1: <?php
2:
3: declare(strict_types=1);
4:
5: /**
6: * This file is part of the Nexus MCP SDK package.
7: *
8: * (c) 2025 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\Schema\Request;
15:
16: use Nexus\Mcp\Schema\Message\JsonRpcRequest;
17: use Nexus\Mcp\Schema\Message\RequestId;
18:
19: /**
20: * Sent from the client to the server, to read a specific resource URI.
21: *
22: * @extends JsonRpcRequest<array{
23: * jsonrpc: '2.0',
24: * id: int|non-empty-string,
25: * method: 'resources/read',
26: * params: array{
27: * _meta?: array<string, mixed>,
28: * uri: non-empty-string,
29: * },
30: * }>
31: */
32: final readonly class ReadResourceRequest extends JsonRpcRequest implements ClientRequest
33: {
34: /**
35: * @param non-empty-string $uri The URI of the resource to read. The URI can use any protocol;
36: * it is up to the server how to interpret it.
37: * @param null|array<string, mixed> $meta Reserved by MCP to allow clients and servers to attach
38: * additional metadata to their interactions.
39: */
40: public function __construct(RequestId $id, string $uri, ?array $meta = null)
41: {
42: parent::__construct(self::JSON_RPC_VERSION, $id, 'resources/read', array_filter([
43: '_meta' => $meta,
44: 'uri' => $uri,
45: ], static fn(mixed $value): bool => null !== $value));
46: }
47: }
48: