@librechat/agents 3.0.0-rc1 → 3.0.0-rc2

package/dist/esm/graphs/MultiAgentGraph.mjs

@@ -1,6 +1,7 @@
 import { z } from 'zod';
 import { tool } from '@langchain/core/tools';
-import { ToolMessage, HumanMessage } from '@langchain/core/messages';
+import { ToolMessage, getBufferString, HumanMessage } from '@langchain/core/messages';
+import { ChatPromptTemplate } from '@langchain/core/prompts';
 import { getCurrentTaskInput, Command, Annotation, messagesStateReducer, StateGraph, END, START } from '@langchain/langgraph';
 import { StandardGraph } from './Graph.mjs';
 
@@ -115,19 +116,23 @@ class MultiAgentGraph extends StandardGraph {
     createHandoffToolsForEdge(edge) {
         const tools = [];
         const destinations = Array.isArray(edge.to) ? edge.to : [edge.to];
-        // If there's a condition, create a single conditional handoff tool
+        /** If there's a condition, create a single conditional handoff tool */
         if (edge.condition != null) {
             const toolName = 'conditional_transfer';
             const toolDescription = edge.description ?? 'Conditionally transfer control based on state';
-            tools.push(tool(async (_, config) => {
+            /** Check if we have a prompt for handoff input */
+            const hasHandoffInput = edge.prompt != null && typeof edge.prompt === 'string';
+            const handoffInputDescription = hasHandoffInput ? edge.prompt : undefined;
+            const promptKey = edge.promptKey ?? 'instructions';
+            tools.push(tool(async (input, config) => {
                 const state = getCurrentTaskInput();
                 const toolCallId = config?.toolCall?.id ??
                     'unknown';
-                // Evaluate condition
+                /** Evaluated condition */
                 const result = edge.condition(state);
                 let destination;
                 if (typeof result === 'boolean') {
-                    // If true, use first destination; if false, don't transfer
+                    /** If true, use first destination; if false, don't transfer */
                     if (!result)
                         return null;
                     destination = destinations[0];
@@ -136,11 +141,17 @@ class MultiAgentGraph extends StandardGraph {
                     destination = result;
                 }
                 else {
-                    // Array of destinations - for now, use the first
+                    /** Array of destinations - for now, use the first */
                     destination = Array.isArray(result) ? result[0] : destinations[0];
                 }
+                let content = `Conditionally transferred to ${destination}`;
+                if (hasHandoffInput &&
+                    promptKey in input &&
+                    input[promptKey] != null) {
+                    content += `\n\n${promptKey.charAt(0).toUpperCase() + promptKey.slice(1)}: ${input[promptKey]}`;
+                }
                 const toolMessage = new ToolMessage({
-                    content: `Conditionally transferred to ${destination}`,
+                    content,
                     name: toolName,
                     tool_call_id: toolCallId,
                 });
@@ -151,20 +162,39 @@ class MultiAgentGraph extends StandardGraph {
                 });
             }, {
                 name: toolName,
-                schema: z.object({}),
+                schema: hasHandoffInput
+                    ? z.object({
+                        [promptKey]: z
+                            .string()
+                            .optional()
+                            .describe(handoffInputDescription),
+                    })
+                    : z.object({}),
                 description: toolDescription,
             }));
         }
         else {
-            // Create individual tools for each destination
+            /** Create individual tools for each destination */
             for (const destination of destinations) {
                 const toolName = `transfer_to_${destination}`;
                 const toolDescription = edge.description ?? `Transfer control to agent '${destination}'`;
-                tools.push(tool(async (_, config) => {
+                /** Check if we have a prompt for handoff input */
+                const hasHandoffInput = edge.prompt != null && typeof edge.prompt === 'string';
+                const handoffInputDescription = hasHandoffInput
+                    ? edge.prompt
+                    : undefined;
+                const promptKey = edge.promptKey ?? 'instructions';
+                tools.push(tool(async (input, config) => {
                     const toolCallId = config?.toolCall?.id ??
                         'unknown';
+                    let content = `Successfully transferred to ${destination}`;
+                    if (hasHandoffInput &&
+                        promptKey in input &&
+                        input[promptKey] != null) {
+                        content += `\n\n${promptKey.charAt(0).toUpperCase() + promptKey.slice(1)}: ${input[promptKey]}`;
+                    }
                     const toolMessage = new ToolMessage({
-                        content: `Successfully transferred to ${destination}`,
+                        content,
                         name: toolName,
                         tool_call_id: toolCallId,
                     });
@@ -176,7 +206,14 @@ class MultiAgentGraph extends StandardGraph {
                     });
                 }, {
                     name: toolName,
-                    schema: z.object({}),
+                    schema: hasHandoffInput
+                        ? z.object({
+                            [promptKey]: z
+                                .string()
+                                .optional()
+                                .describe(handoffInputDescription),
+                        })
+                        : z.object({}),
                     description: toolDescription,
                 }));
             }
@@ -187,7 +224,7 @@ class MultiAgentGraph extends StandardGraph {
      * Create a complete agent subgraph (similar to createReactAgent)
      */
     createAgentSubgraph(agentId) {
-        // This is essentially the same as createAgentNode from StandardGraph
+        /** This is essentially the same as `createAgentNode` from `StandardGraph` */
         return this.createAgentNode(agentId);
     }
     /**
@@ -206,6 +243,12 @@ class MultiAgentGraph extends StandardGraph {
                 },
                 default: () => [],
             }),
+            /** Channel for passing filtered messages to agents when excludeResults is true */
+            agentMessages: Annotation({
+                /** Replaces state entirely */
+                reducer: (a, b) => b,
+                default: () => [],
+            }),
         });
         const builder = new StateGraph(StateAnnotation);
         // Add all agents as complete subgraphs
@@ -229,16 +272,36 @@ class MultiAgentGraph extends StandardGraph {
                     dests.forEach((dest) => directDestinations.add(dest));
                 }
             }
-            // If agent has handoff destinations, add END to possible ends
-            // If agent only has direct destinations, it naturally ends without explicit END
+            /** If agent has handoff destinations, add END to possible ends
+             * If agent only has direct destinations, it naturally ends without explicit END
+             */
             const destinations = new Set([...handoffDestinations]);
             if (handoffDestinations.size > 0 || directDestinations.size === 0) {
                 destinations.add(END);
             }
-            // Create the agent subgraph (includes agent + tools)
+            /** Agent subgraph (includes agent + tools) */
             const agentSubgraph = this.createAgentSubgraph(agentId);
-            // Add the agent as a node with its possible destinations
-            builder.addNode(agentId, agentSubgraph, {
+            /** Wrapper function that handles agentMessages channel */
+            const agentWrapper = async (state) => {
+                if (state.agentMessages != null && state.agentMessages.length > 0) {
+                    /** Temporary state with messages replaced by `agentMessages` */
+                    const transformedState = {
+                        ...state,
+                        messages: state.agentMessages,
+                    };
+                    const result = await agentSubgraph.invoke(transformedState);
+                    return {
+                        ...result,
+                        /** Clear agentMessages for next agent */
+                        agentMessages: [],
+                    };
+                }
+                else {
+                    return await agentSubgraph.invoke(state);
+                }
+            };
+            /** Wrapped agent as a node with its possible destinations */
+            builder.addNode(agentId, agentWrapper, {
                 ends: Array.from(destinations),
             });
         }
@@ -248,7 +311,8 @@ class MultiAgentGraph extends StandardGraph {
             /** @ts-ignore */
             builder.addEdge(START, startNode);
         }
-        /** Add direct edges for automatic transitions
+        /**
+         * Add direct edges for automatic transitions
          * Group edges by destination to handle fan-in scenarios
          */
         const edgesByDestination = new Map();
@@ -263,30 +327,66 @@ class MultiAgentGraph extends StandardGraph {
         }
         for (const [destination, edges] of edgesByDestination) {
             /** Checks if this is a fan-in scenario with prompt instructions */
-            const edgesWithPrompt = edges.filter((edge) => edge.promptInstructions != null && edge.promptInstructions !== '');
+            const edgesWithPrompt = edges.filter((edge) => edge.prompt != null && edge.prompt !== '');
             if (edgesWithPrompt.length > 0) {
-                // Fan-in with prompt: create a single wrapper node for this destination
+                /**
+                 * Single wrapper node for destination (Fan-in with prompt)
+                 */
                 const wrapperNodeId = `fan_in_${destination}_prompt`;
-                // Use the first edge's prompt instructions (they should all be the same for fan-in)
-                const promptInstructions = edgesWithPrompt[0].promptInstructions;
+                /**
+                 * First edge's `prompt`
+                 * (they should all be the same for fan-in)
+                 */
+                const prompt = edgesWithPrompt[0].prompt;
+                /**
+                 * First edge's `excludeResults` flag
+                 * (they should all be the same for fan-in)
+                 */
+                const excludeResults = edgesWithPrompt[0].excludeResults;
                 builder.addNode(wrapperNodeId, async (state) => {
                     let promptText;
-                    if (typeof promptInstructions === 'function') {
-                        promptText = promptInstructions(state.messages);
+                    let effectiveExcludeResults = excludeResults;
+                    if (typeof prompt === 'function') {
+                        promptText = prompt(state.messages, this.startIndex);
                     }
-                    else {
-                        promptText = promptInstructions;
+                    else if (prompt != null) {
+                        if (prompt.includes('{results}')) {
+                            const resultsMessages = state.messages.slice(this.startIndex);
+                            const resultsString = getBufferString(resultsMessages);
+                            const promptTemplate = ChatPromptTemplate.fromTemplate(prompt);
+                            const formattedPromptValue = await promptTemplate.invoke({
+                                results: resultsString,
+                            });
+                            promptText = formattedPromptValue.messages[0].content.toString();
+                            effectiveExcludeResults =
+                                excludeResults !== false && promptText !== '';
+                        }
+                        else {
+                            promptText = prompt;
+                        }
                     }
                     if (promptText != null && promptText !== '') {
-                        // Return state with the prompt message added
+                        if (effectiveExcludeResults == null ||
+                            effectiveExcludeResults === false) {
+                            return {
+                                messages: [new HumanMessage(promptText)],
+                            };
+                        }
+                        /** When `excludeResults` is true, use agentMessages channel
+                         * to pass filtered messages + prompt to the destination agent
+                         */
+                        const filteredMessages = state.messages.slice(0, this.startIndex);
                         return {
-                            messages: [...state.messages, new HumanMessage(promptText)],
+                            messages: [new HumanMessage(promptText)],
+                            agentMessages: messagesStateReducer(filteredMessages, [
+                                new HumanMessage(promptText),
+                            ]),
                         };
                     }
-                    // No prompt needed, return empty update
+                    /** No prompt needed, return empty update */
                     return {};
                 });
-                // Add edges from all sources to the wrapper, then wrapper to destination
+                /** Add edges from all sources to the wrapper, then wrapper to destination */
                 for (const edge of edges) {
                     const sources = Array.isArray(edge.from) ? edge.from : [edge.from];
                     for (const source of sources) {
@@ -295,13 +395,13 @@ class MultiAgentGraph extends StandardGraph {
                         builder.addEdge(source, wrapperNodeId);
                     }
                 }
-                // Single edge from wrapper to destination
+                /** Single edge from wrapper to destination */
                 // eslint-disable-next-line @typescript-eslint/ban-ts-comment
                 /** @ts-ignore */
                 builder.addEdge(wrapperNodeId, destination);
             }
             else {
-                // No prompt instructions, add direct edges
+                /** No prompt instructions, add direct edges */
                 for (const edge of edges) {
                     const sources = Array.isArray(edge.from) ? edge.from : [edge.from];
                     for (const source of sources) {

package/dist/esm/graphs/MultiAgentGraph.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"MultiAgentGraph.mjs","sources":["../../../src/graphs/MultiAgentGraph.ts"],"sourcesContent":["import { z } from 'zod';\nimport { tool } from '@langchain/core/tools';\nimport { ToolMessage, HumanMessage } from '@langchain/core/messages';\nimport {\n  END,\n  START,\n  Command,\n  StateGraph,\n  Annotation,\n  getCurrentTaskInput,\n  messagesStateReducer,\n} from '@langchain/langgraph';\nimport type { ToolRunnableConfig } from '@langchain/core/tools';\nimport type { BaseMessage } from '@langchain/core/messages';\nimport type * as t from '@/types';\nimport { StandardGraph } from './Graph';\n\n/**\n * MultiAgentGraph extends StandardGraph to support dynamic multi-agent workflows\n * with handoffs, fan-in/fan-out, and other composable patterns\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\n  constructor(input: t.MultiAgentGraphInput) {\n    super(input);\n    this.edges = input.edges;\n    this.categorizeEdges();\n    this.analyzeGraph();\n    this.createHandoffTools();\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\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      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      for (const edge of edges) {\n        handoffTools.push(...this.createHandoffToolsForEdge(edge));\n      }\n\n      // Add handoff tools to the agent's existing tools\n      if (!agentContext.tools) {\n        agentContext.tools = [];\n      }\n      agentContext.tools.push(...handoffTools);\n\n      // Update tool map\n      for (const tool of handoffTools) {\n        if (!agentContext.toolMap) {\n          agentContext.toolMap = new Map();\n        }\n        agentContext.toolMap.set(tool.name, tool);\n      }\n    }\n  }\n\n  /**\n   * Create handoff tools for an edge (handles multiple destinations)\n   */\n  private createHandoffToolsForEdge(edge: t.GraphEdge): 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      tools.push(\n        tool(\n          async (_, config) => {\n            const state = getCurrentTaskInput() as t.BaseGraphState;\n            const toolCallId =\n              (config as ToolRunnableConfig | undefined)?.toolCall?.id ??\n              'unknown';\n\n            // Evaluate 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 toolMessage = new ToolMessage({\n              content: `Conditionally transferred to ${destination}`,\n              name: toolName,\n              tool_call_id: toolCallId,\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: z.object({}),\n            description: toolDescription,\n          }\n        )\n      );\n    } else {\n      // Create individual tools for each destination\n      for (const destination of destinations) {\n        const toolName = `transfer_to_${destination}`;\n        const toolDescription =\n          edge.description ?? `Transfer control to agent '${destination}'`;\n\n        tools.push(\n          tool(\n            async (_, config) => {\n              const toolCallId =\n                (config as ToolRunnableConfig | undefined)?.toolCall?.id ??\n                'unknown';\n              const toolMessage = new ToolMessage({\n                content: `Successfully transferred to ${destination}`,\n                name: toolName,\n                tool_call_id: toolCallId,\n              });\n\n              const state = getCurrentTaskInput() as t.BaseGraphState;\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: z.object({}),\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   * Create the multi-agent workflow with dynamic handoffs\n   */\n  override createWorkflow(): t.CompiledStateWorkflow {\n    const StateAnnotation = Annotation.Root({\n      messages: Annotation<BaseMessage[]>({\n        reducer: (a, b) => {\n          if (!a.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    });\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      // If agent has handoff destinations, add END to possible ends\n      // If agent only has direct destinations, it naturally ends without explicit END\n      const destinations = new Set([...handoffDestinations]);\n      if (handoffDestinations.size > 0 || directDestinations.size === 0) {\n        destinations.add(END);\n      }\n\n      // Create the agent subgraph (includes agent + tools)\n      const agentSubgraph = this.createAgentSubgraph(agentId);\n\n      // Add the agent as a node with its possible destinations\n      builder.addNode(agentId, agentSubgraph, {\n        ends: Array.from(destinations),\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    /** 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) =>\n          edge.promptInstructions != null && edge.promptInstructions !== ''\n      );\n\n      if (edgesWithPrompt.length > 0) {\n        // Fan-in with prompt: create a single wrapper node for this destination\n        const wrapperNodeId = `fan_in_${destination}_prompt`;\n\n        // Use the first edge's prompt instructions (they should all be the same for fan-in)\n        const promptInstructions = edgesWithPrompt[0].promptInstructions;\n\n        builder.addNode(wrapperNodeId, async (state: t.BaseGraphState) => {\n          let promptText: string | undefined;\n\n          if (typeof promptInstructions === 'function') {\n            promptText = promptInstructions(state.messages);\n          } else {\n            promptText = promptInstructions;\n          }\n\n          if (promptText != null && promptText !== '') {\n            // Return state with the prompt message added\n            return {\n              messages: [...state.messages, new HumanMessage(promptText)],\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\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, destination);\n          }\n        }\n      }\n    }\n\n    return builder.compile(this.compileOptions as unknown as never);\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"MultiAgentGraph.mjs","sources":["../../../src/graphs/MultiAgentGraph.ts"],"sourcesContent":["import { z } from 'zod';\nimport { tool } from '@langchain/core/tools';\nimport {\n  ToolMessage,\n  HumanMessage,\n  getBufferString,\n} from '@langchain/core/messages';\nimport { ChatPromptTemplate } from '@langchain/core/prompts';\nimport {\n  END,\n  START,\n  Command,\n  StateGraph,\n  Annotation,\n  getCurrentTaskInput,\n  messagesStateReducer,\n} from '@langchain/langgraph';\nimport type { ToolRunnableConfig } from '@langchain/core/tools';\nimport type { BaseMessage } from '@langchain/core/messages';\nimport type * as t from '@/types';\nimport { StandardGraph } from './Graph';\n\n/**\n * MultiAgentGraph extends StandardGraph to support dynamic multi-agent workflows\n * with handoffs, fan-in/fan-out, and other composable patterns\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\n  constructor(input: t.MultiAgentGraphInput) {\n    super(input);\n    this.edges = input.edges;\n    this.categorizeEdges();\n    this.analyzeGraph();\n    this.createHandoffTools();\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\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      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      for (const edge of edges) {\n        handoffTools.push(...this.createHandoffToolsForEdge(edge));\n      }\n\n      // Add handoff tools to the agent's existing tools\n      if (!agentContext.tools) {\n        agentContext.tools = [];\n      }\n      agentContext.tools.push(...handoffTools);\n\n      // Update tool map\n      for (const tool of handoffTools) {\n        if (!agentContext.toolMap) {\n          agentContext.toolMap = new Map();\n        }\n        agentContext.toolMap.set(tool.name, tool);\n      }\n    }\n  }\n\n  /**\n   * Create handoff tools for an edge (handles multiple destinations)\n   */\n  private createHandoffToolsForEdge(edge: t.GraphEdge): 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 (input: Record<string, unknown>, config) => {\n            const state = getCurrentTaskInput() as t.BaseGraphState;\n            const toolCallId =\n              (config as ToolRunnableConfig | undefined)?.toolCall?.id ??\n              '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            let content = `Conditionally transferred to ${destination}`;\n            if (\n              hasHandoffInput &&\n              promptKey in input &&\n              input[promptKey] != null\n            ) {\n              content += `\\n\\n${promptKey.charAt(0).toUpperCase() + promptKey.slice(1)}: ${input[promptKey]}`;\n            }\n\n            const toolMessage = new ToolMessage({\n              content,\n              name: toolName,\n              tool_call_id: toolCallId,\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              ? z.object({\n                [promptKey]: z\n                  .string()\n                  .optional()\n                  .describe(handoffInputDescription as string),\n              })\n              : z.object({}),\n            description: toolDescription,\n          }\n        )\n      );\n    } else {\n      /** Create individual tools for each destination */\n      for (const destination of destinations) {\n        const toolName = `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 (input: Record<string, unknown>, config) => {\n              const toolCallId =\n                (config as ToolRunnableConfig | undefined)?.toolCall?.id ??\n                'unknown';\n\n              let content = `Successfully transferred to ${destination}`;\n              if (\n                hasHandoffInput &&\n                promptKey in input &&\n                input[promptKey] != null\n              ) {\n                content += `\\n\\n${promptKey.charAt(0).toUpperCase() + promptKey.slice(1)}: ${input[promptKey]}`;\n              }\n\n              const toolMessage = new ToolMessage({\n                content,\n                name: toolName,\n                tool_call_id: toolCallId,\n              });\n\n              const state = getCurrentTaskInput() as t.BaseGraphState;\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                ? z.object({\n                  [promptKey]: z\n                    .string()\n                    .optional()\n                    .describe(handoffInputDescription as string),\n                })\n                : z.object({}),\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   * Create the multi-agent workflow with dynamic handoffs\n   */\n  override createWorkflow(): t.CompiledMultiAgentWorkflow {\n    const StateAnnotation = Annotation.Root({\n      messages: Annotation<BaseMessage[]>({\n        reducer: (a, b) => {\n          if (!a.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      /** If agent has handoff destinations, add END to possible ends\n       * If agent only has direct destinations, it naturally ends without explicit END\n       */\n      const destinations = new Set([...handoffDestinations]);\n      if (handoffDestinations.size > 0 || directDestinations.size === 0) {\n        destinations.add(END);\n      }\n\n      /** Agent subgraph (includes agent + tools) */\n      const agentSubgraph = this.createAgentSubgraph(agentId);\n\n      /** Wrapper function that handles agentMessages channel */\n      const agentWrapper = async (\n        state: t.MultiAgentGraphState\n      ): Promise<t.MultiAgentGraphState> => {\n        if (state.agentMessages != null && state.agentMessages.length > 0) {\n          /** Temporary state with messages replaced by `agentMessages` */\n          const transformedState: t.MultiAgentGraphState = {\n            ...state,\n            messages: state.agentMessages,\n          };\n          const result = await agentSubgraph.invoke(transformedState);\n          return {\n            ...result,\n            /** Clear agentMessages for next agent */\n            agentMessages: [],\n          };\n        } else {\n          return await agentSubgraph.invoke(state);\n        }\n      };\n\n      /** Wrapped agent as a node with its possible destinations */\n      builder.addNode(agentId, agentWrapper, {\n        ends: Array.from(destinations),\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 = 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 = ChatPromptTemplate.fromTemplate(prompt);\n              const formattedPromptValue = await promptTemplate.invoke({\n                results: resultsString,\n              });\n              promptText = formattedPromptValue.messages[0].content.toString();\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            return {\n              messages: [new HumanMessage(promptText)],\n              agentMessages: messagesStateReducer(filteredMessages, [\n                new HumanMessage(promptText),\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 */\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, destination);\n          }\n        }\n      }\n    }\n\n    return builder.compile(this.compileOptions as unknown as never);\n  }\n}\n"],"names":[],"mappings":";;;;;;;AAsBA;;;AAGG;AACG,MAAO,eAAgB,SAAQ,aAAa,CAAA;AACxC,IAAA,KAAK;AACL,IAAA,aAAa,GAAgB,IAAI,GAAG,EAAE;IACtC,WAAW,GAAkB,EAAE;IAC/B,YAAY,GAAkB,EAAE;AAExC,IAAA,WAAA,CAAY,KAA6B,EAAA;QACvC,KAAK,CAAC,KAAK,CAAC;AACZ,QAAA,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK;QACxB,IAAI,CAAC,eAAe,EAAE;QACtB,IAAI,CAAC,YAAY,EAAE;QACnB,IAAI,CAAC,kBAAkB,EAAE;;AAG3B;;AAEG;IACK,eAAe,GAAA;AACrB,QAAA,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE;;;AAG7B,YAAA,IAAI,IAAI,CAAC,QAAQ,KAAK,QAAQ,EAAE;AAC9B,gBAAA,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC;;AACtB,iBAAA,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,EAAE;AAChE,gBAAA,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC;;iBACvB;;gBAEL,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBACjE,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;AAElE,gBAAA,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE;;AAEnD,oBAAA,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC;;qBACtB;;AAEL,oBAAA,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;AAMpC;;AAEG;IACK,YAAY,GAAA;AAClB,QAAA,MAAM,eAAe,GAAG,IAAI,GAAG,EAAU;;AAGzC,QAAA,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE;YAC7B,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;AACjE,YAAA,YAAY,CAAC,OAAO,CAAC,CAAC,IAAI,KAAK,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;;;QAI3D,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,EAAE;YAC/C,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE;AACjC,gBAAA,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC;;;;AAKnC,QAAA,IAAI,IAAI,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC,IAAI,IAAI,CAAC,aAAa,CAAC,IAAI,GAAG,CAAC,EAAE;AAChE,YAAA,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAM,CAAC;;;AAInE;;AAEG;IACK,kBAAkB,GAAA;;AAExB,QAAA,MAAM,eAAe,GAAG,IAAI,GAAG,EAAyB;;AAGxD,QAAA,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,YAAY,EAAE;YACpC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;AAClE,YAAA,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,KAAI;gBACzB,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE;AAChC,oBAAA,eAAe,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC;;gBAEjC,eAAe,CAAC,GAAG,CAAC,MAAM,CAAE,CAAC,IAAI,CAAC,IAAI,CAAC;AACzC,aAAC,CAAC;;;QAIJ,KAAK,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,eAAe,EAAE;YAC9C,MAAM,YAAY,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC;AACpD,YAAA,IAAI,CAAC,YAAY;gBAAE;;YAGnB,MAAM,YAAY,GAAoB,EAAE;AACxC,YAAA,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE;gBACxB,YAAY,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,yBAAyB,CAAC,IAAI,CAAC,CAAC;;;AAI5D,YAAA,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE;AACvB,gBAAA,YAAY,CAAC,KAAK,GAAG,EAAE;;YAEzB,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC;;AAGxC,YAAA,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE;AAC/B,gBAAA,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE;AACzB,oBAAA,YAAY,CAAC,OAAO,GAAG,IAAI,GAAG,EAAE;;gBAElC,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC;;;;AAK/C;;AAEG;AACK,IAAA,yBAAyB,CAAC,IAAiB,EAAA;QACjD,MAAM,KAAK,GAAoB,EAAE;QACjC,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;;AAGjE,QAAA,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,EAAE;YAC1B,MAAM,QAAQ,GAAG,sBAAsB;AACvC,YAAA,MAAM,eAAe,GACnB,IAAI,CAAC,WAAW,IAAI,+CAA+C;;AAGrE,YAAA,MAAM,eAAe,GACnB,IAAI,CAAC,MAAM,IAAI,IAAI,IAAI,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ;AACxD,YAAA,MAAM,uBAAuB,GAAG,eAAe,GAAG,IAAI,CAAC,MAAM,GAAG,SAAS;AACzE,YAAA,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,cAAc;YAElD,KAAK,CAAC,IAAI,CACR,IAAI,CACF,OAAO,KAA8B,EAAE,MAAM,KAAI;AAC/C,gBAAA,MAAM,KAAK,GAAG,mBAAmB,EAAsB;AACvD,gBAAA,MAAM,UAAU,GACb,MAAyC,EAAE,QAAQ,EAAE,EAAE;AACxD,oBAAA,SAAS;;gBAGX,MAAM,MAAM,GAAG,IAAI,CAAC,SAAU,CAAC,KAAK,CAAC;AACrC,gBAAA,IAAI,WAAmB;AAEvB,gBAAA,IAAI,OAAO,MAAM,KAAK,SAAS,EAAE;;AAE/B,oBAAA,IAAI,CAAC,MAAM;AAAE,wBAAA,OAAO,IAAI;AACxB,oBAAA,WAAW,GAAG,YAAY,CAAC,CAAC,CAAC;;AACxB,qBAAA,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE;oBACrC,WAAW,GAAG,MAAM;;qBACf;;oBAEL,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC;;AAGnE,gBAAA,IAAI,OAAO,GAAG,CAAgC,6BAAA,EAAA,WAAW,EAAE;AAC3D,gBAAA,IACE,eAAe;AACf,oBAAA,SAAS,IAAI,KAAK;AAClB,oBAAA,KAAK,CAAC,SAAS,CAAC,IAAI,IAAI,EACxB;oBACA,OAAO,IAAI,CAAO,IAAA,EAAA,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA,EAAA,EAAK,KAAK,CAAC,SAAS,CAAC,CAAA,CAAE;;AAGjG,gBAAA,MAAM,WAAW,GAAG,IAAI,WAAW,CAAC;oBAClC,OAAO;AACP,oBAAA,IAAI,EAAE,QAAQ;AACd,oBAAA,YAAY,EAAE,UAAU;AACzB,iBAAA,CAAC;gBAEF,OAAO,IAAI,OAAO,CAAC;AACjB,oBAAA,IAAI,EAAE,WAAW;AACjB,oBAAA,MAAM,EAAE,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE;oBACxD,KAAK,EAAE,OAAO,CAAC,MAAM;AACtB,iBAAA,CAAC;AACJ,aAAC,EACD;AACE,gBAAA,IAAI,EAAE,QAAQ;AACd,gBAAA,MAAM,EAAE;AACN,sBAAE,CAAC,CAAC,MAAM,CAAC;wBACT,CAAC,SAAS,GAAG;AACV,6BAAA,MAAM;AACN,6BAAA,QAAQ;6BACR,QAAQ,CAAC,uBAAiC,CAAC;qBAC/C;AACD,sBAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;AAChB,gBAAA,WAAW,EAAE,eAAe;AAC7B,aAAA,CACF,CACF;;aACI;;AAEL,YAAA,KAAK,MAAM,WAAW,IAAI,YAAY,EAAE;AACtC,gBAAA,MAAM,QAAQ,GAAG,CAAe,YAAA,EAAA,WAAW,EAAE;gBAC7C,MAAM,eAAe,GACnB,IAAI,CAAC,WAAW,IAAI,CAAA,2BAAA,EAA8B,WAAW,CAAA,CAAA,CAAG;;AAGlE,gBAAA,MAAM,eAAe,GACnB,IAAI,CAAC,MAAM,IAAI,IAAI,IAAI,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ;gBACxD,MAAM,uBAAuB,GAAG;sBAC5B,IAAI,CAAC;sBACL,SAAS;AACb,gBAAA,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,cAAc;gBAElD,KAAK,CAAC,IAAI,CACR,IAAI,CACF,OAAO,KAA8B,EAAE,MAAM,KAAI;AAC/C,oBAAA,MAAM,UAAU,GACb,MAAyC,EAAE,QAAQ,EAAE,EAAE;AACxD,wBAAA,SAAS;AAEX,oBAAA,IAAI,OAAO,GAAG,CAA+B,4BAAA,EAAA,WAAW,EAAE;AAC1D,oBAAA,IACE,eAAe;AACf,wBAAA,SAAS,IAAI,KAAK;AAClB,wBAAA,KAAK,CAAC,SAAS,CAAC,IAAI,IAAI,EACxB;wBACA,OAAO,IAAI,CAAO,IAAA,EAAA,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA,EAAA,EAAK,KAAK,CAAC,SAAS,CAAC,CAAA,CAAE;;AAGjG,oBAAA,MAAM,WAAW,GAAG,IAAI,WAAW,CAAC;wBAClC,OAAO;AACP,wBAAA,IAAI,EAAE,QAAQ;AACd,wBAAA,YAAY,EAAE,UAAU;AACzB,qBAAA,CAAC;AAEF,oBAAA,MAAM,KAAK,GAAG,mBAAmB,EAAsB;oBAEvD,OAAO,IAAI,OAAO,CAAC;AACjB,wBAAA,IAAI,EAAE,WAAW;AACjB,wBAAA,MAAM,EAAE,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE;wBACxD,KAAK,EAAE,OAAO,CAAC,MAAM;AACtB,qBAAA,CAAC;AACJ,iBAAC,EACD;AACE,oBAAA,IAAI,EAAE,QAAQ;AACd,oBAAA,MAAM,EAAE;AACN,0BAAE,CAAC,CAAC,MAAM,CAAC;4BACT,CAAC,SAAS,GAAG;AACV,iCAAA,MAAM;AACN,iCAAA,QAAQ;iCACR,QAAQ,CAAC,uBAAiC,CAAC;yBAC/C;AACD,0BAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;AAChB,oBAAA,WAAW,EAAE,eAAe;AAC7B,iBAAA,CACF,CACF;;;AAIL,QAAA,OAAO,KAAK;;AAGd;;AAEG;AACK,IAAA,mBAAmB,CAAC,OAAe,EAAA;;AAEzC,QAAA,OAAO,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC;;AAGtC;;AAEG;IACM,cAAc,GAAA;AACrB,QAAA,MAAM,eAAe,GAAG,UAAU,CAAC,IAAI,CAAC;YACtC,QAAQ,EAAE,UAAU,CAAgB;AAClC,gBAAA,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,KAAI;AAChB,oBAAA,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE;wBACb,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM;;oBAEvC,MAAM,MAAM,GAAG,oBAAoB,CAAC,CAAC,EAAE,CAAC,CAAC;AACzC,oBAAA,IAAI,CAAC,QAAQ,GAAG,MAAM;AACtB,oBAAA,OAAO,MAAM;iBACd;AACD,gBAAA,OAAO,EAAE,MAAM,EAAE;aAClB,CAAC;;YAEF,aAAa,EAAE,UAAU,CAAgB;;gBAEvC,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC;AACpB,gBAAA,OAAO,EAAE,MAAM,EAAE;aAClB,CAAC;AACH,SAAA,CAAC;AAEF,QAAA,MAAM,OAAO,GAAG,IAAI,UAAU,CAAC,eAAe,CAAC;;QAG/C,KAAK,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,aAAa,EAAE;;AAE1C,YAAA,MAAM,mBAAmB,GAAG,IAAI,GAAG,EAAU;AAC7C,YAAA,MAAM,kBAAkB,GAAG,IAAI,GAAG,EAAU;;AAG5C,YAAA,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,YAAY,EAAE;gBACpC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;gBAClE,IAAI,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE;oBACtC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;AAC1D,oBAAA,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,KAAK,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;;;;AAK1D,YAAA,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,WAAW,EAAE;gBACnC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;gBAClE,IAAI,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE;oBACtC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;AAC1D,oBAAA,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,KAAK,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;;;AAIzD;;AAEG;YACH,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,mBAAmB,CAAC,CAAC;AACtD,YAAA,IAAI,mBAAmB,CAAC,IAAI,GAAG,CAAC,IAAI,kBAAkB,CAAC,IAAI,KAAK,CAAC,EAAE;AACjE,gBAAA,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC;;;YAIvB,MAAM,aAAa,GAAG,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC;;AAGvD,YAAA,MAAM,YAAY,GAAG,OACnB,KAA6B,KACM;AACnC,gBAAA,IAAI,KAAK,CAAC,aAAa,IAAI,IAAI,IAAI,KAAK,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE;;AAEjE,oBAAA,MAAM,gBAAgB,GAA2B;AAC/C,wBAAA,GAAG,KAAK;wBACR,QAAQ,EAAE,KAAK,CAAC,aAAa;qBAC9B;oBACD,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,MAAM,CAAC,gBAAgB,CAAC;oBAC3D,OAAO;AACL,wBAAA,GAAG,MAAM;;AAET,wBAAA,aAAa,EAAE,EAAE;qBAClB;;qBACI;AACL,oBAAA,OAAO,MAAM,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC;;AAE5C,aAAC;;AAGD,YAAA,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,YAAY,EAAE;AACrC,gBAAA,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC;AAC/B,aAAA,CAAC;;;AAIJ,QAAA,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,aAAa,EAAE;;;AAG1C,YAAA,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,SAAS,CAAC;;AAGnC;;;AAGG;AACH,QAAA,MAAM,kBAAkB,GAAG,IAAI,GAAG,EAAyB;AAE3D,QAAA,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,WAAW,EAAE;YACnC,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;AACjE,YAAA,KAAK,MAAM,WAAW,IAAI,YAAY,EAAE;gBACtC,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE;AACxC,oBAAA,kBAAkB,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,CAAC;;gBAEzC,kBAAkB,CAAC,GAAG,CAAC,WAAW,CAAE,CAAC,IAAI,CAAC,IAAI,CAAC;;;QAInD,KAAK,MAAM,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,kBAAkB,EAAE;;YAErD,MAAM,eAAe,GAAG,KAAK,CAAC,MAAM,CAClC,CAAC,IAAI,KAAK,IAAI,CAAC,MAAM,IAAI,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,EAAE,CACpD;AAED,YAAA,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE;AAC9B;;AAEG;AACH,gBAAA,MAAM,aAAa,GAAG,CAAU,OAAA,EAAA,WAAW,SAAS;AACpD;;;AAGG;gBACH,MAAM,MAAM,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC,MAAM;AACxC;;;AAGG;gBACH,MAAM,cAAc,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC,cAAc;gBAExD,OAAO,CAAC,OAAO,CAAC,aAAa,EAAE,OAAO,KAAuB,KAAI;AAC/D,oBAAA,IAAI,UAA8B;oBAClC,IAAI,uBAAuB,GAAG,cAAc;AAE5C,oBAAA,IAAI,OAAO,MAAM,KAAK,UAAU,EAAE;wBAChC,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC;;AAC/C,yBAAA,IAAI,MAAM,IAAI,IAAI,EAAE;AACzB,wBAAA,IAAI,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE;AAChC,4BAAA,MAAM,eAAe,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC;AAC7D,4BAAA,MAAM,aAAa,GAAG,eAAe,CAAC,eAAe,CAAC;4BACtD,MAAM,cAAc,GAAG,kBAAkB,CAAC,YAAY,CAAC,MAAM,CAAC;AAC9D,4BAAA,MAAM,oBAAoB,GAAG,MAAM,cAAc,CAAC,MAAM,CAAC;AACvD,gCAAA,OAAO,EAAE,aAAa;AACvB,6BAAA,CAAC;AACF,4BAAA,UAAU,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE;4BAChE,uBAAuB;AACrB,gCAAA,cAAc,KAAK,KAAK,IAAI,UAAU,KAAK,EAAE;;6BAC1C;4BACL,UAAU,GAAG,MAAM;;;oBAIvB,IAAI,UAAU,IAAI,IAAI,IAAI,UAAU,KAAK,EAAE,EAAE;wBAC3C,IACE,uBAAuB,IAAI,IAAI;4BAC/B,uBAAuB,KAAK,KAAK,EACjC;4BACA,OAAO;AACL,gCAAA,QAAQ,EAAE,CAAC,IAAI,YAAY,CAAC,UAAU,CAAC,CAAC;6BACzC;;AAGH;;AAEG;AACH,wBAAA,MAAM,gBAAgB,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC;wBACjE,OAAO;AACL,4BAAA,QAAQ,EAAE,CAAC,IAAI,YAAY,CAAC,UAAU,CAAC,CAAC;AACxC,4BAAA,aAAa,EAAE,oBAAoB,CAAC,gBAAgB,EAAE;gCACpD,IAAI,YAAY,CAAC,UAAU,CAAC;6BAC7B,CAAC;yBACH;;;AAIH,oBAAA,OAAO,EAAE;AACX,iBAAC,CAAC;;AAGF,gBAAA,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE;oBACxB,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;AAClE,oBAAA,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE;;;AAG5B,wBAAA,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,aAAa,CAAC;;;;;;AAO1C,gBAAA,OAAO,CAAC,OAAO,CAAC,aAAa,EAAE,WAAW,CAAC;;iBACtC;;AAEL,gBAAA,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE;oBACxB,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;AAClE,oBAAA,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE;;;AAG5B,wBAAA,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,WAAW,CAAC;;;;;QAM5C,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,cAAkC,CAAC;;AAElE;;;;"}

package/dist/types/graphs/MultiAgentGraph.d.ts

@@ -33,5 +33,5 @@ export declare class MultiAgentGraph extends StandardGraph {
     /**
      * Create the multi-agent workflow with dynamic handoffs
      */
-    createWorkflow(): t.CompiledStateWorkflow;
+    createWorkflow(): t.CompiledMultiAgentWorkflow;
 }

package/dist/types/scripts/multi-agent-supervisor.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/scripts/test-custom-prompt-key.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env bun
+export {};

package/dist/types/scripts/test-handoff-input.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env bun
+export {};

package/dist/types/scripts/test-multi-agent-list-handoff.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env bun
+export {};

package/dist/types/types/graph.d.ts

@@ -28,6 +28,9 @@ export type SystemCallbacks = {
 export type BaseGraphState = {
     messages: BaseMessage[];
 };
+export type MultiAgentGraphState = BaseGraphState & {
+    agentMessages?: BaseMessage[];
+};
 export type IState = BaseGraphState;
 export interface EventHandler {
     handle(event: string, data: StreamEventData | ModelEndData | RunStep | RunStepDeltaEvent | MessageDeltaEvent | ReasoningDeltaEvent | {
@@ -46,6 +49,19 @@ export type CompiledStateWorkflow = CompiledStateGraph<StateType<{
 }, {
     messages: BinaryOperatorAggregate<BaseMessage[], BaseMessage[]>;
 }, StateDefinition>;
+export type CompiledMultiAgentWorkflow = CompiledStateGraph<StateType<{
+    messages: BinaryOperatorAggregate<BaseMessage[], BaseMessage[]>;
+    agentMessages: BinaryOperatorAggregate<BaseMessage[], BaseMessage[]>;
+}>, UpdateType<{
+    messages: BinaryOperatorAggregate<BaseMessage[], BaseMessage[]>;
+    agentMessages: BinaryOperatorAggregate<BaseMessage[], BaseMessage[]>;
+}>, string, {
+    messages: BinaryOperatorAggregate<BaseMessage[], BaseMessage[]>;
+    agentMessages: BinaryOperatorAggregate<BaseMessage[], BaseMessage[]>;
+}, {
+    messages: BinaryOperatorAggregate<BaseMessage[], BaseMessage[]>;
+    agentMessages: BinaryOperatorAggregate<BaseMessage[], BaseMessage[]>;
+}, StateDefinition>;
 export type CompiledAgentWorfklow = CompiledStateGraph<{
     messages: BaseMessage[];
 }, {
@@ -185,17 +201,35 @@ export type StandardGraphInput = {
     indexTokenCountMap?: Record<string, number>;
 };
 export type GraphEdge = {
-    /** Use a list for multiple sources */
+    /** Agent ID, use a list for multiple sources */
     from: string | string[];
-    /** Use a list for multiple destinations */
+    /** Agent ID, use a list for multiple destinations */
     to: string | string[];
     description?: string;
     /** Can return boolean or specific destination(s) */
     condition?: (state: BaseGraphState) => boolean | string | string[];
     /** 'handoff' creates tools for dynamic routing, 'direct' creates direct edges, which also allow parallel execution */
     edgeType?: 'handoff' | 'direct';
-    /** Optional prompt to add when transitioning through this edge */
-    promptInstructions?: string | ((messages: BaseMessage[]) => string | undefined);
+    /**
+     * For direct edges: Optional prompt to add when transitioning through this edge.
+     * String prompts can include variables like {results} which will be replaced with
+     * messages from startIndex onwards. When {results} is used, excludeResults defaults to true.
+     *
+     * For handoff edges: Description for the input parameter that the handoff tool accepts,
+     * allowing the supervisor to pass specific instructions/context to the transferred agent.
+     */
+    prompt?: string | ((messages: BaseMessage[], runStartIndex: number) => string | undefined);
+    /**
+     * When true, excludes messages from startIndex when adding prompt.
+     * Automatically set to true when {results} variable is used in prompt.
+     */
+    excludeResults?: boolean;
+    /**
+     * For handoff edges: Customizes the parameter name for the handoff input.
+     * Defaults to "instructions" if not specified.
+     * Only applies when prompt is provided for handoff edges.
+     */
+    promptKey?: string;
 };
 export type MultiAgentGraphInput = StandardGraphInput & {
     edges: GraphEdge[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@librechat/agents",
-  "version": "3.0.00-rc1",
+  "version": "3.0.00-rc2",
   "main": "./dist/cjs/main.cjs",
   "module": "./dist/esm/main.mjs",
   "types": "./dist/types/index.d.ts",
@@ -60,6 +60,10 @@
     "multi-agent-parallel": "node -r dotenv/config --loader ./tsconfig-paths-bootstrap.mjs --experimental-specifier-resolution=node ./src/scripts/multi-agent-parallel.ts",
     "multi-agent-sequence": "node -r dotenv/config --loader ./tsconfig-paths-bootstrap.mjs --experimental-specifier-resolution=node ./src/scripts/multi-agent-sequence.ts",
     "multi-agent-conditional": "node -r dotenv/config --loader ./tsconfig-paths-bootstrap.mjs --experimental-specifier-resolution=node ./src/scripts/multi-agent-conditional.ts",
+    "multi-agent-supervisor": "node -r dotenv/config --loader ./tsconfig-paths-bootstrap.mjs --experimental-specifier-resolution=node ./src/scripts/multi-agent-supervisor.ts",
+    "multi-agent-list-handoff": "node -r dotenv/config --loader ./tsconfig-paths-bootstrap.mjs --experimental-specifier-resolution=node ./src/scripts/test-multi-agent-list-handoff.ts",
+    "test-handoff-input": "node -r dotenv/config --loader ./tsconfig-paths-bootstrap.mjs --experimental-specifier-resolution=node ./src/scripts/test-handoff-input.ts",
+    "test-custom-prompt-key": "node -r dotenv/config --loader ./tsconfig-paths-bootstrap.mjs --experimental-specifier-resolution=node ./src/scripts/test-custom-prompt-key.ts",
     "script2": "node -r dotenv/config --loader ./tsconfig-paths-bootstrap.mjs --experimental-specifier-resolution=node ./src/proto/example_test.ts",
     "script3": "node -r dotenv/config --loader ./tsconfig-paths-bootstrap.mjs --experimental-specifier-resolution=node ./src/proto/example_test_anthropic.ts",
     "script4": "node -r dotenv/config --loader ./tsconfig-paths-bootstrap.mjs --experimental-specifier-resolution=node ./src/scripts/cli4.ts --name 'Jo' --location 'New York, NY'",