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\Resource;
15:
16: use Nexus\Mcp\Core\Schema\Cursor;
17: use Nexus\Mcp\Core\Schema\Result\ListResourceTemplatesResult;
18: use Nexus\Mcp\Core\Schema\Result\ReadResourceResult;
19: use Nexus\Mcp\Server\Exception\InvalidCursorException;
20: use Nexus\Mcp\Server\Exception\ResourceNotFoundException;
21: use Nexus\Mcp\Server\ServerContext;
22:
23: /**
24: * Read surface that the built-in `resources/templates/*` request handlers depend on.
25: */
26: interface ResourceTemplateStoreInterface
27: {
28: /**
29: * @throws InvalidCursorException
30: */
31: public function list(?Cursor $cursor): ListResourceTemplatesResult;
32:
33: /**
34: * Reads `$uri` against the registered templates, returning the result of the
35: * first template that matches.
36: *
37: * @throws ResourceNotFoundException
38: */
39: public function read(string $uri, ServerContext $context): ReadResourceResult;
40: }
41: