@langchain/langgraph-sdk 0.0.34 → 0.0.36

package/dist/client.cjs

@@ -6,6 +6,7 @@ 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");
 const env_js_1 = require("./utils/env.cjs");
+const fetch_js_1 = require("./singletons/fetch.cjs");
 /**
  * Get the API key from the environment.
  * Precedence:
@@ -112,7 +113,7 @@ class BaseClient {
         return [targetUrl, mutatedOptions];
     }
     async fetch(path, options) {
-        const response = await this.asyncCaller.fetch(...this.prepareFetchOptions(path, options));
+        const response = await this.asyncCaller.call((0, fetch_js_1._getFetchImplementation)(), ...this.prepareFetchOptions(path, options));
         if (response.status === 202 || response.status === 204) {
             return undefined;
         }
@@ -518,7 +519,7 @@ class RunsClient extends BaseClient {
             if_not_exists: payload?.ifNotExists,
         };
         const endpoint = threadId == null ? `/runs/stream` : `/threads/${threadId}/runs/stream`;
-        const response = await this.asyncCaller.fetch(...this.prepareFetchOptions(endpoint, {
+        const response = await this.asyncCaller.call((0, fetch_js_1._getFetchImplementation)(), ...this.prepareFetchOptions(endpoint, {
             method: "POST",
             json,
             timeoutMs: null,
@@ -722,7 +723,7 @@ class RunsClient extends BaseClient {
             options instanceof AbortSignal
             ? { signal: options }
             : options;
-        const response = await this.asyncCaller.fetch(...this.prepareFetchOptions(`/threads/${threadId}/runs/${runId}/stream`, {
+        const response = await this.asyncCaller.call((0, fetch_js_1._getFetchImplementation)(), ...this.prepareFetchOptions(`/threads/${threadId}/runs/${runId}/stream`, {
             method: "GET",
             timeoutMs: null,
             signal: opts?.signal,

package/dist/client.d.ts

@@ -1,4 +1,4 @@
-import { Assistant, AssistantGraph, CancelAction, Config, DefaultValues, GraphSchema, Metadata, Run, RunStatus, Thread, ThreadState, Cron, AssistantVersion, Subgraphs, Checkpoint, SearchItemsResponse, ListNamespaceResponse, Item, ThreadStatus } from "./schema.js";
+import { Assistant, AssistantGraph, CancelAction, Config, DefaultValues, GraphSchema, Metadata, Run, RunStatus, Thread, ThreadState, Cron, AssistantVersion, Subgraphs, Checkpoint, SearchItemsResponse, ListNamespaceResponse, Item, ThreadStatus, CronCreateResponse, CronCreateForThreadResponse } from "./schema.js";
 import { AsyncCaller, AsyncCallerParams } from "./utils/async_caller.js";
 import { RunsCreatePayload, RunsStreamPayload, RunsWaitPayload, StreamEvent, CronsCreatePayload, OnConflictBehavior } from "./types.js";
 /**
@@ -46,14 +46,14 @@ export declare class CronsClient extends BaseClient {
      * @param payload Payload for creating a cron job.
      * @returns The created background run.
      */
-    createForThread(threadId: string, assistantId: string, payload?: CronsCreatePayload): Promise<Run>;
+    createForThread(threadId: string, assistantId: string, payload?: CronsCreatePayload): Promise<CronCreateForThreadResponse>;
     /**
      *
      * @param assistantId Assistant ID to use for this cron job.
      * @param payload Payload for creating a cron job.
      * @returns
      */
-    create(assistantId: string, payload?: CronsCreatePayload): Promise<Run>;
+    create(assistantId: string, payload?: CronsCreatePayload): Promise<CronCreateResponse>;
     /**
      *
      * @param cronId Cron ID of Cron job to delete.

package/dist/client.js

@@ -3,6 +3,7 @@ import { createParser, } from "./utils/eventsource-parser/index.js";
 import { IterableReadableStream } from "./utils/stream.js";
 import { mergeSignals } from "./utils/signals.js";
 import { getEnvironmentVariable } from "./utils/env.js";
+import { _getFetchImplementation } from "./singletons/fetch.js";
 /**
  * Get the API key from the environment.
  * Precedence:
@@ -108,7 +109,7 @@ class BaseClient {
         return [targetUrl, mutatedOptions];
     }
     async fetch(path, options) {
-        const response = await this.asyncCaller.fetch(...this.prepareFetchOptions(path, options));
+        const response = await this.asyncCaller.call(_getFetchImplementation(), ...this.prepareFetchOptions(path, options));
         if (response.status === 202 || response.status === 204) {
             return undefined;
         }
@@ -511,7 +512,7 @@ export class RunsClient extends BaseClient {
             if_not_exists: payload?.ifNotExists,
         };
         const endpoint = threadId == null ? `/runs/stream` : `/threads/${threadId}/runs/stream`;
-        const response = await this.asyncCaller.fetch(...this.prepareFetchOptions(endpoint, {
+        const response = await this.asyncCaller.call(_getFetchImplementation(), ...this.prepareFetchOptions(endpoint, {
             method: "POST",
             json,
             timeoutMs: null,
@@ -715,7 +716,7 @@ export class RunsClient extends BaseClient {
             options instanceof AbortSignal
             ? { signal: options }
             : options;
-        const response = await this.asyncCaller.fetch(...this.prepareFetchOptions(`/threads/${threadId}/runs/${runId}/stream`, {
+        const response = await this.asyncCaller.call(_getFetchImplementation(), ...this.prepareFetchOptions(`/threads/${threadId}/runs/${runId}/stream`, {
             method: "GET",
             timeoutMs: null,
             signal: opts?.signal,

package/dist/index.cjs

@@ -1,5 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Client = void 0;
+exports.overrideFetchImplementation = exports.Client = void 0;
 var client_js_1 = require("./client.cjs");
 Object.defineProperty(exports, "Client", { enumerable: true, get: function () { return client_js_1.Client; } });
+var fetch_js_1 = require("./singletons/fetch.cjs");
+Object.defineProperty(exports, "overrideFetchImplementation", { enumerable: true, get: function () { return fetch_js_1.overrideFetchImplementation; } });

package/dist/index.d.ts

@@ -1,3 +1,4 @@
 export { Client } from "./client.js";
 export type { Assistant, AssistantVersion, AssistantGraph, Config, DefaultValues, GraphSchema, Metadata, Run, Thread, ThreadTask, ThreadState, ThreadStatus, Cron, Checkpoint, Interrupt, } from "./schema.js";
+export { overrideFetchImplementation } from "./singletons/fetch.js";
 export type { OnConflictBehavior, Command } from "./types.js";

package/dist/index.js

@@ -1 +1,2 @@
 export { Client } from "./client.js";
+export { overrideFetchImplementation } from "./singletons/fetch.js";

package/dist/schema.d.ts

@@ -207,4 +207,20 @@ export interface SearchItem extends Item {
 export interface SearchItemsResponse {
     items: SearchItem[];
 }
+export interface CronCreateResponse {
+    cron_id: string;
+    assistant_id: string;
+    thread_id: string | undefined;
+    user_id: string;
+    payload: Record<string, unknown>;
+    schedule: string;
+    next_run_date: string;
+    end_time: string | undefined;
+    created_at: string;
+    updated_at: string;
+    metadata: Metadata;
+}
+export interface CronCreateForThreadResponse extends Omit<CronCreateResponse, "thread_id"> {
+    thread_id: string;
+}
 export {};

package/dist/singletons/fetch.cjs

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports._getFetchImplementation = exports.overrideFetchImplementation = void 0;
+// Wrap the default fetch call due to issues with illegal invocations
+// in some environments:
+// https://stackoverflow.com/questions/69876859/why-does-bind-fix-failed-to-execute-fetch-on-window-illegal-invocation-err
+// @ts-expect-error Broad typing to support a range of fetch implementations
+const DEFAULT_FETCH_IMPLEMENTATION = (...args) => fetch(...args);
+const LANGSMITH_FETCH_IMPLEMENTATION_KEY = Symbol.for("lg:fetch_implementation");
+/**
+ * Overrides the fetch implementation used for LangSmith calls.
+ * You should use this if you need to use an implementation of fetch
+ * other than the default global (e.g. for dealing with proxies).
+ * @param fetch The new fetch function to use.
+ */
+const overrideFetchImplementation = (fetch) => {
+    globalThis[LANGSMITH_FETCH_IMPLEMENTATION_KEY] = fetch;
+};
+exports.overrideFetchImplementation = overrideFetchImplementation;
+/**
+ * @internal
+ */
+const _getFetchImplementation = () => {
+    return (globalThis[LANGSMITH_FETCH_IMPLEMENTATION_KEY] ??
+        DEFAULT_FETCH_IMPLEMENTATION);
+};
+exports._getFetchImplementation = _getFetchImplementation;

package/dist/singletons/fetch.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Overrides the fetch implementation used for LangSmith calls.
+ * You should use this if you need to use an implementation of fetch
+ * other than the default global (e.g. for dealing with proxies).
+ * @param fetch The new fetch function to use.
+ */
+export declare const overrideFetchImplementation: (fetch: (...args: any[]) => any) => void;
+/**
+ * @internal
+ */
+export declare const _getFetchImplementation: () => (...args: any[]) => any;

package/dist/singletons/fetch.js

@@ -0,0 +1,22 @@
+// Wrap the default fetch call due to issues with illegal invocations
+// in some environments:
+// https://stackoverflow.com/questions/69876859/why-does-bind-fix-failed-to-execute-fetch-on-window-illegal-invocation-err
+// @ts-expect-error Broad typing to support a range of fetch implementations
+const DEFAULT_FETCH_IMPLEMENTATION = (...args) => fetch(...args);
+const LANGSMITH_FETCH_IMPLEMENTATION_KEY = Symbol.for("lg:fetch_implementation");
+/**
+ * Overrides the fetch implementation used for LangSmith calls.
+ * You should use this if you need to use an implementation of fetch
+ * other than the default global (e.g. for dealing with proxies).
+ * @param fetch The new fetch function to use.
+ */
+export const overrideFetchImplementation = (fetch) => {
+    globalThis[LANGSMITH_FETCH_IMPLEMENTATION_KEY] = fetch;
+};
+/**
+ * @internal
+ */
+export const _getFetchImplementation = () => {
+    return (globalThis[LANGSMITH_FETCH_IMPLEMENTATION_KEY] ??
+        DEFAULT_FETCH_IMPLEMENTATION);
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@langchain/langgraph-sdk",
-  "version": "0.0.34",
+  "version": "0.0.36",
   "description": "Client library for interacting with the LangGraph API",
   "type": "module",
   "packageManager": "yarn@1.22.19",
@@ -9,7 +9,8 @@
     "build": "yarn clean && yarn lc_build --create-entrypoints --pre --tree-shaking",
     "prepublish": "yarn run build",
     "format": "prettier --write src",
-    "lint": "prettier --check src && tsc --noEmit"
+    "lint": "prettier --check src && tsc --noEmit",
+    "test": "NODE_OPTIONS=--experimental-vm-modules jest --testPathIgnorePatterns=\\.int\\.test.ts"
   },
   "main": "index.js",
   "license": "MIT",
@@ -20,12 +21,16 @@
     "uuid": "^9.0.0"
   },
   "devDependencies": {
+    "@jest/globals": "^29.7.0",
     "@langchain/scripts": "^0.1.4",
     "@tsconfig/recommended": "^1.0.2",
+    "@types/jest": "^29.5.12",
     "@types/node": "^20.12.12",
     "@types/uuid": "^9.0.1",
     "concat-md": "^0.5.1",
+    "jest": "^29.7.0",
     "prettier": "^3.2.5",
+    "ts-jest": "^29.1.2",
     "typedoc": "^0.26.1",
     "typedoc-plugin-markdown": "^4.1.0",
     "typescript": "^5.4.5"