@langchain/langgraph-sdk 0.0.62 → 0.0.64

package/auth.cjs

@@ -0,0 +1 @@
+module.exports = require('./dist/auth/index.cjs');

package/auth.d.cts

@@ -0,0 +1 @@
+export * from './dist/auth/index.js'

package/auth.d.ts

@@ -0,0 +1 @@
+export * from './dist/auth/index.js'

package/auth.js

@@ -0,0 +1 @@
+export * from './dist/auth/index.js'

package/dist/auth/error.cjs

@@ -0,0 +1,89 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HTTPException = void 0;
+const HTTP_STATUS_MAPPING = {
+    100: "Continue",
+    101: "Switching Protocols",
+    102: "Processing",
+    103: "Early Hints",
+    200: "OK",
+    201: "Created",
+    202: "Accepted",
+    203: "Non-Authoritative Information",
+    204: "No Content",
+    205: "Reset Content",
+    206: "Partial Content",
+    207: "Multi-Status",
+    208: "Already Reported",
+    226: "IM Used",
+    300: "Multiple Choices",
+    301: "Moved Permanently",
+    302: "Found",
+    303: "See Other",
+    304: "Not Modified",
+    305: "Use Proxy",
+    307: "Temporary Redirect",
+    308: "Permanent Redirect",
+    400: "Bad Request",
+    401: "Unauthorized",
+    402: "Payment Required",
+    403: "Forbidden",
+    404: "Not Found",
+    405: "Method Not Allowed",
+    406: "Not Acceptable",
+    407: "Proxy Authentication Required",
+    408: "Request Timeout",
+    409: "Conflict",
+    410: "Gone",
+    411: "Length Required",
+    412: "Precondition Failed",
+    413: "Request Entity Too Large",
+    414: "Request-URI Too Long",
+    415: "Unsupported Media Type",
+    416: "Requested Range Not Satisfiable",
+    417: "Expectation Failed",
+    418: "I'm a Teapot",
+    421: "Misdirected Request",
+    422: "Unprocessable Entity",
+    423: "Locked",
+    424: "Failed Dependency",
+    425: "Too Early",
+    426: "Upgrade Required",
+    428: "Precondition Required",
+    429: "Too Many Requests",
+    431: "Request Header Fields Too Large",
+    451: "Unavailable For Legal Reasons",
+    500: "Internal Server Error",
+    501: "Not Implemented",
+    502: "Bad Gateway",
+    503: "Service Unavailable",
+    504: "Gateway Timeout",
+    505: "HTTP Version Not Supported",
+    506: "Variant Also Negotiates",
+    507: "Insufficient Storage",
+    508: "Loop Detected",
+    510: "Not Extended",
+    511: "Network Authentication Required",
+};
+class HTTPException extends Error {
+    constructor(status, options) {
+        super(options?.message ?? HTTP_STATUS_MAPPING[status] ?? "Unknown error", {
+            cause: options?.cause,
+        });
+        Object.defineProperty(this, "status", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "headers", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.status = status;
+        this.headers = options?.headers ?? {};
+    }
+}
+exports.HTTPException = HTTPException;

package/dist/auth/error.d.ts

@@ -0,0 +1,9 @@
+export declare class HTTPException extends Error {
+    status: number;
+    headers: HeadersInit;
+    constructor(status: number, options?: {
+        message?: string;
+        headers?: HeadersInit;
+        cause?: unknown;
+    });
+}

package/dist/auth/error.js

@@ -0,0 +1,85 @@
+const HTTP_STATUS_MAPPING = {
+    100: "Continue",
+    101: "Switching Protocols",
+    102: "Processing",
+    103: "Early Hints",
+    200: "OK",
+    201: "Created",
+    202: "Accepted",
+    203: "Non-Authoritative Information",
+    204: "No Content",
+    205: "Reset Content",
+    206: "Partial Content",
+    207: "Multi-Status",
+    208: "Already Reported",
+    226: "IM Used",
+    300: "Multiple Choices",
+    301: "Moved Permanently",
+    302: "Found",
+    303: "See Other",
+    304: "Not Modified",
+    305: "Use Proxy",
+    307: "Temporary Redirect",
+    308: "Permanent Redirect",
+    400: "Bad Request",
+    401: "Unauthorized",
+    402: "Payment Required",
+    403: "Forbidden",
+    404: "Not Found",
+    405: "Method Not Allowed",
+    406: "Not Acceptable",
+    407: "Proxy Authentication Required",
+    408: "Request Timeout",
+    409: "Conflict",
+    410: "Gone",
+    411: "Length Required",
+    412: "Precondition Failed",
+    413: "Request Entity Too Large",
+    414: "Request-URI Too Long",
+    415: "Unsupported Media Type",
+    416: "Requested Range Not Satisfiable",
+    417: "Expectation Failed",
+    418: "I'm a Teapot",
+    421: "Misdirected Request",
+    422: "Unprocessable Entity",
+    423: "Locked",
+    424: "Failed Dependency",
+    425: "Too Early",
+    426: "Upgrade Required",
+    428: "Precondition Required",
+    429: "Too Many Requests",
+    431: "Request Header Fields Too Large",
+    451: "Unavailable For Legal Reasons",
+    500: "Internal Server Error",
+    501: "Not Implemented",
+    502: "Bad Gateway",
+    503: "Service Unavailable",
+    504: "Gateway Timeout",
+    505: "HTTP Version Not Supported",
+    506: "Variant Also Negotiates",
+    507: "Insufficient Storage",
+    508: "Loop Detected",
+    510: "Not Extended",
+    511: "Network Authentication Required",
+};
+export class HTTPException extends Error {
+    constructor(status, options) {
+        super(options?.message ?? HTTP_STATUS_MAPPING[status] ?? "Unknown error", {
+            cause: options?.cause,
+        });
+        Object.defineProperty(this, "status", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "headers", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.status = status;
+        this.headers = options?.headers ?? {};
+    }
+}

package/dist/auth/index.cjs

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HTTPException = exports.Auth = void 0;
+class Auth {
+    constructor() {
+        Object.defineProperty(this, "~handlerCache", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: {}
+        });
+    }
+    authenticate(cb) {
+        this["~handlerCache"].authenticate = cb;
+        return this;
+    }
+    on(event, callback) {
+        this["~handlerCache"].callbacks ??= {};
+        this["~handlerCache"].callbacks[event] = callback;
+        return this;
+    }
+}
+exports.Auth = Auth;
+var error_js_1 = require("./error.cjs");
+Object.defineProperty(exports, "HTTPException", { enumerable: true, get: function () { return error_js_1.HTTPException; } });

package/dist/auth/index.d.ts

@@ -0,0 +1,11 @@
+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>> {
+    "~handlerCache": {
+        authenticate?: AuthenticateCallback<BaseAuthReturn>;
+        callbacks?: Record<string, AnyCallback>;
+    };
+    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 { HTTPException } from "./error.js";

package/dist/auth/index.js

@@ -0,0 +1,20 @@
+export class Auth {
+    constructor() {
+        Object.defineProperty(this, "~handlerCache", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: {}
+        });
+    }
+    authenticate(cb) {
+        this["~handlerCache"].authenticate = cb;
+        return this;
+    }
+    on(event, callback) {
+        this["~handlerCache"].callbacks ??= {};
+        this["~handlerCache"].callbacks[event] = callback;
+        return this;
+    }
+}
+export { HTTPException } from "./error.js";

package/dist/auth/types.cjs

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/auth/types.d.ts

@@ -0,0 +1,224 @@
+type Maybe<T> = T | null | undefined;
+type PromiseMaybe<T> = Promise<T> | T;
+interface AssistantConfig {
+    tags?: Maybe<string[]>;
+    recursion_limit?: Maybe<number>;
+    configurable?: Maybe<{
+        thread_id?: Maybe<string>;
+        thread_ts?: Maybe<string>;
+        [key: string]: unknown;
+    }>;
+}
+interface AssistantCreate {
+    assistant_id?: Maybe<string>;
+    metadata?: Maybe<Record<string, unknown>>;
+    config?: Maybe<AssistantConfig>;
+    if_exists?: Maybe<"raise" | "do_nothing">;
+    name?: Maybe<string>;
+    graph_id: string;
+}
+interface AssistantRead {
+    assistant_id: string;
+    metadata?: Maybe<Record<string, unknown>>;
+}
+interface AssistantUpdate {
+    assistant_id: string;
+    metadata?: Maybe<Record<string, unknown>>;
+    config?: Maybe<AssistantConfig>;
+    graph_id?: Maybe<string>;
+    name?: Maybe<string>;
+    version?: Maybe<number>;
+}
+interface AssistantDelete {
+    assistant_id: string;
+}
+interface AssistantSearch {
+    graph_id?: Maybe<string>;
+    metadata?: Maybe<Record<string, unknown>>;
+    limit?: Maybe<number>;
+    offset?: Maybe<number>;
+}
+interface ThreadCreate {
+    thread_id?: Maybe<string>;
+    metadata?: Maybe<Record<string, unknown>>;
+    if_exists?: Maybe<"raise" | "do_nothing">;
+}
+interface ThreadRead {
+    thread_id?: Maybe<string>;
+}
+interface ThreadUpdate {
+    thread_id?: Maybe<string>;
+    metadata?: Maybe<Record<string, unknown>>;
+    action?: Maybe<"interrupt" | "rollback">;
+}
+interface ThreadDelete {
+    thread_id?: Maybe<string>;
+    run_id?: Maybe<string>;
+}
+interface ThreadSearch {
+    thread_id?: Maybe<string>;
+    status?: Maybe<"idle" | "busy" | "interrupted" | "error" | (string & {})>;
+    metadata?: Maybe<Record<string, unknown>>;
+    values?: Maybe<Record<string, unknown>>;
+    limit?: Maybe<number>;
+    offset?: Maybe<number>;
+}
+interface CronCreate {
+    payload?: Maybe<Record<string, unknown>>;
+    schedule: string;
+    cron_id?: Maybe<string>;
+    thread_id?: Maybe<string>;
+    user_id?: Maybe<string>;
+    end_time?: Maybe<string>;
+}
+interface CronRead {
+    cron_id: string;
+}
+interface CronUpdate {
+    cron_id: string;
+    payload?: Maybe<Record<string, unknown>>;
+    schedule?: Maybe<string>;
+}
+interface CronDelete {
+    cron_id: string;
+}
+interface CronSearch {
+    assistant_id?: Maybe<string>;
+    thread_id?: Maybe<string>;
+    limit?: Maybe<number>;
+    offset?: Maybe<number>;
+}
+interface StorePut {
+    namespace: string[];
+    key: string;
+    value: Record<string, unknown>;
+}
+interface StoreGet {
+    namespace: Maybe<string[]>;
+    key: string;
+}
+interface StoreSearch {
+    namespace?: Maybe<string[]>;
+    filter?: Maybe<Record<string, unknown>>;
+    limit?: Maybe<number>;
+    offset?: Maybe<number>;
+    query?: Maybe<string>;
+}
+interface StoreListNamespaces {
+    namespace?: Maybe<string[]>;
+    suffix?: Maybe<string[]>;
+    max_depth?: Maybe<number>;
+    limit?: Maybe<number>;
+    offset?: Maybe<number>;
+}
+interface StoreDelete {
+    namespace?: Maybe<string[]>;
+    key: string;
+}
+interface RunsCreate {
+    thread_id?: Maybe<string>;
+    assistant_id: string;
+    run_id: string;
+    status: Maybe<"pending" | "running" | "error" | "success" | "timeout" | "interrupted">;
+    metadata?: Maybe<Record<string, unknown>>;
+    prevent_insert_if_inflight?: Maybe<boolean>;
+    multitask_strategy?: Maybe<"interrupt" | "rollback" | "reject" | "enqueue">;
+    if_not_exists?: Maybe<"reject" | "create">;
+    after_seconds?: Maybe<number>;
+    kwargs: Record<string, unknown>;
+}
+export interface ResourceActionType {
+    ["threads:create"]: ThreadCreate;
+    ["threads:read"]: ThreadRead;
+    ["threads:update"]: ThreadUpdate;
+    ["threads:delete"]: ThreadDelete;
+    ["threads:search"]: ThreadSearch;
+    ["threads:create_run"]: RunsCreate;
+    ["assistants:create"]: AssistantCreate;
+    ["assistants:read"]: AssistantRead;
+    ["assistants:update"]: AssistantUpdate;
+    ["assistants:delete"]: AssistantDelete;
+    ["assistants:search"]: AssistantSearch;
+    ["crons:create"]: CronCreate;
+    ["crons:read"]: CronRead;
+    ["crons:update"]: CronUpdate;
+    ["crons:delete"]: CronDelete;
+    ["crons:search"]: CronSearch;
+    ["store:put"]: StorePut;
+    ["store:get"]: StoreGet;
+    ["store:search"]: StoreSearch;
+    ["store:list_namespaces"]: StoreListNamespaces;
+    ["store:delete"]: StoreDelete;
+}
+interface ResourceType {
+    threads: "threads:create" | "threads:read" | "threads:update" | "threads:delete" | "threads:search" | "threads:create_run";
+    assistants: "assistants:create" | "assistants:read" | "assistants:update" | "assistants:delete" | "assistants:search";
+    crons: "crons:create" | "crons:read" | "crons:update" | "crons:delete" | "crons:search";
+    store: "store:put" | "store:get" | "store:search" | "store:list_namespaces" | "store:delete";
+}
+interface ActionType {
+    "*:create": "threads:create" | "assistants:create" | "crons:create";
+    "*:read": "threads:read" | "assistants:read" | "crons:read";
+    "*:update": "threads:update" | "assistants:update" | "crons:update";
+    "*:delete": "threads:delete" | "assistants:delete" | "crons:delete" | "store:delete";
+    "*:search": "threads:search" | "assistants:search" | "crons:search" | "store:search";
+    "*:create_run": "threads:create_run";
+    "*:put": "store:put";
+    "*:get": "store:get";
+    "*:list_namespaces": "store:list_namespaces";
+}
+export type BaseAuthReturn = {
+    is_authenticated?: boolean;
+    display_name?: string;
+    identity: string;
+    permissions: string[];
+} | string;
+export interface BaseUser {
+    is_authenticated: boolean;
+    display_name: string;
+    identity: string;
+    permissions: string[];
+}
+export type ToUserLike<T extends BaseAuthReturn> = T extends string ? {
+    is_authenticated: boolean;
+    display_name: string;
+    identity: string;
+    permissions: string[];
+} : Omit<T, "is_authenticated" | "display_name"> & {
+    is_authenticated: boolean;
+    display_name: string;
+};
+type CallbackParameter<Resource extends string = string, Action extends string = string, Value extends unknown = unknown, TUser extends BaseUser = BaseUser> = {
+    resource: Resource;
+    action: Action;
+    value: Value;
+    user: TUser;
+    permissions: string[];
+};
+type ContextMap = {
+    [ActionType in keyof ResourceActionType]: CallbackParameter<ActionType extends `${infer Resource}:${string}` ? Resource : never, ActionType, ResourceActionType[ActionType], 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] & {
+    user: TUser;
+};
+type ResourceCallbackParameter<T extends keyof ResourceType, TUser extends BaseUser = BaseUser> = ContextMap[ResourceType[T]] & {
+    user: TUser;
+};
+export type Filters<TKey extends string | number | symbol> = {
+    [key in TKey]: string | {
+        [op in "$contains" | "$eq"]?: string;
+    };
+};
+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;
+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>;
+export {};

package/dist/auth/types.js

@@ -0,0 +1 @@
+export {};

package/dist/client.cjs

@@ -255,6 +255,7 @@ class AssistantsClient extends BaseClient {
                 assistant_id: payload.assistantId,
                 if_exists: payload.ifExists,
                 name: payload.name,
+                description: payload.description,
             },
         });
     }
@@ -272,6 +273,7 @@ class AssistantsClient extends BaseClient {
                 config: payload.config,
                 metadata: payload.metadata,
                 name: payload.name,
+                description: payload.description,
             },
         });
     }

package/dist/client.d.ts

@@ -118,6 +118,7 @@ export declare class AssistantsClient extends BaseClient {
         assistantId?: string;
         ifExists?: OnConflictBehavior;
         name?: string;
+        description?: string;
     }): Promise<Assistant>;
     /**
      * Update an assistant.
@@ -130,6 +131,7 @@ export declare class AssistantsClient extends BaseClient {
         config?: Config;
         metadata?: Metadata;
         name?: string;
+        description?: string;
     }): Promise<Assistant>;
     /**
      * Delete an assistant.

package/dist/client.js

@@ -250,6 +250,7 @@ export class AssistantsClient extends BaseClient {
                 assistant_id: payload.assistantId,
                 if_exists: payload.ifExists,
                 name: payload.name,
+                description: payload.description,
             },
         });
     }
@@ -267,6 +268,7 @@ export class AssistantsClient extends BaseClient {
                 config: payload.config,
                 metadata: payload.metadata,
                 name: payload.name,
+                description: payload.description,
             },
         });
     }

package/dist/schema.d.ts

@@ -79,6 +79,8 @@ export interface AssistantBase {
     version: number;
     /** The name of the assistant */
     name: string;
+    /** The description of the assistant */
+    description?: string;
 }
 export interface AssistantVersion extends AssistantBase {
 }

package/dist/types.d.ts

@@ -7,7 +7,7 @@ export type DisconnectMode = "cancel" | "continue";
 export type StreamEvent = "events" | "metadata" | "debug" | "updates" | "values" | "messages/partial" | "messages/metadata" | "messages/complete" | "messages" | (string & {});
 export interface Send {
     node: string;
-    input: Record<string, unknown> | null;
+    input: unknown | null;
 }
 export interface Command {
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@langchain/langgraph-sdk",
-  "version": "0.0.62",
+  "version": "0.0.64",
   "description": "Client library for interacting with the LangGraph API",
   "type": "module",
   "packageManager": "yarn@1.22.19",
@@ -72,6 +72,15 @@
       "import": "./client.js",
       "require": "./client.cjs"
     },
+    "./auth": {
+      "types": {
+        "import": "./auth.d.ts",
+        "require": "./auth.d.cts",
+        "default": "./auth.d.ts"
+      },
+      "import": "./auth.js",
+      "require": "./auth.cjs"
+    },
     "./react": {
       "types": {
         "import": "./react.d.ts",
@@ -111,6 +120,10 @@
     "client.js",
     "client.d.ts",
     "client.d.cts",
+    "auth.cjs",
+    "auth.js",
+    "auth.d.ts",
+    "auth.d.cts",
     "react.cjs",
     "react.js",
     "react.d.ts",