opencode-swarm 5.0.4 → 5.0.5

package/dist/config/schema.d.ts

@@ -45,7 +45,15 @@ export declare const GuardrailsProfileSchema: z.ZodObject<{
     warning_threshold: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 export type GuardrailsProfile = z.infer<typeof GuardrailsProfileSchema>;
-export declare const DEFAULT_ARCHITECT_PROFILE: GuardrailsProfile;
+export declare const DEFAULT_AGENT_PROFILES: Record<string, GuardrailsProfile>;
+/** @deprecated Use DEFAULT_AGENT_PROFILES.architect instead */
+export declare const DEFAULT_ARCHITECT_PROFILE: {
+    max_tool_calls?: number | undefined;
+    max_duration_minutes?: number | undefined;
+    max_repetitions?: number | undefined;
+    max_consecutive_errors?: number | undefined;
+    warning_threshold?: number | undefined;
+};
 export declare const GuardrailsConfigSchema: z.ZodObject<{
     enabled: z.ZodDefault<z.ZodBoolean>;
     max_tool_calls: z.ZodDefault<z.ZodNumber>;
@@ -76,7 +84,7 @@ export type GuardrailsConfig = z.infer<typeof GuardrailsConfigSchema>;
 export declare function stripKnownSwarmPrefix(name: string): string;
 /**
  * Resolve guardrails configuration for a specific agent.
- * Merges the base config with built-in defaults (for the architect) and
+ * Merges the base config with built-in agent-type defaults and
  * any per-agent profile overrides. Merge order: base < built-in < user profile.
  *
  * @param base - The base guardrails configuration

package/dist/index.js

@@ -13623,19 +13623,52 @@ var GuardrailsProfileSchema = exports_external.object({
   max_consecutive_errors: exports_external.number().min(2).max(20).optional(),
   warning_threshold: exports_external.number().min(0.1).max(0.9).optional()
 });
-var DEFAULT_ARCHITECT_PROFILE = {
-  max_tool_calls: 600,
-  max_duration_minutes: 90,
-  max_consecutive_errors: 8,
-  warning_threshold: 0.7
+var DEFAULT_AGENT_PROFILES = {
+  architect: {
+    max_tool_calls: 800,
+    max_duration_minutes: 90,
+    max_consecutive_errors: 8,
+    warning_threshold: 0.75
+  },
+  coder: {
+    max_tool_calls: 400,
+    max_duration_minutes: 45,
+    warning_threshold: 0.85
+  },
+  test_engineer: {
+    max_tool_calls: 400,
+    max_duration_minutes: 45,
+    warning_threshold: 0.85
+  },
+  explorer: {
+    max_tool_calls: 150,
+    max_duration_minutes: 20,
+    warning_threshold: 0.75
+  },
+  reviewer: {
+    max_tool_calls: 200,
+    max_duration_minutes: 30,
+    warning_threshold: 0.65
+  },
+  critic: {
+    max_tool_calls: 200,
+    max_duration_minutes: 30,
+    warning_threshold: 0.65
+  },
+  sme: {
+    max_tool_calls: 200,
+    max_duration_minutes: 30,
+    warning_threshold: 0.65
+  }
 };
+var DEFAULT_ARCHITECT_PROFILE = DEFAULT_AGENT_PROFILES.architect;
 var GuardrailsConfigSchema = exports_external.object({
   enabled: exports_external.boolean().default(true),
   max_tool_calls: exports_external.number().min(10).max(1000).default(200),
   max_duration_minutes: exports_external.number().min(1).max(120).default(30),
   max_repetitions: exports_external.number().min(3).max(50).default(10),
   max_consecutive_errors: exports_external.number().min(2).max(20).default(5),
-  warning_threshold: exports_external.number().min(0.1).max(0.9).default(0.5),
+  warning_threshold: exports_external.number().min(0.1).max(0.9).default(0.75),
   profiles: exports_external.record(exports_external.string(), GuardrailsProfileSchema).optional()
 });
 function stripKnownSwarmPrefix(name) {
@@ -13656,7 +13689,7 @@ function resolveGuardrailsConfig(base, agentName) {
     return base;
   }
   const baseName = stripKnownSwarmPrefix(agentName);
-  const builtIn = baseName === ORCHESTRATOR_NAME ? DEFAULT_ARCHITECT_PROFILE : undefined;
+  const builtIn = DEFAULT_AGENT_PROFILES[baseName];
   const userProfile = base.profiles?.[baseName] ?? base.profiles?.[agentName];
   if (!builtIn && !userProfile) {
     return base;
@@ -15974,6 +16007,7 @@ function startAgentSession(sessionId, agentName, staleDurationMs = 7200000) {
     consecutiveErrors: 0,
     recentToolCalls: [],
     warningIssued: false,
+    warningReason: "",
     hardLimitHit: false
   };
   swarmState.agentSessions.set(sessionId, sessionState);
@@ -16291,7 +16325,7 @@ function createGuardrailsHooks(config2) {
           resolvedMaxCalls: agentConfig.max_tool_calls,
           currentCalls: session.toolCallCount
         });
-        throw new Error(`\uD83D\uDED1 CIRCUIT BREAKER: Tool call limit reached (${session.toolCallCount}/${agentConfig.max_tool_calls}). Stop making tool calls and return your progress summary.`);
+        throw new Error(`\uD83D\uDED1 LIMIT REACHED: Tool calls exhausted (${session.toolCallCount}/${agentConfig.max_tool_calls}). Finish the current operation and return your progress summary.`);
       }
       if (elapsedMinutes >= agentConfig.max_duration_minutes) {
         session.hardLimitHit = true;
@@ -16301,23 +16335,37 @@ function createGuardrailsHooks(config2) {
           resolvedMaxMinutes: agentConfig.max_duration_minutes,
           elapsedMinutes: Math.floor(elapsedMinutes)
         });
-        throw new Error(`\uD83D\uDED1 CIRCUIT BREAKER: Duration limit reached (${Math.floor(elapsedMinutes)} min). Stop making tool calls and return your progress summary.`);
+        throw new Error(`\uD83D\uDED1 LIMIT REACHED: Duration exhausted (${Math.floor(elapsedMinutes)}/${agentConfig.max_duration_minutes} min). Finish the current operation and return your progress summary.`);
       }
       if (repetitionCount >= agentConfig.max_repetitions) {
         session.hardLimitHit = true;
-        throw new Error(`\uD83D\uDED1 CIRCUIT BREAKER: Repetition detected (same call ${repetitionCount} times). Stop making tool calls and return your progress summary.`);
+        throw new Error(`\uD83D\uDED1 LIMIT REACHED: Repeated the same tool call ${repetitionCount} times. This suggests a loop. Return your progress summary.`);
       }
       if (session.consecutiveErrors >= agentConfig.max_consecutive_errors) {
         session.hardLimitHit = true;
-        throw new Error(`\uD83D\uDED1 CIRCUIT BREAKER: Too many consecutive errors (${session.consecutiveErrors}). Stop making tool calls and return your progress summary.`);
+        throw new Error(`\uD83D\uDED1 LIMIT REACHED: ${session.consecutiveErrors} consecutive tool errors detected. Return your progress summary with details of what went wrong.`);
       }
       if (!session.warningIssued) {
-        const toolWarning = session.toolCallCount >= agentConfig.max_tool_calls * agentConfig.warning_threshold;
-        const durationWarning = elapsedMinutes >= agentConfig.max_duration_minutes * agentConfig.warning_threshold;
-        const repetitionWarning = repetitionCount >= agentConfig.max_repetitions * agentConfig.warning_threshold;
-        const errorWarning = session.consecutiveErrors >= agentConfig.max_consecutive_errors * agentConfig.warning_threshold;
-        if (toolWarning || durationWarning || repetitionWarning || errorWarning) {
+        const toolPct = session.toolCallCount / agentConfig.max_tool_calls;
+        const durationPct = elapsedMinutes / agentConfig.max_duration_minutes;
+        const repPct = repetitionCount / agentConfig.max_repetitions;
+        const errorPct = session.consecutiveErrors / agentConfig.max_consecutive_errors;
+        const reasons = [];
+        if (toolPct >= agentConfig.warning_threshold) {
+          reasons.push(`tool calls ${session.toolCallCount}/${agentConfig.max_tool_calls}`);
+        }
+        if (durationPct >= agentConfig.warning_threshold) {
+          reasons.push(`duration ${Math.floor(elapsedMinutes)}/${agentConfig.max_duration_minutes} min`);
+        }
+        if (repPct >= agentConfig.warning_threshold) {
+          reasons.push(`repetitions ${repetitionCount}/${agentConfig.max_repetitions}`);
+        }
+        if (errorPct >= agentConfig.warning_threshold) {
+          reasons.push(`errors ${session.consecutiveErrors}/${agentConfig.max_consecutive_errors}`);
+        }
+        if (reasons.length > 0) {
           session.warningIssued = true;
+          session.warningReason = reasons.join(", ");
         }
       }
     },
@@ -16360,11 +16408,12 @@ function createGuardrailsHooks(config2) {
         return;
       }
       if (session.hardLimitHit) {
-        textPart.text = `[\uD83D\uDED1 CIRCUIT BREAKER ACTIVE: You have exceeded your resource limits. Do NOT make any more tool calls. Immediately return a summary of your progress so far. Any further tool calls will be blocked.]
+        textPart.text = `[\uD83D\uDED1 LIMIT REACHED: Your resource budget is exhausted. Do not make additional tool calls. Return a summary of your progress and any remaining work.]
 
 ` + textPart.text;
       } else if (session.warningIssued) {
-        textPart.text = `[\u26A0\uFE0F GUARDRAIL WARNING: You are approaching resource limits. Please wrap up your current task efficiently. Avoid unnecessary tool calls and prepare to return your results soon.]
+        const reasonSuffix = session.warningReason ? ` (${session.warningReason})` : "";
+        textPart.text = `[\u26A0\uFE0F APPROACHING LIMITS${reasonSuffix}: You still have capacity to finish your current step. Complete what you're working on, then return your results.]
 
 ` + textPart.text;
       }

package/dist/state.d.ts

@@ -55,6 +55,8 @@ export interface AgentSessionState {
     }>;
     /** Whether a soft warning has been issued */
     warningIssued: boolean;
+    /** Human-readable warning reason (set when warningIssued = true) */
+    warningReason: string;
     /** Whether a hard limit has been triggered */
     hardLimitHit: boolean;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "opencode-swarm",
-	"version": "5.0.4",
+	"version": "5.0.5",
 	"description": "Architect-centric agentic swarm plugin for OpenCode - hub-and-spoke orchestration with SME consultation, code generation, and QA review",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",