@librechat/agents 3.4.5 → 3.4.7

package/dist/esm/tools/handlers.mjs

@@ -99,6 +99,7 @@ const handleToolCalls = async (toolCalls, metadata, graph) => {
 			const details = prevRunStep.stepDetails;
 			if ((!details.tool_calls || details.tool_calls.length === 0) && prevStepId !== reusedChunkStepId) {
 				graph.toolCallStepIds.set(toolCallId, prevStepId);
+				graph.registerPendingToolCall(toolCallId, prevStepId);
 				reusedChunkStepId = prevStepId;
 				continue;
 			}

package/dist/esm/tools/handlers.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"handlers.mjs","names":[],"sources":["../../../src/tools/handlers.ts"],"sourcesContent":["/* eslint-disable no-console */\n// src/tools/handlers.ts\nimport { nanoid } from 'nanoid';\nimport { ToolMessage } from '@langchain/core/messages';\nimport type { ToolCall, ToolCallChunk } from '@langchain/core/messages/tool';\nimport type { AnthropicWebSearchResultBlockParam } from '@/llm/anthropic/types';\nimport type { Graph, MultiAgentGraph, StandardGraph } from '@/graphs';\nimport type { AgentContext } from '@/agents/AgentContext';\nimport type * as t from '@/types';\nimport {\n  coerceAnthropicSearchResults,\n  isAnthropicWebSearchResult,\n} from '@/tools/search/anthropic';\nimport {\n  ToolCallTypes,\n  GraphEvents,\n  StepTypes,\n  Providers,\n  Constants,\n} from '@/common';\nimport { formatResultsForLLM } from '@/tools/search/format';\nimport { getMessageId } from '@/messages';\n\nexport async function handleToolCallChunks({\n  graph,\n  stepKey,\n  toolCallChunks,\n  metadata,\n}: {\n  graph: StandardGraph | MultiAgentGraph;\n  stepKey: string;\n  toolCallChunks: ToolCallChunk[];\n  metadata?: Record<string, unknown>;\n}): Promise<void> {\n  let prevStepId: string;\n  let prevRunStep: t.RunStep | undefined;\n  try {\n    prevStepId = graph.getStepIdByKey(stepKey);\n    prevRunStep = graph.getRunStep(prevStepId);\n  } catch {\n    /** Edge Case: If no previous step exists, create a new message creation step */\n    const message_id = getMessageId(stepKey, graph, true) ?? '';\n    prevStepId = await graph.dispatchRunStep(\n      stepKey,\n      {\n        type: StepTypes.MESSAGE_CREATION,\n        message_creation: {\n          message_id,\n        },\n      },\n      metadata\n    );\n    prevRunStep = graph.getRunStep(prevStepId);\n  }\n\n  const _stepId = graph.getStepIdByKey(stepKey);\n\n  /** Edge Case: Tool Call Run Step or `tool_call_ids` never dispatched */\n  const tool_calls: ToolCall[] | undefined =\n    prevStepId && prevRunStep && prevRunStep.type === StepTypes.MESSAGE_CREATION\n      ? []\n      : undefined;\n\n  /** Edge Case: `id` and `name` fields cannot be empty strings */\n  for (const toolCallChunk of toolCallChunks) {\n    if (toolCallChunk.name === '') {\n      toolCallChunk.name = undefined;\n    }\n    if (toolCallChunk.id === '') {\n      toolCallChunk.id = undefined;\n    } else if (\n      tool_calls != null &&\n      toolCallChunk.id != null &&\n      toolCallChunk.name != null\n    ) {\n      tool_calls.push({\n        args: {},\n        id: toolCallChunk.id,\n        name: toolCallChunk.name,\n        type: ToolCallTypes.TOOL_CALL,\n      });\n    }\n  }\n\n  let stepId: string = _stepId;\n  const alreadyDispatched =\n    prevRunStep?.type === StepTypes.MESSAGE_CREATION &&\n    graph.messageStepHasToolCalls.has(prevStepId);\n\n  if (prevRunStep?.type === StepTypes.TOOL_CALLS) {\n    /**\n     * If previous step is already a tool_calls step, use that step ID\n     * This ensures tool call deltas are dispatched to the correct step\n     */\n    stepId = prevStepId;\n  } else if (\n    !alreadyDispatched &&\n    prevRunStep?.type === StepTypes.MESSAGE_CREATION\n  ) {\n    /**\n     * Create tool_calls step as soon as we receive the first tool call chunk\n     * This ensures deltas are always associated with the correct step\n     *\n     * NOTE: We do NOT dispatch an empty text block here because:\n     * - Empty text blocks cause providers (Anthropic, Bedrock) to reject messages\n     * - The tool_calls themselves are sufficient for the step\n     * - Empty content with tool_call_ids gets stored in conversation history\n     *   and causes \"messages must have non-empty content\" errors on replay\n     */\n    graph.messageStepHasToolCalls.set(prevStepId, true);\n    stepId = await graph.dispatchRunStep(\n      stepKey,\n      {\n        type: StepTypes.TOOL_CALLS,\n        tool_calls: tool_calls ?? [],\n      },\n      metadata\n    );\n  }\n\n  await graph.dispatchRunStepDelta(\n    stepId,\n    {\n      type: StepTypes.TOOL_CALLS,\n      tool_calls: toolCallChunks,\n    },\n    metadata\n  );\n}\n\nexport const handleToolCalls = async (\n  toolCalls?: ToolCall[],\n  metadata?: Record<string, unknown>,\n  graph?: Graph | StandardGraph | MultiAgentGraph\n): Promise<void> => {\n  if (!graph || !metadata) {\n    console.warn('Graph or metadata not found in `handleToolCalls`');\n    return;\n  }\n\n  if (!toolCalls) {\n    return;\n  }\n\n  if (toolCalls.length === 0) {\n    return;\n  }\n\n  const stepKey = graph.getStepKey(metadata);\n\n  /**\n   * Track whether we've already reused an empty TOOL_CALLS step created by\n   * handleToolCallChunks during streaming. Only reuse it once (for the first\n   * tool call); subsequent parallel tool calls must create their own steps.\n   */\n  let reusedChunkStepId: string | undefined;\n\n  for (const tool_call of toolCalls) {\n    const toolCallId = tool_call.id ?? `toolu_${nanoid()}`;\n    tool_call.id = toolCallId;\n    if (!toolCallId || graph.toolCallStepIds.has(toolCallId)) {\n      continue;\n    }\n\n    let prevStepId = '';\n    let prevRunStep: t.RunStep | undefined;\n    try {\n      prevStepId = graph.getStepIdByKey(stepKey);\n      prevRunStep = graph.getRunStep(prevStepId);\n    } catch {\n      // no previous step\n    }\n\n    /**\n     * If the previous step is TOOL_CALLS (from handleToolCallChunks or a prior\n     * iteration), either reuse it (if empty) or dispatch a new TOOL_CALLS step\n     * directly — skip the intermediate MESSAGE_CREATION to avoid orphaned gaps.\n     */\n    if (prevRunStep?.type === StepTypes.TOOL_CALLS) {\n      const details = prevRunStep.stepDetails as t.ToolCallsDetails;\n      const isEmpty = !details.tool_calls || details.tool_calls.length === 0;\n      if (isEmpty && prevStepId !== reusedChunkStepId) {\n        graph.toolCallStepIds.set(toolCallId, prevStepId);\n        reusedChunkStepId = prevStepId;\n        continue;\n      }\n      await graph.dispatchRunStep(\n        stepKey,\n        { type: StepTypes.TOOL_CALLS, tool_calls: [tool_call] },\n        metadata\n      );\n      continue;\n    }\n\n    /**\n     * NOTE: We do NOT dispatch empty text blocks with tool_call_ids because:\n     * - Empty text blocks cause providers (Anthropic, Bedrock) to reject messages\n     * - They get stored in conversation history and cause errors on replay:\n     *   \"messages must have non-empty content\" (Anthropic)\n     *   \"The content field in the Message object is empty\" (Bedrock)\n     * - The tool_calls themselves are sufficient\n     */\n    if (prevStepId && prevRunStep) {\n      graph.messageStepHasToolCalls.set(prevStepId, true);\n    } else if (!prevRunStep) {\n      const messageId = getMessageId(stepKey, graph, true) ?? '';\n      const stepId = await graph.dispatchRunStep(\n        stepKey,\n        {\n          type: StepTypes.MESSAGE_CREATION,\n          message_creation: {\n            message_id: messageId,\n          },\n        },\n        metadata\n      );\n      graph.messageStepHasToolCalls.set(stepId, true);\n    }\n\n    await graph.dispatchRunStep(\n      stepKey,\n      {\n        type: StepTypes.TOOL_CALLS,\n        tool_calls: [tool_call],\n      },\n      metadata\n    );\n  }\n};\n\nexport const toolResultTypes = new Set([\n  // 'tool_use',\n  // 'server_tool_use',\n  // 'input_json_delta',\n  'tool_result',\n  'web_search_result',\n  'web_search_tool_result',\n]);\n\n/**\n * Handles the result of a server tool call; in other words, a provider's built-in tool.\n * As of 2025-07-06, only Anthropic handles server tool calls with this pattern.\n */\nexport async function handleServerToolResult({\n  graph,\n  content,\n  metadata,\n  agentContext,\n}: {\n  graph: StandardGraph | MultiAgentGraph;\n  content?: string | t.MessageContentComplex[];\n  metadata?: Record<string, unknown>;\n  agentContext?: AgentContext;\n}): Promise<boolean> {\n  let skipHandling = false;\n  if (agentContext?.provider !== Providers.ANTHROPIC) {\n    return skipHandling;\n  }\n  if (\n    typeof content === 'string' ||\n    content == null ||\n    content.length === 0 ||\n    (content.length === 1 &&\n      (content[0] as t.ToolResultContent).tool_use_id == null)\n  ) {\n    return skipHandling;\n  }\n\n  for (const contentPart of content) {\n    const toolUseId = (contentPart as t.ToolResultContent).tool_use_id;\n    if (toolUseId == null || toolUseId === '') {\n      continue;\n    }\n    const stepId = graph.toolCallStepIds.get(toolUseId);\n    if (stepId == null || stepId === '') {\n      console.warn(\n        `Tool use ID ${toolUseId} not found in graph, cannot dispatch tool result.`\n      );\n      continue;\n    }\n    const runStep = graph.getRunStep(stepId);\n    if (!runStep) {\n      console.warn(\n        `Run step for ${stepId} does not exist, cannot dispatch tool result.`\n      );\n      continue;\n    } else if (runStep.type !== StepTypes.TOOL_CALLS) {\n      console.warn(\n        `Run step for ${stepId} is not a tool call step, cannot dispatch tool result.`\n      );\n      continue;\n    }\n\n    const toolCall =\n      runStep.stepDetails.type === StepTypes.TOOL_CALLS\n        ? (runStep.stepDetails.tool_calls?.find(\n          (toolCall) => toolCall.id === toolUseId\n        ) as ToolCall)\n        : undefined;\n\n    if (!toolCall) {\n      continue;\n    }\n\n    if (\n      contentPart.type === 'web_search_result' ||\n      contentPart.type === 'web_search_tool_result'\n    ) {\n      await handleAnthropicSearchResults({\n        contentPart: contentPart as t.ToolResultContent,\n        toolCall,\n        metadata,\n        graph,\n      });\n    }\n\n    if (!skipHandling) {\n      skipHandling = true;\n    }\n  }\n\n  return skipHandling;\n}\n\nasync function handleAnthropicSearchResults({\n  contentPart,\n  toolCall,\n  metadata,\n  graph,\n}: {\n  contentPart: t.ToolResultContent;\n  toolCall: Partial<ToolCall>;\n  metadata?: Record<string, unknown>;\n  graph: StandardGraph | MultiAgentGraph;\n}): Promise<void> {\n  if (!Array.isArray(contentPart.content)) {\n    console.warn(\n      `Expected content to be an array, got ${typeof contentPart.content}`\n    );\n    return;\n  }\n\n  if (!isAnthropicWebSearchResult(contentPart.content[0])) {\n    console.warn(\n      `Expected content to be an Anthropic web search result, got ${JSON.stringify(\n        contentPart.content\n      )}`\n    );\n    return;\n  }\n\n  const turn = graph.invokedToolIds?.size ?? 0;\n  const searchResultData = coerceAnthropicSearchResults({\n    turn,\n    results: contentPart.content as AnthropicWebSearchResultBlockParam[],\n  });\n\n  const name = toolCall.name;\n  const input = toolCall.args ?? {};\n  const artifact = {\n    [Constants.WEB_SEARCH]: searchResultData,\n  };\n  const { output: formattedOutput } = formatResultsForLLM(\n    turn,\n    searchResultData\n  );\n  const output = new ToolMessage({\n    name,\n    artifact,\n    content: formattedOutput,\n    tool_call_id: toolCall.id!,\n  });\n  const toolEndData: t.ToolEndData = {\n    input,\n    output,\n  };\n  await graph.handlerRegistry\n    ?.getHandler(GraphEvents.TOOL_END)\n    ?.handle(GraphEvents.TOOL_END, toolEndData, metadata, graph);\n\n  if (graph.invokedToolIds == null) {\n    graph.invokedToolIds = new Set<string>();\n  }\n\n  graph.invokedToolIds.add(toolCall.id!);\n}\n"],"mappings":"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"}
+{"version":3,"file":"handlers.mjs","names":[],"sources":["../../../src/tools/handlers.ts"],"sourcesContent":["/* eslint-disable no-console */\n// src/tools/handlers.ts\nimport { nanoid } from 'nanoid';\nimport { ToolMessage } from '@langchain/core/messages';\nimport type { ToolCall, ToolCallChunk } from '@langchain/core/messages/tool';\nimport type { AnthropicWebSearchResultBlockParam } from '@/llm/anthropic/types';\nimport type { Graph, MultiAgentGraph, StandardGraph } from '@/graphs';\nimport type { AgentContext } from '@/agents/AgentContext';\nimport type * as t from '@/types';\nimport {\n  coerceAnthropicSearchResults,\n  isAnthropicWebSearchResult,\n} from '@/tools/search/anthropic';\nimport {\n  ToolCallTypes,\n  GraphEvents,\n  StepTypes,\n  Providers,\n  Constants,\n} from '@/common';\nimport { formatResultsForLLM } from '@/tools/search/format';\nimport { getMessageId } from '@/messages';\n\nexport async function handleToolCallChunks({\n  graph,\n  stepKey,\n  toolCallChunks,\n  metadata,\n}: {\n  graph: StandardGraph | MultiAgentGraph;\n  stepKey: string;\n  toolCallChunks: ToolCallChunk[];\n  metadata?: Record<string, unknown>;\n}): Promise<void> {\n  let prevStepId: string;\n  let prevRunStep: t.RunStep | undefined;\n  try {\n    prevStepId = graph.getStepIdByKey(stepKey);\n    prevRunStep = graph.getRunStep(prevStepId);\n  } catch {\n    /** Edge Case: If no previous step exists, create a new message creation step */\n    const message_id = getMessageId(stepKey, graph, true) ?? '';\n    prevStepId = await graph.dispatchRunStep(\n      stepKey,\n      {\n        type: StepTypes.MESSAGE_CREATION,\n        message_creation: {\n          message_id,\n        },\n      },\n      metadata\n    );\n    prevRunStep = graph.getRunStep(prevStepId);\n  }\n\n  const _stepId = graph.getStepIdByKey(stepKey);\n\n  /** Edge Case: Tool Call Run Step or `tool_call_ids` never dispatched */\n  const tool_calls: ToolCall[] | undefined =\n    prevStepId && prevRunStep && prevRunStep.type === StepTypes.MESSAGE_CREATION\n      ? []\n      : undefined;\n\n  /** Edge Case: `id` and `name` fields cannot be empty strings */\n  for (const toolCallChunk of toolCallChunks) {\n    if (toolCallChunk.name === '') {\n      toolCallChunk.name = undefined;\n    }\n    if (toolCallChunk.id === '') {\n      toolCallChunk.id = undefined;\n    } else if (\n      tool_calls != null &&\n      toolCallChunk.id != null &&\n      toolCallChunk.name != null\n    ) {\n      tool_calls.push({\n        args: {},\n        id: toolCallChunk.id,\n        name: toolCallChunk.name,\n        type: ToolCallTypes.TOOL_CALL,\n      });\n    }\n  }\n\n  let stepId: string = _stepId;\n  const alreadyDispatched =\n    prevRunStep?.type === StepTypes.MESSAGE_CREATION &&\n    graph.messageStepHasToolCalls.has(prevStepId);\n\n  if (prevRunStep?.type === StepTypes.TOOL_CALLS) {\n    /**\n     * If previous step is already a tool_calls step, use that step ID\n     * This ensures tool call deltas are dispatched to the correct step\n     */\n    stepId = prevStepId;\n  } else if (\n    !alreadyDispatched &&\n    prevRunStep?.type === StepTypes.MESSAGE_CREATION\n  ) {\n    /**\n     * Create tool_calls step as soon as we receive the first tool call chunk\n     * This ensures deltas are always associated with the correct step\n     *\n     * NOTE: We do NOT dispatch an empty text block here because:\n     * - Empty text blocks cause providers (Anthropic, Bedrock) to reject messages\n     * - The tool_calls themselves are sufficient for the step\n     * - Empty content with tool_call_ids gets stored in conversation history\n     *   and causes \"messages must have non-empty content\" errors on replay\n     */\n    graph.messageStepHasToolCalls.set(prevStepId, true);\n    stepId = await graph.dispatchRunStep(\n      stepKey,\n      {\n        type: StepTypes.TOOL_CALLS,\n        tool_calls: tool_calls ?? [],\n      },\n      metadata\n    );\n  }\n\n  await graph.dispatchRunStepDelta(\n    stepId,\n    {\n      type: StepTypes.TOOL_CALLS,\n      tool_calls: toolCallChunks,\n    },\n    metadata\n  );\n}\n\nexport const handleToolCalls = async (\n  toolCalls?: ToolCall[],\n  metadata?: Record<string, unknown>,\n  graph?: Graph | StandardGraph | MultiAgentGraph\n): Promise<void> => {\n  if (!graph || !metadata) {\n    console.warn('Graph or metadata not found in `handleToolCalls`');\n    return;\n  }\n\n  if (!toolCalls) {\n    return;\n  }\n\n  if (toolCalls.length === 0) {\n    return;\n  }\n\n  const stepKey = graph.getStepKey(metadata);\n\n  /**\n   * Track whether we've already reused an empty TOOL_CALLS step created by\n   * handleToolCallChunks during streaming. Only reuse it once (for the first\n   * tool call); subsequent parallel tool calls must create their own steps.\n   */\n  let reusedChunkStepId: string | undefined;\n\n  for (const tool_call of toolCalls) {\n    const toolCallId = tool_call.id ?? `toolu_${nanoid()}`;\n    tool_call.id = toolCallId;\n    if (!toolCallId || graph.toolCallStepIds.has(toolCallId)) {\n      continue;\n    }\n\n    let prevStepId = '';\n    let prevRunStep: t.RunStep | undefined;\n    try {\n      prevStepId = graph.getStepIdByKey(stepKey);\n      prevRunStep = graph.getRunStep(prevStepId);\n    } catch {\n      // no previous step\n    }\n\n    /**\n     * If the previous step is TOOL_CALLS (from handleToolCallChunks or a prior\n     * iteration), either reuse it (if empty) or dispatch a new TOOL_CALLS step\n     * directly — skip the intermediate MESSAGE_CREATION to avoid orphaned gaps.\n     */\n    if (prevRunStep?.type === StepTypes.TOOL_CALLS) {\n      const details = prevRunStep.stepDetails as t.ToolCallsDetails;\n      const isEmpty = !details.tool_calls || details.tool_calls.length === 0;\n      if (isEmpty && prevStepId !== reusedChunkStepId) {\n        graph.toolCallStepIds.set(toolCallId, prevStepId);\n        graph.registerPendingToolCall(toolCallId, prevStepId);\n        reusedChunkStepId = prevStepId;\n        continue;\n      }\n      await graph.dispatchRunStep(\n        stepKey,\n        { type: StepTypes.TOOL_CALLS, tool_calls: [tool_call] },\n        metadata\n      );\n      continue;\n    }\n\n    /**\n     * NOTE: We do NOT dispatch empty text blocks with tool_call_ids because:\n     * - Empty text blocks cause providers (Anthropic, Bedrock) to reject messages\n     * - They get stored in conversation history and cause errors on replay:\n     *   \"messages must have non-empty content\" (Anthropic)\n     *   \"The content field in the Message object is empty\" (Bedrock)\n     * - The tool_calls themselves are sufficient\n     */\n    if (prevStepId && prevRunStep) {\n      graph.messageStepHasToolCalls.set(prevStepId, true);\n    } else if (!prevRunStep) {\n      const messageId = getMessageId(stepKey, graph, true) ?? '';\n      const stepId = await graph.dispatchRunStep(\n        stepKey,\n        {\n          type: StepTypes.MESSAGE_CREATION,\n          message_creation: {\n            message_id: messageId,\n          },\n        },\n        metadata\n      );\n      graph.messageStepHasToolCalls.set(stepId, true);\n    }\n\n    await graph.dispatchRunStep(\n      stepKey,\n      {\n        type: StepTypes.TOOL_CALLS,\n        tool_calls: [tool_call],\n      },\n      metadata\n    );\n  }\n};\n\nexport const toolResultTypes = new Set([\n  // 'tool_use',\n  // 'server_tool_use',\n  // 'input_json_delta',\n  'tool_result',\n  'web_search_result',\n  'web_search_tool_result',\n]);\n\n/**\n * Handles the result of a server tool call; in other words, a provider's built-in tool.\n * As of 2025-07-06, only Anthropic handles server tool calls with this pattern.\n */\nexport async function handleServerToolResult({\n  graph,\n  content,\n  metadata,\n  agentContext,\n}: {\n  graph: StandardGraph | MultiAgentGraph;\n  content?: string | t.MessageContentComplex[];\n  metadata?: Record<string, unknown>;\n  agentContext?: AgentContext;\n}): Promise<boolean> {\n  let skipHandling = false;\n  if (agentContext?.provider !== Providers.ANTHROPIC) {\n    return skipHandling;\n  }\n  if (\n    typeof content === 'string' ||\n    content == null ||\n    content.length === 0 ||\n    (content.length === 1 &&\n      (content[0] as t.ToolResultContent).tool_use_id == null)\n  ) {\n    return skipHandling;\n  }\n\n  for (const contentPart of content) {\n    const toolUseId = (contentPart as t.ToolResultContent).tool_use_id;\n    if (toolUseId == null || toolUseId === '') {\n      continue;\n    }\n    const stepId = graph.toolCallStepIds.get(toolUseId);\n    if (stepId == null || stepId === '') {\n      console.warn(\n        `Tool use ID ${toolUseId} not found in graph, cannot dispatch tool result.`\n      );\n      continue;\n    }\n    const runStep = graph.getRunStep(stepId);\n    if (!runStep) {\n      console.warn(\n        `Run step for ${stepId} does not exist, cannot dispatch tool result.`\n      );\n      continue;\n    } else if (runStep.type !== StepTypes.TOOL_CALLS) {\n      console.warn(\n        `Run step for ${stepId} is not a tool call step, cannot dispatch tool result.`\n      );\n      continue;\n    }\n\n    const toolCall =\n      runStep.stepDetails.type === StepTypes.TOOL_CALLS\n        ? (runStep.stepDetails.tool_calls?.find(\n          (toolCall) => toolCall.id === toolUseId\n        ) as ToolCall)\n        : undefined;\n\n    if (!toolCall) {\n      continue;\n    }\n\n    if (\n      contentPart.type === 'web_search_result' ||\n      contentPart.type === 'web_search_tool_result'\n    ) {\n      await handleAnthropicSearchResults({\n        contentPart: contentPart as t.ToolResultContent,\n        toolCall,\n        metadata,\n        graph,\n      });\n    }\n\n    if (!skipHandling) {\n      skipHandling = true;\n    }\n  }\n\n  return skipHandling;\n}\n\nasync function handleAnthropicSearchResults({\n  contentPart,\n  toolCall,\n  metadata,\n  graph,\n}: {\n  contentPart: t.ToolResultContent;\n  toolCall: Partial<ToolCall>;\n  metadata?: Record<string, unknown>;\n  graph: StandardGraph | MultiAgentGraph;\n}): Promise<void> {\n  if (!Array.isArray(contentPart.content)) {\n    console.warn(\n      `Expected content to be an array, got ${typeof contentPart.content}`\n    );\n    return;\n  }\n\n  if (!isAnthropicWebSearchResult(contentPart.content[0])) {\n    console.warn(\n      `Expected content to be an Anthropic web search result, got ${JSON.stringify(\n        contentPart.content\n      )}`\n    );\n    return;\n  }\n\n  const turn = graph.invokedToolIds?.size ?? 0;\n  const searchResultData = coerceAnthropicSearchResults({\n    turn,\n    results: contentPart.content as AnthropicWebSearchResultBlockParam[],\n  });\n\n  const name = toolCall.name;\n  const input = toolCall.args ?? {};\n  const artifact = {\n    [Constants.WEB_SEARCH]: searchResultData,\n  };\n  const { output: formattedOutput } = formatResultsForLLM(\n    turn,\n    searchResultData\n  );\n  const output = new ToolMessage({\n    name,\n    artifact,\n    content: formattedOutput,\n    tool_call_id: toolCall.id!,\n  });\n  const toolEndData: t.ToolEndData = {\n    input,\n    output,\n  };\n  await graph.handlerRegistry\n    ?.getHandler(GraphEvents.TOOL_END)\n    ?.handle(GraphEvents.TOOL_END, toolEndData, metadata, graph);\n\n  if (graph.invokedToolIds == null) {\n    graph.invokedToolIds = new Set<string>();\n  }\n\n  graph.invokedToolIds.add(toolCall.id!);\n}\n"],"mappings":"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"}

package/dist/esm/tools/subagent/SubagentExecutor.mjs

@@ -1380,6 +1380,10 @@ var SubagentExecutor = class {
 				scheduleWrap(eventName, "run_step_completed", data, memberAgentId);
 				return;
 			}
+			if (eventName === "on_run_step_closed") {
+				scheduleWrap(eventName, "run_step_closed", data, memberAgentId);
+				return;
+			}
 			if (eventName === "on_message_delta") {
 				scheduleWrap(eventName, "message_delta", data, memberAgentId);
 				return;
@@ -1585,6 +1589,7 @@ function sanitizeForwardedSubagentUpdateData(eventName, data) {
 	if (eventName === "on_run_step") return sanitizeRunStepUpdateData(data);
 	if (eventName === "on_run_step_delta") return sanitizeRunStepDeltaUpdateData(data);
 	if (eventName === "on_run_step_completed") return sanitizeRunStepCompletedUpdateData(data);
+	if (eventName === "on_run_step_closed") return sanitizeRunStepClosedUpdateData(data);
 	if (eventName === "on_message_delta") return sanitizeMessageDeltaUpdateData(data);
 	if (eventName === "on_reasoning_delta") return sanitizeReasoningDeltaUpdateData(data);
 }
@@ -1609,10 +1614,12 @@ function sanitizeRunStepUpdateData(data) {
 	const step = data;
 	const sanitized = {};
 	assignString(sanitized, "agentId", step.agentId);
+	assignNumber(sanitized, "created_at", step.created_at);
 	assignNumber(sanitized, "groupId", step.groupId);
 	assignString(sanitized, "id", step.id);
 	assignNumber(sanitized, "index", step.index);
 	assignString(sanitized, "runId", step.runId);
+	assignString(sanitized, "status", step.status);
 	assignNumber(sanitized, "stepIndex", step.stepIndex);
 	assignString(sanitized, "type", step.type);
 	if (step.summary !== void 0) sanitized.summary = step.summary;
@@ -1620,6 +1627,22 @@ function sanitizeRunStepUpdateData(data) {
 	sanitized.stepDetails = sanitizeStepDetails(step.stepDetails);
 	return sanitized;
 }
+function sanitizeRunStepClosedUpdateData(data) {
+	if (!isObjectLike(data)) return;
+	const event = data;
+	const sanitized = {};
+	assignString(sanitized, "agentId", event.agentId);
+	assignNumber(sanitized, "closed_at", event.closed_at);
+	assignNumber(sanitized, "created_at", event.created_at);
+	assignNumber(sanitized, "groupId", event.groupId);
+	assignString(sanitized, "id", event.id);
+	assignNumber(sanitized, "index", event.index);
+	assignString(sanitized, "runId", event.runId);
+	assignString(sanitized, "status", event.status);
+	assignNumber(sanitized, "stepIndex", event.stepIndex);
+	assignString(sanitized, "type", event.type);
+	return sanitized;
+}
 function sanitizeRunStepDeltaUpdateData(data) {
 	if (!isObjectLike(data)) return;
 	const event = data;
@@ -1695,6 +1718,7 @@ function sanitizeStepCompleted(data) {
 	const sanitized = { type: "tool_call" };
 	assignString(sanitized, "id", completed.id);
 	assignNumber(sanitized, "index", completed.index);
+	assignNumber(sanitized, "completed_at", completed.completed_at);
 	sanitized.tool_call = sanitizeProcessedToolCall(completed.tool_call);
 	return sanitized;
 }
@@ -1760,6 +1784,10 @@ function summarizeEvent(eventName, data) {
 		if (tool?.name != null && tool.name !== "") return `Tool ${tool.name} complete`;
 		return "Step complete";
 	}
+	if (eventName === "on_run_step_closed") {
+		const closed = data;
+		return closed.status != null && closed.status !== "" ? `Step ${closed.status}` : "Step closed";
+	}
 	if (eventName === "on_message_delta") return "Streaming…";
 	return eventName;
 }