@langchain/langgraph 1.0.12 → 1.0.14

package/dist/pregel/utils/index.js

@@ -0,0 +1,96 @@
+import { CONFIG_KEY_CHECKPOINT_MAP, START } from "../../constants.js";
+
+//#region src/pregel/utils/index.ts
+function getNullChannelVersion(currentVersions) {
+	const startVersion = typeof currentVersions[START];
+	if (startVersion === "number") return 0;
+	if (startVersion === "string") return "";
+	for (const key in currentVersions) {
+		if (!Object.prototype.hasOwnProperty.call(currentVersions, key)) continue;
+		const versionType = typeof currentVersions[key];
+		if (versionType === "number") return 0;
+		if (versionType === "string") return "";
+		break;
+	}
+}
+function getNewChannelVersions(previousVersions, currentVersions) {
+	if (Object.keys(previousVersions).length > 0) {
+		const nullVersion = getNullChannelVersion(currentVersions);
+		return Object.fromEntries(Object.entries(currentVersions).filter(([k, v]) => v > (previousVersions[k] ?? nullVersion)));
+	} else return currentVersions;
+}
+function _coerceToDict(value, defaultKey) {
+	return value && !Array.isArray(value) && !(value instanceof Date) && typeof value === "object" ? value : { [defaultKey]: value };
+}
+function patchConfigurable(config, patch) {
+	if (config === null) return { configurable: patch };
+	else if (config?.configurable === void 0) return {
+		...config,
+		configurable: patch
+	};
+	else return {
+		...config,
+		configurable: {
+			...config.configurable,
+			...patch
+		}
+	};
+}
+function patchCheckpointMap(config, metadata) {
+	const parents = metadata?.parents ?? {};
+	if (Object.keys(parents).length > 0) return patchConfigurable(config, { [CONFIG_KEY_CHECKPOINT_MAP]: {
+		...parents,
+		[config.configurable?.checkpoint_ns ?? ""]: config.configurable?.checkpoint_id
+	} });
+	else return config;
+}
+/**
+* Combine multiple abort signals into a single abort signal.
+* @param signals - The abort signals to combine.
+* @returns A combined abort signal and a dispose function to remove the abort listener if unused.
+*/
+function combineAbortSignals(...x) {
+	const signals = [...new Set(x.filter(Boolean))];
+	if (signals.length === 0) return {
+		signal: void 0,
+		dispose: void 0
+	};
+	if (signals.length === 1) return {
+		signal: signals[0],
+		dispose: void 0
+	};
+	const combinedController = new AbortController();
+	const listener = () => {
+		const reason = signals.find((s) => s.aborted)?.reason;
+		combinedController.abort(reason);
+		signals.forEach((s) => s.removeEventListener("abort", listener));
+	};
+	signals.forEach((s) => s.addEventListener("abort", listener, { once: true }));
+	const hasAlreadyAbortedSignal = signals.find((s) => s.aborted);
+	if (hasAlreadyAbortedSignal) combinedController.abort(hasAlreadyAbortedSignal.reason);
+	return {
+		signal: combinedController.signal,
+		dispose: () => {
+			signals.forEach((s) => s.removeEventListener("abort", listener));
+		}
+	};
+}
+/**
+* Combine multiple callbacks into a single callback.
+* @param callback1 - The first callback to combine.
+* @param callback2 - The second callback to combine.
+* @returns A single callback that is a combination of the input callbacks.
+*/
+const combineCallbacks = (callback1, callback2) => {
+	if (!callback1 && !callback2) return;
+	if (!callback1) return callback2;
+	if (!callback2) return callback1;
+	if (Array.isArray(callback1) && Array.isArray(callback2)) return [...callback1, ...callback2];
+	if (Array.isArray(callback1)) return [...callback1, callback2];
+	if (Array.isArray(callback2)) return [callback1, ...callback2];
+	return [callback1, callback2];
+};
+
+//#endregion
+export { _coerceToDict, combineAbortSignals, combineCallbacks, getNewChannelVersions, getNullChannelVersion, patchCheckpointMap, patchConfigurable };
+//# sourceMappingURL=index.js.map

package/dist/pregel/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/pregel/utils/index.ts"],"sourcesContent":["import { Callbacks } from \"@langchain/core/callbacks/manager\";\nimport { RunnableConfig } from \"@langchain/core/runnables\";\nimport type {\n  ChannelVersions,\n  CheckpointMetadata,\n} from \"@langchain/langgraph-checkpoint\";\nimport { CONFIG_KEY_CHECKPOINT_MAP, START } from \"../../constants.js\";\n\nexport function getNullChannelVersion(currentVersions: ChannelVersions) {\n  // Short circuit for commonly used channels such as __start__\n  // (used by StateGraph)\n  const startVersion = typeof currentVersions[START];\n  if (startVersion === \"number\") return 0;\n  if (startVersion === \"string\") return \"\";\n\n  // Defer back to obtaining a first key from channel versions\n  for (const key in currentVersions) {\n    if (!Object.prototype.hasOwnProperty.call(currentVersions, key)) continue;\n    const versionType = typeof currentVersions[key];\n    if (versionType === \"number\") return 0;\n    if (versionType === \"string\") return \"\";\n    break;\n  }\n\n  return undefined;\n}\n\nexport function getNewChannelVersions(\n  previousVersions: ChannelVersions,\n  currentVersions: ChannelVersions\n): ChannelVersions {\n  // Get new channel versions\n  if (Object.keys(previousVersions).length > 0) {\n    const nullVersion = getNullChannelVersion(currentVersions);\n    return Object.fromEntries(\n      Object.entries(currentVersions).filter(\n        ([k, v]) => v > (previousVersions[k] ?? nullVersion)\n      )\n    );\n  } else {\n    return currentVersions;\n  }\n}\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function _coerceToDict(value: any, defaultKey: string) {\n  return value &&\n    !Array.isArray(value) &&\n    // eslint-disable-next-line no-instanceof/no-instanceof\n    !(value instanceof Date) &&\n    typeof value === \"object\"\n    ? value\n    : { [defaultKey]: value };\n}\n\nexport type RetryPolicy = {\n  /**\n   * Amount of time that must elapse before the first retry occurs in milliseconds.\n   * @default 500\n   */\n  initialInterval?: number;\n\n  /**\n   * Multiplier by which the interval increases after each retry.\n   * @default 2\n   */\n  backoffFactor?: number;\n\n  /**\n   * Maximum amount of time that may elapse between retries in milliseconds.\n   * @default 128000\n   */\n  maxInterval?: number;\n\n  /**\n   * Maximum amount of time that may elapse between retries.\n   * @default 3\n   */\n  maxAttempts?: number;\n\n  /** Whether to add random jitter to the interval between retries. */\n  jitter?: boolean;\n\n  /** A function that returns True for exceptions that should trigger a retry. */\n  retryOn?: (e: any) => boolean; // eslint-disable-line @typescript-eslint/no-explicit-any\n\n  /** Whether to log a warning when a retry is attempted. Defaults to true. */\n  logWarning?: boolean;\n};\n\n/**\n * Configuration for caching nodes.\n */\nexport type CachePolicy = {\n  /**\n   * A function used to generate a cache key from node's input.\n   * @returns A key for the cache.\n   */\n  keyFunc?: (args: unknown[]) => string;\n\n  /**\n   * The time to live for the cache in seconds.\n   * If not defined, the entry will never expire.\n   */\n  ttl?: number;\n};\n\nexport function patchConfigurable(\n  config: RunnableConfig | undefined,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  patch: Record<string, any>\n): RunnableConfig {\n  if (config === null) {\n    return { configurable: patch };\n  } else if (config?.configurable === undefined) {\n    return { ...config, configurable: patch };\n  } else {\n    return {\n      ...config,\n      configurable: { ...config.configurable, ...patch },\n    };\n  }\n}\n\nexport function patchCheckpointMap(\n  config: RunnableConfig,\n  metadata?: CheckpointMetadata\n): RunnableConfig {\n  const parents = metadata?.parents ?? {};\n\n  if (Object.keys(parents).length > 0) {\n    return patchConfigurable(config, {\n      [CONFIG_KEY_CHECKPOINT_MAP]: {\n        ...parents,\n        [config.configurable?.checkpoint_ns ?? \"\"]:\n          config.configurable?.checkpoint_id,\n      },\n    });\n  } else {\n    return config;\n  }\n}\n\n/**\n * Combine multiple abort signals into a single abort signal.\n * @param signals - The abort signals to combine.\n * @returns A combined abort signal and a dispose function to remove the abort listener if unused.\n */\nexport function combineAbortSignals(...x: (AbortSignal | undefined)[]): {\n  signal: AbortSignal | undefined;\n  dispose?: () => void;\n} {\n  const signals = [...new Set(x.filter(Boolean))] as AbortSignal[];\n\n  if (signals.length === 0) {\n    return { signal: undefined, dispose: undefined };\n  }\n\n  if (signals.length === 1) {\n    return { signal: signals[0], dispose: undefined };\n  }\n\n  const combinedController = new AbortController();\n  const listener = () => {\n    const reason = signals.find((s) => s.aborted)?.reason;\n    combinedController.abort(reason);\n    signals.forEach((s) => s.removeEventListener(\"abort\", listener));\n  };\n\n  signals.forEach((s) => s.addEventListener(\"abort\", listener, { once: true }));\n\n  const hasAlreadyAbortedSignal = signals.find((s) => s.aborted);\n  if (hasAlreadyAbortedSignal) {\n    combinedController.abort(hasAlreadyAbortedSignal.reason);\n  }\n\n  return {\n    signal: combinedController.signal,\n    dispose: () => {\n      signals.forEach((s) => s.removeEventListener(\"abort\", listener));\n    },\n  };\n}\n\n/**\n * Combine multiple callbacks into a single callback.\n * @param callback1 - The first callback to combine.\n * @param callback2 - The second callback to combine.\n * @returns A single callback that is a combination of the input callbacks.\n */\nexport const combineCallbacks = (\n  callback1?: Callbacks,\n  callback2?: Callbacks\n): Callbacks | undefined => {\n  if (!callback1 && !callback2) {\n    return undefined;\n  }\n\n  if (!callback1) {\n    return callback2;\n  }\n\n  if (!callback2) {\n    return callback1;\n  }\n  if (Array.isArray(callback1) && Array.isArray(callback2)) {\n    return [...callback1, ...callback2];\n  }\n  if (Array.isArray(callback1)) {\n    return [...callback1, callback2] as Callbacks;\n  }\n  if (Array.isArray(callback2)) {\n    return [callback1, ...callback2];\n  }\n  return [callback1, callback2] as Callbacks;\n};\n"],"mappings":";;;AAQA,SAAgB,sBAAsB,iBAAkC;CAGtE,MAAM,eAAe,OAAO,gBAAgB;AAC5C,KAAI,iBAAiB,SAAU,QAAO;AACtC,KAAI,iBAAiB,SAAU,QAAO;AAGtC,MAAK,MAAM,OAAO,iBAAiB;AACjC,MAAI,CAAC,OAAO,UAAU,eAAe,KAAK,iBAAiB,IAAI,CAAE;EACjE,MAAM,cAAc,OAAO,gBAAgB;AAC3C,MAAI,gBAAgB,SAAU,QAAO;AACrC,MAAI,gBAAgB,SAAU,QAAO;AACrC;;;AAMJ,SAAgB,sBACd,kBACA,iBACiB;AAEjB,KAAI,OAAO,KAAK,iBAAiB,CAAC,SAAS,GAAG;EAC5C,MAAM,cAAc,sBAAsB,gBAAgB;AAC1D,SAAO,OAAO,YACZ,OAAO,QAAQ,gBAAgB,CAAC,QAC7B,CAAC,GAAG,OAAO,KAAK,iBAAiB,MAAM,aACzC,CACF;OAED,QAAO;;AAKX,SAAgB,cAAc,OAAY,YAAoB;AAC5D,QAAO,SACL,CAAC,MAAM,QAAQ,MAAM,IAErB,EAAE,iBAAiB,SACnB,OAAO,UAAU,WACf,QACA,GAAG,aAAa,OAAO;;AAuD7B,SAAgB,kBACd,QAEA,OACgB;AAChB,KAAI,WAAW,KACb,QAAO,EAAE,cAAc,OAAO;UACrB,QAAQ,iBAAiB,OAClC,QAAO;EAAE,GAAG;EAAQ,cAAc;EAAO;KAEzC,QAAO;EACL,GAAG;EACH,cAAc;GAAE,GAAG,OAAO;GAAc,GAAG;GAAO;EACnD;;AAIL,SAAgB,mBACd,QACA,UACgB;CAChB,MAAM,UAAU,UAAU,WAAW,EAAE;AAEvC,KAAI,OAAO,KAAK,QAAQ,CAAC,SAAS,EAChC,QAAO,kBAAkB,QAAQ,GAC9B,4BAA4B;EAC3B,GAAG;GACF,OAAO,cAAc,iBAAiB,KACrC,OAAO,cAAc;EACxB,EACF,CAAC;KAEF,QAAO;;;;;;;AASX,SAAgB,oBAAoB,GAAG,GAGrC;CACA,MAAM,UAAU,CAAC,GAAG,IAAI,IAAI,EAAE,OAAO,QAAQ,CAAC,CAAC;AAE/C,KAAI,QAAQ,WAAW,EACrB,QAAO;EAAE,QAAQ;EAAW,SAAS;EAAW;AAGlD,KAAI,QAAQ,WAAW,EACrB,QAAO;EAAE,QAAQ,QAAQ;EAAI,SAAS;EAAW;CAGnD,MAAM,qBAAqB,IAAI,iBAAiB;CAChD,MAAM,iBAAiB;EACrB,MAAM,SAAS,QAAQ,MAAM,MAAM,EAAE,QAAQ,EAAE;AAC/C,qBAAmB,MAAM,OAAO;AAChC,UAAQ,SAAS,MAAM,EAAE,oBAAoB,SAAS,SAAS,CAAC;;AAGlE,SAAQ,SAAS,MAAM,EAAE,iBAAiB,SAAS,UAAU,EAAE,MAAM,MAAM,CAAC,CAAC;CAE7E,MAAM,0BAA0B,QAAQ,MAAM,MAAM,EAAE,QAAQ;AAC9D,KAAI,wBACF,oBAAmB,MAAM,wBAAwB,OAAO;AAG1D,QAAO;EACL,QAAQ,mBAAmB;EAC3B,eAAe;AACb,WAAQ,SAAS,MAAM,EAAE,oBAAoB,SAAS,SAAS,CAAC;;EAEnE;;;;;;;;AASH,MAAa,oBACX,WACA,cAC0B;AAC1B,KAAI,CAAC,aAAa,CAAC,UACjB;AAGF,KAAI,CAAC,UACH,QAAO;AAGT,KAAI,CAAC,UACH,QAAO;AAET,KAAI,MAAM,QAAQ,UAAU,IAAI,MAAM,QAAQ,UAAU,CACtD,QAAO,CAAC,GAAG,WAAW,GAAG,UAAU;AAErC,KAAI,MAAM,QAAQ,UAAU,CAC1B,QAAO,CAAC,GAAG,WAAW,UAAU;AAElC,KAAI,MAAM,QAAQ,UAAU,CAC1B,QAAO,CAAC,WAAW,GAAG,UAAU;AAElC,QAAO,CAAC,WAAW,UAAU"}

package/dist/pregel/utils/subgraph.cjs

@@ -0,0 +1,18 @@
+
+//#region src/pregel/utils/subgraph.ts
+function isRunnableSequence(x) {
+	return "steps" in x && Array.isArray(x.steps);
+}
+function isPregelLike(x) {
+	return "lg_is_pregel" in x && x.lg_is_pregel === true;
+}
+function findSubgraphPregel(candidate) {
+	const candidates = [candidate];
+	for (const candidate$1 of candidates) if (isPregelLike(candidate$1)) return candidate$1;
+	else if (isRunnableSequence(candidate$1)) candidates.push(...candidate$1.steps);
+}
+
+//#endregion
+exports.findSubgraphPregel = findSubgraphPregel;
+exports.isPregelLike = isPregelLike;
+//# sourceMappingURL=subgraph.cjs.map

package/dist/pregel/utils/subgraph.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"subgraph.cjs","names":["candidate"],"sources":["../../../src/pregel/utils/subgraph.ts"],"sourcesContent":["import {\n  RunnableSequence,\n  Runnable,\n  RunnableLike,\n} from \"@langchain/core/runnables\";\nimport type { PregelInterface } from \"../types.js\";\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nfunction isRunnableSequence(\n  x: RunnableSequence | Runnable\n): x is RunnableSequence {\n  return \"steps\" in x && Array.isArray(x.steps);\n}\n\nexport function isPregelLike(\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  x: PregelInterface<any, any> | RunnableLike<any, any, any>\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n): x is PregelInterface<any, any> {\n  return \"lg_is_pregel\" in x && x.lg_is_pregel === true;\n}\n\nexport function findSubgraphPregel(\n  candidate: Runnable\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n): PregelInterface<any, any> | undefined {\n  const candidates = [candidate];\n  for (const candidate of candidates) {\n    if (isPregelLike(candidate)) {\n      return candidate;\n    } else if (isRunnableSequence(candidate)) {\n      candidates.push(...candidate.steps);\n    }\n  }\n  return undefined;\n}\n"],"mappings":";;AAQA,SAAS,mBACP,GACuB;AACvB,QAAO,WAAW,KAAK,MAAM,QAAQ,EAAE,MAAM;;AAG/C,SAAgB,aAEd,GAEgC;AAChC,QAAO,kBAAkB,KAAK,EAAE,iBAAiB;;AAGnD,SAAgB,mBACd,WAEuC;CACvC,MAAM,aAAa,CAAC,UAAU;AAC9B,MAAK,MAAMA,eAAa,WACtB,KAAI,aAAaA,YAAU,CACzB,QAAOA;UACE,mBAAmBA,YAAU,CACtC,YAAW,KAAK,GAAGA,YAAU,MAAM"}

package/dist/pregel/utils/subgraph.js

@@ -0,0 +1,16 @@
+//#region src/pregel/utils/subgraph.ts
+function isRunnableSequence(x) {
+	return "steps" in x && Array.isArray(x.steps);
+}
+function isPregelLike(x) {
+	return "lg_is_pregel" in x && x.lg_is_pregel === true;
+}
+function findSubgraphPregel(candidate) {
+	const candidates = [candidate];
+	for (const candidate$1 of candidates) if (isPregelLike(candidate$1)) return candidate$1;
+	else if (isRunnableSequence(candidate$1)) candidates.push(...candidate$1.steps);
+}
+
+//#endregion
+export { findSubgraphPregel, isPregelLike };
+//# sourceMappingURL=subgraph.js.map

package/dist/pregel/utils/subgraph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subgraph.js","names":["candidate"],"sources":["../../../src/pregel/utils/subgraph.ts"],"sourcesContent":["import {\n  RunnableSequence,\n  Runnable,\n  RunnableLike,\n} from \"@langchain/core/runnables\";\nimport type { PregelInterface } from \"../types.js\";\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nfunction isRunnableSequence(\n  x: RunnableSequence | Runnable\n): x is RunnableSequence {\n  return \"steps\" in x && Array.isArray(x.steps);\n}\n\nexport function isPregelLike(\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  x: PregelInterface<any, any> | RunnableLike<any, any, any>\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n): x is PregelInterface<any, any> {\n  return \"lg_is_pregel\" in x && x.lg_is_pregel === true;\n}\n\nexport function findSubgraphPregel(\n  candidate: Runnable\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n): PregelInterface<any, any> | undefined {\n  const candidates = [candidate];\n  for (const candidate of candidates) {\n    if (isPregelLike(candidate)) {\n      return candidate;\n    } else if (isRunnableSequence(candidate)) {\n      candidates.push(...candidate.steps);\n    }\n  }\n  return undefined;\n}\n"],"mappings":";AAQA,SAAS,mBACP,GACuB;AACvB,QAAO,WAAW,KAAK,MAAM,QAAQ,EAAE,MAAM;;AAG/C,SAAgB,aAEd,GAEgC;AAChC,QAAO,kBAAkB,KAAK,EAAE,iBAAiB;;AAGnD,SAAgB,mBACd,WAEuC;CACvC,MAAM,aAAa,CAAC,UAAU;AAC9B,MAAK,MAAMA,eAAa,WACtB,KAAI,aAAaA,YAAU,CACzB,QAAOA;UACE,mBAAmBA,YAAU,CACtC,YAAW,KAAK,GAAGA,YAAU,MAAM"}

package/dist/pregel/validate.cjs

@@ -0,0 +1,45 @@
+const require_constants = require('../constants.cjs');
+const require_read = require('./read.cjs');
+
+//#region src/pregel/validate.ts
+var GraphValidationError = class extends Error {
+	constructor(message) {
+		super(message);
+		this.name = "GraphValidationError";
+	}
+};
+function validateGraph({ nodes, channels, inputChannels, outputChannels, streamChannels, interruptAfterNodes, interruptBeforeNodes }) {
+	if (!channels) throw new GraphValidationError("Channels not provided");
+	const subscribedChannels = /* @__PURE__ */ new Set();
+	const allOutputChannels = /* @__PURE__ */ new Set();
+	for (const [name, node] of Object.entries(nodes)) {
+		if (name === require_constants.INTERRUPT) throw new GraphValidationError(`"Node name ${require_constants.INTERRUPT} is reserved"`);
+		if (node.constructor === require_read.PregelNode) node.triggers.forEach((trigger) => subscribedChannels.add(trigger));
+		else throw new GraphValidationError(`Invalid node type ${typeof node}, expected PregelNode`);
+	}
+	for (const chan of subscribedChannels) if (!(chan in channels)) throw new GraphValidationError(`Subscribed channel '${String(chan)}' not in channels`);
+	if (!Array.isArray(inputChannels)) {
+		if (!subscribedChannels.has(inputChannels)) throw new GraphValidationError(`Input channel ${String(inputChannels)} is not subscribed to by any node`);
+	} else if (inputChannels.every((channel) => !subscribedChannels.has(channel))) throw new GraphValidationError(`None of the input channels ${inputChannels} are subscribed to by any node`);
+	if (!Array.isArray(outputChannels)) allOutputChannels.add(outputChannels);
+	else outputChannels.forEach((chan) => allOutputChannels.add(chan));
+	if (streamChannels && !Array.isArray(streamChannels)) allOutputChannels.add(streamChannels);
+	else if (Array.isArray(streamChannels)) streamChannels.forEach((chan) => allOutputChannels.add(chan));
+	for (const chan of allOutputChannels) if (!(chan in channels)) throw new GraphValidationError(`Output channel '${String(chan)}' not in channels`);
+	if (interruptAfterNodes && interruptAfterNodes !== "*") {
+		for (const node of interruptAfterNodes) if (!(node in nodes)) throw new GraphValidationError(`Node ${String(node)} not in nodes`);
+	}
+	if (interruptBeforeNodes && interruptBeforeNodes !== "*") {
+		for (const node of interruptBeforeNodes) if (!(node in nodes)) throw new GraphValidationError(`Node ${String(node)} not in nodes`);
+	}
+}
+function validateKeys(keys, channels) {
+	if (Array.isArray(keys)) {
+		for (const key of keys) if (!(key in channels)) throw new Error(`Key ${String(key)} not found in channels`);
+	} else if (!(keys in channels)) throw new Error(`Key ${String(keys)} not found in channels`);
+}
+
+//#endregion
+exports.validateGraph = validateGraph;
+exports.validateKeys = validateKeys;
+//# sourceMappingURL=validate.cjs.map

package/dist/pregel/validate.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.cjs","names":["INTERRUPT","PregelNode"],"sources":["../../src/pregel/validate.ts"],"sourcesContent":["import { All } from \"@langchain/langgraph-checkpoint\";\nimport { BaseChannel } from \"../channels/index.js\";\nimport { INTERRUPT } from \"../constants.js\";\nimport { PregelNode } from \"./read.js\";\n\nexport class GraphValidationError extends Error {\n  constructor(message?: string) {\n    super(message);\n    this.name = \"GraphValidationError\";\n  }\n}\n\nexport function validateGraph<\n  Nn extends Record<string, PregelNode>,\n  Cc extends Record<string, BaseChannel>\n>({\n  nodes,\n  channels,\n  inputChannels,\n  outputChannels,\n  streamChannels,\n  interruptAfterNodes,\n  interruptBeforeNodes,\n}: {\n  nodes: Nn;\n  channels: Cc;\n  inputChannels: keyof Cc | Array<keyof Cc>;\n  outputChannels: keyof Cc | Array<keyof Cc>;\n  streamChannels?: keyof Cc | Array<keyof Cc>;\n  interruptAfterNodes?: Array<keyof Nn> | All;\n  interruptBeforeNodes?: Array<keyof Nn> | All;\n}): void {\n  if (!channels) {\n    throw new GraphValidationError(\"Channels not provided\");\n  }\n\n  const subscribedChannels = new Set<keyof Cc>();\n  const allOutputChannels = new Set<keyof Cc>();\n\n  for (const [name, node] of Object.entries(nodes)) {\n    if (name === INTERRUPT) {\n      throw new GraphValidationError(`\"Node name ${INTERRUPT} is reserved\"`);\n    }\n    if (node.constructor === PregelNode) {\n      node.triggers.forEach((trigger) => subscribedChannels.add(trigger));\n    } else {\n      throw new GraphValidationError(\n        `Invalid node type ${typeof node}, expected PregelNode`\n      );\n    }\n  }\n\n  // side effect: update channels\n  for (const chan of subscribedChannels) {\n    if (!(chan in channels)) {\n      throw new GraphValidationError(\n        `Subscribed channel '${String(chan)}' not in channels`\n      );\n    }\n  }\n\n  if (!Array.isArray(inputChannels)) {\n    if (!subscribedChannels.has(inputChannels)) {\n      throw new GraphValidationError(\n        `Input channel ${String(\n          inputChannels\n        )} is not subscribed to by any node`\n      );\n    }\n  } else {\n    if (inputChannels.every((channel) => !subscribedChannels.has(channel))) {\n      throw new GraphValidationError(\n        `None of the input channels ${inputChannels} are subscribed to by any node`\n      );\n    }\n  }\n\n  if (!Array.isArray(outputChannels)) {\n    allOutputChannels.add(outputChannels);\n  } else {\n    outputChannels.forEach((chan) => allOutputChannels.add(chan));\n  }\n\n  if (streamChannels && !Array.isArray(streamChannels)) {\n    allOutputChannels.add(streamChannels);\n  } else if (Array.isArray(streamChannels)) {\n    streamChannels.forEach((chan) => allOutputChannels.add(chan));\n  }\n\n  for (const chan of allOutputChannels) {\n    if (!(chan in channels)) {\n      throw new GraphValidationError(\n        `Output channel '${String(chan)}' not in channels`\n      );\n    }\n  }\n\n  // validate interrupt before/after\n  if (interruptAfterNodes && interruptAfterNodes !== \"*\") {\n    for (const node of interruptAfterNodes) {\n      if (!(node in nodes)) {\n        throw new GraphValidationError(`Node ${String(node)} not in nodes`);\n      }\n    }\n  }\n\n  if (interruptBeforeNodes && interruptBeforeNodes !== \"*\") {\n    for (const node of interruptBeforeNodes) {\n      if (!(node in nodes)) {\n        throw new GraphValidationError(`Node ${String(node)} not in nodes`);\n      }\n    }\n  }\n}\n\nexport function validateKeys<Cc extends Record<string, BaseChannel>>(\n  keys: keyof Cc | Array<keyof Cc>,\n  channels: Cc\n): void {\n  if (Array.isArray(keys)) {\n    for (const key of keys) {\n      if (!(key in channels)) {\n        throw new Error(`Key ${String(key)} not found in channels`);\n      }\n    }\n  } else {\n    if (!(keys in channels)) {\n      throw new Error(`Key ${String(keys)} not found in channels`);\n    }\n  }\n}\n"],"mappings":";;;;AAKA,IAAa,uBAAb,cAA0C,MAAM;CAC9C,YAAY,SAAkB;AAC5B,QAAM,QAAQ;AACd,OAAK,OAAO;;;AAIhB,SAAgB,cAGd,EACA,OACA,UACA,eACA,gBACA,gBACA,qBACA,wBASO;AACP,KAAI,CAAC,SACH,OAAM,IAAI,qBAAqB,wBAAwB;CAGzD,MAAM,qCAAqB,IAAI,KAAe;CAC9C,MAAM,oCAAoB,IAAI,KAAe;AAE7C,MAAK,MAAM,CAAC,MAAM,SAAS,OAAO,QAAQ,MAAM,EAAE;AAChD,MAAI,SAASA,4BACX,OAAM,IAAI,qBAAqB,cAAcA,4BAAU,eAAe;AAExE,MAAI,KAAK,gBAAgBC,wBACvB,MAAK,SAAS,SAAS,YAAY,mBAAmB,IAAI,QAAQ,CAAC;MAEnE,OAAM,IAAI,qBACR,qBAAqB,OAAO,KAAK,uBAClC;;AAKL,MAAK,MAAM,QAAQ,mBACjB,KAAI,EAAE,QAAQ,UACZ,OAAM,IAAI,qBACR,uBAAuB,OAAO,KAAK,CAAC,mBACrC;AAIL,KAAI,CAAC,MAAM,QAAQ,cAAc,EAC/B;MAAI,CAAC,mBAAmB,IAAI,cAAc,CACxC,OAAM,IAAI,qBACR,iBAAiB,OACf,cACD,CAAC,mCACH;YAGC,cAAc,OAAO,YAAY,CAAC,mBAAmB,IAAI,QAAQ,CAAC,CACpE,OAAM,IAAI,qBACR,8BAA8B,cAAc,gCAC7C;AAIL,KAAI,CAAC,MAAM,QAAQ,eAAe,CAChC,mBAAkB,IAAI,eAAe;KAErC,gBAAe,SAAS,SAAS,kBAAkB,IAAI,KAAK,CAAC;AAG/D,KAAI,kBAAkB,CAAC,MAAM,QAAQ,eAAe,CAClD,mBAAkB,IAAI,eAAe;UAC5B,MAAM,QAAQ,eAAe,CACtC,gBAAe,SAAS,SAAS,kBAAkB,IAAI,KAAK,CAAC;AAG/D,MAAK,MAAM,QAAQ,kBACjB,KAAI,EAAE,QAAQ,UACZ,OAAM,IAAI,qBACR,mBAAmB,OAAO,KAAK,CAAC,mBACjC;AAKL,KAAI,uBAAuB,wBAAwB,KACjD;OAAK,MAAM,QAAQ,oBACjB,KAAI,EAAE,QAAQ,OACZ,OAAM,IAAI,qBAAqB,QAAQ,OAAO,KAAK,CAAC,eAAe;;AAKzE,KAAI,wBAAwB,yBAAyB,KACnD;OAAK,MAAM,QAAQ,qBACjB,KAAI,EAAE,QAAQ,OACZ,OAAM,IAAI,qBAAqB,QAAQ,OAAO,KAAK,CAAC,eAAe;;;AAM3E,SAAgB,aACd,MACA,UACM;AACN,KAAI,MAAM,QAAQ,KAAK,EACrB;OAAK,MAAM,OAAO,KAChB,KAAI,EAAE,OAAO,UACX,OAAM,IAAI,MAAM,OAAO,OAAO,IAAI,CAAC,wBAAwB;YAI3D,EAAE,QAAQ,UACZ,OAAM,IAAI,MAAM,OAAO,OAAO,KAAK,CAAC,wBAAwB"}

package/dist/pregel/validate.js

@@ -0,0 +1,44 @@
+import { INTERRUPT } from "../constants.js";
+import { PregelNode } from "./read.js";
+
+//#region src/pregel/validate.ts
+var GraphValidationError = class extends Error {
+	constructor(message) {
+		super(message);
+		this.name = "GraphValidationError";
+	}
+};
+function validateGraph({ nodes, channels, inputChannels, outputChannels, streamChannels, interruptAfterNodes, interruptBeforeNodes }) {
+	if (!channels) throw new GraphValidationError("Channels not provided");
+	const subscribedChannels = /* @__PURE__ */ new Set();
+	const allOutputChannels = /* @__PURE__ */ new Set();
+	for (const [name, node] of Object.entries(nodes)) {
+		if (name === INTERRUPT) throw new GraphValidationError(`"Node name ${INTERRUPT} is reserved"`);
+		if (node.constructor === PregelNode) node.triggers.forEach((trigger) => subscribedChannels.add(trigger));
+		else throw new GraphValidationError(`Invalid node type ${typeof node}, expected PregelNode`);
+	}
+	for (const chan of subscribedChannels) if (!(chan in channels)) throw new GraphValidationError(`Subscribed channel '${String(chan)}' not in channels`);
+	if (!Array.isArray(inputChannels)) {
+		if (!subscribedChannels.has(inputChannels)) throw new GraphValidationError(`Input channel ${String(inputChannels)} is not subscribed to by any node`);
+	} else if (inputChannels.every((channel) => !subscribedChannels.has(channel))) throw new GraphValidationError(`None of the input channels ${inputChannels} are subscribed to by any node`);
+	if (!Array.isArray(outputChannels)) allOutputChannels.add(outputChannels);
+	else outputChannels.forEach((chan) => allOutputChannels.add(chan));
+	if (streamChannels && !Array.isArray(streamChannels)) allOutputChannels.add(streamChannels);
+	else if (Array.isArray(streamChannels)) streamChannels.forEach((chan) => allOutputChannels.add(chan));
+	for (const chan of allOutputChannels) if (!(chan in channels)) throw new GraphValidationError(`Output channel '${String(chan)}' not in channels`);
+	if (interruptAfterNodes && interruptAfterNodes !== "*") {
+		for (const node of interruptAfterNodes) if (!(node in nodes)) throw new GraphValidationError(`Node ${String(node)} not in nodes`);
+	}
+	if (interruptBeforeNodes && interruptBeforeNodes !== "*") {
+		for (const node of interruptBeforeNodes) if (!(node in nodes)) throw new GraphValidationError(`Node ${String(node)} not in nodes`);
+	}
+}
+function validateKeys(keys, channels) {
+	if (Array.isArray(keys)) {
+		for (const key of keys) if (!(key in channels)) throw new Error(`Key ${String(key)} not found in channels`);
+	} else if (!(keys in channels)) throw new Error(`Key ${String(keys)} not found in channels`);
+}
+
+//#endregion
+export { validateGraph, validateKeys };
+//# sourceMappingURL=validate.js.map

package/dist/pregel/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","names":[],"sources":["../../src/pregel/validate.ts"],"sourcesContent":["import { All } from \"@langchain/langgraph-checkpoint\";\nimport { BaseChannel } from \"../channels/index.js\";\nimport { INTERRUPT } from \"../constants.js\";\nimport { PregelNode } from \"./read.js\";\n\nexport class GraphValidationError extends Error {\n  constructor(message?: string) {\n    super(message);\n    this.name = \"GraphValidationError\";\n  }\n}\n\nexport function validateGraph<\n  Nn extends Record<string, PregelNode>,\n  Cc extends Record<string, BaseChannel>\n>({\n  nodes,\n  channels,\n  inputChannels,\n  outputChannels,\n  streamChannels,\n  interruptAfterNodes,\n  interruptBeforeNodes,\n}: {\n  nodes: Nn;\n  channels: Cc;\n  inputChannels: keyof Cc | Array<keyof Cc>;\n  outputChannels: keyof Cc | Array<keyof Cc>;\n  streamChannels?: keyof Cc | Array<keyof Cc>;\n  interruptAfterNodes?: Array<keyof Nn> | All;\n  interruptBeforeNodes?: Array<keyof Nn> | All;\n}): void {\n  if (!channels) {\n    throw new GraphValidationError(\"Channels not provided\");\n  }\n\n  const subscribedChannels = new Set<keyof Cc>();\n  const allOutputChannels = new Set<keyof Cc>();\n\n  for (const [name, node] of Object.entries(nodes)) {\n    if (name === INTERRUPT) {\n      throw new GraphValidationError(`\"Node name ${INTERRUPT} is reserved\"`);\n    }\n    if (node.constructor === PregelNode) {\n      node.triggers.forEach((trigger) => subscribedChannels.add(trigger));\n    } else {\n      throw new GraphValidationError(\n        `Invalid node type ${typeof node}, expected PregelNode`\n      );\n    }\n  }\n\n  // side effect: update channels\n  for (const chan of subscribedChannels) {\n    if (!(chan in channels)) {\n      throw new GraphValidationError(\n        `Subscribed channel '${String(chan)}' not in channels`\n      );\n    }\n  }\n\n  if (!Array.isArray(inputChannels)) {\n    if (!subscribedChannels.has(inputChannels)) {\n      throw new GraphValidationError(\n        `Input channel ${String(\n          inputChannels\n        )} is not subscribed to by any node`\n      );\n    }\n  } else {\n    if (inputChannels.every((channel) => !subscribedChannels.has(channel))) {\n      throw new GraphValidationError(\n        `None of the input channels ${inputChannels} are subscribed to by any node`\n      );\n    }\n  }\n\n  if (!Array.isArray(outputChannels)) {\n    allOutputChannels.add(outputChannels);\n  } else {\n    outputChannels.forEach((chan) => allOutputChannels.add(chan));\n  }\n\n  if (streamChannels && !Array.isArray(streamChannels)) {\n    allOutputChannels.add(streamChannels);\n  } else if (Array.isArray(streamChannels)) {\n    streamChannels.forEach((chan) => allOutputChannels.add(chan));\n  }\n\n  for (const chan of allOutputChannels) {\n    if (!(chan in channels)) {\n      throw new GraphValidationError(\n        `Output channel '${String(chan)}' not in channels`\n      );\n    }\n  }\n\n  // validate interrupt before/after\n  if (interruptAfterNodes && interruptAfterNodes !== \"*\") {\n    for (const node of interruptAfterNodes) {\n      if (!(node in nodes)) {\n        throw new GraphValidationError(`Node ${String(node)} not in nodes`);\n      }\n    }\n  }\n\n  if (interruptBeforeNodes && interruptBeforeNodes !== \"*\") {\n    for (const node of interruptBeforeNodes) {\n      if (!(node in nodes)) {\n        throw new GraphValidationError(`Node ${String(node)} not in nodes`);\n      }\n    }\n  }\n}\n\nexport function validateKeys<Cc extends Record<string, BaseChannel>>(\n  keys: keyof Cc | Array<keyof Cc>,\n  channels: Cc\n): void {\n  if (Array.isArray(keys)) {\n    for (const key of keys) {\n      if (!(key in channels)) {\n        throw new Error(`Key ${String(key)} not found in channels`);\n      }\n    }\n  } else {\n    if (!(keys in channels)) {\n      throw new Error(`Key ${String(keys)} not found in channels`);\n    }\n  }\n}\n"],"mappings":";;;;AAKA,IAAa,uBAAb,cAA0C,MAAM;CAC9C,YAAY,SAAkB;AAC5B,QAAM,QAAQ;AACd,OAAK,OAAO;;;AAIhB,SAAgB,cAGd,EACA,OACA,UACA,eACA,gBACA,gBACA,qBACA,wBASO;AACP,KAAI,CAAC,SACH,OAAM,IAAI,qBAAqB,wBAAwB;CAGzD,MAAM,qCAAqB,IAAI,KAAe;CAC9C,MAAM,oCAAoB,IAAI,KAAe;AAE7C,MAAK,MAAM,CAAC,MAAM,SAAS,OAAO,QAAQ,MAAM,EAAE;AAChD,MAAI,SAAS,UACX,OAAM,IAAI,qBAAqB,cAAc,UAAU,eAAe;AAExE,MAAI,KAAK,gBAAgB,WACvB,MAAK,SAAS,SAAS,YAAY,mBAAmB,IAAI,QAAQ,CAAC;MAEnE,OAAM,IAAI,qBACR,qBAAqB,OAAO,KAAK,uBAClC;;AAKL,MAAK,MAAM,QAAQ,mBACjB,KAAI,EAAE,QAAQ,UACZ,OAAM,IAAI,qBACR,uBAAuB,OAAO,KAAK,CAAC,mBACrC;AAIL,KAAI,CAAC,MAAM,QAAQ,cAAc,EAC/B;MAAI,CAAC,mBAAmB,IAAI,cAAc,CACxC,OAAM,IAAI,qBACR,iBAAiB,OACf,cACD,CAAC,mCACH;YAGC,cAAc,OAAO,YAAY,CAAC,mBAAmB,IAAI,QAAQ,CAAC,CACpE,OAAM,IAAI,qBACR,8BAA8B,cAAc,gCAC7C;AAIL,KAAI,CAAC,MAAM,QAAQ,eAAe,CAChC,mBAAkB,IAAI,eAAe;KAErC,gBAAe,SAAS,SAAS,kBAAkB,IAAI,KAAK,CAAC;AAG/D,KAAI,kBAAkB,CAAC,MAAM,QAAQ,eAAe,CAClD,mBAAkB,IAAI,eAAe;UAC5B,MAAM,QAAQ,eAAe,CACtC,gBAAe,SAAS,SAAS,kBAAkB,IAAI,KAAK,CAAC;AAG/D,MAAK,MAAM,QAAQ,kBACjB,KAAI,EAAE,QAAQ,UACZ,OAAM,IAAI,qBACR,mBAAmB,OAAO,KAAK,CAAC,mBACjC;AAKL,KAAI,uBAAuB,wBAAwB,KACjD;OAAK,MAAM,QAAQ,oBACjB,KAAI,EAAE,QAAQ,OACZ,OAAM,IAAI,qBAAqB,QAAQ,OAAO,KAAK,CAAC,eAAe;;AAKzE,KAAI,wBAAwB,yBAAyB,KACnD;OAAK,MAAM,QAAQ,qBACjB,KAAI,EAAE,QAAQ,OACZ,OAAM,IAAI,qBAAqB,QAAQ,OAAO,KAAK,CAAC,eAAe;;;AAM3E,SAAgB,aACd,MACA,UACM;AACN,KAAI,MAAM,QAAQ,KAAK,EACrB;OAAK,MAAM,OAAO,KAChB,KAAI,EAAE,OAAO,UACX,OAAM,IAAI,MAAM,OAAO,OAAO,IAAI,CAAC,wBAAwB;YAI3D,EAAE,QAAQ,UACZ,OAAM,IAAI,MAAM,OAAO,OAAO,KAAK,CAAC,wBAAwB"}

package/dist/pregel/write.cjs

@@ -0,0 +1,96 @@
+const require_errors = require('../errors.cjs');
+const require_constants = require('../constants.cjs');
+const require_utils = require('../utils.cjs');
+let _langchain_core_runnables = require("@langchain/core/runnables");
+
+//#region src/pregel/write.ts
+const SKIP_WRITE = { [Symbol.for("LG_SKIP_WRITE")]: true };
+function _isSkipWrite(x) {
+	return typeof x === "object" && x?.[Symbol.for("LG_SKIP_WRITE")] !== void 0;
+}
+const PASSTHROUGH = { [Symbol.for("LG_PASSTHROUGH")]: true };
+function _isPassthrough(x) {
+	return typeof x === "object" && x?.[Symbol.for("LG_PASSTHROUGH")] !== void 0;
+}
+const IS_WRITER = Symbol("IS_WRITER");
+/**
+* Mapping of write channels to Runnables that return the value to be written,
+* or None to skip writing.
+*/
+var ChannelWrite = class ChannelWrite extends require_utils.RunnableCallable {
+	writes;
+	constructor(writes, tags) {
+		const name = `ChannelWrite<${writes.map((packet) => {
+			if (require_constants._isSend(packet)) return packet.node;
+			else if ("channel" in packet) return packet.channel;
+			return "...";
+		}).join(",")}>`;
+		super({
+			writes,
+			name,
+			tags,
+			func: async (input, config) => {
+				return this._write(input, config ?? {});
+			}
+		});
+		this.writes = writes;
+	}
+	async _write(input, config) {
+		const writes = this.writes.map((write) => {
+			if (_isChannelWriteTupleEntry(write) && _isPassthrough(write.value)) return {
+				mapper: write.mapper,
+				value: input
+			};
+			else if (_isChannelWriteEntry(write) && _isPassthrough(write.value)) return {
+				channel: write.channel,
+				value: input,
+				skipNone: write.skipNone,
+				mapper: write.mapper
+			};
+			else return write;
+		});
+		await ChannelWrite.doWrite(config, writes);
+		return input;
+	}
+	static async doWrite(config, writes) {
+		for (const w of writes) {
+			if (_isChannelWriteEntry(w)) {
+				if (w.channel === require_constants.TASKS) throw new require_errors.InvalidUpdateError("Cannot write to the reserved channel TASKS");
+				if (_isPassthrough(w.value)) throw new require_errors.InvalidUpdateError("PASSTHROUGH value must be replaced");
+			}
+			if (_isChannelWriteTupleEntry(w)) {
+				if (_isPassthrough(w.value)) throw new require_errors.InvalidUpdateError("PASSTHROUGH value must be replaced");
+			}
+		}
+		const writeEntries = [];
+		for (const w of writes) if (require_constants._isSend(w)) writeEntries.push([require_constants.TASKS, w]);
+		else if (_isChannelWriteTupleEntry(w)) {
+			const mappedResult = await w.mapper.invoke(w.value, config);
+			if (mappedResult != null && mappedResult.length > 0) writeEntries.push(...mappedResult);
+		} else if (_isChannelWriteEntry(w)) {
+			const mappedValue = w.mapper !== void 0 ? await w.mapper.invoke(w.value, config) : w.value;
+			if (_isSkipWrite(mappedValue)) continue;
+			if (w.skipNone && mappedValue === void 0) continue;
+			writeEntries.push([w.channel, mappedValue]);
+		} else throw new Error(`Invalid write entry: ${JSON.stringify(w)}`);
+		const write = config.configurable?.[require_constants.CONFIG_KEY_SEND];
+		write(writeEntries);
+	}
+	static isWriter(runnable) {
+		return runnable instanceof ChannelWrite || IS_WRITER in runnable && !!runnable[IS_WRITER];
+	}
+	static registerWriter(runnable) {
+		return Object.defineProperty(runnable, IS_WRITER, { value: true });
+	}
+};
+function _isChannelWriteEntry(x) {
+	return x !== void 0 && typeof x.channel === "string";
+}
+function _isChannelWriteTupleEntry(x) {
+	return x !== void 0 && !_isChannelWriteEntry(x) && _langchain_core_runnables.Runnable.isRunnable(x.mapper);
+}
+
+//#endregion
+exports.ChannelWrite = ChannelWrite;
+exports.PASSTHROUGH = PASSTHROUGH;
+//# sourceMappingURL=write.cjs.map

package/dist/pregel/write.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.cjs","names":["RunnableCallable","_isSend","TASKS","InvalidUpdateError","CONFIG_KEY_SEND","Runnable"],"sources":["../../src/pregel/write.ts"],"sourcesContent":["import {\n  Runnable,\n  RunnableConfig,\n  RunnableLike,\n} from \"@langchain/core/runnables\";\nimport { _isSend, CONFIG_KEY_SEND, Send, TASKS } from \"../constants.js\";\nimport { RunnableCallable } from \"../utils.js\";\nimport { InvalidUpdateError } from \"../errors.js\";\n\ntype TYPE_SEND = (values: Array<[string, unknown]>) => void;\n\nexport const SKIP_WRITE = {\n  [Symbol.for(\"LG_SKIP_WRITE\")]: true,\n};\n\nfunction _isSkipWrite(x: unknown) {\n  return (\n    typeof x === \"object\" &&\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    (x as any)?.[Symbol.for(\"LG_SKIP_WRITE\")] !== undefined\n  );\n}\n\nexport const PASSTHROUGH = {\n  [Symbol.for(\"LG_PASSTHROUGH\")]: true,\n};\n\nfunction _isPassthrough(x: unknown) {\n  return (\n    typeof x === \"object\" &&\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    (x as any)?.[Symbol.for(\"LG_PASSTHROUGH\")] !== undefined\n  );\n}\n\nconst IS_WRITER = Symbol(\"IS_WRITER\");\n\n/**\n * Mapping of write channels to Runnables that return the value to be written,\n * or None to skip writing.\n */\nexport class ChannelWrite<\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  RunInput = any\n> extends RunnableCallable<RunInput, RunInput> {\n  writes: Array<ChannelWriteEntry | ChannelWriteTupleEntry | Send>;\n\n  constructor(\n    writes: Array<ChannelWriteEntry | ChannelWriteTupleEntry | Send>,\n    tags?: string[]\n  ) {\n    const name = `ChannelWrite<${writes\n      .map((packet) => {\n        if (_isSend(packet)) {\n          return packet.node;\n        } else if (\"channel\" in packet) {\n          return packet.channel;\n        }\n        return \"...\";\n      })\n      .join(\",\")}>`;\n    super({\n      ...{ writes, name, tags },\n      func: async (input: RunInput, config?: RunnableConfig) => {\n        return this._write(input, config ?? {});\n      },\n    });\n\n    this.writes = writes;\n  }\n\n  async _write(input: unknown, config: RunnableConfig): Promise<unknown> {\n    const writes = this.writes.map((write) => {\n      if (_isChannelWriteTupleEntry(write) && _isPassthrough(write.value)) {\n        return {\n          mapper: write.mapper,\n          value: input,\n        };\n      } else if (_isChannelWriteEntry(write) && _isPassthrough(write.value)) {\n        return {\n          channel: write.channel,\n          value: input,\n          skipNone: write.skipNone,\n          mapper: write.mapper,\n        };\n      } else {\n        return write;\n      }\n    });\n    await ChannelWrite.doWrite(config, writes);\n    return input;\n  }\n\n  // TODO: Support requireAtLeastOneOf\n  static async doWrite(\n    config: RunnableConfig,\n    writes: (ChannelWriteEntry | ChannelWriteTupleEntry | Send)[]\n  ): Promise<void> {\n    // validate\n    for (const w of writes) {\n      if (_isChannelWriteEntry(w)) {\n        if (w.channel === TASKS) {\n          throw new InvalidUpdateError(\n            \"Cannot write to the reserved channel TASKS\"\n          );\n        }\n        if (_isPassthrough(w.value)) {\n          throw new InvalidUpdateError(\"PASSTHROUGH value must be replaced\");\n        }\n      }\n      if (_isChannelWriteTupleEntry(w)) {\n        if (_isPassthrough(w.value)) {\n          throw new InvalidUpdateError(\"PASSTHROUGH value must be replaced\");\n        }\n      }\n    }\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    const writeEntries: [string, any][] = [];\n    for (const w of writes) {\n      if (_isSend(w)) {\n        writeEntries.push([TASKS, w]);\n      } else if (_isChannelWriteTupleEntry(w)) {\n        const mappedResult = await w.mapper.invoke(w.value, config);\n        if (mappedResult != null && mappedResult.length > 0) {\n          writeEntries.push(...mappedResult);\n        }\n      } else if (_isChannelWriteEntry(w)) {\n        const mappedValue =\n          w.mapper !== undefined\n            ? await w.mapper.invoke(w.value, config)\n            : w.value;\n        if (_isSkipWrite(mappedValue)) {\n          continue;\n        }\n        if (w.skipNone && mappedValue === undefined) {\n          continue;\n        }\n        writeEntries.push([w.channel, mappedValue]);\n      } else {\n        throw new Error(`Invalid write entry: ${JSON.stringify(w)}`);\n      }\n    }\n    const write: TYPE_SEND = config.configurable?.[CONFIG_KEY_SEND];\n    write(writeEntries);\n  }\n\n  static isWriter(runnable: RunnableLike): runnable is ChannelWrite {\n    return (\n      // eslint-disable-next-line no-instanceof/no-instanceof\n      runnable instanceof ChannelWrite ||\n      (IS_WRITER in runnable && !!runnable[IS_WRITER])\n    );\n  }\n\n  static registerWriter<T extends Runnable>(runnable: T): T {\n    return Object.defineProperty(runnable, IS_WRITER, { value: true });\n  }\n}\n\nexport interface ChannelWriteEntry {\n  channel: string;\n  value: unknown;\n  skipNone?: boolean;\n  mapper?: Runnable;\n}\n\nfunction _isChannelWriteEntry(x: unknown): x is ChannelWriteEntry {\n  return (\n    x !== undefined && typeof (x as ChannelWriteEntry).channel === \"string\"\n  );\n}\n\nexport interface ChannelWriteTupleEntry {\n  value: unknown;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  mapper: Runnable<any, [string, any][]>;\n}\n\nfunction _isChannelWriteTupleEntry(x: unknown): x is ChannelWriteTupleEntry {\n  return (\n    x !== undefined &&\n    !_isChannelWriteEntry(x) &&\n    Runnable.isRunnable((x as ChannelWriteTupleEntry).mapper)\n  );\n}\n"],"mappings":"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"}

package/dist/pregel/write.d.cts

@@ -0,0 +1,31 @@
+import { RunnableCallable } from "../utils.cjs";
+import { Send } from "../constants.cjs";
+import { Runnable, RunnableConfig, RunnableLike } from "@langchain/core/runnables";
+
+//#region src/pregel/write.d.ts
+
+/**
+ * Mapping of write channels to Runnables that return the value to be written,
+ * or None to skip writing.
+ */
+declare class ChannelWrite<RunInput = any> extends RunnableCallable<RunInput, RunInput> {
+  writes: Array<ChannelWriteEntry | ChannelWriteTupleEntry | Send>;
+  constructor(writes: Array<ChannelWriteEntry | ChannelWriteTupleEntry | Send>, tags?: string[]);
+  _write(input: unknown, config: RunnableConfig): Promise<unknown>;
+  static doWrite(config: RunnableConfig, writes: (ChannelWriteEntry | ChannelWriteTupleEntry | Send)[]): Promise<void>;
+  static isWriter(runnable: RunnableLike): runnable is ChannelWrite;
+  static registerWriter<T extends Runnable>(runnable: T): T;
+}
+interface ChannelWriteEntry {
+  channel: string;
+  value: unknown;
+  skipNone?: boolean;
+  mapper?: Runnable;
+}
+interface ChannelWriteTupleEntry {
+  value: unknown;
+  mapper: Runnable<any, [string, any][]>;
+}
+//#endregion
+export { ChannelWrite };
+//# sourceMappingURL=write.d.cts.map

package/dist/pregel/write.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.d.cts","names":["Runnable","RunnableConfig","RunnableLike","Send","RunnableCallable","SKIP_WRITE","PASSTHROUGH","ChannelWrite","RunInput","ChannelWriteEntry","ChannelWriteTupleEntry","Array","Promise","T"],"sources":["../../src/pregel/write.d.ts"],"sourcesContent":["import { Runnable, RunnableConfig, RunnableLike } from \"@langchain/core/runnables\";\nimport { Send } from \"../constants.js\";\nimport { RunnableCallable } from \"../utils.js\";\nexport declare const SKIP_WRITE: {\n    [x: symbol]: boolean;\n};\nexport declare const PASSTHROUGH: {\n    [x: symbol]: boolean;\n};\n/**\n * Mapping of write channels to Runnables that return the value to be written,\n * or None to skip writing.\n */\nexport declare class ChannelWrite<RunInput = any> extends RunnableCallable<RunInput, RunInput> {\n    writes: Array<ChannelWriteEntry | ChannelWriteTupleEntry | Send>;\n    constructor(writes: Array<ChannelWriteEntry | ChannelWriteTupleEntry | Send>, tags?: string[]);\n    _write(input: unknown, config: RunnableConfig): Promise<unknown>;\n    static doWrite(config: RunnableConfig, writes: (ChannelWriteEntry | ChannelWriteTupleEntry | Send)[]): Promise<void>;\n    static isWriter(runnable: RunnableLike): runnable is ChannelWrite;\n    static registerWriter<T extends Runnable>(runnable: T): T;\n}\nexport interface ChannelWriteEntry {\n    channel: string;\n    value: unknown;\n    skipNone?: boolean;\n    mapper?: Runnable;\n}\nexport interface ChannelWriteTupleEntry {\n    value: unknown;\n    mapper: Runnable<any, [string, any][]>;\n}\n"],"mappings":";;;;;;;;;;AAe8BS,cAFTF,YAESE,CAAAA,WAAAA,GAAAA,CAAAA,SAF4BL,gBAE5BK,CAF6CD,QAE7CC,EAFuDD,QAEvDC,CAAAA,CAAAA;QAAoBC,EADtCC,KACsCD,CADhCD,iBACgCC,GADZA,sBACYA,GADaP,IACbO,CAAAA;aAAyBP,CAAAA,MAAAA,EAAnDQ,KAAmDR,CAA7CM,iBAA6CN,GAAzBO,sBAAyBP,GAAAA,IAAAA,CAAAA,EAAAA,IAAAA,CAAAA,EAAAA,MAAAA,EAAAA;QAAnDQ,CAAAA,KAAAA,EAAAA,OAAAA,EAAAA,MAAAA,EACWV,cADXU,CAAAA,EAC4BC,OAD5BD,CAAAA,OAAAA,CAAAA;SACWV,OAAAA,CAAAA,MAAAA,EACRA,cADQA,EAAAA,MAAAA,EAAAA,CACiBQ,iBADjBR,GACqCS,sBADrCT,GAC8DE,IAD9DF,CAAAA,EAAAA,CAAAA,EACwEW,OADxEX,CAAAA,IAAAA,CAAAA;SAAiBW,QAAAA,CAAAA,QAAAA,EAEtBV,YAFsBU,CAAAA,EAAAA,QAAAA,IAEKL,YAFLK;SACzBX,cAAAA,CAAAA,UAESD,QAFTC,CAAAA,CAAAA,QAAAA,EAE6BY,CAF7BZ,CAAAA,EAEiCY,CAFjCZ;;AAA6CS,UAIvDD,iBAAAA,CAJuDC;SAAyBP,EAAAA,MAAAA;OAAUS,EAAAA,OAAAA;UAC7EV,CAAAA,EAAAA,OAAAA;QAA2BK,CAAAA,EAO5CP,QAP4CO;;AACDM,UAQvCH,sBAAAA,CARuCG;OAAIA,EAAAA,OAAAA;QANFT,EAgB9CJ,QAhB8CI,CAAAA,GAAAA,EAAAA,CAAAA,MAAAA,EAAAA,GAAAA,CAAAA,EAAAA,CAAAA"}

package/dist/pregel/write.d.ts

@@ -0,0 +1,31 @@
+import { RunnableCallable } from "../utils.js";
+import { Send } from "../constants.js";
+import { Runnable, RunnableConfig, RunnableLike } from "@langchain/core/runnables";
+
+//#region src/pregel/write.d.ts
+
+/**
+ * Mapping of write channels to Runnables that return the value to be written,
+ * or None to skip writing.
+ */
+declare class ChannelWrite<RunInput = any> extends RunnableCallable<RunInput, RunInput> {
+  writes: Array<ChannelWriteEntry | ChannelWriteTupleEntry | Send>;
+  constructor(writes: Array<ChannelWriteEntry | ChannelWriteTupleEntry | Send>, tags?: string[]);
+  _write(input: unknown, config: RunnableConfig): Promise<unknown>;
+  static doWrite(config: RunnableConfig, writes: (ChannelWriteEntry | ChannelWriteTupleEntry | Send)[]): Promise<void>;
+  static isWriter(runnable: RunnableLike): runnable is ChannelWrite;
+  static registerWriter<T extends Runnable>(runnable: T): T;
+}
+interface ChannelWriteEntry {
+  channel: string;
+  value: unknown;
+  skipNone?: boolean;
+  mapper?: Runnable;
+}
+interface ChannelWriteTupleEntry {
+  value: unknown;
+  mapper: Runnable<any, [string, any][]>;
+}
+//#endregion
+export { ChannelWrite };
+//# sourceMappingURL=write.d.ts.map

package/dist/pregel/write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.d.ts","names":["Runnable","RunnableConfig","RunnableLike","Send","RunnableCallable","SKIP_WRITE","PASSTHROUGH","ChannelWrite","RunInput","ChannelWriteEntry","ChannelWriteTupleEntry","Array","Promise","T"],"sources":["../../src/pregel/write.d.ts"],"sourcesContent":["import { Runnable, RunnableConfig, RunnableLike } from \"@langchain/core/runnables\";\nimport { Send } from \"../constants.js\";\nimport { RunnableCallable } from \"../utils.js\";\nexport declare const SKIP_WRITE: {\n    [x: symbol]: boolean;\n};\nexport declare const PASSTHROUGH: {\n    [x: symbol]: boolean;\n};\n/**\n * Mapping of write channels to Runnables that return the value to be written,\n * or None to skip writing.\n */\nexport declare class ChannelWrite<RunInput = any> extends RunnableCallable<RunInput, RunInput> {\n    writes: Array<ChannelWriteEntry | ChannelWriteTupleEntry | Send>;\n    constructor(writes: Array<ChannelWriteEntry | ChannelWriteTupleEntry | Send>, tags?: string[]);\n    _write(input: unknown, config: RunnableConfig): Promise<unknown>;\n    static doWrite(config: RunnableConfig, writes: (ChannelWriteEntry | ChannelWriteTupleEntry | Send)[]): Promise<void>;\n    static isWriter(runnable: RunnableLike): runnable is ChannelWrite;\n    static registerWriter<T extends Runnable>(runnable: T): T;\n}\nexport interface ChannelWriteEntry {\n    channel: string;\n    value: unknown;\n    skipNone?: boolean;\n    mapper?: Runnable;\n}\nexport interface ChannelWriteTupleEntry {\n    value: unknown;\n    mapper: Runnable<any, [string, any][]>;\n}\n"],"mappings":";;;;;;;;;;AAe8BS,cAFTF,YAESE,CAAAA,WAAAA,GAAAA,CAAAA,SAF4BL,gBAE5BK,CAF6CD,QAE7CC,EAFuDD,QAEvDC,CAAAA,CAAAA;QAAoBC,EADtCC,KACsCD,CADhCD,iBACgCC,GADZA,sBACYA,GADaP,IACbO,CAAAA;aAAyBP,CAAAA,MAAAA,EAAnDQ,KAAmDR,CAA7CM,iBAA6CN,GAAzBO,sBAAyBP,GAAAA,IAAAA,CAAAA,EAAAA,IAAAA,CAAAA,EAAAA,MAAAA,EAAAA;QAAnDQ,CAAAA,KAAAA,EAAAA,OAAAA,EAAAA,MAAAA,EACWV,cADXU,CAAAA,EAC4BC,OAD5BD,CAAAA,OAAAA,CAAAA;SACWV,OAAAA,CAAAA,MAAAA,EACRA,cADQA,EAAAA,MAAAA,EAAAA,CACiBQ,iBADjBR,GACqCS,sBADrCT,GAC8DE,IAD9DF,CAAAA,EAAAA,CAAAA,EACwEW,OADxEX,CAAAA,IAAAA,CAAAA;SAAiBW,QAAAA,CAAAA,QAAAA,EAEtBV,YAFsBU,CAAAA,EAAAA,QAAAA,IAEKL,YAFLK;SACzBX,cAAAA,CAAAA,UAESD,QAFTC,CAAAA,CAAAA,QAAAA,EAE6BY,CAF7BZ,CAAAA,EAEiCY,CAFjCZ;;AAA6CS,UAIvDD,iBAAAA,CAJuDC;SAAyBP,EAAAA,MAAAA;OAAUS,EAAAA,OAAAA;UAC7EV,CAAAA,EAAAA,OAAAA;QAA2BK,CAAAA,EAO5CP,QAP4CO;;AACDM,UAQvCH,sBAAAA,CARuCG;OAAIA,EAAAA,OAAAA;QANFT,EAgB9CJ,QAhB8CI,CAAAA,GAAAA,EAAAA,CAAAA,MAAAA,EAAAA,GAAAA,CAAAA,EAAAA,CAAAA"}

package/dist/pregel/write.js

@@ -0,0 +1,95 @@
+import { InvalidUpdateError } from "../errors.js";
+import { CONFIG_KEY_SEND, TASKS, _isSend } from "../constants.js";
+import { RunnableCallable } from "../utils.js";
+import { Runnable } from "@langchain/core/runnables";
+
+//#region src/pregel/write.ts
+const SKIP_WRITE = { [Symbol.for("LG_SKIP_WRITE")]: true };
+function _isSkipWrite(x) {
+	return typeof x === "object" && x?.[Symbol.for("LG_SKIP_WRITE")] !== void 0;
+}
+const PASSTHROUGH = { [Symbol.for("LG_PASSTHROUGH")]: true };
+function _isPassthrough(x) {
+	return typeof x === "object" && x?.[Symbol.for("LG_PASSTHROUGH")] !== void 0;
+}
+const IS_WRITER = Symbol("IS_WRITER");
+/**
+* Mapping of write channels to Runnables that return the value to be written,
+* or None to skip writing.
+*/
+var ChannelWrite = class ChannelWrite extends RunnableCallable {
+	writes;
+	constructor(writes, tags) {
+		const name = `ChannelWrite<${writes.map((packet) => {
+			if (_isSend(packet)) return packet.node;
+			else if ("channel" in packet) return packet.channel;
+			return "...";
+		}).join(",")}>`;
+		super({
+			writes,
+			name,
+			tags,
+			func: async (input, config) => {
+				return this._write(input, config ?? {});
+			}
+		});
+		this.writes = writes;
+	}
+	async _write(input, config) {
+		const writes = this.writes.map((write) => {
+			if (_isChannelWriteTupleEntry(write) && _isPassthrough(write.value)) return {
+				mapper: write.mapper,
+				value: input
+			};
+			else if (_isChannelWriteEntry(write) && _isPassthrough(write.value)) return {
+				channel: write.channel,
+				value: input,
+				skipNone: write.skipNone,
+				mapper: write.mapper
+			};
+			else return write;
+		});
+		await ChannelWrite.doWrite(config, writes);
+		return input;
+	}
+	static async doWrite(config, writes) {
+		for (const w of writes) {
+			if (_isChannelWriteEntry(w)) {
+				if (w.channel === TASKS) throw new InvalidUpdateError("Cannot write to the reserved channel TASKS");
+				if (_isPassthrough(w.value)) throw new InvalidUpdateError("PASSTHROUGH value must be replaced");
+			}
+			if (_isChannelWriteTupleEntry(w)) {
+				if (_isPassthrough(w.value)) throw new InvalidUpdateError("PASSTHROUGH value must be replaced");
+			}
+		}
+		const writeEntries = [];
+		for (const w of writes) if (_isSend(w)) writeEntries.push([TASKS, w]);
+		else if (_isChannelWriteTupleEntry(w)) {
+			const mappedResult = await w.mapper.invoke(w.value, config);
+			if (mappedResult != null && mappedResult.length > 0) writeEntries.push(...mappedResult);
+		} else if (_isChannelWriteEntry(w)) {
+			const mappedValue = w.mapper !== void 0 ? await w.mapper.invoke(w.value, config) : w.value;
+			if (_isSkipWrite(mappedValue)) continue;
+			if (w.skipNone && mappedValue === void 0) continue;
+			writeEntries.push([w.channel, mappedValue]);
+		} else throw new Error(`Invalid write entry: ${JSON.stringify(w)}`);
+		const write = config.configurable?.[CONFIG_KEY_SEND];
+		write(writeEntries);
+	}
+	static isWriter(runnable) {
+		return runnable instanceof ChannelWrite || IS_WRITER in runnable && !!runnable[IS_WRITER];
+	}
+	static registerWriter(runnable) {
+		return Object.defineProperty(runnable, IS_WRITER, { value: true });
+	}
+};
+function _isChannelWriteEntry(x) {
+	return x !== void 0 && typeof x.channel === "string";
+}
+function _isChannelWriteTupleEntry(x) {
+	return x !== void 0 && !_isChannelWriteEntry(x) && Runnable.isRunnable(x.mapper);
+}
+
+//#endregion
+export { ChannelWrite, PASSTHROUGH };
+//# sourceMappingURL=write.js.map

package/dist/pregel/write.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.js","names":[],"sources":["../../src/pregel/write.ts"],"sourcesContent":["import {\n  Runnable,\n  RunnableConfig,\n  RunnableLike,\n} from \"@langchain/core/runnables\";\nimport { _isSend, CONFIG_KEY_SEND, Send, TASKS } from \"../constants.js\";\nimport { RunnableCallable } from \"../utils.js\";\nimport { InvalidUpdateError } from \"../errors.js\";\n\ntype TYPE_SEND = (values: Array<[string, unknown]>) => void;\n\nexport const SKIP_WRITE = {\n  [Symbol.for(\"LG_SKIP_WRITE\")]: true,\n};\n\nfunction _isSkipWrite(x: unknown) {\n  return (\n    typeof x === \"object\" &&\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    (x as any)?.[Symbol.for(\"LG_SKIP_WRITE\")] !== undefined\n  );\n}\n\nexport const PASSTHROUGH = {\n  [Symbol.for(\"LG_PASSTHROUGH\")]: true,\n};\n\nfunction _isPassthrough(x: unknown) {\n  return (\n    typeof x === \"object\" &&\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    (x as any)?.[Symbol.for(\"LG_PASSTHROUGH\")] !== undefined\n  );\n}\n\nconst IS_WRITER = Symbol(\"IS_WRITER\");\n\n/**\n * Mapping of write channels to Runnables that return the value to be written,\n * or None to skip writing.\n */\nexport class ChannelWrite<\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  RunInput = any\n> extends RunnableCallable<RunInput, RunInput> {\n  writes: Array<ChannelWriteEntry | ChannelWriteTupleEntry | Send>;\n\n  constructor(\n    writes: Array<ChannelWriteEntry | ChannelWriteTupleEntry | Send>,\n    tags?: string[]\n  ) {\n    const name = `ChannelWrite<${writes\n      .map((packet) => {\n        if (_isSend(packet)) {\n          return packet.node;\n        } else if (\"channel\" in packet) {\n          return packet.channel;\n        }\n        return \"...\";\n      })\n      .join(\",\")}>`;\n    super({\n      ...{ writes, name, tags },\n      func: async (input: RunInput, config?: RunnableConfig) => {\n        return this._write(input, config ?? {});\n      },\n    });\n\n    this.writes = writes;\n  }\n\n  async _write(input: unknown, config: RunnableConfig): Promise<unknown> {\n    const writes = this.writes.map((write) => {\n      if (_isChannelWriteTupleEntry(write) && _isPassthrough(write.value)) {\n        return {\n          mapper: write.mapper,\n          value: input,\n        };\n      } else if (_isChannelWriteEntry(write) && _isPassthrough(write.value)) {\n        return {\n          channel: write.channel,\n          value: input,\n          skipNone: write.skipNone,\n          mapper: write.mapper,\n        };\n      } else {\n        return write;\n      }\n    });\n    await ChannelWrite.doWrite(config, writes);\n    return input;\n  }\n\n  // TODO: Support requireAtLeastOneOf\n  static async doWrite(\n    config: RunnableConfig,\n    writes: (ChannelWriteEntry | ChannelWriteTupleEntry | Send)[]\n  ): Promise<void> {\n    // validate\n    for (const w of writes) {\n      if (_isChannelWriteEntry(w)) {\n        if (w.channel === TASKS) {\n          throw new InvalidUpdateError(\n            \"Cannot write to the reserved channel TASKS\"\n          );\n        }\n        if (_isPassthrough(w.value)) {\n          throw new InvalidUpdateError(\"PASSTHROUGH value must be replaced\");\n        }\n      }\n      if (_isChannelWriteTupleEntry(w)) {\n        if (_isPassthrough(w.value)) {\n          throw new InvalidUpdateError(\"PASSTHROUGH value must be replaced\");\n        }\n      }\n    }\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    const writeEntries: [string, any][] = [];\n    for (const w of writes) {\n      if (_isSend(w)) {\n        writeEntries.push([TASKS, w]);\n      } else if (_isChannelWriteTupleEntry(w)) {\n        const mappedResult = await w.mapper.invoke(w.value, config);\n        if (mappedResult != null && mappedResult.length > 0) {\n          writeEntries.push(...mappedResult);\n        }\n      } else if (_isChannelWriteEntry(w)) {\n        const mappedValue =\n          w.mapper !== undefined\n            ? await w.mapper.invoke(w.value, config)\n            : w.value;\n        if (_isSkipWrite(mappedValue)) {\n          continue;\n        }\n        if (w.skipNone && mappedValue === undefined) {\n          continue;\n        }\n        writeEntries.push([w.channel, mappedValue]);\n      } else {\n        throw new Error(`Invalid write entry: ${JSON.stringify(w)}`);\n      }\n    }\n    const write: TYPE_SEND = config.configurable?.[CONFIG_KEY_SEND];\n    write(writeEntries);\n  }\n\n  static isWriter(runnable: RunnableLike): runnable is ChannelWrite {\n    return (\n      // eslint-disable-next-line no-instanceof/no-instanceof\n      runnable instanceof ChannelWrite ||\n      (IS_WRITER in runnable && !!runnable[IS_WRITER])\n    );\n  }\n\n  static registerWriter<T extends Runnable>(runnable: T): T {\n    return Object.defineProperty(runnable, IS_WRITER, { value: true });\n  }\n}\n\nexport interface ChannelWriteEntry {\n  channel: string;\n  value: unknown;\n  skipNone?: boolean;\n  mapper?: Runnable;\n}\n\nfunction _isChannelWriteEntry(x: unknown): x is ChannelWriteEntry {\n  return (\n    x !== undefined && typeof (x as ChannelWriteEntry).channel === \"string\"\n  );\n}\n\nexport interface ChannelWriteTupleEntry {\n  value: unknown;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  mapper: Runnable<any, [string, any][]>;\n}\n\nfunction _isChannelWriteTupleEntry(x: unknown): x is ChannelWriteTupleEntry {\n  return (\n    x !== undefined &&\n    !_isChannelWriteEntry(x) &&\n    Runnable.isRunnable((x as ChannelWriteTupleEntry).mapper)\n  );\n}\n"],"mappings":"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"}

package/dist/remote.cjs

@@ -0,0 +1,3 @@
+const require_remote = require('./pregel/remote.cjs');
+
+exports.RemoteGraph = require_remote.RemoteGraph;

package/dist/remote.d.cts

@@ -0,0 +1,2 @@
+import { RemoteGraph, RemoteGraphParams } from "./pregel/remote.cjs";
+export { RemoteGraph, type RemoteGraphParams };

package/dist/remote.d.ts

@@ -0,0 +1,2 @@
+import { RemoteGraph, RemoteGraphParams } from "./pregel/remote.js";
+export { RemoteGraph, type RemoteGraphParams };

package/dist/remote.js

@@ -0,0 +1,3 @@
+import { RemoteGraph } from "./pregel/remote.js";
+
+export { RemoteGraph };

package/dist/setup/async_local_storage.cjs

@@ -0,0 +1,11 @@
+let _langchain_core_singletons = require("@langchain/core/singletons");
+let node_async_hooks = require("node:async_hooks");
+
+//#region src/setup/async_local_storage.ts
+function initializeAsyncLocalStorageSingleton() {
+	_langchain_core_singletons.AsyncLocalStorageProviderSingleton.initializeGlobalInstance(new node_async_hooks.AsyncLocalStorage());
+}
+
+//#endregion
+exports.initializeAsyncLocalStorageSingleton = initializeAsyncLocalStorageSingleton;
+//# sourceMappingURL=async_local_storage.cjs.map

package/dist/setup/async_local_storage.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"async_local_storage.cjs","names":["AsyncLocalStorage"],"sources":["../../src/setup/async_local_storage.ts"],"sourcesContent":["import { AsyncLocalStorageProviderSingleton } from \"@langchain/core/singletons\";\nimport { AsyncLocalStorage } from \"node:async_hooks\";\n\nexport function initializeAsyncLocalStorageSingleton() {\n  AsyncLocalStorageProviderSingleton.initializeGlobalInstance(\n    new AsyncLocalStorage()\n  );\n}\n"],"mappings":";;;;AAGA,SAAgB,uCAAuC;AACrD,+DAAmC,yBACjC,IAAIA,oCAAmB,CACxB"}