opencode-swarm 6.22.4 → 6.22.6

package/README.md

@@ -8,7 +8,11 @@ OpenCode Swarm is a plugin for [OpenCode](https://opencode.ai) that turns a sing
 
 You do **not** manually switch between Swarm's internal agents during normal use.
 
-You continue talking to OpenCode normally. Swarm intercepts the session, the **architect** coordinates the internal pipeline behind the scenes, and all project state is persisted to `.swarm/` so work can resume later.
+You must **explicitly choose a Swarm architect** in the OpenCode GUI before starting. The architect name shown in OpenCode is config-driven — you can define multiple architects with different model assignments in your configuration, and those custom names will appear in the GUI dropdown.
+
+If you use OpenCode's default `Build` / `Plan` options instead of selecting a Swarm architect, the plugin is bypassed entirely.
+
+Once you select a Swarm architect, that architect coordinates the internal pipeline behind the scenes, and all project state is persisted to `.swarm/` so work can resume later.
 
 ```bash
 npm install -g opencode-swarm
@@ -93,15 +97,16 @@ What they tell you:
 * `/swarm agents` shows the registered internal agents and model assignments
 * `/swarm config` shows the resolved configuration currently in effect
 
-### 4. Start normally
+### 4. Select a Swarm architect and start
 
-Just tell OpenCode what you want to build.
+1. **Choose a Swarm architect** in the OpenCode GUI (the exact name depends on your configuration — you can define multiple architects with different model assignments)
+2. Then describe what you want to build.
 
 ```text
 Build a REST API with user registration, login, and JWT auth.
 ```
 
-You do **not** manually choose `architect`, `coder`, `reviewer`, `critic`, or other internal agents. The **architect** coordinates them automatically.
+You do **not** manually choose `coder`, `reviewer`, `critic`, or other internal agents. The **architect** coordinates them automatically after you select it.
 
 ### 5. Understand first run vs later runs
 
@@ -152,9 +157,11 @@ You only need to specify the agents you want to override.
 
 ## Common First-Run Questions
 
-### "Do I need to use the Architect agent specifically?"
+### "Do I need to select a Swarm architect?"
+
+**Yes.** You must explicitly choose a Swarm architect agent in the OpenCode GUI before starting your session. The architect name shown in OpenCode is config-driven — you can define multiple architects with different model assignments in your configuration.
 
-No. In normal use, you just use OpenCode. Swarm's architect runs inside the plugin and coordinates the other internal agents automatically.
+If you use the default OpenCode `Build` / `Plan` options without selecting a Swarm architect, the plugin is bypassed entirely.
 
 ### "Why did the second run start coding immediately?"
 
@@ -1156,8 +1163,11 @@ Upcoming: v6.22 focuses on further context optimization and agent coordination i
 
 ## FAQ
 
-### Do I need to use the Architect agent specifically?
-No. In normal use, you just use OpenCode. Swarm's architect runs inside the plugin and coordinates the other internal agents automatically.
+### Do I need to select a Swarm architect?
+
+**Yes.** You must explicitly choose a Swarm architect agent in the OpenCode GUI before starting your session. The architect name shown in OpenCode is config-driven — you can define multiple architects with different model assignments in your configuration.
+
+If you use the default OpenCode `Build` / `Plan` options without selecting a Swarm architect, the plugin is bypassed entirely.
 
 ### Why did Swarm start coding immediately on my second run?
 Because Swarm resumes from `.swarm/` state when it exists. Check `/swarm status` to see the current mode.

package/dist/hooks/delegation-gate.d.ts

@@ -47,6 +47,7 @@ export declare function createDelegationGateHook(config: PluginConfig): {
         tool: string;
         sessionID: string;
         callID: string;
+        args?: Record<string, unknown>;
     }, output: unknown) => Promise<void>;
 };
 export {};

package/dist/hooks/guardrails.d.ts

@@ -44,6 +44,7 @@ export declare function createGuardrailsHooks(directoryOrConfig?: string | Guard
         tool: string;
         sessionID: string;
         callID: string;
+        args?: Record<string, unknown>;
     }, output: {
         title: string;
         output: string;

package/dist/index.js

@@ -47774,7 +47774,7 @@ function createGuardrailsHooks(directoryOrConfig, config3) {
             }
           }
         }
-        const inputArgs = getStoredInputArgs(input.callID);
+        const inputArgs = input.args ?? getStoredInputArgs(input.callID);
         const delegation = isAgentDelegation(input.tool, inputArgs);
         if (delegation.isDelegation && (delegation.targetAgent === "reviewer" || delegation.targetAgent === "test_engineer")) {
           let currentPhase = 1;
@@ -48019,10 +48019,10 @@ function createDelegationGateHook(config3) {
     console.log(`[swarm-debug-task] delegation-gate.toolAfter | session=${input.sessionID} callID=${input.callID} tool=${input.tool}`);
     const normalized = input.tool.replace(/^[^:]+[:.]/, "");
     if (normalized === "Task" || normalized === "task") {
+      const directArgs = input.args;
       const storedArgs = getStoredInputArgs(input.callID);
-      const argsObj = storedArgs;
-      const subagentType = argsObj?.subagent_type;
-      console.log(`[swarm-debug-task] delegation-gate.taskDetected | session=${input.sessionID} subagent_type=${subagentType ?? "(none)"} currentStates=[${statesSummary}]`);
+      const subagentType = directArgs?.subagent_type ?? storedArgs?.subagent_type;
+      console.log(`[swarm-debug-task] delegation-gate.taskDetected | session=${input.sessionID} subagent_type=${subagentType ?? "(none)"} source=${directArgs?.subagent_type ? "input.args" : storedArgs?.subagent_type ? "storedArgs" : "none"} currentStates=[${statesSummary}]`);
       let hasReviewer = false;
       let hasTestEngineer = false;
       if (typeof subagentType === "string") {
@@ -48076,7 +48076,7 @@ function createDelegationGateHook(config3) {
           }
         }
       }
-      if (argsObj !== undefined) {
+      if (storedArgs !== undefined) {
         deleteStoredInputArgs(input.callID);
       }
       if (!subagentType || !hasReviewer) {
@@ -60922,7 +60922,8 @@ var OpenCodeSwarm = async (ctx) => {
           }
         }
       }
-      if (input.tool === "task") {
+      const normalizedTool = input.tool.replace(/^[^:]+[:.]/, "");
+      if (normalizedTool === "Task" || normalizedTool === "task") {
         const sessionId = input.sessionID;
         const beforeSession = swarmState.agentSessions.get(sessionId);
         const beforeStates = beforeSession?.taskWorkflowStates ? Object.entries(beforeSession.taskWorkflowStates).map(([k, v]) => `${k}=${v}`).join(",") : "(none)";

package/package.json

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