@langchain/langgraph-sdk 1.3.1 → 1.4.5

package/dist/schema.d.ts

@@ -65,7 +65,7 @@ interface GraphSchema {
 }
 type Subgraphs = Record<string, GraphSchema>;
 type Metadata = Optional<{
-  source?: "input" | "loop" | "update" | (string & {}); // eslint-disable-line @typescript-eslint/ban-types
+  source?: "input" | "loop" | "update" | (string & {});
   step?: number;
   writes?: Record<string, unknown> | null;
   parents?: Record<string, string>;
@@ -106,7 +106,6 @@ interface AssistantGraph {
   nodes: Array<{
     id: string | number;
     name?: string;
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     data?: Record<string, any> | string;
     metadata?: unknown;
   }>;
@@ -133,7 +132,7 @@ interface Interrupt<TValue = unknown> {
    * Will be deprecated in the future.
    * @deprecated Will be removed in the future.
    */
-  when?: "during" | (string & {}); // eslint-disable-line @typescript-eslint/ban-types
+  when?: "during" | (string & {});
   /**
    * Whether the interrupt can be resumed.
    * @deprecated Will be removed in the future.
@@ -160,6 +159,10 @@ interface Thread<ValuesType = DefaultValues> {
   values: ValuesType;
   /** Interrupts which were thrown in this thread */
   interrupts: Record<string, Array<Interrupt>>;
+  /** The config for the thread */
+  config?: Config;
+  /** The error for the thread (if status == "error") */
+  error?: Optional<string | Record<string, unknown>>;
 }
 interface Cron {
   /** The ID of the cron */
@@ -242,7 +245,6 @@ interface ListNamespaceResponse {
 interface Item {
   namespace: string[];
   key: string;
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
   value: Record<string, any>;
   createdAt: string;
   updatedAt: string;
@@ -273,8 +275,6 @@ type AssistantSortBy = "assistant_id" | "graph_id" | "name" | "created_at" | "up
 type ThreadSortBy = "thread_id" | "status" | "created_at" | "updated_at";
 type CronSortBy = "cron_id" | "assistant_id" | "thread_id" | "created_at" | "updated_at" | "next_run_date";
 type SortOrder = "asc" | "desc";
-// Select field aliases for client-side typing of `select` parameters.
-// These mirror the server's allowed field sets.
 type AssistantSelectField = "assistant_id" | "graph_id" | "name" | "description" | "config" | "context" | "created_at" | "updated_at" | "metadata" | "version";
 type ThreadSelectField = "thread_id" | "created_at" | "updated_at" | "metadata" | "config" | "context" | "status" | "values" | "interrupts";
 type RunSelectField = "run_id" | "thread_id" | "assistant_id" | "created_at" | "updated_at" | "status" | "metadata" | "kwargs" | "multitask_strategy";

package/dist/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","names":["JSONSchema7","Optional","T","RunStatus","ThreadStatus","MultitaskStrategy","CancelAction","Config","GraphSchema","Subgraphs","Record","Metadata","AssistantBase","AssistantVersion","Assistant","AssistantsSearchResponse","AssistantGraph","Array","Interrupt","TValue","Thread","DefaultValues","ValuesType","Cron","ThreadValuesFilter","ThreadState","Checkpoint","ThreadTask","Run","ListNamespaceResponse","Item","SearchItem","SearchItemsResponse","CronCreateResponse","CronCreateForThreadResponse","Omit","AssistantSortBy","ThreadSortBy","CronSortBy","SortOrder","AssistantSelectField","ThreadSelectField","RunSelectField","CronSelectField"],"sources":["../src/schema.d.ts"],"sourcesContent":["import type { JSONSchema7 } from \"json-schema\";\ntype Optional<T> = T | null | undefined;\nexport type RunStatus = \"pending\" | \"running\" | \"error\" | \"success\" | \"timeout\" | \"interrupted\";\nexport type ThreadStatus = \"idle\" | \"busy\" | \"interrupted\" | \"error\";\ntype MultitaskStrategy = \"reject\" | \"interrupt\" | \"rollback\" | \"enqueue\";\nexport type CancelAction = \"interrupt\" | \"rollback\";\nexport type Config = {\n    /**\n     * Tags for this call and any sub-calls (eg. a Chain calling an LLM).\n     * You can use these to filter calls.\n     */\n    tags?: string[];\n    /**\n     * Maximum number of times a call can recurse.\n     * If not provided, defaults to 25.\n     */\n    recursion_limit?: number;\n    /**\n     * Runtime values for attributes previously made configurable on this Runnable.\n     */\n    configurable?: {\n        /**\n         * ID of the thread\n         */\n        thread_id?: Optional<string>;\n        /**\n         * Timestamp of the state checkpoint\n         */\n        checkpoint_id?: Optional<string>;\n        [key: string]: unknown;\n    };\n};\nexport interface GraphSchema {\n    /**\n     * The ID of the graph.\n     */\n    graph_id: string;\n    /**\n     * The schema for the input state.\n     * Missing if unable to generate JSON schema from graph.\n     */\n    input_schema?: JSONSchema7 | null | undefined;\n    /**\n     * The schema for the output state.\n     * Missing if unable to generate JSON schema from graph.\n     */\n    output_schema?: JSONSchema7 | null | undefined;\n    /**\n     * The schema for the graph state.\n     * Missing if unable to generate JSON schema from graph.\n     */\n    state_schema?: JSONSchema7 | null | undefined;\n    /**\n     * The schema for the graph config.\n     * Missing if unable to generate JSON schema from graph.\n     */\n    config_schema?: JSONSchema7 | null | undefined;\n    /**\n     * The schema for the graph context.\n     * Missing if unable to generate JSON schema from graph.\n     */\n    context_schema?: JSONSchema7 | null | undefined;\n}\nexport type Subgraphs = Record<string, GraphSchema>;\nexport type Metadata = Optional<{\n    source?: \"input\" | \"loop\" | \"update\" | (string & {}); // eslint-disable-line @typescript-eslint/ban-types\n    step?: number;\n    writes?: Record<string, unknown> | null;\n    parents?: Record<string, string>;\n    [key: string]: unknown;\n}>;\nexport interface AssistantBase {\n    /** The ID of the assistant. */\n    assistant_id: string;\n    /** The ID of the graph. */\n    graph_id: string;\n    /** The assistant config. */\n    config: Config;\n    /** The assistant context. */\n    context: unknown;\n    /** The time the assistant was created. */\n    created_at: string;\n    /** The assistant metadata. */\n    metadata: Metadata;\n    /** The version of the assistant. */\n    version: number;\n    /** The name of the assistant */\n    name: string;\n    /** The description of the assistant */\n    description?: string;\n}\nexport interface AssistantVersion extends AssistantBase {\n}\nexport interface Assistant extends AssistantBase {\n    /** The last time the assistant was updated. */\n    updated_at: string;\n}\nexport interface AssistantsSearchResponse {\n    /** The assistants returned for the current search page. */\n    assistants: Assistant[];\n    /** Pagination cursor from the X-Pagination-Next response header. */\n    next: string | null;\n}\nexport interface AssistantGraph {\n    nodes: Array<{\n        id: string | number;\n        name?: string;\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        data?: Record<string, any> | string;\n        metadata?: unknown;\n    }>;\n    edges: Array<{\n        source: string;\n        target: string;\n        data?: string;\n        conditional?: boolean;\n    }>;\n}\n/**\n * An interrupt thrown inside a thread.\n */\nexport interface Interrupt<TValue = unknown> {\n    /**\n     * The ID of the interrupt.\n     */\n    id?: string;\n    /**\n     * The value of the interrupt.\n     */\n    value?: TValue;\n    /**\n     * Will be deprecated in the future.\n     * @deprecated Will be removed in the future.\n     */\n    when?: \"during\" | (string & {}); // eslint-disable-line @typescript-eslint/ban-types\n    /**\n     * Whether the interrupt can be resumed.\n     * @deprecated Will be removed in the future.\n     */\n    resumable?: boolean;\n    /**\n     * The namespace of the interrupt.\n     * @deprecated Replaced by `interrupt_id`\n     */\n    ns?: string[];\n}\nexport interface Thread<ValuesType = DefaultValues> {\n    /** The ID of the thread. */\n    thread_id: string;\n    /** The time the thread was created. */\n    created_at: string;\n    /** The last time the thread was updated. */\n    updated_at: string;\n    /** The thread metadata. */\n    metadata: Metadata;\n    /** The status of the thread */\n    status: ThreadStatus;\n    /** The current state of the thread. */\n    values: ValuesType;\n    /** Interrupts which were thrown in this thread */\n    interrupts: Record<string, Array<Interrupt>>;\n}\nexport interface Cron {\n    /** The ID of the cron */\n    cron_id: string;\n    /** The ID of the assistant */\n    assistant_id: string;\n    /** The ID of the thread */\n    thread_id: Optional<string>;\n    /** The end date to stop running the cron. */\n    end_time: Optional<string>;\n    /** The schedule to run, cron format. */\n    schedule: string;\n    /** The time the cron was created. */\n    created_at: string;\n    /** The last time the cron was updated. */\n    updated_at: string;\n    /** The run payload to use for creating new run. */\n    payload: Record<string, unknown>;\n    /** The user ID of the cron */\n    user_id: Optional<string>;\n    /** The next run date of the cron */\n    next_run_date: Optional<string>;\n    /** The metadata of the cron */\n    metadata: Record<string, unknown>;\n}\nexport type DefaultValues = Record<string, unknown>[] | Record<string, unknown>;\nexport type ThreadValuesFilter = Record<string, unknown>;\nexport interface ThreadState<ValuesType = DefaultValues> {\n    /** The state values */\n    values: ValuesType;\n    /** The next nodes to execute. If empty, the thread is done until new input is received */\n    next: string[];\n    /** Checkpoint of the thread state */\n    checkpoint: Checkpoint;\n    /** Metadata for this state */\n    metadata: Metadata;\n    /** Time of state creation  */\n    created_at: Optional<string>;\n    /** The parent checkpoint. If missing, this is the root checkpoint */\n    parent_checkpoint: Optional<Checkpoint>;\n    /** Tasks to execute in this step. If already attempted, may contain an error */\n    tasks: Array<ThreadTask>;\n}\nexport interface ThreadTask {\n    id: string;\n    name: string;\n    result?: unknown;\n    error: Optional<string>;\n    interrupts: Array<Interrupt>;\n    checkpoint: Optional<Checkpoint>;\n    state: Optional<ThreadState>;\n}\nexport interface Run {\n    /** The ID of the run */\n    run_id: string;\n    /** The ID of the thread */\n    thread_id: string;\n    /** The assistant that wwas used for this run */\n    assistant_id: string;\n    /** The time the run was created */\n    created_at: string;\n    /** The last time the run was updated */\n    updated_at: string;\n    /** The status of the run. */\n    status: RunStatus;\n    /** Run metadata */\n    metadata: Metadata;\n    /** Strategy to handle concurrent runs on the same thread */\n    multitask_strategy: Optional<MultitaskStrategy>;\n}\nexport type Checkpoint = {\n    thread_id: string;\n    checkpoint_ns: string;\n    checkpoint_id: Optional<string>;\n    checkpoint_map: Optional<Record<string, unknown>>;\n};\nexport interface ListNamespaceResponse {\n    namespaces: string[][];\n}\nexport interface Item {\n    namespace: string[];\n    key: string;\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    value: Record<string, any>;\n    createdAt: string;\n    updatedAt: string;\n}\nexport interface SearchItem extends Item {\n    score?: number;\n}\nexport interface SearchItemsResponse {\n    items: SearchItem[];\n}\nexport interface CronCreateResponse {\n    cron_id: string;\n    assistant_id: string;\n    thread_id: string | undefined;\n    user_id: string;\n    payload: Record<string, unknown>;\n    schedule: string;\n    next_run_date: string;\n    end_time: string | undefined;\n    created_at: string;\n    updated_at: string;\n    metadata: Metadata;\n}\nexport interface CronCreateForThreadResponse extends Omit<CronCreateResponse, \"thread_id\"> {\n    thread_id: string;\n}\nexport type AssistantSortBy = \"assistant_id\" | \"graph_id\" | \"name\" | \"created_at\" | \"updated_at\";\nexport type ThreadSortBy = \"thread_id\" | \"status\" | \"created_at\" | \"updated_at\";\nexport type CronSortBy = \"cron_id\" | \"assistant_id\" | \"thread_id\" | \"created_at\" | \"updated_at\" | \"next_run_date\";\nexport type SortOrder = \"asc\" | \"desc\";\n// Select field aliases for client-side typing of `select` parameters.\n// These mirror the server's allowed field sets.\nexport type AssistantSelectField = \"assistant_id\" | \"graph_id\" | \"name\" | \"description\" | \"config\" | \"context\" | \"created_at\" | \"updated_at\" | \"metadata\" | \"version\";\nexport type ThreadSelectField = \"thread_id\" | \"created_at\" | \"updated_at\" | \"metadata\" | \"config\" | \"context\" | \"status\" | \"values\" | \"interrupts\";\nexport type RunSelectField = \"run_id\" | \"thread_id\" | \"assistant_id\" | \"created_at\" | \"updated_at\" | \"status\" | \"metadata\" | \"kwargs\" | \"multitask_strategy\";\nexport type CronSelectField = \"cron_id\" | \"assistant_id\" | \"thread_id\" | \"end_time\" | \"schedule\" | \"created_at\" | \"updated_at\" | \"user_id\" | \"payload\" | \"next_run_date\" | \"metadata\" | \"now\";\nexport {};\n"],"mappings":"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"}
+{"version":3,"file":"schema.d.ts","names":["JSONSchema7","Optional","T","RunStatus","ThreadStatus","MultitaskStrategy","CancelAction","Config","GraphSchema","Subgraphs","Record","Metadata","AssistantBase","AssistantVersion","Assistant","AssistantsSearchResponse","AssistantGraph","Array","Interrupt","TValue","Thread","DefaultValues","ValuesType","Cron","ThreadValuesFilter","ThreadState","Checkpoint","ThreadTask","Run","ListNamespaceResponse","Item","SearchItem","SearchItemsResponse","CronCreateResponse","CronCreateForThreadResponse","Omit","AssistantSortBy","ThreadSortBy","CronSortBy","SortOrder","AssistantSelectField","ThreadSelectField","RunSelectField","CronSelectField"],"sources":["../src/schema.d.ts"],"sourcesContent":["import type { JSONSchema7 } from \"json-schema\";\ntype Optional<T> = T | null | undefined;\nexport type RunStatus = \"pending\" | \"running\" | \"error\" | \"success\" | \"timeout\" | \"interrupted\";\nexport type ThreadStatus = \"idle\" | \"busy\" | \"interrupted\" | \"error\";\ntype MultitaskStrategy = \"reject\" | \"interrupt\" | \"rollback\" | \"enqueue\";\nexport type CancelAction = \"interrupt\" | \"rollback\";\nexport type Config = {\n    /**\n     * Tags for this call and any sub-calls (eg. a Chain calling an LLM).\n     * You can use these to filter calls.\n     */\n    tags?: string[];\n    /**\n     * Maximum number of times a call can recurse.\n     * If not provided, defaults to 25.\n     */\n    recursion_limit?: number;\n    /**\n     * Runtime values for attributes previously made configurable on this Runnable.\n     */\n    configurable?: {\n        /**\n         * ID of the thread\n         */\n        thread_id?: Optional<string>;\n        /**\n         * Timestamp of the state checkpoint\n         */\n        checkpoint_id?: Optional<string>;\n        [key: string]: unknown;\n    };\n};\nexport interface GraphSchema {\n    /**\n     * The ID of the graph.\n     */\n    graph_id: string;\n    /**\n     * The schema for the input state.\n     * Missing if unable to generate JSON schema from graph.\n     */\n    input_schema?: JSONSchema7 | null | undefined;\n    /**\n     * The schema for the output state.\n     * Missing if unable to generate JSON schema from graph.\n     */\n    output_schema?: JSONSchema7 | null | undefined;\n    /**\n     * The schema for the graph state.\n     * Missing if unable to generate JSON schema from graph.\n     */\n    state_schema?: JSONSchema7 | null | undefined;\n    /**\n     * The schema for the graph config.\n     * Missing if unable to generate JSON schema from graph.\n     */\n    config_schema?: JSONSchema7 | null | undefined;\n    /**\n     * The schema for the graph context.\n     * Missing if unable to generate JSON schema from graph.\n     */\n    context_schema?: JSONSchema7 | null | undefined;\n}\nexport type Subgraphs = Record<string, GraphSchema>;\nexport type Metadata = Optional<{\n    source?: \"input\" | \"loop\" | \"update\" | (string & {});\n    step?: number;\n    writes?: Record<string, unknown> | null;\n    parents?: Record<string, string>;\n    [key: string]: unknown;\n}>;\nexport interface AssistantBase {\n    /** The ID of the assistant. */\n    assistant_id: string;\n    /** The ID of the graph. */\n    graph_id: string;\n    /** The assistant config. */\n    config: Config;\n    /** The assistant context. */\n    context: unknown;\n    /** The time the assistant was created. */\n    created_at: string;\n    /** The assistant metadata. */\n    metadata: Metadata;\n    /** The version of the assistant. */\n    version: number;\n    /** The name of the assistant */\n    name: string;\n    /** The description of the assistant */\n    description?: string;\n}\nexport interface AssistantVersion extends AssistantBase {\n}\nexport interface Assistant extends AssistantBase {\n    /** The last time the assistant was updated. */\n    updated_at: string;\n}\nexport interface AssistantsSearchResponse {\n    /** The assistants returned for the current search page. */\n    assistants: Assistant[];\n    /** Pagination cursor from the X-Pagination-Next response header. */\n    next: string | null;\n}\nexport interface AssistantGraph {\n    nodes: Array<{\n        id: string | number;\n        name?: string;\n        data?: Record<string, any> | string;\n        metadata?: unknown;\n    }>;\n    edges: Array<{\n        source: string;\n        target: string;\n        data?: string;\n        conditional?: boolean;\n    }>;\n}\n/**\n * An interrupt thrown inside a thread.\n */\nexport interface Interrupt<TValue = unknown> {\n    /**\n     * The ID of the interrupt.\n     */\n    id?: string;\n    /**\n     * The value of the interrupt.\n     */\n    value?: TValue;\n    /**\n     * Will be deprecated in the future.\n     * @deprecated Will be removed in the future.\n     */\n    when?: \"during\" | (string & {});\n    /**\n     * Whether the interrupt can be resumed.\n     * @deprecated Will be removed in the future.\n     */\n    resumable?: boolean;\n    /**\n     * The namespace of the interrupt.\n     * @deprecated Replaced by `interrupt_id`\n     */\n    ns?: string[];\n}\nexport interface Thread<ValuesType = DefaultValues> {\n    /** The ID of the thread. */\n    thread_id: string;\n    /** The time the thread was created. */\n    created_at: string;\n    /** The last time the thread was updated. */\n    updated_at: string;\n    /** The thread metadata. */\n    metadata: Metadata;\n    /** The status of the thread */\n    status: ThreadStatus;\n    /** The current state of the thread. */\n    values: ValuesType;\n    /** Interrupts which were thrown in this thread */\n    interrupts: Record<string, Array<Interrupt>>;\n    /** The config for the thread */\n    config?: Config;\n    /** The error for the thread (if status == \"error\") */\n    error?: Optional<string | Record<string, unknown>>;\n}\nexport interface Cron {\n    /** The ID of the cron */\n    cron_id: string;\n    /** The ID of the assistant */\n    assistant_id: string;\n    /** The ID of the thread */\n    thread_id: Optional<string>;\n    /** The end date to stop running the cron. */\n    end_time: Optional<string>;\n    /** The schedule to run, cron format. */\n    schedule: string;\n    /** The time the cron was created. */\n    created_at: string;\n    /** The last time the cron was updated. */\n    updated_at: string;\n    /** The run payload to use for creating new run. */\n    payload: Record<string, unknown>;\n    /** The user ID of the cron */\n    user_id: Optional<string>;\n    /** The next run date of the cron */\n    next_run_date: Optional<string>;\n    /** The metadata of the cron */\n    metadata: Record<string, unknown>;\n}\nexport type DefaultValues = Record<string, unknown>[] | Record<string, unknown>;\nexport type ThreadValuesFilter = Record<string, unknown>;\nexport interface ThreadState<ValuesType = DefaultValues> {\n    /** The state values */\n    values: ValuesType;\n    /** The next nodes to execute. If empty, the thread is done until new input is received */\n    next: string[];\n    /** Checkpoint of the thread state */\n    checkpoint: Checkpoint;\n    /** Metadata for this state */\n    metadata: Metadata;\n    /** Time of state creation  */\n    created_at: Optional<string>;\n    /** The parent checkpoint. If missing, this is the root checkpoint */\n    parent_checkpoint: Optional<Checkpoint>;\n    /** Tasks to execute in this step. If already attempted, may contain an error */\n    tasks: Array<ThreadTask>;\n}\nexport interface ThreadTask {\n    id: string;\n    name: string;\n    result?: unknown;\n    error: Optional<string>;\n    interrupts: Array<Interrupt>;\n    checkpoint: Optional<Checkpoint>;\n    state: Optional<ThreadState>;\n}\nexport interface Run {\n    /** The ID of the run */\n    run_id: string;\n    /** The ID of the thread */\n    thread_id: string;\n    /** The assistant that wwas used for this run */\n    assistant_id: string;\n    /** The time the run was created */\n    created_at: string;\n    /** The last time the run was updated */\n    updated_at: string;\n    /** The status of the run. */\n    status: RunStatus;\n    /** Run metadata */\n    metadata: Metadata;\n    /** Strategy to handle concurrent runs on the same thread */\n    multitask_strategy: Optional<MultitaskStrategy>;\n}\nexport type Checkpoint = {\n    thread_id: string;\n    checkpoint_ns: string;\n    checkpoint_id: Optional<string>;\n    checkpoint_map: Optional<Record<string, unknown>>;\n};\nexport interface ListNamespaceResponse {\n    namespaces: string[][];\n}\nexport interface Item {\n    namespace: string[];\n    key: string;\n    value: Record<string, any>;\n    createdAt: string;\n    updatedAt: string;\n}\nexport interface SearchItem extends Item {\n    score?: number;\n}\nexport interface SearchItemsResponse {\n    items: SearchItem[];\n}\nexport interface CronCreateResponse {\n    cron_id: string;\n    assistant_id: string;\n    thread_id: string | undefined;\n    user_id: string;\n    payload: Record<string, unknown>;\n    schedule: string;\n    next_run_date: string;\n    end_time: string | undefined;\n    created_at: string;\n    updated_at: string;\n    metadata: Metadata;\n}\nexport interface CronCreateForThreadResponse extends Omit<CronCreateResponse, \"thread_id\"> {\n    thread_id: string;\n}\nexport type AssistantSortBy = \"assistant_id\" | \"graph_id\" | \"name\" | \"created_at\" | \"updated_at\";\nexport type ThreadSortBy = \"thread_id\" | \"status\" | \"created_at\" | \"updated_at\";\nexport type CronSortBy = \"cron_id\" | \"assistant_id\" | \"thread_id\" | \"created_at\" | \"updated_at\" | \"next_run_date\";\nexport type SortOrder = \"asc\" | \"desc\";\nexport type AssistantSelectField = \"assistant_id\" | \"graph_id\" | \"name\" | \"description\" | \"config\" | \"context\" | \"created_at\" | \"updated_at\" | \"metadata\" | \"version\";\nexport type ThreadSelectField = \"thread_id\" | \"created_at\" | \"updated_at\" | \"metadata\" | \"config\" | \"context\" | \"status\" | \"values\" | \"interrupts\";\nexport type RunSelectField = \"run_id\" | \"thread_id\" | \"assistant_id\" | \"created_at\" | \"updated_at\" | \"status\" | \"metadata\" | \"kwargs\" | \"multitask_strategy\";\nexport type CronSelectField = \"cron_id\" | \"assistant_id\" | \"thread_id\" | \"end_time\" | \"schedule\" | \"created_at\" | \"updated_at\" | \"user_id\" | \"payload\" | \"next_run_date\" | \"metadata\" | \"now\";\nexport {};\n"],"mappings":"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"}

package/dist/singletons/fetch.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"fetch.cjs","names":["fetch","_getFetchImplementation: () => (...args: any[]) => any"],"sources":["../../src/singletons/fetch.ts"],"sourcesContent":["/* eslint-disable @typescript-eslint/no-explicit-any */\n// Wrap the default fetch call due to issues with illegal invocations\n// in some environments:\n// https://stackoverflow.com/questions/69876859/why-does-bind-fix-failed-to-execute-fetch-on-window-illegal-invocation-err\n// @ts-expect-error Broad typing to support a range of fetch implementations\nconst DEFAULT_FETCH_IMPLEMENTATION = (...args: any[]) => fetch(...args);\n\nconst LANGSMITH_FETCH_IMPLEMENTATION_KEY = Symbol.for(\n  \"lg:fetch_implementation\"\n);\n\n/**\n * Overrides the fetch implementation used for LangSmith calls.\n * You should use this if you need to use an implementation of fetch\n * other than the default global (e.g. for dealing with proxies).\n * @param fetch The new fetch function to use.\n */\nexport const overrideFetchImplementation = (fetch: (...args: any[]) => any) => {\n  (globalThis as any)[LANGSMITH_FETCH_IMPLEMENTATION_KEY] = fetch;\n};\n\n/**\n * @internal\n */\nexport const _getFetchImplementation: () => (...args: any[]) => any = () => {\n  return (\n    (globalThis as any)[LANGSMITH_FETCH_IMPLEMENTATION_KEY] ??\n    DEFAULT_FETCH_IMPLEMENTATION\n  );\n};\n"],"mappings":";;AAKA,MAAM,gCAAgC,GAAG,SAAgB,MAAM,GAAG;AAElE,MAAM,qCAAqC,OAAO,IAChD;;;;;;;AASF,MAAa,+BAA+B,YAAmC;AAC7E,CAAC,WAAmB,sCAAsCA;;;;;AAM5D,MAAaC,gCAA+D;AAC1E,QACG,WAAmB,uCACpB"}
+{"version":3,"file":"fetch.cjs","names":["fetch"],"sources":["../../src/singletons/fetch.ts"],"sourcesContent":["/* eslint-disable @typescript-eslint/no-explicit-any */\n// Wrap the default fetch call due to issues with illegal invocations\n// in some environments:\n// https://stackoverflow.com/questions/69876859/why-does-bind-fix-failed-to-execute-fetch-on-window-illegal-invocation-err\n// @ts-expect-error Broad typing to support a range of fetch implementations\nconst DEFAULT_FETCH_IMPLEMENTATION = (...args: any[]) => fetch(...args);\n\nconst LANGSMITH_FETCH_IMPLEMENTATION_KEY = Symbol.for(\n  \"lg:fetch_implementation\"\n);\n\n/**\n * Overrides the fetch implementation used for LangSmith calls.\n * You should use this if you need to use an implementation of fetch\n * other than the default global (e.g. for dealing with proxies).\n * @param fetch The new fetch function to use.\n */\nexport const overrideFetchImplementation = (fetch: (...args: any[]) => any) => {\n  (globalThis as any)[LANGSMITH_FETCH_IMPLEMENTATION_KEY] = fetch;\n};\n\n/**\n * @internal\n */\nexport const _getFetchImplementation: () => (...args: any[]) => any = () => {\n  return (\n    (globalThis as any)[LANGSMITH_FETCH_IMPLEMENTATION_KEY] ??\n    DEFAULT_FETCH_IMPLEMENTATION\n  );\n};\n"],"mappings":";;AAKA,MAAM,gCAAgC,GAAG,SAAgB,MAAM,GAAG,KAAK;AAEvE,MAAM,qCAAqC,OAAO,IAChD,0BACD;;;;;;;AAQD,MAAa,+BAA+B,YAAmC;AAC7E,CAAC,WAAmB,sCAAsCA;;;;;AAM5D,MAAa,gCAA+D;AAC1E,QACG,WAAmB,uCACpB"}

package/dist/singletons/fetch.js.map

@@ -1 +1 @@
-{"version":3,"file":"fetch.js","names":["fetch","_getFetchImplementation: () => (...args: any[]) => any"],"sources":["../../src/singletons/fetch.ts"],"sourcesContent":["/* eslint-disable @typescript-eslint/no-explicit-any */\n// Wrap the default fetch call due to issues with illegal invocations\n// in some environments:\n// https://stackoverflow.com/questions/69876859/why-does-bind-fix-failed-to-execute-fetch-on-window-illegal-invocation-err\n// @ts-expect-error Broad typing to support a range of fetch implementations\nconst DEFAULT_FETCH_IMPLEMENTATION = (...args: any[]) => fetch(...args);\n\nconst LANGSMITH_FETCH_IMPLEMENTATION_KEY = Symbol.for(\n  \"lg:fetch_implementation\"\n);\n\n/**\n * Overrides the fetch implementation used for LangSmith calls.\n * You should use this if you need to use an implementation of fetch\n * other than the default global (e.g. for dealing with proxies).\n * @param fetch The new fetch function to use.\n */\nexport const overrideFetchImplementation = (fetch: (...args: any[]) => any) => {\n  (globalThis as any)[LANGSMITH_FETCH_IMPLEMENTATION_KEY] = fetch;\n};\n\n/**\n * @internal\n */\nexport const _getFetchImplementation: () => (...args: any[]) => any = () => {\n  return (\n    (globalThis as any)[LANGSMITH_FETCH_IMPLEMENTATION_KEY] ??\n    DEFAULT_FETCH_IMPLEMENTATION\n  );\n};\n"],"mappings":";AAKA,MAAM,gCAAgC,GAAG,SAAgB,MAAM,GAAG;AAElE,MAAM,qCAAqC,OAAO,IAChD;;;;;;;AASF,MAAa,+BAA+B,YAAmC;AAC7E,CAAC,WAAmB,sCAAsCA;;;;;AAM5D,MAAaC,gCAA+D;AAC1E,QACG,WAAmB,uCACpB"}
+{"version":3,"file":"fetch.js","names":["fetch"],"sources":["../../src/singletons/fetch.ts"],"sourcesContent":["/* eslint-disable @typescript-eslint/no-explicit-any */\n// Wrap the default fetch call due to issues with illegal invocations\n// in some environments:\n// https://stackoverflow.com/questions/69876859/why-does-bind-fix-failed-to-execute-fetch-on-window-illegal-invocation-err\n// @ts-expect-error Broad typing to support a range of fetch implementations\nconst DEFAULT_FETCH_IMPLEMENTATION = (...args: any[]) => fetch(...args);\n\nconst LANGSMITH_FETCH_IMPLEMENTATION_KEY = Symbol.for(\n  \"lg:fetch_implementation\"\n);\n\n/**\n * Overrides the fetch implementation used for LangSmith calls.\n * You should use this if you need to use an implementation of fetch\n * other than the default global (e.g. for dealing with proxies).\n * @param fetch The new fetch function to use.\n */\nexport const overrideFetchImplementation = (fetch: (...args: any[]) => any) => {\n  (globalThis as any)[LANGSMITH_FETCH_IMPLEMENTATION_KEY] = fetch;\n};\n\n/**\n * @internal\n */\nexport const _getFetchImplementation: () => (...args: any[]) => any = () => {\n  return (\n    (globalThis as any)[LANGSMITH_FETCH_IMPLEMENTATION_KEY] ??\n    DEFAULT_FETCH_IMPLEMENTATION\n  );\n};\n"],"mappings":";AAKA,MAAM,gCAAgC,GAAG,SAAgB,MAAM,GAAG,KAAK;AAEvE,MAAM,qCAAqC,OAAO,IAChD,0BACD;;;;;;;AAQD,MAAa,+BAA+B,YAAmC;AAC7E,CAAC,WAAmB,sCAAsCA;;;;;AAM5D,MAAa,gCAA+D;AAC1E,QACG,WAAmB,uCACpB"}

package/dist/types.d.cts

@@ -8,7 +8,7 @@ type OnConflictBehavior = "raise" | "do_nothing";
 type OnCompletionBehavior = "complete" | "continue";
 type DisconnectMode = "cancel" | "continue";
 type Durability = "exit" | "async" | "sync";
-type StreamEvent = "events" | "metadata" | "debug" | "updates" | "values" | "messages/partial" | "messages/metadata" | "messages/complete" | "messages" | (string & {}); // eslint-disable-line @typescript-eslint/ban-types
+type StreamEvent = "events" | "metadata" | "debug" | "updates" | "values" | "messages/partial" | "messages/metadata" | "messages/complete" | "messages" | (string & {});
 interface Send {
   node: string;
   input: unknown | null;

package/dist/types.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.cts","names":["LangChainTracer","Checkpoint","Config","Metadata","StreamMode","MultitaskStrategy","OnConflictBehavior","OnCompletionBehavior","DisconnectMode","Durability","StreamEvent","Send","Command","Record","RunsInvokePayload","Omit","AbortController","RunsStreamPayload","TStreamMode","TSubgraphs","RunsCreatePayload","Array","CronsCreatePayload","RunsWaitPayload"],"sources":["../src/types.d.ts"],"sourcesContent":["import { LangChainTracer } from \"@langchain/core/tracers/tracer_langchain\";\nimport { Checkpoint, Config, Metadata } from \"./schema.js\";\nimport { StreamMode } from \"./types.stream.js\";\nexport type MultitaskStrategy = \"reject\" | \"interrupt\" | \"rollback\" | \"enqueue\";\nexport type OnConflictBehavior = \"raise\" | \"do_nothing\";\nexport type OnCompletionBehavior = \"complete\" | \"continue\";\nexport type DisconnectMode = \"cancel\" | \"continue\";\nexport type Durability = \"exit\" | \"async\" | \"sync\";\nexport type StreamEvent = \"events\" | \"metadata\" | \"debug\" | \"updates\" | \"values\" | \"messages/partial\" | \"messages/metadata\" | \"messages/complete\" | \"messages\" | (string & {}); // eslint-disable-line @typescript-eslint/ban-types\nexport interface Send {\n    node: string;\n    input: unknown | null;\n}\nexport interface Command {\n    /**\n     * An object to update the thread state with.\n     */\n    update?: Record<string, unknown> | [string, unknown][] | null;\n    /**\n     * The value to return from an `interrupt` function call.\n     */\n    resume?: unknown;\n    /**\n     * Determine the next node to navigate to. Can be one of the following:\n     * - Name(s) of the node names to navigate to next.\n     * - `Send` command(s) to execute node(s) with provided input.\n     */\n    goto?: Send | Send[] | string | string[];\n}\nexport interface RunsInvokePayload {\n    /**\n     * Input to the run. Pass `null` to resume from the current state of the thread.\n     */\n    input?: Record<string, unknown> | null;\n    /**\n     * Metadata for the run.\n     */\n    metadata?: Metadata;\n    /**\n     * Additional configuration for the run.\n     */\n    config?: Config;\n    /**\n     * Static context to add to the assistant.\n     * @remarks Added in LangGraph.js 0.4\n     */\n    context?: unknown;\n    /**\n     * Checkpoint ID for when creating a new run.\n     */\n    checkpointId?: string;\n    /**\n     * Checkpoint for when creating a new run.\n     */\n    checkpoint?: Omit<Checkpoint, \"thread_id\">;\n    /**\n     * Whether to checkpoint during the run (or only at the end/interruption).\n     * @deprecated Use `durability` instead.\n     */\n    checkpointDuring?: 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     * Interrupt execution before entering these nodes.\n     */\n    interruptBefore?: \"*\" | string[];\n    /**\n     * Interrupt execution after leaving these nodes.\n     */\n    interruptAfter?: \"*\" | string[];\n    /**\n     * Strategy to handle concurrent runs on the same thread. Only relevant if\n     * there is a pending/inflight run on the same thread. One of:\n     * - \"reject\": Reject the new run.\n     * - \"interrupt\": Interrupt the current run, keeping steps completed until now,\n         and start a new one.\n     * - \"rollback\": Cancel and delete the existing run, rolling back the thread to\n        the state before it had started, then start the new run.\n     * - \"enqueue\": Queue up the new run to start after the current run finishes.\n     */\n    multitaskStrategy?: MultitaskStrategy;\n    /**\n     * Abort controller signal to cancel the run.\n     */\n    signal?: AbortController[\"signal\"];\n    /**\n     * Behavior to handle run completion. Only relevant if\n     * there is a pending/inflight run on the same thread. One of:\n     * - \"complete\": Complete the run.\n     * - \"continue\": Continue the run.\n     */\n    onCompletion?: OnCompletionBehavior;\n    /**\n     * Webhook to call when the run is complete.\n     */\n    webhook?: string;\n    /**\n     * Behavior to handle disconnection. Only relevant if\n     * there is a pending/inflight run on the same thread. One of:\n     * - \"cancel\": Cancel the run.\n     * - \"continue\": Continue the run.\n     */\n    onDisconnect?: DisconnectMode;\n    /**\n     * The number of seconds to wait before starting the run.\n     * Use to schedule future runs.\n     */\n    afterSeconds?: number;\n    /**\n     * Behavior if the specified run doesn't exist. Defaults to \"reject\".\n     */\n    ifNotExists?: \"create\" | \"reject\";\n    /**\n     * One or more commands to invoke the graph with.\n     */\n    command?: Command;\n    /**\n     * Callback when a run is created.\n     */\n    onRunCreated?: (params: {\n        run_id: string;\n        thread_id?: string;\n    }) => void;\n    /**\n     * @internal\n     * For LangSmith tracing purposes only. Not part of the public API.\n     */\n    _langsmithTracer?: LangChainTracer;\n}\nexport interface RunsStreamPayload<TStreamMode extends StreamMode | StreamMode[] = [], TSubgraphs extends boolean = false> extends RunsInvokePayload {\n    /**\n     * One of `\"values\"`, `\"messages\"`, `\"messages-tuple\"`, `\"updates\"`, `\"events\"`, `\"debug\"`, `\"custom\"`.\n     */\n    streamMode?: TStreamMode;\n    /**\n     * Stream output from subgraphs. By default, streams only the top graph.\n     */\n    streamSubgraphs?: TSubgraphs;\n    /**\n     * Whether the stream is considered resumable.\n     * If true, the stream can be resumed and replayed in its entirety even after disconnection.\n     */\n    streamResumable?: boolean;\n    /**\n     * Pass one or more feedbackKeys if you want to request short-lived signed URLs\n     * for submitting feedback to LangSmith with this key for this run.\n     */\n    feedbackKeys?: string[];\n}\nexport interface RunsCreatePayload extends RunsInvokePayload {\n    /**\n     * One of `\"values\"`, `\"messages\"`, `\"messages-tuple\"`, `\"updates\"`, `\"events\"`, `\"debug\"`, `\"custom\"`.\n     */\n    streamMode?: StreamMode | Array<StreamMode>;\n    /**\n     * Stream output from subgraphs. By default, streams only the top graph.\n     */\n    streamSubgraphs?: boolean;\n    /**\n     * Whether the stream is considered resumable.\n     * If true, the stream can be resumed and replayed in its entirety even after disconnection.\n     */\n    streamResumable?: boolean;\n}\nexport interface CronsCreatePayload extends RunsCreatePayload {\n    /**\n     * Schedule for running the Cron Job\n     */\n    schedule: string;\n}\nexport interface RunsWaitPayload extends RunsStreamPayload {\n    /**\n     * Raise errors returned by the run. Default is `true`.\n     */\n    raiseError?: boolean;\n}\n"],"mappings":";;;;;KAGYK,iBAAAA;KACAC,kBAAAA;AADAD,KAEAE,oBAAAA,GAFiB,UAAA,GAAA,UAAA;AACjBD,KAEAE,cAAAA,GAFkB,QAAA,GAAA,UAAA;AAClBD,KAEAE,UAAAA,GAFAF,MAAoB,GAAA,OAAA,GAAA,MAAA;AACpBC,KAEAE,WAAAA,GAFc,QAAA,GAAA,UAAA,GAAA,OAAA,GAAA,SAAA,GAAA,QAAA,GAAA,kBAAA,GAAA,mBAAA,GAAA,mBAAA,GAAA,UAAA,GAAA,CAAA,MAAA,GAAA,CAAA,CAAA,CAAA,CAAA,CAAA;AACdD,UAEKE,IAAAA,CAFK;EACVD,IAAAA,EAAAA,MAAAA;EACKC,KAAAA,EAAI,OAAA,GAAA,IAAA;AAIrB;AAAwB,UAAPC,OAAAA,CAAO;;;;WAIXC;EAYIC;;;QAQFX,CAAAA,EAAAA,OAAAA;;;;;;MAqDFa,CAAAA,EA/DFL,IA+DEK,GA/DKL,IA+DLK,EAAAA,GAAAA,MAAAA,GAAAA,MAAAA,EAAAA;;AAkBMR,UA/EFM,iBAAAA,CA+EEN;;;;EA2BFS,KAAAA,CAAAA,EAtGLJ,MAsGKI,CAAAA,MAAiB,EAAA,OAAA,CAAA,GAAA,IAAA;EAAA;;;UAIjBC,CAAAA,EAtGFf,QAsGEe;;;;EAgBAE,MAAAA,CAAAA,EAlHJlB,MAkHIkB;EAAiB;;;;SAASN,CAAAA,EAAAA,OAAAA;;AAe3C;AAMA;;;;;eA1HiBC,KAAKd;;;;;;;;;;;;;eAaLQ;;;;;;;;;;;;;;;;;;;sBAmBOJ;;;;WAIXW;;;;;;;iBAOMT;;;;;;;;;;;iBAWAC;;;;;;;;;;;;;YAaLI;;;;;;;;;;;;qBAYSZ;;UAENiB,sCAAsCb,aAAaA,+DAA+DU;;;;eAIlHI;;;;oBAIKC;;;;;;;;;;;;UAYLC,iBAAAA,SAA0BN;;;;eAI1BV,aAAaiB,MAAMjB;;;;;;;;;;;UAWnBkB,kBAAAA,SAA2BF;;;;;;UAM3BG,eAAAA,SAAwBN"}
+{"version":3,"file":"types.d.cts","names":["LangChainTracer","Checkpoint","Config","Metadata","StreamMode","MultitaskStrategy","OnConflictBehavior","OnCompletionBehavior","DisconnectMode","Durability","StreamEvent","Send","Command","Record","RunsInvokePayload","Omit","AbortController","RunsStreamPayload","TStreamMode","TSubgraphs","RunsCreatePayload","Array","CronsCreatePayload","RunsWaitPayload"],"sources":["../src/types.d.ts"],"sourcesContent":["import { LangChainTracer } from \"@langchain/core/tracers/tracer_langchain\";\nimport { Checkpoint, Config, Metadata } from \"./schema.js\";\nimport { StreamMode } from \"./types.stream.js\";\nexport type MultitaskStrategy = \"reject\" | \"interrupt\" | \"rollback\" | \"enqueue\";\nexport type OnConflictBehavior = \"raise\" | \"do_nothing\";\nexport type OnCompletionBehavior = \"complete\" | \"continue\";\nexport type DisconnectMode = \"cancel\" | \"continue\";\nexport type Durability = \"exit\" | \"async\" | \"sync\";\nexport type StreamEvent = \"events\" | \"metadata\" | \"debug\" | \"updates\" | \"values\" | \"messages/partial\" | \"messages/metadata\" | \"messages/complete\" | \"messages\" | (string & {});\nexport interface Send {\n    node: string;\n    input: unknown | null;\n}\nexport interface Command {\n    /**\n     * An object to update the thread state with.\n     */\n    update?: Record<string, unknown> | [string, unknown][] | null;\n    /**\n     * The value to return from an `interrupt` function call.\n     */\n    resume?: unknown;\n    /**\n     * Determine the next node to navigate to. Can be one of the following:\n     * - Name(s) of the node names to navigate to next.\n     * - `Send` command(s) to execute node(s) with provided input.\n     */\n    goto?: Send | Send[] | string | string[];\n}\nexport interface RunsInvokePayload {\n    /**\n     * Input to the run. Pass `null` to resume from the current state of the thread.\n     */\n    input?: Record<string, unknown> | null;\n    /**\n     * Metadata for the run.\n     */\n    metadata?: Metadata;\n    /**\n     * Additional configuration for the run.\n     */\n    config?: Config;\n    /**\n     * Static context to add to the assistant.\n     * @remarks Added in LangGraph.js 0.4\n     */\n    context?: unknown;\n    /**\n     * Checkpoint ID for when creating a new run.\n     */\n    checkpointId?: string;\n    /**\n     * Checkpoint for when creating a new run.\n     */\n    checkpoint?: Omit<Checkpoint, \"thread_id\">;\n    /**\n     * Whether to checkpoint during the run (or only at the end/interruption).\n     * @deprecated Use `durability` instead.\n     */\n    checkpointDuring?: 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     * Interrupt execution before entering these nodes.\n     */\n    interruptBefore?: \"*\" | string[];\n    /**\n     * Interrupt execution after leaving these nodes.\n     */\n    interruptAfter?: \"*\" | string[];\n    /**\n     * Strategy to handle concurrent runs on the same thread. Only relevant if\n     * there is a pending/inflight run on the same thread. One of:\n     * - \"reject\": Reject the new run.\n     * - \"interrupt\": Interrupt the current run, keeping steps completed until now,\n         and start a new one.\n     * - \"rollback\": Cancel and delete the existing run, rolling back the thread to\n        the state before it had started, then start the new run.\n     * - \"enqueue\": Queue up the new run to start after the current run finishes.\n     */\n    multitaskStrategy?: MultitaskStrategy;\n    /**\n     * Abort controller signal to cancel the run.\n     */\n    signal?: AbortController[\"signal\"];\n    /**\n     * Behavior to handle run completion. Only relevant if\n     * there is a pending/inflight run on the same thread. One of:\n     * - \"complete\": Complete the run.\n     * - \"continue\": Continue the run.\n     */\n    onCompletion?: OnCompletionBehavior;\n    /**\n     * Webhook to call when the run is complete.\n     */\n    webhook?: string;\n    /**\n     * Behavior to handle disconnection. Only relevant if\n     * there is a pending/inflight run on the same thread. One of:\n     * - \"cancel\": Cancel the run.\n     * - \"continue\": Continue the run.\n     */\n    onDisconnect?: DisconnectMode;\n    /**\n     * The number of seconds to wait before starting the run.\n     * Use to schedule future runs.\n     */\n    afterSeconds?: number;\n    /**\n     * Behavior if the specified run doesn't exist. Defaults to \"reject\".\n     */\n    ifNotExists?: \"create\" | \"reject\";\n    /**\n     * One or more commands to invoke the graph with.\n     */\n    command?: Command;\n    /**\n     * Callback when a run is created.\n     */\n    onRunCreated?: (params: {\n        run_id: string;\n        thread_id?: string;\n    }) => void;\n    /**\n     * @internal\n     * For LangSmith tracing purposes only. Not part of the public API.\n     */\n    _langsmithTracer?: LangChainTracer;\n}\nexport interface RunsStreamPayload<TStreamMode extends StreamMode | StreamMode[] = [], TSubgraphs extends boolean = false> extends RunsInvokePayload {\n    /**\n     * One of `\"values\"`, `\"messages\"`, `\"messages-tuple\"`, `\"updates\"`, `\"events\"`, `\"debug\"`, `\"custom\"`.\n     */\n    streamMode?: TStreamMode;\n    /**\n     * Stream output from subgraphs. By default, streams only the top graph.\n     */\n    streamSubgraphs?: TSubgraphs;\n    /**\n     * Whether the stream is considered resumable.\n     * If true, the stream can be resumed and replayed in its entirety even after disconnection.\n     */\n    streamResumable?: boolean;\n    /**\n     * Pass one or more feedbackKeys if you want to request short-lived signed URLs\n     * for submitting feedback to LangSmith with this key for this run.\n     */\n    feedbackKeys?: string[];\n}\nexport interface RunsCreatePayload extends RunsInvokePayload {\n    /**\n     * One of `\"values\"`, `\"messages\"`, `\"messages-tuple\"`, `\"updates\"`, `\"events\"`, `\"debug\"`, `\"custom\"`.\n     */\n    streamMode?: StreamMode | Array<StreamMode>;\n    /**\n     * Stream output from subgraphs. By default, streams only the top graph.\n     */\n    streamSubgraphs?: boolean;\n    /**\n     * Whether the stream is considered resumable.\n     * If true, the stream can be resumed and replayed in its entirety even after disconnection.\n     */\n    streamResumable?: boolean;\n}\nexport interface CronsCreatePayload extends RunsCreatePayload {\n    /**\n     * Schedule for running the Cron Job\n     */\n    schedule: string;\n}\nexport interface RunsWaitPayload extends RunsStreamPayload {\n    /**\n     * Raise errors returned by the run. Default is `true`.\n     */\n    raiseError?: boolean;\n}\n"],"mappings":";;;;;KAGYK,iBAAAA;KACAC,kBAAAA;AADAD,KAEAE,oBAAAA,GAFiB,UAAA,GAAA,UAAA;AACjBD,KAEAE,cAAAA,GAFkB,QAAA,GAAA,UAAA;AAClBD,KAEAE,UAAAA,GAFAF,MAAoB,GAAA,OAAA,GAAA,MAAA;AACpBC,KAEAE,WAAAA,GAFc,QAAA,GAAA,UAAA,GAAA,OAAA,GAAA,SAAA,GAAA,QAAA,GAAA,kBAAA,GAAA,mBAAA,GAAA,mBAAA,GAAA,UAAA,GAAA,CAAA,MAAA,GAAA,CAAA,CAAA,CAAA;AACdD,UAEKE,IAAAA,CAFK;EACVD,IAAAA,EAAAA,MAAAA;EACKC,KAAAA,EAAI,OAAA,GAAA,IAAA;AAIrB;AAAwB,UAAPC,OAAAA,CAAO;;;;EAcF,MAAA,CAAA,EAVTC,MAUS,CAAA,MAAA,EAAA,OAAA,CAAA,GAAA,CAAA,MAAA,EAAA,OAAA,CAAA,EAAA,GAAA,IAAA;EAELC;;;QAQFX,CAAAA,EAAAA,OAAAA;;;;;;MAqDFa,CAAAA,EA/DFL,IA+DEK,GA/DKL,IA+DLK,EAAAA,GAAAA,MAAAA,GAAAA,MAAAA,EAAAA;;AAkBMR,UA/EFM,iBAAAA,CA+EEN;;;;EA2BFS,KAAAA,CAAAA,EAtGLJ,MAsGKI,CAAAA,MAAiB,EAAA,OAAA,CAAA,GAAA,IAAA;EAAA;;;UAIjBC,CAAAA,EAtGFf,QAsGEe;;;;EAgBAE,MAAAA,CAAAA,EAlHJlB,MAkHIkB;EAAiB;;;;SAASN,CAAAA,EAAAA,OAAAA;EAAiB;AAe5D;AAMA;;;;;eA1HiBC,KAAKd;;;;;;;;;;;;;eAaLQ;;;;;;;;;;;;;;;;;;;sBAmBOJ;;;;WAIXW;;;;;;;iBAOMT;;;;;;;;;;;iBAWAC;;;;;;;;;;;;;YAaLI;;;;;;;;;;;;qBAYSZ;;UAENiB,sCAAsCb,aAAaA,+DAA+DU;;;;eAIlHI;;;;oBAIKC;;;;;;;;;;;;UAYLC,iBAAAA,SAA0BN;;;;eAI1BV,aAAaiB,MAAMjB;;;;;;;;;;;UAWnBkB,kBAAAA,SAA2BF;;;;;;UAM3BG,eAAAA,SAAwBN"}

package/dist/types.d.ts

@@ -8,7 +8,7 @@ type OnConflictBehavior = "raise" | "do_nothing";
 type OnCompletionBehavior = "complete" | "continue";
 type DisconnectMode = "cancel" | "continue";
 type Durability = "exit" | "async" | "sync";
-type StreamEvent = "events" | "metadata" | "debug" | "updates" | "values" | "messages/partial" | "messages/metadata" | "messages/complete" | "messages" | (string & {}); // eslint-disable-line @typescript-eslint/ban-types
+type StreamEvent = "events" | "metadata" | "debug" | "updates" | "values" | "messages/partial" | "messages/metadata" | "messages/complete" | "messages" | (string & {});
 interface Send {
   node: string;
   input: unknown | null;

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","names":["LangChainTracer","Checkpoint","Config","Metadata","StreamMode","MultitaskStrategy","OnConflictBehavior","OnCompletionBehavior","DisconnectMode","Durability","StreamEvent","Send","Command","Record","RunsInvokePayload","Omit","AbortController","RunsStreamPayload","TStreamMode","TSubgraphs","RunsCreatePayload","Array","CronsCreatePayload","RunsWaitPayload"],"sources":["../src/types.d.ts"],"sourcesContent":["import { LangChainTracer } from \"@langchain/core/tracers/tracer_langchain\";\nimport { Checkpoint, Config, Metadata } from \"./schema.js\";\nimport { StreamMode } from \"./types.stream.js\";\nexport type MultitaskStrategy = \"reject\" | \"interrupt\" | \"rollback\" | \"enqueue\";\nexport type OnConflictBehavior = \"raise\" | \"do_nothing\";\nexport type OnCompletionBehavior = \"complete\" | \"continue\";\nexport type DisconnectMode = \"cancel\" | \"continue\";\nexport type Durability = \"exit\" | \"async\" | \"sync\";\nexport type StreamEvent = \"events\" | \"metadata\" | \"debug\" | \"updates\" | \"values\" | \"messages/partial\" | \"messages/metadata\" | \"messages/complete\" | \"messages\" | (string & {}); // eslint-disable-line @typescript-eslint/ban-types\nexport interface Send {\n    node: string;\n    input: unknown | null;\n}\nexport interface Command {\n    /**\n     * An object to update the thread state with.\n     */\n    update?: Record<string, unknown> | [string, unknown][] | null;\n    /**\n     * The value to return from an `interrupt` function call.\n     */\n    resume?: unknown;\n    /**\n     * Determine the next node to navigate to. Can be one of the following:\n     * - Name(s) of the node names to navigate to next.\n     * - `Send` command(s) to execute node(s) with provided input.\n     */\n    goto?: Send | Send[] | string | string[];\n}\nexport interface RunsInvokePayload {\n    /**\n     * Input to the run. Pass `null` to resume from the current state of the thread.\n     */\n    input?: Record<string, unknown> | null;\n    /**\n     * Metadata for the run.\n     */\n    metadata?: Metadata;\n    /**\n     * Additional configuration for the run.\n     */\n    config?: Config;\n    /**\n     * Static context to add to the assistant.\n     * @remarks Added in LangGraph.js 0.4\n     */\n    context?: unknown;\n    /**\n     * Checkpoint ID for when creating a new run.\n     */\n    checkpointId?: string;\n    /**\n     * Checkpoint for when creating a new run.\n     */\n    checkpoint?: Omit<Checkpoint, \"thread_id\">;\n    /**\n     * Whether to checkpoint during the run (or only at the end/interruption).\n     * @deprecated Use `durability` instead.\n     */\n    checkpointDuring?: 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     * Interrupt execution before entering these nodes.\n     */\n    interruptBefore?: \"*\" | string[];\n    /**\n     * Interrupt execution after leaving these nodes.\n     */\n    interruptAfter?: \"*\" | string[];\n    /**\n     * Strategy to handle concurrent runs on the same thread. Only relevant if\n     * there is a pending/inflight run on the same thread. One of:\n     * - \"reject\": Reject the new run.\n     * - \"interrupt\": Interrupt the current run, keeping steps completed until now,\n         and start a new one.\n     * - \"rollback\": Cancel and delete the existing run, rolling back the thread to\n        the state before it had started, then start the new run.\n     * - \"enqueue\": Queue up the new run to start after the current run finishes.\n     */\n    multitaskStrategy?: MultitaskStrategy;\n    /**\n     * Abort controller signal to cancel the run.\n     */\n    signal?: AbortController[\"signal\"];\n    /**\n     * Behavior to handle run completion. Only relevant if\n     * there is a pending/inflight run on the same thread. One of:\n     * - \"complete\": Complete the run.\n     * - \"continue\": Continue the run.\n     */\n    onCompletion?: OnCompletionBehavior;\n    /**\n     * Webhook to call when the run is complete.\n     */\n    webhook?: string;\n    /**\n     * Behavior to handle disconnection. Only relevant if\n     * there is a pending/inflight run on the same thread. One of:\n     * - \"cancel\": Cancel the run.\n     * - \"continue\": Continue the run.\n     */\n    onDisconnect?: DisconnectMode;\n    /**\n     * The number of seconds to wait before starting the run.\n     * Use to schedule future runs.\n     */\n    afterSeconds?: number;\n    /**\n     * Behavior if the specified run doesn't exist. Defaults to \"reject\".\n     */\n    ifNotExists?: \"create\" | \"reject\";\n    /**\n     * One or more commands to invoke the graph with.\n     */\n    command?: Command;\n    /**\n     * Callback when a run is created.\n     */\n    onRunCreated?: (params: {\n        run_id: string;\n        thread_id?: string;\n    }) => void;\n    /**\n     * @internal\n     * For LangSmith tracing purposes only. Not part of the public API.\n     */\n    _langsmithTracer?: LangChainTracer;\n}\nexport interface RunsStreamPayload<TStreamMode extends StreamMode | StreamMode[] = [], TSubgraphs extends boolean = false> extends RunsInvokePayload {\n    /**\n     * One of `\"values\"`, `\"messages\"`, `\"messages-tuple\"`, `\"updates\"`, `\"events\"`, `\"debug\"`, `\"custom\"`.\n     */\n    streamMode?: TStreamMode;\n    /**\n     * Stream output from subgraphs. By default, streams only the top graph.\n     */\n    streamSubgraphs?: TSubgraphs;\n    /**\n     * Whether the stream is considered resumable.\n     * If true, the stream can be resumed and replayed in its entirety even after disconnection.\n     */\n    streamResumable?: boolean;\n    /**\n     * Pass one or more feedbackKeys if you want to request short-lived signed URLs\n     * for submitting feedback to LangSmith with this key for this run.\n     */\n    feedbackKeys?: string[];\n}\nexport interface RunsCreatePayload extends RunsInvokePayload {\n    /**\n     * One of `\"values\"`, `\"messages\"`, `\"messages-tuple\"`, `\"updates\"`, `\"events\"`, `\"debug\"`, `\"custom\"`.\n     */\n    streamMode?: StreamMode | Array<StreamMode>;\n    /**\n     * Stream output from subgraphs. By default, streams only the top graph.\n     */\n    streamSubgraphs?: boolean;\n    /**\n     * Whether the stream is considered resumable.\n     * If true, the stream can be resumed and replayed in its entirety even after disconnection.\n     */\n    streamResumable?: boolean;\n}\nexport interface CronsCreatePayload extends RunsCreatePayload {\n    /**\n     * Schedule for running the Cron Job\n     */\n    schedule: string;\n}\nexport interface RunsWaitPayload extends RunsStreamPayload {\n    /**\n     * Raise errors returned by the run. Default is `true`.\n     */\n    raiseError?: boolean;\n}\n"],"mappings":";;;;;KAGYK,iBAAAA;KACAC,kBAAAA;AADAD,KAEAE,oBAAAA,GAFiB,UAAA,GAAA,UAAA;AACjBD,KAEAE,cAAAA,GAFkB,QAAA,GAAA,UAAA;AAClBD,KAEAE,UAAAA,GAFAF,MAAoB,GAAA,OAAA,GAAA,MAAA;AACpBC,KAEAE,WAAAA,GAFc,QAAA,GAAA,UAAA,GAAA,OAAA,GAAA,SAAA,GAAA,QAAA,GAAA,kBAAA,GAAA,mBAAA,GAAA,mBAAA,GAAA,UAAA,GAAA,CAAA,MAAA,GAAA,CAAA,CAAA,CAAA,CAAA,CAAA;AACdD,UAEKE,IAAAA,CAFK;EACVD,IAAAA,EAAAA,MAAAA;EACKC,KAAAA,EAAI,OAAA,GAAA,IAAA;AAIrB;AAAwB,UAAPC,OAAAA,CAAO;;;;WAIXC;EAYIC;;;QAQFX,CAAAA,EAAAA,OAAAA;;;;;;MAqDFa,CAAAA,EA/DFL,IA+DEK,GA/DKL,IA+DLK,EAAAA,GAAAA,MAAAA,GAAAA,MAAAA,EAAAA;;AAkBMR,UA/EFM,iBAAAA,CA+EEN;;;;EA2BFS,KAAAA,CAAAA,EAtGLJ,MAsGKI,CAAAA,MAAiB,EAAA,OAAA,CAAA,GAAA,IAAA;EAAA;;;UAIjBC,CAAAA,EAtGFf,QAsGEe;;;;EAgBAE,MAAAA,CAAAA,EAlHJlB,MAkHIkB;EAAiB;;;;SAASN,CAAAA,EAAAA,OAAAA;;AAe3C;AAMA;;;;;eA1HiBC,KAAKd;;;;;;;;;;;;;eAaLQ;;;;;;;;;;;;;;;;;;;sBAmBOJ;;;;WAIXW;;;;;;;iBAOMT;;;;;;;;;;;iBAWAC;;;;;;;;;;;;;YAaLI;;;;;;;;;;;;qBAYSZ;;UAENiB,sCAAsCb,aAAaA,+DAA+DU;;;;eAIlHI;;;;oBAIKC;;;;;;;;;;;;UAYLC,iBAAAA,SAA0BN;;;;eAI1BV,aAAaiB,MAAMjB;;;;;;;;;;;UAWnBkB,kBAAAA,SAA2BF;;;;;;UAM3BG,eAAAA,SAAwBN"}
+{"version":3,"file":"types.d.ts","names":["LangChainTracer","Checkpoint","Config","Metadata","StreamMode","MultitaskStrategy","OnConflictBehavior","OnCompletionBehavior","DisconnectMode","Durability","StreamEvent","Send","Command","Record","RunsInvokePayload","Omit","AbortController","RunsStreamPayload","TStreamMode","TSubgraphs","RunsCreatePayload","Array","CronsCreatePayload","RunsWaitPayload"],"sources":["../src/types.d.ts"],"sourcesContent":["import { LangChainTracer } from \"@langchain/core/tracers/tracer_langchain\";\nimport { Checkpoint, Config, Metadata } from \"./schema.js\";\nimport { StreamMode } from \"./types.stream.js\";\nexport type MultitaskStrategy = \"reject\" | \"interrupt\" | \"rollback\" | \"enqueue\";\nexport type OnConflictBehavior = \"raise\" | \"do_nothing\";\nexport type OnCompletionBehavior = \"complete\" | \"continue\";\nexport type DisconnectMode = \"cancel\" | \"continue\";\nexport type Durability = \"exit\" | \"async\" | \"sync\";\nexport type StreamEvent = \"events\" | \"metadata\" | \"debug\" | \"updates\" | \"values\" | \"messages/partial\" | \"messages/metadata\" | \"messages/complete\" | \"messages\" | (string & {});\nexport interface Send {\n    node: string;\n    input: unknown | null;\n}\nexport interface Command {\n    /**\n     * An object to update the thread state with.\n     */\n    update?: Record<string, unknown> | [string, unknown][] | null;\n    /**\n     * The value to return from an `interrupt` function call.\n     */\n    resume?: unknown;\n    /**\n     * Determine the next node to navigate to. Can be one of the following:\n     * - Name(s) of the node names to navigate to next.\n     * - `Send` command(s) to execute node(s) with provided input.\n     */\n    goto?: Send | Send[] | string | string[];\n}\nexport interface RunsInvokePayload {\n    /**\n     * Input to the run. Pass `null` to resume from the current state of the thread.\n     */\n    input?: Record<string, unknown> | null;\n    /**\n     * Metadata for the run.\n     */\n    metadata?: Metadata;\n    /**\n     * Additional configuration for the run.\n     */\n    config?: Config;\n    /**\n     * Static context to add to the assistant.\n     * @remarks Added in LangGraph.js 0.4\n     */\n    context?: unknown;\n    /**\n     * Checkpoint ID for when creating a new run.\n     */\n    checkpointId?: string;\n    /**\n     * Checkpoint for when creating a new run.\n     */\n    checkpoint?: Omit<Checkpoint, \"thread_id\">;\n    /**\n     * Whether to checkpoint during the run (or only at the end/interruption).\n     * @deprecated Use `durability` instead.\n     */\n    checkpointDuring?: 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     * Interrupt execution before entering these nodes.\n     */\n    interruptBefore?: \"*\" | string[];\n    /**\n     * Interrupt execution after leaving these nodes.\n     */\n    interruptAfter?: \"*\" | string[];\n    /**\n     * Strategy to handle concurrent runs on the same thread. Only relevant if\n     * there is a pending/inflight run on the same thread. One of:\n     * - \"reject\": Reject the new run.\n     * - \"interrupt\": Interrupt the current run, keeping steps completed until now,\n         and start a new one.\n     * - \"rollback\": Cancel and delete the existing run, rolling back the thread to\n        the state before it had started, then start the new run.\n     * - \"enqueue\": Queue up the new run to start after the current run finishes.\n     */\n    multitaskStrategy?: MultitaskStrategy;\n    /**\n     * Abort controller signal to cancel the run.\n     */\n    signal?: AbortController[\"signal\"];\n    /**\n     * Behavior to handle run completion. Only relevant if\n     * there is a pending/inflight run on the same thread. One of:\n     * - \"complete\": Complete the run.\n     * - \"continue\": Continue the run.\n     */\n    onCompletion?: OnCompletionBehavior;\n    /**\n     * Webhook to call when the run is complete.\n     */\n    webhook?: string;\n    /**\n     * Behavior to handle disconnection. Only relevant if\n     * there is a pending/inflight run on the same thread. One of:\n     * - \"cancel\": Cancel the run.\n     * - \"continue\": Continue the run.\n     */\n    onDisconnect?: DisconnectMode;\n    /**\n     * The number of seconds to wait before starting the run.\n     * Use to schedule future runs.\n     */\n    afterSeconds?: number;\n    /**\n     * Behavior if the specified run doesn't exist. Defaults to \"reject\".\n     */\n    ifNotExists?: \"create\" | \"reject\";\n    /**\n     * One or more commands to invoke the graph with.\n     */\n    command?: Command;\n    /**\n     * Callback when a run is created.\n     */\n    onRunCreated?: (params: {\n        run_id: string;\n        thread_id?: string;\n    }) => void;\n    /**\n     * @internal\n     * For LangSmith tracing purposes only. Not part of the public API.\n     */\n    _langsmithTracer?: LangChainTracer;\n}\nexport interface RunsStreamPayload<TStreamMode extends StreamMode | StreamMode[] = [], TSubgraphs extends boolean = false> extends RunsInvokePayload {\n    /**\n     * One of `\"values\"`, `\"messages\"`, `\"messages-tuple\"`, `\"updates\"`, `\"events\"`, `\"debug\"`, `\"custom\"`.\n     */\n    streamMode?: TStreamMode;\n    /**\n     * Stream output from subgraphs. By default, streams only the top graph.\n     */\n    streamSubgraphs?: TSubgraphs;\n    /**\n     * Whether the stream is considered resumable.\n     * If true, the stream can be resumed and replayed in its entirety even after disconnection.\n     */\n    streamResumable?: boolean;\n    /**\n     * Pass one or more feedbackKeys if you want to request short-lived signed URLs\n     * for submitting feedback to LangSmith with this key for this run.\n     */\n    feedbackKeys?: string[];\n}\nexport interface RunsCreatePayload extends RunsInvokePayload {\n    /**\n     * One of `\"values\"`, `\"messages\"`, `\"messages-tuple\"`, `\"updates\"`, `\"events\"`, `\"debug\"`, `\"custom\"`.\n     */\n    streamMode?: StreamMode | Array<StreamMode>;\n    /**\n     * Stream output from subgraphs. By default, streams only the top graph.\n     */\n    streamSubgraphs?: boolean;\n    /**\n     * Whether the stream is considered resumable.\n     * If true, the stream can be resumed and replayed in its entirety even after disconnection.\n     */\n    streamResumable?: boolean;\n}\nexport interface CronsCreatePayload extends RunsCreatePayload {\n    /**\n     * Schedule for running the Cron Job\n     */\n    schedule: string;\n}\nexport interface RunsWaitPayload extends RunsStreamPayload {\n    /**\n     * Raise errors returned by the run. Default is `true`.\n     */\n    raiseError?: boolean;\n}\n"],"mappings":";;;;;KAGYK,iBAAAA;KACAC,kBAAAA;AADAD,KAEAE,oBAAAA,GAFiB,UAAA,GAAA,UAAA;AACjBD,KAEAE,cAAAA,GAFkB,QAAA,GAAA,UAAA;AAClBD,KAEAE,UAAAA,GAFAF,MAAoB,GAAA,OAAA,GAAA,MAAA;AACpBC,KAEAE,WAAAA,GAFc,QAAA,GAAA,UAAA,GAAA,OAAA,GAAA,SAAA,GAAA,QAAA,GAAA,kBAAA,GAAA,mBAAA,GAAA,mBAAA,GAAA,UAAA,GAAA,CAAA,MAAA,GAAA,CAAA,CAAA,CAAA;AACdD,UAEKE,IAAAA,CAFK;EACVD,IAAAA,EAAAA,MAAAA;EACKC,KAAAA,EAAI,OAAA,GAAA,IAAA;AAIrB;AAAwB,UAAPC,OAAAA,CAAO;;;;EAcF,MAAA,CAAA,EAVTC,MAUS,CAAA,MAAA,EAAA,OAAA,CAAA,GAAA,CAAA,MAAA,EAAA,OAAA,CAAA,EAAA,GAAA,IAAA;EAELC;;;QAQFX,CAAAA,EAAAA,OAAAA;;;;;;MAqDFa,CAAAA,EA/DFL,IA+DEK,GA/DKL,IA+DLK,EAAAA,GAAAA,MAAAA,GAAAA,MAAAA,EAAAA;;AAkBMR,UA/EFM,iBAAAA,CA+EEN;;;;EA2BFS,KAAAA,CAAAA,EAtGLJ,MAsGKI,CAAAA,MAAiB,EAAA,OAAA,CAAA,GAAA,IAAA;EAAA;;;UAIjBC,CAAAA,EAtGFf,QAsGEe;;;;EAgBAE,MAAAA,CAAAA,EAlHJlB,MAkHIkB;EAAiB;;;;SAASN,CAAAA,EAAAA,OAAAA;EAAiB;AAe5D;AAMA;;;;;eA1HiBC,KAAKd;;;;;;;;;;;;;eAaLQ;;;;;;;;;;;;;;;;;;;sBAmBOJ;;;;WAIXW;;;;;;;iBAOMT;;;;;;;;;;;iBAWAC;;;;;;;;;;;;;YAaLI;;;;;;;;;;;;qBAYSZ;;UAENiB,sCAAsCb,aAAaA,+DAA+DU;;;;eAIlHI;;;;oBAIKC;;;;;;;;;;;;UAYLC,iBAAAA,SAA0BN;;;;eAI1BV,aAAaiB,MAAMjB;;;;;;;;;;;UAWnBkB,kBAAAA,SAA2BF;;;;;;UAM3BG,eAAAA,SAAwBN"}

package/dist/types.messages.d.cts

@@ -28,39 +28,77 @@ type HumanMessage = BaseMessage & {
   type: "human";
   example?: boolean | undefined;
 };
-type AIMessage = BaseMessage & {
+/**
+ * Default tool call type when no specific tool definitions are provided.
+ */
+type DefaultToolCall = {
+  name: string;
+  args: {
+    [x: string]: any;
+  };
+  id?: string | undefined;
+  type?: "tool_call" | undefined;
+};
+/**
+ * Invalid tool call type.
+ */
+type InvalidToolCall = {
+  name?: string | undefined;
+  args?: string | undefined;
+  id?: string | undefined;
+  error?: string | undefined;
+  type?: "invalid_tool_call" | undefined;
+};
+/**
+ * Usage metadata for AI messages.
+ */
+type UsageMetadata = {
+  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;
+};
+/**
+ * AI message type that can be parameterized with custom tool call types.
+ *
+ * @template ToolCall The type of tool calls, defaults to DefaultToolCall.
+ *                    Provide a discriminated union for type-safe tool call handling.
+ *
+ * @example
+ * ```ts
+ * // Define typed tool calls as a discriminated union
+ * type MyToolCalls =
+ *   | { name: "get_weather"; args: { location: string }; id?: string }
+ *   | { name: "search"; args: { query: string; limit?: number }; id?: string };
+ *
+ * // Use with AIMessage
+ * const message: AIMessage<MyToolCalls> = ...;
+ *
+ * // Now tool.name === "get_weather" narrows tool.args type
+ * if (message.tool_calls) {
+ *   for (const tool of message.tool_calls) {
+ *     if (tool.name === "get_weather") {
+ *       // tool.args is now { location: string }
+ *       console.log(tool.args.location);
+ *     }
+ *   }
+ * }
+ * ```
+ */
+type AIMessage<ToolCall = DefaultToolCall> = BaseMessage & {
   type: "ai";
   example?: boolean | undefined;
-  tool_calls?: {
-    name: string;
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    args: {
-      [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;
+  tool_calls?: ToolCall[] | undefined;
+  invalid_tool_calls?: InvalidToolCall[] | undefined;
+  usage_metadata?: UsageMetadata | undefined;
 };
 type ToolMessage = BaseMessage & {
   type: "tool";
@@ -73,7 +111,6 @@ type ToolMessage = BaseMessage & {
    * a subset of the full tool output is being passed as message content but the full
    * output is needed in other parts of the code.
    */
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
   artifact?: any;
 };
 type SystemMessage = BaseMessage & {
@@ -85,7 +122,143 @@ type FunctionMessage = BaseMessage & {
 type RemoveMessage = BaseMessage & {
   type: "remove";
 };
-type Message = HumanMessage | AIMessage | ToolMessage | SystemMessage | FunctionMessage | RemoveMessage;
+/**
+ * Union of all message types.
+ *
+ * @template ToolCall The type of tool calls for AIMessage, defaults to DefaultToolCall.
+ */
+type Message<ToolCall = DefaultToolCall> = HumanMessage | AIMessage<ToolCall> | ToolMessage | SystemMessage | FunctionMessage | RemoveMessage;
+/**
+ * Helper type to infer schema input type, supporting both Zod v3 and v4.
+ * - Zod v4 uses `_zod.input` property
+ * - Zod v3 uses `_input` property
+ *
+ * Note: Zod v4 is checked first as it's the more specific structure.
+ */
+type InferSchemaInput<S> = S extends {
+  _zod: {
+    input: infer Args;
+  };
+} ? Args : S extends {
+  _input: infer Args;
+} ? Args : never;
+/**
+ * Helper type to extract the input type from a DynamicStructuredTool's _call method.
+ * This is more reliable than trying to infer from the schema directly because
+ * DynamicStructuredTool has the input type baked into its _call signature.
+ */
+type InferToolInput<T> = T extends {
+  _call: (arg: infer Args, ...rest: any[]) => any;
+} ? Args : T extends {
+  schema: infer S;
+} ? InferSchemaInput<S> : never;
+/**
+ * Infer a tool call type from a single tool.
+ * Works with tools created via `tool()` from `@langchain/core/tools`.
+ *
+ * For DynamicStructuredTool, this extracts the input type from the _call method,
+ * which is the most reliable source as it's the pre-computed input type.
+ *
+ * @template T The tool type (e.g., DynamicStructuredTool)
+ *
+ * @example
+ * ```ts
+ * import { tool } from "@langchain/core/tools";
+ * import { z } from "zod";
+ *
+ * const getWeather = tool(
+ *   async ({ location }) => `Weather in ${location}`,
+ *   { name: "get_weather", schema: z.object({ location: z.string() }) }
+ * );
+ *
+ * // Infer: { name: "get_weather"; args: { location: string }; id?: string; type?: "tool_call" }
+ * type WeatherToolCall = ToolCallFromTool<typeof getWeather>;
+ * ```
+ */
+type ToolCallFromTool<T> = T extends {
+  name: infer N;
+} ? InferToolInput<T> extends infer Args ? Args extends never ? never : Args extends Record<string, any> ? {
+  name: N;
+  args: Args;
+  id?: string;
+  type?: "tool_call";
+} : never : never : never;
+/**
+ * Infer a union of tool call types from an array of tools.
+ * Works with tools created via `tool()` from `@langchain/core/tools`.
+ *
+ * @template T A tuple/array of tools
+ *
+ * @example
+ * ```ts
+ * import { tool } from "@langchain/core/tools";
+ * import { z } from "zod";
+ *
+ * const getWeather = tool(
+ *   async ({ location }) => `Weather in ${location}`,
+ *   { name: "get_weather", schema: z.object({ location: z.string() }) }
+ * );
+ *
+ * const search = tool(
+ *   async ({ query }) => `Results for ${query}`,
+ *   { name: "search", schema: z.object({ query: z.string() }) }
+ * );
+ *
+ * const tools = [getWeather, search] as const;
+ *
+ * // Infer union:
+ * // | { name: "get_weather"; args: { location: string }; id?: string; type?: "tool_call" }
+ * // | { name: "search"; args: { query: string }; id?: string; type?: "tool_call" }
+ * type MyToolCalls = ToolCallsFromTools<typeof tools>;
+ * ```
+ */
+type ToolCallsFromTools<T extends readonly unknown[]> = T extends readonly [infer First, ...infer Rest] ? ToolCallFromTool<First> | ToolCallsFromTools<Rest> : never;
+/**
+ * The lifecycle state of a tool call.
+ *
+ * - `pending`: Tool call received, awaiting result
+ * - `completed`: Tool execution finished successfully
+ * - `error`: Tool execution failed (result.status === "error")
+ */
+type ToolCallState = "pending" | "completed" | "error";
+/**
+ * Represents a tool call paired with its result.
+ * Useful for rendering tool invocations and their outputs together.
+ *
+ * @template ToolCall The type of the tool call.
+ */
+type ToolCallWithResult<ToolCall = DefaultToolCall> = {
+  /**
+   * Unique identifier for this tool call.
+   * Uses the tool call's id if available, otherwise generates one from aiMessage.id and index.
+   */
+  id: string;
+  /**
+   * The tool call from the AI message.
+   */
+  call: ToolCall;
+  /**
+   * The result message from tool execution.
+   * `undefined` if the tool is still being executed or no result was received.
+   */
+  result: ToolMessage | undefined;
+  /**
+   * The AI message that initiated this tool call.
+   */
+  aiMessage: AIMessage<ToolCall>;
+  /**
+   * Index of this tool call within the AI message's tool_calls array.
+   */
+  index: number;
+  /**
+   * The current lifecycle state of the tool call.
+   *
+   * - `pending`: No result yet
+   * - `completed`: Has result with success status
+   * - `error`: Has result with error status
+   */
+  state: ToolCallState;
+};
 //#endregion
-export { AIMessage, FunctionMessage, HumanMessage, Message, RemoveMessage, SystemMessage, ToolMessage };
+export { AIMessage, DefaultToolCall, FunctionMessage, HumanMessage, Message, RemoveMessage, SystemMessage, ToolCallFromTool, ToolCallState, ToolCallWithResult, ToolCallsFromTools, ToolMessage };
 //# sourceMappingURL=types.messages.d.cts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.messages.d.cts","names":["ImageDetail","MessageContentImageUrl","MessageContentText","MessageContentComplex","MessageContent","MessageAdditionalKwargs","Record","BaseMessage","HumanMessage","AIMessage","ToolMessage","SystemMessage","FunctionMessage","RemoveMessage","Message"],"sources":["../src/types.messages.d.ts"],"sourcesContent":["type ImageDetail = \"auto\" | \"low\" | \"high\";\ntype MessageContentImageUrl = {\n    type: \"image_url\";\n    image_url: string | {\n        url: string;\n        detail?: ImageDetail | undefined;\n    };\n};\ntype MessageContentText = {\n    type: \"text\";\n    text: string;\n};\ntype MessageContentComplex = MessageContentText | MessageContentImageUrl;\ntype MessageContent = string | MessageContentComplex[];\n/**\n * Model-specific additional kwargs, which is passed back to the underlying LLM.\n */\ntype MessageAdditionalKwargs = Record<string, unknown>;\ntype BaseMessage = {\n    additional_kwargs?: MessageAdditionalKwargs | undefined;\n    content: MessageContent;\n    id?: string | undefined;\n    name?: string | undefined;\n    response_metadata?: Record<string, unknown> | undefined;\n};\nexport type HumanMessage = BaseMessage & {\n    type: \"human\";\n    example?: boolean | undefined;\n};\nexport type AIMessage = BaseMessage & {\n    type: \"ai\";\n    example?: boolean | undefined;\n    tool_calls?: {\n        name: string;\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        args: {\n            [x: string]: any;\n        };\n        id?: string | undefined;\n        type?: \"tool_call\" | undefined;\n    }[] | undefined;\n    invalid_tool_calls?: {\n        name?: string | undefined;\n        args?: string | undefined;\n        id?: string | undefined;\n        error?: string | undefined;\n        type?: \"invalid_tool_call\" | undefined;\n    }[] | undefined;\n    usage_metadata?: {\n        input_tokens: number;\n        output_tokens: number;\n        total_tokens: number;\n        input_token_details?: {\n            audio?: number | undefined;\n            cache_read?: number | undefined;\n            cache_creation?: number | undefined;\n        } | undefined;\n        output_token_details?: {\n            audio?: number | undefined;\n            reasoning?: number | undefined;\n        } | undefined;\n    } | undefined;\n};\nexport type ToolMessage = BaseMessage & {\n    type: \"tool\";\n    status?: \"error\" | \"success\" | undefined;\n    tool_call_id: string;\n    /**\n     * Artifact of the Tool execution which is not meant to be sent to the model.\n     *\n     * Should only be specified if it is different from the message content, e.g. if only\n     * a subset of the full tool output is being passed as message content but the full\n     * output is needed in other parts of the code.\n     */\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    artifact?: any;\n};\nexport type SystemMessage = BaseMessage & {\n    type: \"system\";\n};\nexport type FunctionMessage = BaseMessage & {\n    type: \"function\";\n};\nexport type RemoveMessage = BaseMessage & {\n    type: \"remove\";\n};\nexport type Message = HumanMessage | AIMessage | ToolMessage | SystemMessage | FunctionMessage | RemoveMessage;\nexport {};\n"],"mappings":";KAAKA,WAAAA;KACAC,sBAAAA,GADW;EACXA,IAAAA,EAAAA,WAAAA;EAOAC,SAAAA,EAAAA,MAAAA,GAAAA;IAIAC,GAAAA,EAAAA,MAAAA;IAAqB,MAAA,CAAA,EAPTH,WAOS,GAAA,SAAA;;;KAJrBE,kBAAAA;EAKAE,IAAAA,EAAAA,MAAAA;EAIAC,IAAAA,EAAAA,MAAAA;AAAgC,CAAA;KALhCF,qBAAAA,GAAwBD,kBAMb,GANkCD,sBAMlC;KALXG,cAAAA,GAMmBC,MAAAA,GANOF,qBAMPE,EAAAA;;;;AAMxB,KARKA,uBAAAA,GAA0BC,MAQJC,CAAAA,MAAAA,EAAAA,OAAAA,CAAAA;AAI3B,KAXKA,WAAAA,GAWgB;EAkCTG,iBAAW,CAAA,EA5CCL,uBA4CEE,GAAAA,SAAAA;EAcdI,OAAAA,EAzDCP,cAyDY;EAGbQ,EAAAA,CAAAA,EAAAA,MAAAA,GAAAA,SAAe;EAGfC,IAAAA,CAAAA,EAAAA,MAAAA,GAAa,SAAA;EAGbC,iBAAO,CAAA,EA/DKR,MA+DL,CAAA,MAAA,EAAA,OAAA,CAAA,GAAA,SAAA;CAAA;AAAGE,KA7DVA,YAAAA,GAAeD,WA6DLC,GAAAA;MAAeC,EAAAA,OAAAA;SAAYC,CAAAA,EAAAA,OAAAA,GAAAA,SAAAA;;AAA8BE,KAzDnEH,SAAAA,GAAYF,WAyDuDK,GAAAA;MAAkBC,EAAAA,IAAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAvBrFH,WAAAA,GAAcH;;;;;;;;;;;;;;KAcdI,aAAAA,GAAgBJ;;;KAGhBK,eAAAA,GAAkBL;;;KAGlBM,aAAAA,GAAgBN;;;KAGhBO,OAAAA,GAAUN,eAAeC,YAAYC,cAAcC,gBAAgBC,kBAAkBC"}
+{"version":3,"file":"types.messages.d.cts","names":["ImageDetail","MessageContentImageUrl","MessageContentText","MessageContentComplex","MessageContent","MessageAdditionalKwargs","Record","BaseMessage","HumanMessage","DefaultToolCall","InvalidToolCall","UsageMetadata","AIMessage","ToolCall","ToolMessage","SystemMessage","FunctionMessage","RemoveMessage","Message","InferSchemaInput","S","Args","InferToolInput","T","ToolCallFromTool","N","ToolCallsFromTools","First","Rest","ToolCallState","ToolCallWithResult"],"sources":["../src/types.messages.d.ts"],"sourcesContent":["type ImageDetail = \"auto\" | \"low\" | \"high\";\ntype MessageContentImageUrl = {\n    type: \"image_url\";\n    image_url: string | {\n        url: string;\n        detail?: ImageDetail | undefined;\n    };\n};\ntype MessageContentText = {\n    type: \"text\";\n    text: string;\n};\ntype MessageContentComplex = MessageContentText | MessageContentImageUrl;\ntype MessageContent = string | MessageContentComplex[];\n/**\n * Model-specific additional kwargs, which is passed back to the underlying LLM.\n */\ntype MessageAdditionalKwargs = Record<string, unknown>;\ntype BaseMessage = {\n    additional_kwargs?: MessageAdditionalKwargs | undefined;\n    content: MessageContent;\n    id?: string | undefined;\n    name?: string | undefined;\n    response_metadata?: Record<string, unknown> | undefined;\n};\nexport type HumanMessage = BaseMessage & {\n    type: \"human\";\n    example?: boolean | undefined;\n};\n/**\n * Default tool call type when no specific tool definitions are provided.\n */\nexport type DefaultToolCall = {\n    name: string;\n    args: {\n        [x: string]: any;\n    };\n    id?: string | undefined;\n    type?: \"tool_call\" | undefined;\n};\n/**\n * Invalid tool call type.\n */\nexport type InvalidToolCall = {\n    name?: string | undefined;\n    args?: string | undefined;\n    id?: string | undefined;\n    error?: string | undefined;\n    type?: \"invalid_tool_call\" | undefined;\n};\n/**\n * Usage metadata for AI messages.\n */\nexport type UsageMetadata = {\n    input_tokens: number;\n    output_tokens: number;\n    total_tokens: number;\n    input_token_details?: {\n        audio?: number | undefined;\n        cache_read?: number | undefined;\n        cache_creation?: number | undefined;\n    } | undefined;\n    output_token_details?: {\n        audio?: number | undefined;\n        reasoning?: number | undefined;\n    } | undefined;\n};\n/**\n * AI message type that can be parameterized with custom tool call types.\n *\n * @template ToolCall The type of tool calls, defaults to DefaultToolCall.\n *                    Provide a discriminated union for type-safe tool call handling.\n *\n * @example\n * ```ts\n * // Define typed tool calls as a discriminated union\n * type MyToolCalls =\n *   | { name: \"get_weather\"; args: { location: string }; id?: string }\n *   | { name: \"search\"; args: { query: string; limit?: number }; id?: string };\n *\n * // Use with AIMessage\n * const message: AIMessage<MyToolCalls> = ...;\n *\n * // Now tool.name === \"get_weather\" narrows tool.args type\n * if (message.tool_calls) {\n *   for (const tool of message.tool_calls) {\n *     if (tool.name === \"get_weather\") {\n *       // tool.args is now { location: string }\n *       console.log(tool.args.location);\n *     }\n *   }\n * }\n * ```\n */\nexport type AIMessage<ToolCall = DefaultToolCall> = BaseMessage & {\n    type: \"ai\";\n    example?: boolean | undefined;\n    tool_calls?: ToolCall[] | undefined;\n    invalid_tool_calls?: InvalidToolCall[] | undefined;\n    usage_metadata?: UsageMetadata | undefined;\n};\nexport type ToolMessage = BaseMessage & {\n    type: \"tool\";\n    status?: \"error\" | \"success\" | undefined;\n    tool_call_id: string;\n    /**\n     * Artifact of the Tool execution which is not meant to be sent to the model.\n     *\n     * Should only be specified if it is different from the message content, e.g. if only\n     * a subset of the full tool output is being passed as message content but the full\n     * output is needed in other parts of the code.\n     */\n    artifact?: any;\n};\nexport type SystemMessage = BaseMessage & {\n    type: \"system\";\n};\nexport type FunctionMessage = BaseMessage & {\n    type: \"function\";\n};\nexport type RemoveMessage = BaseMessage & {\n    type: \"remove\";\n};\n/**\n * Union of all message types.\n *\n * @template ToolCall The type of tool calls for AIMessage, defaults to DefaultToolCall.\n */\nexport type Message<ToolCall = DefaultToolCall> = HumanMessage | AIMessage<ToolCall> | ToolMessage | SystemMessage | FunctionMessage | RemoveMessage;\n/**\n * Helper type to infer schema input type, supporting both Zod v3 and v4.\n * - Zod v4 uses `_zod.input` property\n * - Zod v3 uses `_input` property\n *\n * Note: Zod v4 is checked first as it's the more specific structure.\n */\ntype InferSchemaInput<S> = S extends {\n    _zod: {\n        input: infer Args;\n    };\n} ? Args : S extends {\n    _input: infer Args;\n} ? Args : never;\n/**\n * Helper type to extract the input type from a DynamicStructuredTool's _call method.\n * This is more reliable than trying to infer from the schema directly because\n * DynamicStructuredTool has the input type baked into its _call signature.\n */\ntype InferToolInput<T> = T extends {\n    _call: (arg: infer Args, ...rest: any[]) => any;\n} ? Args : T extends {\n    schema: infer S;\n} ? InferSchemaInput<S> : never;\n/**\n * Infer a tool call type from a single tool.\n * Works with tools created via `tool()` from `@langchain/core/tools`.\n *\n * For DynamicStructuredTool, this extracts the input type from the _call method,\n * which is the most reliable source as it's the pre-computed input type.\n *\n * @template T The tool type (e.g., DynamicStructuredTool)\n *\n * @example\n * ```ts\n * import { tool } from \"@langchain/core/tools\";\n * import { z } from \"zod\";\n *\n * const getWeather = tool(\n *   async ({ location }) => `Weather in ${location}`,\n *   { name: \"get_weather\", schema: z.object({ location: z.string() }) }\n * );\n *\n * // Infer: { name: \"get_weather\"; args: { location: string }; id?: string; type?: \"tool_call\" }\n * type WeatherToolCall = ToolCallFromTool<typeof getWeather>;\n * ```\n */\nexport type ToolCallFromTool<T> = T extends {\n    name: infer N;\n} ? InferToolInput<T> extends infer Args ? Args extends never ? never : Args extends Record<string, any> ? {\n    name: N;\n    args: Args;\n    id?: string;\n    type?: \"tool_call\";\n} : never : never : never;\n/**\n * Infer a union of tool call types from an array of tools.\n * Works with tools created via `tool()` from `@langchain/core/tools`.\n *\n * @template T A tuple/array of tools\n *\n * @example\n * ```ts\n * import { tool } from \"@langchain/core/tools\";\n * import { z } from \"zod\";\n *\n * const getWeather = tool(\n *   async ({ location }) => `Weather in ${location}`,\n *   { name: \"get_weather\", schema: z.object({ location: z.string() }) }\n * );\n *\n * const search = tool(\n *   async ({ query }) => `Results for ${query}`,\n *   { name: \"search\", schema: z.object({ query: z.string() }) }\n * );\n *\n * const tools = [getWeather, search] as const;\n *\n * // Infer union:\n * // | { name: \"get_weather\"; args: { location: string }; id?: string; type?: \"tool_call\" }\n * // | { name: \"search\"; args: { query: string }; id?: string; type?: \"tool_call\" }\n * type MyToolCalls = ToolCallsFromTools<typeof tools>;\n * ```\n */\nexport type ToolCallsFromTools<T extends readonly unknown[]> = T extends readonly [infer First, ...infer Rest] ? ToolCallFromTool<First> | ToolCallsFromTools<Rest> : never;\n/**\n * The lifecycle state of a tool call.\n *\n * - `pending`: Tool call received, awaiting result\n * - `completed`: Tool execution finished successfully\n * - `error`: Tool execution failed (result.status === \"error\")\n */\nexport type ToolCallState = \"pending\" | \"completed\" | \"error\";\n/**\n * Represents a tool call paired with its result.\n * Useful for rendering tool invocations and their outputs together.\n *\n * @template ToolCall The type of the tool call.\n */\nexport type ToolCallWithResult<ToolCall = DefaultToolCall> = {\n    /**\n     * Unique identifier for this tool call.\n     * Uses the tool call's id if available, otherwise generates one from aiMessage.id and index.\n     */\n    id: string;\n    /**\n     * The tool call from the AI message.\n     */\n    call: ToolCall;\n    /**\n     * The result message from tool execution.\n     * `undefined` if the tool is still being executed or no result was received.\n     */\n    result: ToolMessage | undefined;\n    /**\n     * The AI message that initiated this tool call.\n     */\n    aiMessage: AIMessage<ToolCall>;\n    /**\n     * Index of this tool call within the AI message's tool_calls array.\n     */\n    index: number;\n    /**\n     * The current lifecycle state of the tool call.\n     *\n     * - `pending`: No result yet\n     * - `completed`: Has result with success status\n     * - `error`: Has result with error status\n     */\n    state: ToolCallState;\n};\nexport {};\n"],"mappings":"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"}