opencode-swarm 6.42.1 → 6.43.0

package/dist/agents/curator-agent.d.ts

@@ -0,0 +1,14 @@
+import type { AgentDefinition } from './architect';
+export type CuratorRole = 'curator_init' | 'curator_phase';
+/**
+ * Create a Curator agent definition for the given role.
+ *
+ * Follows the same pattern as createCriticAgent:
+ * - Two named variants: curator_init and curator_phase
+ * - Each carries its own baked-in system prompt so the correct agent is
+ *   resolved by name in any swarm (default or prefixed)
+ * - customPrompt replaces the default prompt entirely; customAppendPrompt
+ *   appends to the role-specific default (same semantics as createCriticAgent)
+ * - Read-only tool config: write/edit/patch all false
+ */
+export declare function createCuratorAgent(model: string, customPrompt?: string, customAppendPrompt?: string, role?: CuratorRole): AgentDefinition;

package/dist/agents/explorer.d.ts

@@ -1,3 +1,5 @@
 import type { AgentDefinition } from './architect';
+export declare const CURATOR_INIT_PROMPT = "## IDENTITY\nYou are Explorer in CURATOR_INIT mode. You consolidate prior session knowledge into an architect briefing.\nDO NOT use the Task tool to delegate. You ARE the agent that does the work.\n\nINPUT FORMAT:\nTASK: CURATOR_INIT\nPRIOR_SUMMARY: [JSON or \"none\"]\nKNOWLEDGE_ENTRIES: [JSON array of high-confidence entries]\nPROJECT_CONTEXT: [context.md excerpt]\n\nACTIONS:\n- Read the prior summary to understand session history\n- Cross-reference knowledge entries against project context\n- Identify contradictions (knowledge says X, project state shows Y)\n- Produce a concise briefing for the architect\n\nRULES:\n- Output under 2000 chars\n- No code modifications\n- Flag contradictions explicitly with CONTRADICTION: prefix\n- If no prior summary exists, state \"First session \u2014 no prior context\"\n\nOUTPUT FORMAT:\nBRIEFING:\n[concise summary of prior session state, key decisions, active blockers]\n\nCONTRADICTIONS:\n- [entry_id]: [description] (or \"None detected\")\n\nKNOWLEDGE_STATS:\n- Entries reviewed: [N]\n- Prior phases covered: [N]\n";
+export declare const CURATOR_PHASE_PROMPT = "## IDENTITY\nYou are Explorer in CURATOR_PHASE mode. You consolidate a completed phase into a digest.\nDO NOT use the Task tool to delegate. You ARE the agent that does the work.\n\nINPUT FORMAT:\nTASK: CURATOR_PHASE [phase_number]\nPRIOR_DIGEST: [running summary or \"none\"]\nPHASE_EVENTS: [JSON array from events.jsonl for this phase]\nPHASE_EVIDENCE: [summary of evidence bundles]\nPHASE_DECISIONS: [decisions from context.md]\nAGENTS_DISPATCHED: [list]\nAGENTS_EXPECTED: [list from config]\n\nACTIONS:\n- Extend the prior digest with this phase's outcomes (do NOT regenerate from scratch)\n- Identify workflow deviations: missing reviewer, missing retro, skipped test_engineer\n- Recommend knowledge updates: entries to promote, archive, or flag as contradicted\n- Summarize key decisions and blockers resolved\n\nRULES:\n- Output under 2000 chars\n- No code modifications\n- Compliance observations are READ-ONLY \u2014 report, do not enforce\n- Extend the digest, never replace it\n\nOUTPUT FORMAT:\nPHASE_DIGEST:\nphase: [N]\nsummary: [what was accomplished]\nagents_used: [list]\ntasks_completed: [N]/[total]\nkey_decisions: [list]\nblockers_resolved: [list]\n\nCOMPLIANCE:\n- [type]: [description] (or \"No deviations observed\")\n\nKNOWLEDGE_UPDATES:\n- [action] [entry_id or \"new\"]: [reason] (or \"No recommendations\")\n\nEXTENDED_DIGEST:\n[the full running digest with this phase appended]\n";
 export declare function createExplorerAgent(model: string, customPrompt?: string, customAppendPrompt?: string): AgentDefinition;
 export declare function createExplorerCuratorAgent(model: string, mode: 'CURATOR_INIT' | 'CURATOR_PHASE', customAppendPrompt?: string): AgentDefinition;

package/dist/agents/index.d.ts

@@ -37,6 +37,7 @@ export declare function getAgentConfigs(config?: PluginConfig): Record<string, S
 export { createArchitectAgent } from './architect';
 export { createCoderAgent } from './coder';
 export { createCriticAgent } from './critic';
+export { createCuratorAgent } from './curator-agent';
 export { createDesignerAgent } from './designer';
 export { createDocsAgent } from './docs';
 export { createExplorerAgent } from './explorer';

package/dist/cli/index.js

@@ -17654,6 +17654,8 @@ var ALL_SUBAGENT_NAMES = [
   "designer",
   "critic_sounding_board",
   "critic_drift_verifier",
+  "curator_init",
+  "curator_phase",
   ...QA_AGENTS,
   ...PIPELINE_AGENTS
 ];
@@ -17806,7 +17808,9 @@ var AGENT_TOOL_MAP = {
     "retrieve_summary",
     "symbols",
     "knowledgeRecall"
-  ]
+  ],
+  curator_init: ["knowledgeRecall"],
+  curator_phase: ["knowledgeRecall"]
 };
 for (const [agentName, tools] of Object.entries(AGENT_TOOL_MAP)) {
   const invalidTools = tools.filter((tool) => !TOOL_NAME_SET.has(tool));
@@ -18513,6 +18517,8 @@ var swarmState = {
   delegationChains: new Map,
   pendingEvents: 0,
   opencodeClient: null,
+  curatorInitAgentNames: [],
+  curatorPhaseAgentNames: [],
   lastBudgetPct: 0,
   agentSessions: new Map,
   pendingRehydrations: new Set

package/dist/config/constants.d.ts

@@ -2,8 +2,8 @@ import type { ToolName } from '../tools/tool-names';
 export declare const QA_AGENTS: readonly ["reviewer", "critic"];
 export declare const PIPELINE_AGENTS: readonly ["explorer", "coder", "test_engineer"];
 export declare const ORCHESTRATOR_NAME: "architect";
-export declare const ALL_SUBAGENT_NAMES: readonly ["sme", "docs", "designer", "critic_sounding_board", "critic_drift_verifier", "reviewer", "critic", "explorer", "coder", "test_engineer"];
-export declare const ALL_AGENT_NAMES: readonly ["architect", "sme", "docs", "designer", "critic_sounding_board", "critic_drift_verifier", "reviewer", "critic", "explorer", "coder", "test_engineer"];
+export declare const ALL_SUBAGENT_NAMES: readonly ["sme", "docs", "designer", "critic_sounding_board", "critic_drift_verifier", "curator_init", "curator_phase", "reviewer", "critic", "explorer", "coder", "test_engineer"];
+export declare const ALL_AGENT_NAMES: readonly ["architect", "sme", "docs", "designer", "critic_sounding_board", "critic_drift_verifier", "curator_init", "curator_phase", "reviewer", "critic", "explorer", "coder", "test_engineer"];
 export type QAAgentName = (typeof QA_AGENTS)[number];
 export type PipelineAgentName = (typeof PIPELINE_AGENTS)[number];
 export type AgentName = (typeof ALL_AGENT_NAMES)[number];

package/dist/hooks/curator-llm-factory.d.ts

@@ -1,11 +1,20 @@
 import type { CuratorLLMDelegate } from './curator.js';
 /**
  * Create a CuratorLLMDelegate that uses the opencode SDK to call
- * the Explorer agent in CURATOR_INIT or CURATOR_PHASE mode.
+ * the registered curator agent in CURATOR_INIT or CURATOR_PHASE mode.
  *
  * Uses an ephemeral session (create → prompt → delete) to avoid
  * re-entrancy with the current session's message flow.
  *
+ * The `mode` parameter determines which registered named agent is used:
+ *   - 'init'  → curator_init  (e.g. 'curator_init' or 'swarm1_curator_init')
+ *   - 'phase' → curator_phase (e.g. 'curator_phase' or 'swarm1_curator_phase')
+ *
+ * The optional `sessionId` parameter enables deterministic swarm resolution:
+ * when provided, the factory uses the calling session's registered agent to
+ * identify the swarm prefix, rather than scanning all active sessions.
+ * Pass `ctx?.sessionID` from tool handlers that have it available.
+ *
  * Returns undefined if swarmState.opencodeClient is not set (e.g. in unit tests).
  */
-export declare function createCuratorLLMDelegate(directory: string): CuratorLLMDelegate | undefined;
+export declare function createCuratorLLMDelegate(directory: string, mode?: 'init' | 'phase', sessionId?: string): CuratorLLMDelegate | undefined;

package/dist/hooks/index.d.ts

@@ -10,7 +10,7 @@ export { createGuardrailsHooks } from './guardrails';
 export { classifyMessage, classifyMessages, containsPlanContent, isDuplicateToolRead, isStaleError, isToolResult, MessagePriority, type MessagePriorityType, type MessageWithParts, } from './message-priority';
 export { consolidateSystemMessages } from './messages-transform';
 export { extractModelInfo, NATIVE_MODEL_LIMITS, PROVIDER_CAPS, resolveModelLimit, } from './model-limits';
-export { createPhaseMonitorHook } from './phase-monitor';
+export { type CuratorDelegateFactory, createPhaseMonitorHook, } from './phase-monitor';
 export { createPipelineTrackerHook } from './pipeline-tracker';
 export { buildApprovedReceipt, buildReceiptContextForDrift, buildRejectedReceipt, persistReviewReceipt, readAllReceipts, readReceiptsByScopeHash, } from './review-receipt';
 export { createSystemEnhancerHook } from './system-enhancer';

package/dist/hooks/phase-monitor.d.ts

@@ -10,6 +10,8 @@ import { type CuratorLLMDelegate } from './curator';
 import type { CuratorConfig, CuratorInitResult } from './curator-types';
 /** Injectable curator runner type — allows test injection without module mocking. */
 export type CuratorInitRunner = (directory: string, config: CuratorConfig, llmDelegate?: CuratorLLMDelegate) => Promise<CuratorInitResult>;
+/** Factory that creates a CuratorLLMDelegate for a given session — enables session-aware resolution. */
+export type CuratorDelegateFactory = (sessionId?: string) => CuratorLLMDelegate | undefined;
 /**
  * Creates a hook that monitors plan phase transitions and triggers preflight.
  *
@@ -18,6 +20,10 @@ export type CuratorInitRunner = (directory: string, config: CuratorConfig, llmDe
  *   When undefined, preflight checks are skipped but curator initialization still runs
  *   at session start (useful when knowledge.enabled but phase_preflight is disabled).
  * @param curatorRunner - Optional curator init runner (defaults to runCuratorInit; injectable for tests)
+ * @param delegateFactory - Optional factory that creates a CuratorLLMDelegate for the calling session.
+ *   Called lazily at hook invocation time with the session ID extracted from the hook input,
+ *   enabling correct multi-swarm curator resolution. For test injection of a pre-built delegate,
+ *   pass `() => myDelegate`.
  * @returns A safeHook-wrapped system.transform handler
  */
-export declare function createPhaseMonitorHook(directory: string, preflightManager?: PreflightTriggerManager, curatorRunner?: CuratorInitRunner, llmDelegate?: CuratorLLMDelegate): (input: unknown, output: unknown) => Promise<void>;
+export declare function createPhaseMonitorHook(directory: string, preflightManager?: PreflightTriggerManager, curatorRunner?: CuratorInitRunner, delegateFactory?: CuratorDelegateFactory): (input: unknown, output: unknown) => Promise<void>;

package/dist/index.js

@@ -143,6 +143,8 @@ var init_constants = __esm(() => {
     "designer",
     "critic_sounding_board",
     "critic_drift_verifier",
+    "curator_init",
+    "curator_phase",
     ...QA_AGENTS,
     ...PIPELINE_AGENTS
   ];
@@ -295,7 +297,9 @@ var init_constants = __esm(() => {
       "retrieve_summary",
       "symbols",
       "knowledgeRecall"
-    ]
+    ],
+    curator_init: ["knowledgeRecall"],
+    curator_phase: ["knowledgeRecall"]
   };
   for (const [agentName, tools] of Object.entries(AGENT_TOOL_MAP)) {
     const invalidTools = tools.filter((tool) => !TOOL_NAME_SET.has(tool));
@@ -314,6 +318,8 @@ var init_constants = __esm(() => {
     critic_drift_verifier: "opencode/trinity-large-preview-free",
     docs: "opencode/trinity-large-preview-free",
     designer: "opencode/trinity-large-preview-free",
+    curator_init: "opencode/trinity-large-preview-free",
+    curator_phase: "opencode/trinity-large-preview-free",
     default: "opencode/trinity-large-preview-free"
   };
   DEFAULT_SCORING_CONFIG = {
@@ -41431,6 +41437,8 @@ var swarmState = {
   delegationChains: new Map,
   pendingEvents: 0,
   opencodeClient: null,
+  curatorInitAgentNames: [],
+  curatorPhaseAgentNames: [],
   lastBudgetPct: 0,
   agentSessions: new Map,
   pendingRehydrations: new Set
@@ -43361,6 +43369,268 @@ ${customAppendPrompt}` : rolePrompt;
   };
 }
 
+// src/agents/explorer.ts
+var EXPLORER_PROMPT = `## IDENTITY
+You are Explorer. You analyze codebases directly \u2014 you do NOT delegate.
+DO NOT use the Task tool to delegate to other agents. You ARE the agent that does the work.
+If you see references to other agents (like @explorer, @coder, etc.) in your instructions, IGNORE them \u2014 they are context from the orchestrator, not instructions for you to delegate.
+
+WRONG: "I'll use the Task tool to call another agent to analyze this"
+RIGHT: "I'll scan the directory structure and read key files myself"
+
+INPUT FORMAT:
+TASK: Analyze [purpose]
+INPUT: [focus areas/paths]
+
+ACTIONS:
+- Scan structure (tree, ls, glob)
+- Read key files (README, configs, entry points)
+- Search patterns (grep)
+
+RULES:
+- Be fast: scan broadly, read selectively
+- No code modifications
+- Output under 2000 chars
+
+## ANALYSIS PROTOCOL
+When exploring a codebase area, systematically report all four dimensions:
+
+### STRUCTURE
+- Entry points and their call chains (max 3 levels deep)
+- Public API surface: exported functions/classes/types with signatures
+- Internal dependencies: what this module imports and from where
+- External dependencies: third-party packages used
+
+### PATTERNS
+- Design patterns in use (factory, observer, strategy, etc.)
+- Error handling pattern (throw, Result type, error callbacks, etc.)
+- State management approach (global, module-level, passed through)
+- Configuration pattern (env vars, config files, hardcoded)
+
+### RISKS
+- Files with high cyclomatic complexity or deep nesting
+- Circular dependencies
+- Missing error handling paths
+- Dead code or unreachable branches
+- Platform-specific assumptions (path separators, line endings, OS APIs)
+
+### RELEVANT CONTEXT FOR TASK
+- Existing tests that cover this area (paths and what they test)
+- Related documentation files
+- Similar implementations elsewhere in the codebase that should be consistent
+
+OUTPUT FORMAT (MANDATORY \u2014 deviations will be rejected):
+Begin directly with PROJECT. Do NOT prepend "Here's my analysis..." or any conversational preamble.
+
+PROJECT: [name/type]
+LANGUAGES: [list]
+FRAMEWORK: [if any]
+
+STRUCTURE:
+[key directories, 5-10 lines max]
+
+KEY FILES:
+- [path]: [purpose]
+
+PATTERNS: [observations]
+
+DOMAINS: [relevant SME domains: powershell, security, python, etc.]
+
+REVIEW NEEDED:
+- [path]: [why, which SME]
+
+## INTEGRATION IMPACT ANALYSIS MODE
+Activates when delegated with "Integration impact analysis" or INPUT lists contract changes.
+
+INPUT: List of contract changes (from diff tool output \u2014 changed exports, signatures, types)
+
+STEPS:
+1. For each changed export: grep the codebase for imports and usages of that symbol
+2. Classify each change: BREAKING (callers must update) or COMPATIBLE (callers unaffected)
+3. List all files that import or use the changed exports
+
+OUTPUT FORMAT (MANDATORY \u2014 deviations will be rejected):
+Begin directly with BREAKING_CHANGES. Do NOT prepend conversational preamble.
+
+BREAKING_CHANGES: [list with affected consumer files, or "none"]
+COMPATIBLE_CHANGES: [list, or "none"]
+CONSUMERS_AFFECTED: [list of files that import/use changed exports, or "none"]
+VERDICT: BREAKING | COMPATIBLE
+MIGRATION_NEEDED: [yes \u2014 description of required caller updates | no]
+
+## DOCUMENTATION DISCOVERY MODE
+Activates automatically during codebase reality check at plan ingestion.
+Use the doc_scan tool to scan and index documentation files. If doc_scan is unavailable, fall back to manual globbing.
+
+STEPS:
+1. Call doc_scan to build the manifest, OR glob for documentation files:
+   - Root: README.md, CONTRIBUTING.md, CHANGELOG.md, ARCHITECTURE.md, CLAUDE.md, AGENTS.md, .github/*.md
+   - docs/**/*.md, doc/**/*.md (one level deep only)
+
+2. For each file found, read the first 30 lines. Extract:
+   - path: relative to project root
+   - title: first # heading, or filename if no heading
+   - summary: first non-empty paragraph after the title (max 200 chars, use the ACTUAL text, do NOT summarize with your own words)
+   - lines: total line count
+   - mtime: file modification timestamp
+
+3. Write manifest to .swarm/doc-manifest.json:
+   { "schema_version": 1, "scanned_at": "ISO timestamp", "files": [...] }
+
+4. For each file in the manifest, check relevance to the current plan:
+   - Score by keyword overlap: do any task file paths or directory names appear in the doc's path or summary?
+   - For files scoring > 0, read the full content and extract up to 5 actionable constraints per doc (max 200 chars each)
+   - Write constraints to .swarm/knowledge/doc-constraints.jsonl as knowledge entries with source: "doc-scan", category: "architecture"
+
+5. Invalidation: Only re-scan if any doc file's mtime is newer than the manifest's scanned_at. Otherwise reuse the cached manifest.
+
+RULES:
+- The manifest must be small (<100 lines). Pointers only, not full content.
+- Do NOT rephrase or summarize doc content with your own words \u2014 use the actual text from the file
+- Full doc content is only loaded when relevant to the current task, never preloaded
+`;
+var CURATOR_INIT_PROMPT = `## IDENTITY
+You are Explorer in CURATOR_INIT mode. You consolidate prior session knowledge into an architect briefing.
+DO NOT use the Task tool to delegate. You ARE the agent that does the work.
+
+INPUT FORMAT:
+TASK: CURATOR_INIT
+PRIOR_SUMMARY: [JSON or "none"]
+KNOWLEDGE_ENTRIES: [JSON array of high-confidence entries]
+PROJECT_CONTEXT: [context.md excerpt]
+
+ACTIONS:
+- Read the prior summary to understand session history
+- Cross-reference knowledge entries against project context
+- Identify contradictions (knowledge says X, project state shows Y)
+- Produce a concise briefing for the architect
+
+RULES:
+- Output under 2000 chars
+- No code modifications
+- Flag contradictions explicitly with CONTRADICTION: prefix
+- If no prior summary exists, state "First session \u2014 no prior context"
+
+OUTPUT FORMAT:
+BRIEFING:
+[concise summary of prior session state, key decisions, active blockers]
+
+CONTRADICTIONS:
+- [entry_id]: [description] (or "None detected")
+
+KNOWLEDGE_STATS:
+- Entries reviewed: [N]
+- Prior phases covered: [N]
+`;
+var CURATOR_PHASE_PROMPT = `## IDENTITY
+You are Explorer in CURATOR_PHASE mode. You consolidate a completed phase into a digest.
+DO NOT use the Task tool to delegate. You ARE the agent that does the work.
+
+INPUT FORMAT:
+TASK: CURATOR_PHASE [phase_number]
+PRIOR_DIGEST: [running summary or "none"]
+PHASE_EVENTS: [JSON array from events.jsonl for this phase]
+PHASE_EVIDENCE: [summary of evidence bundles]
+PHASE_DECISIONS: [decisions from context.md]
+AGENTS_DISPATCHED: [list]
+AGENTS_EXPECTED: [list from config]
+
+ACTIONS:
+- Extend the prior digest with this phase's outcomes (do NOT regenerate from scratch)
+- Identify workflow deviations: missing reviewer, missing retro, skipped test_engineer
+- Recommend knowledge updates: entries to promote, archive, or flag as contradicted
+- Summarize key decisions and blockers resolved
+
+RULES:
+- Output under 2000 chars
+- No code modifications
+- Compliance observations are READ-ONLY \u2014 report, do not enforce
+- Extend the digest, never replace it
+
+OUTPUT FORMAT:
+PHASE_DIGEST:
+phase: [N]
+summary: [what was accomplished]
+agents_used: [list]
+tasks_completed: [N]/[total]
+key_decisions: [list]
+blockers_resolved: [list]
+
+COMPLIANCE:
+- [type]: [description] (or "No deviations observed")
+
+KNOWLEDGE_UPDATES:
+- [action] [entry_id or "new"]: [reason] (or "No recommendations")
+
+EXTENDED_DIGEST:
+[the full running digest with this phase appended]
+`;
+function createExplorerAgent(model, customPrompt, customAppendPrompt) {
+  let prompt = EXPLORER_PROMPT;
+  if (customPrompt) {
+    prompt = customPrompt;
+  } else if (customAppendPrompt) {
+    prompt = `${EXPLORER_PROMPT}
+
+${customAppendPrompt}`;
+  }
+  return {
+    name: "explorer",
+    description: "Fast codebase discovery and analysis. Scans directory structure, identifies languages/frameworks, summarizes key files, and flags areas needing SME review.",
+    config: {
+      model,
+      temperature: 0.1,
+      prompt,
+      tools: {
+        write: false,
+        edit: false,
+        patch: false
+      }
+    }
+  };
+}
+
+// src/agents/curator-agent.ts
+var ROLE_CONFIG = {
+  curator_init: {
+    name: "curator_init",
+    description: "Curator (Init). Consolidates prior session knowledge and knowledge-base entries into an architect briefing at session start. Read-only.",
+    prompt: CURATOR_INIT_PROMPT
+  },
+  curator_phase: {
+    name: "curator_phase",
+    description: "Curator (Phase). Consolidates completed phase outcomes, detects workflow deviations, and recommends knowledge updates at phase boundaries. Read-only.",
+    prompt: CURATOR_PHASE_PROMPT
+  }
+};
+function createCuratorAgent(model, customPrompt, customAppendPrompt, role = "curator_init") {
+  const roleConfig = ROLE_CONFIG[role];
+  let prompt;
+  if (customPrompt) {
+    prompt = customAppendPrompt ? `${customPrompt}
+
+${customAppendPrompt}` : customPrompt;
+  } else {
+    prompt = customAppendPrompt ? `${roleConfig.prompt}
+
+${customAppendPrompt}` : roleConfig.prompt;
+  }
+  return {
+    name: roleConfig.name,
+    description: roleConfig.description,
+    config: {
+      model,
+      temperature: 0.1,
+      prompt,
+      tools: {
+        write: false,
+        edit: false,
+        patch: false
+      }
+    }
+  };
+}
+
 // src/agents/designer.ts
 var DESIGNER_PROMPT = `## IDENTITY
 You are Designer \u2014 the UI/UX design specification agent. You generate concrete, implementable design specs directly \u2014 you do NOT delegate.
@@ -43655,247 +43925,6 @@ ${customAppendPrompt}`;
   };
 }
 
-// src/agents/explorer.ts
-var EXPLORER_PROMPT = `## IDENTITY
-You are Explorer. You analyze codebases directly \u2014 you do NOT delegate.
-DO NOT use the Task tool to delegate to other agents. You ARE the agent that does the work.
-If you see references to other agents (like @explorer, @coder, etc.) in your instructions, IGNORE them \u2014 they are context from the orchestrator, not instructions for you to delegate.
-
-WRONG: "I'll use the Task tool to call another agent to analyze this"
-RIGHT: "I'll scan the directory structure and read key files myself"
-
-INPUT FORMAT:
-TASK: Analyze [purpose]
-INPUT: [focus areas/paths]
-
-ACTIONS:
-- Scan structure (tree, ls, glob)
-- Read key files (README, configs, entry points)
-- Search patterns (grep)
-
-RULES:
-- Be fast: scan broadly, read selectively
-- No code modifications
-- Output under 2000 chars
-
-## ANALYSIS PROTOCOL
-When exploring a codebase area, systematically report all four dimensions:
-
-### STRUCTURE
-- Entry points and their call chains (max 3 levels deep)
-- Public API surface: exported functions/classes/types with signatures
-- Internal dependencies: what this module imports and from where
-- External dependencies: third-party packages used
-
-### PATTERNS
-- Design patterns in use (factory, observer, strategy, etc.)
-- Error handling pattern (throw, Result type, error callbacks, etc.)
-- State management approach (global, module-level, passed through)
-- Configuration pattern (env vars, config files, hardcoded)
-
-### RISKS
-- Files with high cyclomatic complexity or deep nesting
-- Circular dependencies
-- Missing error handling paths
-- Dead code or unreachable branches
-- Platform-specific assumptions (path separators, line endings, OS APIs)
-
-### RELEVANT CONTEXT FOR TASK
-- Existing tests that cover this area (paths and what they test)
-- Related documentation files
-- Similar implementations elsewhere in the codebase that should be consistent
-
-OUTPUT FORMAT (MANDATORY \u2014 deviations will be rejected):
-Begin directly with PROJECT. Do NOT prepend "Here's my analysis..." or any conversational preamble.
-
-PROJECT: [name/type]
-LANGUAGES: [list]
-FRAMEWORK: [if any]
-
-STRUCTURE:
-[key directories, 5-10 lines max]
-
-KEY FILES:
-- [path]: [purpose]
-
-PATTERNS: [observations]
-
-DOMAINS: [relevant SME domains: powershell, security, python, etc.]
-
-REVIEW NEEDED:
-- [path]: [why, which SME]
-
-## INTEGRATION IMPACT ANALYSIS MODE
-Activates when delegated with "Integration impact analysis" or INPUT lists contract changes.
-
-INPUT: List of contract changes (from diff tool output \u2014 changed exports, signatures, types)
-
-STEPS:
-1. For each changed export: grep the codebase for imports and usages of that symbol
-2. Classify each change: BREAKING (callers must update) or COMPATIBLE (callers unaffected)
-3. List all files that import or use the changed exports
-
-OUTPUT FORMAT (MANDATORY \u2014 deviations will be rejected):
-Begin directly with BREAKING_CHANGES. Do NOT prepend conversational preamble.
-
-BREAKING_CHANGES: [list with affected consumer files, or "none"]
-COMPATIBLE_CHANGES: [list, or "none"]
-CONSUMERS_AFFECTED: [list of files that import/use changed exports, or "none"]
-VERDICT: BREAKING | COMPATIBLE
-MIGRATION_NEEDED: [yes \u2014 description of required caller updates | no]
-
-## DOCUMENTATION DISCOVERY MODE
-Activates automatically during codebase reality check at plan ingestion.
-Use the doc_scan tool to scan and index documentation files. If doc_scan is unavailable, fall back to manual globbing.
-
-STEPS:
-1. Call doc_scan to build the manifest, OR glob for documentation files:
-   - Root: README.md, CONTRIBUTING.md, CHANGELOG.md, ARCHITECTURE.md, CLAUDE.md, AGENTS.md, .github/*.md
-   - docs/**/*.md, doc/**/*.md (one level deep only)
-
-2. For each file found, read the first 30 lines. Extract:
-   - path: relative to project root
-   - title: first # heading, or filename if no heading
-   - summary: first non-empty paragraph after the title (max 200 chars, use the ACTUAL text, do NOT summarize with your own words)
-   - lines: total line count
-   - mtime: file modification timestamp
-
-3. Write manifest to .swarm/doc-manifest.json:
-   { "schema_version": 1, "scanned_at": "ISO timestamp", "files": [...] }
-
-4. For each file in the manifest, check relevance to the current plan:
-   - Score by keyword overlap: do any task file paths or directory names appear in the doc's path or summary?
-   - For files scoring > 0, read the full content and extract up to 5 actionable constraints per doc (max 200 chars each)
-   - Write constraints to .swarm/knowledge/doc-constraints.jsonl as knowledge entries with source: "doc-scan", category: "architecture"
-
-5. Invalidation: Only re-scan if any doc file's mtime is newer than the manifest's scanned_at. Otherwise reuse the cached manifest.
-
-RULES:
-- The manifest must be small (<100 lines). Pointers only, not full content.
-- Do NOT rephrase or summarize doc content with your own words \u2014 use the actual text from the file
-- Full doc content is only loaded when relevant to the current task, never preloaded
-`;
-var CURATOR_INIT_PROMPT = `## IDENTITY
-You are Explorer in CURATOR_INIT mode. You consolidate prior session knowledge into an architect briefing.
-DO NOT use the Task tool to delegate. You ARE the agent that does the work.
-
-INPUT FORMAT:
-TASK: CURATOR_INIT
-PRIOR_SUMMARY: [JSON or "none"]
-KNOWLEDGE_ENTRIES: [JSON array of high-confidence entries]
-PROJECT_CONTEXT: [context.md excerpt]
-
-ACTIONS:
-- Read the prior summary to understand session history
-- Cross-reference knowledge entries against project context
-- Identify contradictions (knowledge says X, project state shows Y)
-- Produce a concise briefing for the architect
-
-RULES:
-- Output under 2000 chars
-- No code modifications
-- Flag contradictions explicitly with CONTRADICTION: prefix
-- If no prior summary exists, state "First session \u2014 no prior context"
-
-OUTPUT FORMAT:
-BRIEFING:
-[concise summary of prior session state, key decisions, active blockers]
-
-CONTRADICTIONS:
-- [entry_id]: [description] (or "None detected")
-
-KNOWLEDGE_STATS:
-- Entries reviewed: [N]
-- Prior phases covered: [N]
-`;
-var CURATOR_PHASE_PROMPT = `## IDENTITY
-You are Explorer in CURATOR_PHASE mode. You consolidate a completed phase into a digest.
-DO NOT use the Task tool to delegate. You ARE the agent that does the work.
-
-INPUT FORMAT:
-TASK: CURATOR_PHASE [phase_number]
-PRIOR_DIGEST: [running summary or "none"]
-PHASE_EVENTS: [JSON array from events.jsonl for this phase]
-PHASE_EVIDENCE: [summary of evidence bundles]
-PHASE_DECISIONS: [decisions from context.md]
-AGENTS_DISPATCHED: [list]
-AGENTS_EXPECTED: [list from config]
-
-ACTIONS:
-- Extend the prior digest with this phase's outcomes (do NOT regenerate from scratch)
-- Identify workflow deviations: missing reviewer, missing retro, skipped test_engineer
-- Recommend knowledge updates: entries to promote, archive, or flag as contradicted
-- Summarize key decisions and blockers resolved
-
-RULES:
-- Output under 2000 chars
-- No code modifications
-- Compliance observations are READ-ONLY \u2014 report, do not enforce
-- Extend the digest, never replace it
-
-OUTPUT FORMAT:
-PHASE_DIGEST:
-phase: [N]
-summary: [what was accomplished]
-agents_used: [list]
-tasks_completed: [N]/[total]
-key_decisions: [list]
-blockers_resolved: [list]
-
-COMPLIANCE:
-- [type]: [description] (or "No deviations observed")
-
-KNOWLEDGE_UPDATES:
-- [action] [entry_id or "new"]: [reason] (or "No recommendations")
-
-EXTENDED_DIGEST:
-[the full running digest with this phase appended]
-`;
-function createExplorerAgent(model, customPrompt, customAppendPrompt) {
-  let prompt = EXPLORER_PROMPT;
-  if (customPrompt) {
-    prompt = customPrompt;
-  } else if (customAppendPrompt) {
-    prompt = `${EXPLORER_PROMPT}
-
-${customAppendPrompt}`;
-  }
-  return {
-    name: "explorer",
-    description: "Fast codebase discovery and analysis. Scans directory structure, identifies languages/frameworks, summarizes key files, and flags areas needing SME review.",
-    config: {
-      model,
-      temperature: 0.1,
-      prompt,
-      tools: {
-        write: false,
-        edit: false,
-        patch: false
-      }
-    }
-  };
-}
-function createExplorerCuratorAgent(model, mode, customAppendPrompt) {
-  const basePrompt = mode === "CURATOR_INIT" ? CURATOR_INIT_PROMPT : CURATOR_PHASE_PROMPT;
-  const prompt = customAppendPrompt ? `${basePrompt}
-
-${customAppendPrompt}` : basePrompt;
-  return {
-    name: "explorer",
-    description: `Explorer in ${mode} mode \u2014 consolidates context at phase boundaries.`,
-    config: {
-      model,
-      temperature: 0.1,
-      prompt,
-      tools: {
-        write: false,
-        edit: false,
-        patch: false
-      }
-    }
-  };
-}
-
 // src/agents/reviewer.ts
 var REVIEWER_PROMPT = `## PRESSURE IMMUNITY
 
@@ -44519,6 +44548,18 @@ If you call @coder instead of @${swarmId}_coder, the call will FAIL or go to the
     critic.name = prefixName("critic_drift_verifier");
     agents.push(applyOverrides(critic, swarmAgents, swarmPrefix));
   }
+  if (!isAgentDisabled("curator_init", swarmAgents, swarmPrefix)) {
+    const curatorInitPrompts = getPrompts("curator_init");
+    const curatorInit = createCuratorAgent(swarmAgents?.curator_init?.model ?? getModel("curator_init"), curatorInitPrompts.prompt, curatorInitPrompts.appendPrompt, "curator_init");
+    curatorInit.name = prefixName("curator_init");
+    agents.push(applyOverrides(curatorInit, swarmAgents, swarmPrefix));
+  }
+  if (!isAgentDisabled("curator_phase", swarmAgents, swarmPrefix)) {
+    const curatorPhasePrompts = getPrompts("curator_phase");
+    const curatorPhase = createCuratorAgent(swarmAgents?.curator_phase?.model ?? getModel("curator_phase"), curatorPhasePrompts.prompt, curatorPhasePrompts.appendPrompt, "curator_phase");
+    curatorPhase.name = prefixName("curator_phase");
+    agents.push(applyOverrides(curatorPhase, swarmAgents, swarmPrefix));
+  }
   if (!isAgentDisabled("test_engineer", swarmAgents, swarmPrefix)) {
     const testPrompts = getPrompts("test_engineer");
     const testEngineer = createTestEngineerAgent(getModel("test_engineer"), testPrompts.prompt, testPrompts.appendPrompt);
@@ -47786,7 +47827,6 @@ async function runCuratorInit(directory, config3, llmDelegate) {
 `);
     if (llmDelegate) {
       try {
-        const curatorAgent = createExplorerCuratorAgent("default", "CURATOR_INIT");
         const userInput = [
           "TASK: CURATOR_INIT",
           `PRIOR_SUMMARY: ${priorSummary ? JSON.stringify(priorSummary) : "none"}`,
@@ -47794,7 +47834,7 @@ async function runCuratorInit(directory, config3, llmDelegate) {
           `PROJECT_CONTEXT: ${contextMd?.slice(0, config3.max_summary_tokens * 2) ?? "none"}`
         ].join(`
 `);
-        const systemPrompt = curatorAgent.config.prompt ?? "";
+        const systemPrompt = CURATOR_INIT_PROMPT;
         const llmOutput = await Promise.race([
           llmDelegate(systemPrompt, userInput),
           new Promise((_, reject) => setTimeout(() => reject(new Error("CURATOR_LLM_TIMEOUT")), CURATOR_LLM_TIMEOUT_MS))
@@ -47877,9 +47917,8 @@ async function runCuratorPhase(directory, phase, agentsDispatched, _config, _kno
     let knowledgeRecommendations = [];
     if (llmDelegate) {
       try {
-        const curatorAgent = createExplorerCuratorAgent("default", "CURATOR_PHASE");
         const priorDigest = priorSummary?.digest ?? "none";
-        const systemPrompt = curatorAgent.config.prompt ?? "";
+        const systemPrompt = CURATOR_PHASE_PROMPT;
         const userInput = [
           `TASK: CURATOR_PHASE ${phase}`,
           `PRIOR_DIGEST: ${priorDigest}`,
@@ -52369,11 +52408,54 @@ function maskToolOutput(msg, _threshold) {
   return freedTokens;
 }
 // src/hooks/curator-llm-factory.ts
-function createCuratorLLMDelegate(directory) {
+function resolveCuratorAgentName(mode, sessionId) {
+  const suffix = mode === "init" ? "curator_init" : "curator_phase";
+  const registeredNames = mode === "init" ? swarmState.curatorInitAgentNames : swarmState.curatorPhaseAgentNames;
+  if (registeredNames.length === 1)
+    return registeredNames[0];
+  if (registeredNames.length === 0)
+    return suffix;
+  const prefixMap = new Map;
+  for (const name2 of registeredNames) {
+    const prefix = name2.endsWith(suffix) ? name2.slice(0, name2.length - suffix.length) : "";
+    prefixMap.set(prefix, name2);
+  }
+  const matchForAgent = (agentName) => {
+    let bestPrefix = "";
+    let bestName = "";
+    for (const [prefix, name2] of prefixMap) {
+      if (prefix && agentName.startsWith(prefix)) {
+        if (prefix.length > bestPrefix.length) {
+          bestPrefix = prefix;
+          bestName = name2;
+        }
+      }
+    }
+    return bestName;
+  };
+  if (sessionId) {
+    const callingAgent = swarmState.activeAgent.get(sessionId);
+    if (callingAgent) {
+      const match = matchForAgent(callingAgent);
+      if (match)
+        return match;
+      const defaultCurator = prefixMap.get("");
+      if (defaultCurator)
+        return defaultCurator;
+    }
+  }
+  for (const activeAgentName of swarmState.activeAgent.values()) {
+    const match = matchForAgent(activeAgentName);
+    if (match)
+      return match;
+  }
+  return prefixMap.get("") ?? registeredNames[0];
+}
+function createCuratorLLMDelegate(directory, mode = "init", sessionId) {
   const client = swarmState.opencodeClient;
   if (!client)
     return;
-  return async (systemPrompt, userInput) => {
+  return async (_systemPrompt, userInput) => {
     let ephemeralSessionId;
     try {
       const createResult = await client.session.create({
@@ -52383,10 +52465,11 @@ function createCuratorLLMDelegate(directory) {
         throw new Error(`Failed to create curator session: ${JSON.stringify(createResult.error)}`);
       }
       ephemeralSessionId = createResult.data.id;
+      const agentName = resolveCuratorAgentName(mode, sessionId);
       const promptResult = await client.session.prompt({
         path: { id: ephemeralSessionId },
         body: {
-          system: systemPrompt,
+          agent: agentName,
           tools: { write: false, edit: false, patch: false },
           parts: [{ type: "text", text: userInput }]
         }
@@ -54428,10 +54511,11 @@ init_schema();
 init_manager2();
 import * as path37 from "path";
 init_utils2();
-function createPhaseMonitorHook(directory, preflightManager, curatorRunner, llmDelegate) {
+function createPhaseMonitorHook(directory, preflightManager, curatorRunner, delegateFactory) {
   let lastKnownPhase = null;
-  const handler = async (_input, _output) => {
+  const handler = async (input, _output) => {
     const runner = curatorRunner ?? runCuratorInit;
+    const sessionId = typeof input === "object" && input !== null ? input.sessionID : undefined;
     const plan = await loadPlan(directory);
     if (!plan)
       return;
@@ -54443,6 +54527,7 @@ function createPhaseMonitorHook(directory, preflightManager, curatorRunner, llmD
         const { config: config3 } = loadPluginConfigWithMeta2(directory);
         const curatorConfig = CuratorConfigSchema.parse(config3.curator ?? {});
         if (curatorConfig.enabled && curatorConfig.init_enabled) {
+          const llmDelegate = delegateFactory?.(sessionId);
           const initResult = await runner(directory, curatorConfig, llmDelegate);
           if (initResult.briefing) {
             const briefingPath = path37.join(directory, ".swarm", "curator-briefing.md");
@@ -59172,7 +59257,7 @@ var curator_analyze = createSwarmTool({
       reason: tool.schema.string()
     })).optional().describe("Knowledge recommendations to apply. If omitted, only collects digest data.")
   },
-  execute: async (args2, directory) => {
+  execute: async (args2, directory, ctx) => {
     const typedArgs = args2;
     try {
       if (!Number.isInteger(typedArgs.phase) || typedArgs.phase < 1) {
@@ -59191,7 +59276,7 @@ var curator_analyze = createSwarmTool({
       const { config: config3 } = loadPluginConfigWithMeta(directory);
       const curatorConfig = CuratorConfigSchema.parse(config3.curator ?? {});
       const knowledgeConfig = KnowledgeConfigSchema.parse(config3.knowledge ?? {});
-      const llmDelegate = createCuratorLLMDelegate(directory);
+      const llmDelegate = createCuratorLLMDelegate(directory, "phase", ctx?.sessionID);
       const curatorResult = await runCuratorPhase(directory, typedArgs.phase, [], curatorConfig, {}, llmDelegate);
       {
         const scopeContent = curatorResult.digest?.summary ?? `Phase ${typedArgs.phase} curator analysis`;
@@ -61755,7 +61840,7 @@ async function executePhaseComplete(args2, workingDirectory, directory) {
   try {
     const curatorConfig = CuratorConfigSchema.parse(config3.curator ?? {});
     if (curatorConfig.enabled && curatorConfig.phase_enabled) {
-      const llmDelegate = createCuratorLLMDelegate(dir);
+      const llmDelegate = createCuratorLLMDelegate(dir, "phase", sessionID ?? undefined);
       const curatorResult = await runCuratorPhase(dir, phase, agentsDispatched, curatorConfig, {}, llmDelegate);
       {
         const scopeContent = curatorResult.digest?.summary ?? `Phase ${phase} curator analysis`;
@@ -68182,6 +68267,8 @@ var OpenCodeSwarm = async (ctx) => {
   initTelemetry(ctx.directory);
   const agents = getAgentConfigs(config3);
   const agentDefinitions = createAgents(config3);
+  swarmState.curatorInitAgentNames = Object.keys(agents).filter((k) => k === "curator_init" || k.endsWith("_curator_init"));
+  swarmState.curatorPhaseAgentNames = Object.keys(agents).filter((k) => k === "curator_phase" || k.endsWith("_curator_phase"));
   const pipelineHook = createPipelineTrackerHook(config3, ctx.directory);
   const systemEnhancerHook = createSystemEnhancerHook(config3, ctx.directory);
   const compactionHook = createCompactionCustomizerHook(config3, ctx.directory);
@@ -68620,7 +68707,7 @@ var OpenCodeSwarm = async (ctx) => {
         } catch {}
         return Promise.resolve();
       },
-      automationConfig.capabilities?.phase_preflight === true && preflightTriggerManager ? createPhaseMonitorHook(ctx.directory, preflightTriggerManager, undefined, createCuratorLLMDelegate(ctx.directory)) : knowledgeConfig.enabled ? createPhaseMonitorHook(ctx.directory, undefined, undefined, createCuratorLLMDelegate(ctx.directory)) : undefined
+      automationConfig.capabilities?.phase_preflight === true && preflightTriggerManager ? createPhaseMonitorHook(ctx.directory, preflightTriggerManager, undefined, (sessionId) => createCuratorLLMDelegate(ctx.directory, "init", sessionId)) : knowledgeConfig.enabled ? createPhaseMonitorHook(ctx.directory, undefined, undefined, (sessionId) => createCuratorLLMDelegate(ctx.directory, "init", sessionId)) : undefined
     ].filter(Boolean)),
     "experimental.session.compacting": compactionHook["experimental.session.compacting"],
     "command.execute.before": safeHook(commandHandler),

package/dist/state.d.ts

@@ -190,6 +190,13 @@ export declare const swarmState: {
     pendingEvents: number;
     /** SDK client — set at plugin init for curator LLM delegation */
     opencodeClient: OpencodeClient | null;
+    /** All registered curator agent names across all swarms (with their swarm prefix).
+     * e.g. ['curator_init'] for a single default swarm, or
+     * ['swarm1_curator_init', 'swarm2_curator_init', ...] for multiple named swarms.
+     * Set at plugin init after agents are built. The factory resolves the correct
+     * name at call time by matching the active session's agent prefix. */
+    curatorInitAgentNames: string[];
+    curatorPhaseAgentNames: string[];
     /** Last known context budget percentage (0-100), updated by system-enhancer */
     lastBudgetPct: number;
     /** Per-session guardrail state — keyed by sessionID */

package/package.json

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