File Server/Tool/ToolStoreInterface.php

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\Tool;
15:
16:	use Nexus\Mcp\Core\Exception\InvalidParamsException;
17:	use Nexus\Mcp\Core\Schema\Cursor;
18:	use Nexus\Mcp\Core\Schema\Result\CallToolResult;
19:	use Nexus\Mcp\Core\Schema\Result\InputRequiredResult;
20:	use Nexus\Mcp\Core\Schema\Result\ListToolsResult;
21:	use Nexus\Mcp\Server\Exception\InvalidCursorException;
22:	use Nexus\Mcp\Server\Exception\ToolNotFoundException;
23:	use Nexus\Mcp\Server\Exception\ToolOutputValidationException;
24:	use Nexus\Mcp\Server\ServerContext;
25:
26:	/**
27:	* Read surface that the built-in `tools/*` request handlers depend on.
28:	*/
29:	interface ToolStoreInterface
30:	{
31:	/**
32:	* @throws InvalidCursorException
33:	*/
34:	public function list(?Cursor $cursor): ListToolsResult;
35:
36:	/**
37:	* @param null\|array<string, mixed> $arguments
38:	*
39:	* @throws InvalidParamsException
40:	* @throws ToolNotFoundException
41:	* @throws ToolOutputValidationException
42:	*/
43:	public function call(string $name, ?array $arguments, ServerContext $context): CallToolResult\|InputRequiredResult;
44:	}
45: