@langchain/langgraph-api 0.0.65 → 0.0.67

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # @langchain/langgraph-api
 
+## 0.0.67
+
+### Patch Changes
+
+- e23fa7f: Add support for `sort_by`, `sort_order` and `select` when searching for assistants and add support for pagination headers.
+  - @langchain/langgraph-ui@0.0.67
+
+## 0.0.66
+
+### Patch Changes
+
+- 5176f1c: chore(api): add description field for assistants
+- 68a1aa8: fix(api): call threads:create auth handler when copying a thread
+  - @langchain/langgraph-ui@0.0.66
+
 ## 0.0.65
 
 ### Patch Changes

package/dist/api/assistants.mjs

@@ -40,6 +40,7 @@ api.post("/assistants", zValidator("json", schemas.AssistantCreate), async (c) =
         metadata: payload.metadata ?? {},
         if_exists: payload.if_exists ?? "raise",
         name: payload.name ?? "Untitled",
+        description: payload.description,
     }, c.var.auth);
     return c.json(assistant);
 });
@@ -53,13 +54,22 @@ api.post("/assistants/search", zValidator("json", schemas.AssistantSearchRequest
         metadata: payload.metadata,
         limit: payload.limit ?? 10,
         offset: payload.offset ?? 0,
+        sort_by: payload.sort_by,
+        sort_order: payload.sort_order,
+        select: payload.select,
     }, c.var.auth)) {
-        result.push(item.assistant);
+        result.push(Object.fromEntries(Object.entries(item.assistant).filter(([k]) => !payload.select || payload.select.includes(k))));
         if (total === 0) {
             total = item.total;
         }
     }
-    c.res.headers.set("X-Pagination-Total", total.toString());
+    if (total === payload.limit) {
+        c.res.headers.set("X-Pagination-Next", ((payload.offset ?? 0) + total).toString());
+        c.res.headers.set("X-Pagination-Total", ((payload.offset ?? 0) + total + 1).toString());
+    }
+    else {
+        c.res.headers.set("X-Pagination-Total", ((payload.offset ?? 0) + total).toString());
+    }
     return c.json(result);
 });
 api.post("/assistants/count", zValidator("json", schemas.AssistantCountRequest), async (c) => {

package/dist/schemas.d.mts

@@ -111,8 +111,8 @@ export declare const Assistant: z.ZodObject<{
     };
     created_at: string;
     updated_at: string;
-    graph_id: string;
     assistant_id: string;
+    graph_id: string;
 }, {
     metadata: {} & {
         [k: string]: any;
@@ -129,8 +129,8 @@ export declare const Assistant: z.ZodObject<{
     };
     created_at: string;
     updated_at: string;
-    graph_id: string;
     assistant_id: string;
+    graph_id: string;
 }>;
 export declare const AssistantCreate: z.ZodObject<{
     assistant_id: z.ZodOptional<z.ZodString>;
@@ -179,6 +179,7 @@ export declare const AssistantCreate: z.ZodObject<{
     metadata: z.ZodOptional<z.ZodObject<{}, "strip", z.ZodUnknown, z.objectOutputType<{}, z.ZodUnknown, "strip">, z.objectInputType<{}, z.ZodUnknown, "strip">>>;
     if_exists: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<"raise">, z.ZodLiteral<"do_nothing">]>>;
     name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     graph_id: string;
     context?: unknown;
@@ -197,8 +198,9 @@ export declare const AssistantCreate: z.ZodObject<{
             thread_ts: z.ZodOptional<z.ZodString>;
         }, z.ZodUnknown, "strip">>>;
     }, z.ZodUnknown, "strip"> | undefined;
-    name?: string | undefined;
     assistant_id?: string | undefined;
+    name?: string | undefined;
+    description?: string | undefined;
     if_exists?: "raise" | "do_nothing" | undefined;
 }, {
     graph_id: string;
@@ -218,8 +220,9 @@ export declare const AssistantCreate: z.ZodObject<{
             thread_ts: z.ZodOptional<z.ZodString>;
         }, z.ZodUnknown, "strip">>>;
     }, z.ZodUnknown, "strip"> | undefined;
-    name?: string | undefined;
     assistant_id?: string | undefined;
+    name?: string | undefined;
+    description?: string | undefined;
     if_exists?: "raise" | "do_nothing" | undefined;
 }>;
 export declare const AssistantPatch: z.ZodObject<{
@@ -266,6 +269,7 @@ export declare const AssistantPatch: z.ZodObject<{
     }, z.ZodUnknown, "strip">>>;
     context: z.ZodOptional<z.ZodUnknown>;
     name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
     metadata: z.ZodOptional<z.ZodObject<{}, "strip", z.ZodAny, z.objectOutputType<{}, z.ZodAny, "strip">, z.objectInputType<{}, z.ZodAny, "strip">>>;
 }, "strip", z.ZodTypeAny, {
     context?: unknown;
@@ -286,6 +290,7 @@ export declare const AssistantPatch: z.ZodObject<{
     }, z.ZodUnknown, "strip"> | undefined;
     name?: string | undefined;
     graph_id?: string | undefined;
+    description?: string | undefined;
 }, {
     context?: unknown;
     metadata?: z.objectInputType<{}, z.ZodAny, "strip"> | undefined;
@@ -305,6 +310,7 @@ export declare const AssistantPatch: z.ZodObject<{
     }, z.ZodUnknown, "strip"> | undefined;
     name?: string | undefined;
     graph_id?: string | undefined;
+    description?: string | undefined;
 }>;
 export declare const Config: z.ZodObject<{
     tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -524,8 +530,8 @@ export declare const Run: z.ZodObject<{
     };
     created_at: string;
     updated_at: string;
-    run_id: string;
     assistant_id: string;
+    run_id: string;
     multitask_strategy: "reject" | "rollback" | "interrupt" | "enqueue";
     kwargs: {} & {
         [k: string]: any;
@@ -538,8 +544,8 @@ export declare const Run: z.ZodObject<{
     };
     created_at: string;
     updated_at: string;
-    run_id: string;
     assistant_id: string;
+    run_id: string;
     multitask_strategy: "reject" | "rollback" | "interrupt" | "enqueue";
     kwargs: {} & {
         [k: string]: any;
@@ -1074,16 +1080,25 @@ export declare const AssistantSearchRequest: z.ZodObject<{
     graph_id: z.ZodOptional<z.ZodString>;
     limit: z.ZodOptional<z.ZodNumber>;
     offset: z.ZodOptional<z.ZodNumber>;
+    sort_by: z.ZodOptional<z.ZodEnum<["assistant_id", "graph_id", "created_at", "updated_at", "name"]>>;
+    sort_order: z.ZodOptional<z.ZodEnum<["asc", "desc"]>>;
+    select: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 }, "strip", z.ZodTypeAny, {
     metadata?: z.objectOutputType<{}, z.ZodAny, "strip"> | undefined;
     graph_id?: string | undefined;
     limit?: number | undefined;
     offset?: number | undefined;
+    sort_by?: "created_at" | "updated_at" | "assistant_id" | "name" | "graph_id" | undefined;
+    sort_order?: "asc" | "desc" | undefined;
+    select?: string[] | undefined;
 }, {
     metadata?: z.objectInputType<{}, z.ZodAny, "strip"> | undefined;
     graph_id?: string | undefined;
     limit?: number | undefined;
     offset?: number | undefined;
+    sort_by?: "created_at" | "updated_at" | "assistant_id" | "name" | "graph_id" | undefined;
+    sort_order?: "asc" | "desc" | undefined;
+    select?: string[] | undefined;
 }>;
 export declare const AssistantCountRequest: z.ZodObject<{
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -1123,18 +1138,18 @@ export declare const ThreadSearchRequest: z.ZodObject<{
     metadata?: Record<string, unknown> | undefined;
     limit?: number | undefined;
     offset?: number | undefined;
-    ids?: string[] | undefined;
     sort_by?: "status" | "thread_id" | "created_at" | "updated_at" | undefined;
     sort_order?: "asc" | "desc" | undefined;
+    ids?: string[] | undefined;
 }, {
     values?: Record<string, unknown> | undefined;
     status?: "error" | "idle" | "busy" | "interrupted" | undefined;
     metadata?: Record<string, unknown> | undefined;
     limit?: number | undefined;
     offset?: number | undefined;
-    ids?: string[] | undefined;
     sort_by?: "status" | "thread_id" | "created_at" | "updated_at" | undefined;
     sort_order?: "asc" | "desc" | undefined;
+    ids?: string[] | undefined;
 }>;
 export declare const Thread: z.ZodObject<{
     thread_id: z.ZodString;

package/dist/schemas.mjs

@@ -40,6 +40,7 @@ export const AssistantCreate = z
         .union([z.literal("raise"), z.literal("do_nothing")])
         .optional(),
     name: z.string().optional(),
+    description: z.string().optional(),
 })
     .describe("Payload for creating an assistant.");
 export const AssistantPatch = z
@@ -48,6 +49,7 @@ export const AssistantPatch = z
     config: AssistantConfig.optional(),
     context: z.unknown().optional(),
     name: z.string().optional(),
+    description: z.string().optional(),
     metadata: z
         .object({})
         .catchall(z.any())
@@ -272,6 +274,11 @@ export const AssistantSearchRequest = z
         .gte(0)
         .describe("Offset to start from.")
         .optional(),
+    sort_by: z
+        .enum(["assistant_id", "graph_id", "created_at", "updated_at", "name"])
+        .optional(),
+    sort_order: z.enum(["asc", "desc"]).optional(),
+    select: z.array(z.string()).optional(),
 })
     .describe("Payload for listing assistants.");
 export const AssistantCountRequest = z

package/dist/storage/ops.d.mts

@@ -66,6 +66,7 @@ export declare class FileSystemAssistants implements AssistantsRepo {
         metadata?: Metadata;
         if_exists: OnConflictBehavior;
         name?: string;
+        description?: string;
     }, auth: AuthContext | undefined): Promise<Assistant>;
     patch(assistantId: string, options: {
         config?: RunnableConfig;
@@ -73,6 +74,7 @@ export declare class FileSystemAssistants implements AssistantsRepo {
         graph_id?: string;
         metadata?: Metadata;
         name?: string;
+        description?: string;
     }, auth: AuthContext | undefined): Promise<Assistant>;
     delete(assistant_id: string, auth: AuthContext | undefined): Promise<string[]>;
     setLatest(assistant_id: string, version: number, auth: AuthContext | undefined): Promise<Assistant>;

package/dist/storage/ops.mjs

@@ -221,6 +221,7 @@ export class FileSystemAssistants {
             metadata: options.metadata,
             if_exists: options.if_exists,
             name: options.name,
+            description: options.description,
         });
         return this.conn.with((STORE) => {
             if (STORE.assistants[assistant_id] != null) {
@@ -244,6 +245,7 @@ export class FileSystemAssistants {
                 graph_id: options.graph_id,
                 metadata: mutable.metadata ?? {},
                 name: options.name || options.graph_id,
+                description: options.description,
             };
             STORE.assistant_versions.push({
                 assistant_id: assistant_id,
@@ -254,6 +256,7 @@ export class FileSystemAssistants {
                 metadata: mutable.metadata ?? {},
                 created_at: now,
                 name: options.name || options.graph_id,
+                description: options.description,
             });
             return STORE.assistants[assistant_id];
         });
@@ -265,6 +268,7 @@ export class FileSystemAssistants {
             config: options?.config,
             metadata: options?.metadata,
             name: options?.name,
+            description: options?.description,
         });
         return this.conn.with((STORE) => {
             const assistant = STORE.assistants[assistantId];
@@ -293,6 +297,10 @@ export class FileSystemAssistants {
             if (options?.name != null) {
                 assistant["name"] = options?.name ?? assistant["name"];
             }
+            if (options?.description != null) {
+                assistant["description"] =
+                    options?.description ?? assistant["description"];
+            }
             if (metadata != null) {
                 assistant["metadata"] = metadata ?? assistant["metadata"];
             }
@@ -308,6 +316,7 @@ export class FileSystemAssistants {
                 config: options?.config ?? assistant["config"],
                 context: options?.context ?? assistant["context"],
                 name: options?.name ?? assistant["name"],
+                description: options?.description ?? assistant["description"],
                 metadata: metadata ?? assistant["metadata"],
                 created_at: now,
             };
@@ -615,20 +624,28 @@ export class FileSystemThreads {
         const [filters] = await handleAuthEvent(auth, "threads:read", {
             thread_id,
         });
-        return this.conn.with((STORE) => {
+        const fromThread = await this.conn.with((STORE) => {
             const thread = STORE.threads[thread_id];
             if (!thread)
                 throw new HTTPException(409, { message: "Thread not found" });
             if (!isAuthMatching(thread["metadata"], filters)) {
                 throw new HTTPException(409, { message: "Thread not found" });
             }
-            const newThreadId = uuid4();
-            const now = new Date();
+            return thread;
+        });
+        const newThreadId = uuid4();
+        const now = new Date();
+        const newMetadata = { ...fromThread.metadata, thread_id: newThreadId };
+        await handleAuthEvent(auth, "threads:create", {
+            thread_id: newThreadId,
+            metadata: newMetadata,
+        });
+        return this.conn.with((STORE) => {
             STORE.threads[newThreadId] = {
                 thread_id: newThreadId,
                 created_at: now,
                 updated_at: now,
-                metadata: { ...thread.metadata, thread_id: newThreadId },
+                metadata: newMetadata,
                 config: {},
                 status: "idle",
             };

package/dist/storage/types.d.mts

@@ -26,6 +26,7 @@ export interface RunnableConfig {
 }
 export interface Assistant {
     name: string | undefined;
+    description: string | undefined;
     assistant_id: string;
     graph_id: string;
     created_at: Date;
@@ -44,6 +45,7 @@ export interface AssistantVersion {
     metadata: Metadata;
     created_at: Date;
     name: string | undefined;
+    description: string | undefined;
 }
 export interface RunKwargs {
     input?: unknown;
@@ -243,6 +245,9 @@ export interface AssistantsRepo {
         metadata?: Metadata;
         limit: number;
         offset: number;
+        sort_by?: "assistant_id" | "created_at" | "updated_at" | "name" | "graph_id";
+        sort_order?: "asc" | "desc";
+        select?: string[];
     }, auth: AuthContext | undefined): AsyncGenerator<{
         assistant: Assistant;
         total: number;
@@ -255,6 +260,7 @@ export interface AssistantsRepo {
         metadata?: Metadata;
         if_exists: OnConflictBehavior;
         name?: string;
+        description?: string;
     }, auth: AuthContext | undefined): Promise<Assistant>;
     patch(assistantId: string, options: {
         config?: RunnableConfig;
@@ -262,6 +268,7 @@ export interface AssistantsRepo {
         graph_id?: string;
         metadata?: Metadata;
         name?: string;
+        description?: string;
     }, auth: AuthContext | undefined): Promise<Assistant>;
     delete(assistant_id: string, auth: AuthContext | undefined): Promise<string[]>;
     count(options: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@langchain/langgraph-api",
-  "version": "0.0.65",
+  "version": "0.0.67",
   "type": "module",
   "engines": {
     "node": "^18.19.0 || >=20.16.0"
@@ -64,7 +64,7 @@
     "@babel/code-frame": "^7.26.2",
     "@hono/node-server": "^1.12.0",
     "@hono/zod-validator": "^0.2.2",
-    "@langchain/langgraph-ui": "0.0.65",
+    "@langchain/langgraph-ui": "0.0.67",
     "@types/json-schema": "^7.0.15",
     "@typescript/vfs": "^1.6.0",
     "dedent": "^1.5.3",
@@ -98,7 +98,7 @@
     "@langchain/core": "^0.3.59",
     "@langchain/langgraph": "0.4.9",
     "@langchain/langgraph-checkpoint": "0.1.1",
-    "@langchain/langgraph-sdk": "0.1.1",
+    "@langchain/langgraph-sdk": "0.1.6",
     "@types/babel__code-frame": "^7.0.6",
     "@types/node": "^18.15.11",
     "@types/react": "^19.0.8",