@illuma-ai/agents 1.1.14 → 1.1.15

package/dist/cjs/common/enum.cjs

@@ -86,6 +86,8 @@ exports.EdgeType = void 0;
     EdgeType["HANDOFF"] = "handoff";
     /** Creates direct edges for automatic sequential/parallel transitions */
     EdgeType["DIRECT"] = "direct";
+    /** Creates delegate tools that invoke child subgraph inline and return result to parent */
+    EdgeType["DELEGATE"] = "delegate";
 })(exports.EdgeType || (exports.EdgeType = {}));
 exports.GraphNodeKeys = void 0;
 (function (GraphNodeKeys) {
@@ -168,6 +170,8 @@ exports.Constants = void 0;
     Constants["WEB_SEARCH"] = "web_search";
     Constants["CONTENT_AND_ARTIFACT"] = "content_and_artifact";
     Constants["LC_TRANSFER_TO_"] = "lc_transfer_to_";
+    /** Prefix for delegate tool names: lc_delegate_to_{agentId} */
+    Constants["LC_DELEGATE_TO_"] = "lc_delegate_to_";
     /** Tool name for the AskUser structured question tool */
     Constants["ASK_USER"] = "ask_user";
     /** Delimiter for MCP tools: toolName_mcp_serverName */
@@ -219,4 +223,11 @@ exports.MessageTypes = void 0;
     MessageTypes["DEVELOPER"] = "developer";
     MessageTypes["REMOVE"] = "remove";
 })(exports.MessageTypes || (exports.MessageTypes = {}));
+/** Default max characters for delegate results returned to parent (~8192 tokens at ~4 chars/token) */
+const DEFAULT_DELEGATE_MAX_RESULT_CHARS = 32768;
+/** Default timeout for delegate sub-agent execution in milliseconds (5 minutes) */
+const DELEGATE_TIMEOUT_MS = 300_000;
+
+exports.DEFAULT_DELEGATE_MAX_RESULT_CHARS = DEFAULT_DELEGATE_MAX_RESULT_CHARS;
+exports.DELEGATE_TIMEOUT_MS = DELEGATE_TIMEOUT_MS;
 //# sourceMappingURL=enum.cjs.map

package/dist/cjs/common/enum.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"enum.cjs","sources":["../../../src/common/enum.ts"],"sourcesContent":["/**\n * Enum representing the various event types emitted during the execution of runnables.\n * These events provide real-time information about the progress and state of different components.\n *\n * @enum {string}\n */\nexport enum GraphEvents {\n  /* Custom Events */\n\n  /** [Custom] Agent update event in multi-agent graph/workflow */\n  ON_AGENT_UPDATE = 'on_agent_update',\n  /** [Custom] Delta event for run steps (message creation and tool calls) */\n  ON_RUN_STEP = 'on_run_step',\n  /** [Custom] Delta event for run steps (tool calls) */\n  ON_RUN_STEP_DELTA = 'on_run_step_delta',\n  /** [Custom] Completed event for run steps (tool calls) */\n  ON_RUN_STEP_COMPLETED = 'on_run_step_completed',\n  /** [Custom] Delta events for messages */\n  ON_MESSAGE_DELTA = 'on_message_delta',\n  /** [Custom] Reasoning Delta events for messages */\n  ON_REASONING_DELTA = 'on_reasoning_delta',\n  /** [Custom] Context analytics event for traces */\n  ON_CONTEXT_ANALYTICS = 'on_context_analytics',\n  /** [Custom] Structured output event - emitted when agent returns structured JSON */\n  ON_STRUCTURED_OUTPUT = 'on_structured_output',\n  /** [Custom] Request to execute tools - dispatched by ToolNode, handled by host */\n  ON_TOOL_EXECUTE = 'on_tool_execute',\n  /** [Custom] Context pressure event for monitoring compaction triggers */\n  ON_CONTEXT_PRESSURE = 'on_context_pressure',\n  /** [Custom] Tool requires human approval before execution - dispatched by ToolNode HITL */\n  ON_TOOL_APPROVAL_REQUIRED = 'on_tool_approval_required',\n\n  /* Official Events */\n\n  /** Custom event, emitted by system */\n  ON_CUSTOM_EVENT = 'on_custom_event',\n  /** Emitted when a chat model starts processing. */\n  CHAT_MODEL_START = 'on_chat_model_start',\n\n  /** Emitted when a chat model streams a chunk of its response. */\n  CHAT_MODEL_STREAM = 'on_chat_model_stream',\n\n  /** Emitted when a chat model completes its processing. */\n  CHAT_MODEL_END = 'on_chat_model_end',\n\n  /** Emitted when a language model starts processing. */\n  LLM_START = 'on_llm_start',\n\n  /** Emitted when a language model streams a chunk of its response. */\n  LLM_STREAM = 'on_llm_stream',\n\n  /** Emitted when a language model completes its processing. */\n  LLM_END = 'on_llm_end',\n\n  /** Emitted when a chain starts processing. */\n  CHAIN_START = 'on_chain_start',\n\n  /** Emitted when a chain streams a chunk of its output. */\n  CHAIN_STREAM = 'on_chain_stream',\n\n  /** Emitted when a chain completes its processing. */\n  CHAIN_END = 'on_chain_end',\n\n  /** Emitted when a tool starts its operation. */\n  TOOL_START = 'on_tool_start',\n\n  /** Emitted when a tool completes its operation. */\n  TOOL_END = 'on_tool_end',\n\n  /** Emitted when a retriever starts its operation. */\n  RETRIEVER_START = 'on_retriever_start',\n\n  /** Emitted when a retriever completes its operation. */\n  RETRIEVER_END = 'on_retriever_end',\n\n  /** Emitted when a prompt starts processing. */\n  PROMPT_START = 'on_prompt_start',\n\n  /** Emitted when a prompt completes its processing. */\n  PROMPT_END = 'on_prompt_end',\n}\n\nexport enum Providers {\n  OPENAI = 'openAI',\n  VERTEXAI = 'vertexai',\n  BEDROCK = 'bedrock',\n  ANTHROPIC = 'anthropic',\n  MISTRALAI = 'mistralai',\n  MISTRAL = 'mistral',\n  GOOGLE = 'google',\n  AZURE = 'azureOpenAI',\n  DEEPSEEK = 'deepseek',\n  OPENROUTER = 'openrouter',\n  XAI = 'xai',\n  MOONSHOT = 'moonshot',\n}\n\nexport enum EdgeType {\n  /** Creates handoff tools for dynamic agent routing (default for single-to-single edges) */\n  HANDOFF = 'handoff',\n  /** Creates direct edges for automatic sequential/parallel transitions */\n  DIRECT = 'direct',\n}\n\nexport enum GraphNodeKeys {\n  TOOLS = 'tools=',\n  AGENT = 'agent=',\n  ROUTER = 'router',\n  PRE_TOOLS = 'pre_tools',\n  POST_TOOLS = 'post_tools',\n}\n\nexport enum GraphNodeActions {\n  TOOL_NODE = 'tool_node',\n  CALL_MODEL = 'call_model',\n  ROUTE_MESSAGE = 'route_message',\n}\n\nexport enum CommonEvents {\n  LANGGRAPH = 'LangGraph',\n}\n\nexport enum StepTypes {\n  TOOL_CALLS = 'tool_calls',\n  MESSAGE_CREATION = 'message_creation',\n}\n\nexport enum ContentTypes {\n  TEXT = 'text',\n  ERROR = 'error',\n  THINK = 'think',\n  TOOL_CALL = 'tool_call',\n  IMAGE_URL = 'image_url',\n  IMAGE_FILE = 'image_file',\n  /** Anthropic */\n  THINKING = 'thinking',\n  /** Vertex AI / Google Common */\n  REASONING = 'reasoning',\n  /** Multi-Agent Switch */\n  AGENT_UPDATE = 'agent_update',\n  /** Bedrock */\n  REASONING_CONTENT = 'reasoning_content',\n}\n\nexport enum ToolCallTypes {\n  FUNCTION = 'function',\n  RETRIEVAL = 'retrieval',\n  FILE_SEARCH = 'file_search',\n  CODE_INTERPRETER = 'code_interpreter',\n  /* Agents Tool Call */\n  TOOL_CALL = 'tool_call',\n}\n\nexport enum Callback {\n  TOOL_ERROR = 'handleToolError',\n  TOOL_START = 'handleToolStart',\n  TOOL_END = 'handleToolEnd',\n  CUSTOM_EVENT = 'handleCustomEvent',\n  /*\n  LLM_START = 'handleLLMStart',\n  LLM_NEW_TOKEN = 'handleLLMNewToken',\n  LLM_ERROR = 'handleLLMError',\n  LLM_END = 'handleLLMEnd',\n  CHAT_MODEL_START = 'handleChatModelStart',\n  CHAIN_START = 'handleChainStart',\n  CHAIN_ERROR = 'handleChainError',\n  CHAIN_END = 'handleChainEnd',\n  TEXT = 'handleText',\n  AGENT_ACTION = 'handleAgentAction',\n  AGENT_END = 'handleAgentEnd',\n  RETRIEVER_START = 'handleRetrieverStart',\n  RETRIEVER_END = 'handleRetrieverEnd',\n  RETRIEVER_ERROR = 'handleRetrieverError',\n  */\n}\n\nexport enum Constants {\n  OFFICIAL_CODE_BASEURL = 'https://api.illuma.ai/v1',\n  EXECUTE_CODE = 'execute_code',\n  TOOL_SEARCH = 'tool_search',\n  PROGRAMMATIC_TOOL_CALLING = 'run_tools_with_code',\n  WEB_SEARCH = 'web_search',\n  CONTENT_AND_ARTIFACT = 'content_and_artifact',\n  LC_TRANSFER_TO_ = 'lc_transfer_to_',\n  /** Tool name for the AskUser structured question tool */\n  ASK_USER = 'ask_user',\n  /** Delimiter for MCP tools: toolName_mcp_serverName */\n  MCP_DELIMITER = '_mcp_',\n}\n\nexport enum TitleMethod {\n  STRUCTURED = 'structured',\n  FUNCTIONS = 'functions',\n  COMPLETION = 'completion',\n}\n\nexport enum EnvVar {\n  CODE_API_KEY = 'CODE_EXECUTOR_API_KEY',\n  CODE_BASEURL = 'CODE_EXECUTOR_BASEURL',\n}\n\n/**\n * Normalized LLM finish/stop reasons across providers.\n * Used by toolCallContinuation to detect max_tokens truncation.\n */\nexport enum FinishReasons {\n  /** Anthropic / Bedrock stop reason for token limit */\n  MAX_TOKENS = 'max_tokens',\n  /** OpenAI / Azure finish reason for token limit */\n  LENGTH = 'length',\n  /** Normal completion */\n  STOP = 'stop',\n  /** Anthropic / Bedrock stop reason for normal completion */\n  END_TURN = 'end_turn',\n  /** Model chose to call tools */\n  TOOL_USE = 'tool_use',\n  /** OpenAI finish reason for tool calls */\n  TOOL_CALLS = 'tool_calls',\n}\n\n/**\n * Message type identifiers used by LangChain's BaseMessage.getType().\n * Use these constants instead of instanceof checks to avoid module mismatch issues\n * when different copies of @langchain/core/messages are loaded.\n */\nexport enum MessageTypes {\n  HUMAN = 'human',\n  AI = 'ai',\n  SYSTEM = 'system',\n  TOOL = 'tool',\n  FUNCTION = 'function',\n  GENERIC = 'generic',\n  DEVELOPER = 'developer',\n  REMOVE = 'remove',\n}\n"],"names":["GraphEvents","Providers","EdgeType","GraphNodeKeys","GraphNodeActions","CommonEvents","StepTypes","ContentTypes","ToolCallTypes","Callback","Constants","TitleMethod","EnvVar","FinishReasons","MessageTypes"],"mappings":"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"}
+{"version":3,"file":"enum.cjs","sources":["../../../src/common/enum.ts"],"sourcesContent":["/**\n * Enum representing the various event types emitted during the execution of runnables.\n * These events provide real-time information about the progress and state of different components.\n *\n * @enum {string}\n */\nexport enum GraphEvents {\n  /* Custom Events */\n\n  /** [Custom] Agent update event in multi-agent graph/workflow */\n  ON_AGENT_UPDATE = 'on_agent_update',\n  /** [Custom] Delta event for run steps (message creation and tool calls) */\n  ON_RUN_STEP = 'on_run_step',\n  /** [Custom] Delta event for run steps (tool calls) */\n  ON_RUN_STEP_DELTA = 'on_run_step_delta',\n  /** [Custom] Completed event for run steps (tool calls) */\n  ON_RUN_STEP_COMPLETED = 'on_run_step_completed',\n  /** [Custom] Delta events for messages */\n  ON_MESSAGE_DELTA = 'on_message_delta',\n  /** [Custom] Reasoning Delta events for messages */\n  ON_REASONING_DELTA = 'on_reasoning_delta',\n  /** [Custom] Context analytics event for traces */\n  ON_CONTEXT_ANALYTICS = 'on_context_analytics',\n  /** [Custom] Structured output event - emitted when agent returns structured JSON */\n  ON_STRUCTURED_OUTPUT = 'on_structured_output',\n  /** [Custom] Request to execute tools - dispatched by ToolNode, handled by host */\n  ON_TOOL_EXECUTE = 'on_tool_execute',\n  /** [Custom] Context pressure event for monitoring compaction triggers */\n  ON_CONTEXT_PRESSURE = 'on_context_pressure',\n  /** [Custom] Tool requires human approval before execution - dispatched by ToolNode HITL */\n  ON_TOOL_APPROVAL_REQUIRED = 'on_tool_approval_required',\n\n  /* Official Events */\n\n  /** Custom event, emitted by system */\n  ON_CUSTOM_EVENT = 'on_custom_event',\n  /** Emitted when a chat model starts processing. */\n  CHAT_MODEL_START = 'on_chat_model_start',\n\n  /** Emitted when a chat model streams a chunk of its response. */\n  CHAT_MODEL_STREAM = 'on_chat_model_stream',\n\n  /** Emitted when a chat model completes its processing. */\n  CHAT_MODEL_END = 'on_chat_model_end',\n\n  /** Emitted when a language model starts processing. */\n  LLM_START = 'on_llm_start',\n\n  /** Emitted when a language model streams a chunk of its response. */\n  LLM_STREAM = 'on_llm_stream',\n\n  /** Emitted when a language model completes its processing. */\n  LLM_END = 'on_llm_end',\n\n  /** Emitted when a chain starts processing. */\n  CHAIN_START = 'on_chain_start',\n\n  /** Emitted when a chain streams a chunk of its output. */\n  CHAIN_STREAM = 'on_chain_stream',\n\n  /** Emitted when a chain completes its processing. */\n  CHAIN_END = 'on_chain_end',\n\n  /** Emitted when a tool starts its operation. */\n  TOOL_START = 'on_tool_start',\n\n  /** Emitted when a tool completes its operation. */\n  TOOL_END = 'on_tool_end',\n\n  /** Emitted when a retriever starts its operation. */\n  RETRIEVER_START = 'on_retriever_start',\n\n  /** Emitted when a retriever completes its operation. */\n  RETRIEVER_END = 'on_retriever_end',\n\n  /** Emitted when a prompt starts processing. */\n  PROMPT_START = 'on_prompt_start',\n\n  /** Emitted when a prompt completes its processing. */\n  PROMPT_END = 'on_prompt_end',\n}\n\nexport enum Providers {\n  OPENAI = 'openAI',\n  VERTEXAI = 'vertexai',\n  BEDROCK = 'bedrock',\n  ANTHROPIC = 'anthropic',\n  MISTRALAI = 'mistralai',\n  MISTRAL = 'mistral',\n  GOOGLE = 'google',\n  AZURE = 'azureOpenAI',\n  DEEPSEEK = 'deepseek',\n  OPENROUTER = 'openrouter',\n  XAI = 'xai',\n  MOONSHOT = 'moonshot',\n}\n\nexport enum EdgeType {\n  /** Creates handoff tools for dynamic agent routing (default for single-to-single edges) */\n  HANDOFF = 'handoff',\n  /** Creates direct edges for automatic sequential/parallel transitions */\n  DIRECT = 'direct',\n  /** Creates delegate tools that invoke child subgraph inline and return result to parent */\n  DELEGATE = 'delegate',\n}\n\nexport enum GraphNodeKeys {\n  TOOLS = 'tools=',\n  AGENT = 'agent=',\n  ROUTER = 'router',\n  PRE_TOOLS = 'pre_tools',\n  POST_TOOLS = 'post_tools',\n}\n\nexport enum GraphNodeActions {\n  TOOL_NODE = 'tool_node',\n  CALL_MODEL = 'call_model',\n  ROUTE_MESSAGE = 'route_message',\n}\n\nexport enum CommonEvents {\n  LANGGRAPH = 'LangGraph',\n}\n\nexport enum StepTypes {\n  TOOL_CALLS = 'tool_calls',\n  MESSAGE_CREATION = 'message_creation',\n}\n\nexport enum ContentTypes {\n  TEXT = 'text',\n  ERROR = 'error',\n  THINK = 'think',\n  TOOL_CALL = 'tool_call',\n  IMAGE_URL = 'image_url',\n  IMAGE_FILE = 'image_file',\n  /** Anthropic */\n  THINKING = 'thinking',\n  /** Vertex AI / Google Common */\n  REASONING = 'reasoning',\n  /** Multi-Agent Switch */\n  AGENT_UPDATE = 'agent_update',\n  /** Bedrock */\n  REASONING_CONTENT = 'reasoning_content',\n}\n\nexport enum ToolCallTypes {\n  FUNCTION = 'function',\n  RETRIEVAL = 'retrieval',\n  FILE_SEARCH = 'file_search',\n  CODE_INTERPRETER = 'code_interpreter',\n  /* Agents Tool Call */\n  TOOL_CALL = 'tool_call',\n}\n\nexport enum Callback {\n  TOOL_ERROR = 'handleToolError',\n  TOOL_START = 'handleToolStart',\n  TOOL_END = 'handleToolEnd',\n  CUSTOM_EVENT = 'handleCustomEvent',\n  /*\n  LLM_START = 'handleLLMStart',\n  LLM_NEW_TOKEN = 'handleLLMNewToken',\n  LLM_ERROR = 'handleLLMError',\n  LLM_END = 'handleLLMEnd',\n  CHAT_MODEL_START = 'handleChatModelStart',\n  CHAIN_START = 'handleChainStart',\n  CHAIN_ERROR = 'handleChainError',\n  CHAIN_END = 'handleChainEnd',\n  TEXT = 'handleText',\n  AGENT_ACTION = 'handleAgentAction',\n  AGENT_END = 'handleAgentEnd',\n  RETRIEVER_START = 'handleRetrieverStart',\n  RETRIEVER_END = 'handleRetrieverEnd',\n  RETRIEVER_ERROR = 'handleRetrieverError',\n  */\n}\n\nexport enum Constants {\n  OFFICIAL_CODE_BASEURL = 'https://api.illuma.ai/v1',\n  EXECUTE_CODE = 'execute_code',\n  TOOL_SEARCH = 'tool_search',\n  PROGRAMMATIC_TOOL_CALLING = 'run_tools_with_code',\n  WEB_SEARCH = 'web_search',\n  CONTENT_AND_ARTIFACT = 'content_and_artifact',\n  LC_TRANSFER_TO_ = 'lc_transfer_to_',\n  /** Prefix for delegate tool names: lc_delegate_to_{agentId} */\n  LC_DELEGATE_TO_ = 'lc_delegate_to_',\n  /** Tool name for the AskUser structured question tool */\n  ASK_USER = 'ask_user',\n  /** Delimiter for MCP tools: toolName_mcp_serverName */\n  MCP_DELIMITER = '_mcp_',\n}\n\nexport enum TitleMethod {\n  STRUCTURED = 'structured',\n  FUNCTIONS = 'functions',\n  COMPLETION = 'completion',\n}\n\nexport enum EnvVar {\n  CODE_API_KEY = 'CODE_EXECUTOR_API_KEY',\n  CODE_BASEURL = 'CODE_EXECUTOR_BASEURL',\n}\n\n/**\n * Normalized LLM finish/stop reasons across providers.\n * Used by toolCallContinuation to detect max_tokens truncation.\n */\nexport enum FinishReasons {\n  /** Anthropic / Bedrock stop reason for token limit */\n  MAX_TOKENS = 'max_tokens',\n  /** OpenAI / Azure finish reason for token limit */\n  LENGTH = 'length',\n  /** Normal completion */\n  STOP = 'stop',\n  /** Anthropic / Bedrock stop reason for normal completion */\n  END_TURN = 'end_turn',\n  /** Model chose to call tools */\n  TOOL_USE = 'tool_use',\n  /** OpenAI finish reason for tool calls */\n  TOOL_CALLS = 'tool_calls',\n}\n\n/**\n * Message type identifiers used by LangChain's BaseMessage.getType().\n * Use these constants instead of instanceof checks to avoid module mismatch issues\n * when different copies of @langchain/core/messages are loaded.\n */\nexport enum MessageTypes {\n  HUMAN = 'human',\n  AI = 'ai',\n  SYSTEM = 'system',\n  TOOL = 'tool',\n  FUNCTION = 'function',\n  GENERIC = 'generic',\n  DEVELOPER = 'developer',\n  REMOVE = 'remove',\n}\n\n/** Default max characters for delegate results returned to parent (~8192 tokens at ~4 chars/token) */\nexport const DEFAULT_DELEGATE_MAX_RESULT_CHARS = 32768;\n\n/** Default timeout for delegate sub-agent execution in milliseconds (5 minutes) */\nexport const DELEGATE_TIMEOUT_MS = 300_000;\n"],"names":["GraphEvents","Providers","EdgeType","GraphNodeKeys","GraphNodeActions","CommonEvents","StepTypes","ContentTypes","ToolCallTypes","Callback","Constants","TitleMethod","EnvVar","FinishReasons","MessageTypes"],"mappings":"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"}

package/dist/cjs/graphs/MultiAgentGraph.cjs

@@ -33,6 +33,15 @@ class MultiAgentGraph extends Graph.StandardGraph {
     startingNodes = new Set();
     directEdges = [];
     handoffEdges = [];
+    delegateEdges = [];
+    /**
+     * Lazily populated registry of compiled subgraphs, keyed by agentId.
+     * Delegate tools are created in the constructor but reference subgraphs
+     * that are only created in createWorkflow(). This Map bridges that gap —
+     * tools capture the Map reference in their closure, and createWorkflow()
+     * populates it before any tool invocation occurs.
+     */
+    subgraphRegistry = new Map();
     /**
      * Map of agentId to parallel group info.
      * Contains groupId (incrementing number reflecting execution order) for agents in parallel groups.
@@ -55,6 +64,7 @@ class MultiAgentGraph extends Graph.StandardGraph {
         this.categorizeEdges();
         this.analyzeGraph();
         this.createHandoffTools();
+        this.createDelegateTools();
         console.debug(`[MultiAgentGraph] Constructor complete: ${this.agentContexts.size} agents, ${this.edges.length} edges`);
     }
     /**
@@ -64,7 +74,10 @@ class MultiAgentGraph extends Graph.StandardGraph {
         for (const edge of this.edges) {
             // Default behavior: edges with conditions or explicit 'handoff' type are handoff edges
             // Edges with explicit 'direct' type or multi-destination without conditions are direct edges
-            if (edge.edgeType === _enum.EdgeType.DIRECT) {
+            if (edge.edgeType === _enum.EdgeType.DELEGATE) {
+                this.delegateEdges.push(edge);
+            }
+            else if (edge.edgeType === _enum.EdgeType.DIRECT) {
                 this.directEdges.push(edge);
             }
             else if (edge.edgeType === _enum.EdgeType.HANDOFF || edge.condition != null) {
@@ -84,7 +97,7 @@ class MultiAgentGraph extends Graph.StandardGraph {
                 }
             }
         }
-        console.debug(`[MultiAgentGraph] Edge categorization: ${this.handoffEdges.length} handoff, ${this.directEdges.length} direct (of ${this.edges.length} total)`);
+        console.debug(`[MultiAgentGraph] Edge categorization: ${this.handoffEdges.length} handoff, ${this.directEdges.length} direct, ${this.delegateEdges.length} delegate (of ${this.edges.length} total)`);
     }
     /**
      * Analyze graph structure to determine starting nodes and connections
@@ -170,8 +183,8 @@ class MultiAgentGraph extends Graph.StandardGraph {
                     }
                 }
             }
-            // Also follow handoff edges for traversal (but they don't create parallel groups)
-            for (const edge of this.handoffEdges) {
+            // Also follow handoff and delegate edges for traversal (they don't create parallel groups)
+            for (const edge of [...this.handoffEdges, ...this.delegateEdges]) {
                 const sources = Array.isArray(edge.from) ? edge.from : [edge.from];
                 if (!sources.includes(current))
                     continue;
@@ -452,6 +465,193 @@ class MultiAgentGraph extends Graph.StandardGraph {
         }
         return `Transfer control to "${displayName}"`;
     }
+    /**
+     * Create delegate tools for agents based on delegate edges.
+     * Delegate tools invoke child agent subgraphs inline and return the result
+     * as a string to the parent agent's context. Unlike handoff tools (which
+     * return Command for fire-and-forget routing), delegate tools execute the
+     * child, extract the final text, and return it within the parent's agent loop.
+     *
+     * This enables the supervisor pattern: parent calls child → gets result → thinks → calls another.
+     */
+    createDelegateTools() {
+        const delegatesByAgent = new Map();
+        for (const edge of this.delegateEdges) {
+            const sources = Array.isArray(edge.from) ? edge.from : [edge.from];
+            sources.forEach((source) => {
+                if (!delegatesByAgent.has(source)) {
+                    delegatesByAgent.set(source, []);
+                }
+                delegatesByAgent.get(source).push(edge);
+            });
+        }
+        for (const [agentId, edges] of delegatesByAgent) {
+            const agentContext = this.agentContexts.get(agentId);
+            if (!agentContext)
+                continue;
+            const delegateTools = [];
+            for (const edge of edges) {
+                delegateTools.push(...this.createDelegateToolsForEdge(edge, agentId));
+            }
+            if (!agentContext.graphTools) {
+                agentContext.graphTools = [];
+            }
+            agentContext.graphTools.push(...delegateTools);
+            console.debug(`[MultiAgentGraph] Delegate tools for "${agentId}": [${delegateTools.map((t) => t.name).join(', ')}]`);
+        }
+    }
+    /**
+     * Create delegate tools for an edge (handles multiple destinations).
+     * Each delegate tool invokes the child agent's compiled subgraph inline,
+     * extracts the final AI message text, truncates it, and returns it as
+     * a string (which becomes a ToolMessage in the parent's context).
+     *
+     * @param edge - The graph edge defining the delegation
+     * @param sourceAgentId - The ID of the parent/supervisor agent
+     */
+    createDelegateToolsForEdge(edge, sourceAgentId) {
+        const tools$1 = [];
+        const destinations = Array.isArray(edge.to) ? edge.to : [edge.to];
+        const maxResultChars = edge.maxResultChars ?? _enum.DEFAULT_DELEGATE_MAX_RESULT_CHARS;
+        for (const destination of destinations) {
+            const toolName = `${_enum.Constants.LC_DELEGATE_TO_}${destination}`;
+            const destContext = this.agentContexts.get(destination);
+            const toolDescription = edge.description ??
+                this.buildDefaultDelegateDescription(destContext, destination);
+            const hasPromptInput = edge.prompt != null && typeof edge.prompt === 'string';
+            const promptInputDescription = hasPromptInput ? edge.prompt : undefined;
+            const promptKey = edge.promptKey ?? 'instructions';
+            /** Capture registry reference — Map populated in createWorkflow() */
+            const registry = this.subgraphRegistry;
+            tools$1.push(tools.tool(async (rawInput, config) => {
+                const input = rawInput;
+                const subgraph = registry.get(destination);
+                if (!subgraph) {
+                    throw new Error(`Delegate target "${destination}" subgraph not found in registry. ` +
+                        'This is a bug: createWorkflow() should have populated the subgraph registry.');
+                }
+                const state = langgraph.getCurrentTaskInput();
+                let childMessages = [...state.messages];
+                /** Inject instructions as HumanMessage if provided by the parent LLM */
+                if (hasPromptInput &&
+                    promptKey in input &&
+                    input[promptKey] != null) {
+                    childMessages = [
+                        ...childMessages,
+                        new messages.HumanMessage(String(input[promptKey])),
+                    ];
+                }
+                const childState = {
+                    messages: childMessages,
+                };
+                console.debug(`[MultiAgentGraph] Delegate "${sourceAgentId}" -> "${destination}" START ` +
+                    `(messages: ${childMessages.length})`);
+                try {
+                    /**
+                     * Invoke the child subgraph with config propagation.
+                     * Config carries callbacks (for SSE streaming), abort signal,
+                     * and configurable data (thread_id, user_id) to the child.
+                     */
+                    const result = await subgraph.invoke(childState, config);
+                    const resultText = MultiAgentGraph.extractDelegateResult(result.messages, destination);
+                    const truncatedResult = MultiAgentGraph.truncateDelegateResult(resultText, maxResultChars);
+                    console.debug(`[MultiAgentGraph] Delegate "${sourceAgentId}" -> "${destination}" DONE ` +
+                        `(result: ${resultText.length} chars` +
+                        `${truncatedResult.length < resultText.length ? `, truncated to ${truncatedResult.length}` : ''})`);
+                    return truncatedResult;
+                }
+                catch (err) {
+                    const errorMessage = err instanceof Error ? err.message : String(err);
+                    console.error(`[MultiAgentGraph] Delegate "${sourceAgentId}" -> "${destination}" ERROR:`, errorMessage);
+                    return `[Delegate to "${destination}" failed: ${errorMessage}]`;
+                }
+            }, {
+                name: toolName,
+                schema: hasPromptInput
+                    ? {
+                        type: 'object',
+                        properties: {
+                            [promptKey]: {
+                                type: 'string',
+                                description: promptInputDescription,
+                            },
+                        },
+                        required: [],
+                    }
+                    : { type: 'object', properties: {}, required: [] },
+                description: toolDescription,
+            }));
+        }
+        return tools$1;
+    }
+    /**
+     * Extract the final text result from a child agent's output messages.
+     * Walks backwards to find the last AIMessage with text content.
+     * Handles both string content and array content (multi-modal messages).
+     * @param messages - The child agent's output messages
+     * @param agentId - The child agent ID (for fallback message)
+     */
+    static extractDelegateResult(messages, agentId) {
+        for (let i = messages.length - 1; i >= 0; i--) {
+            const msg = messages[i];
+            if (msg.getType() !== 'ai')
+                continue;
+            const content = msg.content;
+            if (typeof content === 'string' && content.trim()) {
+                return content.trim();
+            }
+            /** Handle array content (multi-modal messages with text blocks) */
+            if (Array.isArray(content)) {
+                const textParts = content
+                    .filter((block) => typeof block === 'object' &&
+                    block !== null &&
+                    'type' in block &&
+                    block.type === 'text' &&
+                    'text' in block &&
+                    typeof block.text === 'string')
+                    .map((block) => block.text);
+                const text = textParts.join('\n').trim();
+                if (text)
+                    return text;
+            }
+        }
+        return `[Agent "${agentId}" completed but produced no text output]`;
+    }
+    /**
+     * Truncate delegate result using head/tail strategy (60/40 split).
+     * Preserves the beginning (key findings) and end (conclusions).
+     * Matches the TaskTool.truncateResult pattern from Ranger.
+     * @param result - The full result text
+     * @param maxChars - Maximum allowed characters
+     */
+    static truncateDelegateResult(result, maxChars) {
+        if (!result || result.length <= maxChars) {
+            return result;
+        }
+        const truncationNotice = '\n\n[... delegate output truncated — middle section omitted to fit parent context ...]\n\n';
+        const available = maxChars - truncationNotice.length;
+        if (available <= 0) {
+            return result.substring(0, maxChars);
+        }
+        const headSize = Math.floor(available * 0.6);
+        const tailSize = available - headSize;
+        return (result.substring(0, headSize) +
+            truncationNotice +
+            result.substring(result.length - tailSize));
+    }
+    /**
+     * Build a meaningful default description for a delegate tool.
+     * @param destContext - AgentContext of the destination agent
+     * @param destinationId - Raw agent ID (fallback)
+     */
+    buildDefaultDelegateDescription(destContext, destinationId) {
+        const displayName = destContext?.name ?? destinationId;
+        const agentDescription = destContext?.description;
+        if (agentDescription != null && agentDescription !== '') {
+            return `Delegate task to "${displayName}": ${agentDescription}. The agent will execute and return its result.`;
+        }
+        return `Delegate task to "${displayName}" and receive its result.`;
+    }
     /**
      * Create a complete agent subgraph (similar to createReactAgent)
      */
@@ -753,6 +953,8 @@ class MultiAgentGraph extends Graph.StandardGraph {
             }
             /** Agent subgraph (includes agent + tools) */
             const agentSubgraph = this.createAgentSubgraph(agentId);
+            /** Register subgraph for delegate tools (lazy reference resolution) */
+            this.subgraphRegistry.set(agentId, agentSubgraph);
             /** Wrapper function that handles agentMessages channel, handoff reception, and conditional routing */
             const agentWrapper = async (state, config) => {
                 console.debug(`[MultiAgentGraph] Agent "${agentId}" wrapper ENTRY (messages: ${state.messages.length}, needsCommandRouting: ${needsCommandRouting})`);