@langchain/langgraph 0.2.31 → 0.2.33

package/dist/pregel/write.cjs

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ChannelWrite = exports.PASSTHROUGH = exports.SKIP_WRITE = void 0;
+const runnables_1 = require("@langchain/core/runnables");
 const constants_js_1 = require("../constants.cjs");
 const utils_js_1 = require("../utils.cjs");
 const errors_js_1 = require("../errors.cjs");
@@ -29,7 +30,13 @@ class ChannelWrite extends utils_js_1.RunnableCallable {
     constructor(writes, tags) {
         const name = `ChannelWrite<${writes
             .map((packet) => {
-            return (0, constants_js_1._isSend)(packet) ? packet.node : packet.channel;
+            if ((0, constants_js_1._isSend)(packet)) {
+                return packet.node;
+            }
+            else if ("channel" in packet) {
+                return packet.channel;
+            }
+            return "...";
         })
             .join(",")}>`;
         super({
@@ -48,7 +55,13 @@ class ChannelWrite extends utils_js_1.RunnableCallable {
     }
     async _write(input, config) {
         const writes = this.writes.map((write) => {
-            if (_isChannelWriteEntry(write) && _isPassthrough(write.value)) {
+            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,
@@ -65,36 +78,52 @@ class ChannelWrite extends utils_js_1.RunnableCallable {
     }
     // TODO: Support requireAtLeastOneOf
     static async doWrite(config, writes) {
-        const sends = writes.filter(constants_js_1._isSend).map((packet) => {
-            return [constants_js_1.TASKS, packet];
-        });
-        const entries = writes.filter((write) => {
-            return !(0, constants_js_1._isSend)(write);
-        });
-        const invalidEntry = entries.find((write) => {
-            return write.channel === constants_js_1.TASKS;
-        });
-        if (invalidEntry) {
-            throw new errors_js_1.InvalidUpdateError(`Cannot write to the reserved channel ${constants_js_1.TASKS}`);
+        // validate
+        for (const w of writes) {
+            if (_isChannelWriteEntry(w)) {
+                if (w.channel === constants_js_1.TASKS) {
+                    throw new errors_js_1.InvalidUpdateError("Cannot write to the reserved channel TASKS");
+                }
+                if (_isPassthrough(w.value)) {
+                    throw new errors_js_1.InvalidUpdateError("PASSTHROUGH value must be replaced");
+                }
+            }
+            if (_isChannelWriteTupleEntry(w)) {
+                if (_isPassthrough(w.value)) {
+                    throw new errors_js_1.InvalidUpdateError("PASSTHROUGH value must be replaced");
+                }
+            }
+        }
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const writeEntries = [];
+        for (const w of writes) {
+            if ((0, constants_js_1._isSend)(w)) {
+                writeEntries.push([constants_js_1.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 !== undefined
+                    ? await w.mapper.invoke(w.value, config)
+                    : w.value;
+                if (_isSkipWrite(mappedValue)) {
+                    continue;
+                }
+                if (w.skipNone && mappedValue === undefined) {
+                    continue;
+                }
+                writeEntries.push([w.channel, mappedValue]);
+            }
+            else {
+                throw new Error(`Invalid write entry: ${JSON.stringify(w)}`);
+            }
         }
-        const values = await Promise.all(entries.map(async (write) => {
-            const mappedValue = write.mapper
-                ? await write.mapper.invoke(write.value, config)
-                : write.value;
-            return {
-                ...write,
-                value: mappedValue,
-            };
-        })).then((writes) => {
-            return writes
-                .filter((write) => !write.skipNone || write.value !== null)
-                .map((write) => {
-                return [write.channel, write.value];
-            });
-        });
         const write = config.configurable?.[constants_js_1.CONFIG_KEY_SEND];
-        const filtered = values.filter(([_, value]) => !_isSkipWrite(value));
-        write([...sends, ...filtered]);
+        write(writeEntries);
     }
     static isWriter(runnable) {
         return (
@@ -110,3 +139,8 @@ exports.ChannelWrite = ChannelWrite;
 function _isChannelWriteEntry(x) {
     return (x !== undefined && typeof x.channel === "string");
 }
+function _isChannelWriteTupleEntry(x) {
+    return (x !== undefined &&
+        !_isChannelWriteEntry(x) &&
+        runnables_1.Runnable.isRunnable(x.mapper));
+}

package/dist/pregel/write.d.ts

@@ -12,10 +12,10 @@ export declare const PASSTHROUGH: {
  * or None to skip writing.
  */
 export declare class ChannelWrite<RunInput = any> extends RunnableCallable {
-    writes: Array<ChannelWriteEntry | Send>;
-    constructor(writes: Array<ChannelWriteEntry | Send>, tags?: string[]);
+    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 | Send)[]): Promise<void>;
+    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;
 }
@@ -25,3 +25,7 @@ export interface ChannelWriteEntry {
     skipNone?: boolean;
     mapper?: Runnable;
 }
+export interface ChannelWriteTupleEntry {
+    value: unknown;
+    mapper: Runnable<any, [string, any][]>;
+}

package/dist/pregel/write.js

@@ -1,3 +1,4 @@
+import { Runnable, } from "@langchain/core/runnables";
 import { _isSend, CONFIG_KEY_SEND, TASKS } from "../constants.js";
 import { RunnableCallable } from "../utils.js";
 import { InvalidUpdateError } from "../errors.js";
@@ -26,7 +27,13 @@ export class ChannelWrite extends RunnableCallable {
     constructor(writes, tags) {
         const name = `ChannelWrite<${writes
             .map((packet) => {
-            return _isSend(packet) ? packet.node : packet.channel;
+            if (_isSend(packet)) {
+                return packet.node;
+            }
+            else if ("channel" in packet) {
+                return packet.channel;
+            }
+            return "...";
         })
             .join(",")}>`;
         super({
@@ -45,7 +52,13 @@ export class ChannelWrite extends RunnableCallable {
     }
     async _write(input, config) {
         const writes = this.writes.map((write) => {
-            if (_isChannelWriteEntry(write) && _isPassthrough(write.value)) {
+            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,
@@ -62,36 +75,52 @@ export class ChannelWrite extends RunnableCallable {
     }
     // TODO: Support requireAtLeastOneOf
     static async doWrite(config, writes) {
-        const sends = writes.filter(_isSend).map((packet) => {
-            return [TASKS, packet];
-        });
-        const entries = writes.filter((write) => {
-            return !_isSend(write);
-        });
-        const invalidEntry = entries.find((write) => {
-            return write.channel === TASKS;
-        });
-        if (invalidEntry) {
-            throw new InvalidUpdateError(`Cannot write to the reserved channel ${TASKS}`);
+        // validate
+        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");
+                }
+            }
+        }
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        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 !== undefined
+                    ? await w.mapper.invoke(w.value, config)
+                    : w.value;
+                if (_isSkipWrite(mappedValue)) {
+                    continue;
+                }
+                if (w.skipNone && mappedValue === undefined) {
+                    continue;
+                }
+                writeEntries.push([w.channel, mappedValue]);
+            }
+            else {
+                throw new Error(`Invalid write entry: ${JSON.stringify(w)}`);
+            }
         }
-        const values = await Promise.all(entries.map(async (write) => {
-            const mappedValue = write.mapper
-                ? await write.mapper.invoke(write.value, config)
-                : write.value;
-            return {
-                ...write,
-                value: mappedValue,
-            };
-        })).then((writes) => {
-            return writes
-                .filter((write) => !write.skipNone || write.value !== null)
-                .map((write) => {
-                return [write.channel, write.value];
-            });
-        });
         const write = config.configurable?.[CONFIG_KEY_SEND];
-        const filtered = values.filter(([_, value]) => !_isSkipWrite(value));
-        write([...sends, ...filtered]);
+        write(writeEntries);
     }
     static isWriter(runnable) {
         return (
@@ -106,3 +135,8 @@ export class ChannelWrite extends RunnableCallable {
 function _isChannelWriteEntry(x) {
     return (x !== undefined && typeof x.channel === "string");
 }
+function _isChannelWriteTupleEntry(x) {
+    return (x !== undefined &&
+        !_isChannelWriteEntry(x) &&
+        Runnable.isRunnable(x.mapper));
+}

package/dist/web.cjs

@@ -14,7 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MessagesAnnotation = exports.InMemoryStore = exports.AsyncBatchedStore = exports.BaseStore = exports.BaseCheckpointSaver = exports.emptyCheckpoint = exports.copyCheckpoint = exports.MemorySaver = exports.interrupt = exports.Command = exports.Send = exports.BinaryOperatorAggregate = exports.BaseChannel = exports.Annotation = exports.messagesStateReducer = exports.MessageGraph = exports.CompiledStateGraph = exports.StateGraph = exports.START = exports.Graph = exports.END = void 0;
+exports.MessagesAnnotation = exports.InMemoryStore = exports.AsyncBatchedStore = exports.BaseStore = exports.BaseCheckpointSaver = exports.emptyCheckpoint = exports.copyCheckpoint = exports.MemorySaver = exports.interrupt = exports.isCommand = exports.Command = exports.Send = exports.BinaryOperatorAggregate = exports.BaseChannel = exports.Annotation = exports.messagesStateReducer = exports.MessageGraph = exports.CompiledStateGraph = exports.StateGraph = exports.START = exports.Graph = exports.END = void 0;
 var index_js_1 = require("./graph/index.cjs");
 Object.defineProperty(exports, "END", { enumerable: true, get: function () { return index_js_1.END; } });
 Object.defineProperty(exports, "Graph", { enumerable: true, get: function () { return index_js_1.Graph; } });
@@ -31,6 +31,7 @@ Object.defineProperty(exports, "BinaryOperatorAggregate", { enumerable: true, ge
 var constants_js_1 = require("./constants.cjs");
 Object.defineProperty(exports, "Send", { enumerable: true, get: function () { return constants_js_1.Send; } });
 Object.defineProperty(exports, "Command", { enumerable: true, get: function () { return constants_js_1.Command; } });
+Object.defineProperty(exports, "isCommand", { enumerable: true, get: function () { return constants_js_1.isCommand; } });
 var interrupt_js_1 = require("./interrupt.cjs");
 Object.defineProperty(exports, "interrupt", { enumerable: true, get: function () { return interrupt_js_1.interrupt; } });
 var langgraph_checkpoint_1 = require("@langchain/langgraph-checkpoint");

package/dist/web.d.ts

@@ -4,7 +4,7 @@ export * from "./errors.js";
 export { BaseChannel, type BinaryOperator, BinaryOperatorAggregate, type AnyValue, type WaitForNames, type DynamicBarrierValue, type LastValue, type NamedBarrierValue, type Topic, } from "./channels/index.js";
 export { type AnnotationRoot as _INTERNAL_ANNOTATION_ROOT } from "./graph/index.js";
 export { type RetryPolicy } from "./pregel/utils/index.js";
-export { Send, Command, type CommandParams, type Interrupt, } from "./constants.js";
+export { Send, Command, type CommandParams, isCommand, type Interrupt, } from "./constants.js";
 export { interrupt } from "./interrupt.js";
 export { MemorySaver, type Checkpoint, type CheckpointMetadata, type CheckpointTuple, copyCheckpoint, emptyCheckpoint, BaseCheckpointSaver, type Item, type GetOperation, type SearchOperation, type PutOperation, type Operation, type OperationResults, BaseStore, AsyncBatchedStore, InMemoryStore, type NameSpacePath, type NamespaceMatchType, type MatchCondition, type ListNamespacesOperation, } from "@langchain/langgraph-checkpoint";
 export * from "./managed/index.js";

package/dist/web.js

@@ -1,7 +1,7 @@
 export { END, Graph, START, StateGraph, CompiledStateGraph, MessageGraph, messagesStateReducer, Annotation, } from "./graph/index.js";
 export * from "./errors.js";
 export { BaseChannel, BinaryOperatorAggregate, } from "./channels/index.js";
-export { Send, Command, } from "./constants.js";
+export { Send, Command, isCommand, } from "./constants.js";
 export { interrupt } from "./interrupt.js";
 export { MemorySaver, copyCheckpoint, emptyCheckpoint, BaseCheckpointSaver, BaseStore, AsyncBatchedStore, InMemoryStore, } from "@langchain/langgraph-checkpoint";
 export * from "./managed/index.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@langchain/langgraph",
-  "version": "0.2.31",
+  "version": "0.2.33",
   "description": "LangGraph",
   "type": "module",
   "engines": {
@@ -43,7 +43,7 @@
     "@jest/globals": "^29.5.0",
     "@langchain/anthropic": "^0.3.5",
     "@langchain/community": "^0.3.9",
-    "@langchain/core": "^0.3.22",
+    "@langchain/core": "^0.3.23",
     "@langchain/langgraph-checkpoint-postgres": "workspace:*",
     "@langchain/langgraph-checkpoint-sqlite": "workspace:*",
     "@langchain/openai": "^0.3.11",