@librechat/agents 3.2.68 → 3.3.1

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

@@ -1 +1 @@
-{"version":3,"file":"enum.cjs","names":[],"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] Request to execute tools - dispatched by ToolNode, handled by host */\n  ON_TOOL_EXECUTE = 'on_tool_execute',\n  /** [Custom] Emitted when the summarize node begins generating a summary */\n  ON_SUMMARIZE_START = 'on_summarize_start',\n  /** [Custom] Delta event carrying the completed summary content */\n  ON_SUMMARIZE_DELTA = 'on_summarize_delta',\n  /** [Custom] Emitted when the summarize node completes with the final summary */\n  ON_SUMMARIZE_COMPLETE = 'on_summarize_complete',\n  /** [Custom] Progress update from a running subagent (wraps child-graph events so hosts can display activity separately from parent). */\n  ON_SUBAGENT_UPDATE = 'on_subagent_update',\n  /** [Custom] Diagnostic logging event for context management observability */\n  ON_AGENT_LOG = 'on_agent_log',\n  /** [Custom] Per-model-call context window usage snapshot (post-prune token budget) */\n  ON_CONTEXT_USAGE = 'on_context_usage',\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 GraphNodeKeys {\n  TOOLS = 'tools=',\n  AGENT = 'agent=',\n  SUMMARIZE = 'summarize=',\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  /** Framework-level conversation summary block */\n  SUMMARY = 'summary',\n  /** Bedrock */\n  REASONING_CONTENT = 'reasoning_content',\n  /** Mid-run user steer persisted inline in an assistant message; replayed as a user turn */\n  STEER = 'steer',\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.librechat.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  /** Delimiter for MCP tools: toolName_mcp_serverName */\n  MCP_DELIMITER = '_mcp_',\n  /** Anthropic server tool ID prefix (web_search, code_execution, etc.) */\n  ANTHROPIC_SERVER_TOOL_PREFIX = 'srvtoolu_',\n  SKILL_TOOL = 'skill',\n  /**\n   * Callback-metadata keys stamped by `attemptInvoke` /\n   * `tryFallbackProviders` carrying the provider (SDK `Providers` enum\n   * value) and configured model that actually served a model invocation.\n   * Unlike `ls_provider` — which derived providers inherit from their base\n   * class (e.g. DeepSeek/OpenRouter report `'openai'`) — these reflect the\n   * SDK's own routing, including fallback-provider calls. Consumed by the\n   * subagent usage-capture handler to tag billing events.\n   */\n  INVOKED_PROVIDER = '__invoked_provider',\n  INVOKED_MODEL = '__invoked_model',\n  READ_FILE = 'read_file',\n  BASH_TOOL = 'bash_tool',\n  BASH_PROGRAMMATIC_TOOL_CALLING = 'run_tools_with_bash',\n  SUBAGENT = 'subagent',\n  /**\n   * Local-engine coding tool names. Promoted to `Constants.*` (rather\n   * than left as per-file `*ToolName` consts) so consumer UIs — most\n   * importantly LibreChat's `getToolIconType` map — can match against\n   * canonical strings instead of guessing. Existing matched names:\n   * `bash_tool`, `read_file`, `execute_code`, `run_tools_with_code`.\n   * The rest below are new and currently fall through to the generic\n   * tool icon; once LibreChat adds icons keyed on the same names, the\n   * wiring will work without an SDK change.\n   */\n  WRITE_FILE = 'write_file',\n  EDIT_FILE = 'edit_file',\n  GREP_SEARCH = 'grep_search',\n  GLOB_SEARCH = 'glob_search',\n  LIST_DIRECTORY = 'list_directory',\n  COMPILE_CHECK = 'compile_check',\n}\n\n/** Tool names that use the code execution environment (shared session, file tracking). */\nexport const CODE_EXECUTION_TOOLS: ReadonlySet<string> = new Set([\n  Constants.EXECUTE_CODE,\n  Constants.BASH_TOOL,\n  Constants.PROGRAMMATIC_TOOL_CALLING,\n  Constants.BASH_PROGRAMMATIC_TOOL_CALLING,\n]);\n\n/**\n * Canonical names of the local-engine-specific coding tools — the\n * file/edit/search/typecheck surface that doesn't exist in the\n * remote (sandbox-API) engine. Single source of truth; the per-tool\n * factories, registry definitions, and `createWorkspacePolicyHook`\n * default extractors all key off these.\n *\n * `read_file` is on this list (the existing ReadFile tool is\n * remote-specific; the local engine's `read_file` is a parallel\n * implementation that shares the canonical name so consumer UIs\n * — most importantly LibreChat's `getToolIconType` — render both\n * with the same icon).\n */\nexport const LOCAL_CODING_TOOL_NAMES: readonly string[] = [\n  Constants.READ_FILE,\n  Constants.WRITE_FILE,\n  Constants.EDIT_FILE,\n  Constants.GREP_SEARCH,\n  Constants.GLOB_SEARCH,\n  Constants.LIST_DIRECTORY,\n  Constants.COMPILE_CHECK,\n];\n\n/**\n * Every tool name the local coding bundle (`createLocalCodingTools`)\n * exposes — the local-specific tools above plus the bash/code/PTC\n * pair that the local engine wraps around the existing factories.\n * Tests pin against this so any addition/removal in the bundle is\n * accompanied by a deliberate canonical-name update here.\n */\nexport const LOCAL_CODING_BUNDLE_NAMES: readonly string[] = [\n  ...LOCAL_CODING_TOOL_NAMES,\n  Constants.BASH_TOOL,\n  Constants.EXECUTE_CODE,\n  Constants.PROGRAMMATIC_TOOL_CALLING,\n  Constants.BASH_PROGRAMMATIC_TOOL_CALLING,\n];\n\nexport enum TitleMethod {\n  STRUCTURED = 'structured',\n  FUNCTIONS = 'functions',\n  COMPLETION = 'completion',\n}\n\nexport enum EnvVar {\n  CODE_BASEURL = 'LIBRECHAT_CODE_BASEURL',\n  CODE_API_RUN_TIMEOUT_MS = 'CODE_API_RUN_TIMEOUT_MS',\n}\n"],"mappings":"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"}
+{"version":3,"file":"enum.cjs","names":[],"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] Request to execute tools - dispatched by ToolNode, handled by host */\n  ON_TOOL_EXECUTE = 'on_tool_execute',\n  /** [Custom] Emitted when the summarize node begins generating a summary */\n  ON_SUMMARIZE_START = 'on_summarize_start',\n  /** [Custom] Delta event carrying the completed summary content */\n  ON_SUMMARIZE_DELTA = 'on_summarize_delta',\n  /** [Custom] Emitted when the summarize node completes with the final summary */\n  ON_SUMMARIZE_COMPLETE = 'on_summarize_complete',\n  /** [Custom] Progress update from a running subagent (wraps child-graph events so hosts can display activity separately from parent). */\n  ON_SUBAGENT_UPDATE = 'on_subagent_update',\n  /** [Custom] Diagnostic logging event for context management observability */\n  ON_AGENT_LOG = 'on_agent_log',\n  /** [Custom] Per-model-call context window usage snapshot (post-prune token budget) */\n  ON_CONTEXT_USAGE = 'on_context_usage',\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 GraphNodeKeys {\n  TOOLS = 'tools=',\n  AGENT = 'agent=',\n  SUMMARIZE = 'summarize=',\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  /** Framework-level conversation summary block */\n  SUMMARY = 'summary',\n  /** Bedrock */\n  REASONING_CONTENT = 'reasoning_content',\n  /** Mid-run user steer persisted inline in an assistant message; replayed as a user turn */\n  STEER = 'steer',\n  /** Fast-model activity label for a tool/reasoning block; UI-only, never model input */\n  ACTIVITY_LABEL = 'activity_label',\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.librechat.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  HANDOFF_PARALLEL_BATCH = '__handoff_parallel_batch',\n  HANDOFF_GROUP_ID = '__handoff_group_id',\n  /** Delimiter for MCP tools: toolName_mcp_serverName */\n  MCP_DELIMITER = '_mcp_',\n  /** Anthropic server tool ID prefix (web_search, code_execution, etc.) */\n  ANTHROPIC_SERVER_TOOL_PREFIX = 'srvtoolu_',\n  SKILL_TOOL = 'skill',\n  /**\n   * Callback-metadata keys stamped by `attemptInvoke` /\n   * `tryFallbackProviders` carrying the provider (SDK `Providers` enum\n   * value) and configured model that actually served a model invocation.\n   * Unlike `ls_provider` — which derived providers inherit from their base\n   * class (e.g. DeepSeek/OpenRouter report `'openai'`) — these reflect the\n   * SDK's own routing, including fallback-provider calls. Consumed by the\n   * subagent usage-capture handler to tag billing events.\n   */\n  INVOKED_PROVIDER = '__invoked_provider',\n  INVOKED_MODEL = '__invoked_model',\n  READ_FILE = 'read_file',\n  BASH_TOOL = 'bash_tool',\n  BASH_PROGRAMMATIC_TOOL_CALLING = 'run_tools_with_bash',\n  SUBAGENT = 'subagent',\n  /**\n   * Local-engine coding tool names. Promoted to `Constants.*` (rather\n   * than left as per-file `*ToolName` consts) so consumer UIs — most\n   * importantly LibreChat's `getToolIconType` map — can match against\n   * canonical strings instead of guessing. Existing matched names:\n   * `bash_tool`, `read_file`, `execute_code`, `run_tools_with_code`.\n   * The rest below are new and currently fall through to the generic\n   * tool icon; once LibreChat adds icons keyed on the same names, the\n   * wiring will work without an SDK change.\n   */\n  WRITE_FILE = 'write_file',\n  EDIT_FILE = 'edit_file',\n  GREP_SEARCH = 'grep_search',\n  GLOB_SEARCH = 'glob_search',\n  LIST_DIRECTORY = 'list_directory',\n  COMPILE_CHECK = 'compile_check',\n}\n\n/** Tool names that use the code execution environment (shared session, file tracking). */\nexport const CODE_EXECUTION_TOOLS: ReadonlySet<string> = new Set([\n  Constants.EXECUTE_CODE,\n  Constants.BASH_TOOL,\n  Constants.PROGRAMMATIC_TOOL_CALLING,\n  Constants.BASH_PROGRAMMATIC_TOOL_CALLING,\n]);\n\n/**\n * Canonical names of the local-engine-specific coding tools — the\n * file/edit/search/typecheck surface that doesn't exist in the\n * remote (sandbox-API) engine. Single source of truth; the per-tool\n * factories, registry definitions, and `createWorkspacePolicyHook`\n * default extractors all key off these.\n *\n * `read_file` is on this list (the existing ReadFile tool is\n * remote-specific; the local engine's `read_file` is a parallel\n * implementation that shares the canonical name so consumer UIs\n * — most importantly LibreChat's `getToolIconType` — render both\n * with the same icon).\n */\nexport const LOCAL_CODING_TOOL_NAMES: readonly string[] = [\n  Constants.READ_FILE,\n  Constants.WRITE_FILE,\n  Constants.EDIT_FILE,\n  Constants.GREP_SEARCH,\n  Constants.GLOB_SEARCH,\n  Constants.LIST_DIRECTORY,\n  Constants.COMPILE_CHECK,\n];\n\n/**\n * Every tool name the local coding bundle (`createLocalCodingTools`)\n * exposes — the local-specific tools above plus the bash/code/PTC\n * pair that the local engine wraps around the existing factories.\n * Tests pin against this so any addition/removal in the bundle is\n * accompanied by a deliberate canonical-name update here.\n */\nexport const LOCAL_CODING_BUNDLE_NAMES: readonly string[] = [\n  ...LOCAL_CODING_TOOL_NAMES,\n  Constants.BASH_TOOL,\n  Constants.EXECUTE_CODE,\n  Constants.PROGRAMMATIC_TOOL_CALLING,\n  Constants.BASH_PROGRAMMATIC_TOOL_CALLING,\n];\n\nexport enum TitleMethod {\n  STRUCTURED = 'structured',\n  FUNCTIONS = 'functions',\n  COMPLETION = 'completion',\n}\n\nexport enum EnvVar {\n  CODE_BASEURL = 'LIBRECHAT_CODE_BASEURL',\n  CODE_API_RUN_TIMEOUT_MS = 'CODE_API_RUN_TIMEOUT_MS',\n}\n"],"mappings":"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"}

package/dist/cjs/graphs/Graph.cjs

@@ -1,11 +1,11 @@
 const require_langfuseConfig = require("../langfuseConfig.cjs");
 const require_langfuseRuntimeScope = require("../langfuseRuntimeScope.cjs");
 const require_langfuse = require("../langfuse.cjs");
+const require_langfuseToolOutputTracing = require("../langfuseToolOutputTracing.cjs");
 const require_callbacks = require("../utils/callbacks.cjs");
 const require_enum = require("../common/enum.cjs");
 require("../common/index.cjs");
 const require_tokens = require("../utils/tokens.cjs");
-const require_langfuseToolOutputTracing = require("../langfuseToolOutputTracing.cjs");
 const require_instrumentation = require("../instrumentation.cjs");
 const require_core = require("../messages/core.cjs");
 const require_ids = require("../messages/ids.cjs");
@@ -18,6 +18,7 @@ const require_anthropicToolCache = require("../messages/anthropicToolCache.cjs")
 const require_content = require("../messages/content.cjs");
 const require_tools = require("../messages/tools.cjs");
 const require_reducer = require("../messages/reducer.cjs");
+const require_recency = require("../messages/recency.cjs");
 require("../messages/index.cjs");
 const require_graph = require("../utils/graph.cjs");
 const require_llm = require("../utils/llm.cjs");
@@ -26,7 +27,11 @@ const require_toolOutputReferences = require("../tools/toolOutputReferences.cjs"
 const require_events$1 = require("../events.cjs");
 const require_run = require("../utils/run.cjs");
 require("../utils/index.cjs");
-const require_toolCache = require("../llm/openrouter/toolCache.cjs");
+const require_contextOverflowRecovery = require("../llm/contextOverflowRecovery.cjs");
+const require_toolCache = require("../llm/bedrock/toolCache.cjs");
+const require_init = require("../llm/init.cjs");
+const require_invoke = require("../llm/invoke.cjs");
+const require_toolCache$1 = require("../llm/openrouter/toolCache.cjs");
 const require_LocalCodingTools = require("../tools/local/LocalCodingTools.cjs");
 const require_CloudflareSandboxTools = require("../tools/cloudflare/CloudflareSandboxTools.cjs");
 require("../tools/cloudflare/index.cjs");
@@ -35,9 +40,6 @@ require("../tools/local/index.cjs");
 const require_ToolNode = require("../tools/ToolNode.cjs");
 const require_SubagentExecutor = require("../tools/subagent/SubagentExecutor.cjs");
 require("../tools/subagent/index.cjs");
-const require_toolCache$1 = require("../llm/bedrock/toolCache.cjs");
-const require_init = require("../llm/init.cjs");
-const require_invoke = require("../llm/invoke.cjs");
 const require_SubagentTool = require("../tools/SubagentTool.cjs");
 const require_index$6 = require("../summarization/index.cjs");
 const require_request = require("../llm/request.cjs");
@@ -161,6 +163,33 @@ function clearCurrentDeltaStepMarkers({ graph, metadata }) {
 		graph.reasoningStepHasDeltas.delete(stepId);
 	}
 }
+/**
+* The completion allowance the caller configured, under whichever key the
+* provider's client uses. Providers count it against the same ceiling as the
+* prompt, so overflow recovery has to reserve it when the error did not
+* itemize the total.
+*/
+function getConfiguredCompletionTokens(clientOptions) {
+	const options = clientOptions;
+	for (const value of [options?.maxTokens, options?.maxOutputTokens]) if (typeof value === "number" && Number.isFinite(value) && value > 0) return value;
+}
+/**
+* Our own estimate of the prompt that was actually sent, derived from the
+* pre-invoke usage snapshot. Used to corroborate ambiguous provider errors
+* and to measure how far our token accounting sits from the provider's.
+*/
+function getEstimatedPromptTokens(contextUsage) {
+	const budget = contextUsage?.contextBudget;
+	const remaining = contextUsage?.remainingContextTokens;
+	if (budget == null || remaining == null || !Number.isFinite(budget) || !Number.isFinite(remaining)) return;
+	const used = budget - remaining;
+	return used > 0 ? used : void 0;
+}
+function minDefined(left, right) {
+	if (left == null) return right;
+	if (right == null) return left;
+	return Math.min(left, right);
+}
 async function dispatchMessageCreationStep({ graph, stepKey, messageId, metadata }) {
 	await graph.dispatchRunStep(stepKey, {
 		type: "message_creation",
@@ -457,9 +486,13 @@ var StandardGraph = class StandardGraph extends Graph {
 	overrideModel;
 	/** Optional compile options passed into workflow.compile() */
 	compileOptions;
+	/** Whether the workflow was actually compiled with a checkpointer. */
+	hasCompiledCheckpointer = false;
 	messages = [];
 	/** Cached run messages preserved before clearHeavyState() so getRunMessages() works after cleanup. */
 	cachedRunMessages;
+	/** Checkpoint scope whose messages match index-keyed tool snapshots. */
+	originalToolContentCheckpointScope;
 	runId;
 	/**
 	* Boundary between historical messages (loaded from conversation state)
@@ -498,7 +531,7 @@ var StandardGraph = class StandardGraph extends Graph {
 		}
 		this.defaultAgentId = agents[0].agentId;
 	}
-	resetValues(keepContent) {
+	resetValues(keepContent, checkpointScope) {
 		this.messages = [];
 		this.cachedRunMessages = void 0;
 		this.config = require_graph.resetIfNotEmpty(this.config, void 0);
@@ -525,14 +558,18 @@ var StandardGraph = class StandardGraph extends Graph {
 		this.reasoningStepHasDeltas = require_graph.resetIfNotEmpty(this.reasoningStepHasDeltas, /* @__PURE__ */ new Set());
 		this.prelimMessageIdsByStepKey = require_graph.resetIfNotEmpty(this.prelimMessageIdsByStepKey, /* @__PURE__ */ new Map());
 		this.invokedToolIds = require_graph.resetIfNotEmpty(this.invokedToolIds, void 0);
-		for (const context of this.agentContexts.values()) context.reset();
+		const hasScopedCheckpoint = this.hasCompiledCheckpointer && checkpointScope != null && checkpointScope !== "";
+		const preserveOriginalToolContent = hasScopedCheckpoint && this.originalToolContentCheckpointScope === checkpointScope;
+		for (const context of this.agentContexts.values()) context.reset({ preserveOriginalToolContent });
+		this.originalToolContentCheckpointScope = hasScopedCheckpoint ? checkpointScope : void 0;
 	}
 	clearHeavyState() {
 		this.cachedRunMessages = this.messages.slice(this.startIndex);
 		super.clearHeavyState();
 		this.messages = [];
 		this.overrideModel = void 0;
-		for (const context of this.agentContexts.values()) context.reset();
+		const preserveOriginalToolContent = this.hasCompiledCheckpointer && this.originalToolContentCheckpointScope != null;
+		for (const context of this.agentContexts.values()) context.reset({ preserveOriginalToolContent });
 	}
 	getRunStep(stepId) {
 		const index = this.contentIndexMap.get(stepId);
@@ -767,6 +804,49 @@ var StandardGraph = class StandardGraph extends Graph {
 		this.signal.removeEventListener("abort", client.abortHandler);
 		client.abortHandler = void 0;
 	}
+	/**
+	* Applies a context-overflow recovery plan and hands control to the
+	* summarize node, which compacts and then routes straight back here for a
+	* retry against the corrected budget.
+	*
+	* Returning the detour rather than rethrowing is the whole point: the
+	* caller never sees the provider's rejection, only a slightly longer turn.
+	*/
+	beginOverflowRecovery({ recovery, agentContext, agentId, config, originalToolContent, estimatedPromptTokens }) {
+		const previousBudget = agentContext.maxContextTokens;
+		/**
+		* Deterministic compaction first. Re-pruning against the corrected budget
+		* raises context pressure, which is what drives the pruner's tool-output
+		* truncation and observation masking — no model call, no cost, and no
+		* message content lost. A summarization call is held back until that has
+		* been tried and the provider rejected the prompt again.
+		*/
+		const allowSummarization = agentContext.shouldSummarizeOverflow();
+		agentContext.preserveOriginalToolContent(originalToolContent);
+		agentContext.applyContextBudgetCorrection(recovery.budgetTokens, estimatedPromptTokens);
+		agentContext.applyObservedOverflowCalibration(recovery.info.provider, recovery.observedCalibrationRatio);
+		require_events.emitAgentLog(config, "warn", "graph", "Provider rejected the prompt as too large — compacting and retrying", {
+			kind: recovery.info.kind,
+			previousBudget,
+			recoveredBudget: recovery.budgetTokens,
+			providerReportedLimit: recovery.info.limitTokens,
+			providerReportedTokens: recovery.info.requestedTokens,
+			providerReportedPromptTokens: recovery.info.promptTokens,
+			observedCalibrationRatio: recovery.observedCalibrationRatio,
+			detectedBy: recovery.info.source,
+			attempt: agentContext.overflowRecoveryAttempts,
+			compaction: allowSummarization ? "summarize" : "compress"
+		}, {
+			runId: this.runId,
+			agentId
+		}, { force: true });
+		return { summarizationRequest: {
+			remainingContextTokens: 0,
+			agentId: agentId || agentContext.agentId,
+			reason: "overflow",
+			allowSummarization
+		} };
+	}
 	createCallModel(agentId = "default") {
 		return async (state, config) => {
 			const agentContext = this.agentContexts.get(agentId);
@@ -794,10 +874,10 @@ var StandardGraph = class StandardGraph extends Graph {
 			*/
 			let toolsForBinding = rawToolsForBinding;
 			if (agentContext.provider === "anthropic" && agentContext.clientOptions?.promptCache === true) toolsForBinding = require_anthropicToolCache.partitionAndMarkAnthropicToolCache(rawToolsForBinding, require_anthropicToolCache.makeIsDeferred(agentContext.toolDefinitions), require_cache.resolvePromptCacheTtl(agentContext.clientOptions?.promptCacheTtl)) ?? rawToolsForBinding;
-			else if (agentContext.provider === "openrouter" && agentContext.clientOptions?.promptCache === true) toolsForBinding = require_toolCache.partitionAndMarkOpenRouterToolCache(rawToolsForBinding, require_anthropicToolCache.makeIsDeferred(agentContext.toolDefinitions), require_cache.resolvePromptCacheTtl(agentContext.clientOptions?.promptCacheTtl)) ?? rawToolsForBinding;
+			else if (agentContext.provider === "openrouter" && agentContext.clientOptions?.promptCache === true) toolsForBinding = require_toolCache$1.partitionAndMarkOpenRouterToolCache(rawToolsForBinding, require_anthropicToolCache.makeIsDeferred(agentContext.toolDefinitions), require_cache.resolvePromptCacheTtl(agentContext.clientOptions?.promptCacheTtl)) ?? rawToolsForBinding;
 			else if (agentContext.provider === "bedrock" && agentContext.clientOptions?.promptCache === true) {
 				const bedrockModel = agentContext.clientOptions?.model;
-				if (bedrockModel == null || require_cache.supportsBedrockToolCache(bedrockModel)) toolsForBinding = require_toolCache$1.partitionAndMarkBedrockToolCache(rawToolsForBinding, require_anthropicToolCache.makeIsDeferred(agentContext.toolDefinitions)) ?? rawToolsForBinding;
+				if (bedrockModel == null || require_cache.supportsBedrockToolCache(bedrockModel)) toolsForBinding = require_toolCache.partitionAndMarkBedrockToolCache(rawToolsForBinding, require_anthropicToolCache.makeIsDeferred(agentContext.toolDefinitions)) ?? rawToolsForBinding;
 			}
 			let model = this.overrideModel ?? require_init.initializeModel({
 				tools: toolsForBinding,
@@ -810,6 +890,12 @@ var StandardGraph = class StandardGraph extends Graph {
 			this.config = config;
 			let messagesToUse = messages;
 			let contextUsage = null;
+			/**
+			* Held outside the prune block so overflow recovery — which detours to
+			* the summarize node from the invoke catch below — can preserve the
+			* same masking record the configured trigger preserves.
+			*/
+			let prunedOriginalToolContent;
 			if (!agentContext.pruneMessages && agentContext.tokenCounter && agentContext.maxContextTokens != null) agentContext.pruneMessages = require_prune.createPruneMessages({
 				startIndex: agentContext.indexTokenCountMap[0] != null ? this.startIndex : 0,
 				provider: agentContext.provider,
@@ -830,12 +916,22 @@ var StandardGraph = class StandardGraph extends Graph {
 				}
 			});
 			if (agentContext.pruneMessages) {
-				const { context, indexTokenCountMap, messagesToRefine, prePruneContextTokens, remainingContextTokens, originalToolContent, calibrationRatio, resolvedInstructionOverhead, contextBudget, effectiveInstructionTokens } = agentContext.pruneMessages({
+				const { context, indexTokenCountMap, messagesToRefine, prePruneContextTokens, remainingContextTokens, newOriginalToolContent, calibrationRatio, resolvedInstructionOverhead, contextBudget, effectiveInstructionTokens } = agentContext.pruneMessages({
 					messages,
 					usageMetadata: agentContext.currentUsage,
 					lastCallUsage: agentContext.lastCallUsage,
 					totalTokensFresh: agentContext.totalTokensFresh
 				});
+				prunedOriginalToolContent = newOriginalToolContent;
+				/**
+				* Masking rewrites tool content in `state.messages` in place, so this
+				* map is the only surviving copy of the full output. Persist it on
+				* every prune, not just when a summary is about to be written — the
+				* pruner closure that produced it is discarded on the next reset, and
+				* with it any chance of a later summary restoring the real content.
+				* AgentContext bounds what accumulates.
+				*/
+				agentContext.preserveOriginalToolContent(newOriginalToolContent);
 				agentContext.indexTokenCountMap = indexTokenCountMap;
 				if (calibrationRatio != null && calibrationRatio > 0) agentContext.calibrationRatio = calibrationRatio;
 				if (resolvedInstructionOverhead != null) {
@@ -882,31 +978,6 @@ var StandardGraph = class StandardGraph extends Graph {
 						remainingContextTokens,
 						messagesToRefineCount: messagesToRefine.length
 					})) {
-						if (originalToolContent != null && originalToolContent.size > 0)
- /**
-						* Merge — never overwrite — the pruner's masking record
-						* into pendingOriginalToolContent.  Carry-over entries
-						* from a prior summarize (preserved by the recency
-						* window for masked tool messages still in the tail) and
-						* the current pruner's new entries are both keyed by
-						* indices in the current `state.messages`, so a key-wise
-						* union is correct.  Overwriting would discard the
-						* carry-over and reduce summary fidelity when those
-						* masked tail messages eventually move into the head.
-						*/
-						if (agentContext.pendingOriginalToolContent == null) agentContext.pendingOriginalToolContent = originalToolContent;
-						else {
-							for (const [idx, content] of originalToolContent) agentContext.pendingOriginalToolContent.set(idx, content);
-							/**
-							* Re-apply the per-store char cap after the union.  The
-							* pruner enforces ORIGINAL_CONTENT_MAX_CHARS inside its
-							* own map via the onContentStored callback, but a
-							* key-wise merge with recency carry-over bypasses that
-							* accounting and could let the merged map grow without
-							* bound across long sessions.
-							*/
-							require_prune.enforceOriginalContentCap(agentContext.pendingOriginalToolContent);
-						}
 						require_events.emitAgentLog(config, "info", "graph", "Summarization triggered", void 0, {
 							runId: this.runId,
 							agentId
@@ -987,6 +1058,19 @@ var StandardGraph = class StandardGraph extends Graph {
 			* model treats as suspicious injected content.
 			*/
 			finalMessages = require_format.ensureThinkingBlockInMessages(finalMessages, agentContext.provider, config, this.startIndex);
+			/**
+			* A destination that binds no tools is invoked without a tool schema, but
+			* in a multi-agent graph it can still inherit a prior agent's toolUse/
+			* toolResult history. Bedrock's Converse API (and other tool-schema-strict
+			* providers) reject such a request when no top-level toolConfig is sent.
+			* Fold that historical tool content into plain text so the tool-less agent
+			* receives valid, context-preserving messages. Handoff tools count as
+			* bound tools, so a tool-less router mid-handoff is not affected.
+			*/
+			if (toolsForBinding == null || toolsForBinding.length === 0) {
+				finalMessages = require_format.foldToolBlocksForToollessAgent(finalMessages, config);
+				if (agentContext.useLegacyContent) finalMessages = require_content.formatContentStrings(finalMessages);
+			}
 			const anthropicPromptCacheEnabled = agentContext.provider === "anthropic" && agentContext.clientOptions?.promptCache === true;
 			const openRouterPromptCacheEnabled = agentContext.provider === "openrouter" && agentContext.clientOptions?.promptCache === true;
 			const bedrockPromptCacheEnabled = agentContext.provider === "bedrock" && agentContext.clientOptions?.promptCache === true;
@@ -1124,17 +1208,115 @@ var StandardGraph = class StandardGraph extends Graph {
 					graph: this,
 					metadata
 				});
-				result = await require_langfuseRuntimeScope.withLangfuseRuntimeScope(require_langfuseRuntimeScope.resolveLangfuseRuntimeScope({
-					runLangfuse: this.langfuse,
-					langfuseOverlay: agentContext.langfuse
-				}), () => require_invoke.tryFallbackProviders({
-					fallbacks,
-					tools: agentContext.tools,
-					messages: finalMessages,
-					config: invokeConfig,
-					primaryError,
-					context: this
-				}));
+				/**
+				* A context overflow is a deterministic consequence of the payload,
+				* not a provider being unavailable — so it is answered by compacting
+				* and retrying rather than by re-sending the same oversized prompt
+				* down the fallback chain. Fallbacks still run for every other
+				* failure, and for an overflow whose recovery budget is spent.
+				*/
+				/**
+				* Compaction has to have something to work with. Without a token
+				* counter there is no pruner, and with summarization disabled the
+				* summarize node deliberately no-ops — so in that combination the
+				* retry would resend a byte-identical prompt. Skipping the detour
+				* keeps the original error and one round trip instead of three.
+				*/
+				const estimatedPromptTokens = getEstimatedPromptTokens(contextUsage);
+				/**
+				* A previous correction that left the prompt no smaller proves this
+				* state has nothing left to compact — an emptied message list whose
+				* content rides along in an injected summary, for instance. Measuring
+				* that beats trying to predict every such configuration.
+				*/
+				const recoveryStalled = agentContext.overflowRecoveryStalled(estimatedPromptTokens);
+				const canSummarizeOverflow = agentContext.summarizationEnabled === true && require_recency.splitAtRecencyBoundary(messages, {
+					turns: agentContext.summarizationConfig?.retainRecent?.turns ?? 2,
+					tokens: agentContext.summarizationConfig?.retainRecent?.tokens,
+					tokenCounter: agentContext.tokenCounter
+				}).head.length > 0;
+				const planRecovery = (error, attributedFallbackContext) => {
+					if (recoveryStalled) return null;
+					/**
+					* When the rejection came from a fallback, plan against *that*
+					* client: its window and output allowance are why it was configured
+					* as an alternative in the first place.
+					*/
+					const fallbackContext = attributedFallbackContext ?? require_invoke.getFallbackErrorContext(error);
+					const recovery = require_contextOverflowRecovery.planContextOverflowRecovery({
+						error,
+						provider: fallbackContext?.provider ?? agentContext.provider,
+						maxContextTokens: fallbackContext?.maxContextTokens ?? agentContext.maxContextTokens,
+						estimatedPromptTokens,
+						calibrationRatio: agentContext.calibrationRatio,
+						instructionTokens: agentContext.instructionTokens,
+						canSummarize: agentContext.summarizationEnabled === true,
+						configuredCompletionTokens: getConfiguredCompletionTokens(fallbackContext?.clientOptions ?? agentContext.clientOptions),
+						attemptsSoFar: agentContext.overflowRecoveryAttempts
+					});
+					if (recovery == null) return null;
+					const translatedRecovery = fallbackContext != null ? {
+						...recovery,
+						budgetTokens: minDefined(require_contextOverflowRecovery.getBlindRecoveryBudget(agentContext.maxContextTokens), require_contextOverflowRecovery.translateRecoveryBudget(recovery.budgetTokens, recovery.observedCalibrationRatio ?? 5, agentContext.calibrationRatio)),
+						observedCalibrationRatio: void 0
+					} : recovery;
+					return canSummarizeOverflow || agentContext.tokenCounter != null && translatedRecovery.budgetTokens != null ? translatedRecovery : null;
+				};
+				const recovery = planRecovery(primaryError);
+				if (recovery != null) return this.beginOverflowRecovery({
+					recovery,
+					agentContext,
+					agentId,
+					config,
+					originalToolContent: prunedOriginalToolContent,
+					estimatedPromptTokens
+				});
+				/**
+				* A fallback can reject the same prompt as too large even when the
+				* primary failed for an unrelated reason — a fallback with a smaller
+				* window is the obvious case. Planning against the exhausted-chain
+				* error keeps that path recoverable instead of surfacing it.
+				*/
+				try {
+					result = await require_langfuseRuntimeScope.withLangfuseRuntimeScope(require_langfuseRuntimeScope.resolveLangfuseRuntimeScope({
+						runLangfuse: this.langfuse,
+						langfuseOverlay: agentContext.langfuse
+					}), () => require_invoke.tryFallbackProviders({
+						fallbacks,
+						tools: agentContext.tools,
+						messages: finalMessages,
+						config: invokeConfig,
+						primaryError,
+						context: this,
+						/**
+						* Lets the chain recognise a fallback overflow whose signature
+						* carries no reason of its own (Vertex AI's bare 400) and
+						* surface it rather than a later unrelated failure.
+						*/
+						overflowContext: {
+							provider: agentContext.provider,
+							estimatedPromptTokens: getEstimatedPromptTokens(contextUsage),
+							maxContextTokens: agentContext.maxContextTokens
+						}
+					}));
+				} catch (fallbackError) {
+					const overflowCandidates = require_invoke.getFallbackOverflowCandidates(fallbackError);
+					let fallbackRecovery = null;
+					for (const candidate of overflowCandidates) {
+						fallbackRecovery = planRecovery(candidate.error, candidate.context);
+						if (fallbackRecovery != null) break;
+					}
+					if (overflowCandidates.length === 0) fallbackRecovery = planRecovery(fallbackError);
+					if (fallbackRecovery == null) throw fallbackError;
+					return this.beginOverflowRecovery({
+						recovery: fallbackRecovery,
+						agentContext,
+						agentId,
+						config,
+						originalToolContent: prunedOriginalToolContent,
+						estimatedPromptTokens
+					});
+				}
 			} finally {
 				await require_langfuse.disposeLangfuseHandler(langfuseHandler);
 			}
@@ -1373,9 +1555,13 @@ var StandardGraph = class StandardGraph extends Graph {
 				isMultiAgent: this.isMultiAgentGraph(),
 				hookRegistry: this.hookRegistry,
 				dispatchRunStep: async (runStep, nodeConfig) => {
+					const resolvedConfig = nodeConfig ?? this.config;
+					if (runStep.agentId != null) {
+						const groupId = this.resolveParallelGroupId(runStep.agentId, resolvedConfig?.metadata);
+						if (groupId != null) runStep.groupId = groupId;
+					}
 					this.contentData.push(runStep);
 					this.contentIndexMap.set(runStep.id, runStep.index);
-					const resolvedConfig = nodeConfig ?? this.config;
 					const handler = this.handlerRegistry?.getHandler("on_run_step");
 					if (handler) {
 						await handler.handle("on_run_step", runStep, resolvedConfig?.configurable, this);
@@ -1403,6 +1589,7 @@ var StandardGraph = class StandardGraph extends Graph {
 		})).addEdge(_langchain_langgraph.START, agentNode).addConditionalEdges(agentNode, routeMessage).addEdge(summarizeNode, agentNode).addEdge(toolNode, agentContext.toolEnd ? _langchain_langgraph.END : agentNode).compile();
 	}
 	createWorkflow() {
+		this.hasCompiledCheckpointer = this.compileOptions?.checkpointer != null;
 		const agentNode = this.createAgentNode(this.defaultAgentId);
 		return new _langchain_langgraph.StateGraph(_langchain_langgraph.Annotation.Root({ messages: (0, _langchain_langgraph.Annotation)({
 			reducer: (a, b) => {
@@ -1430,6 +1617,13 @@ var StandardGraph = class StandardGraph extends Graph {
 	* @returns undefined for StandardGraph (no parallel groups), or group number for MultiAgentGraph
 	*/
 	getParallelGroupIdForAgent(_agentId) {}
+	resolveParallelGroupId(agentId, metadata) {
+		if (metadata == null || !Object.prototype.hasOwnProperty.call(metadata, "__handoff_group_id")) return this.getParallelGroupIdForAgent(agentId);
+		const runtimeGroupId = metadata["__handoff_group_id"];
+		if (runtimeGroupId === null) return;
+		if (typeof runtimeGroupId === "number" && Number.isSafeInteger(runtimeGroupId) && runtimeGroupId > 0) return runtimeGroupId;
+		return this.getParallelGroupIdForAgent(agentId);
+	}
 	/**
 	* Dispatches a run step to the client, returns the step ID
 	*/
@@ -1455,7 +1649,7 @@ var StandardGraph = class StandardGraph extends Graph {
 			const agentContext = this.getAgentContext(metadata);
 			if (this.isMultiAgentGraph() && agentContext.agentId) {
 				runStep.agentId = agentContext.agentId;
-				const groupId = this.getParallelGroupIdForAgent(agentContext.agentId);
+				const groupId = this.resolveParallelGroupId(agentContext.agentId, metadata);
 				if (groupId != null) runStep.groupId = groupId;
 			}
 		} catch (_e) {}