1: <?php
2:
3: declare(strict_types=1);
4:
5: /**
6: * This file is part of the Nexus MCP SDK package.
7: *
8: * (c) 2026 John Paul E. Balandan, CPA <paulbalandan@gmail.com>
9: *
10: * For the full copyright and license information, please view
11: * the LICENSE file that was distributed with this source code.
12: */
13:
14: namespace Nexus\Mcp\Core\Schema;
15:
16: use Nexus\Assert\Assert;
17:
18: /**
19: * An opaque token used to represent a cursor for pagination.
20: *
21: * @see https://modelcontextprotocol.io/specification/2025-11-25/schema#cursor
22: */
23: final readonly class Cursor
24: {
25: /**
26: * @var non-empty-string
27: */
28: public string $cursor;
29:
30: public function __construct(string $cursor)
31: {
32: Assert::that($cursor)->isNonEmptyString('"cursor" must be a non-empty string.');
33:
34: $this->cursor = $cursor;
35: }
36: }
37: