@langchain/langgraph-api 0.0.26 → 0.0.28

package/dist/api/threads.mjs

@@ -1,10 +1,10 @@
 import { zValidator } from "@hono/zod-validator";
 import { Hono } from "hono";
 import { v4 as uuid4 } from "uuid";
-import * as schemas from "../schemas.mjs";
-import { Threads } from "../storage/ops.mjs";
 import { z } from "zod";
+import * as schemas from "../schemas.mjs";
 import { stateSnapshotToThreadState } from "../state.mjs";
+import { Threads } from "../storage/ops.mjs";
 import { jsonExtra } from "../utils/hono.mjs";
 const api = new Hono();
 // Threads Routes
@@ -21,19 +21,27 @@ api.post("/threads/search", zValidator("json", schemas.ThreadSearchRequest), asy
     // Search Threads
     const payload = c.req.valid("json");
     const result = [];
+    let total = 0;
     for await (const item of Threads.search({
         status: payload.status,
         values: payload.values,
         metadata: payload.metadata,
         limit: payload.limit ?? 10,
         offset: payload.offset ?? 0,
+        sort_by: payload.sort_by ?? "created_at",
+        sort_order: payload.sort_order ?? "desc",
     }, c.var.auth)) {
         result.push({
-            ...item,
-            created_at: item.created_at.toISOString(),
-            updated_at: item.updated_at.toISOString(),
+            ...item.thread,
+            created_at: item.thread.created_at.toISOString(),
+            updated_at: item.thread.updated_at.toISOString(),
         });
+        // Only set total if it's the first item
+        if (total === 0) {
+            total = item.total;
+        }
     }
+    c.res.headers.set("X-Pagination-Total", total.toString());
     return jsonExtra(c, result);
 });
 api.get("/threads/:thread_id/state", zValidator("param", z.object({ thread_id: z.string().uuid() })), zValidator("query", z.object({ subgraphs: schemas.coercedBoolean.optional() })), async (c) => {

package/dist/schemas.mjs

@@ -287,6 +287,11 @@ export const ThreadSearchRequest = z
         .gte(0)
         .describe("Offset to start from.")
         .optional(),
+    sort_by: z
+        .enum(["thread_id", "status", "created_at", "updated_at"])
+        .describe("Sort by field.")
+        .optional(),
+    sort_order: z.enum(["asc", "desc"]).describe("Sort order.").optional(),
 })
     .describe("Payload for listing threads.");
 export const Thread = z.object({

package/dist/semver/index.d.mts

@@ -0,0 +1,15 @@
+export declare function checkSemver(packages: {
+    name: string;
+    version: string;
+}[]): Promise<{
+    name: string;
+    version: string;
+    required: string;
+    satisfies: boolean;
+}[]>;
+export declare function checkLangGraphSemver(): Promise<{
+    name: string;
+    version: string;
+    required: string;
+    satisfies: boolean;
+}[]>;

package/dist/semver/index.mjs

@@ -0,0 +1,35 @@
+import * as url from "node:url";
+import * as fs from "node:fs/promises";
+import * as semver from "semver";
+const packageJsonPath = url.fileURLToPath(new URL("../../package.json", import.meta.url));
+export async function checkSemver(packages) {
+    const packageJson = JSON.parse(await fs.readFile(packageJsonPath, "utf-8"));
+    const peerDependencies = packageJson.peerDependencies ?? {};
+    return packages.flatMap((pkg) => {
+        const required = peerDependencies[pkg.name];
+        if (!required)
+            return [];
+        const satisfies = semver.satisfies(pkg.version, required);
+        return { ...pkg, required, satisfies };
+    });
+}
+export async function checkLangGraphSemver() {
+    const resolveVersion = async (name) => {
+        let version = "0.0.0";
+        try {
+            const pkgJson = await import(`${name}/package.json`);
+            version = pkgJson.version || version;
+        }
+        catch {
+            // pass
+        }
+        return { name, version };
+    };
+    const validate = [
+        "@langchain/core",
+        "@langchain/langgraph",
+        "@langchain/langgraph-checkpoint",
+    ];
+    const resolved = await Promise.all(validate.map((name) => resolveVersion(name)));
+    return checkSemver(resolved);
+}

package/dist/server.mjs

@@ -18,6 +18,7 @@ import { registerAuth } from "./auth/index.mjs";
 import { registerHttp } from "./http/custom.mjs";
 import { cors, ensureContentType } from "./http/middleware.mjs";
 import { bindLoopbackFetch } from "./loopback.mjs";
+import { checkLangGraphSemver } from "./semver/index.mjs";
 export const StartServerSchema = z.object({
     port: z.number(),
     nWorkers: z.number(),
@@ -55,6 +56,14 @@ export const StartServerSchema = z.object({
         .optional(),
 });
 export async function startServer(options) {
+    const semver = await checkLangGraphSemver();
+    const invalidPackages = semver.filter((s) => !s.satisfies);
+    if (invalidPackages.length > 0) {
+        logger.warn(`Some LangGraph.js dependencies are not up to date. Please make sure to update them to the required version.`, Object.fromEntries(invalidPackages.map(({ name, version, required }) => [
+            name,
+            { version, required },
+        ])));
+    }
     logger.info(`Initializing storage...`);
     const callbacks = await Promise.all([
         opsConn.initialize(options.cwd),
@@ -81,9 +90,6 @@ export async function startServer(options) {
         truncate({ runs, threads, assistants, checkpointer, store });
         return c.json({ ok: true });
     });
-    app.use(cors(options.http?.cors));
-    app.use(requestLogger());
-    app.use(ensureContentType());
     if (options.auth?.path) {
         logger.info(`Loading auth from ${options.auth.path}`);
         await registerAuth(options.auth, { cwd: options.cwd });
@@ -94,6 +100,9 @@ export async function startServer(options) {
         const { api } = await registerHttp(options.http.app, { cwd: options.cwd });
         app.route("/", api);
     }
+    app.use(cors(options.http?.cors));
+    app.use(requestLogger());
+    app.use(ensureContentType());
     if (!options.http?.disable_meta)
         app.route("/", meta);
     if (!options.http?.disable_assistants)

package/dist/storage/ops.mjs

@@ -1,13 +1,13 @@
 import { HTTPException } from "hono/http-exception";
 import { v4 as uuid4, v5 as uuid5 } from "uuid";
+import { handleAuthEvent, isAuthMatching } from "../auth/custom.mjs";
+import { getLangGraphCommand } from "../command.mjs";
 import { getGraph, NAMESPACE_GRAPH } from "../graph/load.mjs";
-import { checkpointer } from "./checkpoint.mjs";
-import { store } from "./store.mjs";
 import { logger } from "../logging.mjs";
 import { serializeError } from "../utils/serde.mjs";
+import { checkpointer } from "./checkpoint.mjs";
 import { FileSystemPersistence } from "./persist.mjs";
-import { getLangGraphCommand } from "../command.mjs";
-import { handleAuthEvent, isAuthMatching } from "../auth/custom.mjs";
+import { store } from "./store.mjs";
 export const conn = new FileSystemPersistence(".langgraphjs_ops.json", () => ({
     runs: {},
     threads: {},
@@ -374,9 +374,27 @@ export class Threads {
                     return false;
                 return true;
             })
-                .sort((a, b) => b["created_at"].getTime() - a["created_at"].getTime());
+                .sort((a, b) => {
+                const sortBy = options.sort_by ?? "created_at";
+                const sortOrder = options.sort_order ?? "desc";
+                if (sortBy === "created_at" || sortBy === "updated_at") {
+                    const aTime = a[sortBy].getTime();
+                    const bTime = b[sortBy].getTime();
+                    return sortOrder === "desc" ? bTime - aTime : aTime - bTime;
+                }
+                if (sortBy === "thread_id" || sortBy === "status") {
+                    const aVal = a[sortBy];
+                    const bVal = b[sortBy];
+                    return sortOrder === "desc"
+                        ? bVal.localeCompare(aVal)
+                        : aVal.localeCompare(bVal);
+                }
+                return 0;
+            });
+            // Calculate total count before pagination
+            const total = filtered.length;
             for (const thread of filtered.slice(options.offset, options.offset + options.limit)) {
-                yield thread;
+                yield { thread, total };
             }
         });
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@langchain/langgraph-api",
-  "version": "0.0.26",
+  "version": "0.0.28",
   "type": "module",
   "engines": {
     "node": "^18.19.0 || >=20.16.0"
@@ -18,7 +18,12 @@
     "./auth": {
       "types": "./dist/auth/index.d.ts",
       "default": "./dist/auth/index.mjs"
-    }
+    },
+    "./semver": {
+      "types": "./dist/semver/index.d.ts",
+      "default": "./dist/semver/index.mjs"
+    },
+    "./package.json": "./package.json"
   },
   "repository": {
     "type": "git",
@@ -36,6 +41,7 @@
     "hono": "^4.5.4",
     "langsmith": "^0.2.15",
     "open": "^10.1.0",
+    "semver": "^7.7.1",
     "stacktrace-parser": "^0.1.10",
     "superjson": "^2.2.2",
     "tsx": "^4.19.3",
@@ -43,13 +49,13 @@
     "winston": "^3.17.0",
     "winston-console-format": "^1.0.8",
     "zod": "^3.23.8",
-    "@langchain/langgraph-ui": "0.0.26"
+    "@langchain/langgraph-ui": "0.0.28"
   },
   "peerDependencies": {
     "@langchain/core": "^0.3.42",
     "@langchain/langgraph": "^0.2.57",
     "@langchain/langgraph-checkpoint": "^0.0.16",
-    "@langchain/langgraph-sdk": "^0.0.67",
+    "@langchain/langgraph-sdk": "^0.0.70",
     "typescript": "^5.5.4"
   },
   "peerDependenciesMeta": {
@@ -58,13 +64,15 @@
     }
   },
   "devDependencies": {
-    "@langchain/langgraph-sdk": "^0.0.67",
+    "typescript": "^5.5.4",
+    "@langchain/langgraph-sdk": "^0.0.70",
     "@types/babel__code-frame": "^7.0.6",
+    "@types/node": "^22.2.0",
     "@types/react": "^19.0.8",
     "@types/react-dom": "^19.0.3",
-    "@types/node": "^22.2.0",
-    "jose": "^6.0.10",
+    "@types/semver": "^7.7.0",
     "@types/uuid": "^10.0.0",
+    "jose": "^6.0.10",
     "postgres": "^3.4.5",
     "prettier": "^3.3.3",
     "vitest": "^3.0.5"