@langchain/langgraph-sdk 0.0.65 → 0.0.67

package/dist/auth/index.cjs

@@ -3,6 +3,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.HTTPException = exports.Auth = void 0;
 class Auth {
     constructor() {
+        /**
+         * @internal
+         * @ignore
+         */
         Object.defineProperty(this, "~handlerCache", {
             enumerable: true,
             configurable: true,

package/dist/auth/index.d.ts

@@ -1,5 +1,9 @@
 import type { AuthenticateCallback, AnyCallback, CallbackEvent, OnCallback, BaseAuthReturn, ToUserLike, BaseUser } from "./types.js";
 export declare class Auth<TExtra = {}, TAuthReturn extends BaseAuthReturn = BaseAuthReturn, TUser extends BaseUser = ToUserLike<TAuthReturn>> {
+    /**
+     * @internal
+     * @ignore
+     */
     "~handlerCache": {
         authenticate?: AuthenticateCallback<BaseAuthReturn>;
         callbacks?: Record<string, AnyCallback>;
@@ -7,5 +11,5 @@ export declare class Auth<TExtra = {}, TAuthReturn extends BaseAuthReturn = Base
     authenticate<T extends BaseAuthReturn>(cb: AuthenticateCallback<T>): Auth<TExtra, T>;
     on<T extends CallbackEvent>(event: T, callback: OnCallback<T, TUser>): this;
 }
-export type { Filters, ResourceActionType } from "./types.js";
+export type { Filters as AuthFilters, EventValueMap as AuthEventValueMap, } from "./types.js";
 export { HTTPException } from "./error.js";

package/dist/auth/index.js

@@ -1,5 +1,9 @@
 export class Auth {
     constructor() {
+        /**
+         * @internal
+         * @ignore
+         */
         Object.defineProperty(this, "~handlerCache", {
             enumerable: true,
             configurable: true,

package/dist/auth/types.d.ts

@@ -9,6 +9,9 @@ interface AssistantConfig {
         [key: string]: unknown;
     }>;
 }
+/**
+ * @inline
+ */
 interface AssistantCreate {
     assistant_id?: Maybe<string>;
     metadata?: Maybe<Record<string, unknown>>;
@@ -17,10 +20,16 @@ interface AssistantCreate {
     name?: Maybe<string>;
     graph_id: string;
 }
+/**
+ * @inline
+ */
 interface AssistantRead {
     assistant_id: string;
     metadata?: Maybe<Record<string, unknown>>;
 }
+/**
+ * @inline
+ */
 interface AssistantUpdate {
     assistant_id: string;
     metadata?: Maybe<Record<string, unknown>>;
@@ -29,32 +38,53 @@ interface AssistantUpdate {
     name?: Maybe<string>;
     version?: Maybe<number>;
 }
+/**
+ * @inline
+ */
 interface AssistantDelete {
     assistant_id: string;
 }
+/**
+ * @inline
+ */
 interface AssistantSearch {
     graph_id?: Maybe<string>;
     metadata?: Maybe<Record<string, unknown>>;
     limit?: Maybe<number>;
     offset?: Maybe<number>;
 }
+/**
+ * @inline
+ */
 interface ThreadCreate {
     thread_id?: Maybe<string>;
     metadata?: Maybe<Record<string, unknown>>;
     if_exists?: Maybe<"raise" | "do_nothing">;
 }
+/**
+ * @inline
+ */
 interface ThreadRead {
     thread_id?: Maybe<string>;
 }
+/**
+ * @inline
+ */
 interface ThreadUpdate {
     thread_id?: Maybe<string>;
     metadata?: Maybe<Record<string, unknown>>;
     action?: Maybe<"interrupt" | "rollback">;
 }
+/**
+ * @inline
+ */
 interface ThreadDelete {
     thread_id?: Maybe<string>;
     run_id?: Maybe<string>;
 }
+/**
+ * @inline
+ */
 interface ThreadSearch {
     thread_id?: Maybe<string>;
     status?: Maybe<"idle" | "busy" | "interrupted" | "error" | (string & {})>;
@@ -63,6 +93,9 @@ interface ThreadSearch {
     limit?: Maybe<number>;
     offset?: Maybe<number>;
 }
+/**
+ * @inline
+ */
 interface CronCreate {
     payload?: Maybe<Record<string, unknown>>;
     schedule: string;
@@ -71,32 +104,53 @@ interface CronCreate {
     user_id?: Maybe<string>;
     end_time?: Maybe<string>;
 }
+/**
+ * @inline
+ */
 interface CronRead {
     cron_id: string;
 }
+/**
+ * @inline
+ */
 interface CronUpdate {
     cron_id: string;
     payload?: Maybe<Record<string, unknown>>;
     schedule?: Maybe<string>;
 }
+/**
+ * @inline
+ */
 interface CronDelete {
     cron_id: string;
 }
+/**
+ * @inline
+ */
 interface CronSearch {
     assistant_id?: Maybe<string>;
     thread_id?: Maybe<string>;
     limit?: Maybe<number>;
     offset?: Maybe<number>;
 }
+/**
+ * @inline
+ */
 interface StorePut {
     namespace: string[];
     key: string;
     value: Record<string, unknown>;
 }
+/**
+ * @inline
+ */
 interface StoreGet {
     namespace: Maybe<string[]>;
     key: string;
 }
+/**
+ * @inline
+ */
 interface StoreSearch {
     namespace?: Maybe<string[]>;
     filter?: Maybe<Record<string, unknown>>;
@@ -104,6 +158,9 @@ interface StoreSearch {
     offset?: Maybe<number>;
     query?: Maybe<string>;
 }
+/**
+ * @inline
+ */
 interface StoreListNamespaces {
     namespace?: Maybe<string[]>;
     suffix?: Maybe<string[]>;
@@ -111,10 +168,16 @@ interface StoreListNamespaces {
     limit?: Maybe<number>;
     offset?: Maybe<number>;
 }
+/**
+ * @inline
+ */
 interface StoreDelete {
     namespace?: Maybe<string[]>;
     key: string;
 }
+/**
+ * @inline
+ */
 interface RunsCreate {
     thread_id?: Maybe<string>;
     assistant_id: string;
@@ -127,7 +190,7 @@ interface RunsCreate {
     after_seconds?: Maybe<number>;
     kwargs: Record<string, unknown>;
 }
-export interface ResourceActionType {
+export interface EventValueMap {
     ["threads:create"]: ThreadCreate;
     ["threads:read"]: ThreadRead;
     ["threads:update"]: ThreadUpdate;
@@ -188,7 +251,8 @@ export type ToUserLike<T extends BaseAuthReturn> = T extends string ? {
     is_authenticated: boolean;
     display_name: string;
 };
-type CallbackParameter<Resource extends string = string, Action extends string = string, Value extends unknown = unknown, TUser extends BaseUser = BaseUser> = {
+type CallbackParameter<Event extends string = string, Resource extends string = string, Action extends string = string, Value extends unknown = unknown, TUser extends BaseUser = BaseUser> = {
+    event: Event;
     resource: Resource;
     action: Action;
     value: Value;
@@ -196,12 +260,12 @@ type CallbackParameter<Resource extends string = string, Action extends string =
     permissions: string[];
 };
 type ContextMap = {
-    [ActionType in keyof ResourceActionType]: CallbackParameter<ActionType extends `${infer Resource}:${string}` ? Resource : never, ActionType, ResourceActionType[ActionType], BaseUser>;
+    [EventType in keyof EventValueMap]: CallbackParameter<EventType, EventType extends `${infer Resource}:${string}` ? Resource : never, EventType extends `${string}:${infer Action}` ? Action : never, EventValueMap[EventType], BaseUser>;
 };
 type ActionCallbackParameter<T extends keyof ActionType, TUser extends BaseUser = BaseUser> = ContextMap[ActionType[T]] & {
     user: TUser;
 };
-type AuthCallbackParameter<T extends keyof ResourceActionType, TUser extends BaseUser = BaseUser> = ContextMap[T] & {
+type AuthCallbackParameter<T extends keyof EventValueMap, TUser extends BaseUser = BaseUser> = ContextMap[T] & {
     user: TUser;
 };
 type ResourceCallbackParameter<T extends keyof ResourceType, TUser extends BaseUser = BaseUser> = ContextMap[ResourceType[T]] & {
@@ -215,9 +279,9 @@ export type Filters<TKey extends string | number | symbol> = {
 export interface AuthenticateCallback<T extends BaseAuthReturn> {
     (request: Request): PromiseMaybe<T>;
 }
-type OnKey = keyof ResourceType | keyof ActionType | keyof ResourceActionType;
-type OnSingleParameter<T extends OnKey, TUser extends BaseUser = BaseUser> = T extends keyof ResourceType ? ResourceCallbackParameter<T, TUser> : T extends keyof ActionType ? ActionCallbackParameter<T, TUser> : T extends keyof ResourceActionType ? AuthCallbackParameter<T, TUser> : never;
-type OnParameter<T extends "*" | OnKey | OnKey[], TUser extends BaseUser = BaseUser> = T extends OnKey[] ? OnSingleParameter<T[number], TUser> : T extends "*" ? AuthCallbackParameter<keyof ResourceActionType, TUser> : T extends OnKey ? OnSingleParameter<T, TUser> : never;
+type OnKey = keyof ResourceType | keyof ActionType | keyof EventValueMap;
+type OnSingleParameter<T extends OnKey, TUser extends BaseUser = BaseUser> = T extends keyof ResourceType ? ResourceCallbackParameter<T, TUser> : T extends keyof ActionType ? ActionCallbackParameter<T, TUser> : T extends keyof EventValueMap ? AuthCallbackParameter<T, TUser> : never;
+type OnParameter<T extends "*" | OnKey | OnKey[], TUser extends BaseUser = BaseUser> = T extends OnKey[] ? OnSingleParameter<T[number], TUser> : T extends "*" ? AuthCallbackParameter<keyof EventValueMap, TUser> : T extends OnKey ? OnSingleParameter<T, TUser> : never;
 export type AnyCallback = (request: CallbackParameter) => void | boolean | Filters<string>;
 export type CallbackEvent = "*" | OnKey | OnKey[];
 export type OnCallback<T extends CallbackEvent, TUser extends BaseUser = BaseUser, TMetadata extends Record<string, unknown> = Record<string, unknown>> = (request: OnParameter<T, TUser>) => void | boolean | Filters<keyof TMetadata>;

package/dist/client.cjs

@@ -58,16 +58,29 @@ class BaseClient {
             writable: true,
             value: void 0
         });
-        this.asyncCaller = new async_caller_js_1.AsyncCaller({
+        const callerOptions = {
             maxRetries: 4,
             maxConcurrency: 4,
             ...config?.callerOptions,
-        });
+        };
+        let defaultApiUrl = "http://localhost:8123";
+        if (!config?.apiUrl &&
+            typeof globalThis === "object" &&
+            globalThis != null) {
+            const fetchSmb = Symbol.for("langgraph_api:fetch");
+            const urlSmb = Symbol.for("langgraph_api:url");
+            const global = globalThis;
+            if (global[fetchSmb])
+                callerOptions.fetch ??= global[fetchSmb];
+            if (global[urlSmb])
+                defaultApiUrl = global[urlSmb];
+        }
+        this.asyncCaller = new async_caller_js_1.AsyncCaller(callerOptions);
         this.timeoutMs = config?.timeoutMs;
         // default limit being capped by Chrome
         // https://github.com/nodejs/undici/issues/1373
         // Regex to remove trailing slash, if present
-        this.apiUrl = config?.apiUrl?.replace(/\/$/, "") || "http://localhost:8123";
+        this.apiUrl = config?.apiUrl?.replace(/\/$/, "") || defaultApiUrl;
         this.defaultHeaders = config?.defaultHeaders || {};
         const apiKey = getApiKey(config?.apiKey);
         if (apiKey) {

package/dist/client.js

@@ -54,16 +54,29 @@ class BaseClient {
             writable: true,
             value: void 0
         });
-        this.asyncCaller = new AsyncCaller({
+        const callerOptions = {
             maxRetries: 4,
             maxConcurrency: 4,
             ...config?.callerOptions,
-        });
+        };
+        let defaultApiUrl = "http://localhost:8123";
+        if (!config?.apiUrl &&
+            typeof globalThis === "object" &&
+            globalThis != null) {
+            const fetchSmb = Symbol.for("langgraph_api:fetch");
+            const urlSmb = Symbol.for("langgraph_api:url");
+            const global = globalThis;
+            if (global[fetchSmb])
+                callerOptions.fetch ??= global[fetchSmb];
+            if (global[urlSmb])
+                defaultApiUrl = global[urlSmb];
+        }
+        this.asyncCaller = new AsyncCaller(callerOptions);
         this.timeoutMs = config?.timeoutMs;
         // default limit being capped by Chrome
         // https://github.com/nodejs/undici/issues/1373
         // Regex to remove trailing slash, if present
-        this.apiUrl = config?.apiUrl?.replace(/\/$/, "") || "http://localhost:8123";
+        this.apiUrl = config?.apiUrl?.replace(/\/$/, "") || defaultApiUrl;
         this.defaultHeaders = config?.defaultHeaders || {};
         const apiKey = getApiKey(config?.apiKey);
         if (apiKey) {

package/dist/react/index.d.ts

@@ -1 +1 @@
-export { useStream, type MessageMetadata } from "./stream.js";
+export { useStream, type MessageMetadata, type UseStream, type UseStreamOptions, } from "./stream.js";

package/dist/react/index.js

@@ -1 +1 @@
-export { useStream } from "./stream.js";
+export { useStream, } from "./stream.js";

package/dist/react/stream.d.ts

@@ -53,7 +53,7 @@ type GetInterruptType<Bag extends BagTemplate> = Bag extends {
 type GetCustomEventType<Bag extends BagTemplate> = Bag extends {
     CustomEventType: unknown;
 } ? Bag["CustomEventType"] : unknown;
-interface UseStreamOptions<StateType extends Record<string, unknown> = Record<string, unknown>, Bag extends BagTemplate = BagTemplate> {
+export interface UseStreamOptions<StateType extends Record<string, unknown> = Record<string, unknown>, Bag extends BagTemplate = BagTemplate> {
     /**
      * The ID of the assistant to use.
      */

package/dist/utils/async_caller.cjs

@@ -17,10 +17,8 @@ const STATUS_NO_RETRY = [
     406, // Not Acceptable
     407, // Proxy Authentication Required
     408, // Request Timeout
-    422, // Unprocessable Entity
-];
-const STATUS_IGNORE = [
     409, // Conflict
+    422, // Unprocessable Entity
 ];
 /**
  * Do not rely on globalThis.Response, rather just
@@ -159,9 +157,6 @@ class AsyncCaller {
                     if (STATUS_NO_RETRY.includes(error.status)) {
                         throw error;
                     }
-                    else if (STATUS_IGNORE.includes(error.status)) {
-                        return;
-                    }
                     if (onFailedResponseHook && error.response) {
                         await onFailedResponseHook(error.response);
                     }

package/dist/utils/async_caller.js

@@ -11,10 +11,8 @@ const STATUS_NO_RETRY = [
     406, // Not Acceptable
     407, // Proxy Authentication Required
     408, // Request Timeout
-    422, // Unprocessable Entity
-];
-const STATUS_IGNORE = [
     409, // Conflict
+    422, // Unprocessable Entity
 ];
 /**
  * Do not rely on globalThis.Response, rather just
@@ -153,9 +151,6 @@ export class AsyncCaller {
                     if (STATUS_NO_RETRY.includes(error.status)) {
                         throw error;
                     }
-                    else if (STATUS_IGNORE.includes(error.status)) {
-                        return;
-                    }
                     if (onFailedResponseHook && error.response) {
                         await onFailedResponseHook(error.response);
                     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@langchain/langgraph-sdk",
-  "version": "0.0.65",
+  "version": "0.0.67",
   "description": "Client library for interacting with the LangGraph API",
   "type": "module",
   "packageManager": "yarn@1.22.19",
@@ -11,7 +11,7 @@
     "format": "prettier --write src",
     "lint": "prettier --check src && tsc --noEmit",
     "test": "NODE_OPTIONS=--experimental-vm-modules jest --testPathIgnorePatterns=\\.int\\.test.ts",
-    "typedoc": "typedoc && typedoc src/react/index.ts --out docs/react --options typedoc.react.json"
+    "typedoc": "typedoc && typedoc src/react/index.ts --out docs/react --options typedoc.react.json && typedoc src/auth/index.ts --out docs/auth --options typedoc.auth.json"
   },
   "main": "index.js",
   "license": "MIT",