@langchain/langgraph-api 1.1.17 → 1.2.1

package/dist/schemas.d.mts

@@ -334,25 +334,25 @@ export declare const Cron: z.ZodObject<{
     updated_at: z.ZodString;
     payload: z.ZodObject<{}, "strip", z.ZodAny, z.objectOutputType<{}, z.ZodAny, "strip">, z.objectInputType<{}, z.ZodAny, "strip">>;
 }, "strip", z.ZodTypeAny, {
+    thread_id: string;
     created_at: string;
     updated_at: string;
-    thread_id: string;
-    cron_id: string;
-    end_time: string;
-    schedule: string;
     payload: {} & {
         [k: string]: any;
     };
-}, {
-    created_at: string;
-    updated_at: string;
-    thread_id: string;
     cron_id: string;
     end_time: string;
     schedule: string;
+}, {
+    thread_id: string;
+    created_at: string;
+    updated_at: string;
     payload: {} & {
         [k: string]: any;
     };
+    cron_id: string;
+    end_time: string;
+    schedule: string;
 }>;
 export declare const CheckpointSchema: z.ZodObject<{
     checkpoint_id: z.ZodOptional<z.ZodString>;
@@ -419,8 +419,9 @@ export declare const CronCreate: z.ZodObject<{
     interrupt_after: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["*"]>, z.ZodArray<z.ZodString, "many">]>>;
     multitask_strategy: z.ZodOptional<z.ZodEnum<["reject", "rollback", "interrupt", "enqueue"]>>;
 }, "strip", z.ZodTypeAny, {
-    assistant_id: string;
     thread_id: string;
+    assistant_id: string;
+    input?: z.objectOutputType<{}, z.ZodAny, "strip">[] | z.objectOutputType<{}, z.ZodAny, "strip"> | undefined;
     context?: unknown;
     config?: z.objectOutputType<{
         tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -437,15 +438,15 @@ export declare const CronCreate: z.ZodObject<{
         }, z.ZodUnknown, "strip">>>;
     }, z.ZodUnknown, "strip"> | undefined;
     metadata?: z.objectOutputType<{}, z.ZodAny, "strip"> | undefined;
-    input?: z.objectOutputType<{}, z.ZodAny, "strip">[] | z.objectOutputType<{}, z.ZodAny, "strip"> | undefined;
     interrupt_before?: string[] | "*" | undefined;
     interrupt_after?: string[] | "*" | undefined;
     webhook?: string | undefined;
     checkpoint_id?: string | undefined;
     multitask_strategy?: "reject" | "rollback" | "interrupt" | "enqueue" | undefined;
 }, {
-    assistant_id: string;
     thread_id: string;
+    assistant_id: string;
+    input?: z.objectInputType<{}, z.ZodAny, "strip">[] | z.objectInputType<{}, z.ZodAny, "strip"> | undefined;
     context?: unknown;
     config?: z.objectInputType<{
         tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -462,7 +463,6 @@ export declare const CronCreate: z.ZodObject<{
         }, z.ZodUnknown, "strip">>>;
     }, z.ZodUnknown, "strip"> | undefined;
     metadata?: z.objectInputType<{}, z.ZodAny, "strip"> | undefined;
-    input?: z.objectInputType<{}, z.ZodAny, "strip">[] | z.objectInputType<{}, z.ZodAny, "strip"> | undefined;
     interrupt_before?: string[] | "*" | undefined;
     interrupt_after?: string[] | "*" | undefined;
     webhook?: string | undefined;
@@ -475,13 +475,13 @@ export declare const CronSearch: z.ZodObject<{
     limit: z.ZodOptional<z.ZodNumber>;
     offset: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
-    assistant_id?: string | undefined;
     thread_id?: string | undefined;
+    assistant_id?: string | undefined;
     limit?: number | undefined;
     offset?: number | undefined;
 }, {
-    assistant_id?: string | undefined;
     thread_id?: string | undefined;
+    assistant_id?: string | undefined;
     limit?: number | undefined;
     offset?: number | undefined;
 }>;
@@ -523,29 +523,29 @@ export declare const Run: z.ZodObject<{
     kwargs: z.ZodObject<{}, "strip", z.ZodAny, z.objectOutputType<{}, z.ZodAny, "strip">, z.objectInputType<{}, z.ZodAny, "strip">>;
     multitask_strategy: z.ZodEnum<["reject", "rollback", "interrupt", "enqueue"]>;
 }, "strip", z.ZodTypeAny, {
-    status: "error" | "interrupted" | "pending" | "running" | "success" | "timeout";
+    run_id: string;
+    thread_id: string;
+    status: "success" | "error" | "running" | "interrupted" | "pending" | "timeout";
     assistant_id: string;
     created_at: string;
     updated_at: string;
     metadata: {} & {
         [k: string]: any;
     };
-    thread_id: string;
-    run_id: string;
     multitask_strategy: "reject" | "rollback" | "interrupt" | "enqueue";
     kwargs: {} & {
         [k: string]: any;
     };
 }, {
-    status: "error" | "interrupted" | "pending" | "running" | "success" | "timeout";
+    run_id: string;
+    thread_id: string;
+    status: "success" | "error" | "running" | "interrupted" | "pending" | "timeout";
     assistant_id: string;
     created_at: string;
     updated_at: string;
     metadata: {} & {
         [k: string]: any;
     };
-    thread_id: string;
-    run_id: string;
     multitask_strategy: "reject" | "rollback" | "interrupt" | "enqueue";
     kwargs: {} & {
         [k: string]: any;
@@ -574,8 +574,8 @@ export declare const CommandSchema: z.ZodObject<{
     update: z.ZodOptional<z.ZodUnion<[z.ZodRecord<z.ZodString, z.ZodUnknown>, z.ZodArray<z.ZodTuple<[z.ZodString, z.ZodUnknown], null>, "many">]>>;
     resume: z.ZodOptional<z.ZodUnknown>;
 }, "strip", z.ZodTypeAny, {
-    resume?: unknown;
     update?: Record<string, unknown> | [string, unknown][] | undefined;
+    resume?: unknown;
     goto?: string | {
         node: string;
         input?: unknown;
@@ -584,8 +584,8 @@ export declare const CommandSchema: z.ZodObject<{
         input?: unknown;
     })[] | undefined;
 }, {
-    resume?: unknown;
     update?: Record<string, unknown> | [string, unknown][] | undefined;
+    resume?: unknown;
     goto?: string | {
         node: string;
         input?: unknown;
@@ -644,8 +644,8 @@ export declare const RunCreate: z.ZodObject<{
         update: z.ZodOptional<z.ZodUnion<[z.ZodRecord<z.ZodString, z.ZodUnknown>, z.ZodArray<z.ZodTuple<[z.ZodString, z.ZodUnknown], null>, "many">]>>;
         resume: z.ZodOptional<z.ZodUnknown>;
     }, "strip", z.ZodTypeAny, {
-        resume?: unknown;
         update?: Record<string, unknown> | [string, unknown][] | undefined;
+        resume?: unknown;
         goto?: string | {
             node: string;
             input?: unknown;
@@ -654,8 +654,8 @@ export declare const RunCreate: z.ZodObject<{
             input?: unknown;
         })[] | undefined;
     }, {
-        resume?: unknown;
         update?: Record<string, unknown> | [string, unknown][] | undefined;
+        resume?: unknown;
         goto?: string | {
             node: string;
             input?: unknown;
@@ -731,6 +731,7 @@ export declare const RunCreate: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     assistant_id: string;
     on_disconnect: "cancel" | "continue";
+    input?: unknown;
     context?: unknown;
     config?: z.objectOutputType<{
         tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -747,10 +748,9 @@ export declare const RunCreate: z.ZodObject<{
         }, z.ZodUnknown, "strip">>>;
     }, z.ZodUnknown, "strip"> | undefined;
     metadata?: z.objectOutputType<{}, z.ZodAny, "strip"> | undefined;
-    input?: unknown;
     command?: {
-        resume?: unknown;
         update?: Record<string, unknown> | [string, unknown][] | undefined;
+        resume?: unknown;
         goto?: string | {
             node: string;
             input?: unknown;
@@ -759,7 +759,7 @@ export declare const RunCreate: z.ZodObject<{
             input?: unknown;
         })[] | undefined;
     } | undefined;
-    stream_mode?: "values" | "debug" | "messages" | "messages-tuple" | "custom" | "updates" | "events" | "tasks" | "checkpoints" | "tools" | ("values" | "debug" | "messages" | "messages-tuple" | "custom" | "updates" | "events" | "tasks" | "checkpoints" | "tools")[] | undefined;
+    stream_mode?: "values" | "updates" | "messages" | "tools" | "checkpoints" | "tasks" | "custom" | "debug" | "messages-tuple" | "events" | ("values" | "updates" | "messages" | "tools" | "checkpoints" | "tasks" | "custom" | "debug" | "messages-tuple" | "events")[] | undefined;
     interrupt_before?: string[] | "*" | undefined;
     interrupt_after?: string[] | "*" | undefined;
     webhook?: string | undefined;
@@ -782,6 +782,7 @@ export declare const RunCreate: z.ZodObject<{
     } | undefined;
 }, {
     assistant_id: string;
+    input?: unknown;
     context?: unknown;
     config?: z.objectInputType<{
         tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -798,10 +799,9 @@ export declare const RunCreate: z.ZodObject<{
         }, z.ZodUnknown, "strip">>>;
     }, z.ZodUnknown, "strip"> | undefined;
     metadata?: z.objectInputType<{}, z.ZodAny, "strip"> | undefined;
-    input?: unknown;
     command?: {
-        resume?: unknown;
         update?: Record<string, unknown> | [string, unknown][] | undefined;
+        resume?: unknown;
         goto?: string | {
             node: string;
             input?: unknown;
@@ -810,7 +810,7 @@ export declare const RunCreate: z.ZodObject<{
             input?: unknown;
         })[] | undefined;
     } | undefined;
-    stream_mode?: "values" | "debug" | "messages" | "messages-tuple" | "custom" | "updates" | "events" | "tasks" | "checkpoints" | "tools" | ("values" | "debug" | "messages" | "messages-tuple" | "custom" | "updates" | "events" | "tasks" | "checkpoints" | "tools")[] | undefined;
+    stream_mode?: "values" | "updates" | "messages" | "tools" | "checkpoints" | "tasks" | "custom" | "debug" | "messages-tuple" | "events" | ("values" | "updates" | "messages" | "tools" | "checkpoints" | "tasks" | "custom" | "debug" | "messages-tuple" | "events")[] | undefined;
     interrupt_before?: string[] | "*" | undefined;
     interrupt_after?: string[] | "*" | undefined;
     webhook?: string | undefined;
@@ -873,8 +873,8 @@ export declare const RunBatchCreate: z.ZodArray<z.ZodObject<{
         update: z.ZodOptional<z.ZodUnion<[z.ZodRecord<z.ZodString, z.ZodUnknown>, z.ZodArray<z.ZodTuple<[z.ZodString, z.ZodUnknown], null>, "many">]>>;
         resume: z.ZodOptional<z.ZodUnknown>;
     }, "strip", z.ZodTypeAny, {
-        resume?: unknown;
         update?: Record<string, unknown> | [string, unknown][] | undefined;
+        resume?: unknown;
         goto?: string | {
             node: string;
             input?: unknown;
@@ -883,8 +883,8 @@ export declare const RunBatchCreate: z.ZodArray<z.ZodObject<{
             input?: unknown;
         })[] | undefined;
     }, {
-        resume?: unknown;
         update?: Record<string, unknown> | [string, unknown][] | undefined;
+        resume?: unknown;
         goto?: string | {
             node: string;
             input?: unknown;
@@ -960,6 +960,7 @@ export declare const RunBatchCreate: z.ZodArray<z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     assistant_id: string;
     on_disconnect: "cancel" | "continue";
+    input?: unknown;
     context?: unknown;
     config?: z.objectOutputType<{
         tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -976,10 +977,9 @@ export declare const RunBatchCreate: z.ZodArray<z.ZodObject<{
         }, z.ZodUnknown, "strip">>>;
     }, z.ZodUnknown, "strip"> | undefined;
     metadata?: z.objectOutputType<{}, z.ZodAny, "strip"> | undefined;
-    input?: unknown;
     command?: {
-        resume?: unknown;
         update?: Record<string, unknown> | [string, unknown][] | undefined;
+        resume?: unknown;
         goto?: string | {
             node: string;
             input?: unknown;
@@ -988,7 +988,7 @@ export declare const RunBatchCreate: z.ZodArray<z.ZodObject<{
             input?: unknown;
         })[] | undefined;
     } | undefined;
-    stream_mode?: "values" | "debug" | "messages" | "messages-tuple" | "custom" | "updates" | "events" | "tasks" | "checkpoints" | "tools" | ("values" | "debug" | "messages" | "messages-tuple" | "custom" | "updates" | "events" | "tasks" | "checkpoints" | "tools")[] | undefined;
+    stream_mode?: "values" | "updates" | "messages" | "tools" | "checkpoints" | "tasks" | "custom" | "debug" | "messages-tuple" | "events" | ("values" | "updates" | "messages" | "tools" | "checkpoints" | "tasks" | "custom" | "debug" | "messages-tuple" | "events")[] | undefined;
     interrupt_before?: string[] | "*" | undefined;
     interrupt_after?: string[] | "*" | undefined;
     webhook?: string | undefined;
@@ -1011,6 +1011,7 @@ export declare const RunBatchCreate: z.ZodArray<z.ZodObject<{
     } | undefined;
 }, {
     assistant_id: string;
+    input?: unknown;
     context?: unknown;
     config?: z.objectInputType<{
         tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -1027,10 +1028,9 @@ export declare const RunBatchCreate: z.ZodArray<z.ZodObject<{
         }, z.ZodUnknown, "strip">>>;
     }, z.ZodUnknown, "strip"> | undefined;
     metadata?: z.objectInputType<{}, z.ZodAny, "strip"> | undefined;
-    input?: unknown;
     command?: {
-        resume?: unknown;
         update?: Record<string, unknown> | [string, unknown][] | undefined;
+        resume?: unknown;
         goto?: string | {
             node: string;
             input?: unknown;
@@ -1039,7 +1039,7 @@ export declare const RunBatchCreate: z.ZodArray<z.ZodObject<{
             input?: unknown;
         })[] | undefined;
     } | undefined;
-    stream_mode?: "values" | "debug" | "messages" | "messages-tuple" | "custom" | "updates" | "events" | "tasks" | "checkpoints" | "tools" | ("values" | "debug" | "messages" | "messages-tuple" | "custom" | "updates" | "events" | "tasks" | "checkpoints" | "tools")[] | undefined;
+    stream_mode?: "values" | "updates" | "messages" | "tools" | "checkpoints" | "tasks" | "custom" | "debug" | "messages-tuple" | "events" | ("values" | "updates" | "messages" | "tools" | "checkpoints" | "tasks" | "custom" | "debug" | "messages-tuple" | "events")[] | undefined;
     interrupt_before?: string[] | "*" | undefined;
     interrupt_after?: string[] | "*" | undefined;
     webhook?: string | undefined;
@@ -1122,11 +1122,11 @@ export declare const ThreadCountRequest: z.ZodObject<{
     values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, "strip", z.ZodTypeAny, {
     values?: Record<string, unknown> | undefined;
-    status?: "error" | "idle" | "busy" | "interrupted" | undefined;
+    status?: "error" | "interrupted" | "idle" | "busy" | undefined;
     metadata?: Record<string, unknown> | undefined;
 }, {
     values?: Record<string, unknown> | undefined;
-    status?: "error" | "idle" | "busy" | "interrupted" | undefined;
+    status?: "error" | "interrupted" | "idle" | "busy" | undefined;
     metadata?: Record<string, unknown> | undefined;
 }>;
 export declare const ThreadSearchRequest: z.ZodObject<{
@@ -1141,21 +1141,21 @@ export declare const ThreadSearchRequest: z.ZodObject<{
     select: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 }, "strip", z.ZodTypeAny, {
     values?: Record<string, unknown> | undefined;
-    status?: "error" | "idle" | "busy" | "interrupted" | undefined;
+    status?: "error" | "interrupted" | "idle" | "busy" | undefined;
     metadata?: Record<string, unknown> | undefined;
     limit?: number | undefined;
     offset?: number | undefined;
-    sort_by?: "status" | "created_at" | "updated_at" | "thread_id" | undefined;
+    sort_by?: "thread_id" | "status" | "created_at" | "updated_at" | undefined;
     sort_order?: "asc" | "desc" | undefined;
     select?: string[] | undefined;
     ids?: string[] | undefined;
 }, {
     values?: Record<string, unknown> | undefined;
-    status?: "error" | "idle" | "busy" | "interrupted" | undefined;
+    status?: "error" | "interrupted" | "idle" | "busy" | undefined;
     metadata?: Record<string, unknown> | undefined;
     limit?: number | undefined;
     offset?: number | undefined;
-    sort_by?: "status" | "created_at" | "updated_at" | "thread_id" | undefined;
+    sort_by?: "thread_id" | "status" | "created_at" | "updated_at" | undefined;
     sort_order?: "asc" | "desc" | undefined;
     select?: string[] | undefined;
     ids?: string[] | undefined;
@@ -1167,16 +1167,16 @@ export declare const Thread: z.ZodObject<{
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     status: z.ZodOptional<z.ZodEnum<["idle", "busy", "interrupted", "error"]>>;
 }, "strip", z.ZodTypeAny, {
+    thread_id: string;
     created_at: string;
     updated_at: string;
-    thread_id: string;
-    status?: "error" | "idle" | "busy" | "interrupted" | undefined;
+    status?: "error" | "interrupted" | "idle" | "busy" | undefined;
     metadata?: Record<string, unknown> | undefined;
 }, {
+    thread_id: string;
     created_at: string;
     updated_at: string;
-    thread_id: string;
-    status?: "error" | "idle" | "busy" | "interrupted" | undefined;
+    status?: "error" | "interrupted" | "idle" | "busy" | undefined;
     metadata?: Record<string, unknown> | undefined;
 }>;
 export declare const ThreadCreate: z.ZodObject<{
@@ -1206,8 +1206,8 @@ export declare const ThreadCreate: z.ZodObject<{
                 update: z.ZodOptional<z.ZodUnion<[z.ZodRecord<z.ZodString, z.ZodUnknown>, z.ZodArray<z.ZodTuple<[z.ZodString, z.ZodUnknown], null>, "many">]>>;
                 resume: z.ZodOptional<z.ZodUnknown>;
             }, "strip", z.ZodTypeAny, {
-                resume?: unknown;
                 update?: Record<string, unknown> | [string, unknown][] | undefined;
+                resume?: unknown;
                 goto?: string | {
                     node: string;
                     input?: unknown;
@@ -1216,8 +1216,8 @@ export declare const ThreadCreate: z.ZodObject<{
                     input?: unknown;
                 })[] | undefined;
             }, {
-                resume?: unknown;
                 update?: Record<string, unknown> | [string, unknown][] | undefined;
+                resume?: unknown;
                 goto?: string | {
                     node: string;
                     input?: unknown;
@@ -1231,8 +1231,8 @@ export declare const ThreadCreate: z.ZodObject<{
             as_node: string;
             values?: unknown;
             command?: {
-                resume?: unknown;
                 update?: Record<string, unknown> | [string, unknown][] | undefined;
+                resume?: unknown;
                 goto?: string | {
                     node: string;
                     input?: unknown;
@@ -1245,8 +1245,8 @@ export declare const ThreadCreate: z.ZodObject<{
             as_node: string;
             values?: unknown;
             command?: {
-                resume?: unknown;
                 update?: Record<string, unknown> | [string, unknown][] | undefined;
+                resume?: unknown;
                 goto?: string | {
                     node: string;
                     input?: unknown;
@@ -1261,8 +1261,8 @@ export declare const ThreadCreate: z.ZodObject<{
             as_node: string;
             values?: unknown;
             command?: {
-                resume?: unknown;
                 update?: Record<string, unknown> | [string, unknown][] | undefined;
+                resume?: unknown;
                 goto?: string | {
                     node: string;
                     input?: unknown;
@@ -1277,8 +1277,8 @@ export declare const ThreadCreate: z.ZodObject<{
             as_node: string;
             values?: unknown;
             command?: {
-                resume?: unknown;
                 update?: Record<string, unknown> | [string, unknown][] | undefined;
+                resume?: unknown;
                 goto?: string | {
                     node: string;
                     input?: unknown;
@@ -1293,16 +1293,16 @@ export declare const ThreadCreate: z.ZodObject<{
     metadata: z.ZodOptional<z.ZodObject<{}, "strip", z.ZodAny, z.objectOutputType<{}, z.ZodAny, "strip">, z.objectInputType<{}, z.ZodAny, "strip">>>;
     if_exists: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<"raise">, z.ZodLiteral<"do_nothing">]>>;
 }, "strip", z.ZodTypeAny, {
-    metadata?: z.objectOutputType<{}, z.ZodAny, "strip"> | undefined;
     thread_id?: string | undefined;
+    metadata?: z.objectOutputType<{}, z.ZodAny, "strip"> | undefined;
     if_exists?: "raise" | "do_nothing" | undefined;
     supersteps?: {
         updates: {
             as_node: string;
             values?: unknown;
             command?: {
-                resume?: unknown;
                 update?: Record<string, unknown> | [string, unknown][] | undefined;
+                resume?: unknown;
                 goto?: string | {
                     node: string;
                     input?: unknown;
@@ -1314,16 +1314,16 @@ export declare const ThreadCreate: z.ZodObject<{
         }[];
     }[] | undefined;
 }, {
-    metadata?: z.objectInputType<{}, z.ZodAny, "strip"> | undefined;
     thread_id?: string | undefined;
+    metadata?: z.objectInputType<{}, z.ZodAny, "strip"> | undefined;
     if_exists?: "raise" | "do_nothing" | undefined;
     supersteps?: {
         updates: {
             as_node: string;
             values?: unknown;
             command?: {
-                resume?: unknown;
                 update?: Record<string, unknown> | [string, unknown][] | undefined;
+                resume?: unknown;
                 goto?: string | {
                     node: string;
                     input?: unknown;

package/dist/semver/index.mjs

@@ -10,10 +10,28 @@ export async function checkSemver(packages) {
         const required = peerDependencies[pkg.name];
         if (!required)
             return [];
-        const satisfies = semver.satisfies(pkg.version, required);
+        const satisfies = satisfiesPeerRange(pkg.version, required);
         return { ...pkg, required, satisfies };
     });
 }
+function satisfiesPeerRange(version, required) {
+    if (semver.satisfies(version, required, { includePrerelease: true })) {
+        return true;
+    }
+    const parsed = semver.parse(version);
+    if (parsed == null || parsed.prerelease.length === 0) {
+        return false;
+    }
+    // CI often installs internal dev builds such as
+    // `1.1.44-dev-<timestamp>`. Semver orders those below the final
+    // `1.1.44`, so `^1.1.44` does not match directly even though the
+    // build targets that release line. Validate the release tuple as a
+    // compatibility check while still rejecting prereleases below range.
+    const releaseVersion = `${parsed.major}.${parsed.minor}.${parsed.patch}`;
+    return semver.satisfies(releaseVersion, required, {
+        includePrerelease: true,
+    });
+}
 export async function checkLangGraphSemver() {
     const resolveVersion = async (name) => {
         let version = "0.0.0";

package/dist/server.mjs

@@ -1,4 +1,5 @@
 import { serve } from "@hono/node-server";
+import { createNodeWebSocket } from "@hono/node-ws";
 import { Hono } from "hono";
 import { contextStorage } from "hono/context-storage";
 import { registerFromEnv } from "./graph/load.mjs";
@@ -7,6 +8,7 @@ import threads from "./api/threads.mjs";
 import assistants from "./api/assistants.mjs";
 import store from "./api/store.mjs";
 import meta from "./api/meta.mjs";
+import protocol from "./api/protocol.mjs";
 import { zValidator } from "@hono/zod-validator";
 import { z } from "zod/v3";
 import { queue } from "./queue.mjs";
@@ -71,7 +73,7 @@ export async function startServer(options, storage) {
         ])));
     }
     logger.info(`Initializing storage...`);
-    let initCalls = [
+    const initCalls = [
         checkpointer.initialize(options.cwd),
         graphStore.initialize(options.cwd),
     ];
@@ -88,9 +90,11 @@ export async function startServer(options, storage) {
         ops = new FileSystemOps(opsConn);
     }
     const callbacks = await Promise.all(initCalls);
+    let closeServer;
     const cleanup = async () => {
         logger.info(`Flushing to persistent storage, exiting...`);
         await Promise.all(callbacks.map((c) => c.flush()));
+        await closeServer?.();
     };
     // Register global logger that can be consumed via SDK
     // We need to do this before we load the graphs in-case the logger is obtained at top-level.
@@ -120,6 +124,7 @@ export async function startServer(options, storage) {
         return info;
     });
     const app = new Hono();
+    const { injectWebSocket, upgradeWebSocket } = createNodeWebSocket({ app });
     app.use(contextStorage());
     app.use(async (c, next) => {
         c.set("LANGGRAPH_OPS", ops);
@@ -161,6 +166,8 @@ export async function startServer(options, storage) {
         app.route("/", threads);
     if (!options.http?.disable_store)
         app.route("/", store);
+    if (!options.http?.disable_runs)
+        app.route("/", protocol(upgradeWebSocket, ops));
     if (options.ui) {
         logger.info(`Registering UI from ${options.cwd}`);
         const { api, registerGraphUi } = await import("./ui/load.mjs");
@@ -173,9 +180,21 @@ export async function startServer(options, storage) {
     logger.info(`Starting ${options.nWorkers} workers`);
     for (let i = 0; i < options.nWorkers; i++)
         queue(ops);
-    return new Promise((resolve) => {
-        serve({ fetch: app.fetch, port: options.port, hostname: options.host }, (c) => {
+    return new Promise((resolve, reject) => {
+        const server = serve({ fetch: app.fetch, port: options.port, hostname: options.host }, (c) => {
             resolve({ host: `${c.address}:${c.port}`, cleanup });
         });
+        closeServer = async () => await new Promise((resolveClose, rejectClose) => {
+            server.closeAllConnections();
+            server.close((error) => {
+                if (error) {
+                    rejectClose(error);
+                    return;
+                }
+                resolveClose();
+            });
+        });
+        server.once("error", reject);
+        injectWebSocket(server);
     });
 }

package/dist/state.mjs

@@ -15,7 +15,7 @@ export const stateSnapshotToThreadState = (state) => {
             path: task.path,
             // TODO: too many type assertions, check if this is actually correct
             checkpoint: task.state != null && "configurable" in task.state
-                ? task.state.configurable ?? null
+                ? (task.state.configurable ?? null)
                 : null,
             state: task.state != null && isStateSnapshot(task.state)
                 ? stateSnapshotToThreadState(task.state)

package/dist/storage/ops.mjs

@@ -165,7 +165,7 @@ export class FileSystemAssistants {
             offset: options.offset,
         });
         yield* this.conn.withGenerator(async function* (STORE) {
-            let filtered = Object.values(STORE.assistants)
+            const filtered = Object.values(STORE.assistants)
                 .filter((assistant) => {
                 if (options.graph_id != null &&
                     assistant["graph_id"] !== options.graph_id) {
@@ -1010,7 +1010,7 @@ export class FileSystemRuns {
                 kwargs: Object.assign({}, kwargs, {
                     config: Object.assign({}, assistant.config, config, { configurable }, { metadata: mergedMetadata }),
                     context: typeof assistant.context !== "object" && assistant.context != null
-                        ? assistant.context ?? kwargs.context
+                        ? (assistant.context ?? kwargs.context)
                         : Object.assign({}, assistant.context, kwargs.context),
                 }),
                 multitask_strategy: multitaskStrategy,
@@ -1197,7 +1197,7 @@ export class FileSystemRuns {
             const runs = this.runs;
             yield* conn.withGenerator(async function* (STORE) {
                 // TODO: what if we're joining an already completed run? Should we check before?
-                const signal = options?.cancelOnDisconnect;
+                const signal = options?.signal;
                 const queue = StreamManager.getQueue(runId, {
                     ifNotFound: "create",
                     resumable: options.lastEventId != null,
@@ -1231,7 +1231,14 @@ export class FileSystemRuns {
                         }
                         else {
                             const streamTopic = message.topic.substring(`run:${runId}:stream:`.length);
-                            yield { id, event: streamTopic, data: message.data };
+                            yield {
+                                id,
+                                event: streamTopic,
+                                data: message.data,
+                                ...(message.normalized != null
+                                    ? { normalized: message.normalized }
+                                    : {}),
+                            };
                         }
                     }
                     catch (error) {
@@ -1248,7 +1255,9 @@ export class FileSystemRuns {
                         }
                     }
                 }
-                if (signal?.aborted && threadId != null) {
+                if (signal?.aborted &&
+                    options?.cancelOnDisconnect &&
+                    threadId != null) {
                     await runs.cancel(threadId, [runId], { action: "interrupt" }, auth);
                 }
             });
@@ -1261,6 +1270,9 @@ export class FileSystemRuns {
             queue.push({
                 topic: `run:${payload.runId}:stream:${payload.event}`,
                 data: payload.data,
+                ...(payload.normalized != null
+                    ? { normalized: payload.normalized }
+                    : {}),
             });
         }
     };

package/dist/storage/persist.mjs

@@ -68,7 +68,7 @@ export class FileSystemPersistence {
             throw new Error(`${this.name} not initialized`);
         }
         let shouldPersist = false;
-        let schedulePersist = () => void (shouldPersist = true);
+        const schedulePersist = () => void (shouldPersist = true);
         try {
             const gen = typeof fn === "function" ? fn(this.data, { schedulePersist }) : fn;
             yield* gen;

package/dist/storage/types.d.mts

@@ -85,6 +85,14 @@ export interface Store {
 export interface Message {
     topic: `run:${string}:stream:${string}`;
     data: unknown;
+    /**
+     * Marks payloads that have already been converted to their protocol
+     * shape by the in-process streaming layer
+     * (e.g. `convertToProtocolEvent({ mode: "custom", ... })` output).
+     * Carried through the run-queue so downstream consumers (protocol session)
+     * can skip re-wrapping the payload.
+     */
+    normalized?: boolean;
 }
 export interface Thread {
     thread_id: string;
@@ -170,7 +178,8 @@ export interface RunsRepo {
 export interface RunsStreamRepo {
     join(runId: string, threadId: string | undefined, options: {
         ignore404?: boolean;
-        cancelOnDisconnect?: AbortSignal;
+        signal?: AbortSignal;
+        cancelOnDisconnect?: boolean;
         lastEventId: string | undefined;
     }, auth: AuthContext | undefined): AsyncGenerator<{
         id?: string;