@lov3kaizen/agentsea-core 1.0.0 → 1.1.0

package/dist/index.d.mts

@@ -374,6 +374,7 @@ declare abstract class Workflow {
     constructor(config: WorkflowConfig, provider: LLMProvider, toolRegistry: ToolRegistry, memory?: MemoryStore | undefined);
     private initializeAgents;
     abstract execute(input: string, context: AgentContext): Promise<AgentResponse>;
+    protected executeAgent(agent: Agent, input: string, context: AgentContext): Promise<AgentResponse>;
     protected handleError(error: Error, agentName: string, _context: AgentContext): AgentResponse | null;
     protected getAgent(name: string): Agent;
 }

package/dist/index.d.ts

@@ -374,6 +374,7 @@ declare abstract class Workflow {
     constructor(config: WorkflowConfig, provider: LLMProvider, toolRegistry: ToolRegistry, memory?: MemoryStore | undefined);
     private initializeAgents;
     abstract execute(input: string, context: AgentContext): Promise<AgentResponse>;
+    protected executeAgent(agent: Agent, input: string, context: AgentContext): Promise<AgentResponse>;
     protected handleError(error: Error, agentName: string, _context: AgentContext): AgentResponse | null;
     protected getAgent(name: string): Agent;
 }

package/dist/index.js

@@ -3536,6 +3536,37 @@ var Workflow = class {
       this.agents.set(agentConfig.name, agent);
     }
   }
+  /**
+   * Run a single agent, applying the `retry` error-handling strategy when
+   * configured. On the `retry` strategy the agent is re-invoked up to
+   * `retry.maxAttempts` times (with optional fixed/exponential backoff) before
+   * the final error propagates to {@link handleError}. For every other strategy
+   * the agent runs exactly once and any error propagates unchanged.
+   */
+  async executeAgent(agent, input, context) {
+    if ((this.config.errorHandling ?? "fail-fast") !== "retry") {
+      return agent.execute(input, context);
+    }
+    const maxAttempts = Math.max(1, this.config.retry?.maxAttempts ?? 3);
+    const initialDelayMs = this.config.retry?.initialDelayMs ?? 0;
+    const maxDelayMs = this.config.retry?.maxDelayMs ?? Infinity;
+    const backoff = this.config.retry?.backoff ?? "exponential";
+    let lastError;
+    for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+      try {
+        return await agent.execute(input, context);
+      } catch (error) {
+        lastError = error;
+        if (attempt < maxAttempts && initialDelayMs > 0) {
+          const raw = backoff === "linear" ? initialDelayMs * attempt : initialDelayMs * 2 ** (attempt - 1);
+          await new Promise(
+            (resolve) => setTimeout(resolve, Math.min(raw, maxDelayMs))
+          );
+        }
+      }
+    }
+    throw lastError ?? new Error("Agent execution failed after retries");
+  }
   /**
    * Handle errors based on the configured strategy
    */
@@ -3585,7 +3616,7 @@ var SequentialWorkflow = class extends Workflow {
     for (const agentConfig of this.config.agents) {
       try {
         const agent = this.getAgent(agentConfig.name);
-        const response = await agent.execute(currentInput, context);
+        const response = await this.executeAgent(agent, currentInput, context);
         totalTokens += response.metadata.tokensUsed;
         totalIterations += response.metadata.iterations;
         currentInput = response.content;
@@ -3632,7 +3663,7 @@ var ParallelWorkflow = class extends Workflow {
     const promises = this.config.agents.map(async (agentConfig) => {
       try {
         const agent = this.getAgent(agentConfig.name);
-        const response = await agent.execute(input, context);
+        const response = await this.executeAgent(agent, input, context);
         return {
           agentName: agentConfig.name,
           response,
@@ -3701,7 +3732,7 @@ var SupervisorWorkflow = class extends Workflow {
       routingCount++;
       try {
         const agent = this.getAgent(currentAgentName);
-        const response = await agent.execute(currentInput, context);
+        const response = await this.executeAgent(agent, currentInput, context);
         totalTokens += response.metadata.tokensUsed;
         totalIterations += response.metadata.iterations;
         finalResponse = response;

package/dist/index.mjs

@@ -3526,6 +3526,37 @@ var Workflow = class {
       this.agents.set(agentConfig.name, agent);
     }
   }
+  /**
+   * Run a single agent, applying the `retry` error-handling strategy when
+   * configured. On the `retry` strategy the agent is re-invoked up to
+   * `retry.maxAttempts` times (with optional fixed/exponential backoff) before
+   * the final error propagates to {@link handleError}. For every other strategy
+   * the agent runs exactly once and any error propagates unchanged.
+   */
+  async executeAgent(agent, input, context) {
+    if ((this.config.errorHandling ?? "fail-fast") !== "retry") {
+      return agent.execute(input, context);
+    }
+    const maxAttempts = Math.max(1, this.config.retry?.maxAttempts ?? 3);
+    const initialDelayMs = this.config.retry?.initialDelayMs ?? 0;
+    const maxDelayMs = this.config.retry?.maxDelayMs ?? Infinity;
+    const backoff = this.config.retry?.backoff ?? "exponential";
+    let lastError;
+    for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+      try {
+        return await agent.execute(input, context);
+      } catch (error) {
+        lastError = error;
+        if (attempt < maxAttempts && initialDelayMs > 0) {
+          const raw = backoff === "linear" ? initialDelayMs * attempt : initialDelayMs * 2 ** (attempt - 1);
+          await new Promise(
+            (resolve) => setTimeout(resolve, Math.min(raw, maxDelayMs))
+          );
+        }
+      }
+    }
+    throw lastError ?? new Error("Agent execution failed after retries");
+  }
   /**
    * Handle errors based on the configured strategy
    */
@@ -3575,7 +3606,7 @@ var SequentialWorkflow = class extends Workflow {
     for (const agentConfig of this.config.agents) {
       try {
         const agent = this.getAgent(agentConfig.name);
-        const response = await agent.execute(currentInput, context);
+        const response = await this.executeAgent(agent, currentInput, context);
         totalTokens += response.metadata.tokensUsed;
         totalIterations += response.metadata.iterations;
         currentInput = response.content;
@@ -3622,7 +3653,7 @@ var ParallelWorkflow = class extends Workflow {
     const promises = this.config.agents.map(async (agentConfig) => {
       try {
         const agent = this.getAgent(agentConfig.name);
-        const response = await agent.execute(input, context);
+        const response = await this.executeAgent(agent, input, context);
         return {
           agentName: agentConfig.name,
           response,
@@ -3691,7 +3722,7 @@ var SupervisorWorkflow = class extends Workflow {
       routingCount++;
       try {
         const agent = this.getAgent(currentAgentName);
-        const response = await agent.execute(currentInput, context);
+        const response = await this.executeAgent(agent, currentInput, context);
         totalTokens += response.metadata.tokensUsed;
         totalIterations += response.metadata.iterations;
         finalResponse = response;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lov3kaizen/agentsea-core",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "AgentSea - Unite and orchestrate AI agents. A production-ready ADK for building agentic AI applications with multi-provider support.",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -25,7 +25,7 @@
     "winston": "^3.19.0",
     "ioredis": "^5.11.1",
     "marked": "^12.0.2",
-    "@lov3kaizen/agentsea-types": "1.0.0"
+    "@lov3kaizen/agentsea-types": "1.1.0"
   },
   "devDependencies": {
     "@types/node": "^20.19.0",
@@ -72,7 +72,7 @@
     "nodejs"
   ],
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=20.0.0"
   },
   "author": "lovekaizen",
   "license": "MIT",