langchain 1.4.5 → 1.4.6-dev-1781485641139

package/dist/agents/transformers/subagent.js

@@ -0,0 +1,204 @@
+import { createToolCallTransformer } from "./tool-call.js";
+import { StreamChannel, createMessagesTransformer } from "@langchain/langgraph";
+//#region src/agents/transformers/subagent.ts
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/** Stable string key for a namespace. */
+function nsKey(ns) {
+	return ns.join("\0");
+}
+/** Tests whether `ns` starts with every segment in `prefix`. */
+function hasPrefix(ns, prefix) {
+	if (prefix.length > ns.length) return false;
+	for (let i = 0; i < prefix.length; i += 1) if (ns[i] !== prefix[i]) return false;
+	return true;
+}
+/**
+* Creates a native transformer that surfaces nested named agents on
+* `run.subagents`.
+*
+* It watches `tasks` events to record each namespace's `lc_agent_name` (set by
+* `createAgent({ name })`) and the triggering tool call, then — for any nested
+* run one level below {@link scope} that carries an `lc_agent_name` — emits a
+* typed {@link SubagentRunStream} handle.
+*
+* Each handle is backed by its own per-subagent transformer instances
+* ({@link createMessagesTransformer}, {@link createToolCallTransformer}, and a
+* nested {@link createSubagentTransformer}) scoped to the subagent's namespace.
+* Every event in the subtree is fed straight into those transformers, which
+* self-filter by namespace; the subagent's final `output` is resolved from its
+* last `values` snapshot when its `lifecycle` completes.
+*
+* Marked `__native: true` — the `subagents` projection lands directly on the
+* `GraphRunStream` instance as `run.subagents`.
+*
+* @param scope - Namespace prefix this transformer is scoped to. The root agent
+*   uses `[]`; nested handles use their subagent's namespace, so grandchild
+*   subagents are discovered recursively.
+*/
+function createSubagentTransformer(scope = []) {
+	return () => {
+		const subagentsLog = StreamChannel.local();
+		/** `lc_agent_name` observed per namespace (first task event wins). */
+		const lcByNs = /* @__PURE__ */ new Map();
+		/** Triggering task id -> originating LLM `tool_call_id`. */
+		const pendingToolCalls = /* @__PURE__ */ new Map();
+		/**
+		* Namespace key -> the `tool_call_id` of the most recent tool to start
+		* executing there. A tool that invokes a subagent emits its `tool-started`
+		* at the tools-node namespace (`tools:<task_id>`) where the subagent then
+		* roots, so this is the tool call that caused the subagent.
+		*/
+		const activeToolCallByNs = /* @__PURE__ */ new Map();
+		const handles = /* @__PURE__ */ new Map();
+		const depth = scope.length;
+		function recordIdentity(ns, data) {
+			const key = nsKey(ns);
+			if (lcByNs.has(key)) return;
+			const lc = (isRecord(data) && isRecord(data.metadata) ? data.metadata : void 0)?.lc_agent_name;
+			lcByNs.set(key, typeof lc === "string" ? lc : void 0);
+		}
+		function recordPendingToolCalls(data) {
+			if (!isRecord(data)) return;
+			const taskId = data.id;
+			if (typeof taskId !== "string") return;
+			const input = data.input;
+			let toolCallId;
+			if (isRecord(input) && isRecord(input.tool_call)) {
+				const candidate = input.tool_call.id;
+				if (typeof candidate === "string") toolCallId = candidate;
+			} else if (Array.isArray(input)) {
+				for (const toolCall of input) if (isRecord(toolCall) && typeof toolCall.id === "string") {
+					toolCallId = toolCall.id;
+					break;
+				}
+			}
+			if (toolCallId != null) pendingToolCalls.set(taskId, toolCallId);
+		}
+		/**
+		* Derive the `toolCall` cause for a named-subagent namespace.
+		*
+		* Primary signal: the tool whose `tool-started` event fired at the
+		* subagent's own namespace (the tools node it roots under). Fallback: the
+		* namespace segment's task id (`node:<task_id>`) joined to a tool call
+		* harvested from a `tool_call_with_context`-shaped task input, so the
+		* derivation stays correct if that shape reaches the stream in the future.
+		*/
+		function deriveCause(ns) {
+			const active = activeToolCallByNs.get(nsKey(ns));
+			if (typeof active === "string" && active.length > 0) return {
+				type: "toolCall",
+				tool_call_id: active
+			};
+			const segment = ns[ns.length - 1];
+			const colon = segment.indexOf(":");
+			if (colon === -1) return void 0;
+			const triggerCallId = segment.slice(colon + 1);
+			if (triggerCallId.length === 0) return void 0;
+			const toolCallId = pendingToolCalls.get(triggerCallId);
+			if (typeof toolCallId !== "string" || toolCallId.length === 0) return;
+			return {
+				type: "toolCall",
+				tool_call_id: toolCallId
+			};
+		}
+		function maybeStartSubagent(ns) {
+			if (ns.length !== depth + 1 || !hasPrefix(ns, scope)) return;
+			const key = nsKey(ns);
+			if (handles.has(key)) return;
+			const lc = lcByNs.get(key);
+			if (typeof lc !== "string" || lc.length === 0) return;
+			const messages = createMessagesTransformer(ns);
+			const messagesProjection = messages.init();
+			const toolCall = createToolCallTransformer(ns)();
+			const toolCallProjection = toolCall.init();
+			const nested = createSubagentTransformer(ns)();
+			const nestedProjection = nested.init();
+			let resolveOutput;
+			let rejectOutput;
+			const output = new Promise((resolve, reject) => {
+				resolveOutput = resolve;
+				rejectOutput = reject;
+			});
+			handles.set(key, {
+				key,
+				path: ns,
+				name: lc,
+				messages,
+				toolCall,
+				nested,
+				resolveOutput,
+				rejectOutput,
+				latestValues: void 0,
+				done: false
+			});
+			subagentsLog.push({
+				name: lc,
+				cause: deriveCause(ns),
+				output,
+				messages: messagesProjection.messages,
+				toolCalls: toolCallProjection.toolCalls,
+				subagents: nestedProjection.subagents
+			});
+		}
+		function finishHandle(handle, outcome) {
+			if (handle.done) return;
+			handle.done = true;
+			if (outcome.type === "resolve") handle.resolveOutput(handle.latestValues);
+			else handle.rejectOutput(outcome.error);
+			handle.messages.finalize?.();
+			handle.toolCall.finalize?.();
+			handle.nested.finalize?.();
+		}
+		return {
+			__native: true,
+			init: () => ({ subagents: subagentsLog }),
+			process(event) {
+				const ns = event.params.namespace;
+				const data = event.params.data;
+				const isTaskResult = event.method === "tasks" && isRecord(data) && "result" in data;
+				if (event.method === "tools" && isRecord(data) && data.event === "tool-started" && typeof data.tool_call_id === "string" && data.tool_call_id.length > 0) activeToolCallByNs.set(nsKey(ns), data.tool_call_id);
+				if (event.method === "tasks" && !isTaskResult) {
+					recordIdentity(ns, data);
+					recordPendingToolCalls(data);
+					maybeStartSubagent(ns);
+				}
+				for (const handle of handles.values()) {
+					if (handle.done) continue;
+					if (!hasPrefix(ns, handle.path)) continue;
+					handle.messages.process(event);
+					handle.toolCall.process(event);
+					handle.nested.process(event);
+					if (nsKey(ns) === handle.key) {
+						if (event.method === "values" && isRecord(data)) handle.latestValues = data;
+						else if (event.method === "lifecycle" && isRecord(data)) {
+							const status = data.event;
+							if (status === "completed" || status === "interrupted") finishHandle(handle, { type: "resolve" });
+							else if (status === "failed") finishHandle(handle, {
+								type: "reject",
+								error: /* @__PURE__ */ new Error(`Subagent ${handle.name} failed`)
+							});
+						}
+					}
+				}
+				return true;
+			},
+			finalize() {
+				for (const handle of handles.values()) finishHandle(handle, { type: "resolve" });
+				subagentsLog.close();
+			},
+			fail(err) {
+				for (const handle of handles.values()) finishHandle(handle, {
+					type: "reject",
+					error: err
+				});
+				subagentsLog.fail(err);
+			}
+		};
+	};
+}
+//#endregion
+export { createSubagentTransformer };
+
+//# sourceMappingURL=subagent.js.map

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

@@ -0,0 +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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"}

package/dist/agents/{stream.cjs → transformers/tool-call.cjs}

@@ -1,19 +1,7 @@
-require("../_virtual/_rolldown/runtime.cjs");
+require("../../_virtual/_rolldown/runtime.cjs");
 let _langchain_core_messages = require("@langchain/core/messages");
 let _langchain_langgraph = require("@langchain/langgraph");
-//#region src/agents/stream.ts
-/**
-* Agent-level streaming support (experimental).
-*
-* Provides native stream transformer factories for tool calls and
-* middleware events.  When marked `__native: true`, their projections
-* are assigned directly onto the `GraphRunStream` instance by
-* `createGraphRunStream` in langgraph-core — no subclass or wrapper
-* needed.
-*
-* See protocol proposal §15 (In-Process Streaming Interface) and §16
-* (Native Stream Transformers).
-*/
+//#region src/agents/transformers/tool-call.ts
 /**
 * Returns true when `ns` belongs to the agent's own graph — i.e. it
 * starts with `path` and is at most one level deeper (the agent's
@@ -173,4 +161,4 @@ function createToolCallTransformer(path) {
 //#endregion
 exports.createToolCallTransformer = createToolCallTransformer;
 
-//# sourceMappingURL=stream.cjs.map
+//# sourceMappingURL=tool-call.cjs.map

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

@@ -0,0 +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\nfunction isHeadlessToolInterruptError(\n  message: string,\n  toolCallId: string | undefined\n): boolean {\n  try {\n    const parsed = JSON.parse(message) as unknown;\n    if (!Array.isArray(parsed)) return false;\n    return parsed.some((entry) => {\n      if (entry == null || typeof entry !== \"object\") return false;\n      const value = (entry as { value?: unknown }).value;\n      if (value == null || typeof value !== \"object\") return false;\n      const payload = value as {\n        type?: unknown;\n        toolCall?: { id?: unknown };\n      };\n      return (\n        payload.type === \"tool\" &&\n        (toolCallId == null ||\n          payload.toolCall?.id == null ||\n          payload.toolCall.id === toolCallId)\n      );\n    });\n  } catch {\n    return false;\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              if (isHeadlessToolInterruptError(message, toolCallId)) {\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

@@ -0,0 +1,17 @@
+import { Namespace, NativeStreamTransformer, ToolCallStream } from "@langchain/langgraph";
+
+//#region src/agents/transformers/tool-call.d.ts
+interface ToolCallProjection {
+  toolCalls: AsyncIterable<ToolCallStream>;
+}
+/**
+ * Creates a native transformer that correlates `tools` channel events
+ * into per-call {@link ToolCallStream} objects.
+ *
+ * Marked `__native: true` — projection keys land directly on the
+ * `GraphRunStream` instance as `run.toolCalls`.
+ */
+declare function createToolCallTransformer(path: Namespace): () => NativeStreamTransformer<ToolCallProjection>;
+//#endregion
+export { createToolCallTransformer };
+//# sourceMappingURL=tool-call.d.cts.map

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

@@ -0,0 +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;;;;;;;;iBAuFX,yBAAA,CACd,IAAA,EAAM,SAAA,SACC,uBAAA,CAAwB,kBAAA"}

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

@@ -0,0 +1,17 @@
+import { Namespace, NativeStreamTransformer, ToolCallStream } from "@langchain/langgraph";
+
+//#region src/agents/transformers/tool-call.d.ts
+interface ToolCallProjection {
+  toolCalls: AsyncIterable<ToolCallStream>;
+}
+/**
+ * Creates a native transformer that correlates `tools` channel events
+ * into per-call {@link ToolCallStream} objects.
+ *
+ * Marked `__native: true` — projection keys land directly on the
+ * `GraphRunStream` instance as `run.toolCalls`.
+ */
+declare function createToolCallTransformer(path: Namespace): () => NativeStreamTransformer<ToolCallProjection>;
+//#endregion
+export { createToolCallTransformer };
+//# sourceMappingURL=tool-call.d.ts.map

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

@@ -0,0 +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;;;;;;;;iBAuFX,yBAAA,CACd,IAAA,EAAM,SAAA,SACC,uBAAA,CAAwB,kBAAA"}

package/dist/agents/{stream.js → transformers/tool-call.js}

@@ -1,18 +1,6 @@
 import { ToolMessage } from "@langchain/core/messages";
 import { StreamChannel } from "@langchain/langgraph";
-//#region src/agents/stream.ts
-/**
-* Agent-level streaming support (experimental).
-*
-* Provides native stream transformer factories for tool calls and
-* middleware events.  When marked `__native: true`, their projections
-* are assigned directly onto the `GraphRunStream` instance by
-* `createGraphRunStream` in langgraph-core — no subclass or wrapper
-* needed.
-*
-* See protocol proposal §15 (In-Process Streaming Interface) and §16
-* (Native Stream Transformers).
-*/
+//#region src/agents/transformers/tool-call.ts
 /**
 * Returns true when `ns` belongs to the agent's own graph — i.e. it
 * starts with `path` and is at most one level deeper (the agent's
@@ -172,4 +160,4 @@ function createToolCallTransformer(path) {
 //#endregion
 export { createToolCallTransformer };
 
-//# sourceMappingURL=stream.js.map
+//# sourceMappingURL=tool-call.js.map

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

@@ -0,0 +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\nfunction isHeadlessToolInterruptError(\n  message: string,\n  toolCallId: string | undefined\n): boolean {\n  try {\n    const parsed = JSON.parse(message) as unknown;\n    if (!Array.isArray(parsed)) return false;\n    return parsed.some((entry) => {\n      if (entry == null || typeof entry !== \"object\") return false;\n      const value = (entry as { value?: unknown }).value;\n      if (value == null || typeof value !== \"object\") return false;\n      const payload = value as {\n        type?: unknown;\n        toolCall?: { id?: unknown };\n      };\n      return (\n        payload.type === \"tool\" &&\n        (toolCallId == null ||\n          payload.toolCall?.id == null ||\n          payload.toolCall.id === toolCallId)\n      );\n    });\n  } catch {\n    return false;\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              if (isHeadlessToolInterruptError(message, toolCallId)) {\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/{stream.d.ts → transformers/types.d.cts}

@@ -1,11 +1,10 @@
 import { ClientTool, DynamicStructuredTool, ServerTool, StructuredToolInterface } from "@langchain/core/tools";
-import { GraphRunStream, Namespace, NativeStreamTransformer, StreamTransformer, ToolCallStream } from "@langchain/langgraph";
+import { ChatModelStream, GraphRunStream, LifecycleCause, StreamTransformer, ToolCallStream } from "@langchain/langgraph";
 
-//#region src/agents/stream.d.ts
+//#region src/agents/transformers/types.d.ts
 /**
  * Infers the merged extensions shape from a tuple of stream transformer
- * factories. Mirrors `InferExtensions` from `@langchain/langgraph`, which
- * is not exported from the package's public surface.
+ * factories.
  *
  * Given `[() => StreamTransformer<{ a: number }>, () => StreamTransformer<{ b: string }>]`,
  * produces `{ a: number } & { b: string }`.
@@ -28,6 +27,41 @@ type ToolOutputOf<T> = T extends DynamicStructuredTool<any, any, any, infer Tool
  * 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];
+/**
+ * A nested named-agent execution surfaced on `run.subagents`.
+ *
+ * A subagent is a nested `createAgent` run whose `lc_agent_name` differs from
+ * its parent's — e.g. a `createAgent({ name })` invoked inside a tool body. The
+ * handle exposes scoped projections (`messages`, `toolCalls`, nested
+ * `subagents`) plus the resolved {@link name}, the {@link cause} that triggered
+ * it, and the subagent's final {@link output} state.
+ *
+ * This is a self-contained handle (no subclass of `SubgraphRunStream`): its
+ * projections are produced by per-subagent transformer instances that
+ * {@link createSubagentTransformer} drives directly.
+ *
+ * @typeParam TValues - Shape of the subagent's final output state.
+ * @typeParam TTools - Tuple of tools the subagent may call, used to type
+ *   {@link toolCalls}.
+ */
+interface SubagentRunStream<TValues = Record<string, unknown>, TTools extends readonly (ClientTool | ServerTool)[] = readonly (ClientTool | ServerTool)[]> {
+  /** The subagent's `lc_agent_name` (set by `createAgent({ name })`). */
+  readonly name: string;
+  /**
+   * The tool call that dispatched this subagent, as
+   * `{ type: "toolCall", tool_call_id }`, or `undefined` when the originating
+   * tool call could not be recovered (e.g. it was not triggered from a tool).
+   */
+  readonly cause: LifecycleCause | undefined;
+  /** Resolves with the subagent's final state once it completes. */
+  readonly output: Promise<TValues>;
+  /** Per-message chat-model token streams scoped to this subagent. */
+  readonly messages: AsyncIterable<Omit<ChatModelStream, "then">>;
+  /** The subagent's own tool-call streams. */
+  readonly toolCalls: AsyncIterable<ToolCallStreamUnion<TTools>>;
+  /** Nested subagents this subagent dispatches from its own tools. */
+  readonly subagents: AsyncIterable<SubagentRunStream>;
+}
 /**
  * A {@link GraphRunStream} with native agent-level projections assigned
  * directly on the instance by `createGraphRunStream` (via `__native`
@@ -40,26 +74,22 @@ type ToolCallStreamUnion<TTools extends readonly (ClientTool | ServerTool)[]> =
  * @typeParam TValues - Shape of the graph's state values.
  * @typeParam TTools - Tuple of tools registered on the agent, used to type
  *   the per-tool `toolCalls` discriminated union.
- * @typeParam TMiddleware - Tuple of middleware registered on the agent, used
- *   to type the per-middleware `middleware` event union.
  * @typeParam TExtensions - Shape of `run.extensions` produced by user-supplied
  *   stream transformer factories. Derived via
- *   `InferExtensions<TStreamTransformers>`.
+ *   `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>>;
+  /**
+   * Named subagent runs dispatched from tools, surfaced by the native
+   * {@link createSubagentTransformer}.  Each yielded {@link SubagentRunStream}
+   * is a nested `createAgent` run whose `lc_agent_name` differs from this
+   * agent's — for example a `createAgent({ name })` invoked inside a tool body.
+   * Unlike `run.subgraphs` (which also yields the agent's own internal nodes),
+   * `run.subagents` only yields real named-agent invocations.
+   */
+  subagents: AsyncIterable<SubagentRunStream<TValues>>;
 };
-interface ToolCallProjection {
-  toolCalls: AsyncIterable<ToolCallStream>;
-}
-/**
- * Creates a native transformer that correlates `tools` channel events
- * into per-call {@link ToolCallStream} objects.
- *
- * Marked `__native: true` — projection keys land directly on the
- * `GraphRunStream` instance as `run.toolCalls`.
- */
-declare function createToolCallTransformer(path: Namespace): () => NativeStreamTransformer<ToolCallProjection>;
 //#endregion
-export { AgentRunStream, InferStreamExtensions, ToolCallStreamUnion, createToolCallTransformer };
-//# sourceMappingURL=stream.d.ts.map
+export { AgentRunStream, InferStreamExtensions, SubagentRunStream, ToolCallStreamUnion };
+//# sourceMappingURL=types.d.cts.map

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

@@ -0,0 +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"}

package/dist/agents/{stream.d.cts → transformers/types.d.ts}

@@ -1,11 +1,10 @@
 import { ClientTool, DynamicStructuredTool, ServerTool, StructuredToolInterface } from "@langchain/core/tools";
-import { GraphRunStream, Namespace, NativeStreamTransformer, StreamTransformer, ToolCallStream } from "@langchain/langgraph";
+import { ChatModelStream, GraphRunStream, LifecycleCause, StreamTransformer, ToolCallStream } from "@langchain/langgraph";
 
-//#region src/agents/stream.d.ts
+//#region src/agents/transformers/types.d.ts
 /**
  * Infers the merged extensions shape from a tuple of stream transformer
- * factories. Mirrors `InferExtensions` from `@langchain/langgraph`, which
- * is not exported from the package's public surface.
+ * factories.
  *
  * Given `[() => StreamTransformer<{ a: number }>, () => StreamTransformer<{ b: string }>]`,
  * produces `{ a: number } & { b: string }`.
@@ -28,6 +27,41 @@ type ToolOutputOf<T> = T extends DynamicStructuredTool<any, any, any, infer Tool
  * 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];
+/**
+ * A nested named-agent execution surfaced on `run.subagents`.
+ *
+ * A subagent is a nested `createAgent` run whose `lc_agent_name` differs from
+ * its parent's — e.g. a `createAgent({ name })` invoked inside a tool body. The
+ * handle exposes scoped projections (`messages`, `toolCalls`, nested
+ * `subagents`) plus the resolved {@link name}, the {@link cause} that triggered
+ * it, and the subagent's final {@link output} state.
+ *
+ * This is a self-contained handle (no subclass of `SubgraphRunStream`): its
+ * projections are produced by per-subagent transformer instances that
+ * {@link createSubagentTransformer} drives directly.
+ *
+ * @typeParam TValues - Shape of the subagent's final output state.
+ * @typeParam TTools - Tuple of tools the subagent may call, used to type
+ *   {@link toolCalls}.
+ */
+interface SubagentRunStream<TValues = Record<string, unknown>, TTools extends readonly (ClientTool | ServerTool)[] = readonly (ClientTool | ServerTool)[]> {
+  /** The subagent's `lc_agent_name` (set by `createAgent({ name })`). */
+  readonly name: string;
+  /**
+   * The tool call that dispatched this subagent, as
+   * `{ type: "toolCall", tool_call_id }`, or `undefined` when the originating
+   * tool call could not be recovered (e.g. it was not triggered from a tool).
+   */
+  readonly cause: LifecycleCause | undefined;
+  /** Resolves with the subagent's final state once it completes. */
+  readonly output: Promise<TValues>;
+  /** Per-message chat-model token streams scoped to this subagent. */
+  readonly messages: AsyncIterable<Omit<ChatModelStream, "then">>;
+  /** The subagent's own tool-call streams. */
+  readonly toolCalls: AsyncIterable<ToolCallStreamUnion<TTools>>;
+  /** Nested subagents this subagent dispatches from its own tools. */
+  readonly subagents: AsyncIterable<SubagentRunStream>;
+}
 /**
  * A {@link GraphRunStream} with native agent-level projections assigned
  * directly on the instance by `createGraphRunStream` (via `__native`
@@ -40,26 +74,22 @@ type ToolCallStreamUnion<TTools extends readonly (ClientTool | ServerTool)[]> =
  * @typeParam TValues - Shape of the graph's state values.
  * @typeParam TTools - Tuple of tools registered on the agent, used to type
  *   the per-tool `toolCalls` discriminated union.
- * @typeParam TMiddleware - Tuple of middleware registered on the agent, used
- *   to type the per-middleware `middleware` event union.
  * @typeParam TExtensions - Shape of `run.extensions` produced by user-supplied
  *   stream transformer factories. Derived via
- *   `InferExtensions<TStreamTransformers>`.
+ *   `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>>;
+  /**
+   * Named subagent runs dispatched from tools, surfaced by the native
+   * {@link createSubagentTransformer}.  Each yielded {@link SubagentRunStream}
+   * is a nested `createAgent` run whose `lc_agent_name` differs from this
+   * agent's — for example a `createAgent({ name })` invoked inside a tool body.
+   * Unlike `run.subgraphs` (which also yields the agent's own internal nodes),
+   * `run.subagents` only yields real named-agent invocations.
+   */
+  subagents: AsyncIterable<SubagentRunStream<TValues>>;
 };
-interface ToolCallProjection {
-  toolCalls: AsyncIterable<ToolCallStream>;
-}
-/**
- * Creates a native transformer that correlates `tools` channel events
- * into per-call {@link ToolCallStream} objects.
- *
- * Marked `__native: true` — projection keys land directly on the
- * `GraphRunStream` instance as `run.toolCalls`.
- */
-declare function createToolCallTransformer(path: Namespace): () => NativeStreamTransformer<ToolCallProjection>;
 //#endregion
-export { AgentRunStream, InferStreamExtensions, ToolCallStreamUnion, createToolCallTransformer };
-//# sourceMappingURL=stream.d.cts.map
+export { AgentRunStream, InferStreamExtensions, SubagentRunStream, ToolCallStreamUnion };
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +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"}

package/dist/browser.cjs

@@ -5,7 +5,8 @@ const require_headless = require("./tools/headless.cjs");
 const require_errors = require("./agents/errors.cjs");
 const require_responses = require("./agents/responses.cjs");
 const require_utils = require("./agents/middleware/utils.cjs");
-const require_stream = require("./agents/stream.cjs");
+const require_tool_call = require("./agents/transformers/tool-call.cjs");
+const require_subagent = require("./agents/transformers/subagent.cjs");
 const require_types = require("./agents/middleware/types.cjs");
 const require_middleware = require("./agents/middleware.cjs");
 const require_utils$1 = require("./agents/tests/utils.cjs");
@@ -72,7 +73,8 @@ var browser_exports = /* @__PURE__ */ require_runtime.__exportAll({
 	countTokensApproximately: () => require_utils.countTokensApproximately,
 	createAgent: () => require_index.createAgent,
 	createMiddleware: () => require_middleware.createMiddleware,
-	createToolCallTransformer: () => require_stream.createToolCallTransformer,
+	createSubagentTransformer: () => require_subagent.createSubagentTransformer,
+	createToolCallTransformer: () => require_tool_call.createToolCallTransformer,
 	detectCreditCard: () => require_pii.detectCreditCard,
 	detectEmail: () => require_pii.detectEmail,
 	detectIP: () => require_pii.detectIP,
@@ -231,7 +233,8 @@ exports.contextEditingMiddleware = require_contextEditing.contextEditingMiddlewa
 exports.countTokensApproximately = require_utils.countTokensApproximately;
 exports.createAgent = require_index.createAgent;
 exports.createMiddleware = require_middleware.createMiddleware;
-exports.createToolCallTransformer = require_stream.createToolCallTransformer;
+exports.createSubagentTransformer = require_subagent.createSubagentTransformer;
+exports.createToolCallTransformer = require_tool_call.createToolCallTransformer;
 exports.detectCreditCard = require_pii.detectCreditCard;
 exports.detectEmail = require_pii.detectEmail;
 exports.detectIP = require_pii.detectIP;