@langchain/langgraph 1.0.12 → 1.0.13

package/dist/channels/any_value.cjs

@@ -0,0 +1,46 @@
+const require_errors = require('../errors.cjs');
+const require_base = require('./base.cjs');
+
+//#region src/channels/any_value.ts
+/**
+* Stores the last value received, assumes that if multiple values are received, they are all equal.
+*
+* Note: Unlike 'LastValue' if multiple nodes write to this channel in a single step, the values
+* will be continuously overwritten.
+*/
+var AnyValue = class AnyValue extends require_base.BaseChannel {
+	lc_graph_name = "AnyValue";
+	value = [];
+	constructor() {
+		super();
+	}
+	fromCheckpoint(checkpoint) {
+		const empty = new AnyValue();
+		if (typeof checkpoint !== "undefined") empty.value = [checkpoint];
+		return empty;
+	}
+	update(values) {
+		if (values.length === 0) {
+			const updated = this.value.length > 0;
+			this.value = [];
+			return updated;
+		}
+		this.value = [values[values.length - 1]];
+		return false;
+	}
+	get() {
+		if (this.value.length === 0) throw new require_errors.EmptyChannelError();
+		return this.value[0];
+	}
+	checkpoint() {
+		if (this.value.length === 0) throw new require_errors.EmptyChannelError();
+		return this.value[0];
+	}
+	isAvailable() {
+		return this.value.length !== 0;
+	}
+};
+
+//#endregion
+exports.AnyValue = AnyValue;
+//# sourceMappingURL=any_value.cjs.map

package/dist/channels/any_value.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"any_value.cjs","names":["BaseChannel","EmptyChannelError"],"sources":["../../src/channels/any_value.ts"],"sourcesContent":["import { EmptyChannelError } from \"../errors.js\";\nimport { BaseChannel } from \"./base.js\";\n\n/**\n * Stores the last value received, assumes that if multiple values are received, they are all equal.\n *\n * Note: Unlike 'LastValue' if multiple nodes write to this channel in a single step, the values\n * will be continuously overwritten.\n */\nexport class AnyValue<Value> extends BaseChannel<Value, Value, Value> {\n  lc_graph_name = \"AnyValue\";\n\n  // value is an array so we don't misinterpret an update to undefined as no write\n  value: [Value] | [] = [];\n\n  constructor() {\n    super();\n  }\n\n  fromCheckpoint(checkpoint?: Value) {\n    const empty = new AnyValue<Value>();\n    if (typeof checkpoint !== \"undefined\") {\n      empty.value = [checkpoint];\n    }\n    return empty as this;\n  }\n\n  update(values: Value[]): boolean {\n    if (values.length === 0) {\n      const updated = this.value.length > 0;\n      this.value = [];\n      return updated;\n    }\n\n    // eslint-disable-next-line prefer-destructuring\n    this.value = [values[values.length - 1]];\n    return false;\n  }\n\n  get(): Value {\n    if (this.value.length === 0) {\n      throw new EmptyChannelError();\n    }\n    return this.value[0];\n  }\n\n  checkpoint(): Value {\n    if (this.value.length === 0) {\n      throw new EmptyChannelError();\n    }\n    return this.value[0];\n  }\n\n  isAvailable(): boolean {\n    return this.value.length !== 0;\n  }\n}\n"],"mappings":";;;;;;;;;;AASA,IAAa,WAAb,MAAa,iBAAwBA,yBAAiC;CACpE,gBAAgB;CAGhB,QAAsB,EAAE;CAExB,cAAc;AACZ,SAAO;;CAGT,eAAe,YAAoB;EACjC,MAAM,QAAQ,IAAI,UAAiB;AACnC,MAAI,OAAO,eAAe,YACxB,OAAM,QAAQ,CAAC,WAAW;AAE5B,SAAO;;CAGT,OAAO,QAA0B;AAC/B,MAAI,OAAO,WAAW,GAAG;GACvB,MAAM,UAAU,KAAK,MAAM,SAAS;AACpC,QAAK,QAAQ,EAAE;AACf,UAAO;;AAIT,OAAK,QAAQ,CAAC,OAAO,OAAO,SAAS,GAAG;AACxC,SAAO;;CAGT,MAAa;AACX,MAAI,KAAK,MAAM,WAAW,EACxB,OAAM,IAAIC,kCAAmB;AAE/B,SAAO,KAAK,MAAM;;CAGpB,aAAoB;AAClB,MAAI,KAAK,MAAM,WAAW,EACxB,OAAM,IAAIA,kCAAmB;AAE/B,SAAO,KAAK,MAAM;;CAGpB,cAAuB;AACrB,SAAO,KAAK,MAAM,WAAW"}

package/dist/channels/any_value.d.cts

@@ -0,0 +1,23 @@
+import { BaseChannel } from "./base.cjs";
+
+//#region src/channels/any_value.d.ts
+
+/**
+ * Stores the last value received, assumes that if multiple values are received, they are all equal.
+ *
+ * Note: Unlike 'LastValue' if multiple nodes write to this channel in a single step, the values
+ * will be continuously overwritten.
+ */
+declare class AnyValue<Value> extends BaseChannel<Value, Value, Value> {
+  lc_graph_name: string;
+  value: [Value] | [];
+  constructor();
+  fromCheckpoint(checkpoint?: Value): this;
+  update(values: Value[]): boolean;
+  get(): Value;
+  checkpoint(): Value;
+  isAvailable(): boolean;
+}
+//#endregion
+export { AnyValue };
+//# sourceMappingURL=any_value.d.cts.map

package/dist/channels/any_value.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"any_value.d.cts","names":["BaseChannel","AnyValue","Value"],"sources":["../../src/channels/any_value.d.ts"],"sourcesContent":["import { BaseChannel } from \"./base.js\";\n/**\n * Stores the last value received, assumes that if multiple values are received, they are all equal.\n *\n * Note: Unlike 'LastValue' if multiple nodes write to this channel in a single step, the values\n * will be continuously overwritten.\n */\nexport declare class AnyValue<Value> extends BaseChannel<Value, Value, Value> {\n    lc_graph_name: string;\n    value: [Value] | [];\n    constructor();\n    fromCheckpoint(checkpoint?: Value): this;\n    update(values: Value[]): boolean;\n    get(): Value;\n    checkpoint(): Value;\n    isAvailable(): boolean;\n}\n"],"mappings":";;;;;;AAOA;;;;AAAuEE,cAAlDD,QAAkDC,CAAAA,KAAAA,CAAAA,SAA1BF,WAA0BE,CAAdA,KAAcA,EAAPA,KAAOA,EAAAA,KAAAA,CAAAA,CAAAA;eAE3DA,EAAAA,MAAAA;OAEoBA,EAAAA,CAFpBA,KAEoBA,CAAAA,GAAAA,EAAAA;aACbA,CAAAA;gBACRA,CAAAA,UAAAA,CAAAA,EAFqBA,KAErBA,CAAAA,EAAAA,IAAAA;QACOA,CAAAA,MAAAA,EAFCA,KAEDA,EAAAA,CAAAA,EAAAA,OAAAA;KAP2BF,CAAAA,CAAAA,EAMlCE,KANkCF;EAAW,UAAA,CAAA,CAAA,EAOtCE,KAPsC"}

package/dist/channels/any_value.d.ts

@@ -0,0 +1,23 @@
+import { BaseChannel } from "./base.js";
+
+//#region src/channels/any_value.d.ts
+
+/**
+ * Stores the last value received, assumes that if multiple values are received, they are all equal.
+ *
+ * Note: Unlike 'LastValue' if multiple nodes write to this channel in a single step, the values
+ * will be continuously overwritten.
+ */
+declare class AnyValue<Value> extends BaseChannel<Value, Value, Value> {
+  lc_graph_name: string;
+  value: [Value] | [];
+  constructor();
+  fromCheckpoint(checkpoint?: Value): this;
+  update(values: Value[]): boolean;
+  get(): Value;
+  checkpoint(): Value;
+  isAvailable(): boolean;
+}
+//#endregion
+export { AnyValue };
+//# sourceMappingURL=any_value.d.ts.map

package/dist/channels/any_value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"any_value.d.ts","names":["BaseChannel","AnyValue","Value"],"sources":["../../src/channels/any_value.d.ts"],"sourcesContent":["import { BaseChannel } from \"./base.js\";\n/**\n * Stores the last value received, assumes that if multiple values are received, they are all equal.\n *\n * Note: Unlike 'LastValue' if multiple nodes write to this channel in a single step, the values\n * will be continuously overwritten.\n */\nexport declare class AnyValue<Value> extends BaseChannel<Value, Value, Value> {\n    lc_graph_name: string;\n    value: [Value] | [];\n    constructor();\n    fromCheckpoint(checkpoint?: Value): this;\n    update(values: Value[]): boolean;\n    get(): Value;\n    checkpoint(): Value;\n    isAvailable(): boolean;\n}\n"],"mappings":";;;;;;AAOA;;;;AAAuEE,cAAlDD,QAAkDC,CAAAA,KAAAA,CAAAA,SAA1BF,WAA0BE,CAAdA,KAAcA,EAAPA,KAAOA,EAAAA,KAAAA,CAAAA,CAAAA;eAE3DA,EAAAA,MAAAA;OAEoBA,EAAAA,CAFpBA,KAEoBA,CAAAA,GAAAA,EAAAA;aACbA,CAAAA;gBACRA,CAAAA,UAAAA,CAAAA,EAFqBA,KAErBA,CAAAA,EAAAA,IAAAA;QACOA,CAAAA,MAAAA,EAFCA,KAEDA,EAAAA,CAAAA,EAAAA,OAAAA;KAP2BF,CAAAA,CAAAA,EAMlCE,KANkCF;EAAW,UAAA,CAAA,CAAA,EAOtCE,KAPsC"}

package/dist/channels/any_value.js

@@ -0,0 +1,46 @@
+import { EmptyChannelError } from "../errors.js";
+import { BaseChannel } from "./base.js";
+
+//#region src/channels/any_value.ts
+/**
+* Stores the last value received, assumes that if multiple values are received, they are all equal.
+*
+* Note: Unlike 'LastValue' if multiple nodes write to this channel in a single step, the values
+* will be continuously overwritten.
+*/
+var AnyValue = class AnyValue extends BaseChannel {
+	lc_graph_name = "AnyValue";
+	value = [];
+	constructor() {
+		super();
+	}
+	fromCheckpoint(checkpoint) {
+		const empty = new AnyValue();
+		if (typeof checkpoint !== "undefined") empty.value = [checkpoint];
+		return empty;
+	}
+	update(values) {
+		if (values.length === 0) {
+			const updated = this.value.length > 0;
+			this.value = [];
+			return updated;
+		}
+		this.value = [values[values.length - 1]];
+		return false;
+	}
+	get() {
+		if (this.value.length === 0) throw new EmptyChannelError();
+		return this.value[0];
+	}
+	checkpoint() {
+		if (this.value.length === 0) throw new EmptyChannelError();
+		return this.value[0];
+	}
+	isAvailable() {
+		return this.value.length !== 0;
+	}
+};
+
+//#endregion
+export { AnyValue };
+//# sourceMappingURL=any_value.js.map

package/dist/channels/any_value.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"any_value.js","names":[],"sources":["../../src/channels/any_value.ts"],"sourcesContent":["import { EmptyChannelError } from \"../errors.js\";\nimport { BaseChannel } from \"./base.js\";\n\n/**\n * Stores the last value received, assumes that if multiple values are received, they are all equal.\n *\n * Note: Unlike 'LastValue' if multiple nodes write to this channel in a single step, the values\n * will be continuously overwritten.\n */\nexport class AnyValue<Value> extends BaseChannel<Value, Value, Value> {\n  lc_graph_name = \"AnyValue\";\n\n  // value is an array so we don't misinterpret an update to undefined as no write\n  value: [Value] | [] = [];\n\n  constructor() {\n    super();\n  }\n\n  fromCheckpoint(checkpoint?: Value) {\n    const empty = new AnyValue<Value>();\n    if (typeof checkpoint !== \"undefined\") {\n      empty.value = [checkpoint];\n    }\n    return empty as this;\n  }\n\n  update(values: Value[]): boolean {\n    if (values.length === 0) {\n      const updated = this.value.length > 0;\n      this.value = [];\n      return updated;\n    }\n\n    // eslint-disable-next-line prefer-destructuring\n    this.value = [values[values.length - 1]];\n    return false;\n  }\n\n  get(): Value {\n    if (this.value.length === 0) {\n      throw new EmptyChannelError();\n    }\n    return this.value[0];\n  }\n\n  checkpoint(): Value {\n    if (this.value.length === 0) {\n      throw new EmptyChannelError();\n    }\n    return this.value[0];\n  }\n\n  isAvailable(): boolean {\n    return this.value.length !== 0;\n  }\n}\n"],"mappings":";;;;;;;;;;AASA,IAAa,WAAb,MAAa,iBAAwB,YAAiC;CACpE,gBAAgB;CAGhB,QAAsB,EAAE;CAExB,cAAc;AACZ,SAAO;;CAGT,eAAe,YAAoB;EACjC,MAAM,QAAQ,IAAI,UAAiB;AACnC,MAAI,OAAO,eAAe,YACxB,OAAM,QAAQ,CAAC,WAAW;AAE5B,SAAO;;CAGT,OAAO,QAA0B;AAC/B,MAAI,OAAO,WAAW,GAAG;GACvB,MAAM,UAAU,KAAK,MAAM,SAAS;AACpC,QAAK,QAAQ,EAAE;AACf,UAAO;;AAIT,OAAK,QAAQ,CAAC,OAAO,OAAO,SAAS,GAAG;AACxC,SAAO;;CAGT,MAAa;AACX,MAAI,KAAK,MAAM,WAAW,EACxB,OAAM,IAAI,mBAAmB;AAE/B,SAAO,KAAK,MAAM;;CAGpB,aAAoB;AAClB,MAAI,KAAK,MAAM,WAAW,EACxB,OAAM,IAAI,mBAAmB;AAE/B,SAAO,KAAK,MAAM;;CAGpB,cAAuB;AACrB,SAAO,KAAK,MAAM,WAAW"}

package/dist/channels/base.cjs

@@ -0,0 +1,101 @@
+const require_errors = require('../errors.cjs');
+let _langchain_langgraph_checkpoint = require("@langchain/langgraph-checkpoint");
+
+//#region src/channels/base.ts
+function isBaseChannel(obj) {
+	return obj != null && obj.lg_is_channel === true;
+}
+/** @internal */
+var BaseChannel = class {
+	ValueType;
+	UpdateType;
+	/** @ignore */
+	lg_is_channel = true;
+	/**
+	* Mark the current value of the channel as consumed. By default, no-op.
+	* A channel can use this method to modify its state, preventing the value
+	* from being consumed again.
+	*
+	* Returns True if the channel was updated, False otherwise.
+	*/
+	consume() {
+		return false;
+	}
+	/**
+	* Notify the channel that the Pregel run is finishing. By default, no-op.
+	* A channel can use this method to modify its state, preventing finish.
+	*
+	* Returns True if the channel was updated, False otherwise.
+	*/
+	finish() {
+		return false;
+	}
+	/**
+	* Return True if the channel is available (not empty), False otherwise.
+	* Subclasses should override this method to provide a more efficient
+	* implementation than calling get() and catching EmptyChannelError.
+	*/
+	isAvailable() {
+		try {
+			this.get();
+			return true;
+		} catch (error) {
+			if (error.name === require_errors.EmptyChannelError.unminifiable_name) return false;
+			throw error;
+		}
+	}
+};
+const IS_ONLY_BASE_CHANNEL = Symbol.for("LG_IS_ONLY_BASE_CHANNEL");
+function getOnlyChannels(channels) {
+	if (channels[IS_ONLY_BASE_CHANNEL] === true) return channels;
+	const newChannels = {};
+	for (const k in channels) {
+		if (!Object.prototype.hasOwnProperty.call(channels, k)) continue;
+		const value = channels[k];
+		if (isBaseChannel(value)) newChannels[k] = value;
+	}
+	Object.assign(newChannels, { [IS_ONLY_BASE_CHANNEL]: true });
+	return newChannels;
+}
+function emptyChannels(channels, checkpoint) {
+	const filteredChannels = getOnlyChannels(channels);
+	const newChannels = {};
+	for (const k in filteredChannels) {
+		if (!Object.prototype.hasOwnProperty.call(filteredChannels, k)) continue;
+		const channelValue = checkpoint.channel_values[k];
+		newChannels[k] = filteredChannels[k].fromCheckpoint(channelValue);
+	}
+	Object.assign(newChannels, { [IS_ONLY_BASE_CHANNEL]: true });
+	return newChannels;
+}
+function createCheckpoint(checkpoint, channels, step, options) {
+	let values;
+	if (channels === void 0) values = checkpoint.channel_values;
+	else {
+		values = {};
+		for (const k in channels) {
+			if (!Object.prototype.hasOwnProperty.call(channels, k)) continue;
+			try {
+				values[k] = channels[k].checkpoint();
+			} catch (error) {
+				if (error.name === require_errors.EmptyChannelError.unminifiable_name) {} else throw error;
+			}
+		}
+	}
+	return {
+		v: 4,
+		id: options?.id ?? (0, _langchain_langgraph_checkpoint.uuid6)(step),
+		ts: (/* @__PURE__ */ new Date()).toISOString(),
+		channel_values: values,
+		channel_versions: checkpoint.channel_versions,
+		versions_seen: checkpoint.versions_seen
+	};
+}
+
+//#endregion
+exports.BaseChannel = BaseChannel;
+exports.createCheckpoint = createCheckpoint;
+exports.emptyChannels = emptyChannels;
+exports.getOnlyChannels = getOnlyChannels;
+exports.isBaseChannel = isBaseChannel;
+//# sourceMappingURL=base.cjs.map

package/dist/channels/base.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.cjs","names":["EmptyChannelError"],"sources":["../../src/channels/base.ts"],"sourcesContent":["import {\n  ReadonlyCheckpoint,\n  uuid6,\n  Checkpoint,\n} from \"@langchain/langgraph-checkpoint\";\nimport { EmptyChannelError } from \"../errors.js\";\n\nexport function isBaseChannel(obj: unknown): obj is BaseChannel {\n  return obj != null && (obj as BaseChannel).lg_is_channel === true;\n}\n\n/** @internal */\nexport abstract class BaseChannel<\n  ValueType = unknown,\n  UpdateType = unknown,\n  CheckpointType = unknown\n> {\n  ValueType: ValueType;\n\n  UpdateType: UpdateType;\n\n  /**\n   * The name of the channel.\n   */\n  abstract lc_graph_name: string;\n\n  /** @ignore */\n  lg_is_channel = true;\n\n  /**\n   * Return a new identical channel, optionally initialized from a checkpoint.\n   * Can be thought of as a \"restoration\" from a checkpoint which is a \"snapshot\" of the channel's state.\n   *\n   * @param {CheckpointType | undefined} checkpoint\n   * @param {CheckpointType | undefined} initialValue\n   * @returns {this}\n   */\n  abstract fromCheckpoint(checkpoint?: CheckpointType): this;\n\n  /**\n   * Update the channel's value with the given sequence of updates.\n   * The order of the updates in the sequence is arbitrary.\n   * This method is called by Pregel for all channels at the end of each step.\n   * If there are no updates, it is called with an empty sequence.\n   *\n   * Raises InvalidUpdateError if the sequence of updates is invalid.\n   * Returns True if the channel was updated, False otherwise.\n   *\n   * @throws {InvalidUpdateError} if the sequence of updates is invalid.\n   * @param {Array<UpdateType>} values\n   * @returns {void}\n   */\n  abstract update(values: UpdateType[]): boolean;\n\n  /**\n   * Return the current value of the channel.\n   *\n   * @throws {EmptyChannelError} if the channel is empty (never updated yet).\n   * @returns {ValueType}\n   */\n  abstract get(): ValueType;\n\n  /**\n   * Return a string representation of the channel's current state.\n   *\n   * @throws {EmptyChannelError} if the channel is empty (never updated yet), or doesn't support checkpoints.\n   * @returns {CheckpointType | undefined}\n   */\n  abstract checkpoint(): CheckpointType | undefined;\n\n  /**\n   * Mark the current value of the channel as consumed. By default, no-op.\n   * A channel can use this method to modify its state, preventing the value\n   * from being consumed again.\n   *\n   * Returns True if the channel was updated, False otherwise.\n   */\n  consume(): boolean {\n    return false;\n  }\n\n  /**\n   * Notify the channel that the Pregel run is finishing. By default, no-op.\n   * A channel can use this method to modify its state, preventing finish.\n   *\n   * Returns True if the channel was updated, False otherwise.\n   */\n  finish(): boolean {\n    return false;\n  }\n\n  /**\n   * Return True if the channel is available (not empty), False otherwise.\n   * Subclasses should override this method to provide a more efficient\n   * implementation than calling get() and catching EmptyChannelError.\n   */\n  isAvailable(): boolean {\n    try {\n      this.get();\n      return true;\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    } catch (error: any) {\n      if (error.name === EmptyChannelError.unminifiable_name) {\n        return false;\n      }\n      throw error;\n    }\n  }\n}\n\nconst IS_ONLY_BASE_CHANNEL = Symbol.for(\"LG_IS_ONLY_BASE_CHANNEL\");\nexport function getOnlyChannels(\n  channels: Record<string, BaseChannel>\n): Record<string, BaseChannel> {\n  // @ts-expect-error - we know it's a record of base channels\n  if (channels[IS_ONLY_BASE_CHANNEL] === true) return channels;\n\n  const newChannels = {} as Record<string, BaseChannel>;\n  for (const k in channels) {\n    if (!Object.prototype.hasOwnProperty.call(channels, k)) continue;\n    const value = channels[k];\n    if (isBaseChannel(value)) newChannels[k] = value;\n  }\n\n  Object.assign(newChannels, { [IS_ONLY_BASE_CHANNEL]: true });\n  return newChannels;\n}\n\nexport function emptyChannels<Cc extends Record<string, BaseChannel>>(\n  channels: Cc,\n  checkpoint: ReadonlyCheckpoint\n): Cc {\n  const filteredChannels = getOnlyChannels(channels) as Cc;\n\n  const newChannels = {} as Cc;\n  for (const k in filteredChannels) {\n    if (!Object.prototype.hasOwnProperty.call(filteredChannels, k)) continue;\n    const channelValue = checkpoint.channel_values[k];\n    newChannels[k] = filteredChannels[k].fromCheckpoint(channelValue);\n  }\n  Object.assign(newChannels, { [IS_ONLY_BASE_CHANNEL]: true });\n  return newChannels;\n}\n\nexport function createCheckpoint<ValueType>(\n  checkpoint: ReadonlyCheckpoint,\n  channels: Record<string, BaseChannel<ValueType>> | undefined,\n  step: number,\n  options?: { id?: string }\n): Checkpoint {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  let values: Record<string, any>;\n  if (channels === undefined) {\n    values = checkpoint.channel_values;\n  } else {\n    values = {};\n    for (const k in channels) {\n      if (!Object.prototype.hasOwnProperty.call(channels, k)) continue;\n      try {\n        values[k] = channels[k].checkpoint();\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      } catch (error: any) {\n        if (error.name === EmptyChannelError.unminifiable_name) {\n          // no-op\n        } else {\n          throw error; // Rethrow unexpected errors\n        }\n      }\n    }\n  }\n\n  return {\n    v: 4,\n    id: options?.id ?? uuid6(step),\n    ts: new Date().toISOString(),\n    channel_values: values,\n    channel_versions: checkpoint.channel_versions,\n    versions_seen: checkpoint.versions_seen,\n  };\n}\n"],"mappings":";;;;AAOA,SAAgB,cAAc,KAAkC;AAC9D,QAAO,OAAO,QAAS,IAAoB,kBAAkB;;;AAI/D,IAAsB,cAAtB,MAIE;CACA;CAEA;;CAQA,gBAAgB;;;;;;;;CAkDhB,UAAmB;AACjB,SAAO;;;;;;;;CAST,SAAkB;AAChB,SAAO;;;;;;;CAQT,cAAuB;AACrB,MAAI;AACF,QAAK,KAAK;AACV,UAAO;WAEA,OAAY;AACnB,OAAI,MAAM,SAASA,iCAAkB,kBACnC,QAAO;AAET,SAAM;;;;AAKZ,MAAM,uBAAuB,OAAO,IAAI,0BAA0B;AAClE,SAAgB,gBACd,UAC6B;AAE7B,KAAI,SAAS,0BAA0B,KAAM,QAAO;CAEpD,MAAM,cAAc,EAAE;AACtB,MAAK,MAAM,KAAK,UAAU;AACxB,MAAI,CAAC,OAAO,UAAU,eAAe,KAAK,UAAU,EAAE,CAAE;EACxD,MAAM,QAAQ,SAAS;AACvB,MAAI,cAAc,MAAM,CAAE,aAAY,KAAK;;AAG7C,QAAO,OAAO,aAAa,GAAG,uBAAuB,MAAM,CAAC;AAC5D,QAAO;;AAGT,SAAgB,cACd,UACA,YACI;CACJ,MAAM,mBAAmB,gBAAgB,SAAS;CAElD,MAAM,cAAc,EAAE;AACtB,MAAK,MAAM,KAAK,kBAAkB;AAChC,MAAI,CAAC,OAAO,UAAU,eAAe,KAAK,kBAAkB,EAAE,CAAE;EAChE,MAAM,eAAe,WAAW,eAAe;AAC/C,cAAY,KAAK,iBAAiB,GAAG,eAAe,aAAa;;AAEnE,QAAO,OAAO,aAAa,GAAG,uBAAuB,MAAM,CAAC;AAC5D,QAAO;;AAGT,SAAgB,iBACd,YACA,UACA,MACA,SACY;CAEZ,IAAI;AACJ,KAAI,aAAa,OACf,UAAS,WAAW;MACf;AACL,WAAS,EAAE;AACX,OAAK,MAAM,KAAK,UAAU;AACxB,OAAI,CAAC,OAAO,UAAU,eAAe,KAAK,UAAU,EAAE,CAAE;AACxD,OAAI;AACF,WAAO,KAAK,SAAS,GAAG,YAAY;YAE7B,OAAY;AACnB,QAAI,MAAM,SAASA,iCAAkB,mBAAmB,OAGtD,OAAM;;;;AAMd,QAAO;EACL,GAAG;EACH,IAAI,SAAS,iDAAY,KAAK;EAC9B,qBAAI,IAAI,MAAM,EAAC,aAAa;EAC5B,gBAAgB;EAChB,kBAAkB,WAAW;EAC7B,eAAe,WAAW;EAC3B"}

package/dist/channels/base.d.cts

@@ -0,0 +1,79 @@
+import { Checkpoint, ReadonlyCheckpoint } from "@langchain/langgraph-checkpoint";
+
+//#region src/channels/base.d.ts
+/** @internal */
+declare abstract class BaseChannel<ValueType = unknown, UpdateType = unknown, CheckpointType = unknown> {
+  ValueType: ValueType;
+  UpdateType: UpdateType;
+  /**
+   * The name of the channel.
+   */
+  abstract lc_graph_name: string;
+  /** @ignore */
+  lg_is_channel: boolean;
+  /**
+   * Return a new identical channel, optionally initialized from a checkpoint.
+   * Can be thought of as a "restoration" from a checkpoint which is a "snapshot" of the channel's state.
+   *
+   * @param {CheckpointType | undefined} checkpoint
+   * @param {CheckpointType | undefined} initialValue
+   * @returns {this}
+   */
+  abstract fromCheckpoint(checkpoint?: CheckpointType): this;
+  /**
+   * Update the channel's value with the given sequence of updates.
+   * The order of the updates in the sequence is arbitrary.
+   * This method is called by Pregel for all channels at the end of each step.
+   * If there are no updates, it is called with an empty sequence.
+   *
+   * Raises InvalidUpdateError if the sequence of updates is invalid.
+   * Returns True if the channel was updated, False otherwise.
+   *
+   * @throws {InvalidUpdateError} if the sequence of updates is invalid.
+   * @param {Array<UpdateType>} values
+   * @returns {void}
+   */
+  abstract update(values: UpdateType[]): boolean;
+  /**
+   * Return the current value of the channel.
+   *
+   * @throws {EmptyChannelError} if the channel is empty (never updated yet).
+   * @returns {ValueType}
+   */
+  abstract get(): ValueType;
+  /**
+   * Return a string representation of the channel's current state.
+   *
+   * @throws {EmptyChannelError} if the channel is empty (never updated yet), or doesn't support checkpoints.
+   * @returns {CheckpointType | undefined}
+   */
+  abstract checkpoint(): CheckpointType | undefined;
+  /**
+   * Mark the current value of the channel as consumed. By default, no-op.
+   * A channel can use this method to modify its state, preventing the value
+   * from being consumed again.
+   *
+   * Returns True if the channel was updated, False otherwise.
+   */
+  consume(): boolean;
+  /**
+   * Notify the channel that the Pregel run is finishing. By default, no-op.
+   * A channel can use this method to modify its state, preventing finish.
+   *
+   * Returns True if the channel was updated, False otherwise.
+   */
+  finish(): boolean;
+  /**
+   * Return True if the channel is available (not empty), False otherwise.
+   * Subclasses should override this method to provide a more efficient
+   * implementation than calling get() and catching EmptyChannelError.
+   */
+  isAvailable(): boolean;
+}
+declare function emptyChannels<Cc extends Record<string, BaseChannel>>(channels: Cc, checkpoint: ReadonlyCheckpoint): Cc;
+declare function createCheckpoint<ValueType>(checkpoint: ReadonlyCheckpoint, channels: Record<string, BaseChannel<ValueType>> | undefined, step: number, options?: {
+  id?: string;
+}): Checkpoint;
+//#endregion
+export { BaseChannel, createCheckpoint, emptyChannels };
+//# sourceMappingURL=base.d.cts.map

package/dist/channels/base.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.cts","names":["ReadonlyCheckpoint","Checkpoint","isBaseChannel","BaseChannel","ValueType","UpdateType","CheckpointType","getOnlyChannels","Record","emptyChannels","Cc","createCheckpoint"],"sources":["../../src/channels/base.d.ts"],"sourcesContent":["import { ReadonlyCheckpoint, Checkpoint } from \"@langchain/langgraph-checkpoint\";\nexport declare function isBaseChannel(obj: unknown): obj is BaseChannel;\n/** @internal */\nexport declare abstract class BaseChannel<ValueType = unknown, UpdateType = unknown, CheckpointType = unknown> {\n    ValueType: ValueType;\n    UpdateType: UpdateType;\n    /**\n     * The name of the channel.\n     */\n    abstract lc_graph_name: string;\n    /** @ignore */\n    lg_is_channel: boolean;\n    /**\n     * Return a new identical channel, optionally initialized from a checkpoint.\n     * Can be thought of as a \"restoration\" from a checkpoint which is a \"snapshot\" of the channel's state.\n     *\n     * @param {CheckpointType | undefined} checkpoint\n     * @param {CheckpointType | undefined} initialValue\n     * @returns {this}\n     */\n    abstract fromCheckpoint(checkpoint?: CheckpointType): this;\n    /**\n     * Update the channel's value with the given sequence of updates.\n     * The order of the updates in the sequence is arbitrary.\n     * This method is called by Pregel for all channels at the end of each step.\n     * If there are no updates, it is called with an empty sequence.\n     *\n     * Raises InvalidUpdateError if the sequence of updates is invalid.\n     * Returns True if the channel was updated, False otherwise.\n     *\n     * @throws {InvalidUpdateError} if the sequence of updates is invalid.\n     * @param {Array<UpdateType>} values\n     * @returns {void}\n     */\n    abstract update(values: UpdateType[]): boolean;\n    /**\n     * Return the current value of the channel.\n     *\n     * @throws {EmptyChannelError} if the channel is empty (never updated yet).\n     * @returns {ValueType}\n     */\n    abstract get(): ValueType;\n    /**\n     * Return a string representation of the channel's current state.\n     *\n     * @throws {EmptyChannelError} if the channel is empty (never updated yet), or doesn't support checkpoints.\n     * @returns {CheckpointType | undefined}\n     */\n    abstract checkpoint(): CheckpointType | undefined;\n    /**\n     * Mark the current value of the channel as consumed. By default, no-op.\n     * A channel can use this method to modify its state, preventing the value\n     * from being consumed again.\n     *\n     * Returns True if the channel was updated, False otherwise.\n     */\n    consume(): boolean;\n    /**\n     * Notify the channel that the Pregel run is finishing. By default, no-op.\n     * A channel can use this method to modify its state, preventing finish.\n     *\n     * Returns True if the channel was updated, False otherwise.\n     */\n    finish(): boolean;\n    /**\n     * Return True if the channel is available (not empty), False otherwise.\n     * Subclasses should override this method to provide a more efficient\n     * implementation than calling get() and catching EmptyChannelError.\n     */\n    isAvailable(): boolean;\n}\nexport declare function getOnlyChannels(channels: Record<string, BaseChannel>): Record<string, BaseChannel>;\nexport declare function emptyChannels<Cc extends Record<string, BaseChannel>>(channels: Cc, checkpoint: ReadonlyCheckpoint): Cc;\nexport declare function createCheckpoint<ValueType>(checkpoint: ReadonlyCheckpoint, channels: Record<string, BaseChannel<ValueType>> | undefined, step: number, options?: {\n    id?: string;\n}): Checkpoint;\n"],"mappings":";;;;AAG8BG,uBAAAA,WAAW,CAAA,YAAA,OAAA,EAAA,aAAA,OAAA,EAAA,iBAAA,OAAA,CAAA,CAAA;EAAA,SAAA,EAC1BC,SAD0B;YAC1BA,EACCC,UADDD;;;;WAqCKA,aAAAA,EAAAA,MAAAA;;EAOqB,aAAA,EAAA,OAAA;EAwBjBK;;;;;;;;EACAE,SAAAA,cAAgB,CAAA,UAAA,CAAA,EArDCL,cAqDD,CAAA,EAAA,IAAA;EAAA;;;;;;;;;;;;;0BAvCZD;;;;;;;kBAORD;;;;;;;yBAOOE;;;;;;;;;;;;;;;;;;;;;;;iBAwBHG,yBAAyBD,eAAeL,wBAAwBO,gBAAgBV,qBAAqBU;iBACrGC,wCAAwCX,8BAA8BQ,eAAeL,YAAYC;;IAErHH"}

package/dist/channels/base.d.ts

@@ -0,0 +1,79 @@
+import { Checkpoint, ReadonlyCheckpoint } from "@langchain/langgraph-checkpoint";
+
+//#region src/channels/base.d.ts
+/** @internal */
+declare abstract class BaseChannel<ValueType = unknown, UpdateType = unknown, CheckpointType = unknown> {
+  ValueType: ValueType;
+  UpdateType: UpdateType;
+  /**
+   * The name of the channel.
+   */
+  abstract lc_graph_name: string;
+  /** @ignore */
+  lg_is_channel: boolean;
+  /**
+   * Return a new identical channel, optionally initialized from a checkpoint.
+   * Can be thought of as a "restoration" from a checkpoint which is a "snapshot" of the channel's state.
+   *
+   * @param {CheckpointType | undefined} checkpoint
+   * @param {CheckpointType | undefined} initialValue
+   * @returns {this}
+   */
+  abstract fromCheckpoint(checkpoint?: CheckpointType): this;
+  /**
+   * Update the channel's value with the given sequence of updates.
+   * The order of the updates in the sequence is arbitrary.
+   * This method is called by Pregel for all channels at the end of each step.
+   * If there are no updates, it is called with an empty sequence.
+   *
+   * Raises InvalidUpdateError if the sequence of updates is invalid.
+   * Returns True if the channel was updated, False otherwise.
+   *
+   * @throws {InvalidUpdateError} if the sequence of updates is invalid.
+   * @param {Array<UpdateType>} values
+   * @returns {void}
+   */
+  abstract update(values: UpdateType[]): boolean;
+  /**
+   * Return the current value of the channel.
+   *
+   * @throws {EmptyChannelError} if the channel is empty (never updated yet).
+   * @returns {ValueType}
+   */
+  abstract get(): ValueType;
+  /**
+   * Return a string representation of the channel's current state.
+   *
+   * @throws {EmptyChannelError} if the channel is empty (never updated yet), or doesn't support checkpoints.
+   * @returns {CheckpointType | undefined}
+   */
+  abstract checkpoint(): CheckpointType | undefined;
+  /**
+   * Mark the current value of the channel as consumed. By default, no-op.
+   * A channel can use this method to modify its state, preventing the value
+   * from being consumed again.
+   *
+   * Returns True if the channel was updated, False otherwise.
+   */
+  consume(): boolean;
+  /**
+   * Notify the channel that the Pregel run is finishing. By default, no-op.
+   * A channel can use this method to modify its state, preventing finish.
+   *
+   * Returns True if the channel was updated, False otherwise.
+   */
+  finish(): boolean;
+  /**
+   * Return True if the channel is available (not empty), False otherwise.
+   * Subclasses should override this method to provide a more efficient
+   * implementation than calling get() and catching EmptyChannelError.
+   */
+  isAvailable(): boolean;
+}
+declare function emptyChannels<Cc extends Record<string, BaseChannel>>(channels: Cc, checkpoint: ReadonlyCheckpoint): Cc;
+declare function createCheckpoint<ValueType>(checkpoint: ReadonlyCheckpoint, channels: Record<string, BaseChannel<ValueType>> | undefined, step: number, options?: {
+  id?: string;
+}): Checkpoint;
+//#endregion
+export { BaseChannel, createCheckpoint, emptyChannels };
+//# sourceMappingURL=base.d.ts.map

package/dist/channels/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","names":["ReadonlyCheckpoint","Checkpoint","isBaseChannel","BaseChannel","ValueType","UpdateType","CheckpointType","getOnlyChannels","Record","emptyChannels","Cc","createCheckpoint"],"sources":["../../src/channels/base.d.ts"],"sourcesContent":["import { ReadonlyCheckpoint, Checkpoint } from \"@langchain/langgraph-checkpoint\";\nexport declare function isBaseChannel(obj: unknown): obj is BaseChannel;\n/** @internal */\nexport declare abstract class BaseChannel<ValueType = unknown, UpdateType = unknown, CheckpointType = unknown> {\n    ValueType: ValueType;\n    UpdateType: UpdateType;\n    /**\n     * The name of the channel.\n     */\n    abstract lc_graph_name: string;\n    /** @ignore */\n    lg_is_channel: boolean;\n    /**\n     * Return a new identical channel, optionally initialized from a checkpoint.\n     * Can be thought of as a \"restoration\" from a checkpoint which is a \"snapshot\" of the channel's state.\n     *\n     * @param {CheckpointType | undefined} checkpoint\n     * @param {CheckpointType | undefined} initialValue\n     * @returns {this}\n     */\n    abstract fromCheckpoint(checkpoint?: CheckpointType): this;\n    /**\n     * Update the channel's value with the given sequence of updates.\n     * The order of the updates in the sequence is arbitrary.\n     * This method is called by Pregel for all channels at the end of each step.\n     * If there are no updates, it is called with an empty sequence.\n     *\n     * Raises InvalidUpdateError if the sequence of updates is invalid.\n     * Returns True if the channel was updated, False otherwise.\n     *\n     * @throws {InvalidUpdateError} if the sequence of updates is invalid.\n     * @param {Array<UpdateType>} values\n     * @returns {void}\n     */\n    abstract update(values: UpdateType[]): boolean;\n    /**\n     * Return the current value of the channel.\n     *\n     * @throws {EmptyChannelError} if the channel is empty (never updated yet).\n     * @returns {ValueType}\n     */\n    abstract get(): ValueType;\n    /**\n     * Return a string representation of the channel's current state.\n     *\n     * @throws {EmptyChannelError} if the channel is empty (never updated yet), or doesn't support checkpoints.\n     * @returns {CheckpointType | undefined}\n     */\n    abstract checkpoint(): CheckpointType | undefined;\n    /**\n     * Mark the current value of the channel as consumed. By default, no-op.\n     * A channel can use this method to modify its state, preventing the value\n     * from being consumed again.\n     *\n     * Returns True if the channel was updated, False otherwise.\n     */\n    consume(): boolean;\n    /**\n     * Notify the channel that the Pregel run is finishing. By default, no-op.\n     * A channel can use this method to modify its state, preventing finish.\n     *\n     * Returns True if the channel was updated, False otherwise.\n     */\n    finish(): boolean;\n    /**\n     * Return True if the channel is available (not empty), False otherwise.\n     * Subclasses should override this method to provide a more efficient\n     * implementation than calling get() and catching EmptyChannelError.\n     */\n    isAvailable(): boolean;\n}\nexport declare function getOnlyChannels(channels: Record<string, BaseChannel>): Record<string, BaseChannel>;\nexport declare function emptyChannels<Cc extends Record<string, BaseChannel>>(channels: Cc, checkpoint: ReadonlyCheckpoint): Cc;\nexport declare function createCheckpoint<ValueType>(checkpoint: ReadonlyCheckpoint, channels: Record<string, BaseChannel<ValueType>> | undefined, step: number, options?: {\n    id?: string;\n}): Checkpoint;\n"],"mappings":";;;;AAG8BG,uBAAAA,WAAW,CAAA,YAAA,OAAA,EAAA,aAAA,OAAA,EAAA,iBAAA,OAAA,CAAA,CAAA;EAAA,SAAA,EAC1BC,SAD0B;YAC1BA,EACCC,UADDD;;;;WAqCKA,aAAAA,EAAAA,MAAAA;;EAOqB,aAAA,EAAA,OAAA;EAwBjBK;;;;;;;;EACAE,SAAAA,cAAgB,CAAA,UAAA,CAAA,EArDCL,cAqDD,CAAA,EAAA,IAAA;EAAA;;;;;;;;;;;;;0BAvCZD;;;;;;;kBAORD;;;;;;;yBAOOE;;;;;;;;;;;;;;;;;;;;;;;iBAwBHG,yBAAyBD,eAAeL,wBAAwBO,gBAAgBV,qBAAqBU;iBACrGC,wCAAwCX,8BAA8BQ,eAAeL,YAAYC;;IAErHH"}

package/dist/channels/base.js

@@ -0,0 +1,97 @@
+import { EmptyChannelError } from "../errors.js";
+import { uuid6 } from "@langchain/langgraph-checkpoint";
+
+//#region src/channels/base.ts
+function isBaseChannel(obj) {
+	return obj != null && obj.lg_is_channel === true;
+}
+/** @internal */
+var BaseChannel = class {
+	ValueType;
+	UpdateType;
+	/** @ignore */
+	lg_is_channel = true;
+	/**
+	* Mark the current value of the channel as consumed. By default, no-op.
+	* A channel can use this method to modify its state, preventing the value
+	* from being consumed again.
+	*
+	* Returns True if the channel was updated, False otherwise.
+	*/
+	consume() {
+		return false;
+	}
+	/**
+	* Notify the channel that the Pregel run is finishing. By default, no-op.
+	* A channel can use this method to modify its state, preventing finish.
+	*
+	* Returns True if the channel was updated, False otherwise.
+	*/
+	finish() {
+		return false;
+	}
+	/**
+	* Return True if the channel is available (not empty), False otherwise.
+	* Subclasses should override this method to provide a more efficient
+	* implementation than calling get() and catching EmptyChannelError.
+	*/
+	isAvailable() {
+		try {
+			this.get();
+			return true;
+		} catch (error) {
+			if (error.name === EmptyChannelError.unminifiable_name) return false;
+			throw error;
+		}
+	}
+};
+const IS_ONLY_BASE_CHANNEL = Symbol.for("LG_IS_ONLY_BASE_CHANNEL");
+function getOnlyChannels(channels) {
+	if (channels[IS_ONLY_BASE_CHANNEL] === true) return channels;
+	const newChannels = {};
+	for (const k in channels) {
+		if (!Object.prototype.hasOwnProperty.call(channels, k)) continue;
+		const value = channels[k];
+		if (isBaseChannel(value)) newChannels[k] = value;
+	}
+	Object.assign(newChannels, { [IS_ONLY_BASE_CHANNEL]: true });
+	return newChannels;
+}
+function emptyChannels(channels, checkpoint) {
+	const filteredChannels = getOnlyChannels(channels);
+	const newChannels = {};
+	for (const k in filteredChannels) {
+		if (!Object.prototype.hasOwnProperty.call(filteredChannels, k)) continue;
+		const channelValue = checkpoint.channel_values[k];
+		newChannels[k] = filteredChannels[k].fromCheckpoint(channelValue);
+	}
+	Object.assign(newChannels, { [IS_ONLY_BASE_CHANNEL]: true });
+	return newChannels;
+}
+function createCheckpoint(checkpoint, channels, step, options) {
+	let values;
+	if (channels === void 0) values = checkpoint.channel_values;
+	else {
+		values = {};
+		for (const k in channels) {
+			if (!Object.prototype.hasOwnProperty.call(channels, k)) continue;
+			try {
+				values[k] = channels[k].checkpoint();
+			} catch (error) {
+				if (error.name === EmptyChannelError.unminifiable_name) {} else throw error;
+			}
+		}
+	}
+	return {
+		v: 4,
+		id: options?.id ?? uuid6(step),
+		ts: (/* @__PURE__ */ new Date()).toISOString(),
+		channel_values: values,
+		channel_versions: checkpoint.channel_versions,
+		versions_seen: checkpoint.versions_seen
+	};
+}
+
+//#endregion
+export { BaseChannel, createCheckpoint, emptyChannels, getOnlyChannels, isBaseChannel };
+//# sourceMappingURL=base.js.map

package/dist/channels/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","names":[],"sources":["../../src/channels/base.ts"],"sourcesContent":["import {\n  ReadonlyCheckpoint,\n  uuid6,\n  Checkpoint,\n} from \"@langchain/langgraph-checkpoint\";\nimport { EmptyChannelError } from \"../errors.js\";\n\nexport function isBaseChannel(obj: unknown): obj is BaseChannel {\n  return obj != null && (obj as BaseChannel).lg_is_channel === true;\n}\n\n/** @internal */\nexport abstract class BaseChannel<\n  ValueType = unknown,\n  UpdateType = unknown,\n  CheckpointType = unknown\n> {\n  ValueType: ValueType;\n\n  UpdateType: UpdateType;\n\n  /**\n   * The name of the channel.\n   */\n  abstract lc_graph_name: string;\n\n  /** @ignore */\n  lg_is_channel = true;\n\n  /**\n   * Return a new identical channel, optionally initialized from a checkpoint.\n   * Can be thought of as a \"restoration\" from a checkpoint which is a \"snapshot\" of the channel's state.\n   *\n   * @param {CheckpointType | undefined} checkpoint\n   * @param {CheckpointType | undefined} initialValue\n   * @returns {this}\n   */\n  abstract fromCheckpoint(checkpoint?: CheckpointType): this;\n\n  /**\n   * Update the channel's value with the given sequence of updates.\n   * The order of the updates in the sequence is arbitrary.\n   * This method is called by Pregel for all channels at the end of each step.\n   * If there are no updates, it is called with an empty sequence.\n   *\n   * Raises InvalidUpdateError if the sequence of updates is invalid.\n   * Returns True if the channel was updated, False otherwise.\n   *\n   * @throws {InvalidUpdateError} if the sequence of updates is invalid.\n   * @param {Array<UpdateType>} values\n   * @returns {void}\n   */\n  abstract update(values: UpdateType[]): boolean;\n\n  /**\n   * Return the current value of the channel.\n   *\n   * @throws {EmptyChannelError} if the channel is empty (never updated yet).\n   * @returns {ValueType}\n   */\n  abstract get(): ValueType;\n\n  /**\n   * Return a string representation of the channel's current state.\n   *\n   * @throws {EmptyChannelError} if the channel is empty (never updated yet), or doesn't support checkpoints.\n   * @returns {CheckpointType | undefined}\n   */\n  abstract checkpoint(): CheckpointType | undefined;\n\n  /**\n   * Mark the current value of the channel as consumed. By default, no-op.\n   * A channel can use this method to modify its state, preventing the value\n   * from being consumed again.\n   *\n   * Returns True if the channel was updated, False otherwise.\n   */\n  consume(): boolean {\n    return false;\n  }\n\n  /**\n   * Notify the channel that the Pregel run is finishing. By default, no-op.\n   * A channel can use this method to modify its state, preventing finish.\n   *\n   * Returns True if the channel was updated, False otherwise.\n   */\n  finish(): boolean {\n    return false;\n  }\n\n  /**\n   * Return True if the channel is available (not empty), False otherwise.\n   * Subclasses should override this method to provide a more efficient\n   * implementation than calling get() and catching EmptyChannelError.\n   */\n  isAvailable(): boolean {\n    try {\n      this.get();\n      return true;\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    } catch (error: any) {\n      if (error.name === EmptyChannelError.unminifiable_name) {\n        return false;\n      }\n      throw error;\n    }\n  }\n}\n\nconst IS_ONLY_BASE_CHANNEL = Symbol.for(\"LG_IS_ONLY_BASE_CHANNEL\");\nexport function getOnlyChannels(\n  channels: Record<string, BaseChannel>\n): Record<string, BaseChannel> {\n  // @ts-expect-error - we know it's a record of base channels\n  if (channels[IS_ONLY_BASE_CHANNEL] === true) return channels;\n\n  const newChannels = {} as Record<string, BaseChannel>;\n  for (const k in channels) {\n    if (!Object.prototype.hasOwnProperty.call(channels, k)) continue;\n    const value = channels[k];\n    if (isBaseChannel(value)) newChannels[k] = value;\n  }\n\n  Object.assign(newChannels, { [IS_ONLY_BASE_CHANNEL]: true });\n  return newChannels;\n}\n\nexport function emptyChannels<Cc extends Record<string, BaseChannel>>(\n  channels: Cc,\n  checkpoint: ReadonlyCheckpoint\n): Cc {\n  const filteredChannels = getOnlyChannels(channels) as Cc;\n\n  const newChannels = {} as Cc;\n  for (const k in filteredChannels) {\n    if (!Object.prototype.hasOwnProperty.call(filteredChannels, k)) continue;\n    const channelValue = checkpoint.channel_values[k];\n    newChannels[k] = filteredChannels[k].fromCheckpoint(channelValue);\n  }\n  Object.assign(newChannels, { [IS_ONLY_BASE_CHANNEL]: true });\n  return newChannels;\n}\n\nexport function createCheckpoint<ValueType>(\n  checkpoint: ReadonlyCheckpoint,\n  channels: Record<string, BaseChannel<ValueType>> | undefined,\n  step: number,\n  options?: { id?: string }\n): Checkpoint {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  let values: Record<string, any>;\n  if (channels === undefined) {\n    values = checkpoint.channel_values;\n  } else {\n    values = {};\n    for (const k in channels) {\n      if (!Object.prototype.hasOwnProperty.call(channels, k)) continue;\n      try {\n        values[k] = channels[k].checkpoint();\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      } catch (error: any) {\n        if (error.name === EmptyChannelError.unminifiable_name) {\n          // no-op\n        } else {\n          throw error; // Rethrow unexpected errors\n        }\n      }\n    }\n  }\n\n  return {\n    v: 4,\n    id: options?.id ?? uuid6(step),\n    ts: new Date().toISOString(),\n    channel_values: values,\n    channel_versions: checkpoint.channel_versions,\n    versions_seen: checkpoint.versions_seen,\n  };\n}\n"],"mappings":";;;;AAOA,SAAgB,cAAc,KAAkC;AAC9D,QAAO,OAAO,QAAS,IAAoB,kBAAkB;;;AAI/D,IAAsB,cAAtB,MAIE;CACA;CAEA;;CAQA,gBAAgB;;;;;;;;CAkDhB,UAAmB;AACjB,SAAO;;;;;;;;CAST,SAAkB;AAChB,SAAO;;;;;;;CAQT,cAAuB;AACrB,MAAI;AACF,QAAK,KAAK;AACV,UAAO;WAEA,OAAY;AACnB,OAAI,MAAM,SAAS,kBAAkB,kBACnC,QAAO;AAET,SAAM;;;;AAKZ,MAAM,uBAAuB,OAAO,IAAI,0BAA0B;AAClE,SAAgB,gBACd,UAC6B;AAE7B,KAAI,SAAS,0BAA0B,KAAM,QAAO;CAEpD,MAAM,cAAc,EAAE;AACtB,MAAK,MAAM,KAAK,UAAU;AACxB,MAAI,CAAC,OAAO,UAAU,eAAe,KAAK,UAAU,EAAE,CAAE;EACxD,MAAM,QAAQ,SAAS;AACvB,MAAI,cAAc,MAAM,CAAE,aAAY,KAAK;;AAG7C,QAAO,OAAO,aAAa,GAAG,uBAAuB,MAAM,CAAC;AAC5D,QAAO;;AAGT,SAAgB,cACd,UACA,YACI;CACJ,MAAM,mBAAmB,gBAAgB,SAAS;CAElD,MAAM,cAAc,EAAE;AACtB,MAAK,MAAM,KAAK,kBAAkB;AAChC,MAAI,CAAC,OAAO,UAAU,eAAe,KAAK,kBAAkB,EAAE,CAAE;EAChE,MAAM,eAAe,WAAW,eAAe;AAC/C,cAAY,KAAK,iBAAiB,GAAG,eAAe,aAAa;;AAEnE,QAAO,OAAO,aAAa,GAAG,uBAAuB,MAAM,CAAC;AAC5D,QAAO;;AAGT,SAAgB,iBACd,YACA,UACA,MACA,SACY;CAEZ,IAAI;AACJ,KAAI,aAAa,OACf,UAAS,WAAW;MACf;AACL,WAAS,EAAE;AACX,OAAK,MAAM,KAAK,UAAU;AACxB,OAAI,CAAC,OAAO,UAAU,eAAe,KAAK,UAAU,EAAE,CAAE;AACxD,OAAI;AACF,WAAO,KAAK,SAAS,GAAG,YAAY;YAE7B,OAAY;AACnB,QAAI,MAAM,SAAS,kBAAkB,mBAAmB,OAGtD,OAAM;;;;AAMd,QAAO;EACL,GAAG;EACH,IAAI,SAAS,MAAM,MAAM,KAAK;EAC9B,qBAAI,IAAI,MAAM,EAAC,aAAa;EAC5B,gBAAgB;EAChB,kBAAkB,WAAW;EAC7B,eAAe,WAAW;EAC3B"}

package/dist/channels/binop.cjs

@@ -0,0 +1,49 @@
+const require_errors = require('../errors.cjs');
+const require_base = require('./base.cjs');
+
+//#region src/channels/binop.ts
+/**
+* Stores the result of applying a binary operator to the current value and each new value.
+*/
+var BinaryOperatorAggregate = class BinaryOperatorAggregate extends require_base.BaseChannel {
+	lc_graph_name = "BinaryOperatorAggregate";
+	value;
+	operator;
+	initialValueFactory;
+	constructor(operator, initialValueFactory) {
+		super();
+		this.operator = operator;
+		this.initialValueFactory = initialValueFactory;
+		this.value = initialValueFactory?.();
+	}
+	fromCheckpoint(checkpoint) {
+		const empty = new BinaryOperatorAggregate(this.operator, this.initialValueFactory);
+		if (typeof checkpoint !== "undefined") empty.value = checkpoint;
+		return empty;
+	}
+	update(values) {
+		let newValues = values;
+		if (!newValues.length) return false;
+		if (this.value === void 0) {
+			[this.value] = newValues;
+			newValues = newValues.slice(1);
+		}
+		for (const value of newValues) if (this.value !== void 0) this.value = this.operator(this.value, value);
+		return true;
+	}
+	get() {
+		if (this.value === void 0) throw new require_errors.EmptyChannelError();
+		return this.value;
+	}
+	checkpoint() {
+		if (this.value === void 0) throw new require_errors.EmptyChannelError();
+		return this.value;
+	}
+	isAvailable() {
+		return this.value !== void 0;
+	}
+};
+
+//#endregion
+exports.BinaryOperatorAggregate = BinaryOperatorAggregate;
+//# sourceMappingURL=binop.cjs.map

package/dist/channels/binop.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"binop.cjs","names":["BaseChannel","EmptyChannelError"],"sources":["../../src/channels/binop.ts"],"sourcesContent":["import { EmptyChannelError } from \"../errors.js\";\nimport { BaseChannel } from \"./base.js\";\n\nexport type BinaryOperator<ValueType, UpdateType> = (\n  a: ValueType,\n  b: UpdateType\n) => ValueType;\n\n/**\n * Stores the result of applying a binary operator to the current value and each new value.\n */\nexport class BinaryOperatorAggregate<\n  ValueType,\n  UpdateType = ValueType\n> extends BaseChannel<ValueType, UpdateType, ValueType> {\n  lc_graph_name = \"BinaryOperatorAggregate\";\n\n  value: ValueType | undefined;\n\n  operator: BinaryOperator<ValueType, UpdateType>;\n\n  initialValueFactory?: () => ValueType;\n\n  constructor(\n    operator: BinaryOperator<ValueType, UpdateType>,\n    initialValueFactory?: () => ValueType\n  ) {\n    super();\n\n    this.operator = operator;\n    this.initialValueFactory = initialValueFactory;\n    this.value = initialValueFactory?.();\n  }\n\n  public fromCheckpoint(checkpoint?: ValueType) {\n    const empty = new BinaryOperatorAggregate(\n      this.operator,\n      this.initialValueFactory\n    );\n    if (typeof checkpoint !== \"undefined\") {\n      empty.value = checkpoint;\n    }\n    return empty as this;\n  }\n\n  public update(values: UpdateType[]): boolean {\n    let newValues = values;\n    if (!newValues.length) return false;\n\n    if (this.value === undefined) {\n      [this.value as UpdateType] = newValues;\n      newValues = newValues.slice(1);\n    }\n\n    for (const value of newValues) {\n      if (this.value !== undefined) {\n        this.value = this.operator(this.value, value);\n      }\n    }\n    return true;\n  }\n\n  public get(): ValueType {\n    if (this.value === undefined) {\n      throw new EmptyChannelError();\n    }\n    return this.value;\n  }\n\n  public checkpoint(): ValueType {\n    if (this.value === undefined) {\n      throw new EmptyChannelError();\n    }\n    return this.value;\n  }\n\n  isAvailable(): boolean {\n    return this.value !== undefined;\n  }\n}\n"],"mappings":";;;;;;;AAWA,IAAa,0BAAb,MAAa,gCAGHA,yBAA8C;CACtD,gBAAgB;CAEhB;CAEA;CAEA;CAEA,YACE,UACA,qBACA;AACA,SAAO;AAEP,OAAK,WAAW;AAChB,OAAK,sBAAsB;AAC3B,OAAK,QAAQ,uBAAuB;;CAGtC,AAAO,eAAe,YAAwB;EAC5C,MAAM,QAAQ,IAAI,wBAChB,KAAK,UACL,KAAK,oBACN;AACD,MAAI,OAAO,eAAe,YACxB,OAAM,QAAQ;AAEhB,SAAO;;CAGT,AAAO,OAAO,QAA+B;EAC3C,IAAI,YAAY;AAChB,MAAI,CAAC,UAAU,OAAQ,QAAO;AAE9B,MAAI,KAAK,UAAU,QAAW;AAC5B,IAAC,KAAK,SAAuB;AAC7B,eAAY,UAAU,MAAM,EAAE;;AAGhC,OAAK,MAAM,SAAS,UAClB,KAAI,KAAK,UAAU,OACjB,MAAK,QAAQ,KAAK,SAAS,KAAK,OAAO,MAAM;AAGjD,SAAO;;CAGT,AAAO,MAAiB;AACtB,MAAI,KAAK,UAAU,OACjB,OAAM,IAAIC,kCAAmB;AAE/B,SAAO,KAAK;;CAGd,AAAO,aAAwB;AAC7B,MAAI,KAAK,UAAU,OACjB,OAAM,IAAIA,kCAAmB;AAE/B,SAAO,KAAK;;CAGd,cAAuB;AACrB,SAAO,KAAK,UAAU"}