@langchain/langgraph-sdk 0.0.17 → 0.0.19

package/dist/client.cjs

@@ -4,6 +4,7 @@ exports.Client = exports.StoreClient = exports.RunsClient = exports.ThreadsClien
 const async_caller_js_1 = require("./utils/async_caller.cjs");
 const index_js_1 = require("./utils/eventsource-parser/index.cjs");
 const stream_js_1 = require("./utils/stream.cjs");
+const signals_js_1 = require("./utils/signals.cjs");
 class BaseClient {
     constructor(config) {
         Object.defineProperty(this, "asyncCaller", {
@@ -36,6 +37,8 @@ class BaseClient {
             ...config?.callerOptions,
         });
         this.timeoutMs = config?.timeoutMs || 12_000;
+        // default limit being capped by Chrome
+        // https://github.com/nodejs/undici/issues/1373
         this.apiUrl = config?.apiUrl || "http://localhost:8123";
         this.defaultHeaders = config?.defaultHeaders || {};
         if (config?.apiKey != null) {
@@ -55,6 +58,16 @@ class BaseClient {
             };
             delete mutatedOptions.json;
         }
+        let timeoutSignal = null;
+        if (typeof options?.timeoutMs !== "undefined") {
+            if (options.timeoutMs != null) {
+                timeoutSignal = AbortSignal.timeout(options.timeoutMs);
+            }
+        }
+        else {
+            timeoutSignal = AbortSignal.timeout(this.timeoutMs);
+        }
+        mutatedOptions.signal = (0, signals_js_1.mergeSignals)(timeoutSignal, mutatedOptions.signal);
         const targetUrl = new URL(`${this.apiUrl}${path}`);
         if (mutatedOptions.params) {
             for (const [key, value] of Object.entries(mutatedOptions.params)) {
@@ -474,6 +487,7 @@ class RunsClient extends BaseClient {
         const response = await this.asyncCaller.fetch(...this.prepareFetchOptions(endpoint, {
             method: "POST",
             json,
+            timeoutMs: null,
             signal: payload?.signal,
         }));
         let parser;
@@ -579,11 +593,22 @@ class RunsClient extends BaseClient {
             after_seconds: payload?.afterSeconds,
         };
         const endpoint = threadId == null ? `/runs/wait` : `/threads/${threadId}/runs/wait`;
-        return this.fetch(endpoint, {
+        const response = await this.fetch(endpoint, {
             method: "POST",
             json,
+            timeoutMs: null,
             signal: payload?.signal,
         });
+        const raiseError = payload?.raiseError !== undefined ? payload.raiseError : true;
+        if (raiseError &&
+            "__error__" in response &&
+            typeof response.__error__ === "object" &&
+            response.__error__ &&
+            "error" in response.__error__ &&
+            "message" in response.__error__) {
+            throw new Error(`${response.__error__?.error}: ${response.__error__?.message}`);
+        }
+        return response;
     }
     /**
      * List all runs for a thread.
@@ -633,8 +658,11 @@ class RunsClient extends BaseClient {
      * @param runId The ID of the run.
      * @returns
      */
-    async join(threadId, runId) {
-        return this.fetch(`/threads/${threadId}/runs/${runId}/join`);
+    async join(threadId, runId, options) {
+        return this.fetch(`/threads/${threadId}/runs/${runId}/join`, {
+            timeoutMs: null,
+            signal: options?.signal,
+        });
     }
     /**
      * Stream output from a run in real-time, until the run is done.
@@ -649,6 +677,7 @@ class RunsClient extends BaseClient {
     async *joinStream(threadId, runId, signal) {
         const response = await this.asyncCaller.fetch(...this.prepareFetchOptions(`/threads/${threadId}/runs/${runId}/stream`, {
             method: "GET",
+            timeoutMs: null,
             signal,
         }));
         let parser;

package/dist/client.d.ts

@@ -17,10 +17,13 @@ declare class BaseClient {
     protected prepareFetchOptions(path: string, options?: RequestInit & {
         json?: unknown;
         params?: Record<string, unknown>;
+        timeoutMs?: number | null;
     }): [url: URL, init: RequestInit];
     protected fetch<T>(path: string, options?: RequestInit & {
         json?: unknown;
         params?: Record<string, unknown>;
+        timeoutMs?: number | null;
+        signal?: AbortSignal;
     }): Promise<T>;
 }
 export declare class CronsClient extends BaseClient {
@@ -334,7 +337,9 @@ export declare class RunsClient extends BaseClient {
      * @param runId The ID of the run.
      * @returns
      */
-    join(threadId: string, runId: string): Promise<void>;
+    join(threadId: string, runId: string, options?: {
+        signal?: AbortSignal;
+    }): Promise<void>;
     /**
      * Stream output from a run in real-time, until the run is done.
      * Output is not buffered, so any output produced before this call will

package/dist/client.js

@@ -1,6 +1,7 @@
 import { AsyncCaller } from "./utils/async_caller.js";
 import { createParser, } from "./utils/eventsource-parser/index.js";
 import { IterableReadableStream } from "./utils/stream.js";
+import { mergeSignals } from "./utils/signals.js";
 class BaseClient {
     constructor(config) {
         Object.defineProperty(this, "asyncCaller", {
@@ -33,6 +34,8 @@ class BaseClient {
             ...config?.callerOptions,
         });
         this.timeoutMs = config?.timeoutMs || 12_000;
+        // default limit being capped by Chrome
+        // https://github.com/nodejs/undici/issues/1373
         this.apiUrl = config?.apiUrl || "http://localhost:8123";
         this.defaultHeaders = config?.defaultHeaders || {};
         if (config?.apiKey != null) {
@@ -52,6 +55,16 @@ class BaseClient {
             };
             delete mutatedOptions.json;
         }
+        let timeoutSignal = null;
+        if (typeof options?.timeoutMs !== "undefined") {
+            if (options.timeoutMs != null) {
+                timeoutSignal = AbortSignal.timeout(options.timeoutMs);
+            }
+        }
+        else {
+            timeoutSignal = AbortSignal.timeout(this.timeoutMs);
+        }
+        mutatedOptions.signal = mergeSignals(timeoutSignal, mutatedOptions.signal);
         const targetUrl = new URL(`${this.apiUrl}${path}`);
         if (mutatedOptions.params) {
             for (const [key, value] of Object.entries(mutatedOptions.params)) {
@@ -468,6 +481,7 @@ export class RunsClient extends BaseClient {
         const response = await this.asyncCaller.fetch(...this.prepareFetchOptions(endpoint, {
             method: "POST",
             json,
+            timeoutMs: null,
             signal: payload?.signal,
         }));
         let parser;
@@ -573,11 +587,22 @@ export class RunsClient extends BaseClient {
             after_seconds: payload?.afterSeconds,
         };
         const endpoint = threadId == null ? `/runs/wait` : `/threads/${threadId}/runs/wait`;
-        return this.fetch(endpoint, {
+        const response = await this.fetch(endpoint, {
             method: "POST",
             json,
+            timeoutMs: null,
             signal: payload?.signal,
         });
+        const raiseError = payload?.raiseError !== undefined ? payload.raiseError : true;
+        if (raiseError &&
+            "__error__" in response &&
+            typeof response.__error__ === "object" &&
+            response.__error__ &&
+            "error" in response.__error__ &&
+            "message" in response.__error__) {
+            throw new Error(`${response.__error__?.error}: ${response.__error__?.message}`);
+        }
+        return response;
     }
     /**
      * List all runs for a thread.
@@ -627,8 +652,11 @@ export class RunsClient extends BaseClient {
      * @param runId The ID of the run.
      * @returns
      */
-    async join(threadId, runId) {
-        return this.fetch(`/threads/${threadId}/runs/${runId}/join`);
+    async join(threadId, runId, options) {
+        return this.fetch(`/threads/${threadId}/runs/${runId}/join`, {
+            timeoutMs: null,
+            signal: options?.signal,
+        });
     }
     /**
      * Stream output from a run in real-time, until the run is done.
@@ -643,6 +671,7 @@ export class RunsClient extends BaseClient {
     async *joinStream(threadId, runId, signal) {
         const response = await this.asyncCaller.fetch(...this.prepareFetchOptions(`/threads/${threadId}/runs/${runId}/stream`, {
             method: "GET",
+            timeoutMs: null,
             signal,
         }));
         let parser;

package/dist/schema.d.ts

@@ -1,7 +1,7 @@
 import type { JSONSchema7 } from "json-schema";
 type Optional<T> = T | null | undefined;
 type RunStatus = "pending" | "running" | "error" | "success" | "timeout" | "interrupted";
-type ThreadStatus = "idle" | "busy" | "interrupted";
+type ThreadStatus = "idle" | "busy" | "interrupted" | "error";
 type MultitaskStrategy = "reject" | "interrupt" | "rollback" | "enqueue";
 export interface Config {
     /**

package/dist/types.d.ts

@@ -102,5 +102,10 @@ export interface CronsCreatePayload extends RunsCreatePayload {
      */
     schedule: string;
 }
-export type RunsWaitPayload = RunsStreamPayload;
+export interface RunsWaitPayload extends RunsStreamPayload {
+    /**
+     * Raise errors returned by the run. Default is `true`.
+     */
+    raiseError?: boolean;
+}
 export {};

package/dist/utils/signals.cjs

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mergeSignals = void 0;
+function mergeSignals(...signals) {
+    const nonZeroSignals = signals.filter((signal) => signal != null);
+    if (nonZeroSignals.length === 0)
+        return undefined;
+    if (nonZeroSignals.length === 1)
+        return nonZeroSignals[0];
+    const controller = new AbortController();
+    for (const signal of signals) {
+        if (signal?.aborted) {
+            controller.abort(signal.reason);
+            return controller.signal;
+        }
+        signal?.addEventListener("abort", () => controller.abort(signal.reason), {
+            once: true,
+        });
+    }
+    return controller.signal;
+}
+exports.mergeSignals = mergeSignals;

package/dist/utils/signals.d.ts

@@ -0,0 +1 @@
+export declare function mergeSignals(...signals: (AbortSignal | null | undefined)[]): AbortSignal | undefined;

package/dist/utils/signals.js

@@ -0,0 +1,18 @@
+export function mergeSignals(...signals) {
+    const nonZeroSignals = signals.filter((signal) => signal != null);
+    if (nonZeroSignals.length === 0)
+        return undefined;
+    if (nonZeroSignals.length === 1)
+        return nonZeroSignals[0];
+    const controller = new AbortController();
+    for (const signal of signals) {
+        if (signal?.aborted) {
+            controller.abort(signal.reason);
+            return controller.signal;
+        }
+        signal?.addEventListener("abort", () => controller.abort(signal.reason), {
+            once: true,
+        });
+    }
+    return controller.signal;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@langchain/langgraph-sdk",
-  "version": "0.0.17",
+  "version": "0.0.19",
   "description": "Client library for interacting with the LangGraph API",
   "type": "module",
   "packageManager": "yarn@1.22.19",