@langchain/langgraph 1.2.8 → 1.3.0

package/dist/stream/convert.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert.cjs","names":[],"sources":["../../src/stream/convert.ts"],"sourcesContent":["/**\n * Protocol event conversion — maps raw `[ns, mode, payload, meta?]` stream\n * chunks from graph.stream() to CDDL-aligned ProtocolEvents.\n */\n\nimport type { StreamMode } from \"../pregel/types.js\";\nimport type { StreamChunkMeta } from \"../pregel/stream.js\";\nimport type {\n  Namespace,\n  ProtocolEvent,\n  ToolsEventData,\n  UpdatesEventData,\n} from \"./types.js\";\n\n/**\n * The set of stream modes requested by\n * `streamEvents(..., { version: \"v3\" })` — every mode the protocol maps\n * to a channel.\n *\n * The verbose `\"debug\"` mode is intentionally excluded: it was a thin\n * re-wrap of `checkpoints` + `tasks` carrying no new information.\n *\n * The `\"checkpoints\"` mode is likewise excluded from the stream-mode\n * request because the protocol's `checkpoints` channel carries only a\n * lightweight envelope (`id`, `parent_id`, `step`, `source`) derived from\n * {@link StreamChunkMeta.checkpoint} on the adjacent `values` chunk — not\n * the full-state shape that Pregel's `checkpoints` stream mode produces.\n * `convertToProtocolEvent` emits a companion `checkpoints` protocol event\n * next to each `values` event when meta is present, so clients can build\n * branching/time-travel UIs without a full-state `checkpoints` subscription.\n */\nexport const STREAM_EVENTS_V3_MODES: StreamMode[] = [\n  \"values\",\n  \"updates\",\n  \"messages\",\n  \"tools\",\n  \"custom\",\n  \"tasks\",\n];\n\n/**\n * Converts a raw `[ns, mode, payload, meta?]` stream chunk emitted by\n * `graph.stream()` into one or more CDDL-aligned {@link ProtocolEvent}s.\n *\n * Most modes produce a single event. `values` chunks carrying\n * {@link StreamChunkMeta.checkpoint} additionally produce a companion\n * `checkpoints` event immediately after the `values` event, so clients\n * that subscribe only to `checkpoints` can build a branching timeline\n * without also paying for full-state `values` payloads, and clients that\n * subscribe to both can correlate the pair by `(namespace, step)` or by\n * adjacent `seq` numbers.\n *\n * Returns an empty array for stream modes that have no protocol mapping.\n *\n * @param options - Conversion inputs for a single raw stream chunk.\n * @param options.namespace - Hierarchical namespace path identifying the\n *   source in the agent tree.\n * @param options.mode - The stream mode that produced this chunk (e.g.\n *   `\"messages\"`, `\"tools\"`).\n * @param options.payload - The raw payload emitted by the stream for this\n *   mode.\n * @param options.seq - Monotonically increasing sequence number assigned to\n *   the first returned event; the companion `checkpoints` event (when\n *   emitted) uses `seq + 1`.\n * @param options.meta - Optional chunk-level metadata (e.g. the checkpoint\n *   envelope paired with a `values` chunk).\n * @returns An ordered list of {@link ProtocolEvent}s ready for downstream\n *   reducers. Callers advance their `seq` counter by `result.length`.\n */\nexport interface ConvertToProtocolEventOptions {\n  namespace: Namespace;\n  mode: StreamMode;\n  payload: unknown;\n  seq: number;\n  meta?: StreamChunkMeta;\n}\n\nfunction unwrapMessagesPayload(payload: unknown) {\n  if (!Array.isArray(payload) || payload.length !== 2) {\n    return { data: payload };\n  }\n\n  const [data, metadata] = payload;\n  if (metadata == null || typeof metadata !== \"object\") {\n    return { data: payload };\n  }\n\n  const record = metadata as Record<string, unknown>;\n  const node =\n    typeof record.langgraph_node === \"string\"\n      ? record.langgraph_node\n      : undefined;\n  const runId = typeof record.run_id === \"string\" ? record.run_id : undefined;\n  const dataWithRunId =\n    runId != null && data != null && typeof data === \"object\"\n      ? { ...(data as Record<string, unknown>), run_id: runId }\n      : data;\n\n  return { data: dataWithRunId, node };\n}\n\nexport function convertToProtocolEvent({\n  namespace: ns,\n  mode,\n  payload,\n  seq,\n  meta,\n}: ConvertToProtocolEventOptions): ProtocolEvent[] {\n  const timestamp = Date.now();\n  const base = { type: \"event\" as const };\n\n  switch (mode) {\n    case \"messages\": {\n      const { data, node } = unwrapMessagesPayload(payload);\n      return [\n        {\n          ...base,\n          seq,\n          method: \"messages\",\n          params: { namespace: ns, timestamp, ...(node ? { node } : {}), data },\n        },\n      ];\n    }\n\n    case \"tools\":\n      return [\n        {\n          ...base,\n          seq,\n          method: \"tools\",\n          params: {\n            namespace: ns,\n            timestamp,\n            data: convertToolsPayload(payload),\n          },\n        },\n      ];\n\n    case \"values\": {\n      // Emit the `checkpoints` event immediately BEFORE its companion\n      // `values` event so clients subscribed to both channels have the\n      // envelope buffered by the time the values payload arrives. This\n      // lets the SDK attach `parentCheckpointId` to messages extracted\n      // from the values snapshot without waiting for a second pass.\n      const events: ProtocolEvent[] = [];\n      if (meta?.checkpoint != null) {\n        events.push({\n          ...base,\n          seq,\n          method: \"checkpoints\",\n          params: { namespace: ns, timestamp, data: meta.checkpoint },\n        });\n      }\n      events.push({\n        ...base,\n        seq: meta?.checkpoint != null ? seq + 1 : seq,\n        method: \"values\",\n        params: { namespace: ns, timestamp, data: payload },\n      });\n      return events;\n    }\n\n    case \"updates\": {\n      const data = convertUpdatesPayload(payload);\n      return [\n        {\n          ...base,\n          seq,\n          method: \"updates\",\n          params: {\n            namespace: ns,\n            timestamp,\n            // Surface the completed node at the top level of `params` so\n            // transformers (notably `LifecycleTransformer`) can attribute\n            // a finished task to its child namespace without re-parsing\n            // the payload.  The same value is retained inside `data` for\n            // downstream consumers that inspect the event body.\n            ...(typeof data.node === \"string\" ? { node: data.node } : {}),\n            data,\n          },\n        },\n      ];\n    }\n\n    case \"custom\": {\n      const data =\n        typeof payload === \"object\" &&\n        payload !== null &&\n        !Array.isArray(payload) &&\n        \"name\" in payload\n          ? payload\n          : { payload };\n      return [\n        {\n          ...base,\n          seq,\n          method: \"custom\",\n          params: { namespace: ns, timestamp, data },\n        },\n      ];\n    }\n\n    case \"tasks\":\n      return [\n        {\n          ...base,\n          seq,\n          method: \"tasks\",\n          params: { namespace: ns, timestamp, data: payload },\n        },\n      ];\n\n    default:\n      return [];\n  }\n}\n\n/**\n * Normalises a raw tools-mode payload into a typed {@link ToolsEventData}\n * discriminated union, mapping internal lifecycle events (`on_tool_start`,\n * `on_tool_end`, etc.) to their protocol counterparts.\n *\n * @param payload - The raw payload from a `\"tools\"` stream chunk.\n * @returns A {@link ToolsEventData} object with the appropriate `event`\n *   discriminant and associated fields.\n */\nfunction convertToolsPayload(payload: unknown): ToolsEventData {\n  if (typeof payload !== \"object\" || payload === null) {\n    return {\n      event: \"tool-error\",\n      tool_call_id: \"\",\n      message: \"Unexpected tools payload shape\",\n    };\n  }\n\n  const p = payload as Record<string, unknown>;\n  const tool_call_id = String(p.toolCallId ?? \"\");\n\n  switch (p.event) {\n    case \"on_tool_start\":\n      return {\n        event: \"tool-started\",\n        tool_call_id,\n        tool_name: String(p.name ?? \"unknown\"),\n        input: p.input,\n      };\n\n    case \"on_tool_event\": {\n      const delta =\n        typeof p.data === \"string\" ? p.data : JSON.stringify(p.data ?? \"\");\n      return {\n        event: \"tool-output-delta\",\n        tool_call_id,\n        delta,\n      };\n    }\n\n    case \"on_tool_end\":\n      return {\n        event: \"tool-finished\",\n        tool_call_id,\n        output: p.output,\n      };\n\n    case \"on_tool_error\": {\n      const err = p.error;\n      const errMessage =\n        typeof err === \"object\" &&\n        err !== null &&\n        \"message\" in err &&\n        typeof (err as { message: unknown }).message === \"string\"\n          ? (err as { message: string }).message\n          : String(err ?? \"unknown error\");\n      return {\n        event: \"tool-error\",\n        tool_call_id,\n        message: errMessage,\n      };\n    }\n\n    default:\n      return {\n        event: \"tool-error\",\n        tool_call_id: \"\",\n        message: `Unknown tool event: ${String(p.event)}`,\n      };\n  }\n}\n\n/**\n * Extracts the first `{node: delta}` entry from an updates-mode payload and\n * reshapes it into an {@link UpdatesEventData} with explicit `node` and\n * `values` fields.  Non-object payloads are coerced to `{ values: {} }`.\n *\n * @param payload - The raw payload from an `\"updates\"` stream chunk,\n *   expected to be a `Record<string, unknown>` keyed by node name.\n * @returns An {@link UpdatesEventData} containing the extracted node name\n *   and its associated delta values.\n */\nfunction convertUpdatesPayload(payload: unknown): UpdatesEventData {\n  if (typeof payload !== \"object\" || payload === null) {\n    return { values: {} };\n  }\n\n  const entries = Object.entries(payload as Record<string, unknown>);\n  if (entries.length === 0) {\n    return { values: {} };\n  }\n\n  const [node, values] = entries[0];\n  return {\n    node,\n    values: (typeof values === \"object\" && values !== null\n      ? values\n      : { value: values }) as Record<string, unknown>,\n  };\n}\n"],"mappings":"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"}

package/dist/stream/convert.d.cts

@@ -0,0 +1,69 @@
+import { Namespace, ProtocolEvent } from "./types.cjs";
+import { StreamMode } from "../pregel/types.cjs";
+import { StreamChunkMeta } from "../pregel/stream.cjs";
+
+//#region src/stream/convert.d.ts
+/**
+ * The set of stream modes requested by
+ * `streamEvents(..., { version: "v3" })` — every mode the protocol maps
+ * to a channel.
+ *
+ * The verbose `"debug"` mode is intentionally excluded: it was a thin
+ * re-wrap of `checkpoints` + `tasks` carrying no new information.
+ *
+ * The `"checkpoints"` mode is likewise excluded from the stream-mode
+ * request because the protocol's `checkpoints` channel carries only a
+ * lightweight envelope (`id`, `parent_id`, `step`, `source`) derived from
+ * {@link StreamChunkMeta.checkpoint} on the adjacent `values` chunk — not
+ * the full-state shape that Pregel's `checkpoints` stream mode produces.
+ * `convertToProtocolEvent` emits a companion `checkpoints` protocol event
+ * next to each `values` event when meta is present, so clients can build
+ * branching/time-travel UIs without a full-state `checkpoints` subscription.
+ */
+declare const STREAM_EVENTS_V3_MODES: StreamMode[];
+/**
+ * Converts a raw `[ns, mode, payload, meta?]` stream chunk emitted by
+ * `graph.stream()` into one or more CDDL-aligned {@link ProtocolEvent}s.
+ *
+ * Most modes produce a single event. `values` chunks carrying
+ * {@link StreamChunkMeta.checkpoint} additionally produce a companion
+ * `checkpoints` event immediately after the `values` event, so clients
+ * that subscribe only to `checkpoints` can build a branching timeline
+ * without also paying for full-state `values` payloads, and clients that
+ * subscribe to both can correlate the pair by `(namespace, step)` or by
+ * adjacent `seq` numbers.
+ *
+ * Returns an empty array for stream modes that have no protocol mapping.
+ *
+ * @param options - Conversion inputs for a single raw stream chunk.
+ * @param options.namespace - Hierarchical namespace path identifying the
+ *   source in the agent tree.
+ * @param options.mode - The stream mode that produced this chunk (e.g.
+ *   `"messages"`, `"tools"`).
+ * @param options.payload - The raw payload emitted by the stream for this
+ *   mode.
+ * @param options.seq - Monotonically increasing sequence number assigned to
+ *   the first returned event; the companion `checkpoints` event (when
+ *   emitted) uses `seq + 1`.
+ * @param options.meta - Optional chunk-level metadata (e.g. the checkpoint
+ *   envelope paired with a `values` chunk).
+ * @returns An ordered list of {@link ProtocolEvent}s ready for downstream
+ *   reducers. Callers advance their `seq` counter by `result.length`.
+ */
+interface ConvertToProtocolEventOptions {
+  namespace: Namespace;
+  mode: StreamMode;
+  payload: unknown;
+  seq: number;
+  meta?: StreamChunkMeta;
+}
+declare function convertToProtocolEvent({
+  namespace: ns,
+  mode,
+  payload,
+  seq,
+  meta
+}: ConvertToProtocolEventOptions): ProtocolEvent[];
+//#endregion
+export { ConvertToProtocolEventOptions, STREAM_EVENTS_V3_MODES, convertToProtocolEvent };
+//# sourceMappingURL=convert.d.cts.map

package/dist/stream/convert.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert.d.cts","names":[],"sources":["../../src/stream/convert.ts"],"mappings":";;;;;;;;AAqEA;;;;;;;;;;;;;;cAtCa,sBAAA,EAAwB,UAAA;;;;AAsErC;;;;;;;;;;;;;;;;;;;;;;;;;;UAhCiB,6BAAA;EACf,SAAA,EAAW,SAAA;EACX,IAAA,EAAM,UAAA;EACN,OAAA;EACA,GAAA;EACA,IAAA,GAAO,eAAA;AAAA;AAAA,iBA2BO,sBAAA,CAAA;EACd,SAAA,EAAW,EAAA;EACX,IAAA;EACA,OAAA;EACA,GAAA;EACA;AAAA,GACC,6BAAA,GAAgC,aAAA"}

package/dist/stream/convert.d.ts

@@ -0,0 +1,69 @@
+import { Namespace, ProtocolEvent } from "./types.js";
+import { StreamMode } from "../pregel/types.js";
+import { StreamChunkMeta } from "../pregel/stream.js";
+
+//#region src/stream/convert.d.ts
+/**
+ * The set of stream modes requested by
+ * `streamEvents(..., { version: "v3" })` — every mode the protocol maps
+ * to a channel.
+ *
+ * The verbose `"debug"` mode is intentionally excluded: it was a thin
+ * re-wrap of `checkpoints` + `tasks` carrying no new information.
+ *
+ * The `"checkpoints"` mode is likewise excluded from the stream-mode
+ * request because the protocol's `checkpoints` channel carries only a
+ * lightweight envelope (`id`, `parent_id`, `step`, `source`) derived from
+ * {@link StreamChunkMeta.checkpoint} on the adjacent `values` chunk — not
+ * the full-state shape that Pregel's `checkpoints` stream mode produces.
+ * `convertToProtocolEvent` emits a companion `checkpoints` protocol event
+ * next to each `values` event when meta is present, so clients can build
+ * branching/time-travel UIs without a full-state `checkpoints` subscription.
+ */
+declare const STREAM_EVENTS_V3_MODES: StreamMode[];
+/**
+ * Converts a raw `[ns, mode, payload, meta?]` stream chunk emitted by
+ * `graph.stream()` into one or more CDDL-aligned {@link ProtocolEvent}s.
+ *
+ * Most modes produce a single event. `values` chunks carrying
+ * {@link StreamChunkMeta.checkpoint} additionally produce a companion
+ * `checkpoints` event immediately after the `values` event, so clients
+ * that subscribe only to `checkpoints` can build a branching timeline
+ * without also paying for full-state `values` payloads, and clients that
+ * subscribe to both can correlate the pair by `(namespace, step)` or by
+ * adjacent `seq` numbers.
+ *
+ * Returns an empty array for stream modes that have no protocol mapping.
+ *
+ * @param options - Conversion inputs for a single raw stream chunk.
+ * @param options.namespace - Hierarchical namespace path identifying the
+ *   source in the agent tree.
+ * @param options.mode - The stream mode that produced this chunk (e.g.
+ *   `"messages"`, `"tools"`).
+ * @param options.payload - The raw payload emitted by the stream for this
+ *   mode.
+ * @param options.seq - Monotonically increasing sequence number assigned to
+ *   the first returned event; the companion `checkpoints` event (when
+ *   emitted) uses `seq + 1`.
+ * @param options.meta - Optional chunk-level metadata (e.g. the checkpoint
+ *   envelope paired with a `values` chunk).
+ * @returns An ordered list of {@link ProtocolEvent}s ready for downstream
+ *   reducers. Callers advance their `seq` counter by `result.length`.
+ */
+interface ConvertToProtocolEventOptions {
+  namespace: Namespace;
+  mode: StreamMode;
+  payload: unknown;
+  seq: number;
+  meta?: StreamChunkMeta;
+}
+declare function convertToProtocolEvent({
+  namespace: ns,
+  mode,
+  payload,
+  seq,
+  meta
+}: ConvertToProtocolEventOptions): ProtocolEvent[];
+//#endregion
+export { ConvertToProtocolEventOptions, STREAM_EVENTS_V3_MODES, convertToProtocolEvent };
+//# sourceMappingURL=convert.d.ts.map

package/dist/stream/convert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert.d.ts","names":[],"sources":["../../src/stream/convert.ts"],"mappings":";;;;;;;;AAqEA;;;;;;;;;;;;;;cAtCa,sBAAA,EAAwB,UAAA;;;;AAsErC;;;;;;;;;;;;;;;;;;;;;;;;;;UAhCiB,6BAAA;EACf,SAAA,EAAW,SAAA;EACX,IAAA,EAAM,UAAA;EACN,OAAA;EACA,GAAA;EACA,IAAA,GAAO,eAAA;AAAA;AAAA,iBA2BO,sBAAA,CAAA;EACd,SAAA,EAAW,EAAA;EACX,IAAA;EACA,OAAA;EACA,GAAA;EACA;AAAA,GACC,6BAAA,GAAgC,aAAA"}

package/dist/stream/convert.js

@@ -0,0 +1,206 @@
+//#region src/stream/convert.ts
+/**
+* The set of stream modes requested by
+* `streamEvents(..., { version: "v3" })` — every mode the protocol maps
+* to a channel.
+*
+* The verbose `"debug"` mode is intentionally excluded: it was a thin
+* re-wrap of `checkpoints` + `tasks` carrying no new information.
+*
+* The `"checkpoints"` mode is likewise excluded from the stream-mode
+* request because the protocol's `checkpoints` channel carries only a
+* lightweight envelope (`id`, `parent_id`, `step`, `source`) derived from
+* {@link StreamChunkMeta.checkpoint} on the adjacent `values` chunk — not
+* the full-state shape that Pregel's `checkpoints` stream mode produces.
+* `convertToProtocolEvent` emits a companion `checkpoints` protocol event
+* next to each `values` event when meta is present, so clients can build
+* branching/time-travel UIs without a full-state `checkpoints` subscription.
+*/
+const STREAM_EVENTS_V3_MODES = [
+	"values",
+	"updates",
+	"messages",
+	"tools",
+	"custom",
+	"tasks"
+];
+function unwrapMessagesPayload(payload) {
+	if (!Array.isArray(payload) || payload.length !== 2) return { data: payload };
+	const [data, metadata] = payload;
+	if (metadata == null || typeof metadata !== "object") return { data: payload };
+	const record = metadata;
+	const node = typeof record.langgraph_node === "string" ? record.langgraph_node : void 0;
+	const runId = typeof record.run_id === "string" ? record.run_id : void 0;
+	return {
+		data: runId != null && data != null && typeof data === "object" ? {
+			...data,
+			run_id: runId
+		} : data,
+		node
+	};
+}
+function convertToProtocolEvent({ namespace: ns, mode, payload, seq, meta }) {
+	const timestamp = Date.now();
+	const base = { type: "event" };
+	switch (mode) {
+		case "messages": {
+			const { data, node } = unwrapMessagesPayload(payload);
+			return [{
+				...base,
+				seq,
+				method: "messages",
+				params: {
+					namespace: ns,
+					timestamp,
+					...node ? { node } : {},
+					data
+				}
+			}];
+		}
+		case "tools": return [{
+			...base,
+			seq,
+			method: "tools",
+			params: {
+				namespace: ns,
+				timestamp,
+				data: convertToolsPayload(payload)
+			}
+		}];
+		case "values": {
+			const events = [];
+			if (meta?.checkpoint != null) events.push({
+				...base,
+				seq,
+				method: "checkpoints",
+				params: {
+					namespace: ns,
+					timestamp,
+					data: meta.checkpoint
+				}
+			});
+			events.push({
+				...base,
+				seq: meta?.checkpoint != null ? seq + 1 : seq,
+				method: "values",
+				params: {
+					namespace: ns,
+					timestamp,
+					data: payload
+				}
+			});
+			return events;
+		}
+		case "updates": {
+			const data = convertUpdatesPayload(payload);
+			return [{
+				...base,
+				seq,
+				method: "updates",
+				params: {
+					namespace: ns,
+					timestamp,
+					...typeof data.node === "string" ? { node: data.node } : {},
+					data
+				}
+			}];
+		}
+		case "custom": {
+			const data = typeof payload === "object" && payload !== null && !Array.isArray(payload) && "name" in payload ? payload : { payload };
+			return [{
+				...base,
+				seq,
+				method: "custom",
+				params: {
+					namespace: ns,
+					timestamp,
+					data
+				}
+			}];
+		}
+		case "tasks": return [{
+			...base,
+			seq,
+			method: "tasks",
+			params: {
+				namespace: ns,
+				timestamp,
+				data: payload
+			}
+		}];
+		default: return [];
+	}
+}
+/**
+* Normalises a raw tools-mode payload into a typed {@link ToolsEventData}
+* discriminated union, mapping internal lifecycle events (`on_tool_start`,
+* `on_tool_end`, etc.) to their protocol counterparts.
+*
+* @param payload - The raw payload from a `"tools"` stream chunk.
+* @returns A {@link ToolsEventData} object with the appropriate `event`
+*   discriminant and associated fields.
+*/
+function convertToolsPayload(payload) {
+	if (typeof payload !== "object" || payload === null) return {
+		event: "tool-error",
+		tool_call_id: "",
+		message: "Unexpected tools payload shape"
+	};
+	const p = payload;
+	const tool_call_id = String(p.toolCallId ?? "");
+	switch (p.event) {
+		case "on_tool_start": return {
+			event: "tool-started",
+			tool_call_id,
+			tool_name: String(p.name ?? "unknown"),
+			input: p.input
+		};
+		case "on_tool_event": return {
+			event: "tool-output-delta",
+			tool_call_id,
+			delta: typeof p.data === "string" ? p.data : JSON.stringify(p.data ?? "")
+		};
+		case "on_tool_end": return {
+			event: "tool-finished",
+			tool_call_id,
+			output: p.output
+		};
+		case "on_tool_error": {
+			const err = p.error;
+			return {
+				event: "tool-error",
+				tool_call_id,
+				message: typeof err === "object" && err !== null && "message" in err && typeof err.message === "string" ? err.message : String(err ?? "unknown error")
+			};
+		}
+		default: return {
+			event: "tool-error",
+			tool_call_id: "",
+			message: `Unknown tool event: ${String(p.event)}`
+		};
+	}
+}
+/**
+* Extracts the first `{node: delta}` entry from an updates-mode payload and
+* reshapes it into an {@link UpdatesEventData} with explicit `node` and
+* `values` fields.  Non-object payloads are coerced to `{ values: {} }`.
+*
+* @param payload - The raw payload from an `"updates"` stream chunk,
+*   expected to be a `Record<string, unknown>` keyed by node name.
+* @returns An {@link UpdatesEventData} containing the extracted node name
+*   and its associated delta values.
+*/
+function convertUpdatesPayload(payload) {
+	if (typeof payload !== "object" || payload === null) return { values: {} };
+	const entries = Object.entries(payload);
+	if (entries.length === 0) return { values: {} };
+	const [node, values] = entries[0];
+	return {
+		node,
+		values: typeof values === "object" && values !== null ? values : { value: values }
+	};
+}
+//#endregion
+export { STREAM_EVENTS_V3_MODES, convertToProtocolEvent };
+
+//# sourceMappingURL=convert.js.map

package/dist/stream/convert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert.js","names":[],"sources":["../../src/stream/convert.ts"],"sourcesContent":["/**\n * Protocol event conversion — maps raw `[ns, mode, payload, meta?]` stream\n * chunks from graph.stream() to CDDL-aligned ProtocolEvents.\n */\n\nimport type { StreamMode } from \"../pregel/types.js\";\nimport type { StreamChunkMeta } from \"../pregel/stream.js\";\nimport type {\n  Namespace,\n  ProtocolEvent,\n  ToolsEventData,\n  UpdatesEventData,\n} from \"./types.js\";\n\n/**\n * The set of stream modes requested by\n * `streamEvents(..., { version: \"v3\" })` — every mode the protocol maps\n * to a channel.\n *\n * The verbose `\"debug\"` mode is intentionally excluded: it was a thin\n * re-wrap of `checkpoints` + `tasks` carrying no new information.\n *\n * The `\"checkpoints\"` mode is likewise excluded from the stream-mode\n * request because the protocol's `checkpoints` channel carries only a\n * lightweight envelope (`id`, `parent_id`, `step`, `source`) derived from\n * {@link StreamChunkMeta.checkpoint} on the adjacent `values` chunk — not\n * the full-state shape that Pregel's `checkpoints` stream mode produces.\n * `convertToProtocolEvent` emits a companion `checkpoints` protocol event\n * next to each `values` event when meta is present, so clients can build\n * branching/time-travel UIs without a full-state `checkpoints` subscription.\n */\nexport const STREAM_EVENTS_V3_MODES: StreamMode[] = [\n  \"values\",\n  \"updates\",\n  \"messages\",\n  \"tools\",\n  \"custom\",\n  \"tasks\",\n];\n\n/**\n * Converts a raw `[ns, mode, payload, meta?]` stream chunk emitted by\n * `graph.stream()` into one or more CDDL-aligned {@link ProtocolEvent}s.\n *\n * Most modes produce a single event. `values` chunks carrying\n * {@link StreamChunkMeta.checkpoint} additionally produce a companion\n * `checkpoints` event immediately after the `values` event, so clients\n * that subscribe only to `checkpoints` can build a branching timeline\n * without also paying for full-state `values` payloads, and clients that\n * subscribe to both can correlate the pair by `(namespace, step)` or by\n * adjacent `seq` numbers.\n *\n * Returns an empty array for stream modes that have no protocol mapping.\n *\n * @param options - Conversion inputs for a single raw stream chunk.\n * @param options.namespace - Hierarchical namespace path identifying the\n *   source in the agent tree.\n * @param options.mode - The stream mode that produced this chunk (e.g.\n *   `\"messages\"`, `\"tools\"`).\n * @param options.payload - The raw payload emitted by the stream for this\n *   mode.\n * @param options.seq - Monotonically increasing sequence number assigned to\n *   the first returned event; the companion `checkpoints` event (when\n *   emitted) uses `seq + 1`.\n * @param options.meta - Optional chunk-level metadata (e.g. the checkpoint\n *   envelope paired with a `values` chunk).\n * @returns An ordered list of {@link ProtocolEvent}s ready for downstream\n *   reducers. Callers advance their `seq` counter by `result.length`.\n */\nexport interface ConvertToProtocolEventOptions {\n  namespace: Namespace;\n  mode: StreamMode;\n  payload: unknown;\n  seq: number;\n  meta?: StreamChunkMeta;\n}\n\nfunction unwrapMessagesPayload(payload: unknown) {\n  if (!Array.isArray(payload) || payload.length !== 2) {\n    return { data: payload };\n  }\n\n  const [data, metadata] = payload;\n  if (metadata == null || typeof metadata !== \"object\") {\n    return { data: payload };\n  }\n\n  const record = metadata as Record<string, unknown>;\n  const node =\n    typeof record.langgraph_node === \"string\"\n      ? record.langgraph_node\n      : undefined;\n  const runId = typeof record.run_id === \"string\" ? record.run_id : undefined;\n  const dataWithRunId =\n    runId != null && data != null && typeof data === \"object\"\n      ? { ...(data as Record<string, unknown>), run_id: runId }\n      : data;\n\n  return { data: dataWithRunId, node };\n}\n\nexport function convertToProtocolEvent({\n  namespace: ns,\n  mode,\n  payload,\n  seq,\n  meta,\n}: ConvertToProtocolEventOptions): ProtocolEvent[] {\n  const timestamp = Date.now();\n  const base = { type: \"event\" as const };\n\n  switch (mode) {\n    case \"messages\": {\n      const { data, node } = unwrapMessagesPayload(payload);\n      return [\n        {\n          ...base,\n          seq,\n          method: \"messages\",\n          params: { namespace: ns, timestamp, ...(node ? { node } : {}), data },\n        },\n      ];\n    }\n\n    case \"tools\":\n      return [\n        {\n          ...base,\n          seq,\n          method: \"tools\",\n          params: {\n            namespace: ns,\n            timestamp,\n            data: convertToolsPayload(payload),\n          },\n        },\n      ];\n\n    case \"values\": {\n      // Emit the `checkpoints` event immediately BEFORE its companion\n      // `values` event so clients subscribed to both channels have the\n      // envelope buffered by the time the values payload arrives. This\n      // lets the SDK attach `parentCheckpointId` to messages extracted\n      // from the values snapshot without waiting for a second pass.\n      const events: ProtocolEvent[] = [];\n      if (meta?.checkpoint != null) {\n        events.push({\n          ...base,\n          seq,\n          method: \"checkpoints\",\n          params: { namespace: ns, timestamp, data: meta.checkpoint },\n        });\n      }\n      events.push({\n        ...base,\n        seq: meta?.checkpoint != null ? seq + 1 : seq,\n        method: \"values\",\n        params: { namespace: ns, timestamp, data: payload },\n      });\n      return events;\n    }\n\n    case \"updates\": {\n      const data = convertUpdatesPayload(payload);\n      return [\n        {\n          ...base,\n          seq,\n          method: \"updates\",\n          params: {\n            namespace: ns,\n            timestamp,\n            // Surface the completed node at the top level of `params` so\n            // transformers (notably `LifecycleTransformer`) can attribute\n            // a finished task to its child namespace without re-parsing\n            // the payload.  The same value is retained inside `data` for\n            // downstream consumers that inspect the event body.\n            ...(typeof data.node === \"string\" ? { node: data.node } : {}),\n            data,\n          },\n        },\n      ];\n    }\n\n    case \"custom\": {\n      const data =\n        typeof payload === \"object\" &&\n        payload !== null &&\n        !Array.isArray(payload) &&\n        \"name\" in payload\n          ? payload\n          : { payload };\n      return [\n        {\n          ...base,\n          seq,\n          method: \"custom\",\n          params: { namespace: ns, timestamp, data },\n        },\n      ];\n    }\n\n    case \"tasks\":\n      return [\n        {\n          ...base,\n          seq,\n          method: \"tasks\",\n          params: { namespace: ns, timestamp, data: payload },\n        },\n      ];\n\n    default:\n      return [];\n  }\n}\n\n/**\n * Normalises a raw tools-mode payload into a typed {@link ToolsEventData}\n * discriminated union, mapping internal lifecycle events (`on_tool_start`,\n * `on_tool_end`, etc.) to their protocol counterparts.\n *\n * @param payload - The raw payload from a `\"tools\"` stream chunk.\n * @returns A {@link ToolsEventData} object with the appropriate `event`\n *   discriminant and associated fields.\n */\nfunction convertToolsPayload(payload: unknown): ToolsEventData {\n  if (typeof payload !== \"object\" || payload === null) {\n    return {\n      event: \"tool-error\",\n      tool_call_id: \"\",\n      message: \"Unexpected tools payload shape\",\n    };\n  }\n\n  const p = payload as Record<string, unknown>;\n  const tool_call_id = String(p.toolCallId ?? \"\");\n\n  switch (p.event) {\n    case \"on_tool_start\":\n      return {\n        event: \"tool-started\",\n        tool_call_id,\n        tool_name: String(p.name ?? \"unknown\"),\n        input: p.input,\n      };\n\n    case \"on_tool_event\": {\n      const delta =\n        typeof p.data === \"string\" ? p.data : JSON.stringify(p.data ?? \"\");\n      return {\n        event: \"tool-output-delta\",\n        tool_call_id,\n        delta,\n      };\n    }\n\n    case \"on_tool_end\":\n      return {\n        event: \"tool-finished\",\n        tool_call_id,\n        output: p.output,\n      };\n\n    case \"on_tool_error\": {\n      const err = p.error;\n      const errMessage =\n        typeof err === \"object\" &&\n        err !== null &&\n        \"message\" in err &&\n        typeof (err as { message: unknown }).message === \"string\"\n          ? (err as { message: string }).message\n          : String(err ?? \"unknown error\");\n      return {\n        event: \"tool-error\",\n        tool_call_id,\n        message: errMessage,\n      };\n    }\n\n    default:\n      return {\n        event: \"tool-error\",\n        tool_call_id: \"\",\n        message: `Unknown tool event: ${String(p.event)}`,\n      };\n  }\n}\n\n/**\n * Extracts the first `{node: delta}` entry from an updates-mode payload and\n * reshapes it into an {@link UpdatesEventData} with explicit `node` and\n * `values` fields.  Non-object payloads are coerced to `{ values: {} }`.\n *\n * @param payload - The raw payload from an `\"updates\"` stream chunk,\n *   expected to be a `Record<string, unknown>` keyed by node name.\n * @returns An {@link UpdatesEventData} containing the extracted node name\n *   and its associated delta values.\n */\nfunction convertUpdatesPayload(payload: unknown): UpdatesEventData {\n  if (typeof payload !== \"object\" || payload === null) {\n    return { values: {} };\n  }\n\n  const entries = Object.entries(payload as Record<string, unknown>);\n  if (entries.length === 0) {\n    return { values: {} };\n  }\n\n  const [node, values] = entries[0];\n  return {\n    node,\n    values: (typeof values === \"object\" && values !== null\n      ? values\n      : { value: values }) as Record<string, unknown>,\n  };\n}\n"],"mappings":"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"}

package/dist/stream/index.cjs

@@ -0,0 +1,11 @@
+require("./stream-channel.cjs");
+require("./convert.cjs");
+require("./mux.cjs");
+require("./transformers/lifecycle.cjs");
+require("./transformers/messages.cjs");
+require("./transformers/subgraphs.cjs");
+require("./transformers/values.cjs");
+require("./transformers/index.cjs");
+require("./types.cjs");
+require("./run-stream.cjs");
+require("@langchain/core/language_models/stream");

package/dist/stream/index.d.cts

@@ -0,0 +1,12 @@
+import { AgentStatus, ChatModelStream as ChatModelStream$1, InferExtensions, InterruptPayload, LifecycleCause, LifecycleData, MessagesEventData, Namespace, NativeStreamTransformer, ProtocolEvent, StreamEmitter, StreamTransformer, ToolCallStatus, ToolCallStream, ToolsEventData, UpdatesEventData, UsageInfo, isNativeTransformer } from "./types.cjs";
+import { StreamChannel } from "./stream-channel.cjs";
+import { ConvertToProtocolEventOptions, STREAM_EVENTS_V3_MODES, convertToProtocolEvent } from "./convert.cjs";
+import { REJECT_VALUES, RESOLVE_VALUES, StreamHandle, StreamMux, SubgraphDiscovery } from "./mux.cjs";
+import { LifecycleEntry, LifecycleTransformerOptions } from "./transformers/types.cjs";
+import { LifecycleProjection, createLifecycleTransformer, filterLifecycleEntries } from "./transformers/lifecycle.cjs";
+import { createMessagesTransformer } from "./transformers/messages.cjs";
+import { SubgraphDiscoveryProjection, SubgraphDiscoveryTransformerOptions, createSubgraphDiscoveryTransformer, filterSubgraphHandles } from "./transformers/subgraphs.cjs";
+import { createValuesTransformer } from "./transformers/values.cjs";
+import { CreateGraphRunStreamOptions, GraphRunStream, SET_LIFECYCLE_ITERABLE, SET_MESSAGES_ITERABLE, SET_VALUES_LOG, SubgraphRunStream, createGraphRunStream } from "./run-stream.cjs";
+import { ChatModelStream as ChatModelStreamImpl } from "@langchain/core/language_models/stream";
+export { ChatModelStreamImpl };

package/dist/stream/index.d.ts

@@ -0,0 +1,12 @@
+import { AgentStatus, ChatModelStream as ChatModelStream$1, InferExtensions, InterruptPayload, LifecycleCause, LifecycleData, MessagesEventData, Namespace, NativeStreamTransformer, ProtocolEvent, StreamEmitter, StreamTransformer, ToolCallStatus, ToolCallStream, ToolsEventData, UpdatesEventData, UsageInfo, isNativeTransformer } from "./types.js";
+import { StreamChannel } from "./stream-channel.js";
+import { ConvertToProtocolEventOptions, STREAM_EVENTS_V3_MODES, convertToProtocolEvent } from "./convert.js";
+import { REJECT_VALUES, RESOLVE_VALUES, StreamHandle, StreamMux, SubgraphDiscovery } from "./mux.js";
+import { LifecycleEntry, LifecycleTransformerOptions } from "./transformers/types.js";
+import { LifecycleProjection, createLifecycleTransformer, filterLifecycleEntries } from "./transformers/lifecycle.js";
+import { createMessagesTransformer } from "./transformers/messages.js";
+import { SubgraphDiscoveryProjection, SubgraphDiscoveryTransformerOptions, createSubgraphDiscoveryTransformer, filterSubgraphHandles } from "./transformers/subgraphs.js";
+import { createValuesTransformer } from "./transformers/values.js";
+import { CreateGraphRunStreamOptions, GraphRunStream, SET_LIFECYCLE_ITERABLE, SET_MESSAGES_ITERABLE, SET_VALUES_LOG, SubgraphRunStream, createGraphRunStream } from "./run-stream.js";
+import { ChatModelStream as ChatModelStreamImpl } from "@langchain/core/language_models/stream";
+export { ChatModelStreamImpl };

package/dist/stream/index.js

@@ -0,0 +1,12 @@
+import "./stream-channel.js";
+import "./convert.js";
+import "./mux.js";
+import "./transformers/lifecycle.js";
+import "./transformers/messages.js";
+import "./transformers/subgraphs.js";
+import "./transformers/values.js";
+import "./transformers/index.js";
+import "./types.js";
+import "./run-stream.js";
+import { ChatModelStream as ChatModelStreamImpl } from "@langchain/core/language_models/stream";
+export { ChatModelStreamImpl };