@langchain/langgraph-sdk 0.0.39 → 0.0.41

package/dist/index.js

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

package/dist/schema.cjs

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

package/dist/singletons/fetch.cjs

@@ -1,27 +0,0 @@
-"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

@@ -1,11 +0,0 @@
-/**
- * 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

@@ -1,22 +0,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.
- */
-export const overrideFetchImplementation = (fetch) => {
-    globalThis[LANGSMITH_FETCH_IMPLEMENTATION_KEY] = fetch;
-};
-/**
- * @internal
- */
-export const _getFetchImplementation = () => {
-    return (globalThis[LANGSMITH_FETCH_IMPLEMENTATION_KEY] ??
-        DEFAULT_FETCH_IMPLEMENTATION);
-};

package/dist/types.cjs

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

package/dist/types.d.ts

@@ -1,141 +0,0 @@
-import { Checkpoint, Config, Metadata } from "./schema.js";
-import { StreamMode } from "./types.stream.js";
-export type MultitaskStrategy = "reject" | "interrupt" | "rollback" | "enqueue";
-export type OnConflictBehavior = "raise" | "do_nothing";
-export type OnCompletionBehavior = "complete" | "continue";
-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;
-}
-export interface Command {
-    /**
-     * An object to update the thread state with.
-     */
-    update?: Record<string, unknown> | [string, unknown][] | null;
-    /**
-     * The value to return from an `interrupt` function call.
-     */
-    resume?: unknown;
-    /**
-     * Determine the next node to navigate to. Can be one of the following:
-     * - Name(s) of the node names to navigate to next.
-     * - `Send` command(s) to execute node(s) with provided input.
-     */
-    goto?: Send | Send[] | string | string[];
-}
-interface RunsInvokePayload {
-    /**
-     * Input to the run. Pass `null` to resume from the current state of the thread.
-     */
-    input?: Record<string, unknown> | null;
-    /**
-     * Metadata for the run.
-     */
-    metadata?: Metadata;
-    /**
-     * Additional configuration for the run.
-     */
-    config?: Config;
-    /**
-     * Checkpoint ID for when creating a new run.
-     */
-    checkpointId?: string;
-    /**
-     * Checkpoint for when creating a new run.
-     */
-    checkpoint?: Omit<Checkpoint, "thread_id">;
-    /**
-     * Interrupt execution before entering these nodes.
-     */
-    interruptBefore?: "*" | string[];
-    /**
-     * Interrupt execution after leaving these nodes.
-     */
-    interruptAfter?: "*" | string[];
-    /**
-     * Strategy to handle concurrent runs on the same thread. Only relevant if
-     * there is a pending/inflight run on the same thread. One of:
-     * - "reject": Reject the new run.
-     * - "interrupt": Interrupt the current run, keeping steps completed until now,
-         and start a new one.
-     * - "rollback": Cancel and delete the existing run, rolling back the thread to
-        the state before it had started, then start the new run.
-     * - "enqueue": Queue up the new run to start after the current run finishes.
-     */
-    multitaskStrategy?: MultitaskStrategy;
-    /**
-     * Abort controller signal to cancel the run.
-     */
-    signal?: AbortController["signal"];
-    /**
-     * Behavior to handle run completion. Only relevant if
-     * there is a pending/inflight run on the same thread. One of:
-     * - "complete": Complete the run.
-     * - "continue": Continue the run.
-     */
-    onCompletion?: OnCompletionBehavior;
-    /**
-     * Webhook to call when the run is complete.
-     */
-    webhook?: string;
-    /**
-     * Behavior to handle disconnection. Only relevant if
-     * there is a pending/inflight run on the same thread. One of:
-     * - "cancel": Cancel the run.
-     * - "continue": Continue the run.
-     */
-    onDisconnect?: DisconnectMode;
-    /**
-     * The number of seconds to wait before starting the run.
-     * Use to schedule future runs.
-     */
-    afterSeconds?: number;
-    /**
-     * Behavior if the specified run doesn't exist. Defaults to "reject".
-     */
-    ifNotExists?: "create" | "reject";
-    /**
-     * One or more commands to invoke the graph with.
-     */
-    command?: Command;
-}
-export interface RunsStreamPayload<TStreamMode extends StreamMode | StreamMode[] = [], TSubgraphs extends boolean = false> extends RunsInvokePayload {
-    /**
-     * One of `"values"`, `"messages"`, `"messages-tuple"`, `"updates"`, `"events"`, `"debug"`, `"custom"`.
-     */
-    streamMode?: TStreamMode;
-    /**
-     * Stream output from subgraphs. By default, streams only the top graph.
-     */
-    streamSubgraphs?: TSubgraphs;
-    /**
-     * Pass one or more feedbackKeys if you want to request short-lived signed URLs
-     * for submitting feedback to LangSmith with this key for this run.
-     */
-    feedbackKeys?: string[];
-}
-export interface RunsCreatePayload extends RunsInvokePayload {
-    /**
-     * One of `"values"`, `"messages"`, `"messages-tuple"`, `"updates"`, `"events"`, `"debug"`, `"custom"`.
-     */
-    streamMode?: StreamMode | Array<StreamMode>;
-    /**
-     * Stream output from subgraphs. By default, streams only the top graph.
-     */
-    streamSubgraphs?: boolean;
-}
-export interface CronsCreatePayload extends RunsCreatePayload {
-    /**
-     * Schedule for running the Cron Job
-     */
-    schedule: string;
-}
-export interface RunsWaitPayload extends RunsStreamPayload {
-    /**
-     * Raise errors returned by the run. Default is `true`.
-     */
-    raiseError?: boolean;
-}
-export {};

package/dist/types.js

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

package/dist/types.messages.d.ts

@@ -1,88 +0,0 @@
-type ImageDetail = "auto" | "low" | "high";
-type MessageContentImageUrl = {
-    type: "image_url";
-    image_url: string | {
-        url: string;
-        detail?: ImageDetail | undefined;
-    };
-};
-type MessageContentText = {
-    type: "text";
-    text: string;
-};
-type MessageContentComplex = MessageContentText | MessageContentImageUrl;
-type MessageContent = string | MessageContentComplex[];
-/**
- * Model-specific additional kwargs, which is passed back to the underlying LLM.
- */
-type MessageAdditionalKwargs = Record<string, unknown>;
-export type HumanMessage = {
-    type: "human";
-    id?: string | undefined;
-    content: MessageContent;
-};
-export type AIMessage = {
-    type: "ai";
-    id?: string | undefined;
-    content: MessageContent;
-    tool_calls?: {
-        name: string;
-        args: {
-            [x: string]: {
-                [x: string]: any;
-            };
-        };
-        id?: string | undefined;
-        type?: "tool_call" | undefined;
-    }[] | undefined;
-    invalid_tool_calls?: {
-        name?: string | undefined;
-        args?: string | undefined;
-        id?: string | undefined;
-        error?: string | undefined;
-        type?: "invalid_tool_call" | undefined;
-    }[] | undefined;
-    usage_metadata?: {
-        input_tokens: number;
-        output_tokens: number;
-        total_tokens: number;
-        input_token_details?: {
-            audio?: number | undefined;
-            cache_read?: number | undefined;
-            cache_creation?: number | undefined;
-        } | undefined;
-        output_token_details?: {
-            audio?: number | undefined;
-            reasoning?: number | undefined;
-        } | undefined;
-    } | undefined;
-    additional_kwargs?: MessageAdditionalKwargs | undefined;
-    response_metadata?: Record<string, unknown> | undefined;
-};
-export type ToolMessage = {
-    type: "tool";
-    name?: string | undefined;
-    id?: string | undefined;
-    content: MessageContent;
-    status?: "error" | "success" | undefined;
-    tool_call_id: string;
-    additional_kwargs?: MessageAdditionalKwargs | undefined;
-    response_metadata?: Record<string, unknown> | undefined;
-};
-export type SystemMessage = {
-    type: "system";
-    id?: string | undefined;
-    content: MessageContent;
-};
-export type FunctionMessage = {
-    type: "function";
-    id?: string | undefined;
-    content: MessageContent;
-};
-export type RemoveMessage = {
-    type: "remove";
-    id: string;
-    content: MessageContent;
-};
-export type Message = HumanMessage | AIMessage | ToolMessage | SystemMessage | FunctionMessage | RemoveMessage;
-export {};

package/dist/types.stream.d.ts

@@ -1,156 +0,0 @@
-import type { Message } from "./types.messages.js";
-/**
- * Stream modes
- * - "values": Stream only the state values.
- * - "messages": Stream complete messages.
- * - "messages-tuple": Stream (message chunk, metadata) tuples.
- * - "updates": Stream updates to the state.
- * - "events": Stream events occurring during execution.
- * - "debug": Stream detailed debug information.
- * - "custom": Stream custom events.
- */
-export type StreamMode = "values" | "messages" | "updates" | "events" | "debug" | "custom" | "messages-tuple";
-type MessageTupleMetadata = {
-    tags: string[];
-    [key: string]: unknown;
-};
-type AsSubgraph<TEvent extends {
-    event: string;
-    data: unknown;
-}> = {
-    event: TEvent["event"] | `${TEvent["event"]}|${string}`;
-    data: TEvent["data"];
-};
-/**
- * Stream event with values after completion of each step.
- */
-export type ValuesStreamEvent<StateType> = {
-    event: "values";
-    data: StateType;
-};
-/** @internal */
-export type SubgraphValuesStreamEvent<StateType> = AsSubgraph<ValuesStreamEvent<StateType>>;
-/**
- * Stream event with message chunks coming from LLM invocations inside nodes.
- */
-export type MessagesTupleStreamEvent = {
-    event: "messages";
-    data: [message: Message, config: MessageTupleMetadata];
-};
-/** @internal */
-export type SubgraphMessagesTupleStreamEvent = AsSubgraph<MessagesTupleStreamEvent>;
-/**
- * Metadata stream event with information about the run and thread
- */
-export type MetadataStreamEvent = {
-    event: "metadata";
-    data: {
-        run_id: string;
-        thread_id: string;
-    };
-};
-/**
- * Stream event with error information.
- */
-export type ErrorStreamEvent = {
-    event: "error";
-    data: {
-        error: string;
-        message: string;
-    };
-};
-/** @internal */
-export type SubgraphErrorStreamEvent = AsSubgraph<ErrorStreamEvent>;
-/**
- * Stream event with updates to the state after each step.
- * The streamed outputs include the name of the node that
- * produced the update as well as the update.
- */
-export type UpdatesStreamEvent<UpdateType> = {
-    event: "updates";
-    data: {
-        [node: string]: UpdateType;
-    };
-};
-/** @internal */
-export type SubgraphUpdatesStreamEvent<UpdateType> = AsSubgraph<UpdatesStreamEvent<UpdateType>>;
-/**
- * Streaming custom data from inside the nodes.
- */
-export type CustomStreamEvent<T> = {
-    event: "custom";
-    data: T;
-};
-/** @internal */
-export type SubgraphCustomStreamEvent<T> = AsSubgraph<CustomStreamEvent<T>>;
-type MessagesMetadataStreamEvent = {
-    event: "messages/metadata";
-    data: {
-        [messageId: string]: {
-            metadata: unknown;
-        };
-    };
-};
-type MessagesCompleteStreamEvent = {
-    event: "messages/complete";
-    data: Message[];
-};
-type MessagesPartialStreamEvent = {
-    event: "messages/partial";
-    data: Message[];
-};
-/**
- * Message stream event specific to LangGraph Server.
- * @deprecated Use `streamMode: "messages-tuple"` instead.
- */
-export type MessagesStreamEvent = MessagesMetadataStreamEvent | MessagesCompleteStreamEvent | MessagesPartialStreamEvent;
-/** @internal */
-export type SubgraphMessagesStreamEvent = AsSubgraph<MessagesMetadataStreamEvent> | AsSubgraph<MessagesCompleteStreamEvent> | AsSubgraph<MessagesPartialStreamEvent>;
-/**
- * Stream event with detailed debug information.
- */
-export type DebugStreamEvent = {
-    event: "debug";
-    data: unknown;
-};
-/** @internal */
-export type SubgraphDebugStreamEvent = AsSubgraph<DebugStreamEvent>;
-/**
- * Stream event with events occurring during execution.
- */
-export type EventsStreamEvent = {
-    event: "events";
-    data: unknown;
-};
-/** @internal */
-export type SubgraphEventsStreamEvent = AsSubgraph<EventsStreamEvent>;
-/**
- * Stream event with a feedback key to signed URL map. Set `feedbackKeys` in
- * the `RunsStreamPayload` to receive this event.
- */
-export type FeedbackStreamEvent = {
-    event: "feedback";
-    data: {
-        [feedbackKey: string]: string;
-    };
-};
-type GetStreamModeMap<TStreamMode extends StreamMode | StreamMode[], TStateType = unknown, TUpdateType = TStateType, TCustomType = unknown> = {
-    values: ValuesStreamEvent<TStateType>;
-    updates: UpdatesStreamEvent<TUpdateType>;
-    custom: CustomStreamEvent<TCustomType>;
-    debug: DebugStreamEvent;
-    messages: MessagesStreamEvent;
-    "messages-tuple": MessagesTupleStreamEvent;
-    events: EventsStreamEvent;
-}[TStreamMode extends StreamMode[] ? TStreamMode[number] : TStreamMode] | ErrorStreamEvent | MetadataStreamEvent | FeedbackStreamEvent;
-type GetSubgraphsStreamModeMap<TStreamMode extends StreamMode | StreamMode[], TStateType = unknown, TUpdateType = TStateType, TCustomType = unknown> = {
-    values: SubgraphValuesStreamEvent<TStateType>;
-    updates: SubgraphUpdatesStreamEvent<TUpdateType>;
-    custom: SubgraphCustomStreamEvent<TCustomType>;
-    debug: SubgraphDebugStreamEvent;
-    messages: SubgraphMessagesStreamEvent;
-    "messages-tuple": SubgraphMessagesTupleStreamEvent;
-    events: SubgraphEventsStreamEvent;
-}[TStreamMode extends StreamMode[] ? TStreamMode[number] : TStreamMode] | SubgraphErrorStreamEvent | MetadataStreamEvent | FeedbackStreamEvent;
-export type TypedAsyncGenerator<TStreamMode extends StreamMode | StreamMode[] = [], TSubgraphs extends boolean = false, TStateType = unknown, TUpdateType = TStateType, TCustomType = unknown> = AsyncGenerator<TSubgraphs extends true ? GetSubgraphsStreamModeMap<TStreamMode, TStateType, TUpdateType, TCustomType> : GetStreamModeMap<TStreamMode, TStateType, TUpdateType, TCustomType>>;
-export {};

package/dist/types.stream.js

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

package/dist/utils/async_caller.cjs

@@ -1,197 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.AsyncCaller = void 0;
-const p_retry_1 = __importDefault(require("p-retry"));
-const p_queue_1 = __importDefault(require("p-queue"));
-const fetch_js_1 = require("../singletons/fetch.cjs");
-const STATUS_NO_RETRY = [
-    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
-    422, // Unprocessable Entity
-];
-const STATUS_IGNORE = [
-    409, // Conflict
-];
-/**
- * Do not rely on globalThis.Response, rather just
- * do duck typing
- */
-function isResponse(x) {
-    if (x == null || typeof x !== "object")
-        return false;
-    return "status" in x && "statusText" in x && "text" in x;
-}
-/**
- * Utility error to properly handle failed requests
- */
-class HTTPError extends Error {
-    constructor(status, message, response) {
-        super(`HTTP ${status}: ${message}`);
-        Object.defineProperty(this, "status", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "text", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "response", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        this.status = status;
-        this.text = message;
-        this.response = response;
-    }
-    static async fromResponse(response, options) {
-        try {
-            return new HTTPError(response.status, await response.text(), options?.includeResponse ? response : undefined);
-        }
-        catch {
-            return new HTTPError(response.status, response.statusText, options?.includeResponse ? response : undefined);
-        }
-    }
-}
-/**
- * A class that can be used to make async calls with concurrency and retry logic.
- *
- * This is useful for making calls to any kind of "expensive" external resource,
- * be it because it's rate-limited, subject to network issues, etc.
- *
- * Concurrent calls are limited by the `maxConcurrency` parameter, which defaults
- * to `Infinity`. This means that by default, all calls will be made in parallel.
- *
- * Retries are limited by the `maxRetries` parameter, which defaults to 5. This
- * means that by default, each call will be retried up to 5 times, with an
- * exponential backoff between each attempt.
- */
-class AsyncCaller {
-    constructor(params) {
-        Object.defineProperty(this, "maxConcurrency", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "maxRetries", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "queue", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "onFailedResponseHook", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "customFetch", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        this.maxConcurrency = params.maxConcurrency ?? Infinity;
-        this.maxRetries = params.maxRetries ?? 4;
-        if ("default" in p_queue_1.default) {
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            this.queue = new p_queue_1.default.default({
-                concurrency: this.maxConcurrency,
-            });
-        }
-        else {
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            this.queue = new p_queue_1.default({ concurrency: this.maxConcurrency });
-        }
-        this.onFailedResponseHook = params?.onFailedResponseHook;
-        this.customFetch = params.fetch;
-    }
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    call(callable, ...args) {
-        const onFailedResponseHook = this.onFailedResponseHook;
-        return this.queue.add(() => (0, p_retry_1.default)(() => callable(...args).catch(async (error) => {
-            // eslint-disable-next-line no-instanceof/no-instanceof
-            if (error instanceof Error) {
-                throw error;
-            }
-            else if (isResponse(error)) {
-                throw await HTTPError.fromResponse(error, {
-                    includeResponse: !!onFailedResponseHook,
-                });
-            }
-            else {
-                throw new Error(error);
-            }
-        }), {
-            async onFailedAttempt(error) {
-                if (error.message.startsWith("Cancel") ||
-                    error.message.startsWith("TimeoutError") ||
-                    error.message.startsWith("AbortError")) {
-                    throw error;
-                }
-                // eslint-disable-next-line @typescript-eslint/no-explicit-any
-                if (error?.code === "ECONNABORTED") {
-                    throw error;
-                }
-                if (error instanceof HTTPError) {
-                    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);
-                    }
-                }
-            },
-            // If needed we can change some of the defaults here,
-            // but they're quite sensible.
-            retries: this.maxRetries,
-            randomize: true,
-        }), { throwOnTimeout: true });
-    }
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    callWithOptions(options, callable, ...args) {
-        // Note this doesn't cancel the underlying request,
-        // when available prefer to use the signal option of the underlying call
-        if (options.signal) {
-            return Promise.race([
-                this.call(callable, ...args),
-                new Promise((_, reject) => {
-                    options.signal?.addEventListener("abort", () => {
-                        reject(new Error("AbortError"));
-                    });
-                }),
-            ]);
-        }
-        return this.call(callable, ...args);
-    }
-    fetch(...args) {
-        const fetchFn = this.customFetch ?? (0, fetch_js_1._getFetchImplementation)();
-        return this.call(() => fetchFn(...args).then((res) => (res.ok ? res : Promise.reject(res))));
-    }
-}
-exports.AsyncCaller = AsyncCaller;