@langchain/langgraph-api 0.0.25 → 0.0.27

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/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.25",
+  "version": "0.0.27",
   "type": "module",
   "engines": {
     "node": "^18.19.0 || >=20.16.0"
@@ -43,13 +43,13 @@
     "winston": "^3.17.0",
     "winston-console-format": "^1.0.8",
     "zod": "^3.23.8",
-    "@langchain/langgraph-ui": "0.0.25"
+    "@langchain/langgraph-ui": "0.0.27"
   },
   "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,7 +58,7 @@
     }
   },
   "devDependencies": {
-    "@langchain/langgraph-sdk": "^0.0.67",
+    "@langchain/langgraph-sdk": "^0.0.70",
     "@types/babel__code-frame": "^7.0.6",
     "@types/react": "^19.0.8",
     "@types/react-dom": "^19.0.3",