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\Exception;
15:
16: use Nexus\Mcp\Core\Exception\McpExceptionInterface;
17:
18: /**
19: * Thrown when a tool's `structuredContent` does not conform to its declared `outputSchema`.
20: */
21: final class ToolOutputValidationException extends \RuntimeException implements McpExceptionInterface
22: {
23: /**
24: * @param list<string> $errors
25: */
26: public function __construct(string $toolName, array $errors, ?\Throwable $previous = null)
27: {
28: parent::__construct(
29: \sprintf(
30: 'Tool "%s" returned structuredContent that does not conform to its outputSchema: %s',
31: $toolName,
32: implode('; ', $errors),
33: ),
34: previous: $previous,
35: );
36: }
37: }
38: