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\Request;
15:
16: use Nexus\Assert\Assert;
17: use Nexus\Mcp\Core\Schema\JsonRpc\JsonRpcRequest;
18: use Nexus\Mcp\Core\Schema\RequestId;
19: use Nexus\Mcp\Core\Schema\RequestParams\InitializeRequestParams;
20:
21: /**
22: * This request is sent from the client to the server when it first connects, asking it to begin initialization.
23: *
24: * @property-read InitializeRequestParams $params
25: *
26: * @extends JsonRpcRequest<'initialize'>
27: *
28: * @see https://modelcontextprotocol.io/specification/2025-11-25/schema#initializerequest
29: */
30: final readonly class InitializeRequest extends JsonRpcRequest implements ClientRequest
31: {
32: public function __construct(RequestId $id, InitializeRequestParams $params)
33: {
34: parent::__construct($id, $params);
35: }
36:
37: #[\Override]
38: public static function getMethod(): string
39: {
40: return 'initialize';
41: }
42:
43: #[\Override]
44: public static function fromArray(array $data): static
45: {
46: Assert::that($data)->hasOffset('id', 'missing the required "id" key.');
47:
48: $id = $data['id'];
49: Assert::that($id)->isArrayKey('"id" must be an int or string, {type} given.');
50:
51: Assert::that($data)->hasOffset('params', 'missing the required "params" key.');
52: Assert::that($data['params'])
53: ->isArray('"params" must be an object, {type} given.')
54: ->isMap('"params" must be a string-keyed object.')
55: ;
56:
57: return new self(
58: new RequestId($id),
59: InitializeRequestParams::fromArray($data['params']),
60: );
61: }
62: }
63: