@langchain/langgraph-sdk 0.1.0 → 0.1.2

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # @langchain/langgraph-sdk
 
+## 0.1.2
+
+### Patch Changes
+
+- 3b1e137: Add `description` field for assistants auth handlers
+
+## 0.1.1
+
+### Patch Changes
+
+- 7de6680: Fix `onRequest` not being called when streaming runs or threads (#1585)
+- df8b662: Fix interrupts not being exposed in `useStream["interrupt"]` when `fetchStateHistory: false`
+- 572de43: feat(threads): add `ids` filter to Threads.search
+
+  - SDK: `ThreadsClient.search` now accepts `ids?: string[]` and forwards it to `/threads/search`.
+  - API: `/threads/search` schema accepts `ids` and storage filters by provided thread IDs.
+
+  This enables fetching a specific set of threads directly via the search endpoint, while remaining backward compatible.
+
 ## 0.1.0
 
 ### Minor Changes

package/dist/auth/types.d.ts

@@ -19,6 +19,7 @@ interface AssistantCreate {
     context?: Maybe<unknown>;
     if_exists?: Maybe<"raise" | "do_nothing">;
     name?: Maybe<string>;
+    description?: Maybe<string>;
     graph_id: string;
 }
 /**
@@ -38,6 +39,7 @@ interface AssistantUpdate {
     context?: Maybe<unknown>;
     graph_id?: Maybe<string>;
     name?: Maybe<string>;
+    description?: Maybe<string>;
     version?: Maybe<number>;
 }
 /**
@@ -89,6 +91,7 @@ interface ThreadDelete {
  */
 interface ThreadSearch {
     thread_id?: Maybe<string>;
+    ids?: Maybe<string[]>;
     status?: Maybe<"idle" | "busy" | "interrupted" | "error" | (string & {})>;
     metadata?: Maybe<Record<string, unknown>>;
     values?: Maybe<Record<string, unknown>>;

package/dist/client.cjs

@@ -563,6 +563,7 @@ class ThreadsClient extends BaseClient {
             method: "POST",
             json: {
                 metadata: query?.metadata ?? undefined,
+                ids: query?.ids ?? undefined,
                 limit: query?.limit ?? 10,
                 offset: query?.offset ?? 0,
                 status: query?.status,
@@ -671,7 +672,7 @@ class ThreadsClient extends BaseClient {
     async *joinStream(threadId, options
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     ) {
-        const response = await this.asyncCaller.fetch(...this.prepareFetchOptions(`/threads/${threadId}/stream`, {
+        let [url, init] = this.prepareFetchOptions(`/threads/${threadId}/stream`, {
             method: "GET",
             headers: options?.lastEventId
                 ? { "Last-Event-ID": options.lastEventId }
@@ -679,7 +680,10 @@ class ThreadsClient extends BaseClient {
             params: options?.streamMode
                 ? { stream_mode: options.streamMode }
                 : undefined,
-        }));
+        });
+        if (this.onRequest != null)
+            init = await this.onRequest(url, init);
+        const response = await this.asyncCaller.fetch(url, init);
         // eslint-disable-next-line @typescript-eslint/no-explicit-any
         const stream = (response.body || new ReadableStream({ start: (ctrl) => ctrl.close() }))
             .pipeThrough((0, sse_js_1.BytesLineDecoder)())
@@ -722,12 +726,15 @@ class RunsClient extends BaseClient {
             durability: payload?.durability,
         };
         const endpoint = threadId == null ? `/runs/stream` : `/threads/${threadId}/runs/stream`;
-        const response = await this.asyncCaller.fetch(...this.prepareFetchOptions(endpoint, {
+        let [url, init] = this.prepareFetchOptions(endpoint, {
             method: "POST",
             json,
             timeoutMs: null,
             signal: payload?.signal,
-        }));
+        });
+        if (this.onRequest != null)
+            init = await this.onRequest(url, init);
+        const response = await this.asyncCaller.fetch(url, init);
         const runMetadata = getRunMetadataFromResponse(response);
         if (runMetadata)
             payload?.onRunCreated?.(runMetadata);
@@ -939,7 +946,7 @@ class RunsClient extends BaseClient {
             options instanceof AbortSignal
             ? { signal: options }
             : options;
-        const response = await this.asyncCaller.fetch(...this.prepareFetchOptions(threadId != null
+        let [url, init] = this.prepareFetchOptions(threadId != null
             ? `/threads/${threadId}/runs/${runId}/stream`
             : `/runs/${runId}/stream`, {
             method: "GET",
@@ -952,7 +959,10 @@ class RunsClient extends BaseClient {
                 cancel_on_disconnect: opts?.cancelOnDisconnect ? "1" : "0",
                 stream_mode: opts?.streamMode,
             },
-        }));
+        });
+        if (this.onRequest != null)
+            init = await this.onRequest(url, init);
+        const response = await this.asyncCaller.fetch(url, init);
         // eslint-disable-next-line @typescript-eslint/no-explicit-any
         const stream = (response.body || new ReadableStream({ start: (ctrl) => ctrl.close() }))
             .pipeThrough((0, sse_js_1.BytesLineDecoder)())
@@ -1172,14 +1182,17 @@ class UiClient extends BaseClient {
     }
     async getComponent(assistantId, agentName) {
         return UiClient.getOrCached(`${this.apiUrl}-${assistantId}-${agentName}`, async () => {
-            const response = await this.asyncCaller.fetch(...this.prepareFetchOptions(`/ui/${assistantId}`, {
+            let [url, init] = this.prepareFetchOptions(`/ui/${assistantId}`, {
                 headers: {
                     Accept: "text/html",
                     "Content-Type": "application/json",
                 },
                 method: "POST",
                 json: { name: agentName },
-            }));
+            });
+            if (this.onRequest != null)
+                init = await this.onRequest(url, init);
+            const response = await this.asyncCaller.fetch(url, init);
             return response.text();
         });
     }

package/dist/client.d.ts

@@ -297,6 +297,10 @@ export declare class ThreadsClient<TStateType = DefaultValues, TUpdateType = TSt
          * Metadata to filter threads by.
          */
         metadata?: Metadata;
+        /**
+         * Filter by specific thread IDs.
+         */
+        ids?: string[];
         /**
          * Maximum number of threads to return.
          * Defaults to 10

package/dist/client.js

@@ -556,6 +556,7 @@ export class ThreadsClient extends BaseClient {
             method: "POST",
             json: {
                 metadata: query?.metadata ?? undefined,
+                ids: query?.ids ?? undefined,
                 limit: query?.limit ?? 10,
                 offset: query?.offset ?? 0,
                 status: query?.status,
@@ -664,7 +665,7 @@ export class ThreadsClient extends BaseClient {
     async *joinStream(threadId, options
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     ) {
-        const response = await this.asyncCaller.fetch(...this.prepareFetchOptions(`/threads/${threadId}/stream`, {
+        let [url, init] = this.prepareFetchOptions(`/threads/${threadId}/stream`, {
             method: "GET",
             headers: options?.lastEventId
                 ? { "Last-Event-ID": options.lastEventId }
@@ -672,7 +673,10 @@ export class ThreadsClient extends BaseClient {
             params: options?.streamMode
                 ? { stream_mode: options.streamMode }
                 : undefined,
-        }));
+        });
+        if (this.onRequest != null)
+            init = await this.onRequest(url, init);
+        const response = await this.asyncCaller.fetch(url, init);
         // eslint-disable-next-line @typescript-eslint/no-explicit-any
         const stream = (response.body || new ReadableStream({ start: (ctrl) => ctrl.close() }))
             .pipeThrough(BytesLineDecoder())
@@ -714,12 +718,15 @@ export class RunsClient extends BaseClient {
             durability: payload?.durability,
         };
         const endpoint = threadId == null ? `/runs/stream` : `/threads/${threadId}/runs/stream`;
-        const response = await this.asyncCaller.fetch(...this.prepareFetchOptions(endpoint, {
+        let [url, init] = this.prepareFetchOptions(endpoint, {
             method: "POST",
             json,
             timeoutMs: null,
             signal: payload?.signal,
-        }));
+        });
+        if (this.onRequest != null)
+            init = await this.onRequest(url, init);
+        const response = await this.asyncCaller.fetch(url, init);
         const runMetadata = getRunMetadataFromResponse(response);
         if (runMetadata)
             payload?.onRunCreated?.(runMetadata);
@@ -931,7 +938,7 @@ export class RunsClient extends BaseClient {
             options instanceof AbortSignal
             ? { signal: options }
             : options;
-        const response = await this.asyncCaller.fetch(...this.prepareFetchOptions(threadId != null
+        let [url, init] = this.prepareFetchOptions(threadId != null
             ? `/threads/${threadId}/runs/${runId}/stream`
             : `/runs/${runId}/stream`, {
             method: "GET",
@@ -944,7 +951,10 @@ export class RunsClient extends BaseClient {
                 cancel_on_disconnect: opts?.cancelOnDisconnect ? "1" : "0",
                 stream_mode: opts?.streamMode,
             },
-        }));
+        });
+        if (this.onRequest != null)
+            init = await this.onRequest(url, init);
+        const response = await this.asyncCaller.fetch(url, init);
         // eslint-disable-next-line @typescript-eslint/no-explicit-any
         const stream = (response.body || new ReadableStream({ start: (ctrl) => ctrl.close() }))
             .pipeThrough(BytesLineDecoder())
@@ -1162,14 +1172,17 @@ class UiClient extends BaseClient {
     }
     async getComponent(assistantId, agentName) {
         return UiClient.getOrCached(`${this.apiUrl}-${assistantId}-${agentName}`, async () => {
-            const response = await this.asyncCaller.fetch(...this.prepareFetchOptions(`/ui/${assistantId}`, {
+            let [url, init] = this.prepareFetchOptions(`/ui/${assistantId}`, {
                 headers: {
                     Accept: "text/html",
                     "Content-Type": "application/json",
                 },
                 method: "POST",
                 json: { name: agentName },
-            }));
+            });
+            if (this.onRequest != null)
+                init = await this.onRequest(url, init);
+            const response = await this.asyncCaller.fetch(url, init);
             return response.text();
         });
     }

package/dist/react/manager.cjs

@@ -138,10 +138,12 @@ class StreamManager {
                             options.callbacks.onDebugEvent?.(data, { namespace });
                         }
                         if (event === "values") {
-                            // don't update values on interrupt values event
-                            if ("__interrupt__" in data)
-                                continue;
-                            this.setStreamValues(data);
+                            if ("__interrupt__" in data) {
+                                this.setStreamValues((prev) => ({ ...prev, ...data }));
+                            }
+                            else {
+                                this.setStreamValues(data);
+                            }
                         }
                         if (this.matchEventType("messages", event, data)) {
                             const [serialized, metadata] = data;

package/dist/react/manager.js

@@ -135,10 +135,12 @@ export class StreamManager {
                             options.callbacks.onDebugEvent?.(data, { namespace });
                         }
                         if (event === "values") {
-                            // don't update values on interrupt values event
-                            if ("__interrupt__" in data)
-                                continue;
-                            this.setStreamValues(data);
+                            if ("__interrupt__" in data) {
+                                this.setStreamValues((prev) => ({ ...prev, ...data }));
+                            }
+                            else {
+                                this.setStreamValues(data);
+                            }
                         }
                         if (this.matchEventType("messages", event, data)) {
                             const [serialized, metadata] = data;

package/dist/react/stream.cjs

@@ -422,7 +422,18 @@ function useStream(options) {
             return branchContext.branchTree;
         },
         get interrupt() {
-            // Don't show the interrupt if the stream is loading
+            if (values != null &&
+                "__interrupt__" in values &&
+                Array.isArray(values.__interrupt__)) {
+                const valueInterrupts = values.__interrupt__;
+                if (valueInterrupts.length === 0)
+                    return { when: "breakpoint" };
+                if (valueInterrupts.length === 1)
+                    return valueInterrupts[0];
+                // TODO: fix the typing of interrupts if multiple interrupts are returned
+                return valueInterrupts;
+            }
+            // If we're deferring to old interrupt detection logic, don't show the interrupt if the stream is loading
             if (stream.isLoading)
                 return undefined;
             const interrupts = branchContext.threadHead?.tasks?.at(-1)?.interrupts;

package/dist/react/stream.js

@@ -418,7 +418,18 @@ export function useStream(options) {
             return branchContext.branchTree;
         },
         get interrupt() {
-            // Don't show the interrupt if the stream is loading
+            if (values != null &&
+                "__interrupt__" in values &&
+                Array.isArray(values.__interrupt__)) {
+                const valueInterrupts = values.__interrupt__;
+                if (valueInterrupts.length === 0)
+                    return { when: "breakpoint" };
+                if (valueInterrupts.length === 1)
+                    return valueInterrupts[0];
+                // TODO: fix the typing of interrupts if multiple interrupts are returned
+                return valueInterrupts;
+            }
+            // If we're deferring to old interrupt detection logic, don't show the interrupt if the stream is loading
             if (stream.isLoading)
                 return undefined;
             const interrupts = branchContext.threadHead?.tasks?.at(-1)?.interrupts;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@langchain/langgraph-sdk",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Client library for interacting with the LangGraph API",
   "type": "module",
   "scripts": {