opencode-swarm 5.0.5 → 5.0.8

package/dist/config/schema.d.ts

@@ -43,6 +43,7 @@ export declare const GuardrailsProfileSchema: z.ZodObject<{
     max_repetitions: z.ZodOptional<z.ZodNumber>;
     max_consecutive_errors: z.ZodOptional<z.ZodNumber>;
     warning_threshold: z.ZodOptional<z.ZodNumber>;
+    idle_timeout_minutes: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 export type GuardrailsProfile = z.infer<typeof GuardrailsProfileSchema>;
 export declare const DEFAULT_AGENT_PROFILES: Record<string, GuardrailsProfile>;
@@ -53,6 +54,7 @@ export declare const DEFAULT_ARCHITECT_PROFILE: {
     max_repetitions?: number | undefined;
     max_consecutive_errors?: number | undefined;
     warning_threshold?: number | undefined;
+    idle_timeout_minutes?: number | undefined;
 };
 export declare const GuardrailsConfigSchema: z.ZodObject<{
     enabled: z.ZodDefault<z.ZodBoolean>;
@@ -61,12 +63,14 @@ export declare const GuardrailsConfigSchema: z.ZodObject<{
     max_repetitions: z.ZodDefault<z.ZodNumber>;
     max_consecutive_errors: z.ZodDefault<z.ZodNumber>;
     warning_threshold: z.ZodDefault<z.ZodNumber>;
+    idle_timeout_minutes: z.ZodDefault<z.ZodNumber>;
     profiles: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
         max_tool_calls: z.ZodOptional<z.ZodNumber>;
         max_duration_minutes: z.ZodOptional<z.ZodNumber>;
         max_repetitions: z.ZodOptional<z.ZodNumber>;
         max_consecutive_errors: z.ZodOptional<z.ZodNumber>;
         warning_threshold: z.ZodOptional<z.ZodNumber>;
+        idle_timeout_minutes: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>>;
 }, z.core.$strip>;
 export type GuardrailsConfig = z.infer<typeof GuardrailsConfigSchema>;
@@ -130,12 +134,14 @@ export declare const PluginConfigSchema: z.ZodObject<{
         max_repetitions: z.ZodDefault<z.ZodNumber>;
         max_consecutive_errors: z.ZodDefault<z.ZodNumber>;
         warning_threshold: z.ZodDefault<z.ZodNumber>;
+        idle_timeout_minutes: z.ZodDefault<z.ZodNumber>;
         profiles: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
             max_tool_calls: z.ZodOptional<z.ZodNumber>;
             max_duration_minutes: z.ZodOptional<z.ZodNumber>;
             max_repetitions: z.ZodOptional<z.ZodNumber>;
             max_consecutive_errors: z.ZodOptional<z.ZodNumber>;
             warning_threshold: z.ZodOptional<z.ZodNumber>;
+            idle_timeout_minutes: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>>;
     }, z.core.$strip>>;
     evidence: z.ZodOptional<z.ZodObject<{

package/dist/index.js

@@ -13618,15 +13618,16 @@ var EvidenceConfigSchema = exports_external.object({
 });
 var GuardrailsProfileSchema = exports_external.object({
   max_tool_calls: exports_external.number().min(10).max(1000).optional(),
-  max_duration_minutes: exports_external.number().min(1).max(120).optional(),
+  max_duration_minutes: exports_external.number().min(0).max(480).optional(),
   max_repetitions: exports_external.number().min(3).max(50).optional(),
   max_consecutive_errors: exports_external.number().min(2).max(20).optional(),
-  warning_threshold: exports_external.number().min(0.1).max(0.9).optional()
+  warning_threshold: exports_external.number().min(0.1).max(0.9).optional(),
+  idle_timeout_minutes: exports_external.number().min(5).max(240).optional()
 });
 var DEFAULT_AGENT_PROFILES = {
   architect: {
     max_tool_calls: 800,
-    max_duration_minutes: 90,
+    max_duration_minutes: 0,
     max_consecutive_errors: 8,
     warning_threshold: 0.75
   },
@@ -13665,10 +13666,11 @@ 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_duration_minutes: exports_external.number().min(0).max(480).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.75),
+  idle_timeout_minutes: exports_external.number().min(5).max(240).default(60),
   profiles: exports_external.record(exports_external.string(), GuardrailsProfileSchema).optional()
 });
 function stripKnownSwarmPrefix(name) {
@@ -16008,7 +16010,8 @@ function startAgentSession(sessionId, agentName, staleDurationMs = 7200000) {
     recentToolCalls: [],
     warningIssued: false,
     warningReason: "",
-    hardLimitHit: false
+    hardLimitHit: false,
+    lastSuccessTime: now
   };
   swarmState.agentSessions.set(sessionId, sessionState);
 }
@@ -16327,7 +16330,7 @@ function createGuardrailsHooks(config2) {
         });
         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) {
+      if (agentConfig.max_duration_minutes > 0 && elapsedMinutes >= agentConfig.max_duration_minutes) {
         session.hardLimitHit = true;
         warn("Circuit breaker: duration limit hit", {
           sessionID: input.sessionID,
@@ -16345,9 +16348,20 @@ function createGuardrailsHooks(config2) {
         session.hardLimitHit = true;
         throw new Error(`\uD83D\uDED1 LIMIT REACHED: ${session.consecutiveErrors} consecutive tool errors detected. Return your progress summary with details of what went wrong.`);
       }
+      const idleMinutes = (Date.now() - session.lastSuccessTime) / 60000;
+      if (idleMinutes >= agentConfig.idle_timeout_minutes) {
+        session.hardLimitHit = true;
+        warn("Circuit breaker: idle timeout hit", {
+          sessionID: input.sessionID,
+          agentName: session.agentName,
+          idleTimeoutMinutes: agentConfig.idle_timeout_minutes,
+          idleMinutes: Math.floor(idleMinutes)
+        });
+        throw new Error(`\uD83D\uDED1 LIMIT REACHED: No successful tool call for ${Math.floor(idleMinutes)} minutes (idle timeout: ${agentConfig.idle_timeout_minutes} min). This suggests the agent may be stuck. Return your progress summary.`);
+      }
       if (!session.warningIssued) {
         const toolPct = session.toolCallCount / agentConfig.max_tool_calls;
-        const durationPct = elapsedMinutes / agentConfig.max_duration_minutes;
+        const durationPct = agentConfig.max_duration_minutes > 0 ? elapsedMinutes / agentConfig.max_duration_minutes : 0;
         const repPct = repetitionCount / agentConfig.max_repetitions;
         const errorPct = session.consecutiveErrors / agentConfig.max_consecutive_errors;
         const reasons = [];
@@ -16379,6 +16393,7 @@ function createGuardrailsHooks(config2) {
         session.consecutiveErrors++;
       } else {
         session.consecutiveErrors = 0;
+        session.lastSuccessTime = Date.now();
       }
     },
     messagesTransform: async (_input, output) => {

package/dist/state.d.ts

@@ -59,6 +59,8 @@ export interface AgentSessionState {
     warningReason: string;
     /** Whether a hard limit has been triggered */
     hardLimitHit: boolean;
+    /** Timestamp of most recent SUCCESSFUL tool call (for idle timeout) */
+    lastSuccessTime: number;
 }
 /**
  * Singleton state object for sharing data across hooks

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "opencode-swarm",
-	"version": "5.0.5",
+	"version": "5.0.8",
 	"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",
@@ -25,7 +25,8 @@
 		"LICENSE"
 	],
 	"scripts": {
-		"build": "bun build src/index.ts --outdir dist --target bun --format esm && bun build src/cli/index.ts --outdir dist/cli --target bun --format esm && tsc --emitDeclarationOnly",
+		"clean": "rm -rf dist",
+		"build": "rm -rf dist && bun build src/index.ts --outdir dist --target bun --format esm && bun build src/cli/index.ts --outdir dist/cli --target bun --format esm && tsc --emitDeclarationOnly",
 		"typecheck": "tsc --noEmit",
 		"test": "bun test",
 		"lint": "biome lint .",

package/dist/agents/auditor.d.ts

@@ -1,2 +0,0 @@
-import type { AgentDefinition } from './architect';
-export declare function createAuditorAgent(model: string, customPrompt?: string, customAppendPrompt?: string): AgentDefinition;

package/dist/agents/security-reviewer.d.ts

@@ -1,2 +0,0 @@
-import type { AgentDefinition } from './architect';
-export declare function createSecurityReviewerAgent(model: string, customPrompt?: string, customAppendPrompt?: string): AgentDefinition;

package/dist/agents/sme/active-directory.d.ts

@@ -1,2 +0,0 @@
-import type { SMEDomainConfig } from './base';
-export declare const activeDirectorySMEConfig: SMEDomainConfig;

package/dist/agents/sme/ai.d.ts

@@ -1,2 +0,0 @@
-import type { SMEDomainConfig } from './base';
-export declare const aiSMEConfig: SMEDomainConfig;

package/dist/agents/sme/api.d.ts

@@ -1,2 +0,0 @@
-import type { SMEDomainConfig } from './base';
-export declare const apiSMEConfig: SMEDomainConfig;

package/dist/agents/sme/azure.d.ts

@@ -1,2 +0,0 @@
-import type { SMEDomainConfig } from './base';
-export declare const azureSMEConfig: SMEDomainConfig;

package/dist/agents/sme/base.d.ts

@@ -1,13 +0,0 @@
-import type { AgentDefinition } from '../architect';
-/**
- * SME domain configuration
- */
-export interface SMEDomainConfig {
-    domain: string;
-    description: string;
-    guidance: string;
-}
-/**
- * Create an SME agent definition
- */
-export declare function createSMEAgent(agentName: string, domainConfig: SMEDomainConfig, model: string, customPrompt?: string, customAppendPrompt?: string): AgentDefinition;

package/dist/agents/sme/database.d.ts

@@ -1,2 +0,0 @@
-import type { SMEDomainConfig } from './base';
-export declare const databaseSMEConfig: SMEDomainConfig;

package/dist/agents/sme/devops.d.ts

@@ -1,2 +0,0 @@
-import type { SMEDomainConfig } from './base';
-export declare const devopsSMEConfig: SMEDomainConfig;

package/dist/agents/sme/index.d.ts

@@ -1,20 +0,0 @@
-import type { AgentDefinition } from '../architect';
-import { type SMEDomainConfig } from './base';
-export declare const SME_CONFIGS: Record<string, SMEDomainConfig>;
-export declare const AGENT_TO_DOMAIN: Record<string, string>;
-/**
- * Create all SME agent definitions
- */
-export declare function createAllSMEAgents(getModel: (agentName: string) => string, loadPrompt: (agentName: string) => {
-    prompt?: string;
-    appendPrompt?: string;
-}): AgentDefinition[];
-/**
- * Get list of available SME domains
- */
-export declare function listDomains(): string[];
-/**
- * Get SME agent name for a domain
- */
-export declare function domainToAgent(domain: string): string | undefined;
-export { createSMEAgent, type SMEDomainConfig } from './base';

package/dist/agents/sme/linux.d.ts

@@ -1,2 +0,0 @@
-import type { SMEDomainConfig } from './base';
-export declare const linuxSMEConfig: SMEDomainConfig;

package/dist/agents/sme/network.d.ts

@@ -1,2 +0,0 @@
-import type { SMEDomainConfig } from './base';
-export declare const networkSMEConfig: SMEDomainConfig;

package/dist/agents/sme/oracle.d.ts

@@ -1,2 +0,0 @@
-import type { SMEDomainConfig } from './base';
-export declare const oracleSMEConfig: SMEDomainConfig;

package/dist/agents/sme/powershell.d.ts

@@ -1,2 +0,0 @@
-import type { SMEDomainConfig } from './base';
-export declare const powershellSMEConfig: SMEDomainConfig;

package/dist/agents/sme/python.d.ts

@@ -1,2 +0,0 @@
-import type { SMEDomainConfig } from './base';
-export declare const pythonSMEConfig: SMEDomainConfig;

package/dist/agents/sme/security.d.ts

@@ -1,2 +0,0 @@
-import type { SMEDomainConfig } from './base';
-export declare const securitySMEConfig: SMEDomainConfig;

package/dist/agents/sme/ui-ux.d.ts

@@ -1,2 +0,0 @@
-import type { SMEDomainConfig } from './base';
-export declare const uiUxSMEConfig: SMEDomainConfig;

package/dist/agents/sme/vmware.d.ts

@@ -1,2 +0,0 @@
-import type { SMEDomainConfig } from './base';
-export declare const vmwareSMEConfig: SMEDomainConfig;

package/dist/agents/sme/web.d.ts

@@ -1,2 +0,0 @@
-import type { SMEDomainConfig } from './base';
-export declare const webSMEConfig: SMEDomainConfig;

package/dist/agents/sme/windows.d.ts

@@ -1,2 +0,0 @@
-import type { SMEDomainConfig } from './base';
-export declare const windowsSMEConfig: SMEDomainConfig;

package/dist/agents/sme-unified.d.ts

@@ -1,3 +0,0 @@
-import type { AgentDefinition } from './architect';
-export declare function createUnifiedSMEAgent(model: string, customPrompt?: string, customAppendPrompt?: string): AgentDefinition;
-export declare const AVAILABLE_DOMAINS: string[];

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
-};