@langchain/langgraph-sdk 0.1.9 → 1.0.0

package/dist/ui/branching.test.js

@@ -1,368 +0,0 @@
-import { it, expect } from "vitest";
-import { getBranchSequence } from "./branching.js";
-const history = [
-    {
-        values: {
-            messages: [
-                {
-                    content: "Fork: Hello",
-                    additional_kwargs: {},
-                    response_metadata: {},
-                    id: "33357aea-9c2d-4718-92f4-20038d5a2d29",
-                    type: "human",
-                },
-                {
-                    content: "Hey",
-                    additional_kwargs: {},
-                    response_metadata: {},
-                    tool_call_chunks: [],
-                    id: "run-782a2f90-2e39-4c21-9ee6-0f38585a0ae6",
-                    tool_calls: [],
-                    invalid_tool_calls: [],
-                    type: "ai",
-                },
-            ],
-        },
-        next: [],
-        tasks: [],
-        metadata: {
-            source: "loop",
-            step: 2,
-            parents: {},
-            thread_id: "efa80f4d-725f-4903-b19f-216309f060bc",
-        },
-        created_at: "2025-08-21T12:47:12.640Z",
-        checkpoint: {
-            thread_id: "efa80f4d-725f-4903-b19f-216309f060bc",
-            checkpoint_id: "1f07e8cf-56a7-6000-8002-5e272b1d5285",
-            checkpoint_ns: "",
-            checkpoint_map: null,
-        },
-        parent_checkpoint: {
-            thread_id: "efa80f4d-725f-4903-b19f-216309f060bc",
-            checkpoint_id: "1f07e8cf-53aa-6d70-8001-2096b0bbf835",
-            checkpoint_ns: "",
-            checkpoint_map: null,
-        },
-    },
-    {
-        values: {
-            messages: [
-                {
-                    content: "Fork: Hello",
-                    additional_kwargs: {},
-                    response_metadata: {},
-                    id: "33357aea-9c2d-4718-92f4-20038d5a2d29",
-                    type: "human",
-                },
-            ],
-        },
-        next: ["agent"],
-        tasks: [
-            {
-                id: "680ee831-4d10-50f9-956f-e0d937321614",
-                name: "agent",
-                error: null,
-                interrupts: [],
-                path: ["__pregel_pull", "agent"],
-                checkpoint: null,
-                state: null,
-                result: {
-                    messages: [
-                        {
-                            content: "Hey",
-                            additional_kwargs: {},
-                            response_metadata: {},
-                            tool_call_chunks: [],
-                            id: "run-782a2f90-2e39-4c21-9ee6-0f38585a0ae6",
-                            tool_calls: [],
-                            invalid_tool_calls: [],
-                            type: "ai",
-                        },
-                    ],
-                },
-            },
-        ],
-        metadata: {
-            source: "loop",
-            step: 1,
-            parents: {},
-            thread_id: "efa80f4d-725f-4903-b19f-216309f060bc",
-        },
-        created_at: "2025-08-21T12:47:12.327Z",
-        checkpoint: {
-            thread_id: "efa80f4d-725f-4903-b19f-216309f060bc",
-            checkpoint_id: "1f07e8cf-53aa-6d70-8001-2096b0bbf835",
-            checkpoint_ns: "",
-            checkpoint_map: null,
-        },
-        parent_checkpoint: {
-            thread_id: "efa80f4d-725f-4903-b19f-216309f060bc",
-            checkpoint_id: "1f07e8cf-53a8-6660-8000-f157c9cf7d66",
-            checkpoint_ns: "",
-            checkpoint_map: null,
-        },
-    },
-    {
-        values: { messages: [] },
-        next: ["__start__"],
-        tasks: [
-            {
-                id: "4233f4c0-5ea2-5117-9153-95e5fe59eee3",
-                name: "__start__",
-                error: null,
-                interrupts: [],
-                path: ["__pregel_pull", "__start__"],
-                checkpoint: null,
-                state: null,
-                result: { messages: [{ type: "human", content: "Fork: Hello" }] },
-            },
-        ],
-        metadata: {
-            source: "input",
-            step: 0,
-            parents: {},
-            thread_id: "efa80f4d-725f-4903-b19f-216309f060bc",
-        },
-        created_at: "2025-08-21T12:47:12.326Z",
-        checkpoint: {
-            thread_id: "efa80f4d-725f-4903-b19f-216309f060bc",
-            checkpoint_id: "1f07e8cf-53a8-6660-8000-f157c9cf7d66",
-            checkpoint_ns: "",
-            checkpoint_map: null,
-        },
-        parent_checkpoint: {
-            thread_id: "efa80f4d-725f-4903-b19f-216309f060bc",
-            checkpoint_id: "1f07e8cf-4cea-6530-ffff-0995a53299c5",
-            checkpoint_ns: "",
-            checkpoint_map: null,
-        },
-    },
-    {
-        values: {
-            messages: [
-                {
-                    content: "Hello",
-                    additional_kwargs: {},
-                    response_metadata: {},
-                    id: "ec300e63-1494-4ef6-936c-60d02d7bdce1",
-                    type: "human",
-                },
-                {
-                    content: "Hey",
-                    additional_kwargs: {},
-                    response_metadata: {},
-                    tool_call_chunks: [],
-                    id: "run-593064bd-dd07-4ed3-99c0-a918625f4884",
-                    tool_calls: [],
-                    invalid_tool_calls: [],
-                    type: "ai",
-                },
-            ],
-        },
-        next: [],
-        tasks: [],
-        metadata: {
-            source: "loop",
-            step: 1,
-            parents: {},
-            thread_id: "efa80f4d-725f-4903-b19f-216309f060bc",
-        },
-        created_at: "2025-08-21T12:47:12.285Z",
-        checkpoint: {
-            thread_id: "efa80f4d-725f-4903-b19f-216309f060bc",
-            checkpoint_id: "1f07e8cf-5344-64d0-8001-8a176e91d12f",
-            checkpoint_ns: "",
-            checkpoint_map: null,
-        },
-        parent_checkpoint: {
-            thread_id: "efa80f4d-725f-4903-b19f-216309f060bc",
-            checkpoint_id: "1f07e8cf-4cf8-6f90-8000-7707fd155a8a",
-            checkpoint_ns: "",
-            checkpoint_map: null,
-        },
-    },
-    {
-        values: {
-            messages: [
-                {
-                    content: "Hello",
-                    additional_kwargs: {},
-                    response_metadata: {},
-                    id: "ec300e63-1494-4ef6-936c-60d02d7bdce1",
-                    type: "human",
-                },
-                {
-                    content: "Hey",
-                    additional_kwargs: {},
-                    response_metadata: {},
-                    tool_call_chunks: [],
-                    id: "run-b86ef558-eaff-4838-bc03-218f20554a9f",
-                    tool_calls: [],
-                    invalid_tool_calls: [],
-                    type: "ai",
-                },
-            ],
-        },
-        next: [],
-        tasks: [],
-        metadata: {
-            source: "loop",
-            step: 1,
-            parents: {},
-            thread_id: "efa80f4d-725f-4903-b19f-216309f060bc",
-        },
-        created_at: "2025-08-21T12:47:11.936Z",
-        checkpoint: {
-            thread_id: "efa80f4d-725f-4903-b19f-216309f060bc",
-            checkpoint_id: "1f07e8cf-4ff0-6400-8001-a54aedf52a76",
-            checkpoint_ns: "",
-            checkpoint_map: null,
-        },
-        parent_checkpoint: {
-            thread_id: "efa80f4d-725f-4903-b19f-216309f060bc",
-            checkpoint_id: "1f07e8cf-4cf8-6f90-8000-7707fd155a8a",
-            checkpoint_ns: "",
-            checkpoint_map: null,
-        },
-    },
-    {
-        values: {
-            messages: [
-                {
-                    content: "Hello",
-                    additional_kwargs: {},
-                    response_metadata: {},
-                    id: "ec300e63-1494-4ef6-936c-60d02d7bdce1",
-                    type: "human",
-                },
-            ],
-        },
-        next: ["agent"],
-        tasks: [
-            {
-                id: "e3f503f1-73bc-5db1-8b4d-13f660ad1b51",
-                name: "agent",
-                error: null,
-                interrupts: [],
-                path: ["__pregel_pull", "agent"],
-                checkpoint: null,
-                state: null,
-                result: {
-                    messages: [
-                        {
-                            content: "Hey",
-                            additional_kwargs: {},
-                            response_metadata: {},
-                            tool_call_chunks: [],
-                            id: "run-b86ef558-eaff-4838-bc03-218f20554a9f",
-                            tool_calls: [],
-                            invalid_tool_calls: [],
-                            type: "ai",
-                        },
-                    ],
-                },
-            },
-        ],
-        metadata: {
-            source: "loop",
-            step: 0,
-            parents: {},
-            thread_id: "efa80f4d-725f-4903-b19f-216309f060bc",
-        },
-        created_at: "2025-08-21T12:47:11.625Z",
-        checkpoint: {
-            thread_id: "efa80f4d-725f-4903-b19f-216309f060bc",
-            checkpoint_id: "1f07e8cf-4cf8-6f90-8000-7707fd155a8a",
-            checkpoint_ns: "",
-            checkpoint_map: null,
-        },
-        parent_checkpoint: {
-            thread_id: "efa80f4d-725f-4903-b19f-216309f060bc",
-            checkpoint_id: "1f07e8cf-4cea-6530-ffff-0995a53299c5",
-            checkpoint_ns: "",
-            checkpoint_map: null,
-        },
-    },
-    {
-        values: { messages: [] },
-        next: ["__start__"],
-        tasks: [
-            {
-                id: "cddede95-d276-59f1-bc08-8051d6448734",
-                name: "__start__",
-                error: null,
-                interrupts: [],
-                path: ["__pregel_pull", "__start__"],
-                checkpoint: null,
-                state: null,
-                result: { messages: [{ type: "human", content: "Hello" }] },
-            },
-        ],
-        metadata: {
-            source: "input",
-            step: -1,
-            parents: {},
-            thread_id: "efa80f4d-725f-4903-b19f-216309f060bc",
-        },
-        created_at: "2025-08-21T12:47:11.619Z",
-        checkpoint: {
-            thread_id: "efa80f4d-725f-4903-b19f-216309f060bc",
-            checkpoint_id: "1f07e8cf-4cea-6530-ffff-0995a53299c5",
-            checkpoint_ns: "",
-            checkpoint_map: null,
-        },
-        parent_checkpoint: null,
-    },
-];
-const node = (value, paths = []) => ({
-    type: "node",
-    value: typeof value === "number" ? history.at(value) : value,
-    path: paths.map((v) => {
-        if (typeof v === "number") {
-            return history.at(v)?.checkpoint?.checkpoint_id;
-        }
-        return v?.checkpoint?.checkpoint_id;
-    }),
-});
-const fork = (...items) => ({ type: "fork", items });
-const sequence = (...items) => ({ type: "sequence", items });
-it("full tree", async () => {
-    const { rootSequence, paths } = getBranchSequence(history);
-    expect
-        .soft(paths)
-        .toMatchObject(expect.arrayContaining([[5], [5, 4], [5, 3], [2]].map((p) => p.map((i) => history.at(i)?.checkpoint?.checkpoint_id))));
-    expect
-        .soft(rootSequence)
-        .toMatchObject(sequence(node(6), fork(sequence(node(5, [5]), fork(sequence(node(4, [5, 4])), sequence(node(3, [5, 3])))), sequence(node(2, [2]), node(1, [2]), node(0, [2])))));
-});
-it("partial tree", async () => {
-    expect(getBranchSequence(history.slice(0, 1))).toMatchObject({
-        paths: [],
-        rootSequence: sequence(node(0)),
-    });
-    expect(getBranchSequence(history.slice(0, 2))).toMatchObject({
-        paths: [],
-        rootSequence: sequence(node(1), node(0)),
-    });
-    expect(getBranchSequence(history.slice(0, 3))).toMatchObject({
-        paths: [],
-        rootSequence: sequence(node(2), node(1), node(0)),
-    });
-    expect(getBranchSequence(history.slice(0, 4))).toMatchObject({
-        paths: [],
-        rootSequence: sequence(node(2), node(1), node(0)),
-    });
-    expect(getBranchSequence(history.slice(0, 5))).toMatchObject({
-        paths: [],
-        rootSequence: sequence(node(2), node(1), node(0)),
-    });
-    expect(getBranchSequence(history.slice(0, 6))).toMatchObject({
-        paths: expect.arrayContaining([[5], [5, 4], [5, 3], [2]].map((p) => p.map((i) => history.at(i)?.checkpoint?.checkpoint_id))),
-        rootSequence: sequence(fork(sequence(node(5, [5]), fork(sequence(node(4, [5, 4])), sequence(node(3, [5, 3])))), sequence(node(2, [2]), node(1, [2]), node(0, [2])))),
-    });
-    expect(getBranchSequence(history.slice(0, 7))).toMatchObject({
-        paths: expect.arrayContaining([[5], [5, 4], [5, 3], [2]].map((p) => p.map((i) => history.at(i)?.checkpoint?.checkpoint_id))),
-        rootSequence: sequence(node(6), fork(sequence(node(5, [5]), fork(sequence(node(4, [5, 4])), sequence(node(3, [5, 3])))), sequence(node(2, [2]), node(1, [2]), node(0, [2])))),
-    });
-});

package/dist/ui/errors.d.ts

@@ -1,12 +0,0 @@
-export declare class StreamError extends Error {
-    constructor(data: {
-        error?: string;
-        name?: string;
-        message: string;
-    });
-    static isStructuredError(error: unknown): error is {
-        error?: string;
-        name?: string;
-        message: string;
-    };
-}

package/dist/ui/manager.d.ts

@@ -1,87 +0,0 @@
-import type { CheckpointsStreamEvent, CustomStreamEvent, DebugStreamEvent, ErrorStreamEvent, EventsStreamEvent, FeedbackStreamEvent, MessagesTupleStreamEvent, MetadataStreamEvent, TasksStreamEvent, UpdatesStreamEvent, ValuesStreamEvent } from "../types.stream.js";
-import { MessageTupleManager } from "./messages.js";
-import type { Message } from "../types.messages.js";
-type BagTemplate = {
-    ConfigurableType?: Record<string, unknown>;
-    InterruptType?: unknown;
-    CustomEventType?: unknown;
-    UpdateType?: unknown;
-};
-type GetUpdateType<Bag extends BagTemplate, StateType extends Record<string, unknown>> = Bag extends {
-    UpdateType: unknown;
-} ? Bag["UpdateType"] : Partial<StateType>;
-type GetCustomEventType<Bag extends BagTemplate> = Bag extends {
-    CustomEventType: unknown;
-} ? Bag["CustomEventType"] : unknown;
-type EventStreamMap<StateType, UpdateType, CustomType> = {
-    values: ValuesStreamEvent<StateType>;
-    updates: UpdatesStreamEvent<UpdateType>;
-    custom: CustomStreamEvent<CustomType>;
-    debug: DebugStreamEvent;
-    messages: MessagesTupleStreamEvent;
-    events: EventsStreamEvent;
-    metadata: MetadataStreamEvent;
-    checkpoints: CheckpointsStreamEvent<StateType>;
-    tasks: TasksStreamEvent<StateType, UpdateType>;
-    error: ErrorStreamEvent;
-    feedback: FeedbackStreamEvent;
-};
-export type EventStreamEvent<StateType, UpdateType, CustomType> = EventStreamMap<StateType, UpdateType, CustomType>[keyof EventStreamMap<StateType, UpdateType, CustomType>];
-interface StreamManagerEventCallbacks<StateType extends Record<string, unknown>, Bag extends BagTemplate = BagTemplate> {
-    onUpdateEvent?: (data: UpdatesStreamEvent<GetUpdateType<Bag, StateType>>["data"], options: {
-        namespace: string[] | undefined;
-        mutate: (update: Partial<StateType> | ((prev: StateType) => Partial<StateType>)) => void;
-    }) => void;
-    onCustomEvent?: (data: GetCustomEventType<Bag>, options: {
-        namespace: string[] | undefined;
-        mutate: (update: Partial<StateType> | ((prev: StateType) => Partial<StateType>)) => void;
-    }) => void;
-    onMetadataEvent?: (data: MetadataStreamEvent["data"]) => void;
-    onLangChainEvent?: (data: EventsStreamEvent["data"]) => void;
-    onDebugEvent?: (data: DebugStreamEvent["data"], options: {
-        namespace: string[] | undefined;
-    }) => void;
-    onCheckpointEvent?: (data: CheckpointsStreamEvent<StateType>["data"], options: {
-        namespace: string[] | undefined;
-    }) => void;
-    onTaskEvent?: (data: TasksStreamEvent<StateType, GetUpdateType<Bag, StateType>>["data"], options: {
-        namespace: string[] | undefined;
-    }) => void;
-}
-export declare class StreamManager<StateType extends Record<string, unknown>, Bag extends BagTemplate = BagTemplate> {
-    private abortRef;
-    private messages;
-    private listeners;
-    private state;
-    constructor(messages: MessageTupleManager);
-    private setState;
-    private notifyListeners;
-    subscribe: (listener: () => void) => (() => void);
-    getSnapshot: () => {
-        isLoading: boolean;
-        values: [values: StateType, kind: "stream" | "stop"] | null;
-        error: unknown;
-    };
-    get isLoading(): boolean;
-    get values(): StateType | null;
-    get error(): unknown;
-    setStreamValues: (values: (StateType | null) | ((prev: StateType | null, kind: "stream" | "stop") => StateType | null), kind?: "stream" | "stop") => void;
-    private getMutateFn;
-    private matchEventType;
-    start: (action: (signal: AbortSignal) => Promise<AsyncGenerator<EventStreamEvent<StateType, GetUpdateType<Bag, StateType>, GetCustomEventType<Bag>>>>, options: {
-        getMessages: (values: StateType) => Message[];
-        setMessages: (current: StateType, messages: Message[]) => StateType;
-        initialValues: StateType;
-        callbacks: StreamManagerEventCallbacks<StateType, Bag>;
-        onSuccess: () => StateType | null | undefined | void | Promise<StateType | null | undefined | void>;
-        onError: (error: unknown) => void | Promise<void>;
-        onFinish?: () => void;
-    }) => Promise<void>;
-    stop: (historyValues: StateType, options: {
-        onStop?: (options: {
-            mutate: (update: Partial<StateType> | ((prev: StateType) => Partial<StateType>)) => void;
-        }) => void;
-    }) => Promise<void>;
-    clear: () => void;
-}
-export {};

package/dist/ui/messages.d.ts

@@ -1,18 +0,0 @@
-import { type BaseMessage, type BaseMessageChunk } from "@langchain/core/messages";
-import type { Message } from "../types.messages.js";
-export declare class MessageTupleManager {
-    chunks: Record<string, {
-        chunk?: BaseMessageChunk | BaseMessage;
-        metadata?: Record<string, unknown>;
-        index?: number;
-    }>;
-    constructor();
-    add(serialized: Message, metadata: Record<string, unknown> | undefined): string | null;
-    clear(): void;
-    get(id: string | null | undefined, defaultIndex?: number): {
-        chunk?: BaseMessageChunk | BaseMessage;
-        metadata?: Record<string, unknown>;
-        index?: number;
-    } | null;
-}
-export declare const toMessageDict: (chunk: BaseMessage) => Message;

package/dist/ui/utils.d.ts

@@ -1,2 +0,0 @@
-export declare function unique<T>(array: T[]): T[];
-export declare function findLast<T>(array: T[], predicate: (item: T) => boolean): T | undefined;

package/dist/utils/env.d.ts

@@ -1 +0,0 @@
-export declare function getEnvironmentVariable(name: string): string | undefined;

package/dist/utils/signals.d.ts

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

package/dist/utils/sse.d.ts

@@ -1,8 +0,0 @@
-export declare function BytesLineDecoder(): TransformStream<Uint8Array<ArrayBufferLike>, Uint8Array<ArrayBufferLike>>;
-interface StreamPart {
-    id: string | undefined;
-    event: string;
-    data: unknown;
-}
-export declare function SSEDecoder(): TransformStream<Uint8Array<ArrayBufferLike>, StreamPart>;
-export {};

package/dist/utils/stream.d.ts

@@ -1,13 +0,0 @@
-type IterableReadableStreamInterface<T> = ReadableStream<T> & AsyncIterable<T>;
-export declare class IterableReadableStream<T> extends ReadableStream<T> implements IterableReadableStreamInterface<T> {
-    reader: ReadableStreamDefaultReader<T>;
-    ensureReader(): void;
-    next(): Promise<IteratorResult<T>>;
-    return(): Promise<IteratorResult<T>>;
-    throw(e: any): Promise<IteratorResult<T>>;
-    [Symbol.asyncDispose](): Promise<void>;
-    [Symbol.asyncIterator](): this;
-    static fromReadableStream<T>(stream: ReadableStream<T>): IterableReadableStream<T>;
-    static fromAsyncGenerator<T>(generator: AsyncGenerator<T>): IterableReadableStream<T>;
-}
-export {};

package/index.cjs

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

package/index.d.cts

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

package/index.d.ts

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

package/index.js

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

package/logging.cjs

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

package/logging.d.cts

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

package/logging.d.ts

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

package/logging.js

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

package/react-ui/server.cjs

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

package/react-ui/server.d.cts

@@ -1 +0,0 @@
-export * from '../dist/react-ui/server/index.js'

package/react-ui/server.d.ts

@@ -1 +0,0 @@
-export * from '../dist/react-ui/server/index.js'

package/react-ui/server.js

@@ -1 +0,0 @@
-export * from '../dist/react-ui/server/index.js'

package/react-ui.cjs

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

package/react-ui.d.cts

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

package/react-ui.d.ts

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

package/react-ui.js

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

package/react.cjs

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

package/react.d.cts

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

package/react.d.ts

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

package/react.js

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