Skip to content

ToolSearchOutputItem

type ToolSearchOutputItem = object;
call_id?: string | null;
callId?: string | null;
execution?: "client" | "server";
id?: string;

An ID to identify the item. This is optional by default. If a model provider absolutely requires this field, it will be validated on the model level.

providerData?: Record<string, any>;

Additional optional provider specific data. Used for custom functionality or model provider specific fields.

status?: string;
tools: Record<string, any>[];
toolSearchAgentName?: string;

SDK-only discovery attribution, excluded from provider requests. Names must identify the same logical Agent across reused history. Missing or ambiguous ownership requires a new search; this field does not grant tool execution permissions.

toolSearchMcpToolNames?: string[];

SDK-only hosted MCP namespace identities established when this output was received. Excluded from provider requests. Older namespace outputs without this provenance require a new search; explicit MCP descriptors remain usable. This records discovery, not permission to execute a tool, and never overrides current caller/approval policy.

type: "tool_search_output";