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\Server;
15:
16: use Amp\Cancellation;
17: use Nexus\Mcp\Core\Handler\AbstractContext;
18: use Nexus\Mcp\Core\Handler\SenderInterface;
19: use Nexus\Mcp\Core\Schema\MetaObject\RequestMetaObject;
20: use Nexus\Mcp\Core\Schema\RequestId;
21: use Nexus\Mcp\Core\Schema\Result\InputResponse;
22: use Nexus\Mcp\Core\Transport\ReceiveContext;
23:
24: /**
25: * Context passed to server-side request handlers.
26: */
27: final readonly class ServerContext extends AbstractContext
28: {
29: /**
30: * @param null|array<int|non-empty-string, InputResponse> $inputResponses The client's answers to a prior `InputRequiredResult`
31: * @param null|string $requestState The continuation token carried by that result, echoed back unchanged
32: * @param null|RequestStateSigner $requestStateSigner The server's signer bound to this request, null when none is configured
33: * @param null|string $requestStatePayload The payload of `$requestState` once the signer verified it
34: */
35: public function __construct(
36: RequestId $requestId,
37: Cancellation $cancellation,
38: public RequestMetaObject $meta,
39: SenderInterface $sender,
40: public ReceiveContext $receiveContext = new ReceiveContext(),
41: public ?array $inputResponses = null,
42: public ?string $requestState = null,
43: public ?RequestStateSigner $requestStateSigner = null,
44: public ?string $requestStatePayload = null,
45: ) {
46: parent::__construct($requestId, $cancellation, $meta->progressToken, $sender);
47: }
48: }
49: