@langchain/langgraph 0.2.28 → 0.2.29

package/dist/constants.cjs

@@ -121,6 +121,9 @@ function _isSend(x) {
     return operation !== undefined && operation.lg_name === "Send";
 }
 exports._isSend = _isSend;
+/**
+ * One or more commands to update the graph's state and send messages to nodes.
+ */
 class Command {
     constructor(args) {
         Object.defineProperty(this, "lg_name", {

package/dist/constants.d.ts

@@ -89,11 +89,32 @@ export type Interrupt = {
     ns?: string[];
 };
 export type CommandParams<R> = {
+    /**
+     * Value to resume execution with. To be used together with {@link interrupt}.
+     */
     resume?: R;
+    /**
+     * Graph to send the command to. Supported values are:
+     *   - None: the current graph (default)
+     *   - GraphCommand.PARENT: closest parent graph
+     */
     graph?: string;
+    /**
+     * Update to apply to the graph's state.
+     */
     update?: Record<string, any>;
+    /**
+     * Can be one of the following:
+     *   - name of the node to navigate to next (any node that belongs to the specified `graph`)
+     *   - sequence of node names to navigate to next
+     *   - `Send` object (to execute a node with the input provided)
+     *   - sequence of `Send` objects
+     */
     goto?: string | Send | (string | Send)[];
 };
+/**
+ * One or more commands to update the graph's state and send messages to nodes.
+ */
 export declare class Command<R = unknown> {
     lg_name: string;
     resume?: R;

package/dist/constants.js

@@ -115,6 +115,9 @@ export function _isSend(x) {
     const operation = x;
     return operation !== undefined && operation.lg_name === "Send";
 }
+/**
+ * One or more commands to update the graph's state and send messages to nodes.
+ */
 export class Command {
     constructor(args) {
         Object.defineProperty(this, "lg_name", {

package/dist/graph/graph.cjs

@@ -159,6 +159,7 @@ class Graph {
             runnable,
             metadata: options?.metadata,
             subgraphs: (0, subgraph_js_1.isPregelLike)(runnable) ? [runnable] : options?.subgraphs,
+            ends: options?.ends,
         };
         return this;
     }
@@ -290,6 +291,11 @@ class Graph {
                 }
             }
         }
+        for (const node of Object.values(this.nodes)) {
+            for (const target of node.ends ?? []) {
+                allTargets.add(target);
+            }
+        }
         // validate targets
         for (const node of Object.keys(this.nodes)) {
             if (!allTargets.has(node)) {
@@ -331,6 +337,7 @@ class CompiledGraph extends index_js_1.Pregel {
             triggers: [],
             metadata: node.metadata,
             subgraphs: node.subgraphs,
+            ends: node.ends,
         })
             .pipe(node.runnable)
             .pipe(new write_js_1.ChannelWrite([{ channel: key, value: write_js_1.PASSTHROUGH }], [constants_js_1.TAG_HIDDEN]));
@@ -526,6 +533,13 @@ class CompiledGraph extends index_js_1.Pregel {
                 }
             }
         }
+        for (const [key, node] of Object.entries(this.builder.nodes)) {
+            if (node.ends !== undefined) {
+                for (const end of node.ends) {
+                    addEdge(_escapeMermaidKeywords(key), _escapeMermaidKeywords(end), undefined, true);
+                }
+            }
+        }
         return graph;
     }
     /**

package/dist/graph/graph.d.ts

@@ -30,10 +30,12 @@ export type NodeSpec<RunInput, RunOutput> = {
     runnable: Runnable<RunInput, RunOutput>;
     metadata?: Record<string, unknown>;
     subgraphs?: Pregel<any, any>[];
+    ends?: string[];
 };
 export type AddNodeOptions = {
     metadata?: Record<string, unknown>;
     subgraphs?: Pregel<any, any>[];
+    ends?: string[];
 };
 export declare class Graph<N extends string = typeof END, RunInput = any, RunOutput = any, NodeSpecType extends NodeSpec<RunInput, RunOutput> = NodeSpec<RunInput, RunOutput>, C extends StateDefinition = StateDefinition> {
     nodes: Record<N, NodeSpecType>;

package/dist/graph/graph.js

@@ -155,6 +155,7 @@ export class Graph {
             runnable,
             metadata: options?.metadata,
             subgraphs: isPregelLike(runnable) ? [runnable] : options?.subgraphs,
+            ends: options?.ends,
         };
         return this;
     }
@@ -286,6 +287,11 @@ export class Graph {
                 }
             }
         }
+        for (const node of Object.values(this.nodes)) {
+            for (const target of node.ends ?? []) {
+                allTargets.add(target);
+            }
+        }
         // validate targets
         for (const node of Object.keys(this.nodes)) {
             if (!allTargets.has(node)) {
@@ -326,6 +332,7 @@ export class CompiledGraph extends Pregel {
             triggers: [],
             metadata: node.metadata,
             subgraphs: node.subgraphs,
+            ends: node.ends,
         })
             .pipe(node.runnable)
             .pipe(new ChannelWrite([{ channel: key, value: PASSTHROUGH }], [TAG_HIDDEN]));
@@ -521,6 +528,13 @@ export class CompiledGraph extends Pregel {
                 }
             }
         }
+        for (const [key, node] of Object.entries(this.builder.nodes)) {
+            if (node.ends !== undefined) {
+                for (const end of node.ends) {
+                    addEdge(_escapeMermaidKeywords(key), _escapeMermaidKeywords(end), undefined, true);
+                }
+            }
+        }
         return graph;
     }
     /**

package/dist/graph/state.cjs

@@ -240,6 +240,7 @@ class StateGraph extends graph_js_1.Graph {
                 ? // eslint-disable-next-line @typescript-eslint/no-explicit-any
                     [runnable]
                 : options?.subgraphs,
+            ends: options?.ends,
         };
         this.nodes[key] = nodeSpec;
         return this;
@@ -431,6 +432,7 @@ class CompiledStateGraph extends graph_js_1.CompiledGraph {
                 metadata: node?.metadata,
                 retryPolicy: node?.retryPolicy,
                 subgraphs: node?.subgraphs,
+                ends: node?.ends,
             });
         }
     }

package/dist/graph/state.js

@@ -237,6 +237,7 @@ export class StateGraph extends Graph {
                 ? // eslint-disable-next-line @typescript-eslint/no-explicit-any
                     [runnable]
                 : options?.subgraphs,
+            ends: options?.ends,
         };
         this.nodes[key] = nodeSpec;
         return this;
@@ -427,6 +428,7 @@ export class CompiledStateGraph extends CompiledGraph {
                 metadata: node?.metadata,
                 retryPolicy: node?.retryPolicy,
                 subgraphs: node?.subgraphs,
+                ends: node?.ends,
             });
         }
     }

package/dist/pregel/read.cjs

@@ -63,7 +63,7 @@ const defaultRunnableBound =
 /* #__PURE__ */ new runnables_1.RunnablePassthrough();
 class PregelNode extends runnables_1.RunnableBinding {
     constructor(fields) {
-        const { channels, triggers, mapper, writers, bound, kwargs, metadata, retryPolicy, tags, subgraphs, } = fields;
+        const { channels, triggers, mapper, writers, bound, kwargs, metadata, retryPolicy, tags, subgraphs, ends, } = fields;
         const mergedTags = [
             ...(fields.config?.tags ? fields.config.tags : []),
             ...(tags ?? []),
@@ -145,6 +145,12 @@ class PregelNode extends runnables_1.RunnableBinding {
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "ends", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         this.channels = channels;
         this.triggers = triggers;
         this.mapper = mapper;
@@ -155,6 +161,7 @@ class PregelNode extends runnables_1.RunnableBinding {
         this.tags = mergedTags;
         this.retryPolicy = retryPolicy;
         this.subgraphs = subgraphs;
+        this.ends = ends;
     }
     getWriters() {
         const newWriters = [...this.writers];

package/dist/pregel/read.d.ts

@@ -21,6 +21,7 @@ interface PregelNodeArgs<RunInput, RunOutput> extends Partial<RunnableBindingArg
     metadata?: Record<string, unknown>;
     retryPolicy?: RetryPolicy;
     subgraphs?: Runnable[];
+    ends?: string[];
 }
 export type PregelNodeInputType = any;
 export type PregelNodeOutputType = any;
@@ -36,6 +37,7 @@ export declare class PregelNode<RunInput = PregelNodeInputType, RunOutput = Preg
     tags: string[];
     retryPolicy?: RetryPolicy;
     subgraphs?: Runnable[];
+    ends?: string[];
     constructor(fields: PregelNodeArgs<RunInput, RunOutput>);
     getWriters(): Array<Runnable>;
     getNode(): Runnable<RunInput, RunOutput> | undefined;

package/dist/pregel/read.js

@@ -59,7 +59,7 @@ const defaultRunnableBound =
 /* #__PURE__ */ new RunnablePassthrough();
 export class PregelNode extends RunnableBinding {
     constructor(fields) {
-        const { channels, triggers, mapper, writers, bound, kwargs, metadata, retryPolicy, tags, subgraphs, } = fields;
+        const { channels, triggers, mapper, writers, bound, kwargs, metadata, retryPolicy, tags, subgraphs, ends, } = fields;
         const mergedTags = [
             ...(fields.config?.tags ? fields.config.tags : []),
             ...(tags ?? []),
@@ -141,6 +141,12 @@ export class PregelNode extends RunnableBinding {
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "ends", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         this.channels = channels;
         this.triggers = triggers;
         this.mapper = mapper;
@@ -151,6 +157,7 @@ export class PregelNode extends RunnableBinding {
         this.tags = mergedTags;
         this.retryPolicy = retryPolicy;
         this.subgraphs = subgraphs;
+        this.ends = ends;
     }
     getWriters() {
         const newWriters = [...this.writers];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@langchain/langgraph",
-  "version": "0.2.28",
+  "version": "0.2.29",
   "description": "LangGraph",
   "type": "module",
   "engines": {