@langchain/langgraph-sdk 1.3.1 → 1.4.4

package/dist/react/types.d.cts

@@ -1,363 +0,0 @@
-import { Checkpoint, Config, Interrupt, Metadata, ThreadState } from "../schema.cjs";
-import { Message } from "../types.messages.cjs";
-import { CheckpointsStreamEvent, CustomStreamEvent, DebugStreamEvent, EventsStreamEvent, MetadataStreamEvent, StreamMode, TasksStreamEvent, UpdatesStreamEvent } from "../types.stream.cjs";
-import { Command, DisconnectMode, Durability, MultitaskStrategy, OnCompletionBehavior } from "../types.cjs";
-import { Client, ClientConfig } from "../client.cjs";
-import { Sequence } from "../ui/branching.cjs";
-
-//#region src/react/types.d.ts
-type MessageMetadata<StateType extends Record<string, unknown>> = {
-  /**
-   * The ID of the message used.
-   */
-  messageId: string;
-  /**
-   * The first thread state the message was seen in.
-   */
-  firstSeenState: ThreadState<StateType> | undefined;
-  /**
-   * The branch of the message.
-   */
-  branch: string | undefined;
-  /**
-   * The list of branches this message is part of.
-   * This is useful for displaying branching controls.
-   */
-  branchOptions: string[] | undefined;
-  /**
-   * Metadata sent alongside the message during run streaming.
-   * @remarks This metadata only exists temporarily in browser memory during streaming and is not persisted after completion.
-   */
-  streamMetadata: Record<string, unknown> | undefined;
-};
-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 GetConfigurableType<Bag extends BagTemplate> = Bag extends {
-  ConfigurableType: Record<string, unknown>;
-} ? Bag["ConfigurableType"] : Record<string, unknown>;
-type GetInterruptType<Bag extends BagTemplate> = Bag extends {
-  InterruptType: unknown;
-} ? Bag["InterruptType"] : unknown;
-type GetCustomEventType<Bag extends BagTemplate> = Bag extends {
-  CustomEventType: unknown;
-} ? Bag["CustomEventType"] : unknown;
-interface RunCallbackMeta {
-  run_id: string;
-  thread_id: string;
-}
-interface UseStreamThread<StateType extends Record<string, unknown>> {
-  data: ThreadState<StateType>[] | null | undefined;
-  error: unknown;
-  isLoading: boolean;
-  mutate: (mutateId?: string) => Promise<ThreadState<StateType>[] | null | undefined>;
-}
-interface UseStreamOptions<StateType extends Record<string, unknown> = Record<string, unknown>, Bag extends BagTemplate = BagTemplate> {
-  /**
-   * The ID of the assistant to use.
-   */
-  assistantId: string;
-  /**
-   * Client used to send requests.
-   */
-  client?: Client;
-  /**
-   * The URL of the API to use.
-   */
-  apiUrl?: ClientConfig["apiUrl"];
-  /**
-   * The API key to use.
-   */
-  apiKey?: ClientConfig["apiKey"];
-  /**
-   * Custom call options, such as custom fetch implementation.
-   */
-  callerOptions?: ClientConfig["callerOptions"];
-  /**
-   * Default headers to send with requests.
-   */
-  defaultHeaders?: ClientConfig["defaultHeaders"];
-  /**
-   * Specify the key within the state that contains messages.
-   * Defaults to "messages".
-   *
-   * @default "messages"
-   */
-  messagesKey?: string;
-  /**
-   * Callback that is called when an error occurs.
-   */
-  onError?: (error: unknown, run: RunCallbackMeta | undefined) => void;
-  /**
-   * Callback that is called when the stream is finished.
-   */
-  onFinish?: (state: ThreadState<StateType>, run: RunCallbackMeta | undefined) => void;
-  /**
-   * Callback that is called when a new stream is created.
-   */
-  onCreated?: (run: RunCallbackMeta) => void;
-  /**
-   * Callback that is called when an update event is received.
-   */
-  onUpdateEvent?: (data: UpdatesStreamEvent<GetUpdateType<Bag, StateType>>["data"], options: {
-    namespace: string[] | undefined;
-    mutate: (update: Partial<StateType> | ((prev: StateType) => Partial<StateType>)) => void;
-  }) => void;
-  /**
-   * Callback that is called when a custom event is received.
-   */
-  onCustomEvent?: (data: CustomStreamEvent<GetCustomEventType<Bag>>["data"], options: {
-    namespace: string[] | undefined;
-    mutate: (update: Partial<StateType> | ((prev: StateType) => Partial<StateType>)) => void;
-  }) => void;
-  /**
-   * Callback that is called when a metadata event is received.
-   */
-  onMetadataEvent?: (data: MetadataStreamEvent["data"]) => void;
-  /**
-   * Callback that is called when a LangChain event is received.
-   * @see https://langchain-ai.github.io/langgraph/cloud/how-tos/stream_events/#stream-graph-in-events-mode for more details.
-   */
-  onLangChainEvent?: (data: EventsStreamEvent["data"]) => void;
-  /**
-   * Callback that is called when a debug event is received.
-   * @internal This API is experimental and subject to change.
-   */
-  onDebugEvent?: (data: DebugStreamEvent["data"], options: {
-    namespace: string[] | undefined;
-  }) => void;
-  /**
-   * Callback that is called when a checkpoints event is received.
-   */
-  onCheckpointEvent?: (data: CheckpointsStreamEvent<StateType>["data"], options: {
-    namespace: string[] | undefined;
-  }) => void;
-  /**
-   * Callback that is called when a tasks event is received.
-   */
-  onTaskEvent?: (data: TasksStreamEvent<StateType, GetUpdateType<Bag, StateType>>["data"], options: {
-    namespace: string[] | undefined;
-  }) => void;
-  /**
-   * Callback that is called when the stream is stopped by the user.
-   * Provides a mutate function to update the stream state immediately
-   * without requiring a server roundtrip.
-   *
-   * @example
-   * ```typescript
-   * onStop: ({ mutate }) => {
-   *   mutate((prev) => ({
-   *     ...prev,
-   *     ui: prev.ui?.map(component =>
-   *       component.props.isLoading
-   *         ? { ...component, props: { ...component.props, stopped: true, isLoading: false }}
-   *         : component
-   *     )
-   *   }));
-   * }
-   * ```
-   */
-  onStop?: (options: {
-    mutate: (update: Partial<StateType> | ((prev: StateType) => Partial<StateType>)) => void;
-  }) => void;
-  /**
-   * The ID of the thread to fetch history and current values from.
-   */
-  threadId?: string | null;
-  /**
-   * Callback that is called when the thread ID is updated (ie when a new thread is created).
-   */
-  onThreadId?: (threadId: string) => void;
-  /** Will reconnect the stream on mount */
-  reconnectOnMount?: boolean | (() => RunMetadataStorage);
-  /**
-   * Initial values to display immediately when loading a thread.
-   * Useful for displaying cached thread data while official history loads.
-   * These values will be replaced when official thread data is fetched.
-   *
-   * Note: UI components from initialValues will render immediately if they're
-   * predefined in LoadExternalComponent's components prop, providing instant
-   * cached UI display without server fetches.
-   */
-  initialValues?: StateType | null;
-  /**
-   * Whether to fetch the history of the thread.
-   * If true, the history will be fetched from the server. Defaults to 10 entries.
-   * If false, only the last state will be fetched from the server.
-   * @default true
-   */
-  fetchStateHistory?: boolean | {
-    limit: number;
-  };
-  /**
-   * Manage the thread state externally.
-   */
-  thread?: UseStreamThread<StateType>;
-  /**
-   * Throttle the stream.
-   * If a number is provided, the stream will be throttled to the given number of milliseconds.
-   * If `true`, updates are batched in a single macrotask.
-   * If `false`, updates are not throttled or batched.
-   * @default true
-   */
-  throttle?: number | boolean;
-}
-interface RunMetadataStorage {
-  getItem(key: `lg:stream:${string}`): string | null;
-  setItem(key: `lg:stream:${string}`, value: string): void;
-  removeItem(key: `lg:stream:${string}`): void;
-}
-interface UseStream<StateType extends Record<string, unknown> = Record<string, unknown>, Bag extends BagTemplate = BagTemplate> {
-  /**
-   * The current values of the thread.
-   */
-  values: StateType;
-  /**
-   * Last seen error from the thread or during streaming.
-   */
-  error: unknown;
-  /**
-   * Whether the stream is currently running.
-   */
-  isLoading: boolean;
-  /**
-   * Whether the thread is currently being loaded.
-   */
-  isThreadLoading: boolean;
-  /**
-   * Stops the stream.
-   */
-  stop: () => Promise<void>;
-  /**
-   * Create and stream a run to the thread.
-   */
-  submit: (values: GetUpdateType<Bag, StateType> | null | undefined, options?: SubmitOptions<StateType, GetConfigurableType<Bag>>) => Promise<void>;
-  /**
-   * The current branch of the thread.
-   */
-  branch: string;
-  /**
-   * Set the branch of the thread.
-   */
-  setBranch: (branch: string) => void;
-  /**
-   * Flattened history of thread states of a thread.
-   */
-  history: ThreadState<StateType>[];
-  /**
-   * Tree of all branches for the thread.
-   * @experimental
-   */
-  experimental_branchTree: Sequence<StateType>;
-  /**
-   * Get the interrupt value for the stream if interrupted.
-   */
-  interrupt: Interrupt<GetInterruptType<Bag>> | undefined;
-  /**
-   * Messages inferred from the thread.
-   * Will automatically update with incoming message chunks.
-   */
-  messages: Message[];
-  /**
-   * Get the metadata for a message, such as first thread state the message
-   * was seen in and branch information.
-   
-   * @param message - The message to get the metadata for.
-   * @param index - The index of the message in the thread.
-   * @returns The metadata for the message.
-   */
-  getMessagesMetadata: (message: Message, index?: number) => MessageMetadata<StateType> | undefined;
-  /**
-   * LangGraph SDK client used to send request and receive responses.
-   */
-  client: Client;
-  /**
-   * The ID of the assistant to use.
-   */
-  assistantId: string;
-  /**
-   * Join an active stream.
-   */
-  joinStream: (runId: string, lastEventId?: string, options?: {
-    streamMode?: StreamMode | StreamMode[];
-  }) => Promise<void>;
-}
-type ConfigWithConfigurable<ConfigurableType extends Record<string, unknown>> = Config & {
-  configurable?: ConfigurableType;
-};
-interface SubmitOptions<StateType extends Record<string, unknown> = Record<string, unknown>, ContextType extends Record<string, unknown> = Record<string, unknown>> {
-  config?: ConfigWithConfigurable<ContextType>;
-  context?: ContextType;
-  checkpoint?: Omit<Checkpoint, "thread_id"> | null;
-  command?: Command;
-  interruptBefore?: "*" | string[];
-  interruptAfter?: "*" | string[];
-  metadata?: Metadata;
-  multitaskStrategy?: MultitaskStrategy;
-  onCompletion?: OnCompletionBehavior;
-  onDisconnect?: DisconnectMode;
-  feedbackKeys?: string[];
-  streamMode?: Array<StreamMode>;
-  runId?: string;
-  optimisticValues?: Partial<StateType> | ((prev: StateType) => Partial<StateType>);
-  /**
-   * Whether or not to stream the nodes of any subgraphs called
-   * by the assistant.
-   * @default false
-   */
-  streamSubgraphs?: boolean;
-  /**
-   * Mark the stream as resumable. All events emitted during the run will be temporarily persisted
-   * in order to be re-emitted if the stream is re-joined.
-   * @default false
-   */
-  streamResumable?: boolean;
-  /**
-   * Whether to checkpoint during the run (or only at the end/interruption).
-   * - `"async"`: Save checkpoint asynchronously while the next step executes (default).
-   * - `"sync"`: Save checkpoint synchronously before the next step starts.
-   * - `"exit"`: Save checkpoint only when the graph exits.
-   * @default "async"
-   */
-  durability?: Durability;
-  /**
-   * The ID to use when creating a new thread. When provided, this ID will be used
-   * for thread creation when threadId is `null` or `undefined`.
-   * This enables optimistic UI updates where you know the thread ID
-   * before the thread is actually created.
-   */
-  threadId?: string;
-}
-/**
- * Transport used to stream the thread.
- * Only applicable for custom endpoints using `toLangGraphEventStream` or `toLangGraphEventStreamResponse`.
- */
-interface UseStreamTransport<StateType extends Record<string, unknown> = Record<string, unknown>, Bag extends BagTemplate = BagTemplate> {
-  stream: (payload: {
-    input: GetUpdateType<Bag, StateType> | null | undefined;
-    context: GetConfigurableType<Bag> | undefined;
-    command: Command | undefined;
-    config: ConfigWithConfigurable<GetConfigurableType<Bag>> | undefined;
-    signal: AbortSignal;
-  }) => Promise<AsyncGenerator<{
-    id?: string;
-    event: string;
-    data: unknown;
-  }>>;
-}
-type UseStreamCustomOptions<StateType extends Record<string, unknown> = Record<string, unknown>, Bag extends BagTemplate = BagTemplate> = Pick<UseStreamOptions<StateType, Bag>, "messagesKey" | "threadId" | "onThreadId" | "onError" | "onCreated" | "onUpdateEvent" | "onCustomEvent" | "onMetadataEvent" | "onLangChainEvent" | "onDebugEvent" | "onCheckpointEvent" | "onTaskEvent" | "onStop" | "initialValues" | "throttle"> & {
-  transport: UseStreamTransport<StateType, Bag>;
-};
-type UseStreamCustom<StateType extends Record<string, unknown> = Record<string, unknown>, Bag extends BagTemplate = BagTemplate> = Pick<UseStream<StateType, Bag>, "values" | "error" | "isLoading" | "stop" | "interrupt" | "messages"> & {
-  submit: (values: GetUpdateType<Bag, StateType> | null | undefined, options?: CustomSubmitOptions<StateType, GetConfigurableType<Bag>>) => Promise<void>;
-};
-type CustomSubmitOptions<StateType extends Record<string, unknown> = Record<string, unknown>, ConfigurableType extends Record<string, unknown> = Record<string, unknown>> = Pick<SubmitOptions<StateType, ConfigurableType>, "optimisticValues" | "context" | "command" | "config">;
-//#endregion
-export { BagTemplate, GetConfigurableType, GetUpdateType, MessageMetadata, UseStream, UseStreamCustom, UseStreamCustomOptions, UseStreamOptions, UseStreamThread, UseStreamTransport };
-//# sourceMappingURL=types.d.cts.map

package/dist/react/types.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.cts","names":["Client","ClientConfig","ThreadState","Interrupt","Config","Checkpoint","Metadata","Command","MultitaskStrategy","OnCompletionBehavior","DisconnectMode","Durability","Message","UpdatesStreamEvent","CustomStreamEvent","MetadataStreamEvent","EventsStreamEvent","DebugStreamEvent","CheckpointsStreamEvent","TasksStreamEvent","StreamMode","Sequence","MessageMetadata","Record","StateType","BagTemplate","GetUpdateType","Bag","Partial","GetConfigurableType","GetInterruptType","GetCustomEventType","RunCallbackMeta","UseStreamThread","Promise","UseStreamOptions","RunMetadataStorage","UseStream","SubmitOptions","ConfigWithConfigurable","ConfigurableType","ContextType","Omit","Array","UseStreamTransport","AbortSignal","AsyncGenerator","UseStreamCustomOptions","Pick","UseStreamCustom","CustomSubmitOptions"],"sources":["../../src/react/types.d.ts"],"sourcesContent":["/* __LC_ALLOW_ENTRYPOINT_SIDE_EFFECTS__ */\nimport type { Client, ClientConfig } from \"../client.js\";\nimport type { ThreadState, Interrupt, Config, Checkpoint, Metadata } from \"../schema.js\";\nimport type { Command, MultitaskStrategy, OnCompletionBehavior, DisconnectMode, Durability } from \"../types.js\";\nimport type { Message } from \"../types.messages.js\";\nimport type { UpdatesStreamEvent, CustomStreamEvent, MetadataStreamEvent, EventsStreamEvent, DebugStreamEvent, CheckpointsStreamEvent, TasksStreamEvent, StreamMode } from \"../types.stream.js\";\nimport type { Sequence } from \"../ui/branching.js\";\nexport type MessageMetadata<StateType extends Record<string, unknown>> = {\n    /**\n     * The ID of the message used.\n     */\n    messageId: string;\n    /**\n     * The first thread state the message was seen in.\n     */\n    firstSeenState: ThreadState<StateType> | undefined;\n    /**\n     * The branch of the message.\n     */\n    branch: string | undefined;\n    /**\n     * The list of branches this message is part of.\n     * This is useful for displaying branching controls.\n     */\n    branchOptions: string[] | undefined;\n    /**\n     * Metadata sent alongside the message during run streaming.\n     * @remarks This metadata only exists temporarily in browser memory during streaming and is not persisted after completion.\n     */\n    streamMetadata: Record<string, unknown> | undefined;\n};\nexport type BagTemplate = {\n    ConfigurableType?: Record<string, unknown>;\n    InterruptType?: unknown;\n    CustomEventType?: unknown;\n    UpdateType?: unknown;\n};\nexport type GetUpdateType<Bag extends BagTemplate, StateType extends Record<string, unknown>> = Bag extends {\n    UpdateType: unknown;\n} ? Bag[\"UpdateType\"] : Partial<StateType>;\nexport type GetConfigurableType<Bag extends BagTemplate> = Bag extends {\n    ConfigurableType: Record<string, unknown>;\n} ? Bag[\"ConfigurableType\"] : Record<string, unknown>;\nexport type GetInterruptType<Bag extends BagTemplate> = Bag extends {\n    InterruptType: unknown;\n} ? Bag[\"InterruptType\"] : unknown;\nexport type GetCustomEventType<Bag extends BagTemplate> = Bag extends {\n    CustomEventType: unknown;\n} ? Bag[\"CustomEventType\"] : unknown;\nexport interface RunCallbackMeta {\n    run_id: string;\n    thread_id: string;\n}\nexport interface UseStreamThread<StateType extends Record<string, unknown>> {\n    data: ThreadState<StateType>[] | null | undefined;\n    error: unknown;\n    isLoading: boolean;\n    mutate: (mutateId?: string) => Promise<ThreadState<StateType>[] | null | undefined>;\n}\nexport interface UseStreamOptions<StateType extends Record<string, unknown> = Record<string, unknown>, Bag extends BagTemplate = BagTemplate> {\n    /**\n     * The ID of the assistant to use.\n     */\n    assistantId: string;\n    /**\n     * Client used to send requests.\n     */\n    client?: Client;\n    /**\n     * The URL of the API to use.\n     */\n    apiUrl?: ClientConfig[\"apiUrl\"];\n    /**\n     * The API key to use.\n     */\n    apiKey?: ClientConfig[\"apiKey\"];\n    /**\n     * Custom call options, such as custom fetch implementation.\n     */\n    callerOptions?: ClientConfig[\"callerOptions\"];\n    /**\n     * Default headers to send with requests.\n     */\n    defaultHeaders?: ClientConfig[\"defaultHeaders\"];\n    /**\n     * Specify the key within the state that contains messages.\n     * Defaults to \"messages\".\n     *\n     * @default \"messages\"\n     */\n    messagesKey?: string;\n    /**\n     * Callback that is called when an error occurs.\n     */\n    onError?: (error: unknown, run: RunCallbackMeta | undefined) => void;\n    /**\n     * Callback that is called when the stream is finished.\n     */\n    onFinish?: (state: ThreadState<StateType>, run: RunCallbackMeta | undefined) => void;\n    /**\n     * Callback that is called when a new stream is created.\n     */\n    onCreated?: (run: RunCallbackMeta) => void;\n    /**\n     * Callback that is called when an update event is received.\n     */\n    onUpdateEvent?: (data: UpdatesStreamEvent<GetUpdateType<Bag, StateType>>[\"data\"], options: {\n        namespace: string[] | undefined;\n        mutate: (update: Partial<StateType> | ((prev: StateType) => Partial<StateType>)) => void;\n    }) => void;\n    /**\n     * Callback that is called when a custom event is received.\n     */\n    onCustomEvent?: (data: CustomStreamEvent<GetCustomEventType<Bag>>[\"data\"], options: {\n        namespace: string[] | undefined;\n        mutate: (update: Partial<StateType> | ((prev: StateType) => Partial<StateType>)) => void;\n    }) => void;\n    /**\n     * Callback that is called when a metadata event is received.\n     */\n    onMetadataEvent?: (data: MetadataStreamEvent[\"data\"]) => void;\n    /**\n     * Callback that is called when a LangChain event is received.\n     * @see https://langchain-ai.github.io/langgraph/cloud/how-tos/stream_events/#stream-graph-in-events-mode for more details.\n     */\n    onLangChainEvent?: (data: EventsStreamEvent[\"data\"]) => void;\n    /**\n     * Callback that is called when a debug event is received.\n     * @internal This API is experimental and subject to change.\n     */\n    onDebugEvent?: (data: DebugStreamEvent[\"data\"], options: {\n        namespace: string[] | undefined;\n    }) => void;\n    /**\n     * Callback that is called when a checkpoints event is received.\n     */\n    onCheckpointEvent?: (data: CheckpointsStreamEvent<StateType>[\"data\"], options: {\n        namespace: string[] | undefined;\n    }) => void;\n    /**\n     * Callback that is called when a tasks event is received.\n     */\n    onTaskEvent?: (data: TasksStreamEvent<StateType, GetUpdateType<Bag, StateType>>[\"data\"], options: {\n        namespace: string[] | undefined;\n    }) => void;\n    /**\n     * Callback that is called when the stream is stopped by the user.\n     * Provides a mutate function to update the stream state immediately\n     * without requiring a server roundtrip.\n     *\n     * @example\n     * ```typescript\n     * onStop: ({ mutate }) => {\n     *   mutate((prev) => ({\n     *     ...prev,\n     *     ui: prev.ui?.map(component =>\n     *       component.props.isLoading\n     *         ? { ...component, props: { ...component.props, stopped: true, isLoading: false }}\n     *         : component\n     *     )\n     *   }));\n     * }\n     * ```\n     */\n    onStop?: (options: {\n        mutate: (update: Partial<StateType> | ((prev: StateType) => Partial<StateType>)) => void;\n    }) => void;\n    /**\n     * The ID of the thread to fetch history and current values from.\n     */\n    threadId?: string | null;\n    /**\n     * Callback that is called when the thread ID is updated (ie when a new thread is created).\n     */\n    onThreadId?: (threadId: string) => void;\n    /** Will reconnect the stream on mount */\n    reconnectOnMount?: boolean | (() => RunMetadataStorage);\n    /**\n     * Initial values to display immediately when loading a thread.\n     * Useful for displaying cached thread data while official history loads.\n     * These values will be replaced when official thread data is fetched.\n     *\n     * Note: UI components from initialValues will render immediately if they're\n     * predefined in LoadExternalComponent's components prop, providing instant\n     * cached UI display without server fetches.\n     */\n    initialValues?: StateType | null;\n    /**\n     * Whether to fetch the history of the thread.\n     * If true, the history will be fetched from the server. Defaults to 10 entries.\n     * If false, only the last state will be fetched from the server.\n     * @default true\n     */\n    fetchStateHistory?: boolean | {\n        limit: number;\n    };\n    /**\n     * Manage the thread state externally.\n     */\n    thread?: UseStreamThread<StateType>;\n    /**\n     * Throttle the stream.\n     * If a number is provided, the stream will be throttled to the given number of milliseconds.\n     * If `true`, updates are batched in a single macrotask.\n     * If `false`, updates are not throttled or batched.\n     * @default true\n     */\n    throttle?: number | boolean;\n}\ninterface RunMetadataStorage {\n    getItem(key: `lg:stream:${string}`): string | null;\n    setItem(key: `lg:stream:${string}`, value: string): void;\n    removeItem(key: `lg:stream:${string}`): void;\n}\nexport interface UseStream<StateType extends Record<string, unknown> = Record<string, unknown>, Bag extends BagTemplate = BagTemplate> {\n    /**\n     * The current values of the thread.\n     */\n    values: StateType;\n    /**\n     * Last seen error from the thread or during streaming.\n     */\n    error: unknown;\n    /**\n     * Whether the stream is currently running.\n     */\n    isLoading: boolean;\n    /**\n     * Whether the thread is currently being loaded.\n     */\n    isThreadLoading: boolean;\n    /**\n     * Stops the stream.\n     */\n    stop: () => Promise<void>;\n    /**\n     * Create and stream a run to the thread.\n     */\n    submit: (values: GetUpdateType<Bag, StateType> | null | undefined, options?: SubmitOptions<StateType, GetConfigurableType<Bag>>) => Promise<void>;\n    /**\n     * The current branch of the thread.\n     */\n    branch: string;\n    /**\n     * Set the branch of the thread.\n     */\n    setBranch: (branch: string) => void;\n    /**\n     * Flattened history of thread states of a thread.\n     */\n    history: ThreadState<StateType>[];\n    /**\n     * Tree of all branches for the thread.\n     * @experimental\n     */\n    experimental_branchTree: Sequence<StateType>;\n    /**\n     * Get the interrupt value for the stream if interrupted.\n     */\n    interrupt: Interrupt<GetInterruptType<Bag>> | undefined;\n    /**\n     * Messages inferred from the thread.\n     * Will automatically update with incoming message chunks.\n     */\n    messages: Message[];\n    /**\n     * Get the metadata for a message, such as first thread state the message\n     * was seen in and branch information.\n     \n     * @param message - The message to get the metadata for.\n     * @param index - The index of the message in the thread.\n     * @returns The metadata for the message.\n     */\n    getMessagesMetadata: (message: Message, index?: number) => MessageMetadata<StateType> | undefined;\n    /**\n     * LangGraph SDK client used to send request and receive responses.\n     */\n    client: Client;\n    /**\n     * The ID of the assistant to use.\n     */\n    assistantId: string;\n    /**\n     * Join an active stream.\n     */\n    joinStream: (runId: string, lastEventId?: string, options?: {\n        streamMode?: StreamMode | StreamMode[];\n    }) => Promise<void>;\n}\ntype ConfigWithConfigurable<ConfigurableType extends Record<string, unknown>> = Config & {\n    configurable?: ConfigurableType;\n};\nexport interface SubmitOptions<StateType extends Record<string, unknown> = Record<string, unknown>, ContextType extends Record<string, unknown> = Record<string, unknown>> {\n    config?: ConfigWithConfigurable<ContextType>;\n    context?: ContextType;\n    checkpoint?: Omit<Checkpoint, \"thread_id\"> | null;\n    command?: Command;\n    interruptBefore?: \"*\" | string[];\n    interruptAfter?: \"*\" | string[];\n    metadata?: Metadata;\n    multitaskStrategy?: MultitaskStrategy;\n    onCompletion?: OnCompletionBehavior;\n    onDisconnect?: DisconnectMode;\n    feedbackKeys?: string[];\n    streamMode?: Array<StreamMode>;\n    runId?: string;\n    optimisticValues?: Partial<StateType> | ((prev: StateType) => Partial<StateType>);\n    /**\n     * Whether or not to stream the nodes of any subgraphs called\n     * by the assistant.\n     * @default false\n     */\n    streamSubgraphs?: boolean;\n    /**\n     * Mark the stream as resumable. All events emitted during the run will be temporarily persisted\n     * in order to be re-emitted if the stream is re-joined.\n     * @default false\n     */\n    streamResumable?: boolean;\n    /**\n     * Whether to checkpoint during the run (or only at the end/interruption).\n     * - `\"async\"`: Save checkpoint asynchronously while the next step executes (default).\n     * - `\"sync\"`: Save checkpoint synchronously before the next step starts.\n     * - `\"exit\"`: Save checkpoint only when the graph exits.\n     * @default \"async\"\n     */\n    durability?: Durability;\n    /**\n     * The ID to use when creating a new thread. When provided, this ID will be used\n     * for thread creation when threadId is `null` or `undefined`.\n     * This enables optimistic UI updates where you know the thread ID\n     * before the thread is actually created.\n     */\n    threadId?: string;\n}\n/**\n * Transport used to stream the thread.\n * Only applicable for custom endpoints using `toLangGraphEventStream` or `toLangGraphEventStreamResponse`.\n */\nexport interface UseStreamTransport<StateType extends Record<string, unknown> = Record<string, unknown>, Bag extends BagTemplate = BagTemplate> {\n    stream: (payload: {\n        input: GetUpdateType<Bag, StateType> | null | undefined;\n        context: GetConfigurableType<Bag> | undefined;\n        command: Command | undefined;\n        config: ConfigWithConfigurable<GetConfigurableType<Bag>> | undefined;\n        signal: AbortSignal;\n    }) => Promise<AsyncGenerator<{\n        id?: string;\n        event: string;\n        data: unknown;\n    }>>;\n}\nexport type UseStreamCustomOptions<StateType extends Record<string, unknown> = Record<string, unknown>, Bag extends BagTemplate = BagTemplate> = Pick<UseStreamOptions<StateType, Bag>, \"messagesKey\" | \"threadId\" | \"onThreadId\" | \"onError\" | \"onCreated\" | \"onUpdateEvent\" | \"onCustomEvent\" | \"onMetadataEvent\" | \"onLangChainEvent\" | \"onDebugEvent\" | \"onCheckpointEvent\" | \"onTaskEvent\" | \"onStop\" | \"initialValues\" | \"throttle\"> & {\n    transport: UseStreamTransport<StateType, Bag>;\n};\nexport type UseStreamCustom<StateType extends Record<string, unknown> = Record<string, unknown>, Bag extends BagTemplate = BagTemplate> = Pick<UseStream<StateType, Bag>, \"values\" | \"error\" | \"isLoading\" | \"stop\" | \"interrupt\" | \"messages\"> & {\n    submit: (values: GetUpdateType<Bag, StateType> | null | undefined, options?: CustomSubmitOptions<StateType, GetConfigurableType<Bag>>) => Promise<void>;\n};\nexport type CustomSubmitOptions<StateType extends Record<string, unknown> = Record<string, unknown>, ConfigurableType extends Record<string, unknown> = Record<string, unknown>> = Pick<SubmitOptions<StateType, ConfigurableType>, \"optimisticValues\" | \"context\" | \"command\" | \"config\">;\nexport {};\n"],"mappings":"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"}