@agentforge/core 0.15.14 → 0.16.0

package/dist/index.cjs

@@ -2297,7 +2297,7 @@ function mergeState(currentState, update, config) {
 // src/langgraph/builders/sequential.ts
 var import_langgraph2 = require("@langchain/langgraph");
 function createSequentialWorkflow(stateSchema, nodes, options = {}) {
-  const { autoStartEnd = true, name } = options;
+  const { autoStartEnd = true } = options;
   if (nodes.length === 0) {
     throw new Error("Sequential workflow must have at least one node");
   }
@@ -2308,7 +2308,16 @@ function createSequentialWorkflow(stateSchema, nodes, options = {}) {
     }
     nodeNames.add(node.name);
   }
-  const graph = new import_langgraph2.StateGraph(stateSchema);
+  let graph;
+  try {
+    graph = new import_langgraph2.StateGraph(
+      stateSchema
+    );
+  } catch (error) {
+    throw new Error("Sequential workflow requires a LangGraph Annotation.Root schema", {
+      cause: error
+    });
+  }
   for (const { name: nodeName, node } of nodes) {
     graph.addNode(nodeName, node);
   }

package/dist/index.d.cts

@@ -1,6 +1,7 @@
 import { z, ZodTypeAny, output, ZodType, ZodTypeDef } from 'zod';
 import { DynamicStructuredTool } from '@langchain/core/tools';
-import { AnnotationRoot, BaseChannel, StateGraph, StateDefinition, UpdateType, END, MemorySaver, BaseCheckpointSaver, CheckpointTuple } from '@langchain/langgraph';
+import * as _langchain_langgraph from '@langchain/langgraph';
+import { AnnotationRoot, BaseChannel, StateDefinition, UpdateType, StateGraph, END, MemorySaver, BaseCheckpointSaver, CheckpointTuple } from '@langchain/langgraph';
 import { RunnableConfig } from '@langchain/core/runnables';
 
 /**
@@ -2044,20 +2045,13 @@ declare function validateState<TConfig extends StateConfigMap, TState extends Pa
  */
 declare function mergeState<TConfig extends StateConfigMap>(currentState: Partial<StateShape<TConfig>>, update: StateUpdateShape<TConfig>, config: TConfig): Partial<StateShape<TConfig>>;
 
-/**
- * Sequential Workflow Builder
- *
- * Provides utilities for building linear workflows where nodes execute in sequence.
- * This is a thin wrapper around LangGraph's StateGraph that simplifies the common
- * pattern of chaining nodes together.
- *
- * @module langgraph/builders/sequential
- */
-
+type SequentialWorkflowState<SD extends StateDefinition> = AnnotationRoot<SD>['State'];
+type SequentialNodeResult<State> = Partial<State>;
+type SequentialWorkflowGraph<SD extends StateDefinition, State, Update> = StateGraph<AnnotationRoot<SD>, State, Update, string>;
 /**
  * Configuration for a node in a sequential workflow
  */
-interface SequentialNode<State> {
+interface SequentialNode<State, Update = SequentialNodeResult<State>> {
     /**
      * Unique name for the node
      */
@@ -2065,7 +2059,7 @@ interface SequentialNode<State> {
     /**
      * The node function that processes the state
      */
-    node: (state: State) => State | Promise<State> | Partial<State> | Promise<Partial<State>>;
+    node: (state: State) => Update | Promise<Update>;
     /**
      * Optional description of what this node does
      */
@@ -2081,7 +2075,9 @@ interface SequentialWorkflowOptions {
      */
     autoStartEnd?: boolean;
     /**
-     * Custom name for the workflow (for debugging)
+     * Compatibility-only no-op retained to avoid a public type break.
+     *
+     * @deprecated This option is currently unused and will be removed in a future major release.
      */
     name?: string;
 }
@@ -2108,7 +2104,7 @@ interface SequentialWorkflowOptions {
  * @param options - Optional configuration
  * @returns A configured StateGraph ready to compile
  */
-declare function createSequentialWorkflow<State>(stateSchema: any, nodes: SequentialNode<State>[], options?: SequentialWorkflowOptions): StateGraph<State>;
+declare function createSequentialWorkflow<SD extends StateDefinition, Update extends UpdateType<SD>>(stateSchema: AnnotationRoot<SD>, nodes: SequentialNode<SequentialWorkflowState<SD>, Update>[], options?: SequentialWorkflowOptions): SequentialWorkflowGraph<SD, SequentialWorkflowState<SD>, Update>;
 /**
  * Creates a sequential workflow builder with a fluent API.
  *
@@ -2129,11 +2125,11 @@ declare function createSequentialWorkflow<State>(stateSchema: any, nodes: Sequen
  * @param stateSchema - The state annotation for the graph
  * @returns A fluent builder for sequential workflows
  */
-declare function sequentialBuilder<State>(stateSchema: any): {
+declare function sequentialBuilder<SD extends StateDefinition = StateDefinition, Update extends UpdateType<SD> = UpdateType<SD>>(stateSchema: AnnotationRoot<SD>): {
     /**
      * Add a node to the sequential workflow
      */
-    addNode(name: string, node: (state: State) => State | Promise<State> | Partial<State> | Promise<Partial<State>>, description?: string): /*elided*/ any;
+    addNode(name: string, node: (state: _langchain_langgraph.StateType<SD>) => Update | Promise<Update>, description?: string): /*elided*/ any;
     /**
      * Set options for the workflow
      */
@@ -2141,7 +2137,7 @@ declare function sequentialBuilder<State>(stateSchema: any): {
     /**
      * Build the StateGraph
      */
-    build(): StateGraph<State>;
+    build(): StateGraph<AnnotationRoot<SD>, _langchain_langgraph.StateType<SD>, Update, string>;
 };
 
 /**

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 import { z, ZodTypeAny, output, ZodType, ZodTypeDef } from 'zod';
 import { DynamicStructuredTool } from '@langchain/core/tools';
-import { AnnotationRoot, BaseChannel, StateGraph, StateDefinition, UpdateType, END, MemorySaver, BaseCheckpointSaver, CheckpointTuple } from '@langchain/langgraph';
+import * as _langchain_langgraph from '@langchain/langgraph';
+import { AnnotationRoot, BaseChannel, StateDefinition, UpdateType, StateGraph, END, MemorySaver, BaseCheckpointSaver, CheckpointTuple } from '@langchain/langgraph';
 import { RunnableConfig } from '@langchain/core/runnables';
 
 /**
@@ -2044,20 +2045,13 @@ declare function validateState<TConfig extends StateConfigMap, TState extends Pa
  */
 declare function mergeState<TConfig extends StateConfigMap>(currentState: Partial<StateShape<TConfig>>, update: StateUpdateShape<TConfig>, config: TConfig): Partial<StateShape<TConfig>>;
 
-/**
- * Sequential Workflow Builder
- *
- * Provides utilities for building linear workflows where nodes execute in sequence.
- * This is a thin wrapper around LangGraph's StateGraph that simplifies the common
- * pattern of chaining nodes together.
- *
- * @module langgraph/builders/sequential
- */
-
+type SequentialWorkflowState<SD extends StateDefinition> = AnnotationRoot<SD>['State'];
+type SequentialNodeResult<State> = Partial<State>;
+type SequentialWorkflowGraph<SD extends StateDefinition, State, Update> = StateGraph<AnnotationRoot<SD>, State, Update, string>;
 /**
  * Configuration for a node in a sequential workflow
  */
-interface SequentialNode<State> {
+interface SequentialNode<State, Update = SequentialNodeResult<State>> {
     /**
      * Unique name for the node
      */
@@ -2065,7 +2059,7 @@ interface SequentialNode<State> {
     /**
      * The node function that processes the state
      */
-    node: (state: State) => State | Promise<State> | Partial<State> | Promise<Partial<State>>;
+    node: (state: State) => Update | Promise<Update>;
     /**
      * Optional description of what this node does
      */
@@ -2081,7 +2075,9 @@ interface SequentialWorkflowOptions {
      */
     autoStartEnd?: boolean;
     /**
-     * Custom name for the workflow (for debugging)
+     * Compatibility-only no-op retained to avoid a public type break.
+     *
+     * @deprecated This option is currently unused and will be removed in a future major release.
      */
     name?: string;
 }
@@ -2108,7 +2104,7 @@ interface SequentialWorkflowOptions {
  * @param options - Optional configuration
  * @returns A configured StateGraph ready to compile
  */
-declare function createSequentialWorkflow<State>(stateSchema: any, nodes: SequentialNode<State>[], options?: SequentialWorkflowOptions): StateGraph<State>;
+declare function createSequentialWorkflow<SD extends StateDefinition, Update extends UpdateType<SD>>(stateSchema: AnnotationRoot<SD>, nodes: SequentialNode<SequentialWorkflowState<SD>, Update>[], options?: SequentialWorkflowOptions): SequentialWorkflowGraph<SD, SequentialWorkflowState<SD>, Update>;
 /**
  * Creates a sequential workflow builder with a fluent API.
  *
@@ -2129,11 +2125,11 @@ declare function createSequentialWorkflow<State>(stateSchema: any, nodes: Sequen
  * @param stateSchema - The state annotation for the graph
  * @returns A fluent builder for sequential workflows
  */
-declare function sequentialBuilder<State>(stateSchema: any): {
+declare function sequentialBuilder<SD extends StateDefinition = StateDefinition, Update extends UpdateType<SD> = UpdateType<SD>>(stateSchema: AnnotationRoot<SD>): {
     /**
      * Add a node to the sequential workflow
      */
-    addNode(name: string, node: (state: State) => State | Promise<State> | Partial<State> | Promise<Partial<State>>, description?: string): /*elided*/ any;
+    addNode(name: string, node: (state: _langchain_langgraph.StateType<SD>) => Update | Promise<Update>, description?: string): /*elided*/ any;
     /**
      * Set options for the workflow
      */
@@ -2141,7 +2137,7 @@ declare function sequentialBuilder<State>(stateSchema: any): {
     /**
      * Build the StateGraph
      */
-    build(): StateGraph<State>;
+    build(): StateGraph<AnnotationRoot<SD>, _langchain_langgraph.StateType<SD>, Update, string>;
 };
 
 /**

package/dist/index.js

@@ -2122,7 +2122,7 @@ function mergeState(currentState, update, config) {
 // src/langgraph/builders/sequential.ts
 import { StateGraph, END, START } from "@langchain/langgraph";
 function createSequentialWorkflow(stateSchema, nodes, options = {}) {
-  const { autoStartEnd = true, name } = options;
+  const { autoStartEnd = true } = options;
   if (nodes.length === 0) {
     throw new Error("Sequential workflow must have at least one node");
   }
@@ -2133,7 +2133,16 @@ function createSequentialWorkflow(stateSchema, nodes, options = {}) {
     }
     nodeNames.add(node.name);
   }
-  const graph = new StateGraph(stateSchema);
+  let graph;
+  try {
+    graph = new StateGraph(
+      stateSchema
+    );
+  } catch (error) {
+    throw new Error("Sequential workflow requires a LangGraph Annotation.Root schema", {
+      cause: error
+    });
+  }
   for (const { name: nodeName, node } of nodes) {
     graph.addNode(nodeName, node);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentforge/core",
-  "version": "0.15.14",
+  "version": "0.16.0",
   "description": "Production-ready TypeScript agent framework built on LangGraph with orchestration, middleware, and typed abstractions.",
   "type": "module",
   "main": "./dist/index.cjs",