@langchain/langgraph-api 1.2.4 → 1.2.5

package/dist/protocol/session/index.mjs

@@ -305,15 +305,20 @@ export class RunProtocolSession {
             case "tools":
                 await this.pushEvent(this.createEvent("tools", namespace, normalizeToolData(event.data, event.id ?? uuid7())));
                 return;
-            default:
-                // Route unknown methods as named custom events. This allows
-                // reducers to emit("a2a", data) and have it appear on the
-                // custom channel with name set for client-side filtering.
+            default: {
+                // Route unknown methods as named custom events. Extension
+                // StreamChannels emit `custom:<name>` on the wire (matching
+                // Python's mux); strip the prefix so `custom:<name>`
+                // subscriptions match on `data.name === <name>`.
+                const channelName = method.startsWith("custom:")
+                    ? method.slice("custom:".length)
+                    : method;
                 await this.pushEvent(this.createEvent("custom", namespace, {
-                    name: method,
+                    name: channelName,
                     payload: event.data,
                 }));
                 return;
+            }
         }
     }
     /**
@@ -367,8 +372,21 @@ export class RunProtocolSession {
                 await this.pushEvent(this.createEvent("checkpoints", namespace, data));
                 return true;
             }
-            default:
-                return false;
+            default: {
+                if (!method.startsWith("custom:")) {
+                    return false;
+                }
+                const channelName = method.slice("custom:".length);
+                if (!channelName) {
+                    return false;
+                }
+                await this.ensureNamespaces(namespace);
+                await this.pushEvent(this.createEvent("custom", namespace, {
+                    name: channelName,
+                    payload: data,
+                }));
+                return true;
+            }
         }
     }
     /**

package/dist/stream.mjs

@@ -1,6 +1,6 @@
 import { isBaseMessage } from "@langchain/core/messages";
 import { LangChainTracer } from "@langchain/core/tracers/tracer_langchain";
-import { convertToProtocolEvent, STREAM_EVENTS_V3_MODES, } from "@langchain/langgraph/web";
+import { convertToProtocolEvent, isCheckpointEnvelope, STREAM_EVENTS_V3_MODES, } from "@langchain/langgraph/web";
 import { Client as LangSmithClient, getDefaultProjectName } from "langsmith";
 import { getLangGraphCommand } from "./command.mjs";
 import { PROTOCOL_STREAM_RUN_KEY } from "./protocol/constants.mjs";
@@ -136,14 +136,10 @@ export async function* streamState(run, options) {
             continue;
         if (event.event === "on_chain_stream" &&
             (kwargs.subgraphs || event.run_id === run.run_id)) {
-            // Pregel's stream tuple is `[ns, mode, payload, meta?]` (4th element
-            // is the optional `StreamChunkMeta`, preserved when streaming with
-            // `subgraphs: true`). The meta carries the lightweight checkpoint
-            // envelope attached by `_emitValuesWithCheckpointMeta`, which we
-            // forward as a companion `checkpoints` source event below.
+            // Pregel stream chunks are `[ns, mode, payload]`. Lightweight checkpoint
+            // envelopes arrive as a separate `checkpoints` chunk before `values`.
             const rawTuple = (kwargs.subgraphs ? event.data.chunk : [null, ...event.data.chunk]);
             const [ns, mode, chunk] = rawTuple;
-            const chunkMeta = rawTuple[3];
             let data = chunk;
             if (mode === "debug") {
                 const debugChunk = chunk;
@@ -159,9 +155,26 @@ export async function* streamState(run, options) {
                 }
             }
             else if (mode === "checkpoints") {
-                const debugCheckpoint = preprocessDebugCheckpoint(chunk);
+                if (isCheckpointEnvelope(chunk)) {
+                    // Lightweight envelopes pair with `values` on the v3 path.
+                    // Legacy `checkpoints` stream mode consumers expect full debug
+                    // snapshots (`values` / `metadata` / `next`) from `mapDebugCheckpoint`.
+                    if (!userStreamMode.includes("checkpoints")) {
+                        const sseEvent = kwargs.subgraphs && ns?.length
+                            ? `checkpoints|${ns.join("|")}`
+                            : "checkpoints";
+                        yield { event: sseEvent, data: chunk };
+                    }
+                    continue;
+                }
+                const debugPayload = chunk;
+                const debugCheckpoint = preprocessDebugCheckpoint(debugPayload);
                 options?.onCheckpoint?.(debugCheckpoint);
-                data = debugCheckpoint;
+                data = {
+                    values: debugPayload.values,
+                    metadata: debugPayload.metadata,
+                    next: debugPayload.next,
+                };
             }
             else if (mode === "tasks") {
                 const debugTask = preprocessDebugCheckpointTask(chunk);
@@ -170,20 +183,6 @@ export async function* streamState(run, options) {
                 }
                 data = debugTask;
             }
-            // Emit the lightweight checkpoint envelope as a dedicated
-            // `checkpoints` source event immediately BEFORE the companion
-            // `values` event so clients subscribed to both channels have the
-            // envelope buffered by the time the values payload arrives
-            // (`useMessageMetadata(msg.id).parentCheckpointId` for fork /
-            // edit flows). Clients that only want fork / time-travel metadata
-            // subscribe to `checkpoints` alone and avoid the full-state
-            // payload.
-            if (mode === "values" && chunkMeta?.checkpoint != null) {
-                const sseEvent = kwargs.subgraphs && ns?.length
-                    ? `checkpoints|${ns.join("|")}`
-                    : "checkpoints";
-                yield { event: sseEvent, data: chunkMeta.checkpoint };
-            }
             if (mode === "messages") {
                 if (userStreamMode.includes("messages-tuple")) {
                     if (kwargs.subgraphs && ns?.length) {
@@ -270,13 +269,12 @@ async function* fallbackProtocolStreamFromGraphStream(graph, input, options) {
     let seq = 0;
     const stream = await graph.stream(input, options);
     for await (const tuple of stream) {
-        const [namespace, mode, payload, meta] = tuple;
+        const [namespace, mode, payload] = tuple;
         const events = convertToProtocolEvent({
             namespace: namespace ?? [],
             mode,
             payload,
             seq,
-            meta: meta,
         });
         seq += events.length;
         for (const event of events) {
@@ -411,6 +409,7 @@ export async function* streamStateV2(run, options) {
         const normalized = mode === "tools" ||
             mode === "updates" ||
             mode === "custom" ||
+            mode.startsWith("custom:") ||
             mode === "messages" ||
             mode === "checkpoints" ||
             mode === "lifecycle";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@langchain/langgraph-api",
-  "version": "1.2.4",
+  "version": "1.2.5",
   "type": "module",
   "engines": {
     "node": "^18.19.0 || >=20.16.0"
@@ -61,7 +61,7 @@
     "dedent": "^1.5.3",
     "dotenv": "^16.4.7",
     "exit-hook": "^4.0.0",
-    "hono": "^4.12.18",
+    "hono": "^4.12.21",
     "langsmith": ">=0.5.19 <1.0.0",
     "open": "^10.1.0",
     "semver": "^7.7.1",
@@ -72,10 +72,10 @@
     "winston": "^3.17.0",
     "winston-console-format": "^1.0.8",
     "zod": "^3.25.76 || ^4",
-    "@langchain/langgraph-ui": "1.2.4"
+    "@langchain/langgraph-ui": "1.2.5"
   },
   "peerDependencies": {
-    "@langchain/core": "^1.1.44",
+    "@langchain/core": "^1.1.48",
     "@langchain/langgraph": "^0.2.57 || ^0.3.0 || ^0.4.0 || ^1.0.0-alpha || ^1.0.0 || ^1.3.1-rc.0",
     "@langchain/langgraph-checkpoint": "~0.0.16 || ^0.1.0 || ~1.0.0",
     "@langchain/langgraph-sdk": "^1.9.3-rc.0",
@@ -87,23 +87,23 @@
     }
   },
   "devDependencies": {
-    "@langchain/core": "^1.1.44",
+    "@langchain/core": "^1.1.48",
     "@types/babel__code-frame": "^7.0.6",
     "@types/node": "^18.15.11",
-    "@types/react": "^19.0.8",
+    "@types/react": "^19.2.16",
     "@types/react-dom": "^19.0.3",
     "@types/semver": "^7.7.0",
     "@types/uuid": "^10.0.0",
     "deepagents": "^1.9.0",
     "jose": "^6.0.10",
-    "langchain": "^1.2.30",
+    "langchain": "^1.4.4",
     "postgres": "^3.4.5",
     "typescript": "^4.9.5 || ^5.4.5",
     "vitest": "^3.2.4",
     "wait-port": "^1.1.0",
-    "@langchain/langgraph": "1.3.3",
+    "@langchain/langgraph": "1.3.6",
     "@langchain/langgraph-checkpoint": "1.0.4",
-    "@langchain/langgraph-sdk": "1.9.11"
+    "@langchain/langgraph-sdk": "1.9.17"
   },
   "scripts": {
     "clean": "rm -rf dist/ .turbo/ ./tests/graphs/.langgraph_api/ ./tests/protocol-v2/graphs/.langgraph_api/",