<?php

/*
 * This file is part of the official PHP MCP SDK.
 *
 * A collaboration between Symfony and the PHP Foundation.
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 */
namespace Matomo\Dependencies\McpServer\Mcp\Schema\Result;

use Matomo\Dependencies\McpServer\Mcp\Exception\InvalidArgumentException;
use Matomo\Dependencies\McpServer\Mcp\Schema\Content\AudioContent;
use Matomo\Dependencies\McpServer\Mcp\Schema\Content\Content;
use Matomo\Dependencies\McpServer\Mcp\Schema\Content\EmbeddedResource;
use Matomo\Dependencies\McpServer\Mcp\Schema\Content\ImageContent;
use Matomo\Dependencies\McpServer\Mcp\Schema\Content\TextContent;
use Matomo\Dependencies\McpServer\Mcp\Schema\JsonRpc\ResultInterface;
/**
 * The server's response to a tool call.
 *
 * Any errors that originate from the tool SHOULD be reported inside the result
 * object, with `isError` set to true, _not_ as an MCP protocol-level error
 * response. Otherwise, the LLM would not be able to see that an error occurred
 * and self-correct.
 *
 * However, any errors in _finding_ the tool, an error indicating that the
 * server does not support tool calls, or any other exceptional conditions,
 * should be reported as an MCP error response.
 *
 * @author Kyrian Obikwelu <koshnawaza@gmail.com>
 */
class CallToolResult implements ResultInterface
{
    /**
     * Create a new CallToolResult.
     *
     * @param Content[]                 $content           The content of the tool result
     * @param bool                      $isError           Whether the tool execution resulted in an error.  If not set, this is assumed to be false (the call was successful).
     * @param mixed[]                   $structuredContent JSON content for `structuredContent`
     * @param array<string, mixed>|null $meta              Optional metadata
     */
    public function __construct(public readonly array $content, public readonly bool $isError = \false, public readonly ?array $structuredContent = null, public readonly ?array $meta = null)
    {
        foreach ($this->content as $item) {
            if (!$item instanceof Content) {
                throw new InvalidArgumentException('Content must be an array of Content objects.');
            }
        }
    }
    /**
     * Create a new CallToolResult with success status.
     *
     * @param Content[]                 $content The content of the tool result
     * @param array<string, mixed>|null $meta    Optional metadata
     */
    public static function success(array $content, ?array $meta = null) : self
    {
        return new self($content, \false, null, $meta);
    }
    /**
     * Create a new CallToolResult with error status.
     *
     * @param Content[]                 $content The content of the tool result
     * @param array<string, mixed>|null $meta    Optional metadata
     */
    public static function error(array $content, ?array $meta = null) : self
    {
        return new self($content, \true, null, $meta);
    }
    /**
     * @param array{
     *     content: array<mixed>,
     *     isError?: bool,
     *     _meta?: array<string, mixed>,
     *     structuredContent?: array<string, mixed>
     * } $data
     */
    public static function fromArray(array $data) : self
    {
        if (!isset($data['content']) || !\is_array($data['content'])) {
            throw new InvalidArgumentException('Missing or invalid "content" array in CallToolResult data.');
        }
        $contents = [];
        foreach ($data['content'] as $item) {
            $contents[] = match ($item['type'] ?? null) {
                'text' => TextContent::fromArray($item),
                'image' => ImageContent::fromArray($item),
                'audio' => AudioContent::fromArray($item),
                'resource' => EmbeddedResource::fromArray($item),
                default => throw new InvalidArgumentException(\sprintf('Invalid content type in CallToolResult data: "%s".', $item['type'] ?? null)),
            };
        }
        return new self($contents, $data['isError'] ?? \false, $data['structuredContent'] ?? null, $data['_meta'] ?? null);
    }
    /**
     * @return array{
     *     content: array<mixed>,
     *     isError: bool,
     *     structuredContent?: array<mixed>,
     *     _meta?: array<string, mixed>,
     * }
     */
    public function jsonSerialize() : array
    {
        $result = ['content' => $this->content, 'isError' => $this->isError];
        if ($this->structuredContent) {
            $result['structuredContent'] = $this->structuredContent;
        }
        if ($this->meta) {
            $result['_meta'] = $this->meta;
        }
        return $result;
    }
}
