expxagents 0.24.1 → 0.24.2

package/assets/core/runner.pipeline.md

@@ -43,6 +43,35 @@ For each pipeline step:
    - Write state.json immediately
 6. **Handoff delay** (2 seconds for dashboard animation)
 
+#### Step Failure Handling (on_fail)
+
+Each step can define `on_fail` in squad.yaml:
+
+- `abort` (default) — stop the pipeline immediately
+- `skip` — log the error, mark agent as done with skip message, continue to next step
+- `retry` — retry the step up to `max_retries` times (default: 2), then abort
+
+Example in squad.yaml:
+```yaml
+pipeline:
+  steps:
+    - id: step-01
+      agent: transcriber
+      label: Extract transcript
+      on_fail: skip      # continue pipeline if transcript fails
+    - id: step-02
+      agent: writer
+      label: Write article
+      on_fail: retry
+      max_retries: 3     # try up to 4 times total
+```
+
+When a step is skipped:
+1. Set agent status → `done`
+2. Set agent message → "Skipped: [error reason]"
+3. Write state.json
+4. Continue to next step (the next agent may need to handle missing input)
+
 #### Checkpoint Steps (type: checkpoint)
 
 1. **Set status** → `checkpoint` in state.json

package/dist/cli/src/commands/run.js

@@ -178,6 +178,7 @@ export async function runCommand(name) {
         console.log(`Pipeline: ${config.squad.pipeline.steps.length} steps\n`);
     }
     const steps = config.squad.pipeline.steps;
+    const stepAttempts = new Map();
     for (let i = 0; i < steps.length; i++) {
         const step = steps[i];
         const stepNumber = i + 1;
@@ -210,7 +211,32 @@ export async function runCommand(name) {
             output = await runWithProvider(prompt, agent, squadDir, spawnClaudeCode);
         }
         catch (err) {
-            console.error(`\nStep ${stepNumber} failed: ${err.message}`);
+            const failAction = step.onFail ?? 'abort';
+            console.error(`\nStep ${stepNumber} failed: ${err.message} [on_fail: ${failAction}]`);
+            if (failAction === 'retry') {
+                const maxRetries = step.maxRetries ?? 2;
+                const attempt = stepAttempts.get(step.id) ?? 0;
+                if (attempt < maxRetries) {
+                    stepAttempts.set(step.id, attempt + 1);
+                    console.log(`\nRetrying step ${stepNumber} (attempt ${attempt + 2}/${maxRetries + 1})...\n`);
+                    state = updateAgentStatus(state, step.agent, 'idle');
+                    writeState(squadDir, state);
+                    i--;
+                    continue;
+                }
+                console.error(`\nStep ${stepNumber} failed after ${maxRetries + 1} attempts. Aborting.`);
+            }
+            if (failAction === 'skip') {
+                console.log(`\nSkipping step ${stepNumber} (on_fail: skip). Continuing pipeline.\n`);
+                state = updateAgentStatus(state, step.agent, 'done');
+                state = {
+                    ...state,
+                    agents: state.agents.map((a) => a.id === step.agent ? { ...a, message: `Skipped: ${err.message}` } : a),
+                };
+                writeState(squadDir, state);
+                continue;
+            }
+            // Default: abort
             state = updateAgentStatus(state, step.agent, 'idle');
             state = setSquadStatus(state, 'idle');
             writeState(squadDir, state);

package/dist/core/squad-loader.d.ts

@@ -12,6 +12,8 @@ export interface PipelineStep {
     agent: string;
     label: string;
     deliverFrom?: string;
+    onFail?: 'skip' | 'retry' | 'abort';
+    maxRetries?: number;
 }
 export interface ScheduleConfig {
     enabled: boolean;

package/dist/core/squad-loader.js

@@ -122,6 +122,14 @@ export function loadSquad(squadDir) {
         };
     }
     const mcps = Array.isArray(squad.mcps) ? squad.mcps : [];
+    const mappedSteps = steps.map((s) => ({
+        id: s.id,
+        agent: s.agent,
+        label: s.label,
+        deliverFrom: s.deliverFrom ?? s.deliver_from,
+        onFail: ['skip', 'retry', 'abort'].includes(s.on_fail) ? s.on_fail : undefined,
+        maxRetries: typeof s.max_retries === 'number' ? s.max_retries : undefined,
+    }));
     return {
         squad: {
             code: squad.code,
@@ -134,7 +142,7 @@ export function loadSquad(squadDir) {
             icon: squad.icon,
             agents,
             skills,
-            pipeline: { steps },
+            pipeline: { steps: mappedSteps },
             schedule,
             chain,
             webhooks,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expxagents",
-  "version": "0.24.1",
+  "version": "0.24.2",
   "description": "Multi-agent orchestration platform for AI squads",
   "author": "ExpxAgents",
   "license": "MIT",