docs(config): correct maxConcurrent default in agent-defaults type comments

ArielSmoliar · claude · ArielSmoliar · commit 68c382a20270 · 2026-06-13T09:46:22.000-04:00
The JSDoc on AgentDefaults.maxConcurrent and subagents.maxConcurrent said
"Default: 1", but the resolvers default to 4 and 8 respectively
(DEFAULT_AGENT_MAX_CONCURRENT=4, DEFAULT_SUBAGENT_MAX_CONCURRENT=8 in
src/config/agent-limits.ts), applied via applyAgentDefaults and asserted by
src/config/config.agent-concurrency-defaults.test.ts. The user-facing docs
(docs/gateway/config-agents.md) already say 4. Align the type comments so the
inline reference matches the resolver, the test, and the docs.

AI-assisted (Claude + Codex), comment-only, no behavior change.

Co-Authored-By: Claude Opus 4.8 (1M context) &lt;noreply@anthropic.com&gt;
diff --git a/src/config/types.agent-defaults.ts b/src/config/types.agent-defaults.ts
@@ -455,15 +455,15 @@ export type AgentDefaultsConfig = {
      */
     includeReasoning?: boolean;
   };
-  /** Max concurrent agent runs across all conversations. Default: 1 (sequential). */
+  /** Max concurrent agent runs across all conversations. Default: 4. */
   maxConcurrent?: number;
   /** Sub-agent defaults (spawned via sessions_spawn). */
   subagents?: {
     /** Prompt-only guidance for how strongly the main agent should delegate work. Default: "suggest". */
     delegationMode?: SubagentDelegationMode;
     /** Default allowlist of target agent ids for sessions_spawn. Use "*" to allow any configured target. */
     allowAgents?: string[];
-    /** Max concurrent sub-agent runs (global lane: "subagent"). Default: 1. */
+    /** Max concurrent sub-agent runs (global lane: "subagent"). Default: 8. */
     maxConcurrent?: number;
     /** Maximum depth allowed for sessions_spawn chains. Default behavior: 1 (no nested spawns). */
     maxSpawnDepth?: number;
