opencode-swarm 3.2.0 → 3.3.0

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

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

package/dist/config/schema.d.ts

@@ -29,6 +29,7 @@ export declare const PluginConfigSchema: z.ZodObject<{
         }, z.core.$strip>>>;
     }, z.core.$strip>>>;
     max_iterations: z.ZodDefault<z.ZodNumber>;
+    qa_retry_limit: z.ZodDefault<z.ZodNumber>;
     multi_domain_sme: z.ZodDefault<z.ZodBoolean>;
     auto_detect_domains: z.ZodDefault<z.ZodBoolean>;
     inject_phase_reminders: z.ZodDefault<z.ZodBoolean>;

package/dist/index.js

@@ -13759,9 +13759,10 @@ var PluginConfigSchema = exports_external.object({
   agents: exports_external.record(exports_external.string(), AgentOverrideConfigSchema).optional(),
   swarms: exports_external.record(exports_external.string(), SwarmConfigSchema).optional(),
   max_iterations: exports_external.number().min(1).max(10).default(5),
+  qa_retry_limit: exports_external.number().min(1).max(10).default(3),
   multi_domain_sme: exports_external.boolean().default(true),
   auto_detect_domains: exports_external.boolean().default(true),
-  inject_phase_reminders: exports_external.boolean().default(false)
+  inject_phase_reminders: exports_external.boolean().default(true)
 });
 // src/config/loader.ts
 import * as fs from "fs";
@@ -13812,9 +13813,10 @@ function loadPluginConfig(directory) {
   const projectConfigPath = path.join(directory, ".opencode", CONFIG_FILENAME);
   let config2 = loadConfigFromPath(userConfigPath) ?? {
     max_iterations: 5,
+    qa_retry_limit: 3,
     multi_domain_sme: true,
     auto_detect_domains: true,
-    inject_phase_reminders: false
+    inject_phase_reminders: true
   };
   const projectConfig = loadConfigFromPath(projectConfigPath);
   if (projectConfig) {
@@ -13850,6 +13852,11 @@ function loadAgentPrompt(agentName) {
 // src/agents/architect.ts
 var ARCHITECT_PROMPT = `You are Architect - orchestrator of a multi-agent swarm.
 
+## IDENTITY
+
+Swarm: {{SWARM_ID}}
+Your agents: {{AGENT_PREFIX}}explorer, {{AGENT_PREFIX}}coder, {{AGENT_PREFIX}}sme_*, etc.
+
 ## ROLE
 
 You THINK. Subagents DO. You have the largest context window and strongest reasoning. Subagents have smaller contexts and weaker reasoning. Your job:
@@ -13860,19 +13867,19 @@ You THINK. Subagents DO. You have the largest context window and strongest reaso
 
 ## RULES
 
-1. DELEGATE all coding to @coder. You do NOT write code.
+1. DELEGATE all coding to @{{AGENT_PREFIX}}coder. You do NOT write code.
 2. ONE agent per message. Send, STOP, wait for response.
-3. ONE task per @coder call. Never batch.
-4. Fallback: Only code yourself after 3 @coder failures on same task.
+3. ONE task per @{{AGENT_PREFIX}}coder call. Never batch.
+4. Fallback: Only code yourself after {{QA_RETRY_LIMIT}} @{{AGENT_PREFIX}}coder failures on same task.
 
 ## AGENTS
 
-@explorer - Codebase analysis
-@sme_[domain] - Domain expertise (windows, powershell, python, oracle, network, security, linux, vmware, azure, active_directory, ui_ux, web, database, devops, api)
-@coder - Implementation (one task at a time)
-@test_engineer - Test generation
-@security_reviewer - Vulnerability review
-@auditor - Correctness verification
+@{{AGENT_PREFIX}}explorer - Codebase analysis
+@{{AGENT_PREFIX}}sme_[domain] - Domain expertise (windows, powershell, python, oracle, network, security, linux, vmware, azure, active_directory, ui_ux, web, database, devops, api, ai)
+@{{AGENT_PREFIX}}coder - Implementation (one task at a time)
+@{{AGENT_PREFIX}}test_engineer - Test generation
+@{{AGENT_PREFIX}}security_reviewer - Vulnerability review
+@{{AGENT_PREFIX}}auditor - Correctness verification
 
 SMEs advise only. QA agents review only. Neither writes code.
 
@@ -13880,7 +13887,7 @@ SMEs advise only. QA agents review only. Neither writes code.
 
 All delegations use this structure:
 
-@agent
+@{{AGENT_PREFIX}}[agent]
 TASK: [single objective]
 FILE: [path] (if applicable)
 INPUT: [what to analyze/use]
@@ -13889,36 +13896,36 @@ CONSTRAINT: [what NOT to do]
 
 Examples:
 
-@explorer
+@{{AGENT_PREFIX}}explorer
 TASK: Analyze codebase for auth implementation
 INPUT: Focus on src/auth/, src/middleware/
 OUTPUT: Structure, frameworks, key files, relevant SME domains
 
-@sme_security
+@{{AGENT_PREFIX}}sme_security
 TASK: Review auth patterns
 INPUT: src/auth/login.ts, src/auth/session.ts
 OUTPUT: Security considerations, recommended patterns
 CONSTRAINT: Focus on auth only, not general code style
 
-@coder
+@{{AGENT_PREFIX}}coder
 TASK: Add input validation to login
 FILE: src/auth/login.ts
 INPUT: Validate email format, password >= 8 chars
 OUTPUT: Modified file
 CONSTRAINT: Do not modify other functions
 
-@security_reviewer
+@{{AGENT_PREFIX}}security_reviewer
 TASK: Review login validation
 FILE: src/auth/login.ts
 OUTPUT: RISK [LOW|MEDIUM|HIGH|CRITICAL], issues with line numbers
 
-@auditor
+@{{AGENT_PREFIX}}auditor
 TASK: Verify login validation
 FILE: src/auth/login.ts
 INPUT: Must validate email format, password >= 8 chars
 OUTPUT: APPROVED or REJECTED with specific issues
 
-@test_engineer
+@{{AGENT_PREFIX}}test_engineer
 TASK: Generate login validation tests
 FILE: src/auth/login.ts
 OUTPUT: Test file at src/auth/login.test.ts
@@ -13926,19 +13933,24 @@ OUTPUT: Test file at src/auth/login.test.ts
 ## WORKFLOW
 
 ### Phase 0: Resume Check
-If .swarm/plan.md exists \u2192 Read plan.md + context.md, resume at current task
-If not \u2192 New project, proceed to Phase 1
+If .swarm/plan.md exists:
+  1. Read plan.md header for "Swarm:" field
+  2. If Swarm field missing or matches "{{SWARM_ID}}" \u2192 Resume at current task
+  3. If Swarm field differs (e.g., plan says "local" but you are "default"):
+     - STOP and warn user: "This project was created by [other] swarm. The cached context references different agents. Options: (1) Continue - I will re-consult SMEs with my agents, (2) Abort - switch to the correct architect"
+     - If user continues: Delete SME Cache section from context.md, update plan.md Swarm field to "{{SWARM_ID}}"
+If .swarm/plan.md does not exist \u2192 New project, proceed to Phase 1
 
 ### Phase 1: Clarify
 Ambiguous request \u2192 Ask up to 3 questions, wait for answers
 Clear request \u2192 Phase 2
 
 ### Phase 2: Discover
-Delegate to @explorer. Wait for response.
+Delegate to @{{AGENT_PREFIX}}explorer. Wait for response.
 
 ### Phase 3: Consult SMEs
 Check .swarm/context.md for cached guidance first.
-Call 1-3 relevant SMEs based on @explorer findings.
+Call 1-3 relevant SMEs based on @{{AGENT_PREFIX}}explorer findings.
 ONE SME at a time. Wait between each.
 Cache guidance in context.md.
 
@@ -13954,18 +13966,18 @@ Create .swarm/context.md:
 ### Phase 5: Execute
 For each task (respecting dependencies):
 
-5a. @coder - Implement (MANDATORY)
-5b. @security_reviewer - Review
-5c. @auditor - Verify
+5a. @{{AGENT_PREFIX}}coder - Implement (MANDATORY)
+5b. @{{AGENT_PREFIX}}security_reviewer - Review
+5c. @{{AGENT_PREFIX}}auditor - Verify
 5d. Result:
     - APPROVED \u2192 5e
-    - REJECTED (attempt 1-2) \u2192 Feedback to @coder, retry
-    - REJECTED (attempt 3) \u2192 Escalate, handle directly
-5e. @test_engineer - Generate tests
+    - REJECTED (attempt < {{QA_RETRY_LIMIT}}) \u2192 Feedback to @{{AGENT_PREFIX}}coder, retry
+    - REJECTED (attempt {{QA_RETRY_LIMIT}}) \u2192 Escalate, handle directly
+5e. @{{AGENT_PREFIX}}test_engineer - Generate tests
 5f. Update plan.md [x], proceed to next task
 
 ### Phase 6: Phase Complete
-1. @explorer - Rescan
+1. @{{AGENT_PREFIX}}explorer - Rescan
 2. Update context.md
 3. Summarize to user
 4. Ask: "Ready for Phase [N+1]?"
@@ -13978,6 +13990,7 @@ Mark [BLOCKED] in plan.md, skip to next unblocked task, inform user.
 .swarm/plan.md:
 \`\`\`
 # [Project]
+Swarm: {{SWARM_ID}}
 Phase: [N] | Updated: [date]
 
 ## Phase 1 [COMPLETE]
@@ -13992,6 +14005,7 @@ Phase: [N] | Updated: [date]
 .swarm/context.md:
 \`\`\`
 # Context
+Swarm: {{SWARM_ID}}
 
 ## Decisions
 - [decision]: [rationale]
@@ -14336,6 +14350,20 @@ var activeDirectorySMEConfig = {
 - ADSI/DirectoryServices .NET`
 };
 
+// src/agents/sme/ai.ts
+var aiSMEConfig = {
+  domain: "ai",
+  description: "AI/LLM systems and prompt engineering",
+  guidance: `- Prompt engineering (CoT, few-shot, structured output)
+- Context window management, token optimization
+- Model selection tradeoffs (cost, latency, capability)
+- Agent orchestration patterns (delegation, handoff)
+- RAG architectures, embedding strategies
+- Fine-tuning vs prompting decisions
+- Safety/alignment considerations
+- Tool use and function calling patterns`
+};
+
 // src/agents/sme/api.ts
 var apiSMEConfig = {
   domain: "api",
@@ -14549,7 +14577,8 @@ var SME_CONFIGS = {
   web: webSMEConfig,
   database: databaseSMEConfig,
   devops: devopsSMEConfig,
-  api: apiSMEConfig
+  api: apiSMEConfig,
+  ai: aiSMEConfig
 };
 var AGENT_TO_DOMAIN = {
   sme_windows: "windows",
@@ -14566,7 +14595,8 @@ var AGENT_TO_DOMAIN = {
   sme_web: "web",
   sme_database: "database",
   sme_devops: "devops",
-  sme_api: "api"
+  sme_api: "api",
+  sme_ai: "ai"
 };
 function createAllSMEAgents(getModel, loadPrompt) {
   return Object.entries(AGENT_TO_DOMAIN).map(([agentName, domain2]) => {
@@ -14621,11 +14651,12 @@ function applyOverrides(agent, swarmAgents, swarmPrefix) {
   }
   return agent;
 }
-function createSwarmAgents(swarmId, swarmConfig, isDefault) {
+function createSwarmAgents(swarmId, swarmConfig, isDefault, pluginConfig) {
   const agents = [];
   const swarmAgents = swarmConfig.agents;
   const prefix = isDefault ? "" : `${swarmId}_`;
   const swarmPrefix = isDefault ? undefined : swarmId;
+  const qaRetryLimit = pluginConfig?.qa_retry_limit ?? 3;
   const getModel = (baseName) => getModelForAgent(baseName, swarmAgents, swarmPrefix);
   const getPrompts = (name) => loadAgentPrompt(name);
   const prefixName = (name) => `${prefix}${name}`;
@@ -14634,22 +14665,19 @@ function createSwarmAgents(swarmId, swarmConfig, isDefault) {
     const architectPrompts = getPrompts("architect");
     const architect = createArchitectAgent(getModel("architect"), architectPrompts.prompt, architectPrompts.appendPrompt);
     architect.name = prefixName("architect");
+    const swarmName = swarmConfig.name || swarmId;
+    const swarmIdentity = isDefault ? "default" : swarmId;
+    const agentPrefix = prefix;
+    architect.config.prompt = architect.config.prompt?.replace(/\{\{SWARM_ID\}\}/g, swarmIdentity).replace(/\{\{AGENT_PREFIX\}\}/g, agentPrefix).replace(/\{\{QA_RETRY_LIMIT\}\}/g, String(qaRetryLimit));
     if (!isDefault) {
-      const swarmName = swarmConfig.name || swarmId;
       architect.description = `[${swarmName}] ${architect.description}`;
-      const swarmHeader = `
-## \u26A0\uFE0F YOU ARE THE ${swarmName.toUpperCase()} SWARM ARCHITECT
-
-Your agents all have the "${swarmId}_" prefix. You MUST use this prefix when delegating:
-- Use @${prefix}explorer, NOT @explorer
-- Use @${prefix}coder, NOT @coder  
-- Use @${prefix}sme_security, NOT @sme_security
-- etc.
+      const swarmHeader = `## \u26A0\uFE0F YOU ARE THE ${swarmName.toUpperCase()} SWARM ARCHITECT
 
-If you call an agent WITHOUT the "${swarmId}_" prefix, you will be calling the WRONG swarm's agents!
+Your agents all have the "${swarmId}_" prefix. You MUST use this prefix when delegating.
+If you call an agent WITHOUT the "${swarmId}_" prefix, you will call the WRONG swarm's agents!
 
 `;
-      architect.config.prompt = swarmHeader + (architect.config.prompt?.replace(/@explorer/g, `@${prefix}explorer`).replace(/@coder/g, `@${prefix}coder`).replace(/@test_engineer/g, `@${prefix}test_engineer`).replace(/@security_reviewer/g, `@${prefix}security_reviewer`).replace(/@auditor/g, `@${prefix}auditor`).replace(/@sme_(\w+)/g, `@${prefix}sme_$1`).replace(/@sme_\[(\w+)\]/g, `@${prefix}sme_[$1]`) || "");
+      architect.config.prompt = swarmHeader + architect.config.prompt;
     }
     agents.push(applyOverrides(architect, swarmAgents, swarmPrefix));
   }
@@ -14702,7 +14730,7 @@ function createAgents(config2) {
     for (const swarmId of swarmIds) {
       const swarmConfig = swarms[swarmId];
       const isDefault = swarmId === defaultSwarmId;
-      const swarmAgents = createSwarmAgents(swarmId, swarmConfig, isDefault);
+      const swarmAgents = createSwarmAgents(swarmId, swarmConfig, isDefault, config2);
       allAgents.push(...swarmAgents);
     }
   } else {
@@ -14710,7 +14738,7 @@ function createAgents(config2) {
       name: "Default",
       agents: config2?.agents
     };
-    const swarmAgents = createSwarmAgents("default", legacySwarmConfig, true);
+    const swarmAgents = createSwarmAgents("default", legacySwarmConfig, true, config2);
     allAgents.push(...swarmAgents);
   }
   return allAgents;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-swarm",
-  "version": "3.2.0",
+  "version": "3.3.0",
   "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",