@langchain/langgraph-sdk 1.0.3 → 1.2.0

package/CHANGELOG.md

@@ -1,5 +1,28 @@
 # @langchain/langgraph-sdk
 
+## 1.2.0
+
+### Minor Changes
+
+- 379de5e: Fix tool calls arguments not being streamed to the client
+
+### Patch Changes
+
+- d08e484: Add support for sending `AbortSignal` to all SDK methods
+- d08e484: Fix `useStream().stop()` not cancelling creation of thread.
+
+## 1.1.0
+
+### Minor Changes
+
+- e19e76c: Rename `experimental_thread` to `thread`, allowing replacing built-in history fetching hook with React Query / SWR
+- fa6c009: Add throttle option to `useStream` and batch updates in a macrotask to prevent `Maximum update depth exceeded` error
+
+### Patch Changes
+
+- 35e8fc7: Add name parameter to assistants count API.
+- b78a738: feat(sdk): add `includePagination` property when searching from assistants
+
 ## 1.0.3
 
 ### Patch Changes

package/dist/client.cjs

@@ -177,7 +177,8 @@ var CronsClient = class extends BaseClient {
 		};
 		return this.fetch(`/threads/${threadId}/runs/crons`, {
 			method: "POST",
-			json
+			json,
+			signal: payload?.signal
 		});
 	}
 	/**
@@ -204,15 +205,19 @@ var CronsClient = class extends BaseClient {
 		};
 		return this.fetch(`/runs/crons`, {
 			method: "POST",
-			json
+			json,
+			signal: payload?.signal
 		});
 	}
 	/**
 	*
 	* @param cronId Cron ID of Cron job to delete.
 	*/
-	async delete(cronId) {
-		await this.fetch(`/runs/crons/${cronId}`, { method: "DELETE" });
+	async delete(cronId, options) {
+		await this.fetch(`/runs/crons/${cronId}`, {
+			method: "DELETE",
+			signal: options?.signal
+		});
 	}
 	/**
 	*
@@ -230,7 +235,8 @@ var CronsClient = class extends BaseClient {
 				sort_by: query?.sortBy ?? void 0,
 				sort_order: query?.sortOrder ?? void 0,
 				select: query?.select ?? void 0
-			}
+			},
+			signal: query?.signal
 		});
 	}
 	/**
@@ -246,7 +252,8 @@ var CronsClient = class extends BaseClient {
 			json: {
 				assistant_id: query?.assistantId ?? void 0,
 				thread_id: query?.threadId ?? void 0
-			}
+			},
+			signal: query?.signal
 		});
 	}
 };
@@ -257,8 +264,8 @@ var AssistantsClient = class extends BaseClient {
 	* @param assistantId The ID of the assistant.
 	* @returns Assistant
 	*/
-	async get(assistantId) {
-		return this.fetch(`/assistants/${assistantId}`);
+	async get(assistantId, options) {
+		return this.fetch(`/assistants/${assistantId}`, { signal: options?.signal });
 	}
 	/**
 	* Get the JSON representation of the graph assigned to a runnable
@@ -267,15 +274,18 @@ var AssistantsClient = class extends BaseClient {
 	* @returns Serialized graph
 	*/
 	async getGraph(assistantId, options) {
-		return this.fetch(`/assistants/${assistantId}/graph`, { params: { xray: options?.xray } });
+		return this.fetch(`/assistants/${assistantId}/graph`, {
+			params: { xray: options?.xray },
+			signal: options?.signal
+		});
 	}
 	/**
 	* Get the state and config schema of the graph assigned to a runnable
 	* @param assistantId The ID of the assistant.
 	* @returns Graph schema
 	*/
-	async getSchemas(assistantId) {
-		return this.fetch(`/assistants/${assistantId}/schemas`);
+	async getSchemas(assistantId, options) {
+		return this.fetch(`/assistants/${assistantId}/schemas`, { signal: options?.signal });
 	}
 	/**
 	* Get the schemas of an assistant by ID.
@@ -285,8 +295,14 @@ var AssistantsClient = class extends BaseClient {
 	* @returns The subgraphs of the assistant.
 	*/
 	async getSubgraphs(assistantId, options) {
-		if (options?.namespace) return this.fetch(`/assistants/${assistantId}/subgraphs/${options.namespace}`, { params: { recurse: options?.recurse } });
-		return this.fetch(`/assistants/${assistantId}/subgraphs`, { params: { recurse: options?.recurse } });
+		if (options?.namespace) return this.fetch(`/assistants/${assistantId}/subgraphs/${options.namespace}`, {
+			params: { recurse: options?.recurse },
+			signal: options?.signal
+		});
+		return this.fetch(`/assistants/${assistantId}/subgraphs`, {
+			params: { recurse: options?.recurse },
+			signal: options?.signal
+		});
 	}
 	/**
 	* Create a new assistant.
@@ -305,7 +321,8 @@ var AssistantsClient = class extends BaseClient {
 				if_exists: payload.ifExists,
 				name: payload.name,
 				description: payload.description
-			}
+			},
+			signal: payload.signal
 		});
 	}
 	/**
@@ -324,7 +341,8 @@ var AssistantsClient = class extends BaseClient {
 				metadata: payload.metadata,
 				name: payload.name,
 				description: payload.description
-			}
+			},
+			signal: payload.signal
 		});
 	}
 	/**
@@ -332,34 +350,44 @@ var AssistantsClient = class extends BaseClient {
 	*
 	* @param assistantId ID of the assistant.
 	*/
-	async delete(assistantId) {
-		return this.fetch(`/assistants/${assistantId}`, { method: "DELETE" });
+	async delete(assistantId, options) {
+		return this.fetch(`/assistants/${assistantId}`, {
+			method: "DELETE",
+			signal: options?.signal
+		});
 	}
-	/**
-	* List assistants.
-	* @param query Query options.
-	* @returns List of assistants.
-	*/
 	async search(query) {
-		return this.fetch("/assistants/search", {
+		const json = {
+			graph_id: query?.graphId ?? void 0,
+			name: query?.name ?? void 0,
+			metadata: query?.metadata ?? void 0,
+			limit: query?.limit ?? 10,
+			offset: query?.offset ?? 0,
+			sort_by: query?.sortBy ?? void 0,
+			sort_order: query?.sortOrder ?? void 0,
+			select: query?.select ?? void 0
+		};
+		const [assistants, response] = await this.fetch("/assistants/search", {
 			method: "POST",
-			json: {
-				graph_id: query?.graphId ?? void 0,
-				name: query?.name ?? void 0,
-				metadata: query?.metadata ?? void 0,
-				limit: query?.limit ?? 10,
-				offset: query?.offset ?? 0,
-				sort_by: query?.sortBy ?? void 0,
-				sort_order: query?.sortOrder ?? void 0,
-				select: query?.select ?? void 0
-			}
+			json,
+			withResponse: true,
+			signal: query?.signal
 		});
+		if (query?.includePagination) {
+			const next = response.headers.get("X-Pagination-Next");
+			return {
+				assistants,
+				next
+			};
+		}
+		return assistants;
 	}
 	/**
 	* Count assistants matching filters.
 	*
 	* @param query.metadata Metadata to filter by. Exact match for each key/value.
 	* @param query.graphId Optional graph id to filter by.
+	* @param query.name Optional name to filter by.
 	* @returns Number of assistants matching the criteria.
 	*/
 	async count(query) {
@@ -367,8 +395,10 @@ var AssistantsClient = class extends BaseClient {
 			method: "POST",
 			json: {
 				metadata: query?.metadata ?? void 0,
-				graph_id: query?.graphId ?? void 0
-			}
+				graph_id: query?.graphId ?? void 0,
+				name: query?.name ?? void 0
+			},
+			signal: query?.signal
 		});
 	}
 	/**
@@ -384,7 +414,8 @@ var AssistantsClient = class extends BaseClient {
 				metadata: payload?.metadata ?? void 0,
 				limit: payload?.limit ?? 10,
 				offset: payload?.offset ?? 0
-			}
+			},
+			signal: payload?.signal
 		});
 	}
 	/**
@@ -394,10 +425,11 @@ var AssistantsClient = class extends BaseClient {
 	* @param version The version to change to.
 	* @returns The updated assistant.
 	*/
-	async setLatest(assistantId, version) {
+	async setLatest(assistantId, version, options) {
 		return this.fetch(`/assistants/${assistantId}/latest`, {
 			method: "POST",
-			json: { version }
+			json: { version },
+			signal: options?.signal
 		});
 	}
 };
@@ -408,8 +440,8 @@ var ThreadsClient = class extends BaseClient {
 	* @param threadId ID of the thread.
 	* @returns The thread.
 	*/
-	async get(threadId) {
-		return this.fetch(`/threads/${threadId}`);
+	async get(threadId, options) {
+		return this.fetch(`/threads/${threadId}`, { signal: options?.signal });
 	}
 	/**
 	* Create a new thread.
@@ -437,7 +469,8 @@ var ThreadsClient = class extends BaseClient {
 					as_node: u.asNode
 				})) })),
 				ttl: ttlPayload
-			}
+			},
+			signal: payload?.signal
 		});
 	}
 	/**
@@ -445,8 +478,11 @@ var ThreadsClient = class extends BaseClient {
 	* @param threadId ID of the thread to be copied
 	* @returns Newly copied thread
 	*/
-	async copy(threadId) {
-		return this.fetch(`/threads/${threadId}/copy`, { method: "POST" });
+	async copy(threadId, options) {
+		return this.fetch(`/threads/${threadId}/copy`, {
+			method: "POST",
+			signal: options?.signal
+		});
 	}
 	/**
 	* Update a thread.
@@ -465,7 +501,8 @@ var ThreadsClient = class extends BaseClient {
 			json: {
 				metadata: payload?.metadata,
 				ttl: ttlPayload
-			}
+			},
+			signal: payload?.signal
 		});
 	}
 	/**
@@ -473,8 +510,11 @@ var ThreadsClient = class extends BaseClient {
 	*
 	* @param threadId ID of the thread.
 	*/
-	async delete(threadId) {
-		return this.fetch(`/threads/${threadId}`, { method: "DELETE" });
+	async delete(threadId, options) {
+		return this.fetch(`/threads/${threadId}`, {
+			method: "DELETE",
+			signal: options?.signal
+		});
 	}
 	/**
 	* List threads
@@ -495,7 +535,8 @@ var ThreadsClient = class extends BaseClient {
 				sort_order: query?.sortOrder,
 				select: query?.select ?? void 0,
 				values: query?.values ?? void 0
-			}
+			},
+			signal: query?.signal
 		});
 	}
 	/**
@@ -513,7 +554,8 @@ var ThreadsClient = class extends BaseClient {
 				metadata: query?.metadata ?? void 0,
 				values: query?.values ?? void 0,
 				status: query?.status ?? void 0
-			}
+			},
+			signal: query?.signal
 		});
 	}
 	/**
@@ -529,11 +571,18 @@ var ThreadsClient = class extends BaseClient {
 				json: {
 					checkpoint,
 					subgraphs: options?.subgraphs
-				}
+				},
+				signal: options?.signal
+			});
+			return this.fetch(`/threads/${threadId}/state/${checkpoint}`, {
+				params: { subgraphs: options?.subgraphs },
+				signal: options?.signal
 			});
-			return this.fetch(`/threads/${threadId}/state/${checkpoint}`, { params: { subgraphs: options?.subgraphs } });
 		}
-		return this.fetch(`/threads/${threadId}/state`, { params: { subgraphs: options?.subgraphs } });
+		return this.fetch(`/threads/${threadId}/state`, {
+			params: { subgraphs: options?.subgraphs },
+			signal: options?.signal
+		});
 	}
 	/**
 	* Add state to a thread.
@@ -549,7 +598,8 @@ var ThreadsClient = class extends BaseClient {
 				checkpoint_id: options.checkpointId,
 				checkpoint: options.checkpoint,
 				as_node: options?.asNode
-			}
+			},
+			signal: options?.signal
 		});
 	}
 	/**
@@ -558,7 +608,7 @@ var ThreadsClient = class extends BaseClient {
 	* @param threadIdOrConfig Thread ID or config to patch the state of.
 	* @param metadata Metadata to patch the state with.
 	*/
-	async patchState(threadIdOrConfig, metadata) {
+	async patchState(threadIdOrConfig, metadata, options) {
 		let threadId;
 		if (typeof threadIdOrConfig !== "string") {
 			if (typeof threadIdOrConfig.configurable?.thread_id !== "string") throw new Error("Thread ID is required when updating state with a config.");
@@ -566,7 +616,8 @@ var ThreadsClient = class extends BaseClient {
 		} else threadId = threadIdOrConfig;
 		return this.fetch(`/threads/${threadId}/state`, {
 			method: "PATCH",
-			json: { metadata }
+			json: { metadata },
+			signal: options?.signal
 		});
 	}
 	/**
@@ -584,14 +635,16 @@ var ThreadsClient = class extends BaseClient {
 				before: options?.before,
 				metadata: options?.metadata,
 				checkpoint: options?.checkpoint
-			}
+			},
+			signal: options?.signal
 		});
 	}
 	async *joinStream(threadId, options) {
 		let [url, init] = this.prepareFetchOptions(`/threads/${threadId}/stream`, {
 			method: "GET",
 			headers: options?.lastEventId ? { "Last-Event-ID": options.lastEventId } : void 0,
-			params: options?.streamMode ? { stream_mode: options.streamMode } : void 0
+			params: options?.streamMode ? { stream_mode: options.streamMode } : void 0,
+			signal: options?.signal
 		});
 		if (this.onRequest != null) init = await this.onRequest(url, init);
 		const response = await this.asyncCaller.fetch(url, init);
@@ -697,7 +750,7 @@ var RunsClient = class extends BaseClient {
 	* @param payloads An array of payloads for creating runs.
 	* @returns An array of created runs.
 	*/
-	async createBatch(payloads) {
+	async createBatch(payloads, options) {
 		const filteredPayloads = payloads.map((payload) => ({
 			...payload,
 			assistant_id: payload.assistantId
@@ -706,7 +759,8 @@ var RunsClient = class extends BaseClient {
 		});
 		return this.fetch("/runs/batch", {
 			method: "POST",
-			json: filteredPayloads
+			json: filteredPayloads,
+			signal: options?.signal
 		});
 	}
 	/**
@@ -764,12 +818,15 @@ var RunsClient = class extends BaseClient {
 	* @returns List of runs.
 	*/
 	async list(threadId, options) {
-		return this.fetch(`/threads/${threadId}/runs`, { params: {
-			limit: options?.limit ?? 10,
-			offset: options?.offset ?? 0,
-			status: options?.status ?? void 0,
-			select: options?.select ?? void 0
-		} });
+		return this.fetch(`/threads/${threadId}/runs`, {
+			params: {
+				limit: options?.limit ?? 10,
+				offset: options?.offset ?? 0,
+				status: options?.status ?? void 0,
+				select: options?.select ?? void 0
+			},
+			signal: options?.signal
+		});
 	}
 	/**
 	* Get a run by ID.
@@ -778,8 +835,8 @@ var RunsClient = class extends BaseClient {
 	* @param runId The ID of the run.
 	* @returns The run.
 	*/
-	async get(threadId, runId) {
-		return this.fetch(`/threads/${threadId}/runs/${runId}`);
+	async get(threadId, runId, options) {
+		return this.fetch(`/threads/${threadId}/runs/${runId}`, { signal: options?.signal });
 	}
 	/**
 	* Cancel a run.
@@ -790,13 +847,14 @@ var RunsClient = class extends BaseClient {
 	* @param action Action to take when cancelling the run. Possible values are `interrupt` or `rollback`. Default is `interrupt`.
 	* @returns
 	*/
-	async cancel(threadId, runId, wait = false, action = "interrupt") {
+	async cancel(threadId, runId, wait = false, action = "interrupt", options = {}) {
 		return this.fetch(`/threads/${threadId}/runs/${runId}/cancel`, {
 			method: "POST",
 			params: {
 				wait: wait ? "1" : "0",
 				action
-			}
+			},
+			signal: options?.signal
 		});
 	}
 	/**
@@ -850,8 +908,11 @@ var RunsClient = class extends BaseClient {
 	* @param runId The ID of the run.
 	* @returns
 	*/
-	async delete(threadId, runId) {
-		return this.fetch(`/threads/${threadId}/runs/${runId}`, { method: "DELETE" });
+	async delete(threadId, runId, options) {
+		return this.fetch(`/threads/${threadId}/runs/${runId}`, {
+			method: "DELETE",
+			signal: options?.signal
+		});
 	}
 };
 var StoreClient = class extends BaseClient {
@@ -888,7 +949,8 @@ var StoreClient = class extends BaseClient {
 		};
 		return this.fetch("/store/items", {
 			method: "PUT",
-			json: payload
+			json: payload,
+			signal: options?.signal
 		});
 	}
 	/**
@@ -925,7 +987,10 @@ var StoreClient = class extends BaseClient {
 			key
 		};
 		if (options?.refreshTtl !== void 0) params.refresh_ttl = options.refreshTtl;
-		const response = await this.fetch("/store/items", { params });
+		const response = await this.fetch("/store/items", {
+			params,
+			signal: options?.signal
+		});
 		return response ? {
 			...response,
 			createdAt: response.created_at,
@@ -939,7 +1004,7 @@ var StoreClient = class extends BaseClient {
 	* @param key The unique identifier for the item.
 	* @returns Promise<void>
 	*/
-	async deleteItem(namespace, key) {
+	async deleteItem(namespace, key, options) {
 		namespace.forEach((label) => {
 			if (label.includes(".")) throw new Error(`Invalid namespace label '${label}'. Namespace labels cannot contain periods ('.')`);
 		});
@@ -948,7 +1013,8 @@ var StoreClient = class extends BaseClient {
 			json: {
 				namespace,
 				key
-			}
+			},
+			signal: options?.signal
 		});
 	}
 	/**
@@ -998,7 +1064,8 @@ var StoreClient = class extends BaseClient {
 		};
 		const response = await this.fetch("/store/items/search", {
 			method: "POST",
-			json: payload
+			json: payload,
+			signal: options?.signal
 		});
 		return { items: response.items.map((item) => ({
 			...item,
@@ -1026,7 +1093,8 @@ var StoreClient = class extends BaseClient {
 		};
 		return this.fetch("/store/namespaces", {
 			method: "POST",
-			json: payload
+			json: payload,
+			signal: options?.signal
 		});
 	}
 };