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: * A progress token, used to associate progress notifications with the original request.
20: *
21: * @see https://modelcontextprotocol.io/specification/2025-11-25/schema#progresstoken
22: */
23: final readonly class ProgressToken
24: {
25: /**
26: * @var int|non-empty-string
27: */
28: public int|string $token;
29:
30: public function __construct(int|string $token)
31: {
32: if (\is_string($token)) {
33: Assert::that($token)->isNonEmptyString('"progressToken" must be a non-empty string.');
34: }
35:
36: $this->token = $token;
37: }
38: }
39: