@librechat/agents 3.3.3 → 3.3.5

package/dist/cjs/graphs/MultiAgentGraph.cjs

@@ -1,5 +1,7 @@
 require("../common/enum.cjs");
 require("../common/index.cjs");
+const require_truncation = require("../utils/truncation.cjs");
+const require_toolContent = require("../utils/toolContent.cjs");
 const require_Graph = require("./Graph.cjs");
 let _langchain_core_prompts = require("@langchain/core/prompts");
 let _langchain_core_messages = require("@langchain/core/messages");
@@ -460,7 +462,7 @@ var MultiAgentGraph = class extends require_Graph.StandardGraph {
 		/** No transfer targeting this agent found */
 		if (toolMessage === null || toolMessageIndex < 0) return null;
 		/** Extract instructions from the ToolMessage content */
-		const contentStr = typeof toolMessage.content === "string" ? toolMessage.content : JSON.stringify(toolMessage.content);
+		const contentStr = typeof toolMessage.content === "string" ? toolMessage.content : require_toolContent.serializeToolContentBounded(toolMessage.content, require_truncation.HARD_MAX_TOOL_RESULT_CHARS);
 		const structuredInstructions = toolMessage.additional_kwargs[HANDOFF_INSTRUCTIONS_KEY];
 		const instructions = typeof structuredInstructions === "string" ? structuredInstructions.trim() : extractLegacyHandoffInstructions(contentStr, this.handoffPromptLabels.get(agentId));
 		/** Extract source agent name from additional_kwargs */

package/dist/cjs/graphs/MultiAgentGraph.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"MultiAgentGraph.cjs","names":["StandardGraph","ToolMessage","Command","aiMsg","AIMessage","StateGraph","Annotation","END","HumanMessage","START","PromptTemplate"],"sources":["../../../src/graphs/MultiAgentGraph.ts"],"sourcesContent":["import { tool } from '@langchain/core/tools';\nimport { PromptTemplate } from '@langchain/core/prompts';\nimport {\n  AIMessage,\n  ToolMessage,\n  HumanMessage,\n  getBufferString,\n} from '@langchain/core/messages';\nimport {\n  END,\n  START,\n  Command,\n  StateGraph,\n  Annotation,\n  messagesStateReducer,\n} from '@langchain/langgraph';\nimport type { BaseMessage, AIMessageChunk } from '@langchain/core/messages';\nimport type { LangGraphRunnableConfig } from '@langchain/langgraph';\nimport type { ToolRuntime } from '@langchain/core/tools';\nimport type * as t from '@/types';\nimport { StandardGraph } from './Graph';\nimport { Constants } from '@/common';\n\n/** Pattern to extract instructions from transfer ToolMessage content */\nconst HANDOFF_INSTRUCTIONS_PATTERN = /(?:Instructions?|Context):\\s*(.+)/is;\nconst HANDOFF_INSTRUCTIONS_KEY = 'handoff_instructions';\n\nfunction getHandoffInstructions(\n  input: Record<string, unknown>,\n  promptKey: string,\n  hasHandoffInput: boolean\n): string | null {\n  if (\n    !hasHandoffInput ||\n    !Object.prototype.hasOwnProperty.call(input, promptKey)\n  ) {\n    return null;\n  }\n  const value = input[promptKey];\n  return typeof value === 'string' ? value : null;\n}\n\nfunction formatHandoffPromptLabel(promptKey: string): string {\n  return promptKey.charAt(0).toUpperCase() + promptKey.slice(1);\n}\n\nfunction extractLegacyHandoffInstructions(\n  content: string,\n  promptLabels: Set<string> | undefined\n): string | null {\n  let markerIndex = -1;\n  let markerLength = 0;\n  for (const label of promptLabels ?? []) {\n    const marker = `\\n\\n${label}:`;\n    const index = content.indexOf(marker);\n    if (index >= 0 && (markerIndex < 0 || index < markerIndex)) {\n      markerIndex = index;\n      markerLength = marker.length;\n    }\n  }\n  if (markerIndex >= 0) {\n    return content.slice(markerIndex + markerLength).trim();\n  }\n  return content.match(HANDOFF_INSTRUCTIONS_PATTERN)?.[1]?.trim() ?? null;\n}\n\nfunction isValidHandoffGroupId(value: unknown): value is number {\n  return typeof value === 'number' && Number.isSafeInteger(value) && value > 0;\n}\n\nfunction withHandoffGroupMetadata(\n  config: LangGraphRunnableConfig | undefined,\n  groupId: number | undefined\n): LangGraphRunnableConfig {\n  return {\n    ...config,\n    metadata: {\n      ...config?.metadata,\n      [Constants.HANDOFF_GROUP_ID]: groupId ?? null,\n    },\n  };\n}\n\n/**\n * MultiAgentGraph extends StandardGraph to support dynamic multi-agent workflows\n * with handoffs, fan-in/fan-out, and other composable patterns.\n *\n * Key behavior:\n * - Agents with ONLY handoff edges: Can dynamically route to any handoff destination\n * - Agents with ONLY direct edges: Always follow their direct edges\n * - Agents with BOTH: Use Command for exclusive routing (handoff OR direct, not both)\n *   - If handoff occurs: Only the handoff destination executes\n *   - If no handoff: Direct edges execute (potentially in parallel)\n *\n * This enables the common pattern where an agent either delegates (handoff)\n * OR continues its workflow (direct edges), but not both simultaneously.\n */\nexport class MultiAgentGraph extends StandardGraph {\n  private edges: t.GraphEdge[];\n  private startingNodes: Set<string> = new Set();\n  private directEdges: t.GraphEdge[] = [];\n  private handoffEdges: t.GraphEdge[] = [];\n  private handoffPromptLabels: Map<string, Set<string>> = new Map();\n  /**\n   * Map of agentId to parallel group info.\n   * Contains groupId (incrementing number reflecting execution order) for agents in parallel groups.\n   * Sequential agents (not in any parallel group) have undefined entry.\n   *\n   * Example for: researcher -> [analyst1, analyst2, analyst3] -> summarizer\n   * - researcher: undefined (sequential, order 0)\n   * - analyst1, analyst2, analyst3: { groupId: 1 } (parallel group, order 1)\n   * - summarizer: undefined (sequential, order 2)\n   */\n  private agentParallelGroups: Map<string, number> = new Map();\n\n  constructor(input: t.MultiAgentGraphInput) {\n    super(input);\n    this.edges = input.edges;\n    this.validateEdgeAgents();\n    this.categorizeEdges();\n    this.analyzeGraph();\n    this.createHandoffTools();\n  }\n\n  /**\n   * Fails fast when an edge references an agent that is not in\n   * `agentContexts`. Without this check, the underlying LangGraph\n   * `StateGraph.compile()` would throw the opaque\n   * `Found edge ending at unknown node \"<id>\"` error after graph\n   * construction — far from the true root cause.\n   *\n   * This catches the common misuse of passing `edges` into a multi-agent\n   * config without also passing the corresponding sub-agent configs in\n   * `agents` (e.g. a host that forgot to pre-load handoff targets).\n   */\n  private validateEdgeAgents(): void {\n    const known = new Set(this.agentContexts.keys());\n    const unknown = new Set<string>();\n    for (const edge of this.edges) {\n      const participants = [\n        ...(Array.isArray(edge.from) ? edge.from : [edge.from]),\n        ...(Array.isArray(edge.to) ? edge.to : [edge.to]),\n      ];\n      for (const id of participants) {\n        if (typeof id === 'string' && !known.has(id)) {\n          unknown.add(id);\n        }\n      }\n    }\n    if (unknown.size === 0) {\n      return;\n    }\n    const missing = Array.from(unknown)\n      .map((id) => `\"${id}\"`)\n      .join(', ');\n    throw new Error(\n      `MultiAgentGraph: edges reference agent(s) not present in agents: [${missing}]. ` +\n        'Ensure every agent referenced by an edge is also included in the `agents` array, ' +\n        'or filter orphaned edges before constructing the graph.'\n    );\n  }\n\n  /**\n   * Categorize edges into handoff and direct types\n   */\n  private categorizeEdges(): void {\n    for (const edge of this.edges) {\n      // Default behavior: edges with conditions or explicit 'handoff' type are handoff edges\n      // Edges with explicit 'direct' type or multi-destination without conditions are direct edges\n      if (edge.edgeType === 'direct') {\n        this.directEdges.push(edge);\n      } else if (edge.edgeType === 'handoff' || edge.condition != null) {\n        this.handoffEdges.push(edge);\n      } else {\n        // Default: single-to-single edges are handoff, single-to-multiple are direct\n        const destinations = Array.isArray(edge.to) ? edge.to : [edge.to];\n        const sources = Array.isArray(edge.from) ? edge.from : [edge.from];\n\n        if (sources.length === 1 && destinations.length > 1) {\n          // Fan-out pattern defaults to direct\n          this.directEdges.push(edge);\n        } else {\n          // Everything else defaults to handoff\n          this.handoffEdges.push(edge);\n        }\n      }\n    }\n  }\n\n  /**\n   * Analyze graph structure to determine starting nodes and connections\n   */\n  private analyzeGraph(): void {\n    const hasIncomingEdge = new Set<string>();\n\n    // Track all nodes that have incoming edges\n    for (const edge of this.edges) {\n      const destinations = Array.isArray(edge.to) ? edge.to : [edge.to];\n      destinations.forEach((dest) => hasIncomingEdge.add(dest));\n    }\n\n    // Starting nodes are those without incoming edges\n    for (const agentId of this.agentContexts.keys()) {\n      if (!hasIncomingEdge.has(agentId)) {\n        this.startingNodes.add(agentId);\n      }\n    }\n\n    // If no starting nodes found, use the first agent\n    if (this.startingNodes.size === 0 && this.agentContexts.size > 0) {\n      this.startingNodes.add(this.agentContexts.keys().next().value!);\n    }\n\n    // Determine if graph has parallel execution capability\n    this.computeParallelCapability();\n  }\n\n  /**\n   * Compute parallel groups by traversing the graph in execution order.\n   * Assigns incrementing group IDs that reflect the sequential order of execution.\n   *\n   * For: researcher -> [analyst1, analyst2, analyst3] -> summarizer\n   * - researcher: no group (first sequential node)\n   * - analyst1, analyst2, analyst3: groupId 1 (first parallel group)\n   * - summarizer: no group (next sequential node)\n   *\n   * This allows frontend to render in order:\n   * Row 0: researcher\n   * Row 1: [analyst1, analyst2, analyst3] (grouped)\n   * Row 2: summarizer\n   */\n  private computeParallelCapability(): void {\n    let groupCounter = 1; // Start at 1, 0 reserved for \"no group\"\n\n    // Check 1: Multiple starting nodes means parallel from the start (group 1)\n    if (this.startingNodes.size > 1) {\n      for (const agentId of this.startingNodes) {\n        this.agentParallelGroups.set(agentId, groupCounter);\n      }\n      groupCounter++;\n    }\n\n    // Check 2: Traverse direct edges in order to find fan-out patterns\n    // Build a simple execution order by following edges from starting nodes\n    const visited = new Set<string>();\n    const queue: string[] = [...this.startingNodes];\n\n    while (queue.length > 0) {\n      const current = queue.shift()!;\n      if (visited.has(current)) continue;\n      visited.add(current);\n\n      // Find direct edges from this node\n      for (const edge of this.directEdges) {\n        const sources = Array.isArray(edge.from) ? edge.from : [edge.from];\n        if (!sources.includes(current)) continue;\n\n        const destinations = Array.isArray(edge.to) ? edge.to : [edge.to];\n\n        // Fan-out: multiple destinations = parallel group\n        if (destinations.length > 1) {\n          for (const dest of destinations) {\n            // Only set if not already in a group (first group wins)\n            if (!this.agentParallelGroups.has(dest)) {\n              this.agentParallelGroups.set(dest, groupCounter);\n            }\n            if (!visited.has(dest)) {\n              queue.push(dest);\n            }\n          }\n          groupCounter++;\n        } else {\n          // Single destination - add to queue for traversal\n          for (const dest of destinations) {\n            if (!visited.has(dest)) {\n              queue.push(dest);\n            }\n          }\n        }\n      }\n\n      // Also follow handoff edges for traversal (but they don't create parallel groups)\n      for (const edge of this.handoffEdges) {\n        const sources = Array.isArray(edge.from) ? edge.from : [edge.from];\n        if (!sources.includes(current)) continue;\n\n        const destinations = Array.isArray(edge.to) ? edge.to : [edge.to];\n        for (const dest of destinations) {\n          if (!visited.has(dest)) {\n            queue.push(dest);\n          }\n        }\n      }\n    }\n  }\n\n  /**\n   * Get the parallel group ID for an agent, if any.\n   * Returns undefined if the agent is not part of a parallel group.\n   * Group IDs are incrementing numbers reflecting execution order.\n   */\n  getParallelGroupId(agentId: string): number | undefined {\n    return this.agentParallelGroups.get(agentId);\n  }\n\n  /**\n   * Override to indicate this is a multi-agent graph.\n   * Enables agentId to be included in RunStep for frontend agent labeling.\n   */\n  protected override isMultiAgentGraph(): boolean {\n    return true;\n  }\n\n  /**\n   * Override base class method to provide parallel group IDs for run steps.\n   */\n  protected override getParallelGroupIdForAgent(\n    agentId: string\n  ): number | undefined {\n    return this.agentParallelGroups.get(agentId);\n  }\n\n  /**\n   * Create handoff tools for agents based on handoff edges only\n   */\n  private createHandoffTools(): void {\n    // Group handoff edges by source agent(s)\n    const handoffsByAgent = new Map<string, t.GraphEdge[]>();\n\n    // Only process handoff edges for tool creation\n    for (const edge of this.handoffEdges) {\n      if (typeof edge.prompt === 'string') {\n        const label = formatHandoffPromptLabel(\n          edge.promptKey ?? 'instructions'\n        );\n        const destinations = Array.isArray(edge.to) ? edge.to : [edge.to];\n        for (const destination of destinations) {\n          const labels =\n            this.handoffPromptLabels.get(destination) ?? new Set<string>();\n          labels.add(label);\n          this.handoffPromptLabels.set(destination, labels);\n        }\n      }\n      const sources = Array.isArray(edge.from) ? edge.from : [edge.from];\n      sources.forEach((source) => {\n        if (!handoffsByAgent.has(source)) {\n          handoffsByAgent.set(source, []);\n        }\n        handoffsByAgent.get(source)!.push(edge);\n      });\n    }\n\n    // Create handoff tools for each agent\n    for (const [agentId, edges] of handoffsByAgent) {\n      const agentContext = this.agentContexts.get(agentId);\n      if (!agentContext) continue;\n\n      // Create handoff tools for this agent's outgoing edges\n      const handoffTools: t.GenericTool[] = [];\n      const sourceAgentName = agentContext.name ?? agentId;\n      for (const edge of edges) {\n        handoffTools.push(\n          ...this.createHandoffToolsForEdge(edge, agentId, sourceAgentName)\n        );\n      }\n\n      if (!agentContext.graphTools) {\n        agentContext.graphTools = [];\n      }\n      agentContext.graphTools.push(...handoffTools);\n    }\n  }\n\n  /**\n   * Create handoff tools for an edge (handles multiple destinations)\n   * @param edge - The graph edge defining the handoff\n   * @param sourceAgentId - The ID of the agent that will perform the handoff\n   * @param sourceAgentName - The human-readable name of the source agent\n   */\n  private createHandoffToolsForEdge(\n    edge: t.GraphEdge,\n    sourceAgentId: string,\n    sourceAgentName: string\n  ): t.GenericTool[] {\n    const tools: t.GenericTool[] = [];\n    const destinations = Array.isArray(edge.to) ? edge.to : [edge.to];\n\n    /** If there's a condition, create a single conditional handoff tool */\n    if (edge.condition != null) {\n      const toolName = 'conditional_transfer';\n      const toolDescription =\n        edge.description ?? 'Conditionally transfer control based on state';\n\n      /** Check if we have a prompt for handoff input */\n      const hasHandoffInput =\n        edge.prompt != null && typeof edge.prompt === 'string';\n      const handoffInputDescription = hasHandoffInput ? edge.prompt : undefined;\n      const promptKey = edge.promptKey ?? 'instructions';\n\n      tools.push(\n        tool(\n          async (rawInput, runtime: ToolRuntime) => {\n            const input = rawInput as Record<string, unknown>;\n            const state = runtime.state as t.BaseGraphState;\n            const toolCallId = runtime.toolCall?.id ?? 'unknown';\n\n            /** Evaluated condition */\n            const result = edge.condition!(state);\n            let destination: string;\n\n            if (typeof result === 'boolean') {\n              /** If true, use first destination; if false, don't transfer */\n              if (!result) return null;\n              destination = destinations[0];\n            } else if (typeof result === 'string') {\n              destination = result;\n            } else {\n              /** Array of destinations - for now, use the first */\n              destination = Array.isArray(result) ? result[0] : destinations[0];\n            }\n\n            const handoffInstructions = getHandoffInstructions(\n              input,\n              promptKey,\n              hasHandoffInput\n            );\n            let content = `Conditionally transferred to ${destination}`;\n            if (handoffInstructions !== null) {\n              content += `\\n\\n${formatHandoffPromptLabel(promptKey)}: ${handoffInstructions}`;\n            }\n\n            const toolMessage = new ToolMessage({\n              content,\n              name: toolName,\n              tool_call_id: toolCallId,\n              additional_kwargs: {\n                /** Store destination for programmatic access in handoff detection */\n                handoff_destination: destination,\n                /** Store source agent name for receiving agent to know who handed off */\n                handoff_source_name: sourceAgentName,\n                ...(handoffInstructions !== null && {\n                  [HANDOFF_INSTRUCTIONS_KEY]: handoffInstructions,\n                }),\n              },\n            });\n\n            return new Command({\n              goto: destination,\n              update: { messages: state.messages.concat(toolMessage) },\n              graph: Command.PARENT,\n            });\n          },\n          {\n            name: toolName,\n            schema: hasHandoffInput\n              ? {\n                type: 'object',\n                properties: {\n                  [promptKey]: {\n                    type: 'string',\n                    description: handoffInputDescription as string,\n                  },\n                },\n                required: [],\n              }\n              : { type: 'object', properties: {}, required: [] },\n            description: toolDescription,\n          }\n        )\n      );\n    } else {\n      /** Create individual tools for each destination */\n      for (const destination of destinations) {\n        const toolName = `${Constants.LC_TRANSFER_TO_}${destination}`;\n        const toolDescription =\n          edge.description ?? `Transfer control to agent '${destination}'`;\n\n        /** Check if we have a prompt for handoff input */\n        const hasHandoffInput =\n          edge.prompt != null && typeof edge.prompt === 'string';\n        const handoffInputDescription = hasHandoffInput\n          ? edge.prompt\n          : undefined;\n        const promptKey = edge.promptKey ?? 'instructions';\n\n        tools.push(\n          tool(\n            async (rawInput, runtime: ToolRuntime) => {\n              const input = rawInput as Record<string, unknown>;\n              const toolCallId = runtime.toolCall?.id ?? 'unknown';\n\n              const handoffInstructions = getHandoffInstructions(\n                input,\n                promptKey,\n                hasHandoffInput\n              );\n              let content = `Successfully transferred to ${destination}`;\n              if (handoffInstructions !== null) {\n                content += `\\n\\n${formatHandoffPromptLabel(promptKey)}: ${handoffInstructions}`;\n              }\n\n              const toolMessage = new ToolMessage({\n                content,\n                name: toolName,\n                tool_call_id: toolCallId,\n                additional_kwargs: {\n                  /** Store source agent name for receiving agent to know who handed off */\n                  handoff_source_name: sourceAgentName,\n                  ...(handoffInstructions !== null && {\n                    [HANDOFF_INSTRUCTIONS_KEY]: handoffInstructions,\n                  }),\n                },\n              });\n\n              const state = runtime.state as t.BaseGraphState;\n\n              /**\n               * For parallel handoff support:\n               * Build messages that include ONLY this tool call's context.\n               * This prevents errors when LLM calls multiple transfers simultaneously -\n               * each destination gets a valid AIMessage with matching tool_call and tool_result.\n               *\n               * Strategy:\n               * 1. Find the AIMessage containing this tool call\n               * 2. Create a filtered AIMessage with ONLY this tool_call\n               * 3. Include all messages before the AIMessage plus the filtered pair\n               */\n              const messages = state.messages;\n              let filteredMessages = messages;\n              let aiMessageIndex = -1;\n\n              /** Find the AIMessage containing this tool call */\n              for (let i = messages.length - 1; i >= 0; i--) {\n                const msg = messages[i];\n                if (msg.getType() === 'ai') {\n                  const aiMsg = msg as AIMessage;\n                  const hasThisCall = aiMsg.tool_calls?.some(\n                    (tc) => tc.id === toolCallId\n                  );\n                  if (hasThisCall === true) {\n                    aiMessageIndex = i;\n                    break;\n                  }\n                }\n              }\n\n              if (aiMessageIndex >= 0) {\n                const originalAiMsg = messages[aiMessageIndex] as AIMessage;\n                const thisToolCall = originalAiMsg.tool_calls?.find(\n                  (tc) => tc.id === toolCallId\n                );\n\n                if (\n                  thisToolCall != null &&\n                  (originalAiMsg.tool_calls?.length ?? 0) > 1\n                ) {\n                  /**\n                   * Multiple tool calls - create filtered AIMessage with ONLY this call.\n                   * This ensures valid message structure for parallel handoffs.\n                   */\n                  const filteredAiMsg = new AIMessage({\n                    content: originalAiMsg.content,\n                    tool_calls: [thisToolCall],\n                    id: originalAiMsg.id,\n                  });\n\n                  filteredMessages = [\n                    ...messages.slice(0, aiMessageIndex),\n                    filteredAiMsg,\n                    toolMessage,\n                  ];\n                } else {\n                  /** Single tool call - use messages as-is */\n                  filteredMessages = messages.concat(toolMessage);\n                }\n              } else {\n                /** Fallback - append tool message */\n                filteredMessages = messages.concat(toolMessage);\n              }\n\n              return new Command({\n                goto: destination,\n                update: { messages: filteredMessages },\n                graph: Command.PARENT,\n              });\n            },\n            {\n              name: toolName,\n              schema: hasHandoffInput\n                ? {\n                  type: 'object',\n                  properties: {\n                    [promptKey]: {\n                      type: 'string',\n                      description: handoffInputDescription as string,\n                    },\n                  },\n                  required: [],\n                }\n                : { type: 'object', properties: {}, required: [] },\n              description: toolDescription,\n            }\n          )\n        );\n      }\n    }\n\n    return tools;\n  }\n\n  /**\n   * Create a complete agent subgraph (similar to createReactAgent)\n   */\n  private createAgentSubgraph(agentId: string): t.CompiledAgentWorfklow {\n    /** This is essentially the same as `createAgentNode` from `StandardGraph` */\n    return this.createAgentNode(agentId);\n  }\n\n  /**\n   * Detects if the current agent is receiving a handoff and processes the messages accordingly.\n   * Returns filtered messages with the transfer tool call/message removed, plus any instructions,\n   * source agent, and parallel sibling information extracted from the transfer.\n   *\n   * Supports both single handoffs (last message is the transfer) and parallel handoffs\n   * (multiple transfer ToolMessages, need to find the one targeting this agent).\n   *\n   * @param messages - Current state messages\n   * @param agentId - The agent ID to check for handoff reception\n   * @returns Object with filtered messages, extracted instructions, source agent, and parallel siblings\n   */\n  private processHandoffReception(\n    messages: BaseMessage[],\n    agentId: string\n  ): {\n    filteredMessages: BaseMessage[];\n    instructions: string | null;\n    sourceAgentName: string | null;\n    parallelSiblings: string[];\n    parallelGroupId?: number;\n  } | null {\n    if (messages.length === 0) return null;\n\n    /**\n     * A handoff is active only while resolving the most recent assistant\n     * tool-call round. Older transfer results remain in conversation history,\n     * but must not be reused when this agent is reached later through a direct\n     * edge or cycle.\n     */\n    const activeTransferToolCallIds = new Set<string>();\n    let activeToolMessageStartIndex = messages.length;\n    for (let i = messages.length - 1; i >= 0; i--) {\n      const msg = messages[i];\n      if (msg.getType() === 'tool') continue;\n\n      if (msg.getType() === 'ai') {\n        const aiMsg = msg as AIMessage | AIMessageChunk;\n        for (const toolCall of aiMsg.tool_calls ?? []) {\n          if (\n            toolCall.id != null &&\n            (toolCall.name.startsWith(Constants.LC_TRANSFER_TO_) ||\n              toolCall.name === 'conditional_transfer')\n          ) {\n            activeTransferToolCallIds.add(toolCall.id);\n          }\n        }\n        activeToolMessageStartIndex = i + 1;\n      }\n      break;\n    }\n\n    if (activeTransferToolCallIds.size === 0) return null;\n\n    /**\n     * Search for a transfer ToolMessage targeting this agent.\n     * For parallel handoffs, multiple transfer messages may exist - find ours.\n     * Search backwards from the end to find the most recent transfer to this agent.\n     */\n    let toolMessage: ToolMessage | null = null;\n    let toolMessageIndex = -1;\n\n    for (let i = messages.length - 1; i >= activeToolMessageStartIndex; i--) {\n      const msg = messages[i];\n      if (msg.getType() !== 'tool') continue;\n\n      const candidateMsg = msg as ToolMessage;\n      const toolName = candidateMsg.name;\n\n      if (\n        typeof toolName !== 'string' ||\n        !activeTransferToolCallIds.has(candidateMsg.tool_call_id)\n      ) {\n        continue;\n      }\n\n      /** Check for standard transfer pattern */\n      const isTransferMessage = toolName.startsWith(Constants.LC_TRANSFER_TO_);\n      const isConditionalTransfer = toolName === 'conditional_transfer';\n\n      if (!isTransferMessage && !isConditionalTransfer) continue;\n\n      /** Extract destination from tool name or additional_kwargs */\n      let destinationAgent: string | null = null;\n\n      if (isTransferMessage) {\n        destinationAgent = toolName.replace(Constants.LC_TRANSFER_TO_, '');\n      } else if (isConditionalTransfer) {\n        const handoffDest = candidateMsg.additional_kwargs.handoff_destination;\n        destinationAgent = typeof handoffDest === 'string' ? handoffDest : null;\n      }\n\n      /** Check if this transfer targets our agent */\n      if (destinationAgent === agentId) {\n        toolMessage = candidateMsg;\n        toolMessageIndex = i;\n        break;\n      }\n    }\n\n    /** No transfer targeting this agent found */\n    if (toolMessage === null || toolMessageIndex < 0) return null;\n\n    /** Extract instructions from the ToolMessage content */\n    const contentStr =\n      typeof toolMessage.content === 'string'\n        ? toolMessage.content\n        : JSON.stringify(toolMessage.content);\n\n    const structuredInstructions =\n      toolMessage.additional_kwargs[HANDOFF_INSTRUCTIONS_KEY];\n    const instructions =\n      typeof structuredInstructions === 'string'\n        ? structuredInstructions.trim()\n        : extractLegacyHandoffInstructions(\n          contentStr,\n          this.handoffPromptLabels.get(agentId)\n        );\n\n    /** Extract source agent name from additional_kwargs */\n    const handoffSourceName = toolMessage.additional_kwargs.handoff_source_name;\n    const sourceAgentName =\n      typeof handoffSourceName === 'string' ? handoffSourceName : null;\n\n    /** Extract parallel siblings (set by ToolNode for parallel handoffs) */\n    const rawSiblings = toolMessage.additional_kwargs.handoff_parallel_siblings;\n    const siblingIds: string[] = Array.isArray(rawSiblings)\n      ? rawSiblings.filter((s): s is string => typeof s === 'string')\n      : [];\n    /** Convert IDs to display names */\n    const parallelSiblings = siblingIds.map((id) => {\n      const ctx = this.agentContexts.get(id);\n      return ctx?.name ?? id;\n    });\n    const storedParallelGroupId =\n      toolMessage.additional_kwargs[Constants.HANDOFF_GROUP_ID];\n    const parallelGroupId = isValidHandoffGroupId(storedParallelGroupId)\n      ? storedParallelGroupId\n      : undefined;\n\n    /** Get the tool_call_id to find and filter the AI message's tool call */\n    const toolCallId = toolMessage.tool_call_id;\n\n    /**\n     * Collect all transfer tool_call_ids to filter out.\n     * For parallel handoffs, we filter ALL transfer messages (not just ours)\n     * to give the receiving agent a clean context without handoff noise.\n     */\n    const transferToolCallIds = new Set<string>([toolCallId]);\n    for (const msg of messages) {\n      if (msg.getType() === 'tool') {\n        const tm = msg as ToolMessage;\n        const tName = tm.name;\n        if (\n          typeof tName === 'string' &&\n          (tName.startsWith(Constants.LC_TRANSFER_TO_) ||\n            tName === 'conditional_transfer')\n        ) {\n          transferToolCallIds.add(tm.tool_call_id);\n        }\n      } else if (msg.getType() === 'ai') {\n        const aiMsg = msg as AIMessage | AIMessageChunk;\n        for (const toolCall of aiMsg.tool_calls ?? []) {\n          if (\n            toolCall.id != null &&\n            (toolCall.name.startsWith(Constants.LC_TRANSFER_TO_) ||\n              toolCall.name === 'conditional_transfer')\n          ) {\n            transferToolCallIds.add(toolCall.id);\n          }\n        }\n      }\n    }\n\n    /** Filter out all transfer messages */\n    const filteredMessages: BaseMessage[] = [];\n\n    for (let i = 0; i < messages.length; i++) {\n      const msg = messages[i];\n      const msgType = msg.getType();\n\n      /** Skip transfer ToolMessages */\n      if (msgType === 'tool') {\n        const tm = msg as ToolMessage;\n        if (transferToolCallIds.has(tm.tool_call_id)) {\n          continue;\n        }\n      }\n\n      if (msgType === 'ai') {\n        /** Check if this AI message contains any transfer tool calls */\n        const aiMsg = msg as AIMessage | AIMessageChunk;\n        const toolCalls = aiMsg.tool_calls;\n\n        if (toolCalls && toolCalls.length > 0) {\n          /** Filter out all transfer tool calls */\n          const remainingToolCalls = toolCalls.filter(\n            (tc) => tc.id == null || !transferToolCallIds.has(tc.id)\n          );\n\n          const hasTransferCalls = remainingToolCalls.length < toolCalls.length;\n\n          if (hasTransferCalls) {\n            if (\n              remainingToolCalls.length > 0 ||\n              (typeof aiMsg.content === 'string' && aiMsg.content.trim())\n            ) {\n              /** Keep the message but without transfer tool calls */\n              const filteredAiMsg = new AIMessage({\n                content: aiMsg.content,\n                tool_calls: remainingToolCalls,\n                id: aiMsg.id,\n              });\n              filteredMessages.push(filteredAiMsg);\n            }\n            /** If no remaining content or tool calls, skip this message entirely */\n            continue;\n          }\n        }\n      }\n\n      /** Keep all other messages */\n      filteredMessages.push(msg);\n    }\n\n    return {\n      filteredMessages,\n      instructions,\n      sourceAgentName,\n      parallelSiblings,\n      parallelGroupId,\n    };\n  }\n\n  /**\n   * Create the multi-agent workflow with dynamic handoffs\n   */\n  override createWorkflow(): t.CompiledMultiAgentWorkflow {\n    this.hasCompiledCheckpointer = this.compileOptions?.checkpointer != null;\n    const StateAnnotation = Annotation.Root({\n      messages: Annotation<BaseMessage[]>({\n        reducer: (a, b) => {\n          if (!this.messages.length) {\n            this.startIndex = a.length + b.length;\n          }\n          const result = messagesStateReducer(a, b);\n          this.messages = result;\n          return result;\n        },\n        default: () => [],\n      }),\n      /** Channel for passing filtered messages to agents when excludeResults is true */\n      agentMessages: Annotation<BaseMessage[]>({\n        /** Replaces state entirely */\n        reducer: (a, b) => b,\n        default: () => [],\n      }),\n    });\n\n    const builder = new StateGraph(StateAnnotation);\n\n    // Add all agents as complete subgraphs\n    for (const [agentId] of this.agentContexts) {\n      // Get all possible destinations for this agent\n      const handoffDestinations = new Set<string>();\n      const directDestinations = new Set<string>();\n\n      // Check handoff edges for destinations\n      for (const edge of this.handoffEdges) {\n        const sources = Array.isArray(edge.from) ? edge.from : [edge.from];\n        if (sources.includes(agentId) === true) {\n          const dests = Array.isArray(edge.to) ? edge.to : [edge.to];\n          dests.forEach((dest) => handoffDestinations.add(dest));\n        }\n      }\n\n      // Check direct edges for destinations\n      for (const edge of this.directEdges) {\n        const sources = Array.isArray(edge.from) ? edge.from : [edge.from];\n        if (sources.includes(agentId) === true) {\n          const dests = Array.isArray(edge.to) ? edge.to : [edge.to];\n          dests.forEach((dest) => directDestinations.add(dest));\n        }\n      }\n\n      /** Check if this agent has BOTH handoff and direct edges */\n      const hasHandoffEdges = handoffDestinations.size > 0;\n      const hasDirectEdges = directDestinations.size > 0;\n      const needsCommandRouting = hasHandoffEdges && hasDirectEdges;\n\n      /** Collect all possible destinations for this agent */\n      const allDestinations = new Set([\n        ...handoffDestinations,\n        ...directDestinations,\n      ]);\n      if (handoffDestinations.size > 0 || directDestinations.size === 0) {\n        allDestinations.add(END);\n      }\n\n      /** Agent subgraph (includes agent + tools) */\n      const agentSubgraph = this.createAgentSubgraph(agentId);\n\n      /** Wrapper function that handles agentMessages channel, handoff reception, and conditional routing */\n      const agentWrapper = async (\n        state: t.MultiAgentGraphState,\n        config?: LangGraphRunnableConfig\n      ): Promise<t.MultiAgentGraphState | Command> => {\n        let result: t.MultiAgentGraphState;\n\n        /**\n         * Check if this agent is receiving a handoff.\n         * If so, filter out the transfer messages and inject instructions as preamble.\n         * This prevents the receiving agent from seeing the transfer as \"completed work\"\n         * and prematurely producing an end token.\n         */\n        const handoffContext = this.processHandoffReception(\n          state.messages,\n          agentId\n        );\n        const agentContext = this.agentContexts.get(agentId);\n\n        if (\n          handoffContext?.sourceAgentName != null &&\n          handoffContext.sourceAgentName !== ''\n        ) {\n          agentContext?.setHandoffContext(\n            handoffContext.sourceAgentName,\n            handoffContext.parallelSiblings\n          );\n        } else {\n          agentContext?.clearHandoffContext();\n        }\n\n        if (handoffContext !== null) {\n          const { filteredMessages, instructions, parallelGroupId } =\n            handoffContext;\n\n          /** Build messages for the receiving agent */\n          let messagesForAgent = filteredMessages;\n\n          /**\n           * If there are instructions, inject them as a HumanMessage to\n           * ground the receiving agent.\n           *\n           * When the last filtered message is a ToolMessage (e.g. from a\n           * non-handoff tool the router called before handing off), a\n           * synthetic AIMessage is inserted first to satisfy the\n           * tool → assistant role ordering required by chat APIs.  Without\n           * this bridge, appending a HumanMessage directly after a\n           * ToolMessage causes \"400 Unexpected role 'user' after role\n           * 'tool'\" errors (see issue #54).\n           */\n          const hasInstructions = instructions !== null && instructions !== '';\n          if (hasInstructions) {\n            const lastMsg =\n              filteredMessages.length > 0\n                ? filteredMessages[filteredMessages.length - 1]\n                : null;\n\n            if (lastMsg != null && lastMsg.getType() === 'tool') {\n              messagesForAgent = [\n                ...filteredMessages,\n                new AIMessage(\n                  `[Processed tool result and transferring to ${agentId}]`\n                ),\n                new HumanMessage(instructions),\n              ];\n            } else {\n              messagesForAgent = [\n                ...filteredMessages,\n                new HumanMessage(instructions),\n              ];\n            }\n          }\n\n          /** Update token map if we have a token counter */\n          if (agentContext?.tokenCounter && hasInstructions) {\n            const freshTokenMap: Record<string, number> = {};\n            for (\n              let i = 0;\n              i < Math.min(filteredMessages.length, this.startIndex);\n              i++\n            ) {\n              const tokenCount = agentContext.indexTokenCountMap[i];\n              if (tokenCount !== undefined) {\n                freshTokenMap[i] = tokenCount;\n              }\n            }\n            /** Add tokens for the bridge AIMessage + instructions HumanMessage */\n            for (\n              let i = filteredMessages.length;\n              i < messagesForAgent.length;\n              i++\n            ) {\n              freshTokenMap[i] = agentContext.tokenCounter(messagesForAgent[i]);\n            }\n            agentContext.updateTokenMapWithInstructions(freshTokenMap);\n          }\n\n          const transformedState: t.MultiAgentGraphState = {\n            ...state,\n            messages: messagesForAgent,\n          };\n          result = await agentSubgraph.invoke(\n            transformedState,\n            withHandoffGroupMetadata(config, parallelGroupId)\n          );\n          result = {\n            ...result,\n            agentMessages: [],\n          };\n        } else if (\n          state.agentMessages != null &&\n          state.agentMessages.length > 0\n        ) {\n          /**\n           * When using agentMessages (excludeResults=true), we need to update\n           * the token map to account for the new prompt message\n           */\n          if (agentContext && agentContext.tokenCounter) {\n            /** The agentMessages contains:\n             * 1. Filtered messages (0 to startIndex) - already have token counts\n             * 2. New prompt message - needs token counting\n             */\n            const freshTokenMap: Record<string, number> = {};\n\n            /** Copy existing token counts for filtered messages (0 to startIndex) */\n            for (let i = 0; i < this.startIndex; i++) {\n              const tokenCount = agentContext.indexTokenCountMap[i];\n              if (tokenCount !== undefined) {\n                freshTokenMap[i] = tokenCount;\n              }\n            }\n\n            /** Calculate tokens only for the new prompt message (last message) */\n            const promptMessageIndex = state.agentMessages.length - 1;\n            if (promptMessageIndex >= this.startIndex) {\n              const promptMessage = state.agentMessages[promptMessageIndex];\n              freshTokenMap[promptMessageIndex] =\n                agentContext.tokenCounter(promptMessage);\n            }\n\n            /** Update the agent's token map with instructions added */\n            agentContext.updateTokenMapWithInstructions(freshTokenMap);\n          }\n\n          /** Temporary state with messages replaced by `agentMessages` */\n          const transformedState: t.MultiAgentGraphState = {\n            ...state,\n            messages: state.agentMessages,\n          };\n          result = await agentSubgraph.invoke(transformedState, config);\n          result = {\n            ...result,\n            /** Clear agentMessages for next agent */\n            agentMessages: [],\n          };\n        } else {\n          result = await agentSubgraph.invoke(state, config);\n        }\n\n        /** If agent has both handoff and direct edges, use Command for exclusive routing */\n        if (needsCommandRouting) {\n          /** Check if a handoff occurred */\n          const lastMessage = result.messages[\n            result.messages.length - 1\n          ] as BaseMessage | null;\n          if (\n            lastMessage != null &&\n            lastMessage.getType() === 'tool' &&\n            typeof lastMessage.name === 'string' &&\n            lastMessage.name.startsWith(Constants.LC_TRANSFER_TO_)\n          ) {\n            /** Handoff occurred - extract destination and navigate there exclusively */\n            const handoffDest = lastMessage.name.replace(\n              Constants.LC_TRANSFER_TO_,\n              ''\n            );\n            return new Command({\n              update: result,\n              goto: handoffDest,\n            });\n          } else {\n            /** No handoff - proceed with direct edges */\n            const directDests = Array.from(directDestinations);\n            if (directDests.length === 1) {\n              return new Command({\n                update: result,\n                goto: directDests[0],\n              });\n            } else if (directDests.length > 1) {\n              /** Multiple direct destinations - they'll run in parallel */\n              return new Command({\n                update: result,\n                goto: directDests,\n              });\n            }\n          }\n        }\n\n        /** No special routing needed - return state normally */\n        return result;\n      };\n\n      /** Wrapped agent as a node with its possible destinations */\n      builder.addNode(agentId, agentWrapper, {\n        ends: Array.from(allDestinations),\n      });\n    }\n\n    // Add starting edges for all starting nodes\n    for (const startNode of this.startingNodes) {\n      // eslint-disable-next-line @typescript-eslint/ban-ts-comment\n      /** @ts-ignore */\n      builder.addEdge(START, startNode);\n    }\n\n    /**\n     * Add direct edges for automatic transitions\n     * Group edges by destination to handle fan-in scenarios\n     */\n    const edgesByDestination = new Map<string, t.GraphEdge[]>();\n\n    for (const edge of this.directEdges) {\n      const destinations = Array.isArray(edge.to) ? edge.to : [edge.to];\n      for (const destination of destinations) {\n        if (!edgesByDestination.has(destination)) {\n          edgesByDestination.set(destination, []);\n        }\n        edgesByDestination.get(destination)!.push(edge);\n      }\n    }\n\n    for (const [destination, edges] of edgesByDestination) {\n      /** Checks if this is a fan-in scenario with prompt instructions */\n      const edgesWithPrompt = edges.filter(\n        (edge) => edge.prompt != null && edge.prompt !== ''\n      );\n\n      if (edgesWithPrompt.length > 0) {\n        /**\n         * Single wrapper node for destination (Fan-in with prompt)\n         */\n        const wrapperNodeId = `fan_in_${destination}_prompt`;\n        /**\n         * First edge's `prompt`\n         * (they should all be the same for fan-in)\n         */\n        const prompt = edgesWithPrompt[0].prompt;\n        /**\n         * First edge's `excludeResults` flag\n         * (they should all be the same for fan-in)\n         */\n        const excludeResults = edgesWithPrompt[0].excludeResults;\n\n        builder.addNode(wrapperNodeId, async (state: t.BaseGraphState) => {\n          let promptText: string | undefined;\n          let effectiveExcludeResults = excludeResults;\n\n          if (typeof prompt === 'function') {\n            promptText = await prompt(state.messages, this.startIndex);\n          } else if (prompt != null) {\n            if (prompt.includes('{results}')) {\n              const resultsMessages = state.messages.slice(this.startIndex);\n              const resultsString = getBufferString(resultsMessages);\n              const promptTemplate = PromptTemplate.fromTemplate(prompt);\n              const result = await promptTemplate.invoke({\n                results: resultsString,\n              });\n              promptText = result.value;\n              effectiveExcludeResults =\n                excludeResults !== false && promptText !== '';\n            } else {\n              promptText = prompt;\n            }\n          }\n\n          if (promptText != null && promptText !== '') {\n            if (\n              effectiveExcludeResults == null ||\n              effectiveExcludeResults === false\n            ) {\n              return {\n                messages: [new HumanMessage(promptText)],\n              };\n            }\n\n            /** When `excludeResults` is true, use agentMessages channel\n             * to pass filtered messages + prompt to the destination agent\n             */\n            const filteredMessages = state.messages.slice(0, this.startIndex);\n            const promptMessage = new HumanMessage(promptText);\n            return {\n              messages: [promptMessage],\n              agentMessages: messagesStateReducer(filteredMessages, [\n                promptMessage,\n              ]),\n            };\n          }\n\n          /** No prompt needed, return empty update */\n          return {};\n        });\n\n        /** Add edges from all sources to the wrapper, then wrapper to destination */\n        for (const edge of edges) {\n          const sources = Array.isArray(edge.from) ? edge.from : [edge.from];\n          for (const source of sources) {\n            // eslint-disable-next-line @typescript-eslint/ban-ts-comment\n            /** @ts-ignore */\n            builder.addEdge(source, wrapperNodeId);\n          }\n        }\n\n        /** Single edge from wrapper to destination */\n        // eslint-disable-next-line @typescript-eslint/ban-ts-comment\n        /** @ts-ignore */\n        builder.addEdge(wrapperNodeId, destination);\n      } else {\n        /** No prompt instructions, add direct edges (skip if source uses Command routing) */\n        for (const edge of edges) {\n          const sources = Array.isArray(edge.from) ? edge.from : [edge.from];\n          for (const source of sources) {\n            /** Check if this source node has both handoff and direct edges */\n            const sourceHandoffEdges = this.handoffEdges.filter((e) => {\n              const eSources = Array.isArray(e.from) ? e.from : [e.from];\n              return eSources.includes(source);\n            });\n            const sourceDirectEdges = this.directEdges.filter((e) => {\n              const eSources = Array.isArray(e.from) ? e.from : [e.from];\n              return eSources.includes(source);\n            });\n\n            /** Skip adding edge if source uses Command routing (has both types) */\n            if (sourceHandoffEdges.length > 0 && sourceDirectEdges.length > 0) {\n              continue;\n            }\n\n            // eslint-disable-next-line @typescript-eslint/ban-ts-comment\n            /** @ts-ignore */\n            builder.addEdge(source, destination);\n          }\n        }\n      }\n    }\n\n    return builder.compile(this.compileOptions as unknown as never);\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"MultiAgentGraph.cjs","names":["StandardGraph","ToolMessage","Command","aiMsg","AIMessage","serializeToolContentBounded","HARD_MAX_TOOL_RESULT_CHARS","StateGraph","Annotation","END","HumanMessage","START","PromptTemplate"],"sources":["../../../src/graphs/MultiAgentGraph.ts"],"sourcesContent":["import { tool } from '@langchain/core/tools';\nimport { PromptTemplate } from '@langchain/core/prompts';\nimport {\n  AIMessage,\n  ToolMessage,\n  HumanMessage,\n  getBufferString,\n} from '@langchain/core/messages';\nimport {\n  END,\n  START,\n  Command,\n  StateGraph,\n  Annotation,\n  messagesStateReducer,\n} from '@langchain/langgraph';\nimport type { BaseMessage, AIMessageChunk } from '@langchain/core/messages';\nimport type { LangGraphRunnableConfig } from '@langchain/langgraph';\nimport type { ToolRuntime } from '@langchain/core/tools';\nimport type * as t from '@/types';\nimport { serializeToolContentBounded } from '@/utils/toolContent';\nimport { HARD_MAX_TOOL_RESULT_CHARS } from '@/utils/truncation';\nimport { StandardGraph } from './Graph';\nimport { Constants } from '@/common';\n\n/** Pattern to extract instructions from transfer ToolMessage content */\nconst HANDOFF_INSTRUCTIONS_PATTERN = /(?:Instructions?|Context):\\s*(.+)/is;\nconst HANDOFF_INSTRUCTIONS_KEY = 'handoff_instructions';\n\nfunction getHandoffInstructions(\n  input: Record<string, unknown>,\n  promptKey: string,\n  hasHandoffInput: boolean\n): string | null {\n  if (\n    !hasHandoffInput ||\n    !Object.prototype.hasOwnProperty.call(input, promptKey)\n  ) {\n    return null;\n  }\n  const value = input[promptKey];\n  return typeof value === 'string' ? value : null;\n}\n\nfunction formatHandoffPromptLabel(promptKey: string): string {\n  return promptKey.charAt(0).toUpperCase() + promptKey.slice(1);\n}\n\nfunction extractLegacyHandoffInstructions(\n  content: string,\n  promptLabels: Set<string> | undefined\n): string | null {\n  let markerIndex = -1;\n  let markerLength = 0;\n  for (const label of promptLabels ?? []) {\n    const marker = `\\n\\n${label}:`;\n    const index = content.indexOf(marker);\n    if (index >= 0 && (markerIndex < 0 || index < markerIndex)) {\n      markerIndex = index;\n      markerLength = marker.length;\n    }\n  }\n  if (markerIndex >= 0) {\n    return content.slice(markerIndex + markerLength).trim();\n  }\n  return content.match(HANDOFF_INSTRUCTIONS_PATTERN)?.[1]?.trim() ?? null;\n}\n\nfunction isValidHandoffGroupId(value: unknown): value is number {\n  return typeof value === 'number' && Number.isSafeInteger(value) && value > 0;\n}\n\nfunction withHandoffGroupMetadata(\n  config: LangGraphRunnableConfig | undefined,\n  groupId: number | undefined\n): LangGraphRunnableConfig {\n  return {\n    ...config,\n    metadata: {\n      ...config?.metadata,\n      [Constants.HANDOFF_GROUP_ID]: groupId ?? null,\n    },\n  };\n}\n\n/**\n * MultiAgentGraph extends StandardGraph to support dynamic multi-agent workflows\n * with handoffs, fan-in/fan-out, and other composable patterns.\n *\n * Key behavior:\n * - Agents with ONLY handoff edges: Can dynamically route to any handoff destination\n * - Agents with ONLY direct edges: Always follow their direct edges\n * - Agents with BOTH: Use Command for exclusive routing (handoff OR direct, not both)\n *   - If handoff occurs: Only the handoff destination executes\n *   - If no handoff: Direct edges execute (potentially in parallel)\n *\n * This enables the common pattern where an agent either delegates (handoff)\n * OR continues its workflow (direct edges), but not both simultaneously.\n */\nexport class MultiAgentGraph extends StandardGraph {\n  private edges: t.GraphEdge[];\n  private startingNodes: Set<string> = new Set();\n  private directEdges: t.GraphEdge[] = [];\n  private handoffEdges: t.GraphEdge[] = [];\n  private handoffPromptLabels: Map<string, Set<string>> = new Map();\n  /**\n   * Map of agentId to parallel group info.\n   * Contains groupId (incrementing number reflecting execution order) for agents in parallel groups.\n   * Sequential agents (not in any parallel group) have undefined entry.\n   *\n   * Example for: researcher -> [analyst1, analyst2, analyst3] -> summarizer\n   * - researcher: undefined (sequential, order 0)\n   * - analyst1, analyst2, analyst3: { groupId: 1 } (parallel group, order 1)\n   * - summarizer: undefined (sequential, order 2)\n   */\n  private agentParallelGroups: Map<string, number> = new Map();\n\n  constructor(input: t.MultiAgentGraphInput) {\n    super(input);\n    this.edges = input.edges;\n    this.validateEdgeAgents();\n    this.categorizeEdges();\n    this.analyzeGraph();\n    this.createHandoffTools();\n  }\n\n  /**\n   * Fails fast when an edge references an agent that is not in\n   * `agentContexts`. Without this check, the underlying LangGraph\n   * `StateGraph.compile()` would throw the opaque\n   * `Found edge ending at unknown node \"<id>\"` error after graph\n   * construction — far from the true root cause.\n   *\n   * This catches the common misuse of passing `edges` into a multi-agent\n   * config without also passing the corresponding sub-agent configs in\n   * `agents` (e.g. a host that forgot to pre-load handoff targets).\n   */\n  private validateEdgeAgents(): void {\n    const known = new Set(this.agentContexts.keys());\n    const unknown = new Set<string>();\n    for (const edge of this.edges) {\n      const participants = [\n        ...(Array.isArray(edge.from) ? edge.from : [edge.from]),\n        ...(Array.isArray(edge.to) ? edge.to : [edge.to]),\n      ];\n      for (const id of participants) {\n        if (typeof id === 'string' && !known.has(id)) {\n          unknown.add(id);\n        }\n      }\n    }\n    if (unknown.size === 0) {\n      return;\n    }\n    const missing = Array.from(unknown)\n      .map((id) => `\"${id}\"`)\n      .join(', ');\n    throw new Error(\n      `MultiAgentGraph: edges reference agent(s) not present in agents: [${missing}]. ` +\n        'Ensure every agent referenced by an edge is also included in the `agents` array, ' +\n        'or filter orphaned edges before constructing the graph.'\n    );\n  }\n\n  /**\n   * Categorize edges into handoff and direct types\n   */\n  private categorizeEdges(): void {\n    for (const edge of this.edges) {\n      // Default behavior: edges with conditions or explicit 'handoff' type are handoff edges\n      // Edges with explicit 'direct' type or multi-destination without conditions are direct edges\n      if (edge.edgeType === 'direct') {\n        this.directEdges.push(edge);\n      } else if (edge.edgeType === 'handoff' || edge.condition != null) {\n        this.handoffEdges.push(edge);\n      } else {\n        // Default: single-to-single edges are handoff, single-to-multiple are direct\n        const destinations = Array.isArray(edge.to) ? edge.to : [edge.to];\n        const sources = Array.isArray(edge.from) ? edge.from : [edge.from];\n\n        if (sources.length === 1 && destinations.length > 1) {\n          // Fan-out pattern defaults to direct\n          this.directEdges.push(edge);\n        } else {\n          // Everything else defaults to handoff\n          this.handoffEdges.push(edge);\n        }\n      }\n    }\n  }\n\n  /**\n   * Analyze graph structure to determine starting nodes and connections\n   */\n  private analyzeGraph(): void {\n    const hasIncomingEdge = new Set<string>();\n\n    // Track all nodes that have incoming edges\n    for (const edge of this.edges) {\n      const destinations = Array.isArray(edge.to) ? edge.to : [edge.to];\n      destinations.forEach((dest) => hasIncomingEdge.add(dest));\n    }\n\n    // Starting nodes are those without incoming edges\n    for (const agentId of this.agentContexts.keys()) {\n      if (!hasIncomingEdge.has(agentId)) {\n        this.startingNodes.add(agentId);\n      }\n    }\n\n    // If no starting nodes found, use the first agent\n    if (this.startingNodes.size === 0 && this.agentContexts.size > 0) {\n      this.startingNodes.add(this.agentContexts.keys().next().value!);\n    }\n\n    // Determine if graph has parallel execution capability\n    this.computeParallelCapability();\n  }\n\n  /**\n   * Compute parallel groups by traversing the graph in execution order.\n   * Assigns incrementing group IDs that reflect the sequential order of execution.\n   *\n   * For: researcher -> [analyst1, analyst2, analyst3] -> summarizer\n   * - researcher: no group (first sequential node)\n   * - analyst1, analyst2, analyst3: groupId 1 (first parallel group)\n   * - summarizer: no group (next sequential node)\n   *\n   * This allows frontend to render in order:\n   * Row 0: researcher\n   * Row 1: [analyst1, analyst2, analyst3] (grouped)\n   * Row 2: summarizer\n   */\n  private computeParallelCapability(): void {\n    let groupCounter = 1; // Start at 1, 0 reserved for \"no group\"\n\n    // Check 1: Multiple starting nodes means parallel from the start (group 1)\n    if (this.startingNodes.size > 1) {\n      for (const agentId of this.startingNodes) {\n        this.agentParallelGroups.set(agentId, groupCounter);\n      }\n      groupCounter++;\n    }\n\n    // Check 2: Traverse direct edges in order to find fan-out patterns\n    // Build a simple execution order by following edges from starting nodes\n    const visited = new Set<string>();\n    const queue: string[] = [...this.startingNodes];\n\n    while (queue.length > 0) {\n      const current = queue.shift()!;\n      if (visited.has(current)) continue;\n      visited.add(current);\n\n      // Find direct edges from this node\n      for (const edge of this.directEdges) {\n        const sources = Array.isArray(edge.from) ? edge.from : [edge.from];\n        if (!sources.includes(current)) continue;\n\n        const destinations = Array.isArray(edge.to) ? edge.to : [edge.to];\n\n        // Fan-out: multiple destinations = parallel group\n        if (destinations.length > 1) {\n          for (const dest of destinations) {\n            // Only set if not already in a group (first group wins)\n            if (!this.agentParallelGroups.has(dest)) {\n              this.agentParallelGroups.set(dest, groupCounter);\n            }\n            if (!visited.has(dest)) {\n              queue.push(dest);\n            }\n          }\n          groupCounter++;\n        } else {\n          // Single destination - add to queue for traversal\n          for (const dest of destinations) {\n            if (!visited.has(dest)) {\n              queue.push(dest);\n            }\n          }\n        }\n      }\n\n      // Also follow handoff edges for traversal (but they don't create parallel groups)\n      for (const edge of this.handoffEdges) {\n        const sources = Array.isArray(edge.from) ? edge.from : [edge.from];\n        if (!sources.includes(current)) continue;\n\n        const destinations = Array.isArray(edge.to) ? edge.to : [edge.to];\n        for (const dest of destinations) {\n          if (!visited.has(dest)) {\n            queue.push(dest);\n          }\n        }\n      }\n    }\n  }\n\n  /**\n   * Get the parallel group ID for an agent, if any.\n   * Returns undefined if the agent is not part of a parallel group.\n   * Group IDs are incrementing numbers reflecting execution order.\n   */\n  getParallelGroupId(agentId: string): number | undefined {\n    return this.agentParallelGroups.get(agentId);\n  }\n\n  /**\n   * Override to indicate this is a multi-agent graph.\n   * Enables agentId to be included in RunStep for frontend agent labeling.\n   */\n  protected override isMultiAgentGraph(): boolean {\n    return true;\n  }\n\n  /**\n   * Override base class method to provide parallel group IDs for run steps.\n   */\n  protected override getParallelGroupIdForAgent(\n    agentId: string\n  ): number | undefined {\n    return this.agentParallelGroups.get(agentId);\n  }\n\n  /**\n   * Create handoff tools for agents based on handoff edges only\n   */\n  private createHandoffTools(): void {\n    // Group handoff edges by source agent(s)\n    const handoffsByAgent = new Map<string, t.GraphEdge[]>();\n\n    // Only process handoff edges for tool creation\n    for (const edge of this.handoffEdges) {\n      if (typeof edge.prompt === 'string') {\n        const label = formatHandoffPromptLabel(\n          edge.promptKey ?? 'instructions'\n        );\n        const destinations = Array.isArray(edge.to) ? edge.to : [edge.to];\n        for (const destination of destinations) {\n          const labels =\n            this.handoffPromptLabels.get(destination) ?? new Set<string>();\n          labels.add(label);\n          this.handoffPromptLabels.set(destination, labels);\n        }\n      }\n      const sources = Array.isArray(edge.from) ? edge.from : [edge.from];\n      sources.forEach((source) => {\n        if (!handoffsByAgent.has(source)) {\n          handoffsByAgent.set(source, []);\n        }\n        handoffsByAgent.get(source)!.push(edge);\n      });\n    }\n\n    // Create handoff tools for each agent\n    for (const [agentId, edges] of handoffsByAgent) {\n      const agentContext = this.agentContexts.get(agentId);\n      if (!agentContext) continue;\n\n      // Create handoff tools for this agent's outgoing edges\n      const handoffTools: t.GenericTool[] = [];\n      const sourceAgentName = agentContext.name ?? agentId;\n      for (const edge of edges) {\n        handoffTools.push(\n          ...this.createHandoffToolsForEdge(edge, agentId, sourceAgentName)\n        );\n      }\n\n      if (!agentContext.graphTools) {\n        agentContext.graphTools = [];\n      }\n      agentContext.graphTools.push(...handoffTools);\n    }\n  }\n\n  /**\n   * Create handoff tools for an edge (handles multiple destinations)\n   * @param edge - The graph edge defining the handoff\n   * @param sourceAgentId - The ID of the agent that will perform the handoff\n   * @param sourceAgentName - The human-readable name of the source agent\n   */\n  private createHandoffToolsForEdge(\n    edge: t.GraphEdge,\n    sourceAgentId: string,\n    sourceAgentName: string\n  ): t.GenericTool[] {\n    const tools: t.GenericTool[] = [];\n    const destinations = Array.isArray(edge.to) ? edge.to : [edge.to];\n\n    /** If there's a condition, create a single conditional handoff tool */\n    if (edge.condition != null) {\n      const toolName = 'conditional_transfer';\n      const toolDescription =\n        edge.description ?? 'Conditionally transfer control based on state';\n\n      /** Check if we have a prompt for handoff input */\n      const hasHandoffInput =\n        edge.prompt != null && typeof edge.prompt === 'string';\n      const handoffInputDescription = hasHandoffInput ? edge.prompt : undefined;\n      const promptKey = edge.promptKey ?? 'instructions';\n\n      tools.push(\n        tool(\n          async (rawInput, runtime: ToolRuntime) => {\n            const input = rawInput as Record<string, unknown>;\n            const state = runtime.state as t.BaseGraphState;\n            const toolCallId = runtime.toolCall?.id ?? 'unknown';\n\n            /** Evaluated condition */\n            const result = edge.condition!(state);\n            let destination: string;\n\n            if (typeof result === 'boolean') {\n              /** If true, use first destination; if false, don't transfer */\n              if (!result) return null;\n              destination = destinations[0];\n            } else if (typeof result === 'string') {\n              destination = result;\n            } else {\n              /** Array of destinations - for now, use the first */\n              destination = Array.isArray(result) ? result[0] : destinations[0];\n            }\n\n            const handoffInstructions = getHandoffInstructions(\n              input,\n              promptKey,\n              hasHandoffInput\n            );\n            let content = `Conditionally transferred to ${destination}`;\n            if (handoffInstructions !== null) {\n              content += `\\n\\n${formatHandoffPromptLabel(promptKey)}: ${handoffInstructions}`;\n            }\n\n            const toolMessage = new ToolMessage({\n              content,\n              name: toolName,\n              tool_call_id: toolCallId,\n              additional_kwargs: {\n                /** Store destination for programmatic access in handoff detection */\n                handoff_destination: destination,\n                /** Store source agent name for receiving agent to know who handed off */\n                handoff_source_name: sourceAgentName,\n                ...(handoffInstructions !== null && {\n                  [HANDOFF_INSTRUCTIONS_KEY]: handoffInstructions,\n                }),\n              },\n            });\n\n            return new Command({\n              goto: destination,\n              update: { messages: state.messages.concat(toolMessage) },\n              graph: Command.PARENT,\n            });\n          },\n          {\n            name: toolName,\n            schema: hasHandoffInput\n              ? {\n                type: 'object',\n                properties: {\n                  [promptKey]: {\n                    type: 'string',\n                    description: handoffInputDescription as string,\n                  },\n                },\n                required: [],\n              }\n              : { type: 'object', properties: {}, required: [] },\n            description: toolDescription,\n          }\n        )\n      );\n    } else {\n      /** Create individual tools for each destination */\n      for (const destination of destinations) {\n        const toolName = `${Constants.LC_TRANSFER_TO_}${destination}`;\n        const toolDescription =\n          edge.description ?? `Transfer control to agent '${destination}'`;\n\n        /** Check if we have a prompt for handoff input */\n        const hasHandoffInput =\n          edge.prompt != null && typeof edge.prompt === 'string';\n        const handoffInputDescription = hasHandoffInput\n          ? edge.prompt\n          : undefined;\n        const promptKey = edge.promptKey ?? 'instructions';\n\n        tools.push(\n          tool(\n            async (rawInput, runtime: ToolRuntime) => {\n              const input = rawInput as Record<string, unknown>;\n              const toolCallId = runtime.toolCall?.id ?? 'unknown';\n\n              const handoffInstructions = getHandoffInstructions(\n                input,\n                promptKey,\n                hasHandoffInput\n              );\n              let content = `Successfully transferred to ${destination}`;\n              if (handoffInstructions !== null) {\n                content += `\\n\\n${formatHandoffPromptLabel(promptKey)}: ${handoffInstructions}`;\n              }\n\n              const toolMessage = new ToolMessage({\n                content,\n                name: toolName,\n                tool_call_id: toolCallId,\n                additional_kwargs: {\n                  /** Store source agent name for receiving agent to know who handed off */\n                  handoff_source_name: sourceAgentName,\n                  ...(handoffInstructions !== null && {\n                    [HANDOFF_INSTRUCTIONS_KEY]: handoffInstructions,\n                  }),\n                },\n              });\n\n              const state = runtime.state as t.BaseGraphState;\n\n              /**\n               * For parallel handoff support:\n               * Build messages that include ONLY this tool call's context.\n               * This prevents errors when LLM calls multiple transfers simultaneously -\n               * each destination gets a valid AIMessage with matching tool_call and tool_result.\n               *\n               * Strategy:\n               * 1. Find the AIMessage containing this tool call\n               * 2. Create a filtered AIMessage with ONLY this tool_call\n               * 3. Include all messages before the AIMessage plus the filtered pair\n               */\n              const messages = state.messages;\n              let filteredMessages = messages;\n              let aiMessageIndex = -1;\n\n              /** Find the AIMessage containing this tool call */\n              for (let i = messages.length - 1; i >= 0; i--) {\n                const msg = messages[i];\n                if (msg.getType() === 'ai') {\n                  const aiMsg = msg as AIMessage;\n                  const hasThisCall = aiMsg.tool_calls?.some(\n                    (tc) => tc.id === toolCallId\n                  );\n                  if (hasThisCall === true) {\n                    aiMessageIndex = i;\n                    break;\n                  }\n                }\n              }\n\n              if (aiMessageIndex >= 0) {\n                const originalAiMsg = messages[aiMessageIndex] as AIMessage;\n                const thisToolCall = originalAiMsg.tool_calls?.find(\n                  (tc) => tc.id === toolCallId\n                );\n\n                if (\n                  thisToolCall != null &&\n                  (originalAiMsg.tool_calls?.length ?? 0) > 1\n                ) {\n                  /**\n                   * Multiple tool calls - create filtered AIMessage with ONLY this call.\n                   * This ensures valid message structure for parallel handoffs.\n                   */\n                  const filteredAiMsg = new AIMessage({\n                    content: originalAiMsg.content,\n                    tool_calls: [thisToolCall],\n                    id: originalAiMsg.id,\n                  });\n\n                  filteredMessages = [\n                    ...messages.slice(0, aiMessageIndex),\n                    filteredAiMsg,\n                    toolMessage,\n                  ];\n                } else {\n                  /** Single tool call - use messages as-is */\n                  filteredMessages = messages.concat(toolMessage);\n                }\n              } else {\n                /** Fallback - append tool message */\n                filteredMessages = messages.concat(toolMessage);\n              }\n\n              return new Command({\n                goto: destination,\n                update: { messages: filteredMessages },\n                graph: Command.PARENT,\n              });\n            },\n            {\n              name: toolName,\n              schema: hasHandoffInput\n                ? {\n                  type: 'object',\n                  properties: {\n                    [promptKey]: {\n                      type: 'string',\n                      description: handoffInputDescription as string,\n                    },\n                  },\n                  required: [],\n                }\n                : { type: 'object', properties: {}, required: [] },\n              description: toolDescription,\n            }\n          )\n        );\n      }\n    }\n\n    return tools;\n  }\n\n  /**\n   * Create a complete agent subgraph (similar to createReactAgent)\n   */\n  private createAgentSubgraph(agentId: string): t.CompiledAgentWorfklow {\n    /** This is essentially the same as `createAgentNode` from `StandardGraph` */\n    return this.createAgentNode(agentId);\n  }\n\n  /**\n   * Detects if the current agent is receiving a handoff and processes the messages accordingly.\n   * Returns filtered messages with the transfer tool call/message removed, plus any instructions,\n   * source agent, and parallel sibling information extracted from the transfer.\n   *\n   * Supports both single handoffs (last message is the transfer) and parallel handoffs\n   * (multiple transfer ToolMessages, need to find the one targeting this agent).\n   *\n   * @param messages - Current state messages\n   * @param agentId - The agent ID to check for handoff reception\n   * @returns Object with filtered messages, extracted instructions, source agent, and parallel siblings\n   */\n  private processHandoffReception(\n    messages: BaseMessage[],\n    agentId: string\n  ): {\n    filteredMessages: BaseMessage[];\n    instructions: string | null;\n    sourceAgentName: string | null;\n    parallelSiblings: string[];\n    parallelGroupId?: number;\n  } | null {\n    if (messages.length === 0) return null;\n\n    /**\n     * A handoff is active only while resolving the most recent assistant\n     * tool-call round. Older transfer results remain in conversation history,\n     * but must not be reused when this agent is reached later through a direct\n     * edge or cycle.\n     */\n    const activeTransferToolCallIds = new Set<string>();\n    let activeToolMessageStartIndex = messages.length;\n    for (let i = messages.length - 1; i >= 0; i--) {\n      const msg = messages[i];\n      if (msg.getType() === 'tool') continue;\n\n      if (msg.getType() === 'ai') {\n        const aiMsg = msg as AIMessage | AIMessageChunk;\n        for (const toolCall of aiMsg.tool_calls ?? []) {\n          if (\n            toolCall.id != null &&\n            (toolCall.name.startsWith(Constants.LC_TRANSFER_TO_) ||\n              toolCall.name === 'conditional_transfer')\n          ) {\n            activeTransferToolCallIds.add(toolCall.id);\n          }\n        }\n        activeToolMessageStartIndex = i + 1;\n      }\n      break;\n    }\n\n    if (activeTransferToolCallIds.size === 0) return null;\n\n    /**\n     * Search for a transfer ToolMessage targeting this agent.\n     * For parallel handoffs, multiple transfer messages may exist - find ours.\n     * Search backwards from the end to find the most recent transfer to this agent.\n     */\n    let toolMessage: ToolMessage | null = null;\n    let toolMessageIndex = -1;\n\n    for (let i = messages.length - 1; i >= activeToolMessageStartIndex; i--) {\n      const msg = messages[i];\n      if (msg.getType() !== 'tool') continue;\n\n      const candidateMsg = msg as ToolMessage;\n      const toolName = candidateMsg.name;\n\n      if (\n        typeof toolName !== 'string' ||\n        !activeTransferToolCallIds.has(candidateMsg.tool_call_id)\n      ) {\n        continue;\n      }\n\n      /** Check for standard transfer pattern */\n      const isTransferMessage = toolName.startsWith(Constants.LC_TRANSFER_TO_);\n      const isConditionalTransfer = toolName === 'conditional_transfer';\n\n      if (!isTransferMessage && !isConditionalTransfer) continue;\n\n      /** Extract destination from tool name or additional_kwargs */\n      let destinationAgent: string | null = null;\n\n      if (isTransferMessage) {\n        destinationAgent = toolName.replace(Constants.LC_TRANSFER_TO_, '');\n      } else if (isConditionalTransfer) {\n        const handoffDest = candidateMsg.additional_kwargs.handoff_destination;\n        destinationAgent = typeof handoffDest === 'string' ? handoffDest : null;\n      }\n\n      /** Check if this transfer targets our agent */\n      if (destinationAgent === agentId) {\n        toolMessage = candidateMsg;\n        toolMessageIndex = i;\n        break;\n      }\n    }\n\n    /** No transfer targeting this agent found */\n    if (toolMessage === null || toolMessageIndex < 0) return null;\n\n    /** Extract instructions from the ToolMessage content */\n    const contentStr =\n      typeof toolMessage.content === 'string'\n        ? toolMessage.content\n        : serializeToolContentBounded(\n          toolMessage.content,\n          HARD_MAX_TOOL_RESULT_CHARS\n        );\n\n    const structuredInstructions =\n      toolMessage.additional_kwargs[HANDOFF_INSTRUCTIONS_KEY];\n    const instructions =\n      typeof structuredInstructions === 'string'\n        ? structuredInstructions.trim()\n        : extractLegacyHandoffInstructions(\n          contentStr,\n          this.handoffPromptLabels.get(agentId)\n        );\n\n    /** Extract source agent name from additional_kwargs */\n    const handoffSourceName = toolMessage.additional_kwargs.handoff_source_name;\n    const sourceAgentName =\n      typeof handoffSourceName === 'string' ? handoffSourceName : null;\n\n    /** Extract parallel siblings (set by ToolNode for parallel handoffs) */\n    const rawSiblings = toolMessage.additional_kwargs.handoff_parallel_siblings;\n    const siblingIds: string[] = Array.isArray(rawSiblings)\n      ? rawSiblings.filter((s): s is string => typeof s === 'string')\n      : [];\n    /** Convert IDs to display names */\n    const parallelSiblings = siblingIds.map((id) => {\n      const ctx = this.agentContexts.get(id);\n      return ctx?.name ?? id;\n    });\n    const storedParallelGroupId =\n      toolMessage.additional_kwargs[Constants.HANDOFF_GROUP_ID];\n    const parallelGroupId = isValidHandoffGroupId(storedParallelGroupId)\n      ? storedParallelGroupId\n      : undefined;\n\n    /** Get the tool_call_id to find and filter the AI message's tool call */\n    const toolCallId = toolMessage.tool_call_id;\n\n    /**\n     * Collect all transfer tool_call_ids to filter out.\n     * For parallel handoffs, we filter ALL transfer messages (not just ours)\n     * to give the receiving agent a clean context without handoff noise.\n     */\n    const transferToolCallIds = new Set<string>([toolCallId]);\n    for (const msg of messages) {\n      if (msg.getType() === 'tool') {\n        const tm = msg as ToolMessage;\n        const tName = tm.name;\n        if (\n          typeof tName === 'string' &&\n          (tName.startsWith(Constants.LC_TRANSFER_TO_) ||\n            tName === 'conditional_transfer')\n        ) {\n          transferToolCallIds.add(tm.tool_call_id);\n        }\n      } else if (msg.getType() === 'ai') {\n        const aiMsg = msg as AIMessage | AIMessageChunk;\n        for (const toolCall of aiMsg.tool_calls ?? []) {\n          if (\n            toolCall.id != null &&\n            (toolCall.name.startsWith(Constants.LC_TRANSFER_TO_) ||\n              toolCall.name === 'conditional_transfer')\n          ) {\n            transferToolCallIds.add(toolCall.id);\n          }\n        }\n      }\n    }\n\n    /** Filter out all transfer messages */\n    const filteredMessages: BaseMessage[] = [];\n\n    for (let i = 0; i < messages.length; i++) {\n      const msg = messages[i];\n      const msgType = msg.getType();\n\n      /** Skip transfer ToolMessages */\n      if (msgType === 'tool') {\n        const tm = msg as ToolMessage;\n        if (transferToolCallIds.has(tm.tool_call_id)) {\n          continue;\n        }\n      }\n\n      if (msgType === 'ai') {\n        /** Check if this AI message contains any transfer tool calls */\n        const aiMsg = msg as AIMessage | AIMessageChunk;\n        const toolCalls = aiMsg.tool_calls;\n\n        if (toolCalls && toolCalls.length > 0) {\n          /** Filter out all transfer tool calls */\n          const remainingToolCalls = toolCalls.filter(\n            (tc) => tc.id == null || !transferToolCallIds.has(tc.id)\n          );\n\n          const hasTransferCalls = remainingToolCalls.length < toolCalls.length;\n\n          if (hasTransferCalls) {\n            if (\n              remainingToolCalls.length > 0 ||\n              (typeof aiMsg.content === 'string' && aiMsg.content.trim())\n            ) {\n              /** Keep the message but without transfer tool calls */\n              const filteredAiMsg = new AIMessage({\n                content: aiMsg.content,\n                tool_calls: remainingToolCalls,\n                id: aiMsg.id,\n              });\n              filteredMessages.push(filteredAiMsg);\n            }\n            /** If no remaining content or tool calls, skip this message entirely */\n            continue;\n          }\n        }\n      }\n\n      /** Keep all other messages */\n      filteredMessages.push(msg);\n    }\n\n    return {\n      filteredMessages,\n      instructions,\n      sourceAgentName,\n      parallelSiblings,\n      parallelGroupId,\n    };\n  }\n\n  /**\n   * Create the multi-agent workflow with dynamic handoffs\n   */\n  override createWorkflow(): t.CompiledMultiAgentWorkflow {\n    this.hasCompiledCheckpointer = this.compileOptions?.checkpointer != null;\n    const StateAnnotation = Annotation.Root({\n      messages: Annotation<BaseMessage[]>({\n        reducer: (a, b) => {\n          if (!this.messages.length) {\n            this.startIndex = a.length + b.length;\n          }\n          const result = messagesStateReducer(a, b);\n          this.messages = result;\n          return result;\n        },\n        default: () => [],\n      }),\n      /** Channel for passing filtered messages to agents when excludeResults is true */\n      agentMessages: Annotation<BaseMessage[]>({\n        /** Replaces state entirely */\n        reducer: (a, b) => b,\n        default: () => [],\n      }),\n    });\n\n    const builder = new StateGraph(StateAnnotation);\n\n    // Add all agents as complete subgraphs\n    for (const [agentId] of this.agentContexts) {\n      // Get all possible destinations for this agent\n      const handoffDestinations = new Set<string>();\n      const directDestinations = new Set<string>();\n\n      // Check handoff edges for destinations\n      for (const edge of this.handoffEdges) {\n        const sources = Array.isArray(edge.from) ? edge.from : [edge.from];\n        if (sources.includes(agentId) === true) {\n          const dests = Array.isArray(edge.to) ? edge.to : [edge.to];\n          dests.forEach((dest) => handoffDestinations.add(dest));\n        }\n      }\n\n      // Check direct edges for destinations\n      for (const edge of this.directEdges) {\n        const sources = Array.isArray(edge.from) ? edge.from : [edge.from];\n        if (sources.includes(agentId) === true) {\n          const dests = Array.isArray(edge.to) ? edge.to : [edge.to];\n          dests.forEach((dest) => directDestinations.add(dest));\n        }\n      }\n\n      /** Check if this agent has BOTH handoff and direct edges */\n      const hasHandoffEdges = handoffDestinations.size > 0;\n      const hasDirectEdges = directDestinations.size > 0;\n      const needsCommandRouting = hasHandoffEdges && hasDirectEdges;\n\n      /** Collect all possible destinations for this agent */\n      const allDestinations = new Set([\n        ...handoffDestinations,\n        ...directDestinations,\n      ]);\n      if (handoffDestinations.size > 0 || directDestinations.size === 0) {\n        allDestinations.add(END);\n      }\n\n      /** Agent subgraph (includes agent + tools) */\n      const agentSubgraph = this.createAgentSubgraph(agentId);\n\n      /** Wrapper function that handles agentMessages channel, handoff reception, and conditional routing */\n      const agentWrapper = async (\n        state: t.MultiAgentGraphState,\n        config?: LangGraphRunnableConfig\n      ): Promise<t.MultiAgentGraphState | Command> => {\n        let result: t.MultiAgentGraphState;\n\n        /**\n         * Check if this agent is receiving a handoff.\n         * If so, filter out the transfer messages and inject instructions as preamble.\n         * This prevents the receiving agent from seeing the transfer as \"completed work\"\n         * and prematurely producing an end token.\n         */\n        const handoffContext = this.processHandoffReception(\n          state.messages,\n          agentId\n        );\n        const agentContext = this.agentContexts.get(agentId);\n\n        if (\n          handoffContext?.sourceAgentName != null &&\n          handoffContext.sourceAgentName !== ''\n        ) {\n          agentContext?.setHandoffContext(\n            handoffContext.sourceAgentName,\n            handoffContext.parallelSiblings\n          );\n        } else {\n          agentContext?.clearHandoffContext();\n        }\n\n        if (handoffContext !== null) {\n          const { filteredMessages, instructions, parallelGroupId } =\n            handoffContext;\n\n          /** Build messages for the receiving agent */\n          let messagesForAgent = filteredMessages;\n\n          /**\n           * If there are instructions, inject them as a HumanMessage to\n           * ground the receiving agent.\n           *\n           * When the last filtered message is a ToolMessage (e.g. from a\n           * non-handoff tool the router called before handing off), a\n           * synthetic AIMessage is inserted first to satisfy the\n           * tool → assistant role ordering required by chat APIs.  Without\n           * this bridge, appending a HumanMessage directly after a\n           * ToolMessage causes \"400 Unexpected role 'user' after role\n           * 'tool'\" errors (see issue #54).\n           */\n          const hasInstructions = instructions !== null && instructions !== '';\n          if (hasInstructions) {\n            const lastMsg =\n              filteredMessages.length > 0\n                ? filteredMessages[filteredMessages.length - 1]\n                : null;\n\n            if (lastMsg != null && lastMsg.getType() === 'tool') {\n              messagesForAgent = [\n                ...filteredMessages,\n                new AIMessage(\n                  `[Processed tool result and transferring to ${agentId}]`\n                ),\n                new HumanMessage(instructions),\n              ];\n            } else {\n              messagesForAgent = [\n                ...filteredMessages,\n                new HumanMessage(instructions),\n              ];\n            }\n          }\n\n          /** Update token map if we have a token counter */\n          if (agentContext?.tokenCounter && hasInstructions) {\n            const freshTokenMap: Record<string, number> = {};\n            for (\n              let i = 0;\n              i < Math.min(filteredMessages.length, this.startIndex);\n              i++\n            ) {\n              const tokenCount = agentContext.indexTokenCountMap[i];\n              if (tokenCount !== undefined) {\n                freshTokenMap[i] = tokenCount;\n              }\n            }\n            /** Add tokens for the bridge AIMessage + instructions HumanMessage */\n            for (\n              let i = filteredMessages.length;\n              i < messagesForAgent.length;\n              i++\n            ) {\n              freshTokenMap[i] = agentContext.tokenCounter(messagesForAgent[i]);\n            }\n            agentContext.updateTokenMapWithInstructions(freshTokenMap);\n          }\n\n          const transformedState: t.MultiAgentGraphState = {\n            ...state,\n            messages: messagesForAgent,\n          };\n          result = await agentSubgraph.invoke(\n            transformedState,\n            withHandoffGroupMetadata(config, parallelGroupId)\n          );\n          result = {\n            ...result,\n            agentMessages: [],\n          };\n        } else if (\n          state.agentMessages != null &&\n          state.agentMessages.length > 0\n        ) {\n          /**\n           * When using agentMessages (excludeResults=true), we need to update\n           * the token map to account for the new prompt message\n           */\n          if (agentContext && agentContext.tokenCounter) {\n            /** The agentMessages contains:\n             * 1. Filtered messages (0 to startIndex) - already have token counts\n             * 2. New prompt message - needs token counting\n             */\n            const freshTokenMap: Record<string, number> = {};\n\n            /** Copy existing token counts for filtered messages (0 to startIndex) */\n            for (let i = 0; i < this.startIndex; i++) {\n              const tokenCount = agentContext.indexTokenCountMap[i];\n              if (tokenCount !== undefined) {\n                freshTokenMap[i] = tokenCount;\n              }\n            }\n\n            /** Calculate tokens only for the new prompt message (last message) */\n            const promptMessageIndex = state.agentMessages.length - 1;\n            if (promptMessageIndex >= this.startIndex) {\n              const promptMessage = state.agentMessages[promptMessageIndex];\n              freshTokenMap[promptMessageIndex] =\n                agentContext.tokenCounter(promptMessage);\n            }\n\n            /** Update the agent's token map with instructions added */\n            agentContext.updateTokenMapWithInstructions(freshTokenMap);\n          }\n\n          /** Temporary state with messages replaced by `agentMessages` */\n          const transformedState: t.MultiAgentGraphState = {\n            ...state,\n            messages: state.agentMessages,\n          };\n          result = await agentSubgraph.invoke(transformedState, config);\n          result = {\n            ...result,\n            /** Clear agentMessages for next agent */\n            agentMessages: [],\n          };\n        } else {\n          result = await agentSubgraph.invoke(state, config);\n        }\n\n        /** If agent has both handoff and direct edges, use Command for exclusive routing */\n        if (needsCommandRouting) {\n          /** Check if a handoff occurred */\n          const lastMessage = result.messages[\n            result.messages.length - 1\n          ] as BaseMessage | null;\n          if (\n            lastMessage != null &&\n            lastMessage.getType() === 'tool' &&\n            typeof lastMessage.name === 'string' &&\n            lastMessage.name.startsWith(Constants.LC_TRANSFER_TO_)\n          ) {\n            /** Handoff occurred - extract destination and navigate there exclusively */\n            const handoffDest = lastMessage.name.replace(\n              Constants.LC_TRANSFER_TO_,\n              ''\n            );\n            return new Command({\n              update: result,\n              goto: handoffDest,\n            });\n          } else {\n            /** No handoff - proceed with direct edges */\n            const directDests = Array.from(directDestinations);\n            if (directDests.length === 1) {\n              return new Command({\n                update: result,\n                goto: directDests[0],\n              });\n            } else if (directDests.length > 1) {\n              /** Multiple direct destinations - they'll run in parallel */\n              return new Command({\n                update: result,\n                goto: directDests,\n              });\n            }\n          }\n        }\n\n        /** No special routing needed - return state normally */\n        return result;\n      };\n\n      /** Wrapped agent as a node with its possible destinations */\n      builder.addNode(agentId, agentWrapper, {\n        ends: Array.from(allDestinations),\n      });\n    }\n\n    // Add starting edges for all starting nodes\n    for (const startNode of this.startingNodes) {\n      // eslint-disable-next-line @typescript-eslint/ban-ts-comment\n      /** @ts-ignore */\n      builder.addEdge(START, startNode);\n    }\n\n    /**\n     * Add direct edges for automatic transitions\n     * Group edges by destination to handle fan-in scenarios\n     */\n    const edgesByDestination = new Map<string, t.GraphEdge[]>();\n\n    for (const edge of this.directEdges) {\n      const destinations = Array.isArray(edge.to) ? edge.to : [edge.to];\n      for (const destination of destinations) {\n        if (!edgesByDestination.has(destination)) {\n          edgesByDestination.set(destination, []);\n        }\n        edgesByDestination.get(destination)!.push(edge);\n      }\n    }\n\n    for (const [destination, edges] of edgesByDestination) {\n      /** Checks if this is a fan-in scenario with prompt instructions */\n      const edgesWithPrompt = edges.filter(\n        (edge) => edge.prompt != null && edge.prompt !== ''\n      );\n\n      if (edgesWithPrompt.length > 0) {\n        /**\n         * Single wrapper node for destination (Fan-in with prompt)\n         */\n        const wrapperNodeId = `fan_in_${destination}_prompt`;\n        /**\n         * First edge's `prompt`\n         * (they should all be the same for fan-in)\n         */\n        const prompt = edgesWithPrompt[0].prompt;\n        /**\n         * First edge's `excludeResults` flag\n         * (they should all be the same for fan-in)\n         */\n        const excludeResults = edgesWithPrompt[0].excludeResults;\n\n        builder.addNode(wrapperNodeId, async (state: t.BaseGraphState) => {\n          let promptText: string | undefined;\n          let effectiveExcludeResults = excludeResults;\n\n          if (typeof prompt === 'function') {\n            promptText = await prompt(state.messages, this.startIndex);\n          } else if (prompt != null) {\n            if (prompt.includes('{results}')) {\n              const resultsMessages = state.messages.slice(this.startIndex);\n              const resultsString = getBufferString(resultsMessages);\n              const promptTemplate = PromptTemplate.fromTemplate(prompt);\n              const result = await promptTemplate.invoke({\n                results: resultsString,\n              });\n              promptText = result.value;\n              effectiveExcludeResults =\n                excludeResults !== false && promptText !== '';\n            } else {\n              promptText = prompt;\n            }\n          }\n\n          if (promptText != null && promptText !== '') {\n            if (\n              effectiveExcludeResults == null ||\n              effectiveExcludeResults === false\n            ) {\n              return {\n                messages: [new HumanMessage(promptText)],\n              };\n            }\n\n            /** When `excludeResults` is true, use agentMessages channel\n             * to pass filtered messages + prompt to the destination agent\n             */\n            const filteredMessages = state.messages.slice(0, this.startIndex);\n            const promptMessage = new HumanMessage(promptText);\n            return {\n              messages: [promptMessage],\n              agentMessages: messagesStateReducer(filteredMessages, [\n                promptMessage,\n              ]),\n            };\n          }\n\n          /** No prompt needed, return empty update */\n          return {};\n        });\n\n        /** Add edges from all sources to the wrapper, then wrapper to destination */\n        for (const edge of edges) {\n          const sources = Array.isArray(edge.from) ? edge.from : [edge.from];\n          for (const source of sources) {\n            // eslint-disable-next-line @typescript-eslint/ban-ts-comment\n            /** @ts-ignore */\n            builder.addEdge(source, wrapperNodeId);\n          }\n        }\n\n        /** Single edge from wrapper to destination */\n        // eslint-disable-next-line @typescript-eslint/ban-ts-comment\n        /** @ts-ignore */\n        builder.addEdge(wrapperNodeId, destination);\n      } else {\n        /** No prompt instructions, add direct edges (skip if source uses Command routing) */\n        for (const edge of edges) {\n          const sources = Array.isArray(edge.from) ? edge.from : [edge.from];\n          for (const source of sources) {\n            /** Check if this source node has both handoff and direct edges */\n            const sourceHandoffEdges = this.handoffEdges.filter((e) => {\n              const eSources = Array.isArray(e.from) ? e.from : [e.from];\n              return eSources.includes(source);\n            });\n            const sourceDirectEdges = this.directEdges.filter((e) => {\n              const eSources = Array.isArray(e.from) ? e.from : [e.from];\n              return eSources.includes(source);\n            });\n\n            /** Skip adding edge if source uses Command routing (has both types) */\n            if (sourceHandoffEdges.length > 0 && sourceDirectEdges.length > 0) {\n              continue;\n            }\n\n            // eslint-disable-next-line @typescript-eslint/ban-ts-comment\n            /** @ts-ignore */\n            builder.addEdge(source, destination);\n          }\n        }\n      }\n    }\n\n    return builder.compile(this.compileOptions as unknown as never);\n  }\n}\n"],"mappings":"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"}

package/dist/cjs/hooks/HookRegistry.cjs

@@ -170,6 +170,27 @@ var HookRegistry = class {
 		if (bucket === void 0) return false;
 		return readList(bucket, event).length > 0;
 	}
+	/**
+	* True when at least one matcher for `event` would actually DISPATCH on a
+	* query-less call — a wildcard pattern with a non-empty `hooks` array.
+	*
+	* `hasHookFor` answers "is one registered", which is not the same question:
+	* a matcher carrying a pattern is inert for events that supply no
+	* `matchQuery`, so a caller using registration as a proxy for "something
+	* will run" can act on a hook that never fires. Mirrors the two skips in
+	* `executeHooks` (pattern mismatch, empty `hooks`).
+	*
+	* Non-allocating on purpose — `StandardGraph.canClaimPreemptSeal` reads it
+	* once per streamed chunk, where `getMatchers`' defensive `slice()` would
+	* allocate on every delta.
+	*/
+	hasDispatchableHookFor(event, sessionId) {
+		if (hasDispatchableInList(readList(this.global, event))) return true;
+		if (sessionId === void 0) return false;
+		const bucket = this.sessions.get(sessionId);
+		if (bucket === void 0) return false;
+		return hasDispatchableInList(readList(bucket, event));
+	}
 	ensureSessionBucket(sessionId) {
 		const existing = this.sessions.get(sessionId);
 		if (existing !== void 0) return existing;
@@ -188,6 +209,10 @@ function ensureList(bucket, event) {
 function readList(bucket, event) {
 	return bucket[event] ?? [];
 }
+function hasDispatchableInList(list) {
+	for (const matcher of list) if ((matcher.pattern === void 0 || matcher.pattern === "") && matcher.hooks.length > 0) return true;
+	return false;
+}
 function hasResultAlteringInBucket(bucket) {
 	for (const event of RESULT_ALTERING_HOOK_EVENTS) if (readList(bucket, event).length > 0) return true;
 	return false;

package/dist/cjs/hooks/HookRegistry.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"HookRegistry.cjs","names":[],"sources":["../../../src/hooks/HookRegistry.ts"],"sourcesContent":["// src/hooks/HookRegistry.ts\nimport type { HookEvent, HookMatcher } from './types';\n\n/**\n * Internal matcher storage type.\n *\n * Matchers registered via the public `register<E>` API are strictly typed\n * to a single `E`, but the storage needs one uniform slot type per event.\n * We store them as `HookMatcher<HookEvent>` and cast once at the variance\n * boundary — see `ensureList` and `snapshot` below. The invariant (every\n * matcher in `bucket[event]` was registered with that exact event) is\n * enforced by the public API; breaking it requires bypassing the types.\n */\ntype MatcherBucket = Partial<Record<HookEvent, HookMatcher<HookEvent>[]>>;\n\n/**\n * Events whose hooks can change a tool call's input or output. Presence of\n * any of these disables eager tool execution and early completion emission;\n * observation-only events (`PostToolBatch`, `Stop`, telemetry hooks) do not.\n */\nconst RESULT_ALTERING_HOOK_EVENTS = [\n  'PreToolUse',\n  'PostToolUse',\n  'PostToolUseFailure',\n] as const satisfies readonly HookEvent[];\n\n/**\n * Snapshot of a halt request raised by a hook returning\n * `preventContinuation: true`. The SDK's run loop polls for this between\n * stream events and exits cleanly when set, skipping the `Stop` hook\n * (the run is being halted, not naturally completing). One per registry\n * instance — the first hook to halt wins; subsequent halts are ignored\n * so the original reason isn't clobbered.\n */\nexport interface HookHaltSignal {\n  reason: string;\n  /** Event of the hook that triggered the halt (for diagnostics). */\n  source: HookEvent;\n}\n\n/**\n * Run-scoped storage for hook matchers with an additional layer for\n * session-scoped matchers that should be cleaned up between sessions.\n *\n * Hosts construct one registry per `Run` (mirroring how `HandlerRegistry` is\n * scoped) and register global matchers + per-session matchers against it.\n * Registration is strictly additive — nothing in this class mutates a\n * matcher's callbacks or flags after insertion.\n *\n * ## Why `Map<sessionId, MatcherBucket>` and not `Record`\n *\n * LibreChat runs thousands of parallel sessions in one Node process, and\n * hook registration happens inside hot paths (tool loading, agent spawning).\n * A `Record<sessionId, ...>` has to be spread on every insertion, which is\n * O(n) per call and O(n²) total for a batch of parallel registrations. A\n * Map mutates in place, keeping insertions O(1). This mirrors the reasoning\n * Claude Code documents at `utils/hooks/sessionHooks.ts:62`.\n */\nexport class HookRegistry {\n  private readonly global: MatcherBucket = {};\n  private readonly sessions: Map<string, MatcherBucket> = new Map();\n  /**\n   * Per-session halt signals. Scoped by `sessionId` (= the run id the\n   * hook fired under) so a host that shares one registry across\n   * concurrent runs cannot leak `preventContinuation` from one run\n   * into another. Without scoping, a halt raised by run A's hook\n   * would trip run B's stream-loop poll on the next iteration —\n   * silently terminating an unrelated run.\n   *\n   * Map storage mirrors the reasoning above for session matchers:\n   * O(1) insertion in hot paths, no spread-on-write.\n   */\n  private readonly haltSignals: Map<string, HookHaltSignal> = new Map();\n\n  /**\n   * Register a matcher for the lifetime of this registry (= one Run).\n   * Returns an unregister function that removes the matcher by reference.\n   */\n  register<E extends HookEvent>(event: E, matcher: HookMatcher<E>): () => void {\n    const list = ensureList(this.global, event);\n    list.push(widen(matcher));\n    return () => {\n      removeFromList(list, matcher);\n    };\n  }\n\n  /**\n   * Register a matcher for a specific session. Cleared automatically when\n   * `clearSession(sessionId)` is called, or can be removed directly via the\n   * returned unregister function.\n   */\n  registerSession<E extends HookEvent>(\n    sessionId: string,\n    event: E,\n    matcher: HookMatcher<E>\n  ): () => void {\n    const bucket = this.ensureSessionBucket(sessionId);\n    const list = ensureList(bucket, event);\n    list.push(widen(matcher));\n    return () => {\n      removeFromList(list, matcher);\n    };\n  }\n\n  /**\n   * Returns all matchers registered for `event`, concatenating global first\n   * and then session-specific (when `sessionId` is supplied). The caller\n   * receives a fresh array, so iterating it is safe even if a matcher is\n   * removed mid-iteration (e.g. via `once: true`).\n   */\n  getMatchers<E extends HookEvent>(\n    event: E,\n    sessionId?: string\n  ): HookMatcher<E>[] {\n    const globalList = readList(this.global, event);\n    if (sessionId === undefined) {\n      return snapshot<E>(globalList);\n    }\n    const bucket = this.sessions.get(sessionId);\n    if (bucket === undefined) {\n      return snapshot<E>(globalList);\n    }\n    const sessionList = readList(bucket, event);\n    if (globalList.length === 0) {\n      return snapshot<E>(sessionList);\n    }\n    if (sessionList.length === 0) {\n      return snapshot<E>(globalList);\n    }\n    return snapshot<E>([...globalList, ...sessionList]);\n  }\n\n  /**\n   * Removes `matcher` by reference from global storage first, falling back\n   * to the session bucket when `sessionId` is supplied. Used by\n   * `executeHooks` to drop `once: true` matchers after they fire.\n   */\n  removeMatcher<E extends HookEvent>(\n    event: E,\n    matcher: HookMatcher<E>,\n    sessionId?: string\n  ): boolean {\n    if (removeFromList(readList(this.global, event), matcher)) {\n      return true;\n    }\n    if (sessionId === undefined) {\n      return false;\n    }\n    const bucket = this.sessions.get(sessionId);\n    if (bucket === undefined) {\n      return false;\n    }\n    return removeFromList(readList(bucket, event), matcher);\n  }\n\n  /**\n   * Drops every session-scoped matcher for `sessionId`. Call this in the\n   * `finally` block around a Run so a `once: true` hook that never fired\n   * cannot leak into the next session on the same registry.\n   */\n  clearSession(sessionId: string): void {\n    this.sessions.delete(sessionId);\n  }\n\n  /**\n   * Raise a halt signal scoped to `sessionId` (= the run id the hook\n   * fired under). The SDK's run loop polls for this between stream\n   * events with the run's own id. First-write-wins per session: a\n   * halt already raised by an earlier hook in the same run is\n   * preserved so the original `reason` / `source` aren't overwritten.\n   *\n   * Per-session scoping is critical when hosts share one registry\n   * across concurrent runs (e.g. a global policy registered once and\n   * reused). Without it, a `preventContinuation` from run A would\n   * trip run B's stream-loop poll on the next iteration and silently\n   * terminate an unrelated run.\n   *\n   * Called by the SDK after `executeHooks` returns an aggregate with\n   * `preventContinuation: true`. Hosts can also call it directly from\n   * inside a hook callback if they want to halt without going through\n   * the aggregated return value, but `preventContinuation` is the\n   * canonical path.\n   */\n  haltRun(sessionId: string, reason: string, source: HookEvent): void {\n    if (this.haltSignals.has(sessionId)) {\n      return;\n    }\n    this.haltSignals.set(sessionId, { reason, source });\n  }\n\n  /**\n   * Returns the halt signal raised by hooks running under `sessionId`,\n   * or `undefined` if no hook in that run has halted. Polled by\n   * `Run.processStream` between stream events using the run's own id.\n   */\n  getHaltSignal(sessionId: string): HookHaltSignal | undefined {\n    return this.haltSignals.get(sessionId);\n  }\n\n  /**\n   * Clears the halt signal for `sessionId`. Called by\n   * `Run.processStream` in its `finally` block so a subsequent\n   * invocation of the same Run (e.g. resume) starts with a fresh\n   * halt state. No-op when no signal exists for that session.\n   */\n  clearHaltSignal(sessionId: string): void {\n    this.haltSignals.delete(sessionId);\n  }\n\n  /**\n   * True when any registered hook can alter a tool result before or after\n   * execution (`PreToolUse`, `PostToolUse`, `PostToolUseFailure`). Eager\n   * tool execution and early completion emission gate on this instead of\n   * registry presence, so observation-only registries (e.g. a\n   * `PostToolBatch` steering drain) keep those fast paths. With\n   * `sessionId`, checks global + that session; without it, conservatively\n   * scans every session bucket.\n   */\n  hasResultAlteringHooks(sessionId?: string): boolean {\n    if (hasResultAlteringInBucket(this.global)) {\n      return true;\n    }\n    if (sessionId !== undefined) {\n      const bucket = this.sessions.get(sessionId);\n      return bucket !== undefined && hasResultAlteringInBucket(bucket);\n    }\n    for (const bucket of this.sessions.values()) {\n      if (hasResultAlteringInBucket(bucket)) {\n        return true;\n      }\n    }\n    return false;\n  }\n\n  /** True if at least one matcher exists for `event` (global + session). */\n  hasHookFor(event: HookEvent, sessionId?: string): boolean {\n    if (readList(this.global, event).length > 0) {\n      return true;\n    }\n    if (sessionId === undefined) {\n      return false;\n    }\n    const bucket = this.sessions.get(sessionId);\n    if (bucket === undefined) {\n      return false;\n    }\n    return readList(bucket, event).length > 0;\n  }\n\n  private ensureSessionBucket(sessionId: string): MatcherBucket {\n    const existing = this.sessions.get(sessionId);\n    if (existing !== undefined) {\n      return existing;\n    }\n    const fresh: MatcherBucket = {};\n    this.sessions.set(sessionId, fresh);\n    return fresh;\n  }\n}\n\nfunction ensureList(\n  bucket: MatcherBucket,\n  event: HookEvent\n): HookMatcher<HookEvent>[] {\n  const existing = bucket[event];\n  if (existing !== undefined) {\n    return existing;\n  }\n  const fresh: HookMatcher<HookEvent>[] = [];\n  bucket[event] = fresh;\n  return fresh;\n}\n\nfunction readList(\n  bucket: MatcherBucket,\n  event: HookEvent\n): HookMatcher<HookEvent>[] {\n  return bucket[event] ?? [];\n}\n\nfunction hasResultAlteringInBucket(bucket: MatcherBucket): boolean {\n  for (const event of RESULT_ALTERING_HOOK_EVENTS) {\n    if (readList(bucket, event).length > 0) {\n      return true;\n    }\n  }\n  return false;\n}\n\nfunction removeFromList<E extends HookEvent>(\n  list: HookMatcher<HookEvent>[],\n  matcher: HookMatcher<E>\n): boolean {\n  const idx = list.indexOf(widen(matcher));\n  if (idx < 0) {\n    return false;\n  }\n  list.splice(idx, 1);\n  return true;\n}\n\n/**\n * Widen a per-event matcher to the storage's uniform slot type. Unsound at\n * the type level (function parameters are contravariant) but safe by\n * construction: `HookRegistry.register<E>` only ever puts matchers into the\n * bucket slot for their own event, and reads go through `snapshot<E>`\n * which is only called with the same `E`.\n */\nfunction widen<E extends HookEvent>(\n  matcher: HookMatcher<E>\n): HookMatcher<HookEvent> {\n  return matcher as unknown as HookMatcher<HookEvent>;\n}\n\n/**\n * Narrow a storage list back to a per-event matcher list on the way out.\n * Sound counterpart to `widen`: the list only contains matchers that were\n * registered against `E`, because the public API enforces it on insert.\n */\nfunction snapshot<E extends HookEvent>(\n  list: readonly HookMatcher<HookEvent>[]\n): HookMatcher<E>[] {\n  return list.slice() as unknown as HookMatcher<E>[];\n}\n"],"mappings":"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"}
+{"version":3,"file":"HookRegistry.cjs","names":[],"sources":["../../../src/hooks/HookRegistry.ts"],"sourcesContent":["// src/hooks/HookRegistry.ts\nimport type { HookEvent, HookMatcher } from './types';\n\n/**\n * Internal matcher storage type.\n *\n * Matchers registered via the public `register<E>` API are strictly typed\n * to a single `E`, but the storage needs one uniform slot type per event.\n * We store them as `HookMatcher<HookEvent>` and cast once at the variance\n * boundary — see `ensureList` and `snapshot` below. The invariant (every\n * matcher in `bucket[event]` was registered with that exact event) is\n * enforced by the public API; breaking it requires bypassing the types.\n */\ntype MatcherBucket = Partial<Record<HookEvent, HookMatcher<HookEvent>[]>>;\n\n/**\n * Events whose hooks can change a tool call's input or output. Presence of\n * any of these disables eager tool execution and early completion emission;\n * observation-only events (`PostToolBatch`, `Stop`, telemetry hooks) do not.\n */\nconst RESULT_ALTERING_HOOK_EVENTS = [\n  'PreToolUse',\n  'PostToolUse',\n  'PostToolUseFailure',\n] as const satisfies readonly HookEvent[];\n\n/**\n * Snapshot of a halt request raised by a hook returning\n * `preventContinuation: true`. The SDK's run loop polls for this between\n * stream events and exits cleanly when set, skipping the `Stop` hook\n * (the run is being halted, not naturally completing). One per registry\n * instance — the first hook to halt wins; subsequent halts are ignored\n * so the original reason isn't clobbered.\n */\nexport interface HookHaltSignal {\n  reason: string;\n  /** Event of the hook that triggered the halt (for diagnostics). */\n  source: HookEvent;\n}\n\n/**\n * Run-scoped storage for hook matchers with an additional layer for\n * session-scoped matchers that should be cleaned up between sessions.\n *\n * Hosts construct one registry per `Run` (mirroring how `HandlerRegistry` is\n * scoped) and register global matchers + per-session matchers against it.\n * Registration is strictly additive — nothing in this class mutates a\n * matcher's callbacks or flags after insertion.\n *\n * ## Why `Map<sessionId, MatcherBucket>` and not `Record`\n *\n * LibreChat runs thousands of parallel sessions in one Node process, and\n * hook registration happens inside hot paths (tool loading, agent spawning).\n * A `Record<sessionId, ...>` has to be spread on every insertion, which is\n * O(n) per call and O(n²) total for a batch of parallel registrations. A\n * Map mutates in place, keeping insertions O(1). This mirrors the reasoning\n * Claude Code documents at `utils/hooks/sessionHooks.ts:62`.\n */\nexport class HookRegistry {\n  private readonly global: MatcherBucket = {};\n  private readonly sessions: Map<string, MatcherBucket> = new Map();\n  /**\n   * Per-session halt signals. Scoped by `sessionId` (= the run id the\n   * hook fired under) so a host that shares one registry across\n   * concurrent runs cannot leak `preventContinuation` from one run\n   * into another. Without scoping, a halt raised by run A's hook\n   * would trip run B's stream-loop poll on the next iteration —\n   * silently terminating an unrelated run.\n   *\n   * Map storage mirrors the reasoning above for session matchers:\n   * O(1) insertion in hot paths, no spread-on-write.\n   */\n  private readonly haltSignals: Map<string, HookHaltSignal> = new Map();\n\n  /**\n   * Register a matcher for the lifetime of this registry (= one Run).\n   * Returns an unregister function that removes the matcher by reference.\n   */\n  register<E extends HookEvent>(event: E, matcher: HookMatcher<E>): () => void {\n    const list = ensureList(this.global, event);\n    list.push(widen(matcher));\n    return () => {\n      removeFromList(list, matcher);\n    };\n  }\n\n  /**\n   * Register a matcher for a specific session. Cleared automatically when\n   * `clearSession(sessionId)` is called, or can be removed directly via the\n   * returned unregister function.\n   */\n  registerSession<E extends HookEvent>(\n    sessionId: string,\n    event: E,\n    matcher: HookMatcher<E>\n  ): () => void {\n    const bucket = this.ensureSessionBucket(sessionId);\n    const list = ensureList(bucket, event);\n    list.push(widen(matcher));\n    return () => {\n      removeFromList(list, matcher);\n    };\n  }\n\n  /**\n   * Returns all matchers registered for `event`, concatenating global first\n   * and then session-specific (when `sessionId` is supplied). The caller\n   * receives a fresh array, so iterating it is safe even if a matcher is\n   * removed mid-iteration (e.g. via `once: true`).\n   */\n  getMatchers<E extends HookEvent>(\n    event: E,\n    sessionId?: string\n  ): HookMatcher<E>[] {\n    const globalList = readList(this.global, event);\n    if (sessionId === undefined) {\n      return snapshot<E>(globalList);\n    }\n    const bucket = this.sessions.get(sessionId);\n    if (bucket === undefined) {\n      return snapshot<E>(globalList);\n    }\n    const sessionList = readList(bucket, event);\n    if (globalList.length === 0) {\n      return snapshot<E>(sessionList);\n    }\n    if (sessionList.length === 0) {\n      return snapshot<E>(globalList);\n    }\n    return snapshot<E>([...globalList, ...sessionList]);\n  }\n\n  /**\n   * Removes `matcher` by reference from global storage first, falling back\n   * to the session bucket when `sessionId` is supplied. Used by\n   * `executeHooks` to drop `once: true` matchers after they fire.\n   */\n  removeMatcher<E extends HookEvent>(\n    event: E,\n    matcher: HookMatcher<E>,\n    sessionId?: string\n  ): boolean {\n    if (removeFromList(readList(this.global, event), matcher)) {\n      return true;\n    }\n    if (sessionId === undefined) {\n      return false;\n    }\n    const bucket = this.sessions.get(sessionId);\n    if (bucket === undefined) {\n      return false;\n    }\n    return removeFromList(readList(bucket, event), matcher);\n  }\n\n  /**\n   * Drops every session-scoped matcher for `sessionId`. Call this in the\n   * `finally` block around a Run so a `once: true` hook that never fired\n   * cannot leak into the next session on the same registry.\n   */\n  clearSession(sessionId: string): void {\n    this.sessions.delete(sessionId);\n  }\n\n  /**\n   * Raise a halt signal scoped to `sessionId` (= the run id the hook\n   * fired under). The SDK's run loop polls for this between stream\n   * events with the run's own id. First-write-wins per session: a\n   * halt already raised by an earlier hook in the same run is\n   * preserved so the original `reason` / `source` aren't overwritten.\n   *\n   * Per-session scoping is critical when hosts share one registry\n   * across concurrent runs (e.g. a global policy registered once and\n   * reused). Without it, a `preventContinuation` from run A would\n   * trip run B's stream-loop poll on the next iteration and silently\n   * terminate an unrelated run.\n   *\n   * Called by the SDK after `executeHooks` returns an aggregate with\n   * `preventContinuation: true`. Hosts can also call it directly from\n   * inside a hook callback if they want to halt without going through\n   * the aggregated return value, but `preventContinuation` is the\n   * canonical path.\n   */\n  haltRun(sessionId: string, reason: string, source: HookEvent): void {\n    if (this.haltSignals.has(sessionId)) {\n      return;\n    }\n    this.haltSignals.set(sessionId, { reason, source });\n  }\n\n  /**\n   * Returns the halt signal raised by hooks running under `sessionId`,\n   * or `undefined` if no hook in that run has halted. Polled by\n   * `Run.processStream` between stream events using the run's own id.\n   */\n  getHaltSignal(sessionId: string): HookHaltSignal | undefined {\n    return this.haltSignals.get(sessionId);\n  }\n\n  /**\n   * Clears the halt signal for `sessionId`. Called by\n   * `Run.processStream` in its `finally` block so a subsequent\n   * invocation of the same Run (e.g. resume) starts with a fresh\n   * halt state. No-op when no signal exists for that session.\n   */\n  clearHaltSignal(sessionId: string): void {\n    this.haltSignals.delete(sessionId);\n  }\n\n  /**\n   * True when any registered hook can alter a tool result before or after\n   * execution (`PreToolUse`, `PostToolUse`, `PostToolUseFailure`). Eager\n   * tool execution and early completion emission gate on this instead of\n   * registry presence, so observation-only registries (e.g. a\n   * `PostToolBatch` steering drain) keep those fast paths. With\n   * `sessionId`, checks global + that session; without it, conservatively\n   * scans every session bucket.\n   */\n  hasResultAlteringHooks(sessionId?: string): boolean {\n    if (hasResultAlteringInBucket(this.global)) {\n      return true;\n    }\n    if (sessionId !== undefined) {\n      const bucket = this.sessions.get(sessionId);\n      return bucket !== undefined && hasResultAlteringInBucket(bucket);\n    }\n    for (const bucket of this.sessions.values()) {\n      if (hasResultAlteringInBucket(bucket)) {\n        return true;\n      }\n    }\n    return false;\n  }\n\n  /** True if at least one matcher exists for `event` (global + session). */\n  hasHookFor(event: HookEvent, sessionId?: string): boolean {\n    if (readList(this.global, event).length > 0) {\n      return true;\n    }\n    if (sessionId === undefined) {\n      return false;\n    }\n    const bucket = this.sessions.get(sessionId);\n    if (bucket === undefined) {\n      return false;\n    }\n    return readList(bucket, event).length > 0;\n  }\n\n  /**\n   * True when at least one matcher for `event` would actually DISPATCH on a\n   * query-less call — a wildcard pattern with a non-empty `hooks` array.\n   *\n   * `hasHookFor` answers \"is one registered\", which is not the same question:\n   * a matcher carrying a pattern is inert for events that supply no\n   * `matchQuery`, so a caller using registration as a proxy for \"something\n   * will run\" can act on a hook that never fires. Mirrors the two skips in\n   * `executeHooks` (pattern mismatch, empty `hooks`).\n   *\n   * Non-allocating on purpose — `StandardGraph.canClaimPreemptSeal` reads it\n   * once per streamed chunk, where `getMatchers`' defensive `slice()` would\n   * allocate on every delta.\n   */\n  hasDispatchableHookFor(event: HookEvent, sessionId?: string): boolean {\n    if (hasDispatchableInList(readList(this.global, event))) {\n      return true;\n    }\n    if (sessionId === undefined) {\n      return false;\n    }\n    const bucket = this.sessions.get(sessionId);\n    if (bucket === undefined) {\n      return false;\n    }\n    return hasDispatchableInList(readList(bucket, event));\n  }\n\n  private ensureSessionBucket(sessionId: string): MatcherBucket {\n    const existing = this.sessions.get(sessionId);\n    if (existing !== undefined) {\n      return existing;\n    }\n    const fresh: MatcherBucket = {};\n    this.sessions.set(sessionId, fresh);\n    return fresh;\n  }\n}\n\nfunction ensureList(\n  bucket: MatcherBucket,\n  event: HookEvent\n): HookMatcher<HookEvent>[] {\n  const existing = bucket[event];\n  if (existing !== undefined) {\n    return existing;\n  }\n  const fresh: HookMatcher<HookEvent>[] = [];\n  bucket[event] = fresh;\n  return fresh;\n}\n\nfunction readList(\n  bucket: MatcherBucket,\n  event: HookEvent\n): HookMatcher<HookEvent>[] {\n  return bucket[event] ?? [];\n}\n\nfunction hasDispatchableInList(list: HookMatcher<HookEvent>[]): boolean {\n  for (const matcher of list) {\n    if (\n      (matcher.pattern === undefined || matcher.pattern === '') &&\n      matcher.hooks.length > 0\n    ) {\n      return true;\n    }\n  }\n  return false;\n}\n\nfunction hasResultAlteringInBucket(bucket: MatcherBucket): boolean {\n  for (const event of RESULT_ALTERING_HOOK_EVENTS) {\n    if (readList(bucket, event).length > 0) {\n      return true;\n    }\n  }\n  return false;\n}\n\nfunction removeFromList<E extends HookEvent>(\n  list: HookMatcher<HookEvent>[],\n  matcher: HookMatcher<E>\n): boolean {\n  const idx = list.indexOf(widen(matcher));\n  if (idx < 0) {\n    return false;\n  }\n  list.splice(idx, 1);\n  return true;\n}\n\n/**\n * Widen a per-event matcher to the storage's uniform slot type. Unsound at\n * the type level (function parameters are contravariant) but safe by\n * construction: `HookRegistry.register<E>` only ever puts matchers into the\n * bucket slot for their own event, and reads go through `snapshot<E>`\n * which is only called with the same `E`.\n */\nfunction widen<E extends HookEvent>(\n  matcher: HookMatcher<E>\n): HookMatcher<HookEvent> {\n  return matcher as unknown as HookMatcher<HookEvent>;\n}\n\n/**\n * Narrow a storage list back to a per-event matcher list on the way out.\n * Sound counterpart to `widen`: the list only contains matchers that were\n * registered against `E`, because the public API enforces it on insert.\n */\nfunction snapshot<E extends HookEvent>(\n  list: readonly HookMatcher<HookEvent>[]\n): HookMatcher<E>[] {\n  return list.slice() as unknown as HookMatcher<E>[];\n}\n"],"mappings":"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"}

package/dist/cjs/hooks/index.cjs

@@ -12,7 +12,19 @@ require("./types.cjs");
 * be consumed by an SDK version that would silently drop it.
 */
 const HOOK_INJECTED_MESSAGES_CAPABLE = true;
+/**
+* Feature probe for hosts: this SDK dispatches `PreemptBoundary`, so a
+* cooperative mid-generation seal can drain into the run.
+*
+* Deliberately separate from {@link HOOK_INJECTED_MESSAGES_CAPABLE} — an SDK
+* version can support `injectedMessages` at the tool boundary and know
+* nothing about preemption. A host that probed the wrong flag would arm an
+* interrupt control whose seal request is silently ignored, which reads to
+* the user as a dead button rather than as an unsupported feature.
+*/
+const HOOK_PREEMPT_BOUNDARY_CAPABLE = true;
 //#endregion
 exports.HOOK_INJECTED_MESSAGES_CAPABLE = HOOK_INJECTED_MESSAGES_CAPABLE;
+exports.HOOK_PREEMPT_BOUNDARY_CAPABLE = HOOK_PREEMPT_BOUNDARY_CAPABLE;
 
 //# sourceMappingURL=index.cjs.map

package/dist/cjs/hooks/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":[],"sources":["../../../src/hooks/index.ts"],"sourcesContent":["// src/hooks/index.ts\n//\n// Hook lifecycle system for `@librechat/agents`. Re-exported from\n// `src/index.ts` and consumed by `Run.processStream` (RunStart,\n// UserPromptSubmit, Stop, StopFailure), `ToolNode.dispatchToolEvents`\n// (PreToolUse, PostToolUse, PostToolUseFailure, PermissionDenied),\n// `createSummarizeNode` (PreCompact, PostCompact), and\n// `SubagentExecutor.execute` (SubagentStart, SubagentStop).\nexport { HookRegistry } from './HookRegistry';\nexport type { HookHaltSignal } from './HookRegistry';\nexport { executeHooks, DEFAULT_HOOK_TIMEOUT_MS } from './executeHooks';\n/**\n * Feature probe for hosts: hook outputs support `injectedMessages`\n * (per-message graph-state injection at the `PostToolBatch` boundary).\n * Hosts must gate drain-style hooks on this so a queued message can never\n * be consumed by an SDK version that would silently drop it.\n */\nexport const HOOK_INJECTED_MESSAGES_CAPABLE = true;\nexport {\n  matchesQuery,\n  hasNestedQuantifier,\n  MAX_PATTERN_LENGTH,\n  MAX_CACHE_SIZE,\n} from './matchers';\nexport { createToolPolicyHook } from './createToolPolicyHook';\nexport type { ToolPolicyMode, ToolPolicyConfig } from './createToolPolicyHook';\nexport { createWorkspacePolicyHook } from './createWorkspacePolicyHook';\nexport type {\n  OutsideAccessPolicy,\n  WorkspacePolicyConfig,\n  PathExtractor,\n} from './createWorkspacePolicyHook';\nexport { HOOK_EVENTS } from './types';\nexport type {\n  HookEvent,\n  HookInput,\n  HookOutput,\n  HookCallback,\n  HookMatcher,\n  HooksByEvent,\n  HookInputByEvent,\n  HookOutputByEvent,\n  BaseHookInput,\n  BaseHookOutput,\n  ToolDecision,\n  StopDecision,\n  AggregatedHookResult,\n  RunStartHookInput,\n  UserPromptSubmitHookInput,\n  PreToolUseHookInput,\n  PostToolUseHookInput,\n  PostToolUseFailureHookInput,\n  PostToolBatchHookInput,\n  PostToolBatchEntry,\n  PermissionDeniedHookInput,\n  SubagentStartHookInput,\n  SubagentStopHookInput,\n  StopHookInput,\n  StopFailureHookInput,\n  PreCompactHookInput,\n  PostCompactHookInput,\n  RunStartHookOutput,\n  UserPromptSubmitHookOutput,\n  PreToolUseHookOutput,\n  PostToolUseHookOutput,\n  PostToolUseFailureHookOutput,\n  PostToolBatchHookOutput,\n  PermissionDeniedHookOutput,\n  SubagentStartHookOutput,\n  SubagentStopHookOutput,\n  StopHookOutput,\n  StopFailureHookOutput,\n  PreCompactHookOutput,\n  PostCompactHookOutput,\n} from './types';\nexport type { ExecuteHooksOptions } from './executeHooks';\n"],"mappings":";;;;;;;;;;;;;AAiBA,MAAa,iCAAiC"}
+{"version":3,"file":"index.cjs","names":[],"sources":["../../../src/hooks/index.ts"],"sourcesContent":["// src/hooks/index.ts\n//\n// Hook lifecycle system for `@librechat/agents`. Re-exported from\n// `src/index.ts` and consumed by `Run.processStream` (RunStart,\n// UserPromptSubmit, Stop, StopFailure), `ToolNode.dispatchToolEvents`\n// (PreToolUse, PostToolUse, PostToolUseFailure, PermissionDenied),\n// `createSummarizeNode` (PreCompact, PostCompact),\n// `SubagentExecutor.execute` (SubagentStart, SubagentStop), and\n// `StandardGraph.createCallModel` (PreemptBoundary).\nexport { HookRegistry } from './HookRegistry';\nexport type { HookHaltSignal } from './HookRegistry';\nexport { executeHooks, DEFAULT_HOOK_TIMEOUT_MS } from './executeHooks';\n/**\n * Feature probe for hosts: hook outputs support `injectedMessages`\n * (per-message graph-state injection at the `PostToolBatch` boundary).\n * Hosts must gate drain-style hooks on this so a queued message can never\n * be consumed by an SDK version that would silently drop it.\n */\nexport const HOOK_INJECTED_MESSAGES_CAPABLE = true;\n/**\n * Feature probe for hosts: this SDK dispatches `PreemptBoundary`, so a\n * cooperative mid-generation seal can drain into the run.\n *\n * Deliberately separate from {@link HOOK_INJECTED_MESSAGES_CAPABLE} — an SDK\n * version can support `injectedMessages` at the tool boundary and know\n * nothing about preemption. A host that probed the wrong flag would arm an\n * interrupt control whose seal request is silently ignored, which reads to\n * the user as a dead button rather than as an unsupported feature.\n */\nexport const HOOK_PREEMPT_BOUNDARY_CAPABLE = true;\nexport {\n  matchesQuery,\n  hasNestedQuantifier,\n  MAX_PATTERN_LENGTH,\n  MAX_CACHE_SIZE,\n} from './matchers';\nexport { createToolPolicyHook } from './createToolPolicyHook';\nexport type { ToolPolicyMode, ToolPolicyConfig } from './createToolPolicyHook';\nexport { createWorkspacePolicyHook } from './createWorkspacePolicyHook';\nexport type {\n  OutsideAccessPolicy,\n  WorkspacePolicyConfig,\n  PathExtractor,\n} from './createWorkspacePolicyHook';\nexport { HOOK_EVENTS } from './types';\nexport type {\n  HookEvent,\n  HookInput,\n  HookOutput,\n  HookCallback,\n  HookMatcher,\n  HooksByEvent,\n  HookInputByEvent,\n  HookOutputByEvent,\n  BaseHookInput,\n  BaseHookOutput,\n  ToolDecision,\n  StopDecision,\n  AggregatedHookResult,\n  RunStartHookInput,\n  UserPromptSubmitHookInput,\n  PreToolUseHookInput,\n  PostToolUseHookInput,\n  PostToolUseFailureHookInput,\n  PostToolBatchHookInput,\n  PostToolBatchEntry,\n  PreemptBoundaryHookInput,\n  PermissionDeniedHookInput,\n  SubagentStartHookInput,\n  SubagentStopHookInput,\n  StopHookInput,\n  StopFailureHookInput,\n  PreCompactHookInput,\n  PostCompactHookInput,\n  RunStartHookOutput,\n  UserPromptSubmitHookOutput,\n  PreToolUseHookOutput,\n  PostToolUseHookOutput,\n  PostToolUseFailureHookOutput,\n  PostToolBatchHookOutput,\n  PreemptBoundaryHookOutput,\n  PermissionDeniedHookOutput,\n  SubagentStartHookOutput,\n  SubagentStopHookOutput,\n  StopHookOutput,\n  StopFailureHookOutput,\n  PreCompactHookOutput,\n  PostCompactHookOutput,\n} from './types';\nexport type { ExecuteHooksOptions } from './executeHooks';\n"],"mappings":";;;;;;;;;;;;;AAkBA,MAAa,iCAAiC;;;;;;;;;;;AAW9C,MAAa,gCAAgC"}

package/dist/cjs/hooks/types.cjs

@@ -14,6 +14,7 @@ const HOOK_EVENTS = [
 	"PostToolUse",
 	"PostToolUseFailure",
 	"PostToolBatch",
+	"PreemptBoundary",
 	"PermissionDenied",
 	"SubagentStart",
 	"SubagentStop",

package/dist/cjs/hooks/types.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"types.cjs","names":[],"sources":["../../../src/hooks/types.ts"],"sourcesContent":["// src/hooks/types.ts\nimport type { BaseMessage } from '@langchain/core/messages';\nimport type { InjectedMessage } from '@/types/tools';\n\n/**\n * Closed set of hook lifecycle events supported by the hooks system.\n *\n * These mirror the subset of Claude Code's event surface that makes sense\n * for a library context (no filesystem/CLI-specific events). See\n * `docs/hooks-design-report.md` §3.2 for the mapping to existing\n * `@librechat/agents` emission points.\n */\nexport const HOOK_EVENTS = [\n  'RunStart',\n  'UserPromptSubmit',\n  'PreToolUse',\n  'PostToolUse',\n  'PostToolUseFailure',\n  'PostToolBatch',\n  'PermissionDenied',\n  'SubagentStart',\n  'SubagentStop',\n  'Stop',\n  'StopFailure',\n  'PreCompact',\n  'PostCompact',\n] as const;\n\nexport type HookEvent = (typeof HOOK_EVENTS)[number];\n\n/** Tool-gating decision; executeHooks folds with `deny > ask > allow` precedence. */\nexport type ToolDecision = 'allow' | 'deny' | 'ask';\n\n/** Stop-loop decision; `block` means \"do not stop, run another turn\". Any `block` wins. */\nexport type StopDecision = 'continue' | 'block';\n\n/**\n * Fields shared by every `HookInput`. Discriminated by `hook_event_name`.\n *\n * - `runId` identifies the current agent run and is always present.\n * - `threadId` identifies the conversation thread when the host has one.\n * - `agentId` is only set when the hook fires inside a subagent scope.\n * - `executingAgentId` identifies the agent that owns the node emitting the hook,\n *   whenever the graph knows it — including top-level agents in a multi-agent\n *   graph (where `agentId` is intentionally undefined). Use this to attribute a\n *   hook to a specific agent regardless of subagent scope.\n */\nexport interface BaseHookInput {\n  runId: string;\n  threadId?: string;\n  agentId?: string;\n  executingAgentId?: string;\n}\n\nexport interface RunStartHookInput extends BaseHookInput {\n  hook_event_name: 'RunStart';\n  messages: BaseMessage[];\n}\n\nexport interface UserPromptSubmitHookInput extends BaseHookInput {\n  hook_event_name: 'UserPromptSubmit';\n  prompt: string;\n  attachments?: BaseMessage[];\n}\n\n/**\n * Fires before a tool is invoked. Hook may return `deny`/`ask`/`allow` and/or\n * an `updatedInput` that replaces the tool arguments before invocation.\n *\n * `toolInput` is intentionally typed as `Record<string, unknown>` because the\n * SDK is tool-agnostic — concrete tool argument shapes are only known at the\n * call site and are narrowed by the host. This is the one escape hatch in\n * the hook type system.\n */\nexport interface PreToolUseHookInput extends BaseHookInput {\n  hook_event_name: 'PreToolUse';\n  toolName: string;\n  toolInput: Record<string, unknown>;\n  toolUseId: string;\n  stepId?: string;\n  /**\n   * Number of times this tool has been invoked in prior batches within the\n   * current run. Within a single batch of parallel calls, all calls to the\n   * same tool share the same turn value — per-call discrimination within a\n   * batch is not supported in v1.\n   */\n  turn?: number;\n}\n\nexport interface PostToolUseHookInput extends BaseHookInput {\n  hook_event_name: 'PostToolUse';\n  toolName: string;\n  toolInput: Record<string, unknown>;\n  toolOutput: unknown;\n  toolUseId: string;\n  stepId?: string;\n  turn?: number;\n}\n\nexport interface PostToolUseFailureHookInput extends BaseHookInput {\n  hook_event_name: 'PostToolUseFailure';\n  toolName: string;\n  toolInput: Record<string, unknown>;\n  toolUseId: string;\n  error: string;\n  stepId?: string;\n  turn?: number;\n}\n\n/**\n * Per-tool result snapshot included in a `PostToolBatch` event. Mirrors\n * the data PostToolUse / PostToolUseFailure get individually, but the\n * batch view lets a single hook see the whole set so it can inject one\n * consolidated convention/audit message rather than N per-tool ones.\n */\nexport interface PostToolBatchEntry {\n  toolName: string;\n  toolInput: Record<string, unknown>;\n  toolUseId: string;\n  stepId?: string;\n  turn?: number;\n  /** Successful tool output, present only when `status === 'success'`. */\n  toolOutput?: unknown;\n  /** Error message, present only when `status === 'error'`. */\n  error?: string;\n  status: 'success' | 'error';\n}\n\n/**\n * Fires once after every tool call in a single batch finishes (including\n * any that were rejected via HITL). Lets a hook react to the batch as a\n * whole — useful for \"inject conventions once for the whole batch\", batch\n * audit logging, or coordinating cleanup that depends on knowing the full\n * result set rather than streaming each tool's result independently.\n *\n * Order: fires AFTER all per-tool PostToolUse / PostToolUseFailure hooks\n * for the same batch have completed, BEFORE the next model call. Pass an\n * `additionalContext` to inject context for that next model turn, or\n * `injectedMessages` to inject standalone per-message user speech (e.g.\n * mid-run steering) that must not be consolidated with hook context.\n */\nexport interface PostToolBatchHookInput extends BaseHookInput {\n  hook_event_name: 'PostToolBatch';\n  /** All tool calls (and their outcomes) from this batch, in batch order. */\n  entries: PostToolBatchEntry[];\n}\n\nexport interface PermissionDeniedHookInput extends BaseHookInput {\n  hook_event_name: 'PermissionDenied';\n  toolName: string;\n  toolInput: Record<string, unknown>;\n  toolUseId: string;\n  reason: string;\n}\n\nexport interface SubagentStartHookInput extends BaseHookInput {\n  hook_event_name: 'SubagentStart';\n  parentAgentId?: string;\n  agentId: string;\n  agentType: string;\n  inputs: BaseMessage[];\n}\n\nexport interface SubagentStopHookInput extends BaseHookInput {\n  hook_event_name: 'SubagentStop';\n  agentId: string;\n  agentType: string;\n  messages: BaseMessage[];\n}\n\nexport interface StopHookInput extends BaseHookInput {\n  hook_event_name: 'Stop';\n  messages: BaseMessage[];\n  stopReason?: string;\n  stopHookActive: boolean;\n}\n\nexport interface StopFailureHookInput extends BaseHookInput {\n  hook_event_name: 'StopFailure';\n  error: string;\n  lastAssistantMessage?: BaseMessage;\n}\n\nexport interface PreCompactHookInput extends BaseHookInput {\n  hook_event_name: 'PreCompact';\n  messagesBeforeCount: number;\n  /**\n   * What triggered compaction. Matches `SummarizationTrigger.type` from the\n   * agent's summarization config. `'default'` means no trigger was\n   * configured and compaction fired because messages were pruned.\n   */\n  trigger:\n    | 'token_ratio'\n    | 'remaining_tokens'\n    | 'messages_to_refine'\n    | 'default'\n    | (string & {});\n}\n\nexport interface PostCompactHookInput extends BaseHookInput {\n  hook_event_name: 'PostCompact';\n  summary: string;\n  /**\n   * Number of messages remaining after compaction. The summarize node\n   * returns a `removeAll` signal that clears all messages from state;\n   * the summary itself is injected into the system prompt, not as a\n   * message. This is `0` at the point of hook dispatch.\n   */\n  messagesAfterCount: number;\n}\n\n/** Discriminated union of every hook input shape. */\nexport type HookInput =\n  | RunStartHookInput\n  | UserPromptSubmitHookInput\n  | PreToolUseHookInput\n  | PostToolUseHookInput\n  | PostToolUseFailureHookInput\n  | PostToolBatchHookInput\n  | PermissionDeniedHookInput\n  | SubagentStartHookInput\n  | SubagentStopHookInput\n  | StopHookInput\n  | StopFailureHookInput\n  | PreCompactHookInput\n  | PostCompactHookInput;\n\n/** Compile-time map from event name to its input shape. */\nexport type HookInputByEvent = {\n  RunStart: RunStartHookInput;\n  UserPromptSubmit: UserPromptSubmitHookInput;\n  PreToolUse: PreToolUseHookInput;\n  PostToolUse: PostToolUseHookInput;\n  PostToolUseFailure: PostToolUseFailureHookInput;\n  PostToolBatch: PostToolBatchHookInput;\n  PermissionDenied: PermissionDeniedHookInput;\n  SubagentStart: SubagentStartHookInput;\n  SubagentStop: SubagentStopHookInput;\n  Stop: StopHookInput;\n  StopFailure: StopFailureHookInput;\n  PreCompact: PreCompactHookInput;\n  PostCompact: PostCompactHookInput;\n};\n\n/**\n * Fields common to every hook output. Hooks that have nothing to say simply\n * return `{}` (or omit the fields below).\n */\nexport interface BaseHookOutput {\n  /** Context string to inject into the conversation. Accumulated across hooks. */\n  additionalContext?: string;\n  /**\n   * Messages to inject into graph state, one `HumanMessage` per entry\n   * (converted via `ToolNode.convertInjectedMessages`, which preserves\n   * `role`/`source`/`isMeta` in `additional_kwargs`). Unlike\n   * `additionalContext` — which is consolidated across hooks into a single\n   * system-flavored message — each entry keeps its own identity and role,\n   * making this the channel for injecting verbatim user speech (e.g. a\n   * mid-run steering message). Accumulated across hooks in registration\n   * order. Currently consumed only at the `PostToolBatch` dispatch site;\n   * other events ignore the field.\n   */\n  injectedMessages?: InjectedMessage[];\n  /** True to prevent the next model turn. Any hook can set this. */\n  preventContinuation?: boolean;\n  /** Reason reported alongside `preventContinuation`. */\n  stopReason?: string;\n  /**\n   * Marks this hook output as fire-and-forget for INFLUENCE only.\n   * When `true`, the SDK skips every other field on this output —\n   * `decision`, `additionalContext`, `updatedInput`,\n   * `preventContinuation`, `allowedDecisions`, `updatedOutput` are\n   * all ignored. The hook's return value cannot block, modify, or\n   * inject context, so it's safe to use for pure side effects\n   * (logging, metrics, webhooks).\n   *\n   * Important caveat: the hook's CALLBACK promise is still awaited\n   * by `executeHooks` (subject to the matcher's timeout and the\n   * default `DEFAULT_HOOK_TIMEOUT_MS`). The SDK does not\n   * speculatively detach hooks based on output shape, because the\n   * shape is only known after the promise resolves. For TRUE\n   * fire-and-forget where the agent doesn't wait at all, the hook\n   * body should detach its side effect itself and return\n   * immediately:\n   *\n   * @example\n   * ```ts\n   * async (input) => {\n   *   // Detach the slow work — the SDK awaits this hook's\n   *   // returned promise, which resolves immediately because we\n   *   // don't `await` the side effect.\n   *   void sendToLoggingService(input).catch(console.error);\n   *   return { async: true };\n   * };\n   * ```\n   *\n   * @example WRONG — the agent will block on the webhook\n   * ```ts\n   * async (input) => {\n   *   await sendToLoggingService(input);  // ← awaited, blocks\n   *   return { async: true };  // returning async:true doesn't undo the await\n   * };\n   * ```\n   *\n   * Mirrors Claude Code Agent SDK's `async` output, with the same\n   * \"detach inside the hook body\" pattern.\n   */\n  async?: boolean;\n  /**\n   * Optional advisory timeout in milliseconds for the background work\n   * a host has detached inside an `async: true` hook body. The SDK\n   * does not enforce this (the hook's own AbortSignal handling does)\n   * but the field is preserved on the wire so downstream\n   * observability can surface long-running side effects. Ignored\n   * unless `async` is true.\n   */\n  asyncTimeout?: number;\n}\n\nexport type RunStartHookOutput = BaseHookOutput;\n\nexport interface UserPromptSubmitHookOutput extends BaseHookOutput {\n  decision?: ToolDecision;\n  reason?: string;\n}\n\nexport interface PreToolUseHookOutput extends BaseHookOutput {\n  decision?: ToolDecision;\n  reason?: string;\n  /**\n   * Replacement tool input. Merged into the pending tool call by the host.\n   *\n   * When multiple hooks set `updatedInput` within a single `executeHooks`\n   * call, the last writer in registration order wins (outer loop: matcher\n   * registration order; inner loop: hook position within the matcher). The\n   * winner is deterministic — `Promise.all` preserves input-array order.\n   * Consumers that need a single authoritative rewrite should still scope\n   * `updatedInput` to one hook per matcher to avoid confusing precedence.\n   */\n  updatedInput?: Record<string, unknown>;\n  /**\n   * Restricts which decisions the host UI is allowed to surface for this\n   * tool call when the hook returns `decision: 'ask'`. Pass to lock a\n   * tool down to a subset of `'approve' | 'reject' | 'edit' | 'respond'`\n   * — for example, `['approve', 'reject']` to forbid the user from\n   * editing the tool's args or substituting a custom response.\n   *\n   * The values flow into the resulting interrupt's\n   * `review_configs[i].allowed_decisions`. Omitting the field keeps the\n   * SDK default (all four decisions advertised). Last-writer-wins in\n   * registration order, same precedence rules as `updatedInput`.\n   */\n  allowedDecisions?: ReadonlyArray<'approve' | 'reject' | 'edit' | 'respond'>;\n}\n\nexport interface PostToolUseHookOutput extends BaseHookOutput {\n  /**\n   * Replacement tool output. Flows through the aggregated result so the\n   * host can substitute it before appending the tool result message.\n   * Ordering semantics match `PreToolUseHookOutput.updatedInput`:\n   * last-writer-wins in registration order.\n   */\n  updatedOutput?: unknown;\n}\n\nexport type PostToolUseFailureHookOutput = BaseHookOutput;\n\nexport type PostToolBatchHookOutput = BaseHookOutput;\n\nexport type PermissionDeniedHookOutput = BaseHookOutput;\n\nexport interface SubagentStartHookOutput extends BaseHookOutput {\n  decision?: ToolDecision;\n  reason?: string;\n}\n\nexport type SubagentStopHookOutput = BaseHookOutput;\n\nexport interface StopHookOutput extends BaseHookOutput {\n  decision?: StopDecision;\n  reason?: string;\n}\n\nexport type StopFailureHookOutput = BaseHookOutput;\n\nexport type PreCompactHookOutput = BaseHookOutput;\n\nexport type PostCompactHookOutput = BaseHookOutput;\n\n/** Compile-time map from event name to its output shape. */\nexport type HookOutputByEvent = {\n  RunStart: RunStartHookOutput;\n  UserPromptSubmit: UserPromptSubmitHookOutput;\n  PreToolUse: PreToolUseHookOutput;\n  PostToolUse: PostToolUseHookOutput;\n  PostToolUseFailure: PostToolUseFailureHookOutput;\n  PostToolBatch: PostToolBatchHookOutput;\n  PermissionDenied: PermissionDeniedHookOutput;\n  SubagentStart: SubagentStartHookOutput;\n  SubagentStop: SubagentStopHookOutput;\n  Stop: StopHookOutput;\n  StopFailure: StopFailureHookOutput;\n  PreCompact: PreCompactHookOutput;\n  PostCompact: PostCompactHookOutput;\n};\n\n/** Superset output shape used by the executor's fold loop. */\nexport type HookOutput =\n  | RunStartHookOutput\n  | UserPromptSubmitHookOutput\n  | PreToolUseHookOutput\n  | PostToolUseHookOutput\n  | PostToolUseFailureHookOutput\n  | PostToolBatchHookOutput\n  | PermissionDeniedHookOutput\n  | SubagentStartHookOutput\n  | SubagentStopHookOutput\n  | StopHookOutput\n  | StopFailureHookOutput\n  | PreCompactHookOutput\n  | PostCompactHookOutput;\n\n/**\n * A hook callback is a plain async function registered against a specific\n * event. The `signal` is always supplied by `executeHooks` and combines the\n * batch's parent signal with the per-hook timeout — callbacks that perform\n * long-running work should observe it.\n */\nexport type HookCallback<E extends HookEvent = HookEvent> = (\n  input: HookInputByEvent[E],\n  signal: AbortSignal\n) => HookOutputByEvent[E] | Promise<HookOutputByEvent[E]>;\n\n/**\n * A matcher groups one or more callbacks under a shared regex filter and\n * shared timeout/once/internal flags. The generic `E` ties the callback\n * types to the event the matcher is registered against.\n */\nexport interface HookMatcher<E extends HookEvent = HookEvent> {\n  /**\n   * Regex pattern matched against the event's primary query string (e.g.\n   * the tool name for `PreToolUse`, the agent type for `SubagentStart`).\n   *\n   * Omitted or empty means \"always match\". For events that do not supply a\n   * query string (`RunStart`, `Stop`, etc.), only wildcard matchers fire —\n   * a non-empty pattern on such events will never match.\n   *\n   * Patterns are treated as trusted input: `executeHooks` compiles them\n   * with `new RegExp(pattern)` without any sandbox, and a pathological\n   * pattern can block the event loop. Host registration code is expected\n   * to validate or length-bound patterns that originate from user input.\n   */\n  pattern?: string;\n  /** Callbacks that fire when the matcher hits. Executed in parallel. */\n  hooks: HookCallback<E>[];\n  /** Per-matcher timeout in ms. Defaults to the executor's batch timeout. */\n  timeout?: number;\n  /**\n   * Atomically remove the matcher before its first dispatch.\n   *\n   * `executeHooks` claims `once: true` matchers synchronously — between\n   * `getMatchers` and its first `await` — so two concurrent calls cannot\n   * both dispatch the same matcher. Whichever call runs its sync prefix\n   * first wins the matcher; the other sees an empty bucket.\n   *\n   * Semantics are \"at most one dispatch, ever\" — if every hook in the\n   * matcher throws, the matcher is still gone. Use `once` for\n   * fire-and-forget bootstrapping (registration, telemetry, setup). Hosts\n   * that need retry semantics should register a normal matcher and\n   * self-unregister via the callback returned from `registry.register`.\n   */\n  once?: boolean;\n  /** Internal hooks are excluded from telemetry and non-fatal error logging. */\n  internal?: boolean;\n}\n\n/**\n * Storage shape for matchers keyed by event. Each event's matcher list is\n * a generic array parameterized by that event type, so lookup via\n * `HooksByEvent[E]` preserves type-safe callback signatures.\n */\nexport type HooksByEvent = {\n  [E in HookEvent]?: HookMatcher<E>[];\n};\n\n/**\n * Aggregated result of a single `executeHooks` call. Fields are populated\n * according to the fold rules in `executeHooks.ts`.\n */\nexport interface AggregatedHookResult {\n  /** Folded tool-gating decision; `deny > ask > allow`. */\n  decision?: ToolDecision;\n  /** Folded stop decision; any `block` wins. */\n  stopDecision?: StopDecision;\n  /** Reason from the hook that set the winning decision. */\n  reason?: string;\n  /**\n   * Replacement tool input from a `PreToolUse` hook.\n   *\n   * Last-writer-wins in **registration order**: `executeHooks` uses\n   * `Promise.all`, which preserves input-array order, so the fold iterates\n   * outcomes in the same order they were pushed — outer loop over matchers\n   * as they sit in the registry, inner loop over each matcher's `hooks`\n   * array. The winner is therefore deterministic but may not match the\n   * order in which hooks actually completed. Consumers that want a single\n   * authoritative rewrite should still register one `updatedInput`-setting\n   * hook per matcher to avoid subtle precedence bugs.\n   */\n  updatedInput?: Record<string, unknown>;\n  /**\n   * Restricted decision set from a `PreToolUse` hook. Same last-writer-wins\n   * semantics as `updatedInput`. Surfaces to the interrupt payload's\n   * `review_configs[i].allowed_decisions`.\n   */\n  allowedDecisions?: ReadonlyArray<'approve' | 'reject' | 'edit' | 'respond'>;\n  /**\n   * Replacement tool output from a `PostToolUse` hook.\n   *\n   * Same last-writer-wins-in-registration-order semantics as\n   * `updatedInput`. Present only when at least one hook set it; `undefined`\n   * means \"use the original tool output\".\n   */\n  updatedOutput?: unknown;\n  /** Accumulated `additionalContext` strings from every hook, in order. */\n  additionalContexts: string[];\n  /** Accumulated `injectedMessages` from every hook, in registration order. */\n  injectedMessages: InjectedMessage[];\n  /** True if any hook returned `preventContinuation`. */\n  preventContinuation?: boolean;\n  /**\n   * Reason recorded alongside `preventContinuation`. First winner wins:\n   * once a hook sets both flags, later hooks that also set\n   * `preventContinuation` do not overwrite the reason.\n   */\n  stopReason?: string;\n  /** Error messages from hooks that threw; always present (possibly empty). */\n  errors: string[];\n}\n"],"mappings":";;;;;;;;;AAYA,MAAa,cAAc;CACzB;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF"}
+{"version":3,"file":"types.cjs","names":[],"sources":["../../../src/hooks/types.ts"],"sourcesContent":["// src/hooks/types.ts\nimport type { BaseMessage } from '@langchain/core/messages';\nimport type { InjectedMessage } from '@/types/tools';\n\n/**\n * Closed set of hook lifecycle events supported by the hooks system.\n *\n * These mirror the subset of Claude Code's event surface that makes sense\n * for a library context (no filesystem/CLI-specific events). See\n * `docs/hooks-design-report.md` §3.2 for the mapping to existing\n * `@librechat/agents` emission points.\n */\nexport const HOOK_EVENTS = [\n  'RunStart',\n  'UserPromptSubmit',\n  'PreToolUse',\n  'PostToolUse',\n  'PostToolUseFailure',\n  'PostToolBatch',\n  'PreemptBoundary',\n  'PermissionDenied',\n  'SubagentStart',\n  'SubagentStop',\n  'Stop',\n  'StopFailure',\n  'PreCompact',\n  'PostCompact',\n] as const;\n\nexport type HookEvent = (typeof HOOK_EVENTS)[number];\n\n/** Tool-gating decision; executeHooks folds with `deny > ask > allow` precedence. */\nexport type ToolDecision = 'allow' | 'deny' | 'ask';\n\n/** Stop-loop decision; `block` means \"do not stop, run another turn\". Any `block` wins. */\nexport type StopDecision = 'continue' | 'block';\n\n/**\n * Fields shared by every `HookInput`. Discriminated by `hook_event_name`.\n *\n * - `runId` identifies the current agent run and is always present.\n * - `threadId` identifies the conversation thread when the host has one.\n * - `agentId` is only set when the hook fires inside a subagent scope.\n * - `executingAgentId` identifies the agent that owns the node emitting the hook,\n *   whenever the graph knows it — including top-level agents in a multi-agent\n *   graph (where `agentId` is intentionally undefined). Use this to attribute a\n *   hook to a specific agent regardless of subagent scope.\n */\nexport interface BaseHookInput {\n  runId: string;\n  threadId?: string;\n  agentId?: string;\n  executingAgentId?: string;\n}\n\nexport interface RunStartHookInput extends BaseHookInput {\n  hook_event_name: 'RunStart';\n  messages: BaseMessage[];\n}\n\nexport interface UserPromptSubmitHookInput extends BaseHookInput {\n  hook_event_name: 'UserPromptSubmit';\n  prompt: string;\n  attachments?: BaseMessage[];\n}\n\n/**\n * Fires before a tool is invoked. Hook may return `deny`/`ask`/`allow` and/or\n * an `updatedInput` that replaces the tool arguments before invocation.\n *\n * `toolInput` is intentionally typed as `Record<string, unknown>` because the\n * SDK is tool-agnostic — concrete tool argument shapes are only known at the\n * call site and are narrowed by the host. This is the one escape hatch in\n * the hook type system.\n */\nexport interface PreToolUseHookInput extends BaseHookInput {\n  hook_event_name: 'PreToolUse';\n  toolName: string;\n  toolInput: Record<string, unknown>;\n  toolUseId: string;\n  stepId?: string;\n  /**\n   * Number of times this tool has been invoked in prior batches within the\n   * current run. Within a single batch of parallel calls, all calls to the\n   * same tool share the same turn value — per-call discrimination within a\n   * batch is not supported in v1.\n   */\n  turn?: number;\n}\n\nexport interface PostToolUseHookInput extends BaseHookInput {\n  hook_event_name: 'PostToolUse';\n  toolName: string;\n  toolInput: Record<string, unknown>;\n  toolOutput: unknown;\n  toolUseId: string;\n  stepId?: string;\n  turn?: number;\n}\n\nexport interface PostToolUseFailureHookInput extends BaseHookInput {\n  hook_event_name: 'PostToolUseFailure';\n  toolName: string;\n  toolInput: Record<string, unknown>;\n  toolUseId: string;\n  error: string;\n  stepId?: string;\n  turn?: number;\n}\n\n/**\n * Per-tool result snapshot included in a `PostToolBatch` event. Mirrors\n * the data PostToolUse / PostToolUseFailure get individually, but the\n * batch view lets a single hook see the whole set so it can inject one\n * consolidated convention/audit message rather than N per-tool ones.\n */\nexport interface PostToolBatchEntry {\n  toolName: string;\n  toolInput: Record<string, unknown>;\n  toolUseId: string;\n  stepId?: string;\n  turn?: number;\n  /** Successful tool output, present only when `status === 'success'`. */\n  toolOutput?: unknown;\n  /** Error message, present only when `status === 'error'`. */\n  error?: string;\n  status: 'success' | 'error';\n}\n\n/**\n * Fires once after every tool call in a single batch finishes (including\n * any that were rejected via HITL). Lets a hook react to the batch as a\n * whole — useful for \"inject conventions once for the whole batch\", batch\n * audit logging, or coordinating cleanup that depends on knowing the full\n * result set rather than streaming each tool's result independently.\n *\n * Order: fires AFTER all per-tool PostToolUse / PostToolUseFailure hooks\n * for the same batch have completed, BEFORE the next model call. Pass an\n * `additionalContext` to inject context for that next model turn, or\n * `injectedMessages` to inject standalone per-message user speech (e.g.\n * mid-run steering) that must not be consolidated with hook context.\n */\nexport interface PostToolBatchHookInput extends BaseHookInput {\n  hook_event_name: 'PostToolBatch';\n  /** All tool calls (and their outcomes) from this batch, in batch order. */\n  entries: PostToolBatchEntry[];\n}\n\n/**\n * Fires when a cooperative preemption seals the model stream mid-generation\n * — the second injection boundary, and the only one that exists during a\n * long text answer with no tool calls in it.\n *\n * Order: fires after the model stream is sealed and BEFORE the next model\n * call. The `injectedMessages` a hook returns here are appended verbatim and\n * the agent node self-loops. Returning nothing is a valid outcome (the host's\n * queue was cancelled or already drained): the run stops honestly rather than\n * self-looping into an empty turn.\n *\n * The sealed turn is NOT yet observable from graph state when this fires.\n * Dispatch happens inside the agent node, and only the outer graph's reducer\n * writes `StandardGraph.messages` — which cannot run until the node returns.\n * A hook calling `Run.getRunMessages()` here sees the state as of the last\n * completed superstep, so the sealed text is absent. `PostToolBatch` behaves\n * the same way: a tool-boundary hook cannot see the assistant turn that\n * requested the tool. This is a property of the single-node outer graph, not\n * of preemption, and committing first would mean returning from the node and\n * re-entering — precisely what the self-loop exists to avoid.\n *\n * A hook that needs the sealed text should therefore not go looking for it in\n * graph state. Decide from the host's own queue, or read it after the run.\n *\n * Requires `RunConfig.preemption`. This event is deliberately NOT\n * result-altering, so registering it never disables eager tool execution.\n */\nexport interface PreemptBoundaryHookInput extends BaseHookInput {\n  hook_event_name: 'PreemptBoundary';\n  /** 1-based index of this seal within the run. */\n  sealCount: number;\n}\n\nexport interface PermissionDeniedHookInput extends BaseHookInput {\n  hook_event_name: 'PermissionDenied';\n  toolName: string;\n  toolInput: Record<string, unknown>;\n  toolUseId: string;\n  reason: string;\n}\n\nexport interface SubagentStartHookInput extends BaseHookInput {\n  hook_event_name: 'SubagentStart';\n  parentAgentId?: string;\n  agentId: string;\n  agentType: string;\n  inputs: BaseMessage[];\n}\n\nexport interface SubagentStopHookInput extends BaseHookInput {\n  hook_event_name: 'SubagentStop';\n  agentId: string;\n  agentType: string;\n  messages: BaseMessage[];\n}\n\nexport interface StopHookInput extends BaseHookInput {\n  hook_event_name: 'Stop';\n  messages: BaseMessage[];\n  stopReason?: string;\n  stopHookActive: boolean;\n}\n\nexport interface StopFailureHookInput extends BaseHookInput {\n  hook_event_name: 'StopFailure';\n  error: string;\n  lastAssistantMessage?: BaseMessage;\n}\n\nexport interface PreCompactHookInput extends BaseHookInput {\n  hook_event_name: 'PreCompact';\n  messagesBeforeCount: number;\n  /**\n   * What triggered compaction. Matches `SummarizationTrigger.type` from the\n   * agent's summarization config. `'default'` means no trigger was\n   * configured and compaction fired because messages were pruned.\n   */\n  trigger:\n    | 'token_ratio'\n    | 'remaining_tokens'\n    | 'messages_to_refine'\n    | 'default'\n    | (string & {});\n}\n\nexport interface PostCompactHookInput extends BaseHookInput {\n  hook_event_name: 'PostCompact';\n  summary: string;\n  /**\n   * Number of messages remaining after compaction. The summarize node\n   * returns a `removeAll` signal that clears all messages from state;\n   * the summary itself is injected into the system prompt, not as a\n   * message. This is `0` at the point of hook dispatch.\n   */\n  messagesAfterCount: number;\n}\n\n/** Discriminated union of every hook input shape. */\nexport type HookInput =\n  | RunStartHookInput\n  | UserPromptSubmitHookInput\n  | PreToolUseHookInput\n  | PostToolUseHookInput\n  | PostToolUseFailureHookInput\n  | PostToolBatchHookInput\n  | PreemptBoundaryHookInput\n  | PermissionDeniedHookInput\n  | SubagentStartHookInput\n  | SubagentStopHookInput\n  | StopHookInput\n  | StopFailureHookInput\n  | PreCompactHookInput\n  | PostCompactHookInput;\n\n/** Compile-time map from event name to its input shape. */\nexport type HookInputByEvent = {\n  RunStart: RunStartHookInput;\n  UserPromptSubmit: UserPromptSubmitHookInput;\n  PreToolUse: PreToolUseHookInput;\n  PostToolUse: PostToolUseHookInput;\n  PostToolUseFailure: PostToolUseFailureHookInput;\n  PostToolBatch: PostToolBatchHookInput;\n  PreemptBoundary: PreemptBoundaryHookInput;\n  PermissionDenied: PermissionDeniedHookInput;\n  SubagentStart: SubagentStartHookInput;\n  SubagentStop: SubagentStopHookInput;\n  Stop: StopHookInput;\n  StopFailure: StopFailureHookInput;\n  PreCompact: PreCompactHookInput;\n  PostCompact: PostCompactHookInput;\n};\n\n/**\n * Fields common to every hook output. Hooks that have nothing to say simply\n * return `{}` (or omit the fields below).\n */\nexport interface BaseHookOutput {\n  /** Context string to inject into the conversation. Accumulated across hooks. */\n  additionalContext?: string;\n  /**\n   * Messages to inject into graph state, one `HumanMessage` per entry\n   * (converted via `convertInjectedMessages`, which preserves\n   * `role`/`source`/`isMeta` in `additional_kwargs`). Unlike\n   * `additionalContext` — which is consolidated across hooks into a single\n   * system-flavored message — each entry keeps its own identity and role,\n   * making this the channel for injecting verbatim user speech (e.g. a\n   * mid-run steering message). Accumulated across hooks in registration\n   * order.\n   *\n   * Consumed at exactly two dispatch sites, both of which run the same\n   * converter so the emitted shapes cannot drift: `PostToolBatch` (the tool\n   * boundary) and `PreemptBoundary` (a cooperative mid-generation seal).\n   * Every other event ignores the field.\n   */\n  injectedMessages?: InjectedMessage[];\n  /** True to prevent the next model turn. Any hook can set this. */\n  preventContinuation?: boolean;\n  /** Reason reported alongside `preventContinuation`. */\n  stopReason?: string;\n  /**\n   * Marks this hook output as fire-and-forget for INFLUENCE only.\n   * When `true`, the SDK skips every other field on this output —\n   * `decision`, `additionalContext`, `updatedInput`,\n   * `preventContinuation`, `allowedDecisions`, `updatedOutput` are\n   * all ignored. The hook's return value cannot block, modify, or\n   * inject context, so it's safe to use for pure side effects\n   * (logging, metrics, webhooks).\n   *\n   * Important caveat: the hook's CALLBACK promise is still awaited\n   * by `executeHooks` (subject to the matcher's timeout and the\n   * default `DEFAULT_HOOK_TIMEOUT_MS`). The SDK does not\n   * speculatively detach hooks based on output shape, because the\n   * shape is only known after the promise resolves. For TRUE\n   * fire-and-forget where the agent doesn't wait at all, the hook\n   * body should detach its side effect itself and return\n   * immediately:\n   *\n   * @example\n   * ```ts\n   * async (input) => {\n   *   // Detach the slow work — the SDK awaits this hook's\n   *   // returned promise, which resolves immediately because we\n   *   // don't `await` the side effect.\n   *   void sendToLoggingService(input).catch(console.error);\n   *   return { async: true };\n   * };\n   * ```\n   *\n   * @example WRONG — the agent will block on the webhook\n   * ```ts\n   * async (input) => {\n   *   await sendToLoggingService(input);  // ← awaited, blocks\n   *   return { async: true };  // returning async:true doesn't undo the await\n   * };\n   * ```\n   *\n   * Mirrors Claude Code Agent SDK's `async` output, with the same\n   * \"detach inside the hook body\" pattern.\n   */\n  async?: boolean;\n  /**\n   * Optional advisory timeout in milliseconds for the background work\n   * a host has detached inside an `async: true` hook body. The SDK\n   * does not enforce this (the hook's own AbortSignal handling does)\n   * but the field is preserved on the wire so downstream\n   * observability can surface long-running side effects. Ignored\n   * unless `async` is true.\n   */\n  asyncTimeout?: number;\n}\n\nexport type RunStartHookOutput = BaseHookOutput;\n\nexport interface UserPromptSubmitHookOutput extends BaseHookOutput {\n  decision?: ToolDecision;\n  reason?: string;\n}\n\nexport interface PreToolUseHookOutput extends BaseHookOutput {\n  decision?: ToolDecision;\n  reason?: string;\n  /**\n   * Replacement tool input. Merged into the pending tool call by the host.\n   *\n   * When multiple hooks set `updatedInput` within a single `executeHooks`\n   * call, the last writer in registration order wins (outer loop: matcher\n   * registration order; inner loop: hook position within the matcher). The\n   * winner is deterministic — `Promise.all` preserves input-array order.\n   * Consumers that need a single authoritative rewrite should still scope\n   * `updatedInput` to one hook per matcher to avoid confusing precedence.\n   */\n  updatedInput?: Record<string, unknown>;\n  /**\n   * Restricts which decisions the host UI is allowed to surface for this\n   * tool call when the hook returns `decision: 'ask'`. Pass to lock a\n   * tool down to a subset of `'approve' | 'reject' | 'edit' | 'respond'`\n   * — for example, `['approve', 'reject']` to forbid the user from\n   * editing the tool's args or substituting a custom response.\n   *\n   * The values flow into the resulting interrupt's\n   * `review_configs[i].allowed_decisions`. Omitting the field keeps the\n   * SDK default (all four decisions advertised). Last-writer-wins in\n   * registration order, same precedence rules as `updatedInput`.\n   */\n  allowedDecisions?: ReadonlyArray<'approve' | 'reject' | 'edit' | 'respond'>;\n}\n\nexport interface PostToolUseHookOutput extends BaseHookOutput {\n  /**\n   * Replacement tool output. Flows through the aggregated result so the\n   * host can substitute it before appending the tool result message.\n   * Ordering semantics match `PreToolUseHookOutput.updatedInput`:\n   * last-writer-wins in registration order.\n   */\n  updatedOutput?: unknown;\n}\n\nexport type PostToolUseFailureHookOutput = BaseHookOutput;\n\nexport type PostToolBatchHookOutput = BaseHookOutput;\n\nexport type PreemptBoundaryHookOutput = BaseHookOutput;\n\nexport type PermissionDeniedHookOutput = BaseHookOutput;\n\nexport interface SubagentStartHookOutput extends BaseHookOutput {\n  decision?: ToolDecision;\n  reason?: string;\n}\n\nexport type SubagentStopHookOutput = BaseHookOutput;\n\nexport interface StopHookOutput extends BaseHookOutput {\n  decision?: StopDecision;\n  reason?: string;\n}\n\nexport type StopFailureHookOutput = BaseHookOutput;\n\nexport type PreCompactHookOutput = BaseHookOutput;\n\nexport type PostCompactHookOutput = BaseHookOutput;\n\n/** Compile-time map from event name to its output shape. */\nexport type HookOutputByEvent = {\n  RunStart: RunStartHookOutput;\n  UserPromptSubmit: UserPromptSubmitHookOutput;\n  PreToolUse: PreToolUseHookOutput;\n  PostToolUse: PostToolUseHookOutput;\n  PostToolUseFailure: PostToolUseFailureHookOutput;\n  PostToolBatch: PostToolBatchHookOutput;\n  PreemptBoundary: PreemptBoundaryHookOutput;\n  PermissionDenied: PermissionDeniedHookOutput;\n  SubagentStart: SubagentStartHookOutput;\n  SubagentStop: SubagentStopHookOutput;\n  Stop: StopHookOutput;\n  StopFailure: StopFailureHookOutput;\n  PreCompact: PreCompactHookOutput;\n  PostCompact: PostCompactHookOutput;\n};\n\n/** Superset output shape used by the executor's fold loop. */\nexport type HookOutput =\n  | RunStartHookOutput\n  | UserPromptSubmitHookOutput\n  | PreToolUseHookOutput\n  | PostToolUseHookOutput\n  | PostToolUseFailureHookOutput\n  | PostToolBatchHookOutput\n  | PreemptBoundaryHookOutput\n  | PermissionDeniedHookOutput\n  | SubagentStartHookOutput\n  | SubagentStopHookOutput\n  | StopHookOutput\n  | StopFailureHookOutput\n  | PreCompactHookOutput\n  | PostCompactHookOutput;\n\n/**\n * A hook callback is a plain async function registered against a specific\n * event. The `signal` is always supplied by `executeHooks` and combines the\n * batch's parent signal with the per-hook timeout — callbacks that perform\n * long-running work should observe it.\n */\nexport type HookCallback<E extends HookEvent = HookEvent> = (\n  input: HookInputByEvent[E],\n  signal: AbortSignal\n) => HookOutputByEvent[E] | Promise<HookOutputByEvent[E]>;\n\n/**\n * A matcher groups one or more callbacks under a shared regex filter and\n * shared timeout/once/internal flags. The generic `E` ties the callback\n * types to the event the matcher is registered against.\n */\nexport interface HookMatcher<E extends HookEvent = HookEvent> {\n  /**\n   * Regex pattern matched against the event's primary query string (e.g.\n   * the tool name for `PreToolUse`, the agent type for `SubagentStart`).\n   *\n   * Omitted or empty means \"always match\". For events that do not supply a\n   * query string (`RunStart`, `Stop`, etc.), only wildcard matchers fire —\n   * a non-empty pattern on such events will never match.\n   *\n   * Patterns are treated as trusted input: `executeHooks` compiles them\n   * with `new RegExp(pattern)` without any sandbox, and a pathological\n   * pattern can block the event loop. Host registration code is expected\n   * to validate or length-bound patterns that originate from user input.\n   */\n  pattern?: string;\n  /** Callbacks that fire when the matcher hits. Executed in parallel. */\n  hooks: HookCallback<E>[];\n  /** Per-matcher timeout in ms. Defaults to the executor's batch timeout. */\n  timeout?: number;\n  /**\n   * Atomically remove the matcher before its first dispatch.\n   *\n   * `executeHooks` claims `once: true` matchers synchronously — between\n   * `getMatchers` and its first `await` — so two concurrent calls cannot\n   * both dispatch the same matcher. Whichever call runs its sync prefix\n   * first wins the matcher; the other sees an empty bucket.\n   *\n   * Semantics are \"at most one dispatch, ever\" — if every hook in the\n   * matcher throws, the matcher is still gone. Use `once` for\n   * fire-and-forget bootstrapping (registration, telemetry, setup). Hosts\n   * that need retry semantics should register a normal matcher and\n   * self-unregister via the callback returned from `registry.register`.\n   */\n  once?: boolean;\n  /** Internal hooks are excluded from telemetry and non-fatal error logging. */\n  internal?: boolean;\n}\n\n/**\n * Storage shape for matchers keyed by event. Each event's matcher list is\n * a generic array parameterized by that event type, so lookup via\n * `HooksByEvent[E]` preserves type-safe callback signatures.\n */\nexport type HooksByEvent = {\n  [E in HookEvent]?: HookMatcher<E>[];\n};\n\n/**\n * Aggregated result of a single `executeHooks` call. Fields are populated\n * according to the fold rules in `executeHooks.ts`.\n */\nexport interface AggregatedHookResult {\n  /** Folded tool-gating decision; `deny > ask > allow`. */\n  decision?: ToolDecision;\n  /** Folded stop decision; any `block` wins. */\n  stopDecision?: StopDecision;\n  /** Reason from the hook that set the winning decision. */\n  reason?: string;\n  /**\n   * Replacement tool input from a `PreToolUse` hook.\n   *\n   * Last-writer-wins in **registration order**: `executeHooks` uses\n   * `Promise.all`, which preserves input-array order, so the fold iterates\n   * outcomes in the same order they were pushed — outer loop over matchers\n   * as they sit in the registry, inner loop over each matcher's `hooks`\n   * array. The winner is therefore deterministic but may not match the\n   * order in which hooks actually completed. Consumers that want a single\n   * authoritative rewrite should still register one `updatedInput`-setting\n   * hook per matcher to avoid subtle precedence bugs.\n   */\n  updatedInput?: Record<string, unknown>;\n  /**\n   * Restricted decision set from a `PreToolUse` hook. Same last-writer-wins\n   * semantics as `updatedInput`. Surfaces to the interrupt payload's\n   * `review_configs[i].allowed_decisions`.\n   */\n  allowedDecisions?: ReadonlyArray<'approve' | 'reject' | 'edit' | 'respond'>;\n  /**\n   * Replacement tool output from a `PostToolUse` hook.\n   *\n   * Same last-writer-wins-in-registration-order semantics as\n   * `updatedInput`. Present only when at least one hook set it; `undefined`\n   * means \"use the original tool output\".\n   */\n  updatedOutput?: unknown;\n  /** Accumulated `additionalContext` strings from every hook, in order. */\n  additionalContexts: string[];\n  /** Accumulated `injectedMessages` from every hook, in registration order. */\n  injectedMessages: InjectedMessage[];\n  /** True if any hook returned `preventContinuation`. */\n  preventContinuation?: boolean;\n  /**\n   * Reason recorded alongside `preventContinuation`. First winner wins:\n   * once a hook sets both flags, later hooks that also set\n   * `preventContinuation` do not overwrite the reason.\n   */\n  stopReason?: string;\n  /** Error messages from hooks that threw; always present (possibly empty). */\n  errors: string[];\n}\n"],"mappings":";;;;;;;;;AAYA,MAAa,cAAc;CACzB;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF"}