@agentforge/core 0.15.11 → 0.15.12

package/dist/index.cjs

@@ -2354,7 +2354,7 @@ function sequentialBuilder(stateSchema) {
 var import_langgraph3 = require("@langchain/langgraph");
 function createParallelWorkflow(stateSchema, config, options = {}) {
   const { parallel: parallel2, aggregate } = config;
-  const { autoStartEnd = true, name } = options;
+  const { autoStartEnd = true } = options;
   if (parallel2.length === 0) {
     throw new Error("Parallel workflow must have at least one parallel node");
   }

package/dist/index.d.cts

@@ -1,6 +1,6 @@
 import { z, ZodTypeAny, output, ZodType, ZodTypeDef } from 'zod';
 import { DynamicStructuredTool } from '@langchain/core/tools';
-import { AnnotationRoot, BaseChannel, StateGraph, END, MemorySaver, BaseCheckpointSaver, CheckpointTuple } from '@langchain/langgraph';
+import { AnnotationRoot, BaseChannel, StateGraph, StateDefinition, UpdateType, END, MemorySaver, BaseCheckpointSaver, CheckpointTuple } from '@langchain/langgraph';
 import { RunnableConfig } from '@langchain/core/runnables';
 
 /**
@@ -2153,10 +2153,12 @@ declare function sequentialBuilder<State>(stateSchema: any): {
  * @module langgraph/builders/parallel
  */
 
+type ParallelWorkflowState<SD extends StateDefinition> = AnnotationRoot<SD>['State'];
+type ParallelNodeResult<State> = Partial<State>;
 /**
  * Configuration for a parallel node
  */
-interface ParallelNode<State> {
+interface ParallelNode<State, Update = ParallelNodeResult<State>> {
     /**
      * Unique name for the node
      */
@@ -2164,7 +2166,7 @@ interface ParallelNode<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
      */
@@ -2173,7 +2175,7 @@ interface ParallelNode<State> {
 /**
  * Configuration for an aggregation node that combines parallel results
  */
-interface AggregateNode<State> {
+interface AggregateNode<State, Update = ParallelNodeResult<State>> {
     /**
      * Name for the aggregation node
      */
@@ -2181,7 +2183,7 @@ interface AggregateNode<State> {
     /**
      * The aggregation function that combines results from parallel nodes
      */
-    node: (state: State) => State | Promise<State> | Partial<State> | Promise<Partial<State>>;
+    node: (state: State) => Update | Promise<Update>;
     /**
      * Optional description
      */
@@ -2197,22 +2199,24 @@ interface ParallelWorkflowOptions {
      */
     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;
 }
 /**
  * Configuration for a parallel workflow
  */
-interface ParallelWorkflowConfig<State> {
+interface ParallelWorkflowConfig<State, Update = ParallelNodeResult<State>> {
     /**
      * Nodes that execute in parallel
      */
-    parallel: ParallelNode<State>[];
+    parallel: ParallelNode<State, Update>[];
     /**
      * Optional aggregation node that runs after all parallel nodes complete
      */
-    aggregate?: AggregateNode<State>;
+    aggregate?: AggregateNode<State, Update>;
 }
 /**
  * Creates a parallel workflow where multiple nodes execute concurrently.
@@ -2241,7 +2245,7 @@ interface ParallelWorkflowConfig<State> {
  * @param options - Optional configuration
  * @returns A configured StateGraph ready to compile
  */
-declare function createParallelWorkflow<State>(stateSchema: any, config: ParallelWorkflowConfig<State>, options?: ParallelWorkflowOptions): StateGraph<State>;
+declare function createParallelWorkflow<SD extends StateDefinition = StateDefinition, Update extends UpdateType<SD> = UpdateType<SD>>(stateSchema: AnnotationRoot<SD>, config: ParallelWorkflowConfig<ParallelWorkflowState<SD>, Update>, options?: ParallelWorkflowOptions): StateGraph<AnnotationRoot<SD>, ParallelWorkflowState<SD>, Update, string>;
 
 /**
  * Conditional Routing Utilities

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { z, ZodTypeAny, output, ZodType, ZodTypeDef } from 'zod';
 import { DynamicStructuredTool } from '@langchain/core/tools';
-import { AnnotationRoot, BaseChannel, StateGraph, END, MemorySaver, BaseCheckpointSaver, CheckpointTuple } from '@langchain/langgraph';
+import { AnnotationRoot, BaseChannel, StateGraph, StateDefinition, UpdateType, END, MemorySaver, BaseCheckpointSaver, CheckpointTuple } from '@langchain/langgraph';
 import { RunnableConfig } from '@langchain/core/runnables';
 
 /**
@@ -2153,10 +2153,12 @@ declare function sequentialBuilder<State>(stateSchema: any): {
  * @module langgraph/builders/parallel
  */
 
+type ParallelWorkflowState<SD extends StateDefinition> = AnnotationRoot<SD>['State'];
+type ParallelNodeResult<State> = Partial<State>;
 /**
  * Configuration for a parallel node
  */
-interface ParallelNode<State> {
+interface ParallelNode<State, Update = ParallelNodeResult<State>> {
     /**
      * Unique name for the node
      */
@@ -2164,7 +2166,7 @@ interface ParallelNode<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
      */
@@ -2173,7 +2175,7 @@ interface ParallelNode<State> {
 /**
  * Configuration for an aggregation node that combines parallel results
  */
-interface AggregateNode<State> {
+interface AggregateNode<State, Update = ParallelNodeResult<State>> {
     /**
      * Name for the aggregation node
      */
@@ -2181,7 +2183,7 @@ interface AggregateNode<State> {
     /**
      * The aggregation function that combines results from parallel nodes
      */
-    node: (state: State) => State | Promise<State> | Partial<State> | Promise<Partial<State>>;
+    node: (state: State) => Update | Promise<Update>;
     /**
      * Optional description
      */
@@ -2197,22 +2199,24 @@ interface ParallelWorkflowOptions {
      */
     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;
 }
 /**
  * Configuration for a parallel workflow
  */
-interface ParallelWorkflowConfig<State> {
+interface ParallelWorkflowConfig<State, Update = ParallelNodeResult<State>> {
     /**
      * Nodes that execute in parallel
      */
-    parallel: ParallelNode<State>[];
+    parallel: ParallelNode<State, Update>[];
     /**
      * Optional aggregation node that runs after all parallel nodes complete
      */
-    aggregate?: AggregateNode<State>;
+    aggregate?: AggregateNode<State, Update>;
 }
 /**
  * Creates a parallel workflow where multiple nodes execute concurrently.
@@ -2241,7 +2245,7 @@ interface ParallelWorkflowConfig<State> {
  * @param options - Optional configuration
  * @returns A configured StateGraph ready to compile
  */
-declare function createParallelWorkflow<State>(stateSchema: any, config: ParallelWorkflowConfig<State>, options?: ParallelWorkflowOptions): StateGraph<State>;
+declare function createParallelWorkflow<SD extends StateDefinition = StateDefinition, Update extends UpdateType<SD> = UpdateType<SD>>(stateSchema: AnnotationRoot<SD>, config: ParallelWorkflowConfig<ParallelWorkflowState<SD>, Update>, options?: ParallelWorkflowOptions): StateGraph<AnnotationRoot<SD>, ParallelWorkflowState<SD>, Update, string>;
 
 /**
  * Conditional Routing Utilities

package/dist/index.js

@@ -2179,7 +2179,7 @@ function sequentialBuilder(stateSchema) {
 import { StateGraph as StateGraph2, END as END2, START as START2 } from "@langchain/langgraph";
 function createParallelWorkflow(stateSchema, config, options = {}) {
   const { parallel: parallel2, aggregate } = config;
-  const { autoStartEnd = true, name } = options;
+  const { autoStartEnd = true } = options;
   if (parallel2.length === 0) {
     throw new Error("Parallel workflow must have at least one parallel node");
   }

package/package.json

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