opencode-swarm 5.0.4 → 5.0.6

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.6",
 	"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",

package/dist/guardrails.js

@@ -1,178 +0,0 @@
-// src/state.ts
-var swarmState = {
-  activeToolCalls: new Map,
-  toolAggregates: new Map,
-  activeAgent: new Map,
-  delegationChains: new Map,
-  pendingEvents: 0,
-  agentSessions: new Map
-};
-function startAgentSession(sessionId, agentName, staleDurationMs = 3600000) {
-  const now = Date.now();
-  for (const [id, session] of swarmState.agentSessions) {
-    if (now - session.startTime > staleDurationMs) {
-      swarmState.agentSessions.delete(id);
-    }
-  }
-  const sessionState = {
-    agentName,
-    startTime: now,
-    toolCallCount: 0,
-    consecutiveErrors: 0,
-    recentToolCalls: [],
-    warningIssued: false,
-    hardLimitHit: false
-  };
-  swarmState.agentSessions.set(sessionId, sessionState);
-}
-function getAgentSession(sessionId) {
-  return swarmState.agentSessions.get(sessionId);
-}
-// src/utils/logger.ts
-var DEBUG = process.env.OPENCODE_SWARM_DEBUG === "1";
-function warn(message, data) {
-  const timestamp = new Date().toISOString();
-  if (data !== undefined) {
-    console.warn(`[opencode-swarm ${timestamp}] WARN: ${message}`, data);
-  } else {
-    console.warn(`[opencode-swarm ${timestamp}] WARN: ${message}`);
-  }
-}
-// src/hooks/guardrails.ts
-function createGuardrailsHooks(config) {
-  if (config.enabled === false) {
-    return {
-      toolBefore: async () => {},
-      toolAfter: async () => {},
-      messagesTransform: async () => {}
-    };
-  }
-  return {
-    toolBefore: async (input, output) => {
-      let session = getAgentSession(input.sessionID);
-      if (!session) {
-        startAgentSession(input.sessionID, "unknown");
-        session = getAgentSession(input.sessionID);
-        if (!session) {
-          warn(`Failed to create session for ${input.sessionID}`);
-          return;
-        }
-      }
-      if (session.hardLimitHit) {
-        throw new Error("\uD83D\uDED1 CIRCUIT BREAKER: Agent blocked. Hard limit was previously triggered. Stop making tool calls and return your progress summary.");
-      }
-      session.toolCallCount++;
-      const hash = hashArgs(output.args);
-      session.recentToolCalls.push({
-        tool: input.tool,
-        argsHash: hash,
-        timestamp: Date.now()
-      });
-      if (session.recentToolCalls.length > 20) {
-        session.recentToolCalls.shift();
-      }
-      let repetitionCount = 0;
-      if (session.recentToolCalls.length > 0) {
-        const lastEntry = session.recentToolCalls[session.recentToolCalls.length - 1];
-        for (let i = session.recentToolCalls.length - 1;i >= 0; i--) {
-          const entry = session.recentToolCalls[i];
-          if (entry.tool === lastEntry.tool && entry.argsHash === lastEntry.argsHash) {
-            repetitionCount++;
-          } else {
-            break;
-          }
-        }
-      }
-      const elapsedMinutes = (Date.now() - session.startTime) / 60000;
-      if (session.toolCallCount >= config.max_tool_calls) {
-        session.hardLimitHit = true;
-        throw new Error(`\uD83D\uDED1 CIRCUIT BREAKER: Tool call limit reached (${session.toolCallCount}/${config.max_tool_calls}). Stop making tool calls and return your progress summary.`);
-      }
-      if (elapsedMinutes >= config.max_duration_minutes) {
-        session.hardLimitHit = true;
-        throw new Error(`\uD83D\uDED1 CIRCUIT BREAKER: Duration limit reached (${Math.floor(elapsedMinutes)} min). Stop making tool calls and return your progress summary.`);
-      }
-      if (repetitionCount >= config.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.`);
-      }
-      if (session.consecutiveErrors >= config.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.`);
-      }
-      if (!session.warningIssued) {
-        const toolWarning = session.toolCallCount >= config.max_tool_calls * config.warning_threshold;
-        const durationWarning = elapsedMinutes >= config.max_duration_minutes * config.warning_threshold;
-        const repetitionWarning = repetitionCount >= config.max_repetitions * config.warning_threshold;
-        const errorWarning = session.consecutiveErrors >= config.max_consecutive_errors * config.warning_threshold;
-        if (toolWarning || durationWarning || repetitionWarning || errorWarning) {
-          session.warningIssued = true;
-        }
-      }
-    },
-    toolAfter: async (input, output) => {
-      const session = getAgentSession(input.sessionID);
-      if (!session) {
-        return;
-      }
-      const outputStr = String(output.output ?? "");
-      const hasError = output.output === null || output.output === undefined || outputStr === "" || outputStr.toLowerCase().includes("error");
-      if (hasError) {
-        session.consecutiveErrors++;
-      } else {
-        session.consecutiveErrors = 0;
-      }
-    },
-    messagesTransform: async (input, output) => {
-      const messages = output.messages;
-      if (!messages || messages.length === 0) {
-        return;
-      }
-      const lastMessage = messages[messages.length - 1];
-      let sessionId = lastMessage.info?.sessionID;
-      if (!sessionId) {
-        for (const [id, session2] of swarmState.agentSessions) {
-          if (session2.warningIssued || session2.hardLimitHit) {
-            sessionId = id;
-            break;
-          }
-        }
-      }
-      if (!sessionId) {
-        return;
-      }
-      const session = getAgentSession(sessionId);
-      if (!session || !session.warningIssued && !session.hardLimitHit) {
-        return;
-      }
-      const textPart = lastMessage.parts.find((part) => part.type === "text" && typeof part.text === "string");
-      if (!textPart) {
-        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;
-      } else if (session.warningIssued) {
-        textPart.text = `[⚠️ 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.]
-
-` + textPart.text;
-      }
-    }
-  };
-}
-function hashArgs(args) {
-  try {
-    if (typeof args !== "object" || args === null) {
-      return 0;
-    }
-    const sortedKeys = Object.keys(args).sort();
-    return Number(Bun.hash(JSON.stringify(args, sortedKeys)));
-  } catch {
-    return 0;
-  }
-}
-export {
-  hashArgs,
-  createGuardrailsHooks
-};

package/dist/state.js

@@ -1,48 +0,0 @@
-// src/state.ts
-var swarmState = {
-  activeToolCalls: new Map,
-  toolAggregates: new Map,
-  activeAgent: new Map,
-  delegationChains: new Map,
-  pendingEvents: 0,
-  agentSessions: new Map
-};
-function resetSwarmState() {
-  swarmState.activeToolCalls.clear();
-  swarmState.toolAggregates.clear();
-  swarmState.activeAgent.clear();
-  swarmState.delegationChains.clear();
-  swarmState.pendingEvents = 0;
-  swarmState.agentSessions.clear();
-}
-function startAgentSession(sessionId, agentName, staleDurationMs = 3600000) {
-  const now = Date.now();
-  for (const [id, session] of swarmState.agentSessions) {
-    if (now - session.startTime > staleDurationMs) {
-      swarmState.agentSessions.delete(id);
-    }
-  }
-  const sessionState = {
-    agentName,
-    startTime: now,
-    toolCallCount: 0,
-    consecutiveErrors: 0,
-    recentToolCalls: [],
-    warningIssued: false,
-    hardLimitHit: false
-  };
-  swarmState.agentSessions.set(sessionId, sessionState);
-}
-function endAgentSession(sessionId) {
-  swarmState.agentSessions.delete(sessionId);
-}
-function getAgentSession(sessionId) {
-  return swarmState.agentSessions.get(sessionId);
-}
-export {
-  swarmState,
-  startAgentSession,
-  resetSwarmState,
-  getAgentSession,
-  endAgentSession
-};