@agentforge/patterns 0.15.7 → 0.15.8

package/dist/index.d.cts

@@ -131,7 +131,70 @@ type ScratchpadEntry = z.infer<typeof ScratchpadEntrySchema>;
  *
  * This uses LangGraph's Annotation.Root() under the hood, with optional Zod validation.
  */
-declare const ReActState: _langchain_langgraph.AnnotationRoot<_langchain_langgraph.StateDefinition>;
+declare const ReActState: _langchain_langgraph.AnnotationRoot<{
+    messages: _langchain_langgraph.BaseChannel<{
+        role: "system" | "user" | "assistant" | "tool";
+        content: string;
+        name?: string | undefined;
+        tool_call_id?: string | undefined;
+        metadata?: Record<string, any> | undefined;
+    }[], {
+        role: "system" | "user" | "assistant" | "tool";
+        content: string;
+        name?: string | undefined;
+        tool_call_id?: string | undefined;
+        metadata?: Record<string, any> | undefined;
+    }[], unknown>;
+    thoughts: _langchain_langgraph.BaseChannel<{
+        content: string;
+        metadata?: Record<string, any> | undefined;
+        timestamp?: number | undefined;
+    }[], {
+        content: string;
+        metadata?: Record<string, any> | undefined;
+        timestamp?: number | undefined;
+    }[], unknown>;
+    actions: _langchain_langgraph.BaseChannel<{
+        name: string;
+        id: string;
+        arguments: Record<string, any>;
+        timestamp?: number | undefined;
+    }[], {
+        name: string;
+        id: string;
+        arguments: Record<string, any>;
+        timestamp?: number | undefined;
+    }[], unknown>;
+    observations: _langchain_langgraph.BaseChannel<{
+        toolCallId: string;
+        timestamp?: number | undefined;
+        result?: any;
+        error?: string | undefined;
+        isDuplicate?: boolean | undefined;
+    }[], {
+        toolCallId: string;
+        timestamp?: number | undefined;
+        result?: any;
+        error?: string | undefined;
+        isDuplicate?: boolean | undefined;
+    }[], unknown>;
+    scratchpad: _langchain_langgraph.BaseChannel<{
+        step: number;
+        timestamp?: number | undefined;
+        thought?: string | undefined;
+        action?: string | undefined;
+        observation?: string | undefined;
+    }[], {
+        step: number;
+        timestamp?: number | undefined;
+        thought?: string | undefined;
+        action?: string | undefined;
+        observation?: string | undefined;
+    }[], unknown>;
+    iteration: _langchain_langgraph.BaseChannel<number, number, unknown>;
+    shouldContinue: _langchain_langgraph.BaseChannel<boolean | undefined, boolean | undefined, unknown>;
+    response: _langchain_langgraph.BaseChannel<string | undefined, string | undefined, unknown>;
+}>;
 /**
  * TypeScript type for ReAct state
  */
@@ -905,7 +968,63 @@ declare const PlanExecuteStateConfig: {
  *
  * This uses LangGraph's Annotation.Root() under the hood, with optional Zod validation.
  */
-declare const PlanExecuteState: _langchain_langgraph.AnnotationRoot<_langchain_langgraph.StateDefinition>;
+declare const PlanExecuteState: _langchain_langgraph.AnnotationRoot<{
+    input: _langchain_langgraph.BaseChannel<string, string, unknown>;
+    plan: _langchain_langgraph.BaseChannel<{
+        steps: {
+            id: string;
+            description: string;
+            tool?: string | undefined;
+            args?: Record<string, any> | undefined;
+            dependencies?: string[] | undefined;
+        }[];
+        goal: string;
+        createdAt: string;
+        confidence?: number | undefined;
+    } | undefined, {
+        steps: {
+            id: string;
+            description: string;
+            tool?: string | undefined;
+            args?: Record<string, any> | undefined;
+            dependencies?: string[] | undefined;
+        }[];
+        goal: string;
+        createdAt: string;
+        confidence?: number | undefined;
+    } | undefined, unknown>;
+    pastSteps: _langchain_langgraph.BaseChannel<{
+        timestamp: string;
+        step: {
+            id: string;
+            description: string;
+            tool?: string | undefined;
+            args?: Record<string, any> | undefined;
+            dependencies?: string[] | undefined;
+        };
+        success: boolean;
+        result?: any;
+        error?: string | undefined;
+    }[], {
+        timestamp: string;
+        step: {
+            id: string;
+            description: string;
+            tool?: string | undefined;
+            args?: Record<string, any> | undefined;
+            dependencies?: string[] | undefined;
+        };
+        success: boolean;
+        result?: any;
+        error?: string | undefined;
+    }[], unknown>;
+    currentStepIndex: _langchain_langgraph.BaseChannel<number | undefined, number | undefined, unknown>;
+    status: _langchain_langgraph.BaseChannel<"failed" | "planning" | "executing" | "replanning" | "completed", "failed" | "planning" | "executing" | "replanning" | "completed", unknown>;
+    response: _langchain_langgraph.BaseChannel<string | undefined, string | undefined, unknown>;
+    error: _langchain_langgraph.BaseChannel<string | undefined, string | undefined, unknown>;
+    iteration: _langchain_langgraph.BaseChannel<number, number, unknown>;
+    maxIterations: _langchain_langgraph.BaseChannel<number, number, unknown>;
+}>;
 /**
  * TypeScript type for Plan-Execute state
  *
@@ -1595,7 +1714,64 @@ declare const ReflectionStateConfig: {
  *
  * This uses LangGraph's Annotation.Root() under the hood, with optional Zod validation.
  */
-declare const ReflectionState: _langchain_langgraph.AnnotationRoot<_langchain_langgraph.StateDefinition>;
+declare const ReflectionState: _langchain_langgraph.AnnotationRoot<{
+    input: _langchain_langgraph.BaseChannel<string, string, unknown>;
+    currentResponse: _langchain_langgraph.BaseChannel<string | undefined, string | undefined, unknown>;
+    reflections: _langchain_langgraph.BaseChannel<{
+        issues: string[];
+        critique: string;
+        suggestions: string[];
+        meetsStandards: boolean;
+        timestamp?: Date | undefined;
+        score?: number | undefined;
+    }[], {
+        issues: string[];
+        critique: string;
+        suggestions: string[];
+        meetsStandards: boolean;
+        timestamp?: Date | undefined;
+        score?: number | undefined;
+    }[], unknown>;
+    revisions: _langchain_langgraph.BaseChannel<{
+        content: string;
+        iteration: number;
+        timestamp?: Date | undefined;
+        basedOn?: {
+            issues: string[];
+            critique: string;
+            suggestions: string[];
+            meetsStandards: boolean;
+            timestamp?: Date | undefined;
+            score?: number | undefined;
+        } | undefined;
+    }[], {
+        content: string;
+        iteration: number;
+        timestamp?: Date | undefined;
+        basedOn?: {
+            issues: string[];
+            critique: string;
+            suggestions: string[];
+            meetsStandards: boolean;
+            timestamp?: Date | undefined;
+            score?: number | undefined;
+        } | undefined;
+    }[], unknown>;
+    iteration: _langchain_langgraph.BaseChannel<number, number, unknown>;
+    status: _langchain_langgraph.BaseChannel<"failed" | "completed" | "generating" | "reflecting" | "revising", "failed" | "completed" | "generating" | "reflecting" | "revising", unknown>;
+    qualityCriteria: _langchain_langgraph.BaseChannel<{
+        minScore: number;
+        requireAll: boolean;
+        criteria?: string[] | undefined;
+    } | undefined, {
+        minScore: number;
+        requireAll: boolean;
+        criteria?: string[] | undefined;
+    } | undefined, unknown>;
+    maxIterations: _langchain_langgraph.BaseChannel<number, number, unknown>;
+    response: _langchain_langgraph.BaseChannel<string | undefined, string | undefined, unknown>;
+    error: _langchain_langgraph.BaseChannel<string | undefined, string | undefined, unknown>;
+}>;
 /**
  * TypeScript type for Reflection state
  *
@@ -2497,7 +2673,103 @@ declare const MultiAgentStateConfig: {
  *
  * This uses LangGraph's Annotation.Root() under the hood, with optional Zod validation.
  */
-declare const MultiAgentState: _langchain_langgraph.AnnotationRoot<_langchain_langgraph.StateDefinition>;
+declare const MultiAgentState: _langchain_langgraph.AnnotationRoot<{
+    input: _langchain_langgraph.BaseChannel<string, string, unknown>;
+    messages: _langchain_langgraph.BaseChannel<{
+        content: string;
+        type: "error" | "user_input" | "task_assignment" | "task_result" | "handoff" | "completion";
+        timestamp: number;
+        id: string;
+        from: string;
+        to: string | string[];
+        metadata?: Record<string, any> | undefined;
+    }[], {
+        content: string;
+        type: "error" | "user_input" | "task_assignment" | "task_result" | "handoff" | "completion";
+        timestamp: number;
+        id: string;
+        from: string;
+        to: string | string[];
+        metadata?: Record<string, any> | undefined;
+    }[], unknown>;
+    workers: _langchain_langgraph.BaseChannel<Record<string, {
+        tools: string[];
+        skills: string[];
+        available: boolean;
+        currentWorkload: number;
+    }>, Record<string, {
+        tools: string[];
+        skills: string[];
+        available: boolean;
+        currentWorkload: number;
+    }>, unknown>;
+    currentAgent: _langchain_langgraph.BaseChannel<string | undefined, string | undefined, unknown>;
+    routingHistory: _langchain_langgraph.BaseChannel<{
+        timestamp: number;
+        reasoning: string;
+        confidence: number;
+        targetAgent: string | null;
+        targetAgents: string[] | null;
+        strategy: "llm-based" | "rule-based" | "round-robin" | "skill-based" | "load-balanced";
+    }[], {
+        timestamp: number;
+        reasoning: string;
+        confidence: number;
+        targetAgent: string | null;
+        targetAgents: string[] | null;
+        strategy: "llm-based" | "rule-based" | "round-robin" | "skill-based" | "load-balanced";
+    }[], unknown>;
+    activeAssignments: _langchain_langgraph.BaseChannel<{
+        id: string;
+        workerId: string;
+        task: string;
+        priority: number;
+        assignedAt: number;
+        deadline?: number | undefined;
+    }[], {
+        id: string;
+        workerId: string;
+        task: string;
+        priority: number;
+        assignedAt: number;
+        deadline?: number | undefined;
+    }[], unknown>;
+    completedTasks: _langchain_langgraph.BaseChannel<{
+        result: string;
+        success: boolean;
+        workerId: string;
+        assignmentId: string;
+        completedAt: number;
+        metadata?: Record<string, any> | undefined;
+        error?: string | undefined;
+    }[], {
+        result: string;
+        success: boolean;
+        workerId: string;
+        assignmentId: string;
+        completedAt: number;
+        metadata?: Record<string, any> | undefined;
+        error?: string | undefined;
+    }[], unknown>;
+    handoffs: _langchain_langgraph.BaseChannel<{
+        timestamp: string;
+        reason: string;
+        from: string;
+        to: string;
+        context?: any;
+    }[], {
+        timestamp: string;
+        reason: string;
+        from: string;
+        to: string;
+        context?: any;
+    }[], unknown>;
+    status: _langchain_langgraph.BaseChannel<"failed" | "executing" | "completed" | "initializing" | "routing" | "coordinating" | "aggregating", "failed" | "executing" | "completed" | "initializing" | "routing" | "coordinating" | "aggregating", unknown>;
+    iteration: _langchain_langgraph.BaseChannel<number, number, unknown>;
+    maxIterations: _langchain_langgraph.BaseChannel<number, number, unknown>;
+    response: _langchain_langgraph.BaseChannel<string | undefined, string | undefined, unknown>;
+    error: _langchain_langgraph.BaseChannel<string | undefined, string | undefined, unknown>;
+}>;
 /**
  * TypeScript type for Multi-Agent state
  *

package/dist/index.d.ts

@@ -131,7 +131,70 @@ type ScratchpadEntry = z.infer<typeof ScratchpadEntrySchema>;
  *
  * This uses LangGraph's Annotation.Root() under the hood, with optional Zod validation.
  */
-declare const ReActState: _langchain_langgraph.AnnotationRoot<_langchain_langgraph.StateDefinition>;
+declare const ReActState: _langchain_langgraph.AnnotationRoot<{
+    messages: _langchain_langgraph.BaseChannel<{
+        role: "system" | "user" | "assistant" | "tool";
+        content: string;
+        name?: string | undefined;
+        tool_call_id?: string | undefined;
+        metadata?: Record<string, any> | undefined;
+    }[], {
+        role: "system" | "user" | "assistant" | "tool";
+        content: string;
+        name?: string | undefined;
+        tool_call_id?: string | undefined;
+        metadata?: Record<string, any> | undefined;
+    }[], unknown>;
+    thoughts: _langchain_langgraph.BaseChannel<{
+        content: string;
+        metadata?: Record<string, any> | undefined;
+        timestamp?: number | undefined;
+    }[], {
+        content: string;
+        metadata?: Record<string, any> | undefined;
+        timestamp?: number | undefined;
+    }[], unknown>;
+    actions: _langchain_langgraph.BaseChannel<{
+        name: string;
+        id: string;
+        arguments: Record<string, any>;
+        timestamp?: number | undefined;
+    }[], {
+        name: string;
+        id: string;
+        arguments: Record<string, any>;
+        timestamp?: number | undefined;
+    }[], unknown>;
+    observations: _langchain_langgraph.BaseChannel<{
+        toolCallId: string;
+        timestamp?: number | undefined;
+        result?: any;
+        error?: string | undefined;
+        isDuplicate?: boolean | undefined;
+    }[], {
+        toolCallId: string;
+        timestamp?: number | undefined;
+        result?: any;
+        error?: string | undefined;
+        isDuplicate?: boolean | undefined;
+    }[], unknown>;
+    scratchpad: _langchain_langgraph.BaseChannel<{
+        step: number;
+        timestamp?: number | undefined;
+        thought?: string | undefined;
+        action?: string | undefined;
+        observation?: string | undefined;
+    }[], {
+        step: number;
+        timestamp?: number | undefined;
+        thought?: string | undefined;
+        action?: string | undefined;
+        observation?: string | undefined;
+    }[], unknown>;
+    iteration: _langchain_langgraph.BaseChannel<number, number, unknown>;
+    shouldContinue: _langchain_langgraph.BaseChannel<boolean | undefined, boolean | undefined, unknown>;
+    response: _langchain_langgraph.BaseChannel<string | undefined, string | undefined, unknown>;
+}>;
 /**
  * TypeScript type for ReAct state
  */
@@ -905,7 +968,63 @@ declare const PlanExecuteStateConfig: {
  *
  * This uses LangGraph's Annotation.Root() under the hood, with optional Zod validation.
  */
-declare const PlanExecuteState: _langchain_langgraph.AnnotationRoot<_langchain_langgraph.StateDefinition>;
+declare const PlanExecuteState: _langchain_langgraph.AnnotationRoot<{
+    input: _langchain_langgraph.BaseChannel<string, string, unknown>;
+    plan: _langchain_langgraph.BaseChannel<{
+        steps: {
+            id: string;
+            description: string;
+            tool?: string | undefined;
+            args?: Record<string, any> | undefined;
+            dependencies?: string[] | undefined;
+        }[];
+        goal: string;
+        createdAt: string;
+        confidence?: number | undefined;
+    } | undefined, {
+        steps: {
+            id: string;
+            description: string;
+            tool?: string | undefined;
+            args?: Record<string, any> | undefined;
+            dependencies?: string[] | undefined;
+        }[];
+        goal: string;
+        createdAt: string;
+        confidence?: number | undefined;
+    } | undefined, unknown>;
+    pastSteps: _langchain_langgraph.BaseChannel<{
+        timestamp: string;
+        step: {
+            id: string;
+            description: string;
+            tool?: string | undefined;
+            args?: Record<string, any> | undefined;
+            dependencies?: string[] | undefined;
+        };
+        success: boolean;
+        result?: any;
+        error?: string | undefined;
+    }[], {
+        timestamp: string;
+        step: {
+            id: string;
+            description: string;
+            tool?: string | undefined;
+            args?: Record<string, any> | undefined;
+            dependencies?: string[] | undefined;
+        };
+        success: boolean;
+        result?: any;
+        error?: string | undefined;
+    }[], unknown>;
+    currentStepIndex: _langchain_langgraph.BaseChannel<number | undefined, number | undefined, unknown>;
+    status: _langchain_langgraph.BaseChannel<"failed" | "planning" | "executing" | "replanning" | "completed", "failed" | "planning" | "executing" | "replanning" | "completed", unknown>;
+    response: _langchain_langgraph.BaseChannel<string | undefined, string | undefined, unknown>;
+    error: _langchain_langgraph.BaseChannel<string | undefined, string | undefined, unknown>;
+    iteration: _langchain_langgraph.BaseChannel<number, number, unknown>;
+    maxIterations: _langchain_langgraph.BaseChannel<number, number, unknown>;
+}>;
 /**
  * TypeScript type for Plan-Execute state
  *
@@ -1595,7 +1714,64 @@ declare const ReflectionStateConfig: {
  *
  * This uses LangGraph's Annotation.Root() under the hood, with optional Zod validation.
  */
-declare const ReflectionState: _langchain_langgraph.AnnotationRoot<_langchain_langgraph.StateDefinition>;
+declare const ReflectionState: _langchain_langgraph.AnnotationRoot<{
+    input: _langchain_langgraph.BaseChannel<string, string, unknown>;
+    currentResponse: _langchain_langgraph.BaseChannel<string | undefined, string | undefined, unknown>;
+    reflections: _langchain_langgraph.BaseChannel<{
+        issues: string[];
+        critique: string;
+        suggestions: string[];
+        meetsStandards: boolean;
+        timestamp?: Date | undefined;
+        score?: number | undefined;
+    }[], {
+        issues: string[];
+        critique: string;
+        suggestions: string[];
+        meetsStandards: boolean;
+        timestamp?: Date | undefined;
+        score?: number | undefined;
+    }[], unknown>;
+    revisions: _langchain_langgraph.BaseChannel<{
+        content: string;
+        iteration: number;
+        timestamp?: Date | undefined;
+        basedOn?: {
+            issues: string[];
+            critique: string;
+            suggestions: string[];
+            meetsStandards: boolean;
+            timestamp?: Date | undefined;
+            score?: number | undefined;
+        } | undefined;
+    }[], {
+        content: string;
+        iteration: number;
+        timestamp?: Date | undefined;
+        basedOn?: {
+            issues: string[];
+            critique: string;
+            suggestions: string[];
+            meetsStandards: boolean;
+            timestamp?: Date | undefined;
+            score?: number | undefined;
+        } | undefined;
+    }[], unknown>;
+    iteration: _langchain_langgraph.BaseChannel<number, number, unknown>;
+    status: _langchain_langgraph.BaseChannel<"failed" | "completed" | "generating" | "reflecting" | "revising", "failed" | "completed" | "generating" | "reflecting" | "revising", unknown>;
+    qualityCriteria: _langchain_langgraph.BaseChannel<{
+        minScore: number;
+        requireAll: boolean;
+        criteria?: string[] | undefined;
+    } | undefined, {
+        minScore: number;
+        requireAll: boolean;
+        criteria?: string[] | undefined;
+    } | undefined, unknown>;
+    maxIterations: _langchain_langgraph.BaseChannel<number, number, unknown>;
+    response: _langchain_langgraph.BaseChannel<string | undefined, string | undefined, unknown>;
+    error: _langchain_langgraph.BaseChannel<string | undefined, string | undefined, unknown>;
+}>;
 /**
  * TypeScript type for Reflection state
  *
@@ -2497,7 +2673,103 @@ declare const MultiAgentStateConfig: {
  *
  * This uses LangGraph's Annotation.Root() under the hood, with optional Zod validation.
  */
-declare const MultiAgentState: _langchain_langgraph.AnnotationRoot<_langchain_langgraph.StateDefinition>;
+declare const MultiAgentState: _langchain_langgraph.AnnotationRoot<{
+    input: _langchain_langgraph.BaseChannel<string, string, unknown>;
+    messages: _langchain_langgraph.BaseChannel<{
+        content: string;
+        type: "error" | "user_input" | "task_assignment" | "task_result" | "handoff" | "completion";
+        timestamp: number;
+        id: string;
+        from: string;
+        to: string | string[];
+        metadata?: Record<string, any> | undefined;
+    }[], {
+        content: string;
+        type: "error" | "user_input" | "task_assignment" | "task_result" | "handoff" | "completion";
+        timestamp: number;
+        id: string;
+        from: string;
+        to: string | string[];
+        metadata?: Record<string, any> | undefined;
+    }[], unknown>;
+    workers: _langchain_langgraph.BaseChannel<Record<string, {
+        tools: string[];
+        skills: string[];
+        available: boolean;
+        currentWorkload: number;
+    }>, Record<string, {
+        tools: string[];
+        skills: string[];
+        available: boolean;
+        currentWorkload: number;
+    }>, unknown>;
+    currentAgent: _langchain_langgraph.BaseChannel<string | undefined, string | undefined, unknown>;
+    routingHistory: _langchain_langgraph.BaseChannel<{
+        timestamp: number;
+        reasoning: string;
+        confidence: number;
+        targetAgent: string | null;
+        targetAgents: string[] | null;
+        strategy: "llm-based" | "rule-based" | "round-robin" | "skill-based" | "load-balanced";
+    }[], {
+        timestamp: number;
+        reasoning: string;
+        confidence: number;
+        targetAgent: string | null;
+        targetAgents: string[] | null;
+        strategy: "llm-based" | "rule-based" | "round-robin" | "skill-based" | "load-balanced";
+    }[], unknown>;
+    activeAssignments: _langchain_langgraph.BaseChannel<{
+        id: string;
+        workerId: string;
+        task: string;
+        priority: number;
+        assignedAt: number;
+        deadline?: number | undefined;
+    }[], {
+        id: string;
+        workerId: string;
+        task: string;
+        priority: number;
+        assignedAt: number;
+        deadline?: number | undefined;
+    }[], unknown>;
+    completedTasks: _langchain_langgraph.BaseChannel<{
+        result: string;
+        success: boolean;
+        workerId: string;
+        assignmentId: string;
+        completedAt: number;
+        metadata?: Record<string, any> | undefined;
+        error?: string | undefined;
+    }[], {
+        result: string;
+        success: boolean;
+        workerId: string;
+        assignmentId: string;
+        completedAt: number;
+        metadata?: Record<string, any> | undefined;
+        error?: string | undefined;
+    }[], unknown>;
+    handoffs: _langchain_langgraph.BaseChannel<{
+        timestamp: string;
+        reason: string;
+        from: string;
+        to: string;
+        context?: any;
+    }[], {
+        timestamp: string;
+        reason: string;
+        from: string;
+        to: string;
+        context?: any;
+    }[], unknown>;
+    status: _langchain_langgraph.BaseChannel<"failed" | "executing" | "completed" | "initializing" | "routing" | "coordinating" | "aggregating", "failed" | "executing" | "completed" | "initializing" | "routing" | "coordinating" | "aggregating", unknown>;
+    iteration: _langchain_langgraph.BaseChannel<number, number, unknown>;
+    maxIterations: _langchain_langgraph.BaseChannel<number, number, unknown>;
+    response: _langchain_langgraph.BaseChannel<string | undefined, string | undefined, unknown>;
+    error: _langchain_langgraph.BaseChannel<string | undefined, string | undefined, unknown>;
+}>;
 /**
  * TypeScript type for Multi-Agent state
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentforge/patterns",
-  "version": "0.15.7",
+  "version": "0.15.8",
   "description": "Production-ready agent workflow patterns for TypeScript including ReAct and Planner-Executor, built on LangGraph.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -41,13 +41,13 @@
     "url": "https://github.com/TVScoundrel/agentforge/issues"
   },
   "dependencies": {
-    "@agentforge/core": "0.15.7",
+    "@agentforge/core": "0.15.8",
     "@langchain/core": "^1.1.17",
     "@langchain/langgraph": "^1.1.2",
     "zod": "^3.23.8"
   },
   "devDependencies": {
-    "@agentforge/testing": "0.15.7",
+    "@agentforge/testing": "0.15.8",
     "@eslint/js": "^9.17.0",
     "@types/node": "^22.10.2",
     "eslint": "^9.17.0",