Open History to see the last commit
Function: mergeAgentTools()#
function mergeAgentTools(serverTools, clientTools): Tool<SchemaInput, SchemaInput, string>[];
Defined in: packages/typescript/ai/src/utilities/chat-params.ts:174
Merge a server-side tool array with the AG-UI client-declared tools received in the request body.
Rules:
- Server tools win on name collision. The client's declaration is
ignored if the server already has a tool with that name. The client's
UI-side handler still fires when the streamed tool-result event comes
through (see
chat-client.tsonToolCall), giving the "after server execution the client also handles" semantic for free. - Client-only tools (name not in
serverTools) become no-execute entries: the runtime's existingClientToolRequestpath handles them — server emits a tool-call request, client executes via its registered handler, client posts back the result.
Parameters#
serverTools#
readonly Tool<SchemaInput, SchemaInput, string>[]
The server's tool array (e.g. from
[myToolDef.server(...)]). Pass directly to chat({ tools }).
clientTools#
readonly object[]
The tools array received from
chatParamsFromRequest(...) / chatParamsFromRequestBody(...).
Returns#
Tool<SchemaInput, SchemaInput, string>[]
A merged array suitable for chat({ tools }).