langchain 1.5.4 → 1.5.5

package/dist/agents/transformers/subagent.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"subagent.cjs","names":["StreamChannel","createToolCallTransformer"],"sources":["../../../src/agents/transformers/subagent.ts"],"sourcesContent":["import {\n  StreamChannel,\n  createMessagesTransformer,\n  type NativeStreamTransformer,\n  type ProtocolEvent,\n  type Namespace,\n  type LifecycleCause,\n} from \"@langchain/langgraph\";\n\nimport { createToolCallTransformer } from \"./tool-call.js\";\nimport type { SubagentRunStream } from \"./types.js\";\n\ninterface SubagentProjection {\n  subagents: AsyncIterable<SubagentRunStream>;\n}\n\n/** Per-subagent transformer instances, driven manually by the parent. */\ntype MessagesTransformer = ReturnType<typeof createMessagesTransformer>;\ntype ToolCallTransformer = ReturnType<\n  ReturnType<typeof createToolCallTransformer>\n>;\ntype NestedSubagentTransformer = ReturnType<\n  ReturnType<typeof createSubagentTransformer>\n>;\n\ninterface SubagentHandle {\n  readonly key: string;\n  readonly path: Namespace;\n  readonly name: string;\n  readonly messages: MessagesTransformer;\n  readonly toolCall: ToolCallTransformer;\n  readonly nested: NestedSubagentTransformer;\n  readonly resolveOutput: (value: unknown) => void;\n  readonly rejectOutput: (error: unknown) => void;\n  latestValues: Record<string, unknown> | undefined;\n  done: boolean;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\n/** Stable string key for a namespace. */\nfunction nsKey(ns: Namespace): string {\n  return ns.join(\"\\u0000\");\n}\n\n/** Tests whether `ns` starts with every segment in `prefix`. */\nfunction hasPrefix(ns: Namespace, prefix: Namespace): boolean {\n  if (prefix.length > ns.length) return false;\n  for (let i = 0; i < prefix.length; i += 1) {\n    if (ns[i] !== prefix[i]) return false;\n  }\n  return true;\n}\n\n/**\n * Creates a native transformer that surfaces nested named agents on\n * `run.subagents`.\n *\n * It watches `tasks` events to record each namespace's `lc_agent_name` (set by\n * `createAgent({ name })`) and the triggering tool call, then — for any nested\n * run one level below {@link scope} that carries an `lc_agent_name` — emits a\n * typed {@link SubagentRunStream} handle.\n *\n * Each handle is backed by its own per-subagent transformer instances\n * ({@link createMessagesTransformer}, {@link createToolCallTransformer}, and a\n * nested {@link createSubagentTransformer}) scoped to the subagent's namespace.\n * Every event in the subtree is fed straight into those transformers, which\n * self-filter by namespace; the subagent's final `output` is resolved from its\n * last `values` snapshot when its `lifecycle` completes.\n *\n * Marked `__native: true` — the `subagents` projection lands directly on the\n * `GraphRunStream` instance as `run.subagents`.\n *\n * @param scope - Namespace prefix this transformer is scoped to. The root agent\n *   uses `[]`; nested handles use their subagent's namespace, so grandchild\n *   subagents are discovered recursively.\n */\nexport function createSubagentTransformer(\n  scope: Namespace = []\n): () => NativeStreamTransformer<SubagentProjection> {\n  return () => {\n    const subagentsLog = StreamChannel.local<SubagentRunStream>();\n    /** `lc_agent_name` observed per namespace (first task event wins). */\n    const lcByNs = new Map<string, string | undefined>();\n    /** Triggering task id -> originating LLM `tool_call_id`. */\n    const pendingToolCalls = new Map<string, string>();\n    /**\n     * Namespace key -> the `tool_call_id` of the most recent tool to start\n     * executing there. A tool that invokes a subagent emits its `tool-started`\n     * at the tools-node namespace (`tools:<task_id>`) where the subagent then\n     * roots, so this is the tool call that caused the subagent.\n     */\n    const activeToolCallByNs = new Map<string, string>();\n    const handles = new Map<string, SubagentHandle>();\n    const depth = scope.length;\n\n    function recordIdentity(ns: Namespace, data: unknown): void {\n      const key = nsKey(ns);\n      if (lcByNs.has(key)) return;\n      const metadata =\n        isRecord(data) && isRecord(data.metadata) ? data.metadata : undefined;\n      const lc = metadata?.lc_agent_name;\n      lcByNs.set(key, typeof lc === \"string\" ? lc : undefined);\n    }\n\n    function recordPendingToolCalls(data: unknown): void {\n      if (!isRecord(data)) return;\n      const taskId = data.id;\n      if (typeof taskId !== \"string\") return;\n      const input = data.input;\n      let toolCallId: string | undefined;\n      if (isRecord(input) && isRecord(input.tool_call)) {\n        const candidate = input.tool_call.id;\n        if (typeof candidate === \"string\") toolCallId = candidate;\n      } else if (Array.isArray(input)) {\n        for (const toolCall of input) {\n          if (isRecord(toolCall) && typeof toolCall.id === \"string\") {\n            toolCallId = toolCall.id;\n            break;\n          }\n        }\n      }\n      if (toolCallId != null) pendingToolCalls.set(taskId, toolCallId);\n    }\n\n    /**\n     * Derive the `toolCall` cause for a named-subagent namespace.\n     *\n     * Primary signal: the tool whose `tool-started` event fired at the\n     * subagent's own namespace (the tools node it roots under). Fallback: the\n     * namespace segment's task id (`node:<task_id>`) joined to a tool call\n     * harvested from a `tool_call_with_context`-shaped task input, so the\n     * derivation stays correct if that shape reaches the stream in the future.\n     */\n    function deriveCause(ns: Namespace): LifecycleCause | undefined {\n      const active = activeToolCallByNs.get(nsKey(ns));\n      if (typeof active === \"string\" && active.length > 0) {\n        return { type: \"toolCall\", tool_call_id: active } as LifecycleCause;\n      }\n      const segment = ns[ns.length - 1];\n      const colon = segment.indexOf(\":\");\n      if (colon === -1) return undefined;\n      const triggerCallId = segment.slice(colon + 1);\n      if (triggerCallId.length === 0) return undefined;\n      const toolCallId = pendingToolCalls.get(triggerCallId);\n      if (typeof toolCallId !== \"string\" || toolCallId.length === 0) {\n        return undefined;\n      }\n      return { type: \"toolCall\", tool_call_id: toolCallId } as LifecycleCause;\n    }\n\n    function maybeStartSubagent(ns: Namespace): void {\n      if (ns.length !== depth + 1 || !hasPrefix(ns, scope)) return;\n      const key = nsKey(ns);\n      if (handles.has(key)) return;\n      const lc = lcByNs.get(key);\n      // Only surface nested runs carrying an `lc_agent_name`; plain subgraphs\n      // (no name) are excluded so `run.subagents` stays agent-only.\n      if (typeof lc !== \"string\" || lc.length === 0) return;\n\n      // Per-subagent transformers, each scoped to the subagent's namespace so\n      // they pick out only the subagent's own model node / tools / nested\n      // agents when fed the full event stream.\n      const messages = createMessagesTransformer(ns);\n      const messagesProjection = messages.init();\n      const toolCall = createToolCallTransformer(ns)();\n      const toolCallProjection = toolCall.init();\n      const nested = createSubagentTransformer(ns)();\n      const nestedProjection = nested.init();\n\n      let resolveOutput!: (value: unknown) => void;\n      let rejectOutput!: (error: unknown) => void;\n      const output = new Promise<Record<string, unknown>>((resolve, reject) => {\n        resolveOutput = resolve as (value: unknown) => void;\n        rejectOutput = reject;\n      });\n\n      handles.set(key, {\n        key,\n        path: ns,\n        name: lc,\n        messages,\n        toolCall,\n        nested,\n        resolveOutput,\n        rejectOutput,\n        latestValues: undefined,\n        done: false,\n      });\n\n      subagentsLog.push({\n        name: lc,\n        cause: deriveCause(ns),\n        output,\n        messages: messagesProjection.messages,\n        toolCalls: toolCallProjection.toolCalls,\n        subagents: nestedProjection.subagents,\n      });\n    }\n\n    function finishHandle(\n      handle: SubagentHandle,\n      outcome: { type: \"resolve\" } | { type: \"reject\"; error: unknown }\n    ): void {\n      if (handle.done) return;\n      handle.done = true;\n      if (outcome.type === \"resolve\") {\n        handle.resolveOutput(handle.latestValues);\n      } else {\n        handle.rejectOutput(outcome.error);\n      }\n      handle.messages.finalize?.();\n      handle.toolCall.finalize?.();\n      handle.nested.finalize?.();\n    }\n\n    return {\n      __native: true as const,\n\n      init: () => ({ subagents: subagentsLog }),\n\n      process(event: ProtocolEvent): boolean {\n        const ns = event.params.namespace;\n        const data = event.params.data;\n        const isTaskResult =\n          event.method === \"tasks\" && isRecord(data) && \"result\" in data;\n\n        // Track the tool currently executing at each namespace. A subagent's\n        // dispatching tool starts at the same namespace the subagent roots\n        // under, so this records the cause before the subagent is discovered.\n        if (\n          event.method === \"tools\" &&\n          isRecord(data) &&\n          data.event === \"tool-started\" &&\n          typeof data.tool_call_id === \"string\" &&\n          data.tool_call_id.length > 0\n        ) {\n          activeToolCallByNs.set(nsKey(ns), data.tool_call_id);\n        }\n\n        // A task start: record identity / tool call, then discover a subagent\n        // boundary *before* fanning out so the new handle receives its own\n        // subtree events (which Pregel emits after the parent-namespace task).\n        if (event.method === \"tasks\" && !isTaskResult) {\n          recordIdentity(ns, data);\n          recordPendingToolCalls(data);\n          maybeStartSubagent(ns);\n        }\n\n        // Fan the event out to every active subagent whose subtree contains it.\n        // The per-subagent transformers self-filter by namespace depth.\n        for (const handle of handles.values()) {\n          if (handle.done) continue;\n          if (!hasPrefix(ns, handle.path)) continue;\n\n          handle.messages.process(event);\n          handle.toolCall.process(event);\n          handle.nested.process(event);\n\n          // Track the subagent's own (root-level) state and resolve its\n          // `output` from the last snapshot when its lifecycle completes.\n          if (nsKey(ns) === handle.key) {\n            if (event.method === \"values\" && isRecord(data)) {\n              handle.latestValues = data;\n            } else if (event.method === \"lifecycle\" && isRecord(data)) {\n              const status = data.event;\n              if (status === \"completed\" || status === \"interrupted\") {\n                finishHandle(handle, { type: \"resolve\" });\n              } else if (status === \"failed\") {\n                finishHandle(handle, {\n                  type: \"reject\",\n                  error: new Error(`Subagent ${handle.name} failed`),\n                });\n              }\n            }\n          }\n        }\n\n        return true;\n      },\n\n      finalize(): void {\n        for (const handle of handles.values()) {\n          finishHandle(handle, { type: \"resolve\" });\n        }\n        subagentsLog.close();\n      },\n\n      fail(err: unknown): void {\n        for (const handle of handles.values()) {\n          finishHandle(handle, { type: \"reject\", error: err });\n        }\n        subagentsLog.fail(err);\n      },\n    };\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"subagent.cjs","names":["StreamChannel","createToolCallTransformer"],"sources":["../../../src/agents/transformers/subagent.ts"],"sourcesContent":["import {\n  StreamChannel,\n  createMessagesTransformer,\n  type NativeStreamTransformer,\n  type ProtocolEvent,\n  type Namespace,\n  type LifecycleCause,\n} from \"@langchain/langgraph\";\n\nimport { createToolCallTransformer } from \"./tool-call.js\";\nimport type { SubagentRunStream } from \"./types.js\";\n\ninterface SubagentProjection {\n  subagents: AsyncIterable<SubagentRunStream>;\n}\n\n/** Per-subagent transformer instances, driven manually by the parent. */\ntype MessagesTransformer = ReturnType<typeof createMessagesTransformer>;\ntype ToolCallTransformer = ReturnType<\n  ReturnType<typeof createToolCallTransformer>\n>;\ntype NestedSubagentTransformer = ReturnType<\n  ReturnType<typeof createSubagentTransformer>\n>;\n\ninterface SubagentHandle {\n  readonly key: string;\n  readonly path: Namespace;\n  readonly name: string;\n  readonly messages: MessagesTransformer;\n  readonly toolCall: ToolCallTransformer;\n  readonly nested: NestedSubagentTransformer;\n  readonly resolveOutput: (value: unknown) => void;\n  readonly rejectOutput: (error: unknown) => void;\n  latestValues: Record<string, unknown> | undefined;\n  done: boolean;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\n/** Stable string key for a namespace. */\nfunction nsKey(ns: Namespace): string {\n  return ns.join(\"\\u0000\");\n}\n\n/** Tests whether `ns` starts with every segment in `prefix`. */\nfunction hasPrefix(ns: Namespace, prefix: Namespace): boolean {\n  if (prefix.length > ns.length) return false;\n  for (let i = 0; i < prefix.length; i += 1) {\n    if (ns[i] !== prefix[i]) return false;\n  }\n  return true;\n}\n\n/**\n * Creates a native transformer that surfaces nested named agents on\n * `run.subagents`.\n *\n * It watches `tasks` events to record each namespace's `lc_agent_name` (set by\n * `createAgent({ name })`) and the triggering tool call, then — for any nested\n * run one level below {@link scope} that carries an `lc_agent_name` — emits a\n * typed {@link SubagentRunStream} handle.\n *\n * Each handle is backed by its own per-subagent transformer instances\n * ({@link createMessagesTransformer}, {@link createToolCallTransformer}, and a\n * nested {@link createSubagentTransformer}) scoped to the subagent's namespace.\n * Every event in the subtree is fed straight into those transformers, which\n * self-filter by namespace; the subagent's final `output` is resolved from its\n * last `values` snapshot when its `lifecycle` completes.\n *\n * Marked `__native: true` — the `subagents` projection lands directly on the\n * `GraphRunStream` instance as `run.subagents`.\n *\n * @param scope - Namespace prefix this transformer is scoped to. The root agent\n *   uses `[]`; nested handles use their subagent's namespace, so grandchild\n *   subagents are discovered recursively.\n */\nexport function createSubagentTransformer(\n  scope: Namespace = []\n): () => NativeStreamTransformer<SubagentProjection> {\n  return () => {\n    const subagentsLog = StreamChannel.local<SubagentRunStream>();\n    /** `lc_agent_name` observed per namespace (first task event wins). */\n    const lcByNs = new Map<string, string | undefined>();\n    /** Triggering task id -> originating LLM `tool_call_id`. */\n    const pendingToolCalls = new Map<string, string>();\n    /**\n     * Namespace key -> the `tool_call_id` of the most recent tool to start\n     * executing there. A tool that invokes a subagent emits its `tool-started`\n     * at the tools-node namespace (`tools:<task_id>`) where the subagent then\n     * roots, so this is the tool call that caused the subagent.\n     */\n    const activeToolCallByNs = new Map<string, string>();\n    const handles = new Map<string, SubagentHandle>();\n    const depth = scope.length;\n\n    function recordIdentity(ns: Namespace, data: unknown): void {\n      const key = nsKey(ns);\n      if (lcByNs.has(key)) return;\n      const metadata =\n        isRecord(data) && isRecord(data.metadata) ? data.metadata : undefined;\n      const lc = metadata?.lc_agent_name;\n      lcByNs.set(key, typeof lc === \"string\" ? lc : undefined);\n    }\n\n    function recordPendingToolCalls(data: unknown): void {\n      if (!isRecord(data)) return;\n      const taskId = data.id;\n      if (typeof taskId !== \"string\") return;\n      const input = data.input;\n      let toolCallId: string | undefined;\n      if (isRecord(input) && isRecord(input.tool_call)) {\n        const candidate = input.tool_call.id;\n        if (typeof candidate === \"string\") toolCallId = candidate;\n      } else if (Array.isArray(input)) {\n        for (const toolCall of input) {\n          if (isRecord(toolCall) && typeof toolCall.id === \"string\") {\n            toolCallId = toolCall.id;\n            break;\n          }\n        }\n      }\n      if (toolCallId != null) pendingToolCalls.set(taskId, toolCallId);\n    }\n\n    /**\n     * Derive the `toolCall` cause for a named-subagent namespace.\n     *\n     * Primary signal: the tool whose `tool-started` event fired at the\n     * subagent's own namespace (the tools node it roots under). Fallback: the\n     * namespace segment's task id (`node:<task_id>`) joined to a tool call\n     * harvested from a `tool_call_with_context`-shaped task input, so the\n     * derivation stays correct if that shape reaches the stream in the future.\n     */\n    function deriveCause(ns: Namespace): LifecycleCause | undefined {\n      const active = activeToolCallByNs.get(nsKey(ns));\n      if (typeof active === \"string\" && active.length > 0) {\n        return { type: \"toolCall\", tool_call_id: active } as LifecycleCause;\n      }\n      const segment = ns[ns.length - 1];\n      const colon = segment.indexOf(\":\");\n      if (colon === -1) return undefined;\n      const triggerCallId = segment.slice(colon + 1);\n      if (triggerCallId.length === 0) return undefined;\n      const toolCallId = pendingToolCalls.get(triggerCallId);\n      if (typeof toolCallId !== \"string\" || toolCallId.length === 0) {\n        return undefined;\n      }\n      return { type: \"toolCall\", tool_call_id: toolCallId } as LifecycleCause;\n    }\n\n    function maybeStartSubagent(ns: Namespace): void {\n      if (ns.length !== depth + 1 || !hasPrefix(ns, scope)) return;\n      const key = nsKey(ns);\n      if (handles.has(key)) return;\n      const lc = lcByNs.get(key);\n      // Only surface nested runs carrying an `lc_agent_name`; plain subgraphs\n      // (no name) are excluded so `run.subagents` stays agent-only.\n      if (typeof lc !== \"string\" || lc.length === 0) return;\n\n      // Per-subagent transformers, each scoped to the subagent's namespace so\n      // they pick out only the subagent's own model node / tools / nested\n      // agents when fed the full event stream.\n      const messages = createMessagesTransformer(ns);\n      const messagesProjection = messages.init();\n      const toolCall = createToolCallTransformer(ns)();\n      const toolCallProjection = toolCall.init();\n      const nested = createSubagentTransformer(ns)();\n      const nestedProjection = nested.init();\n\n      let resolveOutput!: (value: unknown) => void;\n      let rejectOutput!: (error: unknown) => void;\n      const output = new Promise<Record<string, unknown>>((resolve, reject) => {\n        resolveOutput = resolve as (value: unknown) => void;\n        rejectOutput = reject;\n      });\n\n      handles.set(key, {\n        key,\n        path: ns,\n        name: lc,\n        messages,\n        toolCall,\n        nested,\n        resolveOutput,\n        rejectOutput,\n        latestValues: undefined,\n        done: false,\n      });\n\n      subagentsLog.push({\n        name: lc,\n        cause: deriveCause(ns),\n        output,\n        messages: messagesProjection.messages,\n        toolCalls: toolCallProjection.toolCalls,\n        subagents: nestedProjection.subagents,\n      });\n    }\n\n    function finishHandle(\n      handle: SubagentHandle,\n      outcome: { type: \"resolve\" } | { type: \"reject\"; error: unknown }\n    ): void {\n      if (handle.done) return;\n      handle.done = true;\n      if (outcome.type === \"resolve\") {\n        handle.resolveOutput(handle.latestValues);\n      } else {\n        handle.rejectOutput(outcome.error);\n      }\n      handle.messages.finalize?.();\n      handle.toolCall.finalize?.();\n      handle.nested.finalize?.();\n    }\n\n    return {\n      __native: true as const,\n\n      init: () => ({ subagents: subagentsLog }),\n\n      process(event: ProtocolEvent): boolean {\n        const ns = event.params.namespace;\n        const data = event.params.data;\n        const isTaskResult =\n          event.method === \"tasks\" && isRecord(data) && \"result\" in data;\n\n        // Track the tool currently executing at each namespace. A subagent's\n        // dispatching tool starts at the same namespace the subagent roots\n        // under, so this records the cause before the subagent is discovered.\n        if (\n          event.method === \"tools\" &&\n          isRecord(data) &&\n          data.event === \"tool-started\" &&\n          typeof data.tool_call_id === \"string\" &&\n          data.tool_call_id.length > 0\n        ) {\n          activeToolCallByNs.set(nsKey(ns), data.tool_call_id);\n        }\n\n        // A task start: record identity / tool call, then discover a subagent\n        // boundary *before* fanning out so the new handle receives its own\n        // subtree events (which Pregel emits after the parent-namespace task).\n        if (event.method === \"tasks\" && !isTaskResult) {\n          recordIdentity(ns, data);\n          recordPendingToolCalls(data);\n          maybeStartSubagent(ns);\n        }\n\n        // Fan the event out to every active subagent whose subtree contains it.\n        // The per-subagent transformers self-filter by namespace depth.\n        for (const handle of handles.values()) {\n          if (handle.done) continue;\n          if (!hasPrefix(ns, handle.path)) continue;\n\n          handle.messages.process(event);\n          handle.toolCall.process(event);\n          handle.nested.process(event);\n\n          // Track the subagent's own (root-level) state and resolve its\n          // `output` from the last snapshot when its lifecycle completes.\n          if (nsKey(ns) === handle.key) {\n            if (event.method === \"values\" && isRecord(data)) {\n              handle.latestValues = data;\n            } else if (event.method === \"lifecycle\" && isRecord(data)) {\n              const status = data.event;\n              if (status === \"completed\" || status === \"interrupted\") {\n                finishHandle(handle, { type: \"resolve\" });\n              } else if (status === \"failed\") {\n                finishHandle(handle, {\n                  type: \"reject\",\n                  error: new Error(`Subagent ${handle.name} failed`),\n                });\n              }\n            }\n          }\n        }\n\n        return true;\n      },\n\n      finalize(): void {\n        for (const handle of handles.values()) {\n          finishHandle(handle, { type: \"resolve\" });\n        }\n        subagentsLog.close();\n      },\n\n      fail(err: unknown): void {\n        for (const handle of handles.values()) {\n          finishHandle(handle, { type: \"reject\", error: err });\n        }\n        subagentsLog.fail(err);\n      },\n    };\n  };\n}\n"],"mappings":"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"}

package/dist/agents/transformers/subagent.d.cts

@@ -1,6 +1,5 @@
 import { SubagentRunStream } from "./types.cjs";
 import { Namespace, NativeStreamTransformer } from "@langchain/langgraph";
-
 //#region src/agents/transformers/subagent.d.ts
 interface SubagentProjection {
   subagents: AsyncIterable<SubagentRunStream>;

package/dist/agents/transformers/subagent.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"subagent.d.cts","names":[],"sources":["../../../src/agents/transformers/subagent.ts"],"mappings":";;;;UAYU,kBAAA;EACR,SAAA,EAAW,aAAA,CAAc,iBAAA;AAAA;;;;;;;;;AAkE3B;;;;;;;;;;;;;;;iBAAgB,yBAAA,CACd,KAAA,GAAO,SAAA,SACA,uBAAA,CAAwB,kBAAA"}
+{"version":3,"file":"subagent.d.cts","names":[],"sources":["../../../src/agents/transformers/subagent.ts"],"mappings":";;;UAYU;EACR,WAAW,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;iBAkEX,0BACd,QAAO,kBACA,wBAAwB"}

package/dist/agents/transformers/subagent.d.ts

@@ -1,6 +1,5 @@
 import { SubagentRunStream } from "./types.js";
 import { Namespace, NativeStreamTransformer } from "@langchain/langgraph";
-
 //#region src/agents/transformers/subagent.d.ts
 interface SubagentProjection {
   subagents: AsyncIterable<SubagentRunStream>;

package/dist/agents/transformers/subagent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"subagent.d.ts","names":[],"sources":["../../../src/agents/transformers/subagent.ts"],"mappings":";;;;UAYU,kBAAA;EACR,SAAA,EAAW,aAAA,CAAc,iBAAA;AAAA;;;;;;;;;AAkE3B;;;;;;;;;;;;;;;iBAAgB,yBAAA,CACd,KAAA,GAAO,SAAA,SACA,uBAAA,CAAwB,kBAAA"}
+{"version":3,"file":"subagent.d.ts","names":[],"sources":["../../../src/agents/transformers/subagent.ts"],"mappings":";;;UAYU;EACR,WAAW,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;iBAkEX,0BACd,QAAO,kBACA,wBAAwB"}

package/dist/agents/transformers/subagent.js.map

@@ -1 +1 @@
-{"version":3,"file":"subagent.js","names":[],"sources":["../../../src/agents/transformers/subagent.ts"],"sourcesContent":["import {\n  StreamChannel,\n  createMessagesTransformer,\n  type NativeStreamTransformer,\n  type ProtocolEvent,\n  type Namespace,\n  type LifecycleCause,\n} from \"@langchain/langgraph\";\n\nimport { createToolCallTransformer } from \"./tool-call.js\";\nimport type { SubagentRunStream } from \"./types.js\";\n\ninterface SubagentProjection {\n  subagents: AsyncIterable<SubagentRunStream>;\n}\n\n/** Per-subagent transformer instances, driven manually by the parent. */\ntype MessagesTransformer = ReturnType<typeof createMessagesTransformer>;\ntype ToolCallTransformer = ReturnType<\n  ReturnType<typeof createToolCallTransformer>\n>;\ntype NestedSubagentTransformer = ReturnType<\n  ReturnType<typeof createSubagentTransformer>\n>;\n\ninterface SubagentHandle {\n  readonly key: string;\n  readonly path: Namespace;\n  readonly name: string;\n  readonly messages: MessagesTransformer;\n  readonly toolCall: ToolCallTransformer;\n  readonly nested: NestedSubagentTransformer;\n  readonly resolveOutput: (value: unknown) => void;\n  readonly rejectOutput: (error: unknown) => void;\n  latestValues: Record<string, unknown> | undefined;\n  done: boolean;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\n/** Stable string key for a namespace. */\nfunction nsKey(ns: Namespace): string {\n  return ns.join(\"\\u0000\");\n}\n\n/** Tests whether `ns` starts with every segment in `prefix`. */\nfunction hasPrefix(ns: Namespace, prefix: Namespace): boolean {\n  if (prefix.length > ns.length) return false;\n  for (let i = 0; i < prefix.length; i += 1) {\n    if (ns[i] !== prefix[i]) return false;\n  }\n  return true;\n}\n\n/**\n * Creates a native transformer that surfaces nested named agents on\n * `run.subagents`.\n *\n * It watches `tasks` events to record each namespace's `lc_agent_name` (set by\n * `createAgent({ name })`) and the triggering tool call, then — for any nested\n * run one level below {@link scope} that carries an `lc_agent_name` — emits a\n * typed {@link SubagentRunStream} handle.\n *\n * Each handle is backed by its own per-subagent transformer instances\n * ({@link createMessagesTransformer}, {@link createToolCallTransformer}, and a\n * nested {@link createSubagentTransformer}) scoped to the subagent's namespace.\n * Every event in the subtree is fed straight into those transformers, which\n * self-filter by namespace; the subagent's final `output` is resolved from its\n * last `values` snapshot when its `lifecycle` completes.\n *\n * Marked `__native: true` — the `subagents` projection lands directly on the\n * `GraphRunStream` instance as `run.subagents`.\n *\n * @param scope - Namespace prefix this transformer is scoped to. The root agent\n *   uses `[]`; nested handles use their subagent's namespace, so grandchild\n *   subagents are discovered recursively.\n */\nexport function createSubagentTransformer(\n  scope: Namespace = []\n): () => NativeStreamTransformer<SubagentProjection> {\n  return () => {\n    const subagentsLog = StreamChannel.local<SubagentRunStream>();\n    /** `lc_agent_name` observed per namespace (first task event wins). */\n    const lcByNs = new Map<string, string | undefined>();\n    /** Triggering task id -> originating LLM `tool_call_id`. */\n    const pendingToolCalls = new Map<string, string>();\n    /**\n     * Namespace key -> the `tool_call_id` of the most recent tool to start\n     * executing there. A tool that invokes a subagent emits its `tool-started`\n     * at the tools-node namespace (`tools:<task_id>`) where the subagent then\n     * roots, so this is the tool call that caused the subagent.\n     */\n    const activeToolCallByNs = new Map<string, string>();\n    const handles = new Map<string, SubagentHandle>();\n    const depth = scope.length;\n\n    function recordIdentity(ns: Namespace, data: unknown): void {\n      const key = nsKey(ns);\n      if (lcByNs.has(key)) return;\n      const metadata =\n        isRecord(data) && isRecord(data.metadata) ? data.metadata : undefined;\n      const lc = metadata?.lc_agent_name;\n      lcByNs.set(key, typeof lc === \"string\" ? lc : undefined);\n    }\n\n    function recordPendingToolCalls(data: unknown): void {\n      if (!isRecord(data)) return;\n      const taskId = data.id;\n      if (typeof taskId !== \"string\") return;\n      const input = data.input;\n      let toolCallId: string | undefined;\n      if (isRecord(input) && isRecord(input.tool_call)) {\n        const candidate = input.tool_call.id;\n        if (typeof candidate === \"string\") toolCallId = candidate;\n      } else if (Array.isArray(input)) {\n        for (const toolCall of input) {\n          if (isRecord(toolCall) && typeof toolCall.id === \"string\") {\n            toolCallId = toolCall.id;\n            break;\n          }\n        }\n      }\n      if (toolCallId != null) pendingToolCalls.set(taskId, toolCallId);\n    }\n\n    /**\n     * Derive the `toolCall` cause for a named-subagent namespace.\n     *\n     * Primary signal: the tool whose `tool-started` event fired at the\n     * subagent's own namespace (the tools node it roots under). Fallback: the\n     * namespace segment's task id (`node:<task_id>`) joined to a tool call\n     * harvested from a `tool_call_with_context`-shaped task input, so the\n     * derivation stays correct if that shape reaches the stream in the future.\n     */\n    function deriveCause(ns: Namespace): LifecycleCause | undefined {\n      const active = activeToolCallByNs.get(nsKey(ns));\n      if (typeof active === \"string\" && active.length > 0) {\n        return { type: \"toolCall\", tool_call_id: active } as LifecycleCause;\n      }\n      const segment = ns[ns.length - 1];\n      const colon = segment.indexOf(\":\");\n      if (colon === -1) return undefined;\n      const triggerCallId = segment.slice(colon + 1);\n      if (triggerCallId.length === 0) return undefined;\n      const toolCallId = pendingToolCalls.get(triggerCallId);\n      if (typeof toolCallId !== \"string\" || toolCallId.length === 0) {\n        return undefined;\n      }\n      return { type: \"toolCall\", tool_call_id: toolCallId } as LifecycleCause;\n    }\n\n    function maybeStartSubagent(ns: Namespace): void {\n      if (ns.length !== depth + 1 || !hasPrefix(ns, scope)) return;\n      const key = nsKey(ns);\n      if (handles.has(key)) return;\n      const lc = lcByNs.get(key);\n      // Only surface nested runs carrying an `lc_agent_name`; plain subgraphs\n      // (no name) are excluded so `run.subagents` stays agent-only.\n      if (typeof lc !== \"string\" || lc.length === 0) return;\n\n      // Per-subagent transformers, each scoped to the subagent's namespace so\n      // they pick out only the subagent's own model node / tools / nested\n      // agents when fed the full event stream.\n      const messages = createMessagesTransformer(ns);\n      const messagesProjection = messages.init();\n      const toolCall = createToolCallTransformer(ns)();\n      const toolCallProjection = toolCall.init();\n      const nested = createSubagentTransformer(ns)();\n      const nestedProjection = nested.init();\n\n      let resolveOutput!: (value: unknown) => void;\n      let rejectOutput!: (error: unknown) => void;\n      const output = new Promise<Record<string, unknown>>((resolve, reject) => {\n        resolveOutput = resolve as (value: unknown) => void;\n        rejectOutput = reject;\n      });\n\n      handles.set(key, {\n        key,\n        path: ns,\n        name: lc,\n        messages,\n        toolCall,\n        nested,\n        resolveOutput,\n        rejectOutput,\n        latestValues: undefined,\n        done: false,\n      });\n\n      subagentsLog.push({\n        name: lc,\n        cause: deriveCause(ns),\n        output,\n        messages: messagesProjection.messages,\n        toolCalls: toolCallProjection.toolCalls,\n        subagents: nestedProjection.subagents,\n      });\n    }\n\n    function finishHandle(\n      handle: SubagentHandle,\n      outcome: { type: \"resolve\" } | { type: \"reject\"; error: unknown }\n    ): void {\n      if (handle.done) return;\n      handle.done = true;\n      if (outcome.type === \"resolve\") {\n        handle.resolveOutput(handle.latestValues);\n      } else {\n        handle.rejectOutput(outcome.error);\n      }\n      handle.messages.finalize?.();\n      handle.toolCall.finalize?.();\n      handle.nested.finalize?.();\n    }\n\n    return {\n      __native: true as const,\n\n      init: () => ({ subagents: subagentsLog }),\n\n      process(event: ProtocolEvent): boolean {\n        const ns = event.params.namespace;\n        const data = event.params.data;\n        const isTaskResult =\n          event.method === \"tasks\" && isRecord(data) && \"result\" in data;\n\n        // Track the tool currently executing at each namespace. A subagent's\n        // dispatching tool starts at the same namespace the subagent roots\n        // under, so this records the cause before the subagent is discovered.\n        if (\n          event.method === \"tools\" &&\n          isRecord(data) &&\n          data.event === \"tool-started\" &&\n          typeof data.tool_call_id === \"string\" &&\n          data.tool_call_id.length > 0\n        ) {\n          activeToolCallByNs.set(nsKey(ns), data.tool_call_id);\n        }\n\n        // A task start: record identity / tool call, then discover a subagent\n        // boundary *before* fanning out so the new handle receives its own\n        // subtree events (which Pregel emits after the parent-namespace task).\n        if (event.method === \"tasks\" && !isTaskResult) {\n          recordIdentity(ns, data);\n          recordPendingToolCalls(data);\n          maybeStartSubagent(ns);\n        }\n\n        // Fan the event out to every active subagent whose subtree contains it.\n        // The per-subagent transformers self-filter by namespace depth.\n        for (const handle of handles.values()) {\n          if (handle.done) continue;\n          if (!hasPrefix(ns, handle.path)) continue;\n\n          handle.messages.process(event);\n          handle.toolCall.process(event);\n          handle.nested.process(event);\n\n          // Track the subagent's own (root-level) state and resolve its\n          // `output` from the last snapshot when its lifecycle completes.\n          if (nsKey(ns) === handle.key) {\n            if (event.method === \"values\" && isRecord(data)) {\n              handle.latestValues = data;\n            } else if (event.method === \"lifecycle\" && isRecord(data)) {\n              const status = data.event;\n              if (status === \"completed\" || status === \"interrupted\") {\n                finishHandle(handle, { type: \"resolve\" });\n              } else if (status === \"failed\") {\n                finishHandle(handle, {\n                  type: \"reject\",\n                  error: new Error(`Subagent ${handle.name} failed`),\n                });\n              }\n            }\n          }\n        }\n\n        return true;\n      },\n\n      finalize(): void {\n        for (const handle of handles.values()) {\n          finishHandle(handle, { type: \"resolve\" });\n        }\n        subagentsLog.close();\n      },\n\n      fail(err: unknown): void {\n        for (const handle of handles.values()) {\n          finishHandle(handle, { type: \"reject\", error: err });\n        }\n        subagentsLog.fail(err);\n      },\n    };\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"subagent.js","names":[],"sources":["../../../src/agents/transformers/subagent.ts"],"sourcesContent":["import {\n  StreamChannel,\n  createMessagesTransformer,\n  type NativeStreamTransformer,\n  type ProtocolEvent,\n  type Namespace,\n  type LifecycleCause,\n} from \"@langchain/langgraph\";\n\nimport { createToolCallTransformer } from \"./tool-call.js\";\nimport type { SubagentRunStream } from \"./types.js\";\n\ninterface SubagentProjection {\n  subagents: AsyncIterable<SubagentRunStream>;\n}\n\n/** Per-subagent transformer instances, driven manually by the parent. */\ntype MessagesTransformer = ReturnType<typeof createMessagesTransformer>;\ntype ToolCallTransformer = ReturnType<\n  ReturnType<typeof createToolCallTransformer>\n>;\ntype NestedSubagentTransformer = ReturnType<\n  ReturnType<typeof createSubagentTransformer>\n>;\n\ninterface SubagentHandle {\n  readonly key: string;\n  readonly path: Namespace;\n  readonly name: string;\n  readonly messages: MessagesTransformer;\n  readonly toolCall: ToolCallTransformer;\n  readonly nested: NestedSubagentTransformer;\n  readonly resolveOutput: (value: unknown) => void;\n  readonly rejectOutput: (error: unknown) => void;\n  latestValues: Record<string, unknown> | undefined;\n  done: boolean;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\n/** Stable string key for a namespace. */\nfunction nsKey(ns: Namespace): string {\n  return ns.join(\"\\u0000\");\n}\n\n/** Tests whether `ns` starts with every segment in `prefix`. */\nfunction hasPrefix(ns: Namespace, prefix: Namespace): boolean {\n  if (prefix.length > ns.length) return false;\n  for (let i = 0; i < prefix.length; i += 1) {\n    if (ns[i] !== prefix[i]) return false;\n  }\n  return true;\n}\n\n/**\n * Creates a native transformer that surfaces nested named agents on\n * `run.subagents`.\n *\n * It watches `tasks` events to record each namespace's `lc_agent_name` (set by\n * `createAgent({ name })`) and the triggering tool call, then — for any nested\n * run one level below {@link scope} that carries an `lc_agent_name` — emits a\n * typed {@link SubagentRunStream} handle.\n *\n * Each handle is backed by its own per-subagent transformer instances\n * ({@link createMessagesTransformer}, {@link createToolCallTransformer}, and a\n * nested {@link createSubagentTransformer}) scoped to the subagent's namespace.\n * Every event in the subtree is fed straight into those transformers, which\n * self-filter by namespace; the subagent's final `output` is resolved from its\n * last `values` snapshot when its `lifecycle` completes.\n *\n * Marked `__native: true` — the `subagents` projection lands directly on the\n * `GraphRunStream` instance as `run.subagents`.\n *\n * @param scope - Namespace prefix this transformer is scoped to. The root agent\n *   uses `[]`; nested handles use their subagent's namespace, so grandchild\n *   subagents are discovered recursively.\n */\nexport function createSubagentTransformer(\n  scope: Namespace = []\n): () => NativeStreamTransformer<SubagentProjection> {\n  return () => {\n    const subagentsLog = StreamChannel.local<SubagentRunStream>();\n    /** `lc_agent_name` observed per namespace (first task event wins). */\n    const lcByNs = new Map<string, string | undefined>();\n    /** Triggering task id -> originating LLM `tool_call_id`. */\n    const pendingToolCalls = new Map<string, string>();\n    /**\n     * Namespace key -> the `tool_call_id` of the most recent tool to start\n     * executing there. A tool that invokes a subagent emits its `tool-started`\n     * at the tools-node namespace (`tools:<task_id>`) where the subagent then\n     * roots, so this is the tool call that caused the subagent.\n     */\n    const activeToolCallByNs = new Map<string, string>();\n    const handles = new Map<string, SubagentHandle>();\n    const depth = scope.length;\n\n    function recordIdentity(ns: Namespace, data: unknown): void {\n      const key = nsKey(ns);\n      if (lcByNs.has(key)) return;\n      const metadata =\n        isRecord(data) && isRecord(data.metadata) ? data.metadata : undefined;\n      const lc = metadata?.lc_agent_name;\n      lcByNs.set(key, typeof lc === \"string\" ? lc : undefined);\n    }\n\n    function recordPendingToolCalls(data: unknown): void {\n      if (!isRecord(data)) return;\n      const taskId = data.id;\n      if (typeof taskId !== \"string\") return;\n      const input = data.input;\n      let toolCallId: string | undefined;\n      if (isRecord(input) && isRecord(input.tool_call)) {\n        const candidate = input.tool_call.id;\n        if (typeof candidate === \"string\") toolCallId = candidate;\n      } else if (Array.isArray(input)) {\n        for (const toolCall of input) {\n          if (isRecord(toolCall) && typeof toolCall.id === \"string\") {\n            toolCallId = toolCall.id;\n            break;\n          }\n        }\n      }\n      if (toolCallId != null) pendingToolCalls.set(taskId, toolCallId);\n    }\n\n    /**\n     * Derive the `toolCall` cause for a named-subagent namespace.\n     *\n     * Primary signal: the tool whose `tool-started` event fired at the\n     * subagent's own namespace (the tools node it roots under). Fallback: the\n     * namespace segment's task id (`node:<task_id>`) joined to a tool call\n     * harvested from a `tool_call_with_context`-shaped task input, so the\n     * derivation stays correct if that shape reaches the stream in the future.\n     */\n    function deriveCause(ns: Namespace): LifecycleCause | undefined {\n      const active = activeToolCallByNs.get(nsKey(ns));\n      if (typeof active === \"string\" && active.length > 0) {\n        return { type: \"toolCall\", tool_call_id: active } as LifecycleCause;\n      }\n      const segment = ns[ns.length - 1];\n      const colon = segment.indexOf(\":\");\n      if (colon === -1) return undefined;\n      const triggerCallId = segment.slice(colon + 1);\n      if (triggerCallId.length === 0) return undefined;\n      const toolCallId = pendingToolCalls.get(triggerCallId);\n      if (typeof toolCallId !== \"string\" || toolCallId.length === 0) {\n        return undefined;\n      }\n      return { type: \"toolCall\", tool_call_id: toolCallId } as LifecycleCause;\n    }\n\n    function maybeStartSubagent(ns: Namespace): void {\n      if (ns.length !== depth + 1 || !hasPrefix(ns, scope)) return;\n      const key = nsKey(ns);\n      if (handles.has(key)) return;\n      const lc = lcByNs.get(key);\n      // Only surface nested runs carrying an `lc_agent_name`; plain subgraphs\n      // (no name) are excluded so `run.subagents` stays agent-only.\n      if (typeof lc !== \"string\" || lc.length === 0) return;\n\n      // Per-subagent transformers, each scoped to the subagent's namespace so\n      // they pick out only the subagent's own model node / tools / nested\n      // agents when fed the full event stream.\n      const messages = createMessagesTransformer(ns);\n      const messagesProjection = messages.init();\n      const toolCall = createToolCallTransformer(ns)();\n      const toolCallProjection = toolCall.init();\n      const nested = createSubagentTransformer(ns)();\n      const nestedProjection = nested.init();\n\n      let resolveOutput!: (value: unknown) => void;\n      let rejectOutput!: (error: unknown) => void;\n      const output = new Promise<Record<string, unknown>>((resolve, reject) => {\n        resolveOutput = resolve as (value: unknown) => void;\n        rejectOutput = reject;\n      });\n\n      handles.set(key, {\n        key,\n        path: ns,\n        name: lc,\n        messages,\n        toolCall,\n        nested,\n        resolveOutput,\n        rejectOutput,\n        latestValues: undefined,\n        done: false,\n      });\n\n      subagentsLog.push({\n        name: lc,\n        cause: deriveCause(ns),\n        output,\n        messages: messagesProjection.messages,\n        toolCalls: toolCallProjection.toolCalls,\n        subagents: nestedProjection.subagents,\n      });\n    }\n\n    function finishHandle(\n      handle: SubagentHandle,\n      outcome: { type: \"resolve\" } | { type: \"reject\"; error: unknown }\n    ): void {\n      if (handle.done) return;\n      handle.done = true;\n      if (outcome.type === \"resolve\") {\n        handle.resolveOutput(handle.latestValues);\n      } else {\n        handle.rejectOutput(outcome.error);\n      }\n      handle.messages.finalize?.();\n      handle.toolCall.finalize?.();\n      handle.nested.finalize?.();\n    }\n\n    return {\n      __native: true as const,\n\n      init: () => ({ subagents: subagentsLog }),\n\n      process(event: ProtocolEvent): boolean {\n        const ns = event.params.namespace;\n        const data = event.params.data;\n        const isTaskResult =\n          event.method === \"tasks\" && isRecord(data) && \"result\" in data;\n\n        // Track the tool currently executing at each namespace. A subagent's\n        // dispatching tool starts at the same namespace the subagent roots\n        // under, so this records the cause before the subagent is discovered.\n        if (\n          event.method === \"tools\" &&\n          isRecord(data) &&\n          data.event === \"tool-started\" &&\n          typeof data.tool_call_id === \"string\" &&\n          data.tool_call_id.length > 0\n        ) {\n          activeToolCallByNs.set(nsKey(ns), data.tool_call_id);\n        }\n\n        // A task start: record identity / tool call, then discover a subagent\n        // boundary *before* fanning out so the new handle receives its own\n        // subtree events (which Pregel emits after the parent-namespace task).\n        if (event.method === \"tasks\" && !isTaskResult) {\n          recordIdentity(ns, data);\n          recordPendingToolCalls(data);\n          maybeStartSubagent(ns);\n        }\n\n        // Fan the event out to every active subagent whose subtree contains it.\n        // The per-subagent transformers self-filter by namespace depth.\n        for (const handle of handles.values()) {\n          if (handle.done) continue;\n          if (!hasPrefix(ns, handle.path)) continue;\n\n          handle.messages.process(event);\n          handle.toolCall.process(event);\n          handle.nested.process(event);\n\n          // Track the subagent's own (root-level) state and resolve its\n          // `output` from the last snapshot when its lifecycle completes.\n          if (nsKey(ns) === handle.key) {\n            if (event.method === \"values\" && isRecord(data)) {\n              handle.latestValues = data;\n            } else if (event.method === \"lifecycle\" && isRecord(data)) {\n              const status = data.event;\n              if (status === \"completed\" || status === \"interrupted\") {\n                finishHandle(handle, { type: \"resolve\" });\n              } else if (status === \"failed\") {\n                finishHandle(handle, {\n                  type: \"reject\",\n                  error: new Error(`Subagent ${handle.name} failed`),\n                });\n              }\n            }\n          }\n        }\n\n        return true;\n      },\n\n      finalize(): void {\n        for (const handle of handles.values()) {\n          finishHandle(handle, { type: \"resolve\" });\n        }\n        subagentsLog.close();\n      },\n\n      fail(err: unknown): void {\n        for (const handle of handles.values()) {\n          finishHandle(handle, { type: \"reject\", error: err });\n        }\n        subagentsLog.fail(err);\n      },\n    };\n  };\n}\n"],"mappings":";;;AAsCA,SAAS,SAAS,OAAkD;CAClE,OAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAC5E;;AAGA,SAAS,MAAM,IAAuB;CACpC,OAAO,GAAG,KAAK,IAAQ;AACzB;;AAGA,SAAS,UAAU,IAAe,QAA4B;CAC5D,IAAI,OAAO,SAAS,GAAG,QAAQ,OAAO;CACtC,KAAK,IAAI,IAAI,GAAG,IAAI,OAAO,QAAQ,KAAK,GACtC,IAAI,GAAG,OAAO,OAAO,IAAI,OAAO;CAElC,OAAO;AACT;;;;;;;;;;;;;;;;;;;;;;;;AAyBA,SAAgB,0BACd,QAAmB,CAAC,GAC+B;CACnD,aAAa;EACX,MAAM,eAAe,cAAc,MAAyB;;EAE5D,MAAM,yBAAS,IAAI,IAAgC;;EAEnD,MAAM,mCAAmB,IAAI,IAAoB;;;;;;;EAOjD,MAAM,qCAAqB,IAAI,IAAoB;EACnD,MAAM,0BAAU,IAAI,IAA4B;EAChD,MAAM,QAAQ,MAAM;EAEpB,SAAS,eAAe,IAAe,MAAqB;GAC1D,MAAM,MAAM,MAAM,EAAE;GACpB,IAAI,OAAO,IAAI,GAAG,GAAG;GAGrB,MAAM,MADJ,SAAS,IAAI,KAAK,SAAS,KAAK,QAAQ,IAAI,KAAK,WAAW,KAAA,EAAA,EACzC;GACrB,OAAO,IAAI,KAAK,OAAO,OAAO,WAAW,KAAK,KAAA,CAAS;EACzD;EAEA,SAAS,uBAAuB,MAAqB;GACnD,IAAI,CAAC,SAAS,IAAI,GAAG;GACrB,MAAM,SAAS,KAAK;GACpB,IAAI,OAAO,WAAW,UAAU;GAChC,MAAM,QAAQ,KAAK;GACnB,IAAI;GACJ,IAAI,SAAS,KAAK,KAAK,SAAS,MAAM,SAAS,GAAG;IAChD,MAAM,YAAY,MAAM,UAAU;IAClC,IAAI,OAAO,cAAc,UAAU,aAAa;GAClD,OAAO,IAAI,MAAM,QAAQ,KAAK,GACvB;SAAA,MAAM,YAAY,OACrB,IAAI,SAAS,QAAQ,KAAK,OAAO,SAAS,OAAO,UAAU;KACzD,aAAa,SAAS;KACtB;IACF;;GAGJ,IAAI,cAAc,MAAM,iBAAiB,IAAI,QAAQ,UAAU;EACjE;;;;;;;;;;EAWA,SAAS,YAAY,IAA2C;GAC9D,MAAM,SAAS,mBAAmB,IAAI,MAAM,EAAE,CAAC;GAC/C,IAAI,OAAO,WAAW,YAAY,OAAO,SAAS,GAChD,OAAO;IAAE,MAAM;IAAY,cAAc;GAAO;GAElD,MAAM,UAAU,GAAG,GAAG,SAAS;GAC/B,MAAM,QAAQ,QAAQ,QAAQ,GAAG;GACjC,IAAI,UAAU,IAAI,OAAO,KAAA;GACzB,MAAM,gBAAgB,QAAQ,MAAM,QAAQ,CAAC;GAC7C,IAAI,cAAc,WAAW,GAAG,OAAO,KAAA;GACvC,MAAM,aAAa,iBAAiB,IAAI,aAAa;GACrD,IAAI,OAAO,eAAe,YAAY,WAAW,WAAW,GAC1D;GAEF,OAAO;IAAE,MAAM;IAAY,cAAc;GAAW;EACtD;EAEA,SAAS,mBAAmB,IAAqB;GAC/C,IAAI,GAAG,WAAW,QAAQ,KAAK,CAAC,UAAU,IAAI,KAAK,GAAG;GACtD,MAAM,MAAM,MAAM,EAAE;GACpB,IAAI,QAAQ,IAAI,GAAG,GAAG;GACtB,MAAM,KAAK,OAAO,IAAI,GAAG;GAGzB,IAAI,OAAO,OAAO,YAAY,GAAG,WAAW,GAAG;GAK/C,MAAM,WAAW,0BAA0B,EAAE;GAC7C,MAAM,qBAAqB,SAAS,KAAK;GACzC,MAAM,WAAW,0BAA0B,EAAE,CAAC,CAAC;GAC/C,MAAM,qBAAqB,SAAS,KAAK;GACzC,MAAM,SAAS,0BAA0B,EAAE,CAAC,CAAC;GAC7C,MAAM,mBAAmB,OAAO,KAAK;GAErC,IAAI;GACJ,IAAI;GACJ,MAAM,SAAS,IAAI,SAAkC,SAAS,WAAW;IACvE,gBAAgB;IAChB,eAAe;GACjB,CAAC;GAED,QAAQ,IAAI,KAAK;IACf;IACA,MAAM;IACN,MAAM;IACN;IACA;IACA;IACA;IACA;IACA,cAAc,KAAA;IACd,MAAM;GACR,CAAC;GAED,aAAa,KAAK;IAChB,MAAM;IACN,OAAO,YAAY,EAAE;IACrB;IACA,UAAU,mBAAmB;IAC7B,WAAW,mBAAmB;IAC9B,WAAW,iBAAiB;GAC9B,CAAC;EACH;EAEA,SAAS,aACP,QACA,SACM;GACN,IAAI,OAAO,MAAM;GACjB,OAAO,OAAO;GACd,IAAI,QAAQ,SAAS,WACnB,OAAO,cAAc,OAAO,YAAY;QAExC,OAAO,aAAa,QAAQ,KAAK;GAEnC,OAAO,SAAS,WAAW;GAC3B,OAAO,SAAS,WAAW;GAC3B,OAAO,OAAO,WAAW;EAC3B;EAEA,OAAO;GACL,UAAU;GAEV,aAAa,EAAE,WAAW,aAAa;GAEvC,QAAQ,OAA+B;IACrC,MAAM,KAAK,MAAM,OAAO;IACxB,MAAM,OAAO,MAAM,OAAO;IAC1B,MAAM,eACJ,MAAM,WAAW,WAAW,SAAS,IAAI,KAAK,YAAY;IAK5D,IACE,MAAM,WAAW,WACjB,SAAS,IAAI,KACb,KAAK,UAAU,kBACf,OAAO,KAAK,iBAAiB,YAC7B,KAAK,aAAa,SAAS,GAE3B,mBAAmB,IAAI,MAAM,EAAE,GAAG,KAAK,YAAY;IAMrD,IAAI,MAAM,WAAW,WAAW,CAAC,cAAc;KAC7C,eAAe,IAAI,IAAI;KACvB,uBAAuB,IAAI;KAC3B,mBAAmB,EAAE;IACvB;IAIA,KAAK,MAAM,UAAU,QAAQ,OAAO,GAAG;KACrC,IAAI,OAAO,MAAM;KACjB,IAAI,CAAC,UAAU,IAAI,OAAO,IAAI,GAAG;KAEjC,OAAO,SAAS,QAAQ,KAAK;KAC7B,OAAO,SAAS,QAAQ,KAAK;KAC7B,OAAO,OAAO,QAAQ,KAAK;KAI3B,IAAI,MAAM,EAAE,MAAM,OAAO,KACnB;UAAA,MAAM,WAAW,YAAY,SAAS,IAAI,GAC5C,OAAO,eAAe;WACjB,IAAI,MAAM,WAAW,eAAe,SAAS,IAAI,GAAG;OACzD,MAAM,SAAS,KAAK;OACpB,IAAI,WAAW,eAAe,WAAW,eACvC,aAAa,QAAQ,EAAE,MAAM,UAAU,CAAC;YACnC,IAAI,WAAW,UACpB,aAAa,QAAQ;QACnB,MAAM;QACN,uBAAO,IAAI,MAAM,YAAY,OAAO,KAAK,QAAQ;OACnD,CAAC;MAEL;;IAEJ;IAEA,OAAO;GACT;GAEA,WAAiB;IACf,KAAK,MAAM,UAAU,QAAQ,OAAO,GAClC,aAAa,QAAQ,EAAE,MAAM,UAAU,CAAC;IAE1C,aAAa,MAAM;GACrB;GAEA,KAAK,KAAoB;IACvB,KAAK,MAAM,UAAU,QAAQ,OAAO,GAClC,aAAa,QAAQ;KAAE,MAAM;KAAU,OAAO;IAAI,CAAC;IAErD,aAAa,KAAK,GAAG;GACvB;EACF;CACF;AACF"}

package/dist/agents/transformers/tool-call.cjs

@@ -1,4 +1,3 @@
-require("../../_virtual/_rolldown/runtime.cjs");
 let _langchain_core_messages = require("@langchain/core/messages");
 let _langchain_langgraph = require("@langchain/langgraph");
 //#region src/agents/transformers/tool-call.ts

package/dist/agents/transformers/tool-call.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"tool-call.cjs","names":["ToolMessage","StreamChannel"],"sources":["../../../src/agents/transformers/tool-call.ts"],"sourcesContent":["import {\n  StreamChannel,\n  type NativeStreamTransformer,\n  type ProtocolEvent,\n  type ToolCallStream,\n  type ToolCallStatus,\n  type ToolsEventData,\n  type Namespace,\n} from \"@langchain/langgraph\";\nimport { ToolMessage } from \"@langchain/core/messages\";\n\ninterface ToolCallProjection {\n  toolCalls: AsyncIterable<ToolCallStream>;\n}\n\n/**\n * Returns true when `ns` belongs to the agent's own graph — i.e. it\n * starts with `path` and is at most one level deeper (the agent's\n * internal nodes like `tools`, `model_request`, etc.).\n *\n * Events from subagent subgraphs (two or more levels deeper) are\n * excluded, so `run.toolCalls` / `run.middleware` only show events\n * from the agent itself, not from its subagents.\n */\nfunction isOwnEvent(ns: Namespace, path: Namespace): boolean {\n  if (ns.length < path.length || ns.length > path.length + 1) return false;\n  for (let i = 0; i < path.length; i += 1) {\n    if (ns[i] !== path[i]) return false;\n  }\n  return true;\n}\n\n/**\n * Detects when a `tool-error` payload is actually a graph interrupt rather\n * than a genuine tool failure.\n *\n * A tool that calls `interrupt()` throws a `GraphInterrupt`, whose message is\n * the JSON-serialized `Interrupt[]` array. Each entry has the LangGraph\n * `Interrupt` shape `{ id, value }`: a stable `id` (a hash of the checkpoint\n * namespace, generated by `interrupt()` and always present during graph\n * execution) plus the `value` passed to `interrupt(...)`. We require BOTH a\n * string `id` and a `value` on every entry — a bare `value` is not a reliable\n * discriminator, since a genuine tool error message can also be a JSON array\n * of `{ value }` records (e.g. a validator emitting\n * `[{ \"value\": \"bad input\", \"message\": \"invalid\" }]`). Keying off the\n * interrupt `id` keeps real tool failures on the error path.\n *\n * An interrupt is control flow that *suspends* the run (the tool re-runs on\n * resume); it is not an error, so the tool call must stay pending rather than\n * have its `output` promise rejected. Any interrupt qualifies regardless of\n * its `value` shape: HITL middleware interrupts (`value.type === \"tool\"`) and\n * raw `interrupt(...)` calls from inside a tool are treated identically —\n * raising an interrupt in a tool must work whether or not\n * `humanInTheLoopMiddleware` is involved.\n */\nfunction isToolInterrupt(message: string): boolean {\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(message);\n  } catch {\n    return false;\n  }\n  if (!Array.isArray(parsed) || parsed.length === 0) return false;\n  return parsed.every((entry) => {\n    if (entry == null || typeof entry !== \"object\") return false;\n    const record = entry as Record<string, unknown>;\n    return typeof record.id === \"string\" && \"value\" in record;\n  });\n}\n\n/**\n * Detects serialized LangChain `ToolMessage` values that can appear on\n * `tool-finished.output` after crossing a protocol or serialization boundary.\n *\n * @example\n * ```ts\n * {\n *   lc: 1,\n *   type: \"constructor\",\n *   id: [\"langchain_core\", \"messages\", \"ToolMessage\"],\n *   kwargs: { content: \"raw tool result\", tool_call_id: \"call_1\" }\n * }\n * ```\n */\nfunction isSerializedToolMessage(\n  value: unknown\n): value is { kwargs?: { content?: unknown } } {\n  if (value == null || typeof value !== \"object\") return false;\n  const record = value as Record<string, unknown>;\n  if (record.type !== \"constructor\" || !Array.isArray(record.id)) return false;\n  return record.id[record.id.length - 1] === \"ToolMessage\";\n}\n\nfunction normalizeToolOutput(output: unknown): unknown {\n  if (ToolMessage.isInstance(output)) {\n    return output.content;\n  }\n  if (isSerializedToolMessage(output)) {\n    return output.kwargs?.content;\n  }\n  return output;\n}\n\n/**\n * Creates a native transformer that correlates `tools` channel events\n * into per-call {@link ToolCallStream} objects.\n *\n * Marked `__native: true` — projection keys land directly on the\n * `GraphRunStream` instance as `run.toolCalls`.\n */\nexport function createToolCallTransformer(\n  path: Namespace\n): () => NativeStreamTransformer<ToolCallProjection> {\n  return () => {\n    const toolCallsLog = StreamChannel.local<ToolCallStream>();\n\n    const pendingCalls = new Map<\n      string,\n      {\n        resolveOutput: (v: unknown) => void;\n        rejectOutput: (e: unknown) => void;\n        resolveStatus: (v: ToolCallStatus) => void;\n        resolveError: (v: string | undefined) => void;\n      }\n    >();\n\n    function createToolCallEntry(\n      callId: string,\n      name: string,\n      rawInput: unknown\n    ): void {\n      if (pendingCalls.has(callId)) return;\n      const input =\n        typeof rawInput === \"string\" ? JSON.parse(rawInput) : rawInput;\n\n      let resolveOutput!: (v: unknown) => void;\n      let rejectOutput!: (e: unknown) => void;\n      let resolveStatus!: (v: ToolCallStatus) => void;\n      let resolveError!: (v: string | undefined) => void;\n\n      const output = new Promise<unknown>((res, rej) => {\n        resolveOutput = res;\n        rejectOutput = rej;\n      });\n      const status = new Promise<ToolCallStatus>((res) => {\n        resolveStatus = res;\n      });\n      const error = new Promise<string | undefined>((res) => {\n        resolveError = res;\n      });\n\n      pendingCalls.set(callId, {\n        resolveOutput,\n        rejectOutput,\n        resolveStatus,\n        resolveError,\n      });\n\n      toolCallsLog.push({\n        name,\n        callId,\n        input,\n        output,\n        status,\n        error,\n      } as ToolCallStream);\n    }\n\n    return {\n      __native: true as const,\n\n      init: () => ({\n        toolCalls: toolCallsLog,\n      }),\n\n      process(event: ProtocolEvent): boolean {\n        /**\n         * Only process events that are at the same depth as the agent's graph.\n         */\n        if (!isOwnEvent(event.params.namespace, path)) return true;\n\n        if (event.method === \"messages\") {\n          const data = event.params.data as Record<string, unknown>;\n          if (data.event === \"content-block-finish\") {\n            const cb = (data.contentBlock ?? data.content_block) as\n              | Record<string, unknown>\n              | undefined;\n            if (cb?.type === \"tool_call\") {\n              createToolCallEntry(\n                String(cb.id ?? \"\"),\n                String(cb.name ?? \"\"),\n                cb.args ?? cb.input\n              );\n            }\n          }\n        }\n\n        if (event.method === \"tools\") {\n          const data = event.params.data as ToolsEventData;\n          const toolCallId = (data as Record<string, unknown>)\n            .tool_call_id as string;\n\n          if (data.event === \"tool-started\") {\n            createToolCallEntry(\n              toolCallId,\n              ((data as Record<string, unknown>).tool_name as string) ??\n                \"unknown\",\n              (data as Record<string, unknown>).input\n            );\n          }\n\n          const pending = toolCallId ? pendingCalls.get(toolCallId) : undefined;\n\n          if (pending) {\n            if (data.event === \"tool-finished\") {\n              pending.resolveOutput(\n                normalizeToolOutput((data as Record<string, unknown>).output)\n              );\n              pending.resolveStatus(\"finished\");\n              pending.resolveError(undefined);\n              pendingCalls.delete(toolCallId);\n            } else if (data.event === \"tool-error\") {\n              const message =\n                ((data as Record<string, unknown>).message as string) ??\n                \"unknown error\";\n              // An interrupt raised inside a tool (HITL middleware *or* a\n              // raw `interrupt()`) surfaces here as a `tool-error` whose\n              // message is the serialized interrupt. It is control flow,\n              // not a failure: keep the call pending (it re-runs on resume)\n              // and never reject `output`, which would otherwise become an\n              // unhandled rejection and crash the run.\n              if (isToolInterrupt(message)) {\n                return true;\n              }\n              pending.rejectOutput(new Error(message));\n              pending.resolveStatus(\"error\");\n              pending.resolveError(message);\n              pendingCalls.delete(toolCallId);\n            }\n          }\n        }\n\n        return true;\n      },\n\n      finalize(): void {\n        for (const pending of pendingCalls.values()) {\n          pending.resolveStatus(\"finished\");\n          pending.resolveError(undefined);\n          pending.resolveOutput(undefined);\n        }\n        pendingCalls.clear();\n        toolCallsLog.close();\n      },\n\n      fail(err: unknown): void {\n        for (const pending of pendingCalls.values()) {\n          pending.resolveStatus(\"error\");\n          pending.resolveError(\n            err instanceof Error ? err.message : String(err)\n          );\n          pending.rejectOutput(err);\n        }\n        pendingCalls.clear();\n        toolCallsLog.fail(err);\n      },\n    };\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"tool-call.cjs","names":["ToolMessage","StreamChannel"],"sources":["../../../src/agents/transformers/tool-call.ts"],"sourcesContent":["import {\n  StreamChannel,\n  type NativeStreamTransformer,\n  type ProtocolEvent,\n  type ToolCallStream,\n  type ToolCallStatus,\n  type ToolsEventData,\n  type Namespace,\n} from \"@langchain/langgraph\";\nimport { ToolMessage } from \"@langchain/core/messages\";\n\ninterface ToolCallProjection {\n  toolCalls: AsyncIterable<ToolCallStream>;\n}\n\n/**\n * Returns true when `ns` belongs to the agent's own graph — i.e. it\n * starts with `path` and is at most one level deeper (the agent's\n * internal nodes like `tools`, `model_request`, etc.).\n *\n * Events from subagent subgraphs (two or more levels deeper) are\n * excluded, so `run.toolCalls` / `run.middleware` only show events\n * from the agent itself, not from its subagents.\n */\nfunction isOwnEvent(ns: Namespace, path: Namespace): boolean {\n  if (ns.length < path.length || ns.length > path.length + 1) return false;\n  for (let i = 0; i < path.length; i += 1) {\n    if (ns[i] !== path[i]) return false;\n  }\n  return true;\n}\n\n/**\n * Detects when a `tool-error` payload is actually a graph interrupt rather\n * than a genuine tool failure.\n *\n * A tool that calls `interrupt()` throws a `GraphInterrupt`, whose message is\n * the JSON-serialized `Interrupt[]` array. Each entry has the LangGraph\n * `Interrupt` shape `{ id, value }`: a stable `id` (a hash of the checkpoint\n * namespace, generated by `interrupt()` and always present during graph\n * execution) plus the `value` passed to `interrupt(...)`. We require BOTH a\n * string `id` and a `value` on every entry — a bare `value` is not a reliable\n * discriminator, since a genuine tool error message can also be a JSON array\n * of `{ value }` records (e.g. a validator emitting\n * `[{ \"value\": \"bad input\", \"message\": \"invalid\" }]`). Keying off the\n * interrupt `id` keeps real tool failures on the error path.\n *\n * An interrupt is control flow that *suspends* the run (the tool re-runs on\n * resume); it is not an error, so the tool call must stay pending rather than\n * have its `output` promise rejected. Any interrupt qualifies regardless of\n * its `value` shape: HITL middleware interrupts (`value.type === \"tool\"`) and\n * raw `interrupt(...)` calls from inside a tool are treated identically —\n * raising an interrupt in a tool must work whether or not\n * `humanInTheLoopMiddleware` is involved.\n */\nfunction isToolInterrupt(message: string): boolean {\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(message);\n  } catch {\n    return false;\n  }\n  if (!Array.isArray(parsed) || parsed.length === 0) return false;\n  return parsed.every((entry) => {\n    if (entry == null || typeof entry !== \"object\") return false;\n    const record = entry as Record<string, unknown>;\n    return typeof record.id === \"string\" && \"value\" in record;\n  });\n}\n\n/**\n * Detects serialized LangChain `ToolMessage` values that can appear on\n * `tool-finished.output` after crossing a protocol or serialization boundary.\n *\n * @example\n * ```ts\n * {\n *   lc: 1,\n *   type: \"constructor\",\n *   id: [\"langchain_core\", \"messages\", \"ToolMessage\"],\n *   kwargs: { content: \"raw tool result\", tool_call_id: \"call_1\" }\n * }\n * ```\n */\nfunction isSerializedToolMessage(\n  value: unknown\n): value is { kwargs?: { content?: unknown } } {\n  if (value == null || typeof value !== \"object\") return false;\n  const record = value as Record<string, unknown>;\n  if (record.type !== \"constructor\" || !Array.isArray(record.id)) return false;\n  return record.id[record.id.length - 1] === \"ToolMessage\";\n}\n\nfunction normalizeToolOutput(output: unknown): unknown {\n  if (ToolMessage.isInstance(output)) {\n    return output.content;\n  }\n  if (isSerializedToolMessage(output)) {\n    return output.kwargs?.content;\n  }\n  return output;\n}\n\n/**\n * Creates a native transformer that correlates `tools` channel events\n * into per-call {@link ToolCallStream} objects.\n *\n * Marked `__native: true` — projection keys land directly on the\n * `GraphRunStream` instance as `run.toolCalls`.\n */\nexport function createToolCallTransformer(\n  path: Namespace\n): () => NativeStreamTransformer<ToolCallProjection> {\n  return () => {\n    const toolCallsLog = StreamChannel.local<ToolCallStream>();\n\n    const pendingCalls = new Map<\n      string,\n      {\n        resolveOutput: (v: unknown) => void;\n        rejectOutput: (e: unknown) => void;\n        resolveStatus: (v: ToolCallStatus) => void;\n        resolveError: (v: string | undefined) => void;\n      }\n    >();\n\n    function createToolCallEntry(\n      callId: string,\n      name: string,\n      rawInput: unknown\n    ): void {\n      if (pendingCalls.has(callId)) return;\n      const input =\n        typeof rawInput === \"string\" ? JSON.parse(rawInput) : rawInput;\n\n      let resolveOutput!: (v: unknown) => void;\n      let rejectOutput!: (e: unknown) => void;\n      let resolveStatus!: (v: ToolCallStatus) => void;\n      let resolveError!: (v: string | undefined) => void;\n\n      const output = new Promise<unknown>((res, rej) => {\n        resolveOutput = res;\n        rejectOutput = rej;\n      });\n      const status = new Promise<ToolCallStatus>((res) => {\n        resolveStatus = res;\n      });\n      const error = new Promise<string | undefined>((res) => {\n        resolveError = res;\n      });\n\n      pendingCalls.set(callId, {\n        resolveOutput,\n        rejectOutput,\n        resolveStatus,\n        resolveError,\n      });\n\n      toolCallsLog.push({\n        name,\n        callId,\n        input,\n        output,\n        status,\n        error,\n      } as ToolCallStream);\n    }\n\n    return {\n      __native: true as const,\n\n      init: () => ({\n        toolCalls: toolCallsLog,\n      }),\n\n      process(event: ProtocolEvent): boolean {\n        /**\n         * Only process events that are at the same depth as the agent's graph.\n         */\n        if (!isOwnEvent(event.params.namespace, path)) return true;\n\n        if (event.method === \"messages\") {\n          const data = event.params.data as Record<string, unknown>;\n          if (data.event === \"content-block-finish\") {\n            const cb = (data.contentBlock ?? data.content_block) as\n              | Record<string, unknown>\n              | undefined;\n            if (cb?.type === \"tool_call\") {\n              createToolCallEntry(\n                String(cb.id ?? \"\"),\n                String(cb.name ?? \"\"),\n                cb.args ?? cb.input\n              );\n            }\n          }\n        }\n\n        if (event.method === \"tools\") {\n          const data = event.params.data as ToolsEventData;\n          const toolCallId = (data as Record<string, unknown>)\n            .tool_call_id as string;\n\n          if (data.event === \"tool-started\") {\n            createToolCallEntry(\n              toolCallId,\n              ((data as Record<string, unknown>).tool_name as string) ??\n                \"unknown\",\n              (data as Record<string, unknown>).input\n            );\n          }\n\n          const pending = toolCallId ? pendingCalls.get(toolCallId) : undefined;\n\n          if (pending) {\n            if (data.event === \"tool-finished\") {\n              pending.resolveOutput(\n                normalizeToolOutput((data as Record<string, unknown>).output)\n              );\n              pending.resolveStatus(\"finished\");\n              pending.resolveError(undefined);\n              pendingCalls.delete(toolCallId);\n            } else if (data.event === \"tool-error\") {\n              const message =\n                ((data as Record<string, unknown>).message as string) ??\n                \"unknown error\";\n              // An interrupt raised inside a tool (HITL middleware *or* a\n              // raw `interrupt()`) surfaces here as a `tool-error` whose\n              // message is the serialized interrupt. It is control flow,\n              // not a failure: keep the call pending (it re-runs on resume)\n              // and never reject `output`, which would otherwise become an\n              // unhandled rejection and crash the run.\n              if (isToolInterrupt(message)) {\n                return true;\n              }\n              pending.rejectOutput(new Error(message));\n              pending.resolveStatus(\"error\");\n              pending.resolveError(message);\n              pendingCalls.delete(toolCallId);\n            }\n          }\n        }\n\n        return true;\n      },\n\n      finalize(): void {\n        for (const pending of pendingCalls.values()) {\n          pending.resolveStatus(\"finished\");\n          pending.resolveError(undefined);\n          pending.resolveOutput(undefined);\n        }\n        pendingCalls.clear();\n        toolCallsLog.close();\n      },\n\n      fail(err: unknown): void {\n        for (const pending of pendingCalls.values()) {\n          pending.resolveStatus(\"error\");\n          pending.resolveError(\n            err instanceof Error ? err.message : String(err)\n          );\n          pending.rejectOutput(err);\n        }\n        pendingCalls.clear();\n        toolCallsLog.fail(err);\n      },\n    };\n  };\n}\n"],"mappings":"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"}

package/dist/agents/transformers/tool-call.d.cts

@@ -1,5 +1,4 @@
 import { Namespace, NativeStreamTransformer, ToolCallStream } from "@langchain/langgraph";
-
 //#region src/agents/transformers/tool-call.d.ts
 interface ToolCallProjection {
   toolCalls: AsyncIterable<ToolCallStream>;

package/dist/agents/transformers/tool-call.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-call.d.cts","names":[],"sources":["../../../src/agents/transformers/tool-call.ts"],"mappings":";;;UAWU,kBAAA;EACR,SAAA,EAAW,aAAA,CAAc,cAAA;AAAA;;;;;;;;iBAkGX,yBAAA,CACd,IAAA,EAAM,SAAA,SACC,uBAAA,CAAwB,kBAAA"}
+{"version":3,"file":"tool-call.d.cts","names":[],"sources":["../../../src/agents/transformers/tool-call.ts"],"mappings":";;UAWU;EACR,WAAW,cAAc;;;;;;;;;iBAkGX,0BACd,MAAM,kBACC,wBAAwB"}

package/dist/agents/transformers/tool-call.d.ts

@@ -1,5 +1,4 @@
 import { Namespace, NativeStreamTransformer, ToolCallStream } from "@langchain/langgraph";
-
 //#region src/agents/transformers/tool-call.d.ts
 interface ToolCallProjection {
   toolCalls: AsyncIterable<ToolCallStream>;

package/dist/agents/transformers/tool-call.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-call.d.ts","names":[],"sources":["../../../src/agents/transformers/tool-call.ts"],"mappings":";;;UAWU,kBAAA;EACR,SAAA,EAAW,aAAA,CAAc,cAAA;AAAA;;;;;;;;iBAkGX,yBAAA,CACd,IAAA,EAAM,SAAA,SACC,uBAAA,CAAwB,kBAAA"}
+{"version":3,"file":"tool-call.d.ts","names":[],"sources":["../../../src/agents/transformers/tool-call.ts"],"mappings":";;UAWU;EACR,WAAW,cAAc;;;;;;;;;iBAkGX,0BACd,MAAM,kBACC,wBAAwB"}

package/dist/agents/transformers/tool-call.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool-call.js","names":[],"sources":["../../../src/agents/transformers/tool-call.ts"],"sourcesContent":["import {\n  StreamChannel,\n  type NativeStreamTransformer,\n  type ProtocolEvent,\n  type ToolCallStream,\n  type ToolCallStatus,\n  type ToolsEventData,\n  type Namespace,\n} from \"@langchain/langgraph\";\nimport { ToolMessage } from \"@langchain/core/messages\";\n\ninterface ToolCallProjection {\n  toolCalls: AsyncIterable<ToolCallStream>;\n}\n\n/**\n * Returns true when `ns` belongs to the agent's own graph — i.e. it\n * starts with `path` and is at most one level deeper (the agent's\n * internal nodes like `tools`, `model_request`, etc.).\n *\n * Events from subagent subgraphs (two or more levels deeper) are\n * excluded, so `run.toolCalls` / `run.middleware` only show events\n * from the agent itself, not from its subagents.\n */\nfunction isOwnEvent(ns: Namespace, path: Namespace): boolean {\n  if (ns.length < path.length || ns.length > path.length + 1) return false;\n  for (let i = 0; i < path.length; i += 1) {\n    if (ns[i] !== path[i]) return false;\n  }\n  return true;\n}\n\n/**\n * Detects when a `tool-error` payload is actually a graph interrupt rather\n * than a genuine tool failure.\n *\n * A tool that calls `interrupt()` throws a `GraphInterrupt`, whose message is\n * the JSON-serialized `Interrupt[]` array. Each entry has the LangGraph\n * `Interrupt` shape `{ id, value }`: a stable `id` (a hash of the checkpoint\n * namespace, generated by `interrupt()` and always present during graph\n * execution) plus the `value` passed to `interrupt(...)`. We require BOTH a\n * string `id` and a `value` on every entry — a bare `value` is not a reliable\n * discriminator, since a genuine tool error message can also be a JSON array\n * of `{ value }` records (e.g. a validator emitting\n * `[{ \"value\": \"bad input\", \"message\": \"invalid\" }]`). Keying off the\n * interrupt `id` keeps real tool failures on the error path.\n *\n * An interrupt is control flow that *suspends* the run (the tool re-runs on\n * resume); it is not an error, so the tool call must stay pending rather than\n * have its `output` promise rejected. Any interrupt qualifies regardless of\n * its `value` shape: HITL middleware interrupts (`value.type === \"tool\"`) and\n * raw `interrupt(...)` calls from inside a tool are treated identically —\n * raising an interrupt in a tool must work whether or not\n * `humanInTheLoopMiddleware` is involved.\n */\nfunction isToolInterrupt(message: string): boolean {\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(message);\n  } catch {\n    return false;\n  }\n  if (!Array.isArray(parsed) || parsed.length === 0) return false;\n  return parsed.every((entry) => {\n    if (entry == null || typeof entry !== \"object\") return false;\n    const record = entry as Record<string, unknown>;\n    return typeof record.id === \"string\" && \"value\" in record;\n  });\n}\n\n/**\n * Detects serialized LangChain `ToolMessage` values that can appear on\n * `tool-finished.output` after crossing a protocol or serialization boundary.\n *\n * @example\n * ```ts\n * {\n *   lc: 1,\n *   type: \"constructor\",\n *   id: [\"langchain_core\", \"messages\", \"ToolMessage\"],\n *   kwargs: { content: \"raw tool result\", tool_call_id: \"call_1\" }\n * }\n * ```\n */\nfunction isSerializedToolMessage(\n  value: unknown\n): value is { kwargs?: { content?: unknown } } {\n  if (value == null || typeof value !== \"object\") return false;\n  const record = value as Record<string, unknown>;\n  if (record.type !== \"constructor\" || !Array.isArray(record.id)) return false;\n  return record.id[record.id.length - 1] === \"ToolMessage\";\n}\n\nfunction normalizeToolOutput(output: unknown): unknown {\n  if (ToolMessage.isInstance(output)) {\n    return output.content;\n  }\n  if (isSerializedToolMessage(output)) {\n    return output.kwargs?.content;\n  }\n  return output;\n}\n\n/**\n * Creates a native transformer that correlates `tools` channel events\n * into per-call {@link ToolCallStream} objects.\n *\n * Marked `__native: true` — projection keys land directly on the\n * `GraphRunStream` instance as `run.toolCalls`.\n */\nexport function createToolCallTransformer(\n  path: Namespace\n): () => NativeStreamTransformer<ToolCallProjection> {\n  return () => {\n    const toolCallsLog = StreamChannel.local<ToolCallStream>();\n\n    const pendingCalls = new Map<\n      string,\n      {\n        resolveOutput: (v: unknown) => void;\n        rejectOutput: (e: unknown) => void;\n        resolveStatus: (v: ToolCallStatus) => void;\n        resolveError: (v: string | undefined) => void;\n      }\n    >();\n\n    function createToolCallEntry(\n      callId: string,\n      name: string,\n      rawInput: unknown\n    ): void {\n      if (pendingCalls.has(callId)) return;\n      const input =\n        typeof rawInput === \"string\" ? JSON.parse(rawInput) : rawInput;\n\n      let resolveOutput!: (v: unknown) => void;\n      let rejectOutput!: (e: unknown) => void;\n      let resolveStatus!: (v: ToolCallStatus) => void;\n      let resolveError!: (v: string | undefined) => void;\n\n      const output = new Promise<unknown>((res, rej) => {\n        resolveOutput = res;\n        rejectOutput = rej;\n      });\n      const status = new Promise<ToolCallStatus>((res) => {\n        resolveStatus = res;\n      });\n      const error = new Promise<string | undefined>((res) => {\n        resolveError = res;\n      });\n\n      pendingCalls.set(callId, {\n        resolveOutput,\n        rejectOutput,\n        resolveStatus,\n        resolveError,\n      });\n\n      toolCallsLog.push({\n        name,\n        callId,\n        input,\n        output,\n        status,\n        error,\n      } as ToolCallStream);\n    }\n\n    return {\n      __native: true as const,\n\n      init: () => ({\n        toolCalls: toolCallsLog,\n      }),\n\n      process(event: ProtocolEvent): boolean {\n        /**\n         * Only process events that are at the same depth as the agent's graph.\n         */\n        if (!isOwnEvent(event.params.namespace, path)) return true;\n\n        if (event.method === \"messages\") {\n          const data = event.params.data as Record<string, unknown>;\n          if (data.event === \"content-block-finish\") {\n            const cb = (data.contentBlock ?? data.content_block) as\n              | Record<string, unknown>\n              | undefined;\n            if (cb?.type === \"tool_call\") {\n              createToolCallEntry(\n                String(cb.id ?? \"\"),\n                String(cb.name ?? \"\"),\n                cb.args ?? cb.input\n              );\n            }\n          }\n        }\n\n        if (event.method === \"tools\") {\n          const data = event.params.data as ToolsEventData;\n          const toolCallId = (data as Record<string, unknown>)\n            .tool_call_id as string;\n\n          if (data.event === \"tool-started\") {\n            createToolCallEntry(\n              toolCallId,\n              ((data as Record<string, unknown>).tool_name as string) ??\n                \"unknown\",\n              (data as Record<string, unknown>).input\n            );\n          }\n\n          const pending = toolCallId ? pendingCalls.get(toolCallId) : undefined;\n\n          if (pending) {\n            if (data.event === \"tool-finished\") {\n              pending.resolveOutput(\n                normalizeToolOutput((data as Record<string, unknown>).output)\n              );\n              pending.resolveStatus(\"finished\");\n              pending.resolveError(undefined);\n              pendingCalls.delete(toolCallId);\n            } else if (data.event === \"tool-error\") {\n              const message =\n                ((data as Record<string, unknown>).message as string) ??\n                \"unknown error\";\n              // An interrupt raised inside a tool (HITL middleware *or* a\n              // raw `interrupt()`) surfaces here as a `tool-error` whose\n              // message is the serialized interrupt. It is control flow,\n              // not a failure: keep the call pending (it re-runs on resume)\n              // and never reject `output`, which would otherwise become an\n              // unhandled rejection and crash the run.\n              if (isToolInterrupt(message)) {\n                return true;\n              }\n              pending.rejectOutput(new Error(message));\n              pending.resolveStatus(\"error\");\n              pending.resolveError(message);\n              pendingCalls.delete(toolCallId);\n            }\n          }\n        }\n\n        return true;\n      },\n\n      finalize(): void {\n        for (const pending of pendingCalls.values()) {\n          pending.resolveStatus(\"finished\");\n          pending.resolveError(undefined);\n          pending.resolveOutput(undefined);\n        }\n        pendingCalls.clear();\n        toolCallsLog.close();\n      },\n\n      fail(err: unknown): void {\n        for (const pending of pendingCalls.values()) {\n          pending.resolveStatus(\"error\");\n          pending.resolveError(\n            err instanceof Error ? err.message : String(err)\n          );\n          pending.rejectOutput(err);\n        }\n        pendingCalls.clear();\n        toolCallsLog.fail(err);\n      },\n    };\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"tool-call.js","names":[],"sources":["../../../src/agents/transformers/tool-call.ts"],"sourcesContent":["import {\n  StreamChannel,\n  type NativeStreamTransformer,\n  type ProtocolEvent,\n  type ToolCallStream,\n  type ToolCallStatus,\n  type ToolsEventData,\n  type Namespace,\n} from \"@langchain/langgraph\";\nimport { ToolMessage } from \"@langchain/core/messages\";\n\ninterface ToolCallProjection {\n  toolCalls: AsyncIterable<ToolCallStream>;\n}\n\n/**\n * Returns true when `ns` belongs to the agent's own graph — i.e. it\n * starts with `path` and is at most one level deeper (the agent's\n * internal nodes like `tools`, `model_request`, etc.).\n *\n * Events from subagent subgraphs (two or more levels deeper) are\n * excluded, so `run.toolCalls` / `run.middleware` only show events\n * from the agent itself, not from its subagents.\n */\nfunction isOwnEvent(ns: Namespace, path: Namespace): boolean {\n  if (ns.length < path.length || ns.length > path.length + 1) return false;\n  for (let i = 0; i < path.length; i += 1) {\n    if (ns[i] !== path[i]) return false;\n  }\n  return true;\n}\n\n/**\n * Detects when a `tool-error` payload is actually a graph interrupt rather\n * than a genuine tool failure.\n *\n * A tool that calls `interrupt()` throws a `GraphInterrupt`, whose message is\n * the JSON-serialized `Interrupt[]` array. Each entry has the LangGraph\n * `Interrupt` shape `{ id, value }`: a stable `id` (a hash of the checkpoint\n * namespace, generated by `interrupt()` and always present during graph\n * execution) plus the `value` passed to `interrupt(...)`. We require BOTH a\n * string `id` and a `value` on every entry — a bare `value` is not a reliable\n * discriminator, since a genuine tool error message can also be a JSON array\n * of `{ value }` records (e.g. a validator emitting\n * `[{ \"value\": \"bad input\", \"message\": \"invalid\" }]`). Keying off the\n * interrupt `id` keeps real tool failures on the error path.\n *\n * An interrupt is control flow that *suspends* the run (the tool re-runs on\n * resume); it is not an error, so the tool call must stay pending rather than\n * have its `output` promise rejected. Any interrupt qualifies regardless of\n * its `value` shape: HITL middleware interrupts (`value.type === \"tool\"`) and\n * raw `interrupt(...)` calls from inside a tool are treated identically —\n * raising an interrupt in a tool must work whether or not\n * `humanInTheLoopMiddleware` is involved.\n */\nfunction isToolInterrupt(message: string): boolean {\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(message);\n  } catch {\n    return false;\n  }\n  if (!Array.isArray(parsed) || parsed.length === 0) return false;\n  return parsed.every((entry) => {\n    if (entry == null || typeof entry !== \"object\") return false;\n    const record = entry as Record<string, unknown>;\n    return typeof record.id === \"string\" && \"value\" in record;\n  });\n}\n\n/**\n * Detects serialized LangChain `ToolMessage` values that can appear on\n * `tool-finished.output` after crossing a protocol or serialization boundary.\n *\n * @example\n * ```ts\n * {\n *   lc: 1,\n *   type: \"constructor\",\n *   id: [\"langchain_core\", \"messages\", \"ToolMessage\"],\n *   kwargs: { content: \"raw tool result\", tool_call_id: \"call_1\" }\n * }\n * ```\n */\nfunction isSerializedToolMessage(\n  value: unknown\n): value is { kwargs?: { content?: unknown } } {\n  if (value == null || typeof value !== \"object\") return false;\n  const record = value as Record<string, unknown>;\n  if (record.type !== \"constructor\" || !Array.isArray(record.id)) return false;\n  return record.id[record.id.length - 1] === \"ToolMessage\";\n}\n\nfunction normalizeToolOutput(output: unknown): unknown {\n  if (ToolMessage.isInstance(output)) {\n    return output.content;\n  }\n  if (isSerializedToolMessage(output)) {\n    return output.kwargs?.content;\n  }\n  return output;\n}\n\n/**\n * Creates a native transformer that correlates `tools` channel events\n * into per-call {@link ToolCallStream} objects.\n *\n * Marked `__native: true` — projection keys land directly on the\n * `GraphRunStream` instance as `run.toolCalls`.\n */\nexport function createToolCallTransformer(\n  path: Namespace\n): () => NativeStreamTransformer<ToolCallProjection> {\n  return () => {\n    const toolCallsLog = StreamChannel.local<ToolCallStream>();\n\n    const pendingCalls = new Map<\n      string,\n      {\n        resolveOutput: (v: unknown) => void;\n        rejectOutput: (e: unknown) => void;\n        resolveStatus: (v: ToolCallStatus) => void;\n        resolveError: (v: string | undefined) => void;\n      }\n    >();\n\n    function createToolCallEntry(\n      callId: string,\n      name: string,\n      rawInput: unknown\n    ): void {\n      if (pendingCalls.has(callId)) return;\n      const input =\n        typeof rawInput === \"string\" ? JSON.parse(rawInput) : rawInput;\n\n      let resolveOutput!: (v: unknown) => void;\n      let rejectOutput!: (e: unknown) => void;\n      let resolveStatus!: (v: ToolCallStatus) => void;\n      let resolveError!: (v: string | undefined) => void;\n\n      const output = new Promise<unknown>((res, rej) => {\n        resolveOutput = res;\n        rejectOutput = rej;\n      });\n      const status = new Promise<ToolCallStatus>((res) => {\n        resolveStatus = res;\n      });\n      const error = new Promise<string | undefined>((res) => {\n        resolveError = res;\n      });\n\n      pendingCalls.set(callId, {\n        resolveOutput,\n        rejectOutput,\n        resolveStatus,\n        resolveError,\n      });\n\n      toolCallsLog.push({\n        name,\n        callId,\n        input,\n        output,\n        status,\n        error,\n      } as ToolCallStream);\n    }\n\n    return {\n      __native: true as const,\n\n      init: () => ({\n        toolCalls: toolCallsLog,\n      }),\n\n      process(event: ProtocolEvent): boolean {\n        /**\n         * Only process events that are at the same depth as the agent's graph.\n         */\n        if (!isOwnEvent(event.params.namespace, path)) return true;\n\n        if (event.method === \"messages\") {\n          const data = event.params.data as Record<string, unknown>;\n          if (data.event === \"content-block-finish\") {\n            const cb = (data.contentBlock ?? data.content_block) as\n              | Record<string, unknown>\n              | undefined;\n            if (cb?.type === \"tool_call\") {\n              createToolCallEntry(\n                String(cb.id ?? \"\"),\n                String(cb.name ?? \"\"),\n                cb.args ?? cb.input\n              );\n            }\n          }\n        }\n\n        if (event.method === \"tools\") {\n          const data = event.params.data as ToolsEventData;\n          const toolCallId = (data as Record<string, unknown>)\n            .tool_call_id as string;\n\n          if (data.event === \"tool-started\") {\n            createToolCallEntry(\n              toolCallId,\n              ((data as Record<string, unknown>).tool_name as string) ??\n                \"unknown\",\n              (data as Record<string, unknown>).input\n            );\n          }\n\n          const pending = toolCallId ? pendingCalls.get(toolCallId) : undefined;\n\n          if (pending) {\n            if (data.event === \"tool-finished\") {\n              pending.resolveOutput(\n                normalizeToolOutput((data as Record<string, unknown>).output)\n              );\n              pending.resolveStatus(\"finished\");\n              pending.resolveError(undefined);\n              pendingCalls.delete(toolCallId);\n            } else if (data.event === \"tool-error\") {\n              const message =\n                ((data as Record<string, unknown>).message as string) ??\n                \"unknown error\";\n              // An interrupt raised inside a tool (HITL middleware *or* a\n              // raw `interrupt()`) surfaces here as a `tool-error` whose\n              // message is the serialized interrupt. It is control flow,\n              // not a failure: keep the call pending (it re-runs on resume)\n              // and never reject `output`, which would otherwise become an\n              // unhandled rejection and crash the run.\n              if (isToolInterrupt(message)) {\n                return true;\n              }\n              pending.rejectOutput(new Error(message));\n              pending.resolveStatus(\"error\");\n              pending.resolveError(message);\n              pendingCalls.delete(toolCallId);\n            }\n          }\n        }\n\n        return true;\n      },\n\n      finalize(): void {\n        for (const pending of pendingCalls.values()) {\n          pending.resolveStatus(\"finished\");\n          pending.resolveError(undefined);\n          pending.resolveOutput(undefined);\n        }\n        pendingCalls.clear();\n        toolCallsLog.close();\n      },\n\n      fail(err: unknown): void {\n        for (const pending of pendingCalls.values()) {\n          pending.resolveStatus(\"error\");\n          pending.resolveError(\n            err instanceof Error ? err.message : String(err)\n          );\n          pending.rejectOutput(err);\n        }\n        pendingCalls.clear();\n        toolCallsLog.fail(err);\n      },\n    };\n  };\n}\n"],"mappings":"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"}

package/dist/agents/transformers/types.d.cts

@@ -1,6 +1,5 @@
 import { ClientTool, DynamicStructuredTool, ServerTool, StructuredToolInterface } from "@langchain/core/tools";
 import { ChatModelStream, GraphRunStream, LifecycleCause, StreamTransformer, ToolCallStream } from "@langchain/langgraph";
-
 //#region src/agents/transformers/types.d.ts
 /**
  * Infers the merged extensions shape from a tuple of stream transformer
@@ -26,7 +25,7 @@ type ToolOutputOf<T> = T extends DynamicStructuredTool<any, any, any, infer Tool
  * Falls back to `ToolCallStream` (untyped) when the tools tuple is a
  * plain `(ClientTool | ServerTool)[]` without literal name types.
  */
-type ToolCallStreamUnion<TTools extends readonly (ClientTool | ServerTool)[]> = { [K in keyof TTools]: ToolCallStream<ToolNameOf<TTools[K]>, ToolInputOf<TTools[K]>, ToolOutputOf<TTools[K]>> }[number];
+type ToolCallStreamUnion<TTools extends readonly (ClientTool | ServerTool)[]> = { [K in keyof TTools]: ToolCallStream<ToolNameOf<TTools[K]>, ToolInputOf<TTools[K]>, ToolOutputOf<TTools[K]>>; }[number];
 /**
  * A nested named-agent execution surfaced on `run.subagents`.
  *
@@ -79,7 +78,8 @@ interface SubagentRunStream<TValues = Record<string, unknown>, TTools extends re
  *   `InferStreamExtensions<TStreamTransformers>`.
  */
 type AgentRunStream<TValues = Record<string, unknown>, TTools extends readonly (ClientTool | ServerTool)[] = readonly (ClientTool | ServerTool)[], TExtensions extends Record<string, unknown> = Record<string, unknown>> = GraphRunStream<TValues, TExtensions> & {
-  /** Tool call streams from the native ToolCallTransformer. */toolCalls: AsyncIterable<ToolCallStreamUnion<TTools>>;
+  /** Tool call streams from the native ToolCallTransformer. */
+  toolCalls: AsyncIterable<ToolCallStreamUnion<TTools>>;
   /**
    * Named subagent runs dispatched from tools, surfaced by the native
    * {@link createSubagentTransformer}.  Each yielded {@link SubagentRunStream}

package/dist/agents/transformers/types.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.cts","names":[],"sources":["../../../src/agents/transformers/types.ts"],"mappings":";;;;;;AAuBA;;;;;KAAY,qBAAA,WACA,aAAA,OAAoB,iBAAA,UAC5B,CAAA,uBACA,MAAA,kBACA,CAAA,yBACU,iBAAA,iCACgB,aAAA,OAAoB,iBAAA,UAE5C,CAAA,GAAI,qBAAA,CAAsB,IAAA,IAC1B,MAAA;;KAGD,UAAA,MAAgB,CAAA;EAAY,IAAA;AAAA,IAAiC,CAAA;;KAG7D,WAAA,MACH,CAAA,SAAU,qBAAA,gDACN,YAAA,GACA,CAAA,SAAU,uBAAA,iCACR,YAAA;;KAIH,YAAA,MACH,CAAA,SAAU,qBAAA,+CACN,WAAA,GACA,CAAA,SAAU,uBAAA,gCACR,WAAA;;;;;;;;;KAWI,mBAAA,0BACe,UAAA,GAAa,UAAA,qBAE1B,MAAA,GAAS,cAAA,CACnB,UAAA,CAAW,MAAA,CAAO,CAAA,IAClB,WAAA,CAAY,MAAA,CAAO,CAAA,IACnB,YAAA,CAAa,MAAA,CAAO,CAAA;;;;;;;AAnCM;;;;;;;;;;;UAwDb,iBAAA,WACL,MAAA,4CACe,UAAA,GAAa,UAAA,gBAClC,UAAA,GACA,UAAA;EAtDU;EAAA,SA0DL,IAAA;EAzDT;;;;;EAAA,SAgES,KAAA,EAAO,cAAA;EAjED;EAAA,SAoEN,MAAA,EAAQ,OAAA,CAAQ,OAAA;EAnEf;EAAA,SAsED,QAAA,EAAU,aAAA,CAAc,IAAA,CAAK,eAAA;EArElC;EAAA,SAwEK,SAAA,EAAW,aAAA,CAAc,mBAAA,CAAoB,MAAA;EAvExC;EAAA,SA0EL,SAAA,EAAW,aAAA,CAAc,iBAAA;AAAA;;;AAzEhB;;;;;;;;;;;;;;KA4FR,cAAA,WACA,MAAA,4CACe,UAAA,GAAa,UAAA,gBAClC,UAAA,GACA,UAAA,yBAEgB,MAAA,oBAA0B,MAAA,qBAC5C,cAAA,CAAe,OAAA,EAAS,WAAA;EA5FZ,6DA8Fd,SAAA,EAAW,aAAA,CAAc,mBAAA,CAAoB,MAAA;EA7FvC;;;AAWR;;;;;EA4FE,SAAA,EAAW,aAAA,CAAc,iBAAA,CAAkB,OAAA;AAAA"}
+{"version":3,"file":"types.d.cts","names":[],"sources":["../../../src/agents/transformers/types.ts"],"mappings":";;;;;;;;;;KAuBY,sBACV,UAAU,oBAAoB,2BAC5B,wBACA,wBACA,0BACU,wBAAwB,aACrB,aAAa,oBAAoB,2BAE5C,IAAI,sBAAsB,QAC1B;;KAGD,WAAW,KAAK;EAAY,YAAY;IAAqB;;KAG7D,YAAY,KACf,UAAU,sCAAsC,+BAC5C,eACA,UAAU,mCAAmC,qBAC3C;;KAIH,aAAa,KAChB,UAAU,2CAA2C,yBACjD,cACA,UAAU,wCAAwC,eAChD;;;;;;;;;KAWI,oBACV,yBAAyB,aAAa,oBAErC,WAAW,SAAS,eACnB,WAAW,OAAO,KAClB,YAAY,OAAO,KACnB,aAAa,OAAO;;;;;;;;;;;;;;;;;;UAqBP,kBACf,UAAU,yBACV,yBAAyB,aAAa,0BAClC,aACA;;WAIK;;;;;;WAOA,OAAO;;WAGP,QAAQ,QAAQ;;WAGhB,UAAU,cAAc,KAAK;;WAG7B,WAAW,cAAc,oBAAoB;;WAG7C,WAAW,cAAc;;;;;;;;;;;;;;;;;;KAmBxB,eACV,UAAU,yBACV,yBAAyB,aAAa,0BAClC,aACA,eAEJ,oBAAoB,0BAA0B,2BAC5C,eAAe,SAAS;;EAE1B,WAAW,cAAc,oBAAoB;;;;;;;;;EAU7C,WAAW,cAAc,kBAAkB"}

package/dist/agents/transformers/types.d.ts

@@ -1,6 +1,5 @@
 import { ClientTool, DynamicStructuredTool, ServerTool, StructuredToolInterface } from "@langchain/core/tools";
 import { ChatModelStream, GraphRunStream, LifecycleCause, StreamTransformer, ToolCallStream } from "@langchain/langgraph";
-
 //#region src/agents/transformers/types.d.ts
 /**
  * Infers the merged extensions shape from a tuple of stream transformer
@@ -26,7 +25,7 @@ type ToolOutputOf<T> = T extends DynamicStructuredTool<any, any, any, infer Tool
  * Falls back to `ToolCallStream` (untyped) when the tools tuple is a
  * plain `(ClientTool | ServerTool)[]` without literal name types.
  */
-type ToolCallStreamUnion<TTools extends readonly (ClientTool | ServerTool)[]> = { [K in keyof TTools]: ToolCallStream<ToolNameOf<TTools[K]>, ToolInputOf<TTools[K]>, ToolOutputOf<TTools[K]>> }[number];
+type ToolCallStreamUnion<TTools extends readonly (ClientTool | ServerTool)[]> = { [K in keyof TTools]: ToolCallStream<ToolNameOf<TTools[K]>, ToolInputOf<TTools[K]>, ToolOutputOf<TTools[K]>>; }[number];
 /**
  * A nested named-agent execution surfaced on `run.subagents`.
  *
@@ -79,7 +78,8 @@ interface SubagentRunStream<TValues = Record<string, unknown>, TTools extends re
  *   `InferStreamExtensions<TStreamTransformers>`.
  */
 type AgentRunStream<TValues = Record<string, unknown>, TTools extends readonly (ClientTool | ServerTool)[] = readonly (ClientTool | ServerTool)[], TExtensions extends Record<string, unknown> = Record<string, unknown>> = GraphRunStream<TValues, TExtensions> & {
-  /** Tool call streams from the native ToolCallTransformer. */toolCalls: AsyncIterable<ToolCallStreamUnion<TTools>>;
+  /** Tool call streams from the native ToolCallTransformer. */
+  toolCalls: AsyncIterable<ToolCallStreamUnion<TTools>>;
   /**
    * Named subagent runs dispatched from tools, surfaced by the native
    * {@link createSubagentTransformer}.  Each yielded {@link SubagentRunStream}

package/dist/agents/transformers/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","names":[],"sources":["../../../src/agents/transformers/types.ts"],"mappings":";;;;;;AAuBA;;;;;KAAY,qBAAA,WACA,aAAA,OAAoB,iBAAA,UAC5B,CAAA,uBACA,MAAA,kBACA,CAAA,yBACU,iBAAA,iCACgB,aAAA,OAAoB,iBAAA,UAE5C,CAAA,GAAI,qBAAA,CAAsB,IAAA,IAC1B,MAAA;;KAGD,UAAA,MAAgB,CAAA;EAAY,IAAA;AAAA,IAAiC,CAAA;;KAG7D,WAAA,MACH,CAAA,SAAU,qBAAA,gDACN,YAAA,GACA,CAAA,SAAU,uBAAA,iCACR,YAAA;;KAIH,YAAA,MACH,CAAA,SAAU,qBAAA,+CACN,WAAA,GACA,CAAA,SAAU,uBAAA,gCACR,WAAA;;;;;;;;;KAWI,mBAAA,0BACe,UAAA,GAAa,UAAA,qBAE1B,MAAA,GAAS,cAAA,CACnB,UAAA,CAAW,MAAA,CAAO,CAAA,IAClB,WAAA,CAAY,MAAA,CAAO,CAAA,IACnB,YAAA,CAAa,MAAA,CAAO,CAAA;;;;;;;AAnCM;;;;;;;;;;;UAwDb,iBAAA,WACL,MAAA,4CACe,UAAA,GAAa,UAAA,gBAClC,UAAA,GACA,UAAA;EAtDU;EAAA,SA0DL,IAAA;EAzDT;;;;;EAAA,SAgES,KAAA,EAAO,cAAA;EAjED;EAAA,SAoEN,MAAA,EAAQ,OAAA,CAAQ,OAAA;EAnEf;EAAA,SAsED,QAAA,EAAU,aAAA,CAAc,IAAA,CAAK,eAAA;EArElC;EAAA,SAwEK,SAAA,EAAW,aAAA,CAAc,mBAAA,CAAoB,MAAA;EAvExC;EAAA,SA0EL,SAAA,EAAW,aAAA,CAAc,iBAAA;AAAA;;;AAzEhB;;;;;;;;;;;;;;KA4FR,cAAA,WACA,MAAA,4CACe,UAAA,GAAa,UAAA,gBAClC,UAAA,GACA,UAAA,yBAEgB,MAAA,oBAA0B,MAAA,qBAC5C,cAAA,CAAe,OAAA,EAAS,WAAA;EA5FZ,6DA8Fd,SAAA,EAAW,aAAA,CAAc,mBAAA,CAAoB,MAAA;EA7FvC;;;AAWR;;;;;EA4FE,SAAA,EAAW,aAAA,CAAc,iBAAA,CAAkB,OAAA;AAAA"}
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../../src/agents/transformers/types.ts"],"mappings":";;;;;;;;;;KAuBY,sBACV,UAAU,oBAAoB,2BAC5B,wBACA,wBACA,0BACU,wBAAwB,aACrB,aAAa,oBAAoB,2BAE5C,IAAI,sBAAsB,QAC1B;;KAGD,WAAW,KAAK;EAAY,YAAY;IAAqB;;KAG7D,YAAY,KACf,UAAU,sCAAsC,+BAC5C,eACA,UAAU,mCAAmC,qBAC3C;;KAIH,aAAa,KAChB,UAAU,2CAA2C,yBACjD,cACA,UAAU,wCAAwC,eAChD;;;;;;;;;KAWI,oBACV,yBAAyB,aAAa,oBAErC,WAAW,SAAS,eACnB,WAAW,OAAO,KAClB,YAAY,OAAO,KACnB,aAAa,OAAO;;;;;;;;;;;;;;;;;;UAqBP,kBACf,UAAU,yBACV,yBAAyB,aAAa,0BAClC,aACA;;WAIK;;;;;;WAOA,OAAO;;WAGP,QAAQ,QAAQ;;WAGhB,UAAU,cAAc,KAAK;;WAG7B,WAAW,cAAc,oBAAoB;;WAG7C,WAAW,cAAc;;;;;;;;;;;;;;;;;;KAmBxB,eACV,UAAU,yBACV,yBAAyB,aAAa,0BAClC,aACA,eAEJ,oBAAoB,0BAA0B,2BAC5C,eAAe,SAAS;;EAE1B,WAAW,cAAc,oBAAoB;;;;;;;;;EAU7C,WAAW,cAAc,kBAAkB"}

package/dist/agents/types.d.cts

@@ -8,7 +8,6 @@ import { InteropZodObject, InteropZodType } from "@langchain/core/utils/types";
 import { END, START, StateDefinitionInit, StateGraph, StreamTransformer } from "@langchain/langgraph";
 import { BaseCheckpointSaver, BaseStore } from "@langchain/langgraph-checkpoint";
 import { Messages } from "@langchain/langgraph/";
-
 //#region src/agents/types.d.ts
 /**
  * Type bag that encapsulates all agent type parameters.
@@ -135,7 +134,7 @@ type ExtractToolDefinition<T> = T extends DynamicStructuredTool<infer _SchemaT,
  */
 type ToolsToMessageToolSet<T extends readonly (ClientTool | ServerTool)[]> = { [K in T[number] as K extends {
   name: infer N extends string;
-} ? N : never]: ExtractToolDefinition<K> };
+} ? N : never]: ExtractToolDefinition<K>; };
 /**
  * Helper type to resolve an AgentTypeConfig from either:
  * - An AgentTypeConfig directly

package/dist/agents/types.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.cts","names":[],"sources":["../../src/agents/types.ts"],"mappings":"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"}
+{"version":3,"file":"types.d.cts","names":[],"sources":["../../src/agents/types.ts"],"mappings":"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"}

package/dist/agents/types.d.ts

@@ -8,7 +8,6 @@ import { END, START, StateDefinitionInit, StateGraph, StreamTransformer } from "
 import { InteropZodObject, InteropZodType } from "@langchain/core/utils/types";
 import { BaseCheckpointSaver, BaseStore } from "@langchain/langgraph-checkpoint";
 import { Messages } from "@langchain/langgraph/";
-
 //#region src/agents/types.d.ts
 /**
  * Type bag that encapsulates all agent type parameters.
@@ -135,7 +134,7 @@ type ExtractToolDefinition<T> = T extends DynamicStructuredTool<infer _SchemaT,
  */
 type ToolsToMessageToolSet<T extends readonly (ClientTool | ServerTool)[]> = { [K in T[number] as K extends {
   name: infer N extends string;
-} ? N : never]: ExtractToolDefinition<K> };
+} ? N : never]: ExtractToolDefinition<K>; };
 /**
  * Helper type to resolve an AgentTypeConfig from either:
  * - An AgentTypeConfig directly

package/dist/agents/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","names":[],"sources":["../../src/agents/types.ts"],"mappings":"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"}
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../src/agents/types.ts"],"mappings":"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"}

package/dist/agents/utils.cjs

@@ -1,4 +1,3 @@
-require("../_virtual/_rolldown/runtime.cjs");
 const require_model = require("./model.cjs");
 const require_errors = require("./errors.cjs");
 let _langchain_core_messages = require("@langchain/core/messages");