@langchain/langgraph-api 1.3.0 → 1.4.0

package/dist/api/assistants.mjs

@@ -1,6 +1,6 @@
 import { zValidator } from "@hono/zod-validator";
 import { Hono } from "hono";
-import { v7 as uuid } from "uuid";
+import { v7 as uuid } from "@langchain/core/utils/uuid";
 import { z } from "zod/v3";
 import { getAssistantId, getCachedStaticGraphSchema, getGraph, } from "../graph/load.mjs";
 import { getRuntimeGraphSchema } from "../graph/parser/index.mjs";

package/dist/api/protocol.mjs

@@ -1,7 +1,7 @@
 import { zValidator } from "@hono/zod-validator";
 import { Hono } from "hono";
 import { streamSSE } from "hono/streaming";
-import { v7 as uuid7 } from "uuid";
+import { v7 as uuid7 } from "@langchain/core/utils/uuid";
 import { z } from "zod/v3";
 import { ProtocolService } from "../protocol/service.mjs";
 import { jsonExtra } from "../utils/hono.mjs";

package/dist/api/runs.mjs

@@ -2,7 +2,7 @@ import { zValidator } from "@hono/zod-validator";
 import { Hono } from "hono";
 import { HTTPException } from "hono/http-exception";
 import { streamSSE } from "hono/streaming";
-import { v7 as uuid7 } from "uuid";
+import { v7 as uuid7 } from "@langchain/core/utils/uuid";
 import { z } from "zod/v3";
 import { getAssistantId } from "../graph/load.mjs";
 import { logError, logger } from "../logging.mjs";

package/dist/api/threads.mjs

@@ -1,6 +1,6 @@
 import { zValidator } from "@hono/zod-validator";
 import { Hono } from "hono";
-import { v7 as uuid7 } from "uuid";
+import { v7 as uuid7 } from "@langchain/core/utils/uuid";
 import { z } from "zod/v3";
 import * as schemas from "../schemas.mjs";
 import { stateSnapshotToThreadState } from "../state.mjs";

package/dist/experimental/embed/protocol.mjs

@@ -1,6 +1,6 @@
 import { zValidator } from "@hono/zod-validator";
 import { streamSSE } from "hono/streaming";
-import { v7 as uuidv7 } from "uuid";
+import { v7 as uuidv7 } from "@langchain/core/utils/uuid";
 import { z } from "zod/v3";
 import { streamState } from "../../stream.mjs";
 import { serialiseAsDict } from "../../utils/serde.mjs";
@@ -298,11 +298,31 @@ export function registerProtocolRoutes(api, context, upgradeWebSocket) {
                 message: "Thread has no active assistant; call run.start first.",
             });
         }
+        // `update` / `goto` are the optional state mutation and directed jump
+        // the SDK's `respond({ update, goto })` forwards on `input.respond`
+        // (`InputRespondOne` / `InputRespondMany`). Fold them into the same
+        // `Command(resume, update, goto)` as the resume so the resumed run
+        // produces a single checkpoint reflecting all of them — the HITL
+        // "push card into state + resume" flow. Read leniently (update: object
+        // or `[key, value][]` tuples; goto: node name, Send object, or a list
+        // of either), same posture as `config` / `metadata`.
+        const update = isRecord(params.update) || Array.isArray(params.update)
+            ? params.update
+            : undefined;
+        const goto = typeof params.goto === "string" ||
+            Array.isArray(params.goto) ||
+            isRecord(params.goto)
+            ? params.goto
+            : undefined;
         const run = createStubRun(thread.threadId, {
             assistant_id: assistantId,
             on_disconnect: "cancel",
             input: null,
-            command: { resume: resumeInput },
+            command: {
+                resume: resumeInput,
+                ...(update != null ? { update } : {}),
+                ...(goto != null ? { goto } : {}),
+            },
             // Carry the SDK's `respond({ config, metadata })` onto the resumed
             // run so it applies the same run config / metadata a fresh
             // `run.start` would (both are part of the `input.respond` params).

package/dist/experimental/embed/runs.mjs

@@ -1,6 +1,6 @@
 import { zValidator } from "@hono/zod-validator";
 import { streamSSE } from "hono/streaming";
-import { v7 as uuidv7 } from "uuid";
+import { v7 as uuidv7 } from "@langchain/core/utils/uuid";
 import { z } from "zod/v3";
 import * as schemas from "../../schemas.mjs";
 import { streamState } from "../../stream.mjs";

package/dist/experimental/embed/threads.mjs

@@ -1,5 +1,5 @@
 import { zValidator } from "@hono/zod-validator";
-import { v7 as uuidv7 } from "uuid";
+import { v7 as uuidv7 } from "@langchain/core/utils/uuid";
 import { z } from "zod/v3";
 import * as schemas from "../../schemas.mjs";
 import { jsonExtra } from "../../utils/hono.mjs";

package/dist/experimental/embed/utils.mjs

@@ -1,4 +1,4 @@
-import { v7 as uuidv7 } from "uuid";
+import { v7 as uuidv7 } from "@langchain/core/utils/uuid";
 import { z } from "zod/v3";
 export const ProtocolCommandSchema = z.object({
     id: z.number().int().nonnegative(),

package/dist/graph/load.mjs

@@ -1,5 +1,5 @@
 import { z } from "zod/v3";
-import * as uuid from "uuid";
+import * as uuid from "@langchain/core/utils/uuid";
 import { HTTPException } from "hono/http-exception";
 import { resolveGraph } from "./load.utils.mjs";
 import { getStaticGraphSchema } from "./parser/index.mjs";

package/dist/graph/load.utils.mjs

@@ -1,4 +1,4 @@
-import * as uuid from "uuid";
+import * as uuid from "@langchain/core/utils/uuid";
 import * as path from "node:path";
 import * as fs from "node:fs/promises";
 import { pathToFileURL } from "node:url";

package/dist/protocol/service.mjs

@@ -1,5 +1,5 @@
 import { inferChannel, isPrefixMatch } from "@langchain/langgraph/stream";
-import { v7 as uuid7 } from "uuid";
+import { v7 as uuid7 } from "@langchain/core/utils/uuid";
 import { getAssistantId } from "../graph/load.mjs";
 import { PROTOCOL_STREAM_RUN_KEY } from "./constants.mjs";
 import { RunProtocolSession } from "./session/index.mjs";
@@ -267,9 +267,26 @@ export class ProtocolService {
         // context, …) and metadata (trigger source, test flags, …) a fresh
         // `run.start` would. Read them leniently — same posture as
         // `normalizeRunStart`.
+        // `update` / `goto` are the optional state mutation and directed jump
+        // applied in the same superstep as the resume (`InputRespondOne` /
+        // `InputRespondMany`). The SDK's `respond({ update, goto })` forwards them
+        // on the `input.respond` command; they are folded into
+        // `Command(resume, update, goto)` by `createOrResumeRun`. Read leniently
+        // (update: object or [key, value][] tuples; goto: node name, Send object,
+        // or a list of either) — same posture as `config` / `metadata`.
+        const update = isRecord(rawParams.update) || Array.isArray(rawParams.update)
+            ? rawParams.update
+            : undefined;
+        const goto = typeof rawParams.goto === "string" ||
+            Array.isArray(rawParams.goto) ||
+            isRecord(rawParams.goto)
+            ? rawParams.goto
+            : undefined;
         await this.createOrResumeRun(record, {
             assistant_id: record.assistantId,
             input: resumeInput,
+            update,
+            goto,
             config: isRecord(rawParams.config) ? rawParams.config : undefined,
             metadata: isRecord(rawParams.metadata) ? rawParams.metadata : undefined,
         });
@@ -313,7 +330,16 @@ export class ProtocolService {
             assistant_id: assistantId,
             input: isResume ? null : params.input,
             command: isResume
-                ? { resume: params.input }
+                ? {
+                    resume: params.input,
+                    // Apply an optional state update and/or directed jump in the
+                    // same superstep as the resume (HITL "push card into state +
+                    // resume" flows, or resume-and-redirect). Mapped straight onto
+                    // LangGraph's `Command(resume, update, goto)`, so the resumed
+                    // run produces a single checkpoint reflecting all of them.
+                    ...(params.update != null ? { update: params.update } : {}),
+                    ...(params.goto != null ? { goto: params.goto } : {}),
+                }
                 : undefined,
             config: runConfig,
             metadata: params.metadata,

package/dist/protocol/session/index.mjs

@@ -1,5 +1,5 @@
 import { inferChannel, isSupportedChannel } from "@langchain/langgraph/stream";
-import { v7 as uuid7 } from "uuid";
+import { v7 as uuid7 } from "@langchain/core/utils/uuid";
 import { serialiseAsDict, serializeError } from "../../utils/serde.mjs";
 import { normalizeInputRequestedData, normalizeToolData, stripInterruptsFromValues, toLifecycleStatus, } from "./event-normalizers.mjs";
 import { isRecord } from "./internal-types.mjs";

package/dist/protocol/session/state-normalizers.mjs

@@ -357,6 +357,15 @@ export const normalizeProtocolStateMessage = (value) => {
     if (typeof value.name === "string") {
         message.name = value.name;
     }
+    // Preserve `response_metadata` when present. It is a first-class protocol
+    // message field, and HITL flows rely on it: an interrupt's card is carried
+    // on `AIMessage.response_metadata` (e.g. `{ cards: ... }`) and the frontend
+    // pushes that message into state via `respond(decision, { update })`. We
+    // only forward a non-empty record to keep the common (empty) case minimal.
+    if (isRecord(value.response_metadata) &&
+        Object.keys(value.response_metadata).length > 0) {
+        message.response_metadata = value.response_metadata;
+    }
     if ((type === "ai" || type === "human") &&
         typeof value.example === "boolean") {
         message.example = value.example;

package/dist/storage/ops.mjs

@@ -1,5 +1,5 @@
 import { HTTPException } from "hono/http-exception";
-import { v7 as uuid7, v5 as uuid5 } from "uuid";
+import { v7 as uuid7, v5 as uuid5 } from "@langchain/core/utils/uuid";
 import { handleAuthEvent, isAuthMatching } from "../auth/index.mjs";
 import { getLangGraphCommand } from "../command.mjs";
 import { getGraph, NAMESPACE_GRAPH } from "../graph/load.mjs";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@langchain/langgraph-api",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "type": "module",
   "engines": {
     "node": "^18.19.0 || >=20.16.0"
@@ -55,29 +55,28 @@
     "@hono/node-server": "^1.19.13",
     "@hono/node-ws": "^1.3.0",
     "@hono/zod-validator": "^0.7.6",
-    "@langchain/protocol": "^0.0.16",
+    "@langchain/protocol": "^0.0.18",
     "@types/json-schema": "^7.0.15",
     "@typescript/vfs": "^1.6.0",
     "dedent": "^1.5.3",
     "dotenv": "^16.4.7",
     "exit-hook": "^4.0.0",
-    "hono": "^4.12.21",
+    "hono": "^4.12.25",
     "langsmith": ">=0.5.19 <1.0.0",
     "open": "^10.1.0",
     "semver": "^7.7.1",
     "stacktrace-parser": "^0.1.10",
     "superjson": "^2.2.2",
     "tsx": "^4.19.3",
-    "uuid": "^14.0.0",
     "winston": "^3.17.0",
     "winston-console-format": "^1.0.8",
     "zod": "^3.25.76 || ^4",
-    "@langchain/langgraph-ui": "1.3.0"
+    "@langchain/langgraph-ui": "1.4.0"
   },
   "peerDependencies": {
     "@langchain/core": "^1.1.48",
     "@langchain/langgraph": "^1.3.6",
-    "@langchain/langgraph-checkpoint": "~0.0.16 || ^0.1.0 || ~1.0.0",
+    "@langchain/langgraph-checkpoint": "~0.0.16 || ^0.1.0 || ^1.0.0",
     "@langchain/langgraph-sdk": "^1.9.3-rc.0",
     "typescript": "^5.5.4"
   },
@@ -87,23 +86,22 @@
     }
   },
   "devDependencies": {
-    "@langchain/core": "^1.1.48",
+    "@langchain/core": "^1.2.1",
     "@types/babel__code-frame": "^7.0.6",
     "@types/node": "^18.15.11",
     "@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",
+    "deepagents": "^1.10.5",
     "jose": "^6.0.10",
-    "langchain": "^1.4.4",
+    "langchain": "^1.5.1",
     "postgres": "^3.4.5",
     "typescript": "^4.9.5 || ^5.4.5",
     "vitest": "^4.1.0",
     "wait-port": "^1.1.0",
-    "@langchain/langgraph": "1.3.7",
-    "@langchain/langgraph-checkpoint": "1.0.4",
-    "@langchain/langgraph-sdk": "1.9.19"
+    "@langchain/langgraph": "1.4.5",
+    "@langchain/langgraph-checkpoint": "1.1.2",
+    "@langchain/langgraph-sdk": "1.9.24"
   },
   "scripts": {
     "clean": "rm -rf dist/ .turbo/ ./tests/graphs/.langgraph_api/ ./tests/protocol-v2/graphs/.langgraph_api/",