opencode-swarm 7.3.4 → 7.3.5

package/README.md

@@ -788,6 +788,17 @@ Prefixed agents (e.g., `paid_coder`, `mega_reviewer`, `local_architect`) inherit
 
 In this example, `paid_coder` gets its own explicit rule, while other prefixed coders (e.g., `mega_coder`) fall back to `coder`.
 
+#### Selecting the primary agent in multi-swarm configs (`default_agent`)
+
+The top-level `default_agent` field controls which generated agents OpenCode treats as primary. **It is optional.** Behavior:
+
+- **Omitted** — every architect-role agent is primary. In a multi-swarm config that means each swarm exposes its own architect (`local_architect`, `mega_architect`, `paid_architect`, `modelrelay_architect`, …) as a selectable session default. This is the v7.0.0-compatible behavior and the recommended setup.
+- **Base role** (e.g. `"coder"`) — every generated agent whose canonical base role matches becomes primary (`local_coder`, `mega_coder`, …).
+- **Exact generated name** (e.g. `"local_architect"`) — only that agent is primary.
+- **Unknown / invalid value** — a one-time warning is logged and the resolver falls back to architect-role primaries (or the first generated agent if architects are disabled). The plugin never produces zero primaries when at least one agent exists.
+
+See [`docs/configuration.md`](docs/configuration.md) for the full table.
+
 ### Runtime Enforcement
 
 Architect direct writes are enforced at runtime via `toolBefore` hook. This tracks writes to source code paths outside `.swarm/` and protects `.swarm/plan.md` and `.swarm/plan.json` from direct modification.

package/dist/agents/index.d.ts

@@ -34,6 +34,34 @@ export declare function getSwarmAgents(): Record<string, {
  * Create all agent definitions with configuration applied
  */
 export declare function createAgents(config?: PluginConfig): AgentDefinition[];
+/**
+ * Resolve the set of generated agent names that should be marked as primary
+ * for OpenCode's session-default-agent resolution.
+ *
+ * Resolution rules (see schema.ts default_agent comment for full semantics):
+ *   - default_agent omitted ⇒ every architect-role agent is primary
+ *     (canonical base role === "architect"). This restores v7.0.0 behavior in
+ *     multi-swarm configs where there is no unprefixed `architect` agent.
+ *   - default_agent exactly matches a generated agent name ⇒ only that agent.
+ *     Exact match wins over base-role match — `local_architect` resolves to
+ *     just `local_architect`, never the entire architect role.
+ *   - default_agent is a base role in ALL_AGENT_NAMES ⇒ every generated agent
+ *     whose canonical base role matches that role.
+ *   - default_agent is invalid (matches nothing) ⇒ fall back to architect-role
+ *     primaries; if no architect roles exist (architects disabled), fall back
+ *     to the first generated agent. Always warns. Never returns empty when
+ *     `agentNames` is non-empty.
+ *
+ * Important matching detail: a value like "not_an_architect" is NOT treated
+ * as a base-role request even though stripKnownSwarmPrefix() returns
+ * "architect" for it. Base-role matching only fires when the user-supplied
+ * value is itself one of ALL_AGENT_NAMES.
+ */
+export declare function resolvePrimaryAgentNames(agentNames: string[], defaultAgent?: string): {
+    primaryNames: Set<string>;
+    reason: 'implicit-architects' | 'exact' | 'base-role' | 'fallback-architects' | 'fallback-first';
+    warning?: string;
+};
 /**
  * Get agent configurations formatted for the OpenCode SDK.
  */

package/dist/cli/index.js

@@ -34,7 +34,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "opencode-swarm",
-    version: "7.3.4",
+    version: "7.3.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",
@@ -16915,7 +16915,12 @@ var init_schema = __esm(() => {
   });
   PluginConfigSchema = exports_external.object({
     agents: exports_external.record(exports_external.string(), AgentOverrideConfigSchema).optional(),
-    default_agent: exports_external.enum(ALL_AGENT_NAMES).default("architect").optional(),
+    default_agent: exports_external.string().optional().transform((v) => {
+      if (v === undefined)
+        return;
+      const trimmed = v.trim();
+      return trimmed === "" ? undefined : trimmed;
+    }),
     swarms: exports_external.record(exports_external.string(), SwarmConfigSchema).optional(),
     max_iterations: exports_external.number().min(1).max(10).default(5),
     pipeline: PipelineConfigSchema.optional(),

package/dist/config/schema.d.ts

@@ -643,26 +643,7 @@ export declare const PluginConfigSchema: z.ZodObject<{
         disabled: z.ZodOptional<z.ZodBoolean>;
         fallback_models: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strip>>>;
-    default_agent: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
-        architect: "architect";
-        sme: "sme";
-        docs: "docs";
-        designer: "designer";
-        critic_sounding_board: "critic_sounding_board";
-        critic_drift_verifier: "critic_drift_verifier";
-        critic_hallucination_verifier: "critic_hallucination_verifier";
-        curator_init: "curator_init";
-        curator_phase: "curator_phase";
-        council_generalist: "council_generalist";
-        council_skeptic: "council_skeptic";
-        council_domain_expert: "council_domain_expert";
-        reviewer: "reviewer";
-        critic: "critic";
-        critic_oversight: "critic_oversight";
-        explorer: "explorer";
-        coder: "coder";
-        test_engineer: "test_engineer";
-    }>>>;
+    default_agent: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string | undefined, string | undefined>>;
     swarms: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
         name: z.ZodOptional<z.ZodString>;
         agents: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{

package/dist/index.js

@@ -33,7 +33,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "opencode-swarm",
-    version: "7.3.4",
+    version: "7.3.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",
@@ -15352,7 +15352,12 @@ var init_schema = __esm(() => {
   });
   PluginConfigSchema = exports_external.object({
     agents: exports_external.record(exports_external.string(), AgentOverrideConfigSchema).optional(),
-    default_agent: exports_external.enum(ALL_AGENT_NAMES).default("architect").optional(),
+    default_agent: exports_external.string().optional().transform((v) => {
+      if (v === undefined)
+        return;
+      const trimmed = v.trim();
+      return trimmed === "" ? undefined : trimmed;
+    }),
     swarms: exports_external.record(exports_external.string(), SwarmConfigSchema).optional(),
     max_iterations: exports_external.number().min(1).max(10).default(5),
     pipeline: PipelineConfigSchema.optional(),
@@ -59986,6 +59991,52 @@ function createAgents(config3) {
   }
   return allAgents;
 }
+function resolvePrimaryAgentNames(agentNames, defaultAgent) {
+  const collectArchitectRole = () => agentNames.filter((n) => stripKnownSwarmPrefix(n) === "architect");
+  const trimmed = typeof defaultAgent === "string" ? defaultAgent.trim() : undefined;
+  const value = trimmed === "" ? undefined : trimmed;
+  if (agentNames.length === 0) {
+    return { primaryNames: new Set, reason: "implicit-architects" };
+  }
+  if (value === undefined) {
+    const architects2 = collectArchitectRole();
+    if (architects2.length > 0) {
+      return {
+        primaryNames: new Set(architects2),
+        reason: "implicit-architects"
+      };
+    }
+    const first2 = agentNames[0];
+    return {
+      primaryNames: new Set([first2]),
+      reason: "fallback-first",
+      warning: `[swarm] No architect-role agents are registered and default_agent is unset; falling back to '${first2}' as primary. Re-enable an architect agent or set default_agent to silence this warning.`
+    };
+  }
+  if (ALL_AGENT_NAMES.includes(value)) {
+    const matching = agentNames.filter((n) => stripKnownSwarmPrefix(n) === value);
+    if (matching.length > 0) {
+      return { primaryNames: new Set(matching), reason: "base-role" };
+    }
+  }
+  if (agentNames.includes(value)) {
+    return { primaryNames: new Set([value]), reason: "exact" };
+  }
+  const architects = collectArchitectRole();
+  if (architects.length > 0) {
+    return {
+      primaryNames: new Set(architects),
+      reason: "fallback-architects",
+      warning: `[swarm] default_agent '${value}' did not match any registered agent; falling back to architect-role primaries: ${architects.join(", ")}.`
+    };
+  }
+  const first = agentNames[0];
+  return {
+    primaryNames: new Set([first]),
+    reason: "fallback-first",
+    warning: `[swarm] default_agent '${value}' did not match any registered agent and no architect-role agents are registered; falling back to '${first}' as primary.`
+  };
+}
 function getAgentConfigs(config3, directory, sessionId) {
   const agents = createAgents(config3);
   const toolFilterEnabled = config3?.tool_filter?.enabled ?? true;
@@ -59993,21 +60044,29 @@ function getAgentConfigs(config3, directory, sessionId) {
   const quiet = config3?.quiet ?? true;
   const warnedMissingWhitelist = new Set;
   const agentToolSnapshot = {};
+  const resolution = resolvePrimaryAgentNames(agents.map((a) => a.name), config3?.default_agent);
+  if (resolution.warning) {
+    if (!quiet) {
+      console.warn(resolution.warning);
+    } else {
+      addDeferredWarning(resolution.warning);
+    }
+  }
+  if (agents.length > 0 && resolution.primaryNames.size === 0) {
+    const generated = agents.map((a) => a.name).join(", ");
+    const diagnostic = `[swarm] DIAGNOSTIC: ${agents.length} generated agents but zero primaries. Likely cause: a regression in resolvePrimaryAgentNames. Generated: ${generated}.`;
+    if (!quiet) {
+      console.warn(diagnostic);
+    } else {
+      addDeferredWarning(diagnostic);
+    }
+  }
   const result = Object.fromEntries(agents.map((agent) => {
     const sdkConfig = {
       ...agent.config,
       description: agent.description
     };
-    let defaultAgent = config3?.default_agent ?? "architect";
-    if (defaultAgent !== "architect" && !ALL_AGENT_NAMES.includes(defaultAgent)) {
-      if (!quiet) {
-        console.warn(`[swarm] Invalid default_agent '${defaultAgent}' — falling back to 'architect'. Valid values: ${ALL_AGENT_NAMES.join(", ")}`);
-      } else {
-        addDeferredWarning(`[swarm] Invalid default_agent '${defaultAgent}' — falling back to 'architect'. Valid values: ${ALL_AGENT_NAMES.join(", ")}`);
-      }
-      defaultAgent = "architect";
-    }
-    const isPrimaryAgent = agent.name === defaultAgent;
+    const isPrimaryAgent = resolution.primaryNames.has(agent.name);
     if (isPrimaryAgent) {
       sdkConfig.mode = "primary";
       sdkConfig.permission = { task: "allow" };

package/package.json

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