ToolSearchOutputItem
type ToolSearchOutputItem = object;Type Declaration
Section titled “Type Declaration”call_id?
Section titled “call_id?”optional call_id?: string | null;callId?
Section titled “callId?”optional callId?: string | null;execution?
Section titled “execution?”optional execution?: "client" | "server";optional 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?
Section titled “providerData?”optional providerData?: Record<string, any>;Additional optional provider specific data. Used for custom functionality or model provider specific fields.
status?
Section titled “status?”optional status?: string;tools: Record<string, any>[];toolSearchAgentName?
Section titled “toolSearchAgentName?”optional 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?
Section titled “toolSearchMcpToolNames?”optional 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";