Skip to content

[Schema] Add _meta to CallToolResult #148

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Nov 13, 2025
Merged

[Schema] Add _meta to CallToolResult #148

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
36 changes: 26 additions & 10 deletions src/Schema/Result/CallToolResult.php
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -38,14 +38,16 @@ 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 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) {
Expand All @@ -57,27 +59,30 @@ public function __construct(
/**
* Create a new CallToolResult with success status.
*
* @param Content[] $content The content of the tool result
* @param Content[] $content The content of the tool result
* @param array<string, mixed>|null $meta Optional metadata
*/
public static function success(array $content): self
public static function success(array $content, ?array $meta = null): self
{
return new self($content, false);
return new self($content, false, null, $meta);
}

/**
* Create a new CallToolResult with error status.
*
* @param Content[] $content The content of the tool result
* @param Content[] $content The content of the tool result
* @param array<string, mixed>|null $meta Optional metadata
*/
public static function error(array $content): self
public static function error(array $content, ?array $meta = null): self
{
return new self($content, true);
return new self($content, true, null, $meta);
}

/**
* @param array{
* content: array<mixed>,
* isError?: bool,
* _meta?: array<string, mixed>,
* } $data
*/
public static function fromArray(array $data): self
Expand All @@ -98,13 +103,20 @@ public static function fromArray(array $data): self
};
}

return new self($contents, $data['isError'] ?? false);
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
Expand All @@ -118,6 +130,10 @@ public function jsonSerialize(): array
$result['structuredContent'] = $this->structuredContent;
}

if ($this->meta) {
$result['_meta'] = $this->meta;
}

return $result;
}
}