@langchain/langgraph 1.0.12 → 1.0.14

package/dist/channels/named_barrier_value.js

@@ -0,0 +1,114 @@
+import { EmptyChannelError, InvalidUpdateError } from "../errors.js";
+import { BaseChannel } from "./base.js";
+
+//#region src/channels/named_barrier_value.ts
+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.
+*/
+var NamedBarrierValue = class NamedBarrierValue extends BaseChannel {
+	lc_graph_name = "NamedBarrierValue";
+	names;
+	seen;
+	constructor(names) {
+		super();
+		this.names = names;
+		this.seen = /* @__PURE__ */ new Set();
+	}
+	fromCheckpoint(checkpoint) {
+		const empty = new NamedBarrierValue(this.names);
+		if (typeof checkpoint !== "undefined") empty.seen = new Set(checkpoint);
+		return empty;
+	}
+	update(values) {
+		let updated = false;
+		for (const nodeName of values) if (this.names.has(nodeName)) {
+			if (!this.seen.has(nodeName)) {
+				this.seen.add(nodeName);
+				updated = true;
+			}
+		} else throw new InvalidUpdateError(`Value ${JSON.stringify(nodeName)} not in names ${JSON.stringify(this.names)}`);
+		return updated;
+	}
+	get() {
+		if (!areSetsEqual(this.names, this.seen)) throw new EmptyChannelError();
+	}
+	checkpoint() {
+		return [...this.seen];
+	}
+	consume() {
+		if (this.seen && this.names && areSetsEqual(this.seen, this.names)) {
+			this.seen = /* @__PURE__ */ new Set();
+			return true;
+		}
+		return false;
+	}
+	isAvailable() {
+		return !!this.names && areSetsEqual(this.names, this.seen);
+	}
+};
+/**
+* A channel that waits until all named values are received before making the value ready to be made available.
+* It is only made available after finish() is called.
+* @internal
+*/
+var NamedBarrierValueAfterFinish = class NamedBarrierValueAfterFinish extends BaseChannel {
+	lc_graph_name = "NamedBarrierValueAfterFinish";
+	names;
+	seen;
+	finished;
+	constructor(names) {
+		super();
+		this.names = names;
+		this.seen = /* @__PURE__ */ new Set();
+		this.finished = false;
+	}
+	fromCheckpoint(checkpoint) {
+		const empty = new NamedBarrierValueAfterFinish(this.names);
+		if (typeof checkpoint !== "undefined") {
+			const [seen, finished] = checkpoint;
+			empty.seen = new Set(seen);
+			empty.finished = finished;
+		}
+		return empty;
+	}
+	update(values) {
+		let updated = false;
+		for (const nodeName of values) if (this.names.has(nodeName) && !this.seen.has(nodeName)) {
+			this.seen.add(nodeName);
+			updated = true;
+		} else if (!this.names.has(nodeName)) throw new InvalidUpdateError(`Value ${JSON.stringify(nodeName)} not in names ${JSON.stringify(this.names)}`);
+		return updated;
+	}
+	get() {
+		if (!this.finished || !areSetsEqual(this.names, this.seen)) throw new EmptyChannelError();
+	}
+	checkpoint() {
+		return [[...this.seen], this.finished];
+	}
+	consume() {
+		if (this.finished && this.seen && this.names && areSetsEqual(this.seen, this.names)) {
+			this.seen = /* @__PURE__ */ new Set();
+			this.finished = false;
+			return true;
+		}
+		return false;
+	}
+	finish() {
+		if (!this.finished && !!this.names && areSetsEqual(this.names, this.seen)) {
+			this.finished = true;
+			return true;
+		}
+		return false;
+	}
+	isAvailable() {
+		return this.finished && !!this.names && areSetsEqual(this.names, this.seen);
+	}
+};
+
+//#endregion
+export { NamedBarrierValue, NamedBarrierValueAfterFinish, areSetsEqual };
+//# sourceMappingURL=named_barrier_value.js.map

package/dist/channels/named_barrier_value.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"named_barrier_value.js","names":[],"sources":["../../src/channels/named_barrier_value.ts"],"sourcesContent":["import { EmptyChannelError, InvalidUpdateError } from \"../errors.js\";\nimport { BaseChannel } from \"./base.js\";\n\nexport const areSetsEqual = <T>(a: Set<T>, b: Set<T>) =>\n  a.size === b.size && [...a].every((value) => b.has(value));\n\n/**\n * A channel that waits until all named values are received before making the value available.\n *\n * This ensures that if node N and node M both write to channel C, the value of C will not be updated\n * until N and M have completed updating.\n */\nexport class NamedBarrierValue<Value> extends BaseChannel<\n  void,\n  Value,\n  Value[]\n> {\n  lc_graph_name = \"NamedBarrierValue\";\n\n  names: Set<Value>; // Names of nodes that we want to wait for.\n\n  seen: Set<Value>;\n\n  constructor(names: Set<Value>) {\n    super();\n    this.names = names;\n    this.seen = new Set<Value>();\n  }\n\n  fromCheckpoint(checkpoint?: Value[]) {\n    const empty = new NamedBarrierValue<Value>(this.names);\n    if (typeof checkpoint !== \"undefined\") {\n      empty.seen = new Set(checkpoint);\n    }\n    return empty as this;\n  }\n\n  update(values: Value[]): boolean {\n    let updated = false;\n    for (const nodeName of values) {\n      if (this.names.has(nodeName)) {\n        if (!this.seen.has(nodeName)) {\n          this.seen.add(nodeName);\n          updated = true;\n        }\n      } else {\n        throw new InvalidUpdateError(\n          `Value ${JSON.stringify(nodeName)} not in names ${JSON.stringify(\n            this.names\n          )}`\n        );\n      }\n    }\n    return updated;\n  }\n\n  // If we have not yet seen all the node names we want to wait for,\n  // throw an error to prevent continuing.\n  get(): void {\n    if (!areSetsEqual(this.names, this.seen)) {\n      throw new EmptyChannelError();\n    }\n    return undefined;\n  }\n\n  checkpoint(): Value[] {\n    return [...this.seen];\n  }\n\n  consume(): boolean {\n    if (this.seen && this.names && areSetsEqual(this.seen, this.names)) {\n      this.seen = new Set<Value>();\n      return true;\n    }\n    return false;\n  }\n\n  isAvailable(): boolean {\n    return !!this.names && areSetsEqual(this.names, this.seen);\n  }\n}\n\n/**\n * A channel that waits until all named values are received before making the value ready to be made available.\n * It is only made available after finish() is called.\n * @internal\n */\nexport class NamedBarrierValueAfterFinish<Value> extends BaseChannel<\n  void,\n  Value,\n  [Value[], boolean]\n> {\n  lc_graph_name = \"NamedBarrierValueAfterFinish\";\n\n  names: Set<Value>; // Names of nodes that we want to wait for.\n\n  seen: Set<Value>;\n\n  finished: boolean;\n\n  constructor(names: Set<Value>) {\n    super();\n    this.names = names;\n    this.seen = new Set<Value>();\n    this.finished = false;\n  }\n\n  fromCheckpoint(checkpoint?: [Value[], boolean]) {\n    const empty = new NamedBarrierValueAfterFinish<Value>(this.names);\n    if (typeof checkpoint !== \"undefined\") {\n      const [seen, finished] = checkpoint;\n      empty.seen = new Set(seen);\n      empty.finished = finished;\n    }\n    return empty as this;\n  }\n\n  update(values: Value[]): boolean {\n    let updated = false;\n    for (const nodeName of values) {\n      if (this.names.has(nodeName) && !this.seen.has(nodeName)) {\n        this.seen.add(nodeName);\n        updated = true;\n      } else if (!this.names.has(nodeName)) {\n        throw new InvalidUpdateError(\n          `Value ${JSON.stringify(nodeName)} not in names ${JSON.stringify(\n            this.names\n          )}`\n        );\n      }\n    }\n    return updated;\n  }\n\n  get(): void {\n    if (!this.finished || !areSetsEqual(this.names, this.seen)) {\n      throw new EmptyChannelError();\n    }\n    return undefined;\n  }\n\n  checkpoint(): [Value[], boolean] {\n    return [[...this.seen], this.finished];\n  }\n\n  consume(): boolean {\n    if (\n      this.finished &&\n      this.seen &&\n      this.names &&\n      areSetsEqual(this.seen, this.names)\n    ) {\n      this.seen = new Set<Value>();\n      this.finished = false;\n      return true;\n    }\n    return false;\n  }\n\n  finish(): boolean {\n    if (!this.finished && !!this.names && areSetsEqual(this.names, this.seen)) {\n      this.finished = true;\n      return true;\n    }\n    return false;\n  }\n\n  isAvailable(): boolean {\n    return this.finished && !!this.names && areSetsEqual(this.names, this.seen);\n  }\n}\n"],"mappings":"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"}

package/dist/channels/topic.cjs

@@ -0,0 +1,65 @@
+const require_errors = require('../errors.cjs');
+const require_base = require('./base.cjs');
+
+//#region src/channels/topic.ts
+/**
+* A configurable PubSub Topic.
+*/
+var Topic = class Topic extends require_base.BaseChannel {
+	lc_graph_name = "Topic";
+	unique = false;
+	accumulate = false;
+	seen;
+	values;
+	constructor(fields) {
+		super();
+		this.unique = fields?.unique ?? this.unique;
+		this.accumulate = fields?.accumulate ?? this.accumulate;
+		this.seen = /* @__PURE__ */ new Set();
+		this.values = [];
+	}
+	fromCheckpoint(checkpoint) {
+		const empty = new Topic({
+			unique: this.unique,
+			accumulate: this.accumulate
+		});
+		if (typeof checkpoint !== "undefined") {
+			empty.seen = new Set(checkpoint[0]);
+			empty.values = checkpoint[1];
+		}
+		return empty;
+	}
+	update(values) {
+		let updated = false;
+		if (!this.accumulate) {
+			updated = this.values.length > 0;
+			this.values = [];
+		}
+		const flatValues = values.flat();
+		if (flatValues.length > 0) if (this.unique) {
+			for (const value of flatValues) if (!this.seen.has(value)) {
+				updated = true;
+				this.seen.add(value);
+				this.values.push(value);
+			}
+		} else {
+			updated = true;
+			this.values.push(...flatValues);
+		}
+		return updated;
+	}
+	get() {
+		if (this.values.length === 0) throw new require_errors.EmptyChannelError();
+		return this.values;
+	}
+	checkpoint() {
+		return [[...this.seen], this.values];
+	}
+	isAvailable() {
+		return this.values.length !== 0;
+	}
+};
+
+//#endregion
+exports.Topic = Topic;
+//# sourceMappingURL=topic.cjs.map

package/dist/channels/topic.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"topic.cjs","names":["BaseChannel","EmptyChannelError"],"sources":["../../src/channels/topic.ts"],"sourcesContent":["import { EmptyChannelError } from \"../errors.js\";\nimport { BaseChannel } from \"./base.js\";\n\n/**\n * A configurable PubSub Topic.\n */\nexport class Topic<Value> extends BaseChannel<\n  Array<Value>,\n  Value | Value[],\n  [Value[], Value[]]\n> {\n  lc_graph_name = \"Topic\";\n\n  unique = false;\n\n  accumulate = false;\n\n  seen: Set<Value>;\n\n  values: Value[];\n\n  constructor(fields?: {\n    /**\n     * Whether to only add unique values to the topic. If `true`, only unique values (using reference equality) will be added to the topic.\n     */\n    unique?: boolean;\n    /**\n     * Whether to accumulate values across steps. If `false`, the channel will be emptied after each step.\n     */\n    accumulate?: boolean;\n  }) {\n    super();\n\n    this.unique = fields?.unique ?? this.unique;\n    this.accumulate = fields?.accumulate ?? this.accumulate;\n    // State\n    this.seen = new Set<Value>();\n    this.values = [];\n  }\n\n  public fromCheckpoint(checkpoint?: [Value[], Value[]]) {\n    const empty = new Topic<Value>({\n      unique: this.unique,\n      accumulate: this.accumulate,\n    });\n    if (typeof checkpoint !== \"undefined\") {\n      empty.seen = new Set(checkpoint[0]);\n      // eslint-disable-next-line prefer-destructuring\n      empty.values = checkpoint[1];\n    }\n    return empty as this;\n  }\n\n  public update(values: Array<Value | Value[]>): boolean {\n    let updated = false;\n    if (!this.accumulate) {\n      updated = this.values.length > 0;\n      this.values = [];\n    }\n    const flatValues = values.flat() as Value[];\n    if (flatValues.length > 0) {\n      if (this.unique) {\n        for (const value of flatValues) {\n          if (!this.seen.has(value)) {\n            updated = true;\n            this.seen.add(value);\n            this.values.push(value);\n          }\n        }\n      } else {\n        updated = true;\n        this.values.push(...flatValues);\n      }\n    }\n    return updated;\n  }\n\n  public get(): Array<Value> {\n    if (this.values.length === 0) {\n      throw new EmptyChannelError();\n    }\n    return this.values;\n  }\n\n  public checkpoint(): [Value[], Value[]] {\n    return [[...this.seen], this.values];\n  }\n\n  isAvailable(): boolean {\n    return this.values.length !== 0;\n  }\n}\n"],"mappings":";;;;;;;AAMA,IAAa,QAAb,MAAa,cAAqBA,yBAIhC;CACA,gBAAgB;CAEhB,SAAS;CAET,aAAa;CAEb;CAEA;CAEA,YAAY,QAST;AACD,SAAO;AAEP,OAAK,SAAS,QAAQ,UAAU,KAAK;AACrC,OAAK,aAAa,QAAQ,cAAc,KAAK;AAE7C,OAAK,uBAAO,IAAI,KAAY;AAC5B,OAAK,SAAS,EAAE;;CAGlB,AAAO,eAAe,YAAiC;EACrD,MAAM,QAAQ,IAAI,MAAa;GAC7B,QAAQ,KAAK;GACb,YAAY,KAAK;GAClB,CAAC;AACF,MAAI,OAAO,eAAe,aAAa;AACrC,SAAM,OAAO,IAAI,IAAI,WAAW,GAAG;AAEnC,SAAM,SAAS,WAAW;;AAE5B,SAAO;;CAGT,AAAO,OAAO,QAAyC;EACrD,IAAI,UAAU;AACd,MAAI,CAAC,KAAK,YAAY;AACpB,aAAU,KAAK,OAAO,SAAS;AAC/B,QAAK,SAAS,EAAE;;EAElB,MAAM,aAAa,OAAO,MAAM;AAChC,MAAI,WAAW,SAAS,EACtB,KAAI,KAAK,QACP;QAAK,MAAM,SAAS,WAClB,KAAI,CAAC,KAAK,KAAK,IAAI,MAAM,EAAE;AACzB,cAAU;AACV,SAAK,KAAK,IAAI,MAAM;AACpB,SAAK,OAAO,KAAK,MAAM;;SAGtB;AACL,aAAU;AACV,QAAK,OAAO,KAAK,GAAG,WAAW;;AAGnC,SAAO;;CAGT,AAAO,MAAoB;AACzB,MAAI,KAAK,OAAO,WAAW,EACzB,OAAM,IAAIC,kCAAmB;AAE/B,SAAO,KAAK;;CAGd,AAAO,aAAiC;AACtC,SAAO,CAAC,CAAC,GAAG,KAAK,KAAK,EAAE,KAAK,OAAO;;CAGtC,cAAuB;AACrB,SAAO,KAAK,OAAO,WAAW"}

package/dist/channels/topic.d.cts

@@ -0,0 +1,32 @@
+import { BaseChannel } from "./base.cjs";
+
+//#region src/channels/topic.d.ts
+
+/**
+ * A configurable PubSub Topic.
+ */
+declare class Topic<Value> extends BaseChannel<Array<Value>, Value | Value[], [Value[], Value[]]> {
+  lc_graph_name: string;
+  unique: boolean;
+  accumulate: boolean;
+  seen: Set<Value>;
+  values: Value[];
+  constructor(fields?: {
+    /**
+     * Whether to only add unique values to the topic. If `true`, only unique values (using reference equality) will be added to the topic.
+     */
+    unique?: boolean;
+    /**
+     * Whether to accumulate values across steps. If `false`, the channel will be emptied after each step.
+     */
+    accumulate?: boolean;
+  });
+  fromCheckpoint(checkpoint?: [Value[], Value[]]): this;
+  update(values: Array<Value | Value[]>): boolean;
+  get(): Array<Value>;
+  checkpoint(): [Value[], Value[]];
+  isAvailable(): boolean;
+}
+//#endregion
+export { Topic };
+//# sourceMappingURL=topic.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"topic.d.cts","names":["BaseChannel","Topic","Value","Array","Set"],"sources":["../../src/channels/topic.d.ts"],"sourcesContent":["import { BaseChannel } from \"./base.js\";\n/**\n * A configurable PubSub Topic.\n */\nexport declare class Topic<Value> extends BaseChannel<Array<Value>, Value | Value[], [\n    Value[],\n    Value[]\n]> {\n    lc_graph_name: string;\n    unique: boolean;\n    accumulate: boolean;\n    seen: Set<Value>;\n    values: Value[];\n    constructor(fields?: {\n        /**\n         * Whether to only add unique values to the topic. If `true`, only unique values (using reference equality) will be added to the topic.\n         */\n        unique?: boolean;\n        /**\n         * Whether to accumulate values across steps. If `false`, the channel will be emptied after each step.\n         */\n        accumulate?: boolean;\n    });\n    fromCheckpoint(checkpoint?: [Value[], Value[]]): this;\n    update(values: Array<Value | Value[]>): boolean;\n    get(): Array<Value>;\n    checkpoint(): [Value[], Value[]];\n    isAvailable(): boolean;\n}\n"],"mappings":";;;;;;AAIA;AAA0B,cAALC,KAAK,CAAA,KAAA,CAAA,SAAgBD,WAAhB,CAA4BG,KAA5B,CAAkCD,KAAlC,CAAA,EAA0CA,KAA1C,GAAkDA,KAAlD,EAAA,EAAA,CACtBA,KADwDA,EAAAA,EAExDA,KAFkDC,EAAAA;eAAsBD,EAAAA,MAAAA;QACxEA,EAAAA,OAAAA;YACAA,EAAAA,OAAAA;MAKUA,EAAJE,GAAIF,CAAAA,KAAAA,CAAAA;QAAJE,EACEF,KADFE,EAAAA;aACEF,CAAAA,OAAAA,EAAAA;IAWqBA;;;IACAA,MAAAA,CAAAA,EAAAA,OAAAA;IAAdC;;;IAEAD,UAAAA,CAAAA,EAAAA,OAAAA;;gBAtBuBF,CAAAA,UAAAA,CAAAA,EAAAA,CAmBTE,KAnBSF,EAAAA,EAmBAE,KAnBAF,EAAAA,CAAAA,CAAAA,EAAAA,IAAAA;EAAW,MAAA,CAAA,MAAA,EAoBlCG,KApBkC,CAoB5BD,KApB4B,GAoBpBA,KApBoB,EAAA,CAAA,CAAA,EAAA,OAAA;SAqB1CC,MAAMD;iBACEA,SAASA"}

package/dist/channels/topic.d.ts

@@ -0,0 +1,32 @@
+import { BaseChannel } from "./base.js";
+
+//#region src/channels/topic.d.ts
+
+/**
+ * A configurable PubSub Topic.
+ */
+declare class Topic<Value> extends BaseChannel<Array<Value>, Value | Value[], [Value[], Value[]]> {
+  lc_graph_name: string;
+  unique: boolean;
+  accumulate: boolean;
+  seen: Set<Value>;
+  values: Value[];
+  constructor(fields?: {
+    /**
+     * Whether to only add unique values to the topic. If `true`, only unique values (using reference equality) will be added to the topic.
+     */
+    unique?: boolean;
+    /**
+     * Whether to accumulate values across steps. If `false`, the channel will be emptied after each step.
+     */
+    accumulate?: boolean;
+  });
+  fromCheckpoint(checkpoint?: [Value[], Value[]]): this;
+  update(values: Array<Value | Value[]>): boolean;
+  get(): Array<Value>;
+  checkpoint(): [Value[], Value[]];
+  isAvailable(): boolean;
+}
+//#endregion
+export { Topic };
+//# sourceMappingURL=topic.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"topic.d.ts","names":["BaseChannel","Topic","Value","Array","Set"],"sources":["../../src/channels/topic.d.ts"],"sourcesContent":["import { BaseChannel } from \"./base.js\";\n/**\n * A configurable PubSub Topic.\n */\nexport declare class Topic<Value> extends BaseChannel<Array<Value>, Value | Value[], [\n    Value[],\n    Value[]\n]> {\n    lc_graph_name: string;\n    unique: boolean;\n    accumulate: boolean;\n    seen: Set<Value>;\n    values: Value[];\n    constructor(fields?: {\n        /**\n         * Whether to only add unique values to the topic. If `true`, only unique values (using reference equality) will be added to the topic.\n         */\n        unique?: boolean;\n        /**\n         * Whether to accumulate values across steps. If `false`, the channel will be emptied after each step.\n         */\n        accumulate?: boolean;\n    });\n    fromCheckpoint(checkpoint?: [Value[], Value[]]): this;\n    update(values: Array<Value | Value[]>): boolean;\n    get(): Array<Value>;\n    checkpoint(): [Value[], Value[]];\n    isAvailable(): boolean;\n}\n"],"mappings":";;;;;;AAIA;AAA0B,cAALC,KAAK,CAAA,KAAA,CAAA,SAAgBD,WAAhB,CAA4BG,KAA5B,CAAkCD,KAAlC,CAAA,EAA0CA,KAA1C,GAAkDA,KAAlD,EAAA,EAAA,CACtBA,KADwDA,EAAAA,EAExDA,KAFkDC,EAAAA;eAAsBD,EAAAA,MAAAA;QACxEA,EAAAA,OAAAA;YACAA,EAAAA,OAAAA;MAKUA,EAAJE,GAAIF,CAAAA,KAAAA,CAAAA;QAAJE,EACEF,KADFE,EAAAA;aACEF,CAAAA,OAAAA,EAAAA;IAWqBA;;;IACAA,MAAAA,CAAAA,EAAAA,OAAAA;IAAdC;;;IAEAD,UAAAA,CAAAA,EAAAA,OAAAA;;gBAtBuBF,CAAAA,UAAAA,CAAAA,EAAAA,CAmBTE,KAnBSF,EAAAA,EAmBAE,KAnBAF,EAAAA,CAAAA,CAAAA,EAAAA,IAAAA;EAAW,MAAA,CAAA,MAAA,EAoBlCG,KApBkC,CAoB5BD,KApB4B,GAoBpBA,KApBoB,EAAA,CAAA,CAAA,EAAA,OAAA;SAqB1CC,MAAMD;iBACEA,SAASA"}

package/dist/channels/topic.js

@@ -0,0 +1,65 @@
+import { EmptyChannelError } from "../errors.js";
+import { BaseChannel } from "./base.js";
+
+//#region src/channels/topic.ts
+/**
+* A configurable PubSub Topic.
+*/
+var Topic = class Topic extends BaseChannel {
+	lc_graph_name = "Topic";
+	unique = false;
+	accumulate = false;
+	seen;
+	values;
+	constructor(fields) {
+		super();
+		this.unique = fields?.unique ?? this.unique;
+		this.accumulate = fields?.accumulate ?? this.accumulate;
+		this.seen = /* @__PURE__ */ new Set();
+		this.values = [];
+	}
+	fromCheckpoint(checkpoint) {
+		const empty = new Topic({
+			unique: this.unique,
+			accumulate: this.accumulate
+		});
+		if (typeof checkpoint !== "undefined") {
+			empty.seen = new Set(checkpoint[0]);
+			empty.values = checkpoint[1];
+		}
+		return empty;
+	}
+	update(values) {
+		let updated = false;
+		if (!this.accumulate) {
+			updated = this.values.length > 0;
+			this.values = [];
+		}
+		const flatValues = values.flat();
+		if (flatValues.length > 0) if (this.unique) {
+			for (const value of flatValues) if (!this.seen.has(value)) {
+				updated = true;
+				this.seen.add(value);
+				this.values.push(value);
+			}
+		} else {
+			updated = true;
+			this.values.push(...flatValues);
+		}
+		return updated;
+	}
+	get() {
+		if (this.values.length === 0) throw new EmptyChannelError();
+		return this.values;
+	}
+	checkpoint() {
+		return [[...this.seen], this.values];
+	}
+	isAvailable() {
+		return this.values.length !== 0;
+	}
+};
+
+//#endregion
+export { Topic };
+//# sourceMappingURL=topic.js.map

package/dist/channels/topic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"topic.js","names":[],"sources":["../../src/channels/topic.ts"],"sourcesContent":["import { EmptyChannelError } from \"../errors.js\";\nimport { BaseChannel } from \"./base.js\";\n\n/**\n * A configurable PubSub Topic.\n */\nexport class Topic<Value> extends BaseChannel<\n  Array<Value>,\n  Value | Value[],\n  [Value[], Value[]]\n> {\n  lc_graph_name = \"Topic\";\n\n  unique = false;\n\n  accumulate = false;\n\n  seen: Set<Value>;\n\n  values: Value[];\n\n  constructor(fields?: {\n    /**\n     * Whether to only add unique values to the topic. If `true`, only unique values (using reference equality) will be added to the topic.\n     */\n    unique?: boolean;\n    /**\n     * Whether to accumulate values across steps. If `false`, the channel will be emptied after each step.\n     */\n    accumulate?: boolean;\n  }) {\n    super();\n\n    this.unique = fields?.unique ?? this.unique;\n    this.accumulate = fields?.accumulate ?? this.accumulate;\n    // State\n    this.seen = new Set<Value>();\n    this.values = [];\n  }\n\n  public fromCheckpoint(checkpoint?: [Value[], Value[]]) {\n    const empty = new Topic<Value>({\n      unique: this.unique,\n      accumulate: this.accumulate,\n    });\n    if (typeof checkpoint !== \"undefined\") {\n      empty.seen = new Set(checkpoint[0]);\n      // eslint-disable-next-line prefer-destructuring\n      empty.values = checkpoint[1];\n    }\n    return empty as this;\n  }\n\n  public update(values: Array<Value | Value[]>): boolean {\n    let updated = false;\n    if (!this.accumulate) {\n      updated = this.values.length > 0;\n      this.values = [];\n    }\n    const flatValues = values.flat() as Value[];\n    if (flatValues.length > 0) {\n      if (this.unique) {\n        for (const value of flatValues) {\n          if (!this.seen.has(value)) {\n            updated = true;\n            this.seen.add(value);\n            this.values.push(value);\n          }\n        }\n      } else {\n        updated = true;\n        this.values.push(...flatValues);\n      }\n    }\n    return updated;\n  }\n\n  public get(): Array<Value> {\n    if (this.values.length === 0) {\n      throw new EmptyChannelError();\n    }\n    return this.values;\n  }\n\n  public checkpoint(): [Value[], Value[]] {\n    return [[...this.seen], this.values];\n  }\n\n  isAvailable(): boolean {\n    return this.values.length !== 0;\n  }\n}\n"],"mappings":";;;;;;;AAMA,IAAa,QAAb,MAAa,cAAqB,YAIhC;CACA,gBAAgB;CAEhB,SAAS;CAET,aAAa;CAEb;CAEA;CAEA,YAAY,QAST;AACD,SAAO;AAEP,OAAK,SAAS,QAAQ,UAAU,KAAK;AACrC,OAAK,aAAa,QAAQ,cAAc,KAAK;AAE7C,OAAK,uBAAO,IAAI,KAAY;AAC5B,OAAK,SAAS,EAAE;;CAGlB,AAAO,eAAe,YAAiC;EACrD,MAAM,QAAQ,IAAI,MAAa;GAC7B,QAAQ,KAAK;GACb,YAAY,KAAK;GAClB,CAAC;AACF,MAAI,OAAO,eAAe,aAAa;AACrC,SAAM,OAAO,IAAI,IAAI,WAAW,GAAG;AAEnC,SAAM,SAAS,WAAW;;AAE5B,SAAO;;CAGT,AAAO,OAAO,QAAyC;EACrD,IAAI,UAAU;AACd,MAAI,CAAC,KAAK,YAAY;AACpB,aAAU,KAAK,OAAO,SAAS;AAC/B,QAAK,SAAS,EAAE;;EAElB,MAAM,aAAa,OAAO,MAAM;AAChC,MAAI,WAAW,SAAS,EACtB,KAAI,KAAK,QACP;QAAK,MAAM,SAAS,WAClB,KAAI,CAAC,KAAK,KAAK,IAAI,MAAM,EAAE;AACzB,cAAU;AACV,SAAK,KAAK,IAAI,MAAM;AACpB,SAAK,OAAO,KAAK,MAAM;;SAGtB;AACL,aAAU;AACV,QAAK,OAAO,KAAK,GAAG,WAAW;;AAGnC,SAAO;;CAGT,AAAO,MAAoB;AACzB,MAAI,KAAK,OAAO,WAAW,EACzB,OAAM,IAAI,mBAAmB;AAE/B,SAAO,KAAK;;CAGd,AAAO,aAAiC;AACtC,SAAO,CAAC,CAAC,GAAG,KAAK,KAAK,EAAE,KAAK,OAAO;;CAGtC,cAAuB;AACrB,SAAO,KAAK,OAAO,WAAW"}