useToolCalls

Subscribe to a scoped tools (tool-call) stream. Same target and lifecycle rules as useMessages; at the root this just returns stream.toolCalls.

The optional generic T can be passed to narrow the type of toolCall.args on the returned array. Accepts either:

• an agent brand (typeof agent) — union is derived from the agent's declared tools;
• an array of LangGraph tools (typeof tools) — union is derived from ToolCallFromTool<T[number]>;
• any direct DefaultToolCall shape.

When omitted, returns the plain AssembledToolCall[] union used by the controller.