@langchain/langgraph 0.0.12 → 0.0.14

package/dist/channels/ephemeral_value.d.ts

@@ -0,0 +1,14 @@
+import { BaseChannel } from "./index.js";
+/**
+ * Stores the value received in the step immediately preceding, clears after.
+ */
+export declare class EphemeralValue<Value> extends BaseChannel<Value, Value, Value> {
+    lc_graph_name: string;
+    guard: boolean;
+    value?: Value;
+    constructor(guard?: boolean);
+    fromCheckpoint(checkpoint?: Value): this;
+    update(values: Value[]): void;
+    get(): Value;
+    checkpoint(): Value;
+}

package/dist/channels/ephemeral_value.js

@@ -0,0 +1,60 @@
+import { EmptyChannelError, InvalidUpdateError } from "../errors.js";
+import { BaseChannel } from "./index.js";
+/**
+ * Stores the value received in the step immediately preceding, clears after.
+ */
+export class EphemeralValue extends BaseChannel {
+    constructor(guard = true) {
+        super();
+        Object.defineProperty(this, "lc_graph_name", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: "EphemeralValue"
+        });
+        Object.defineProperty(this, "guard", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "value", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.guard = guard;
+    }
+    fromCheckpoint(checkpoint) {
+        const empty = new EphemeralValue();
+        if (checkpoint) {
+            empty.value = checkpoint;
+        }
+        return empty;
+    }
+    update(values) {
+        if (values.length === 0) {
+            // If there are no updates for this specific channel at the end of the step, wipe it.
+            this.value = undefined;
+            return;
+        }
+        if (values.length !== 1 && this.guard) {
+            throw new InvalidUpdateError("EphemeralValue can only receive one value per step.");
+        }
+        // eslint-disable-next-line prefer-destructuring
+        this.value = values[values.length - 1];
+    }
+    get() {
+        if (this.value === undefined) {
+            throw new EmptyChannelError();
+        }
+        return this.value;
+    }
+    checkpoint() {
+        if (this.value === undefined) {
+            throw new EmptyChannelError();
+        }
+        return this.value;
+    }
+}

package/dist/channels/index.cjs

@@ -1,9 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.empty = exports.createCheckpoint = exports.InvalidUpdateError = exports.EmptyChannelError = exports.BaseChannel = void 0;
+exports.empty = exports.createCheckpoint = exports.BaseChannel = void 0;
 var base_js_1 = require("./base.cjs");
 Object.defineProperty(exports, "BaseChannel", { enumerable: true, get: function () { return base_js_1.BaseChannel; } });
-Object.defineProperty(exports, "EmptyChannelError", { enumerable: true, get: function () { return base_js_1.EmptyChannelError; } });
-Object.defineProperty(exports, "InvalidUpdateError", { enumerable: true, get: function () { return base_js_1.InvalidUpdateError; } });
 Object.defineProperty(exports, "createCheckpoint", { enumerable: true, get: function () { return base_js_1.createCheckpoint; } });
 Object.defineProperty(exports, "empty", { enumerable: true, get: function () { return base_js_1.emptyChannels; } });

package/dist/channels/index.d.ts

@@ -1 +1 @@
-export { BaseChannel, EmptyChannelError, InvalidUpdateError, createCheckpoint, emptyChannels as empty, } from "./base.js";
+export { BaseChannel, createCheckpoint, emptyChannels as empty, } from "./base.js";

package/dist/channels/index.js

@@ -1 +1 @@
-export { BaseChannel, EmptyChannelError, InvalidUpdateError, createCheckpoint, emptyChannels as empty, } from "./base.js";
+export { BaseChannel, createCheckpoint, emptyChannels as empty, } from "./base.js";

package/dist/channels/last_value.cjs

@@ -1,9 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.LastValue = void 0;
+const errors_js_1 = require("../errors.cjs");
 const index_js_1 = require("./index.cjs");
 /**
  * Stores the last value received, can receive at most one value per step.
+ *
+ * Since `update` is only called once per step and value can only be of length 1,
+ * LastValue always stores the last value of a single node. If multiple nodes attempt to
+ * write to this channel in a single step, an error will be thrown.
  */
 class LastValue extends index_js_1.BaseChannel {
     constructor() {
@@ -21,7 +26,7 @@ class LastValue extends index_js_1.BaseChannel {
             value: void 0
         });
     }
-    empty(checkpoint) {
+    fromCheckpoint(checkpoint) {
         const empty = new LastValue();
         if (checkpoint) {
             empty.value = checkpoint;
@@ -33,19 +38,20 @@ class LastValue extends index_js_1.BaseChannel {
             return;
         }
         if (values.length !== 1) {
-            throw new index_js_1.InvalidUpdateError();
+            throw new errors_js_1.InvalidUpdateError();
         }
-        [this.value] = values;
+        // eslint-disable-next-line prefer-destructuring
+        this.value = values[values.length - 1];
     }
     get() {
         if (this.value === undefined) {
-            throw new index_js_1.EmptyChannelError();
+            throw new errors_js_1.EmptyChannelError();
         }
         return this.value;
     }
     checkpoint() {
         if (this.value === undefined) {
-            throw new index_js_1.EmptyChannelError();
+            throw new errors_js_1.EmptyChannelError();
         }
         return this.value;
     }

package/dist/channels/last_value.d.ts

@@ -1,11 +1,15 @@
 import { BaseChannel } from "./index.js";
 /**
  * Stores the last value received, can receive at most one value per step.
+ *
+ * Since `update` is only called once per step and value can only be of length 1,
+ * LastValue always stores the last value of a single node. If multiple nodes attempt to
+ * write to this channel in a single step, an error will be thrown.
  */
 export declare class LastValue<Value> extends BaseChannel<Value, Value, Value> {
     lc_graph_name: string;
     value?: Value;
-    empty(checkpoint?: Value): LastValue<Value>;
+    fromCheckpoint(checkpoint?: Value): this;
     update(values: Value[]): void;
     get(): Value;
     checkpoint(): Value;

package/dist/channels/last_value.js

@@ -1,6 +1,11 @@
-import { BaseChannel, EmptyChannelError, InvalidUpdateError } from "./index.js";
+import { EmptyChannelError, InvalidUpdateError } from "../errors.js";
+import { BaseChannel } from "./index.js";
 /**
  * Stores the last value received, can receive at most one value per step.
+ *
+ * Since `update` is only called once per step and value can only be of length 1,
+ * LastValue always stores the last value of a single node. If multiple nodes attempt to
+ * write to this channel in a single step, an error will be thrown.
  */
 export class LastValue extends BaseChannel {
     constructor() {
@@ -18,7 +23,7 @@ export class LastValue extends BaseChannel {
             value: void 0
         });
     }
-    empty(checkpoint) {
+    fromCheckpoint(checkpoint) {
         const empty = new LastValue();
         if (checkpoint) {
             empty.value = checkpoint;
@@ -32,7 +37,8 @@ export class LastValue extends BaseChannel {
         if (values.length !== 1) {
             throw new InvalidUpdateError();
         }
-        [this.value] = values;
+        // eslint-disable-next-line prefer-destructuring
+        this.value = values[values.length - 1];
     }
     get() {
         if (this.value === undefined) {

package/dist/channels/named_barrier_value.cjs

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NamedBarrierValue = exports.areSetsEqual = void 0;
+const errors_js_1 = require("../errors.cjs");
+const index_js_1 = require("./index.cjs");
+const areSetsEqual = (a, b) => a.size === b.size && [...a].every((value) => b.has(value));
+exports.areSetsEqual = areSetsEqual;
+/**
+ * A channel that waits until all named values are received before making the value available.
+ *
+ * This ensures that if node N and node M both write to channel C, the value of C will not be updated
+ * until N and M have completed updating.
+ */
+class NamedBarrierValue extends index_js_1.BaseChannel {
+    constructor(names) {
+        super();
+        Object.defineProperty(this, "lc_graph_name", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: "NamedBarrierValue"
+        });
+        Object.defineProperty(this, "names", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        }); // Names of nodes that we want to wait for.
+        Object.defineProperty(this, "seen", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.names = names;
+        this.seen = new Set();
+    }
+    fromCheckpoint(checkpoint) {
+        const empty = new NamedBarrierValue(this.names);
+        if (checkpoint) {
+            empty.seen = new Set(checkpoint);
+        }
+        return empty;
+    }
+    update(values) {
+        // We have seen all nodes, so we can reset the seen set in preparation for the next round of updates.
+        if ((0, exports.areSetsEqual)(this.names, this.seen)) {
+            this.seen = new Set();
+        }
+        for (const nodeName of values) {
+            if (this.names.has(nodeName)) {
+                this.seen.add(nodeName);
+            }
+            else {
+                throw new Error(`Value ${JSON.stringify(nodeName)} not in names ${JSON.stringify(this.names)}`);
+            }
+        }
+    }
+    // If we have not yet seen all the node names we want to wait for,
+    // throw an error to prevent continuing.
+    get() {
+        if (!(0, exports.areSetsEqual)(this.names, this.seen)) {
+            throw new errors_js_1.EmptyChannelError();
+        }
+        return undefined;
+    }
+    checkpoint() {
+        return [...this.seen];
+    }
+}
+exports.NamedBarrierValue = NamedBarrierValue;

package/dist/channels/named_barrier_value.d.ts

@@ -0,0 +1,18 @@
+import { BaseChannel } from "./index.js";
+export declare const areSetsEqual: <T>(a: Set<T>, b: Set<T>) => boolean;
+/**
+ * A channel that waits until all named values are received before making the value available.
+ *
+ * This ensures that if node N and node M both write to channel C, the value of C will not be updated
+ * until N and M have completed updating.
+ */
+export declare class NamedBarrierValue<Value> extends BaseChannel<void, Value, Value[]> {
+    lc_graph_name: string;
+    names: Set<Value>;
+    seen: Set<Value>;
+    constructor(names: Set<Value>);
+    fromCheckpoint(checkpoint?: Value[]): this;
+    update(values: Value[]): void;
+    get(): void;
+    checkpoint(): Value[];
+}

package/dist/channels/named_barrier_value.js

@@ -0,0 +1,66 @@
+import { EmptyChannelError } from "../errors.js";
+import { BaseChannel } from "./index.js";
+export const areSetsEqual = (a, b) => a.size === b.size && [...a].every((value) => b.has(value));
+/**
+ * A channel that waits until all named values are received before making the value available.
+ *
+ * This ensures that if node N and node M both write to channel C, the value of C will not be updated
+ * until N and M have completed updating.
+ */
+export class NamedBarrierValue extends BaseChannel {
+    constructor(names) {
+        super();
+        Object.defineProperty(this, "lc_graph_name", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: "NamedBarrierValue"
+        });
+        Object.defineProperty(this, "names", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        }); // Names of nodes that we want to wait for.
+        Object.defineProperty(this, "seen", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.names = names;
+        this.seen = new Set();
+    }
+    fromCheckpoint(checkpoint) {
+        const empty = new NamedBarrierValue(this.names);
+        if (checkpoint) {
+            empty.seen = new Set(checkpoint);
+        }
+        return empty;
+    }
+    update(values) {
+        // We have seen all nodes, so we can reset the seen set in preparation for the next round of updates.
+        if (areSetsEqual(this.names, this.seen)) {
+            this.seen = new Set();
+        }
+        for (const nodeName of values) {
+            if (this.names.has(nodeName)) {
+                this.seen.add(nodeName);
+            }
+            else {
+                throw new Error(`Value ${JSON.stringify(nodeName)} not in names ${JSON.stringify(this.names)}`);
+            }
+        }
+    }
+    // If we have not yet seen all the node names we want to wait for,
+    // throw an error to prevent continuing.
+    get() {
+        if (!areSetsEqual(this.names, this.seen)) {
+            throw new EmptyChannelError();
+        }
+        return undefined;
+    }
+    checkpoint() {
+        return [...this.seen];
+    }
+}

package/dist/channels/topic.cjs

@@ -51,13 +51,15 @@ class Topic extends base_js_1.BaseChannel {
         this.seen = new Set();
         this.values = [];
     }
-    empty(checkpoint) {
+    fromCheckpoint(checkpoint) {
         const empty = new Topic({
             unique: this.unique,
             accumulate: this.accumulate,
         });
         if (checkpoint) {
-            [empty.seen, empty.values] = checkpoint;
+            empty.seen = new Set(checkpoint[0]);
+            // eslint-disable-next-line prefer-destructuring
+            empty.values = checkpoint[1];
         }
         return empty;
     }
@@ -84,7 +86,7 @@ class Topic extends base_js_1.BaseChannel {
         return this.values;
     }
     checkpoint() {
-        return [this.seen, this.values];
+        return [[...this.seen], this.values];
     }
 }
 exports.Topic = Topic;

package/dist/channels/topic.d.ts

@@ -1,6 +1,6 @@
 import { BaseChannel } from "./base.js";
 export declare class Topic<Value> extends BaseChannel<Array<Value>, Value | Value[], [
-    Set<Value>,
+    Value[],
     Value[]
 ]> {
     lc_graph_name: string;
@@ -12,8 +12,8 @@ export declare class Topic<Value> extends BaseChannel<Array<Value>, Value | Valu
         unique?: boolean;
         accumulate?: boolean;
     });
-    empty(checkpoint?: [Set<Value>, Value[]]): Topic<Value>;
+    fromCheckpoint(checkpoint?: [Value[], Value[]]): this;
     update(values: Array<Value | Value[]>): void;
     get(): Array<Value>;
-    checkpoint(): [Set<Value>, Array<Value>];
+    checkpoint(): [Value[], Value[]];
 }

package/dist/channels/topic.js

@@ -48,13 +48,15 @@ export class Topic extends BaseChannel {
         this.seen = new Set();
         this.values = [];
     }
-    empty(checkpoint) {
+    fromCheckpoint(checkpoint) {
         const empty = new Topic({
             unique: this.unique,
             accumulate: this.accumulate,
         });
         if (checkpoint) {
-            [empty.seen, empty.values] = checkpoint;
+            empty.seen = new Set(checkpoint[0]);
+            // eslint-disable-next-line prefer-destructuring
+            empty.values = checkpoint[1];
         }
         return empty;
     }
@@ -81,6 +83,6 @@ export class Topic extends BaseChannel {
         return this.values;
     }
     checkpoint() {
-        return [this.seen, this.values];
+        return [[...this.seen], this.values];
     }
 }

package/dist/checkpoint/base.cjs

@@ -1,37 +1,55 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.BaseCheckpointSaver = exports.copyCheckpoint = exports.emptyCheckpoint = void 0;
+exports.BaseCheckpointSaver = exports.copyCheckpoint = exports.emptyCheckpoint = exports.deepCopy = void 0;
+const id_js_1 = require("./id.cjs");
+function deepCopy(obj) {
+    if (typeof obj !== "object" || obj === null) {
+        return obj;
+    }
+    const newObj = Array.isArray(obj) ? [] : {};
+    for (const key in obj) {
+        if (Object.prototype.hasOwnProperty.call(obj, key)) {
+            newObj[key] = deepCopy(obj[key]);
+        }
+    }
+    return newObj;
+}
+exports.deepCopy = deepCopy;
 function emptyCheckpoint() {
     return {
         v: 1,
+        id: (0, id_js_1.uuid6)(-2),
         ts: new Date().toISOString(),
-        channelValues: {},
-        channelVersions: {},
-        versionsSeen: {},
+        channel_values: {},
+        channel_versions: {},
+        versions_seen: {},
     };
 }
 exports.emptyCheckpoint = emptyCheckpoint;
 function copyCheckpoint(checkpoint) {
     return {
         v: checkpoint.v,
+        id: checkpoint.id,
         ts: checkpoint.ts,
-        channelValues: { ...checkpoint.channelValues },
-        channelVersions: { ...checkpoint.channelVersions },
-        versionsSeen: { ...checkpoint.versionsSeen },
+        channel_values: { ...checkpoint.channel_values },
+        channel_versions: { ...checkpoint.channel_versions },
+        versions_seen: deepCopy(checkpoint.versions_seen),
     };
 }
 exports.copyCheckpoint = copyCheckpoint;
 class BaseCheckpointSaver {
-    constructor() {
-        Object.defineProperty(this, "at", {
+    constructor(serde) {
+        Object.defineProperty(this, "serde", {
             enumerable: true,
             configurable: true,
             writable: true,
-            value: "end_of_run" /* CheckpointAt.END_OF_RUN */
+            value: JSON
         });
+        this.serde = serde || this.serde;
     }
-    get configSpecs() {
-        return [];
+    async get(config) {
+        const value = await this.getTuple(config);
+        return value ? value.checkpoint : undefined;
     }
 }
 exports.BaseCheckpointSaver = BaseCheckpointSaver;

package/dist/checkpoint/base.d.ts

@@ -1,22 +1,29 @@
 import { RunnableConfig } from "@langchain/core/runnables";
-/** A field that can be configured by the user. It is a specification of a field. */
-export interface ConfigurableFieldSpec {
-    id: string;
-    annotation: any;
-    name: string | null;
-    description: string | null;
-    default: any;
+import { SerializerProtocol } from "../serde/base.js";
+export interface CheckpointMetadata {
+    source: "input" | "loop" | "update";
     /**
-     * @default false
-     */
-    isShared?: boolean;
-    dependencies: Array<string> | null;
+     * The source of the checkpoint.
+     * - "input": The checkpoint was created from an input to invoke/stream/batch.
+     * - "loop": The checkpoint was created from inside the pregel loop.
+     * - "update": The checkpoint was created from a manual state update. */
+    step: number;
+    /**
+     * The step number of the checkpoint.
+     * -1 for the first "input" checkpoint.
+     * 0 for the first "loop" checkpoint.
+     * ... for the nth checkpoint afterwards. */
+    writes?: Record<string, unknown>;
 }
 export interface Checkpoint {
     /**
      * Version number
      */
     v: number;
+    /**
+     * Checkpoint ID {uuid6}
+     */
+    id: string;
     /**
      * Timestamp {new Date().toISOString()}
      */
@@ -24,25 +31,35 @@ export interface Checkpoint {
     /**
      * @default {}
      */
-    channelValues: Record<string, any>;
+    channel_values: Record<string, unknown>;
     /**
      * @default {}
      */
-    channelVersions: Record<string, number>;
+    channel_versions: Record<string, number>;
     /**
      * @default {}
      */
-    versionsSeen: Record<string, Record<string, number>>;
+    versions_seen: Record<string, Record<string, number>>;
+}
+export interface ReadonlyCheckpoint extends Readonly<Checkpoint> {
+    readonly channel_values: Readonly<Record<string, unknown>>;
+    readonly channel_versions: Readonly<Record<string, number>>;
+    readonly versions_seen: Readonly<Record<string, Readonly<Record<string, number>>>>;
 }
+export declare function deepCopy<T>(obj: T): T;
 export declare function emptyCheckpoint(): Checkpoint;
-export declare function copyCheckpoint(checkpoint: Checkpoint): Checkpoint;
-export declare const enum CheckpointAt {
-    END_OF_STEP = "end_of_step",
-    END_OF_RUN = "end_of_run"
+export declare function copyCheckpoint(checkpoint: ReadonlyCheckpoint): Checkpoint;
+export interface CheckpointTuple {
+    config: RunnableConfig;
+    checkpoint: Checkpoint;
+    metadata?: CheckpointMetadata;
+    parentConfig?: RunnableConfig;
 }
 export declare abstract class BaseCheckpointSaver {
-    at: CheckpointAt;
-    get configSpecs(): Array<ConfigurableFieldSpec>;
-    abstract get(config: RunnableConfig): Checkpoint | undefined;
-    abstract put(config: RunnableConfig, checkpoint: Checkpoint): void;
+    serde: SerializerProtocol<unknown>;
+    constructor(serde?: SerializerProtocol<unknown>);
+    get(config: RunnableConfig): Promise<Checkpoint | undefined>;
+    abstract getTuple(config: RunnableConfig): Promise<CheckpointTuple | undefined>;
+    abstract list(config: RunnableConfig, limit?: number, before?: RunnableConfig): AsyncGenerator<CheckpointTuple>;
+    abstract put(config: RunnableConfig, checkpoint: Checkpoint, metadata: CheckpointMetadata): Promise<RunnableConfig>;
 }

package/dist/checkpoint/base.js

@@ -1,31 +1,48 @@
+import { uuid6 } from "./id.js";
+export function deepCopy(obj) {
+    if (typeof obj !== "object" || obj === null) {
+        return obj;
+    }
+    const newObj = Array.isArray(obj) ? [] : {};
+    for (const key in obj) {
+        if (Object.prototype.hasOwnProperty.call(obj, key)) {
+            newObj[key] = deepCopy(obj[key]);
+        }
+    }
+    return newObj;
+}
 export function emptyCheckpoint() {
     return {
         v: 1,
+        id: uuid6(-2),
         ts: new Date().toISOString(),
-        channelValues: {},
-        channelVersions: {},
-        versionsSeen: {},
+        channel_values: {},
+        channel_versions: {},
+        versions_seen: {},
     };
 }
 export function copyCheckpoint(checkpoint) {
     return {
         v: checkpoint.v,
+        id: checkpoint.id,
         ts: checkpoint.ts,
-        channelValues: { ...checkpoint.channelValues },
-        channelVersions: { ...checkpoint.channelVersions },
-        versionsSeen: { ...checkpoint.versionsSeen },
+        channel_values: { ...checkpoint.channel_values },
+        channel_versions: { ...checkpoint.channel_versions },
+        versions_seen: deepCopy(checkpoint.versions_seen),
     };
 }
 export class BaseCheckpointSaver {
-    constructor() {
-        Object.defineProperty(this, "at", {
+    constructor(serde) {
+        Object.defineProperty(this, "serde", {
             enumerable: true,
             configurable: true,
             writable: true,
-            value: "end_of_run" /* CheckpointAt.END_OF_RUN */
+            value: JSON
         });
+        this.serde = serde || this.serde;
     }
-    get configSpecs() {
-        return [];
+    async get(config) {
+        const value = await this.getTuple(config);
+        return value ? value.checkpoint : undefined;
     }
 }