opencode-swarm 7.132.2 → 7.134.0

package/dist/state.d.ts

@@ -64,6 +64,62 @@ export interface PrSubscriptionState {
  * Transitions must be forward-only: idle → coder_delegated → pre_check_passed → reviewer_run → tests_run → complete
  */
 export type TaskWorkflowState = 'idle' | 'coder_delegated' | 'pre_check_passed' | 'reviewer_run' | 'tests_run' | 'complete';
+/**
+ * Upper bound for per-session task file-attribution entries.
+ *
+ * Runtime concurrency is capped well below this value. When the map is full,
+ * only workflow-complete entries may be reclaimed; live task attribution is
+ * never evicted to make room.
+ */
+export declare const MAX_TRACKED_TASK_FILE_ATTRIBUTIONS = 128;
+/** Exact lifecycle state for one coder generation and its paired reviewer. */
+export interface ReviewerScopeGeneration {
+    taskId: string;
+    coderCallID: string;
+    generation: number;
+    sessionIncarnation: string;
+    background: boolean;
+    declaredFiles: string[];
+    modifiedFiles: string[];
+    modifiedFileFingerprints: import('./hooks/reviewer-scope-file-fingerprint.js').ReviewerScopeFileFingerprint[];
+    status: 'collecting' | 'ready' | 'claimed';
+    createdAt: number;
+    readyAt?: number;
+    reviewerCallID?: string;
+    reviewerDispatchScope?: ReviewerScopeDispatchSnapshot;
+}
+export interface ReviewerScopeDispatchSnapshot {
+    hash: string;
+    description: string;
+    files: string[];
+    headSha: string;
+    taskId: string;
+    coderCallID: string;
+    generation: number;
+    sessionIncarnation: string;
+}
+export interface ReviewerScopeGenerationIdentity {
+    generation: number;
+    coderCallID: string;
+    sessionIncarnation: string;
+}
+/**
+ * Immutable ownership provenance retained after a background generation's
+ * reviewer consumes the live handoff. Delayed sibling completion ingestion may
+ * consult this bounded history, but only exact fingerprints and overlapping
+ * dispatch intervals can establish ownership.
+ */
+export interface ReviewerScopeOwnershipTombstone extends ReviewerScopeGenerationIdentity {
+    parentSessionID: string;
+    taskId: string;
+    background: true;
+    declaredFiles: string[];
+    modifiedFiles: string[];
+    modifiedFileFingerprints: import('./hooks/reviewer-scope-file-fingerprint.js').ReviewerScopeFileFingerprint[];
+    createdAt: number;
+    readyAt: number;
+    consumedAt: number;
+}
 /**
  * Represents per-session state for guardrail tracking.
  * Budget fields (toolCallCount, consecutiveErrors, etc.) have moved to InvocationWindow.
@@ -170,8 +226,23 @@ export interface AgentSessionState {
     lastScopeViolation: string | null;
     /** Flag for one-shot scope violation warning injection in messagesTransform */
     scopeViolationDetected?: boolean;
-    /** Files modified by the current coder task (populated by guardrails toolBefore/toolAfter, reset on new coder delegation) */
+    /** Task-keyed files modified by coder work. Bounded by MAX_TRACKED_TASK_FILE_ATTRIBUTIONS. */
+    modifiedFilesByTask: Map<string, string[]>;
+    /**
+     * Compatibility projection for callers that still inspect the active task.
+     * Helpers in this module keep it synchronized only with `currentTaskId`.
+     */
     modifiedFilesThisCoderTask: string[];
+    /** Bounded coder generations awaiting exact reviewer claims. */
+    reviewerScopeGenerations?: Map<string, ReviewerScopeGeneration>;
+    /** Monotonic per-session generation source; call identity remains authoritative. */
+    reviewerScopeGenerationCounter?: number;
+    /** Non-reused identity for this in-memory parent-session incarnation. */
+    reviewerScopeIncarnation?: string;
+    /** Latest generation token by task, retained through async validation. */
+    reviewerScopeLatestGenerationByTask?: Map<string, ReviewerScopeGenerationIdentity>;
+    /** Bounded recent background ownership retained after reviewer consumption. */
+    reviewerScopeOwnershipHistory?: Map<string, ReviewerScopeOwnershipTombstone>;
     /** Number of coder revisions in the current task (incremented on each coder delegation completion) */
     coderRevisions: number;
     /** Flag set when coder revisions hit the configured ceiling */
@@ -449,6 +520,127 @@ export declare function resetSwarmState(): void;
  * propagate to caller (no try/catch wrapper).
  */
 export declare function resetSwarmStatePreservingSingletons(): void;
+/** Match the Stage-B scope builder's hard file-count ceiling. */
+export declare const MAX_REVIEWER_SCOPE_GENERATION_FILES = 256;
+/** One parent session may retain at most this many parallel task generations. */
+export declare const MAX_REVIEWER_SCOPE_GENERATIONS = 256;
+/** Recent consumed owners are bounded to the maximum parallel generation set. */
+export declare const MAX_REVIEWER_SCOPE_OWNERSHIP_HISTORY = 256;
+/** Generation expiry never exceeds the parent session's normal idle TTL. */
+export declare const REVIEWER_SCOPE_GENERATION_TTL_MS = 7200000;
+/** Begin one exact coder generation after the full blocking before-chain passes. */
+export declare function startReviewerScopeGeneration(input: {
+    parentSessionID: string;
+    taskId: string;
+    coderCallID: string;
+    background?: boolean;
+    declaredFiles?: string[];
+    createdAt?: number;
+}): ReviewerScopeGeneration | null;
+/** Route one child-observed write to its exact parent/task/coder generation. */
+export declare function recordReviewerScopeGenerationFile(input: {
+    parentSessionID: string;
+    taskId: string;
+    coderCallID: string;
+    file: string;
+    now?: number;
+}): boolean;
+/**
+ * Record the bounded post-write state only after a guarded child write returns
+ * successfully. Pre-write routing in modifiedFiles remains authorization metadata.
+ */
+export declare function recordReviewerScopeGenerationFileFingerprint(input: {
+    parentSessionID: string;
+    taskId: string;
+    coderCallID: string;
+    fingerprint: import('./hooks/reviewer-scope-file-fingerprint.js').ReviewerScopeFileFingerprint;
+}): boolean;
+/** Mark the exact coder call terminal; background running placeholders do not call this. */
+export declare function markReviewerScopeGenerationReady(input: {
+    parentSessionID: string;
+    taskId: string;
+    coderCallID: string;
+    readyAt?: number;
+}): boolean;
+/** Read one exact coder generation for terminal guardrail/evidence checks. */
+export declare function getReviewerScopeGenerationForCoderCall(input: {
+    parentSessionID: string;
+    taskId?: string;
+    coderCallID: string;
+    now?: number;
+}): ReviewerScopeGeneration | null;
+/** Inspect the only ready generation for a task without claiming it. */
+export declare function peekReadyReviewerScopeGeneration(input: {
+    parentSessionID: string;
+    taskId: string;
+    now?: number;
+}): ReviewerScopeGeneration | null;
+/**
+ * Claim the only ready generation for an exact task after every blocking
+ * reviewer before-hook has passed. Ambiguity fails closed to no receipt.
+ */
+export declare function claimReviewerScopeGeneration(input: {
+    parentSessionID: string;
+    taskId: string;
+    reviewerCallID: string;
+    now?: number;
+}): ReviewerScopeGeneration | null;
+/** Bind the immutable scope captured immediately before the reviewer Task dispatch. */
+export declare function attachReviewerScopeGenerationDispatchSnapshot(input: {
+    parentSessionID: string;
+    taskId: string;
+    reviewerCallID: string;
+    snapshot: ReviewerScopeDispatchSnapshot;
+}): boolean;
+/** Terminal one-shot consumption by exact task and reviewer Task call. */
+export declare function takeReviewerScopeGeneration(input: {
+    parentSessionID: string;
+    taskId: string;
+    reviewerCallID: string;
+    now?: number;
+}): ReviewerScopeGeneration | null;
+/** Read bounded immutable ownership history for delayed background ingestion. */
+export declare function getReviewerScopeOwnershipHistory(input: {
+    parentSessionID: string;
+}): ReviewerScopeOwnershipTombstone[];
+/** Inspect one exact reviewer claim without consuming retryable state. */
+export declare function peekReviewerScopeGenerationClaim(input: {
+    parentSessionID: string;
+    taskId: string;
+    reviewerCallID: string;
+    now?: number;
+}): ReviewerScopeGeneration | null;
+/** Clear one exact terminal/stale reviewer claim without touching parallel tasks. */
+export declare function discardReviewerScopeGenerationClaim(input: {
+    parentSessionID: string;
+    taskId?: string;
+    reviewerCallID: string;
+}): boolean;
+/**
+ * Detect a concurrently collecting coder generation whose declaration overlaps
+ * this exact coder call. Shared declared paths cannot be attributed safely from
+ * one workspace snapshot, even when child write routing observed both calls.
+ */
+export declare function reviewerScopeGenerationHasDeclaredOverlap(input: {
+    parentSessionID: string;
+    taskId: string;
+    coderCallID: string;
+    declaredFiles: string[];
+}): boolean;
+/** Clear one exact collecting/ready coder generation on terminal error/stale. */
+export declare function discardReviewerScopeGenerationForCoderCall(input: {
+    parentSessionID: string;
+    taskId?: string;
+    coderCallID: string;
+}): boolean;
+/** Validate an async result against the latest coder generation for its task. */
+export declare function isReviewerScopeGenerationCurrent(input: {
+    parentSessionID: string;
+    taskId: string;
+    coderCallID: string;
+    generation: number;
+    sessionIncarnation: string;
+}): boolean;
 /**
  * Evict every agent session whose last tool activity is older than
  * staleDurationMs, and drop the delegation chain keyed by that same sessionID
@@ -558,6 +750,35 @@ export declare function pruneOldWindows(sessionId: string, maxAgeMs?: number, ma
  * @param agentName - Agent name to record (will be normalized)
  */
 export declare function recordPhaseAgentDispatch(sessionId: string, agentName: string): void;
+/**
+ * Atomically replace one task's attributed file list.
+ *
+ * Returns false without mutation when the task id is invalid or the bounded
+ * map has no reclaimable workflow-complete slot.
+ */
+export declare function recordModifiedFilesForTask(session: AgentSessionState, taskId: string, files: readonly string[]): boolean;
+/**
+ * Add one file to a task's attribution without disturbing its existing files.
+ */
+export declare function recordModifiedFileForTask(session: AgentSessionState, taskId: string, file: string): boolean;
+/**
+ * Return a defensive copy of the files attributed to one task.
+ */
+export declare function getModifiedFilesForTask(session: AgentSessionState, taskId: string): string[];
+/**
+ * Reset one task's attribution. `remove` is used at terminal cleanup; the
+ * default keeps an empty live-task slot ready for subsequent writes.
+ */
+export declare function resetModifiedFilesForTask(session: AgentSessionState, taskId: string, options?: {
+    remove?: boolean;
+}): boolean;
+/**
+ * Apply task-completion retention rules.
+ *
+ * Non-Epic sessions release attribution at the workflow-complete boundary.
+ * Epic sessions retain it until `epic_record_divergence` consumes the entry.
+ */
+export declare function completeModifiedFilesForTask(session: AgentSessionState, taskId: string): void;
 /**
  * Advance a task's workflow state. Validates forward-only transitions.
  * Throws 'INVALID_TASK_STATE_TRANSITION: [taskId] [current] → [requested]' on illegal transition.

package/dist/tools/dispatch-lanes.d.ts

@@ -67,7 +67,7 @@ declare function validatePrReviewMicroDispatch(args: DispatchLanesAsyncArgs, dep
 export type DispatchLanesArgs = z.infer<typeof DispatchLanesArgsSchema>;
 export type DispatchLanesAsyncArgs = z.infer<typeof DispatchLanesAsyncArgsSchema>;
 export type CollectLaneResultsArgs = z.infer<typeof CollectLaneResultsArgsSchema>;
-export type DispatchLaneStatus = 'pending' | 'completed' | 'failed' | 'rejected' | 'cancelled' | 'stale' | 'consumed';
+export type DispatchLaneStatus = 'pending' | 'completed' | 'failed' | 'rejected' | 'cancelled' | 'stale' | 'ingesting' | 'consumed';
 export interface DispatchLaneResult {
     id: string;
     agent: string;
@@ -256,6 +256,7 @@ export declare const _test_exports: {
     applyCommonPrompt: typeof applyCommonPrompt;
     applyExplorerFormatSuffix: typeof applyExplorerFormatSuffix;
     applyPrWorkflowPromptContract: typeof applyPrWorkflowPromptContract;
+    buildCollectResult: typeof buildCollectResult;
     buildReadOnlyTools: typeof buildReadOnlyTools;
     buildLaneSessionCreateArgs: typeof buildLaneSessionCreateArgs;
     extractAssistantTranscript: typeof extractAssistantTranscript;
@@ -341,6 +342,7 @@ declare function extractAssistantTranscript(messages: Array<{
     transcriptIncomplete: boolean;
 };
 declare function nextCollectPollInterval(currentMs: number): number;
+declare function buildCollectResult(batchId: string, records: BackgroundDelegationRecord[], includePending: boolean): CollectLaneResultsResult;
 declare function recordToLaneResult(record: BackgroundDelegationRecord, batchId: string): DispatchLaneResult;
 declare function buildReadOnlyTools(): ReadOnlyToolPermissions;
 type ApplyCommonPromptResult = {

package/dist/tools/epic-record-divergence.d.ts

@@ -6,10 +6,8 @@
  *
  *   1. Reads the task's DECLARED scope from `.swarm/scopes/scope-{taskId}.json`
  *      (the same on-disk record `readScopeFromDisk` consults).
- *   2. Reads the ACTUAL files the coder modified from the session's
- *      `modifiedFilesThisCoderTask` — populated by the guardrails write hook
- *      and reset by Lean Turbo at task-boundaries, so it captures THIS
- *      task's writes only.
+ *   2. Reads the ACTUAL files attributed to this exact task by the guardrails
+ *      write hook and background-completion ingestion.
  *   3. Appends one record to `.swarm/epic/divergence.jsonl` via
  *      `recordTaskDivergence`. The calibration engine reads that file on the
  *      next `epic_decide_phase` invocation (the architect-facing decide
@@ -28,7 +26,7 @@
 import type { ToolDefinition } from '@opencode-ai/plugin/tool';
 import { loadPlanJsonOnly as loadPlanJsonOnly_import } from '../plan/manager.js';
 import { readScopeFromDisk as readScopeFromDisk_import } from '../scope/scope-persistence.js';
-import { getAgentSession as getAgentSession_import, hasActiveEpicMode as hasActiveEpicMode_import } from '../state.js';
+import { getAgentSession as getAgentSession_import, getModifiedFilesForTask as getModifiedFilesForTask_import, hasActiveEpicMode as hasActiveEpicMode_import, resetModifiedFilesForTask as resetModifiedFilesForTask_import } from '../state.js';
 import { recordTaskDivergence as recordTaskDivergence_import } from '../turbo/epic/divergence-recorder.js';
 export interface EpicRecordDivergenceArgs {
     directory: string;
@@ -65,6 +63,8 @@ export interface EpicRecordDivergenceResult {
 export declare const _internals: {
     hasActiveEpicMode: typeof hasActiveEpicMode_import;
     getAgentSession: typeof getAgentSession_import;
+    getModifiedFilesForTask: typeof getModifiedFilesForTask_import;
+    resetModifiedFilesForTask: typeof resetModifiedFilesForTask_import;
     readScopeFromDisk: typeof readScopeFromDisk_import;
     loadPlanJsonOnly: typeof loadPlanJsonOnly_import;
     recordTaskDivergence: typeof recordTaskDivergence_import;

package/dist/tools/lean-turbo-review.d.ts

@@ -4,6 +4,8 @@
  * Dispatches a read-only reviewer agent to evaluate a completed Lean Turbo phase.
  */
 import type { ToolDefinition } from '@opencode-ai/plugin/tool';
+import type { ReviewModelDispatcher } from '../review/contracts.js';
+import type { ReviewAgentModelRegistry } from '../review/runtime.js';
 import { type PhaseReviewerResult } from '../turbo/lean/reviewer';
 /**
  * Arguments for the lean_turbo_review tool
@@ -27,8 +29,9 @@ export interface LeanTurboReviewResult {
  * Execute the lean_turbo_review tool.
  * Dispatches a read-only reviewer agent to evaluate a completed Lean Turbo phase.
  */
-export declare function executeLeanTurboReview(args: LeanTurboReviewArgs): Promise<LeanTurboReviewResult>;
+export declare function executeLeanTurboReview(args: LeanTurboReviewArgs, dispatcher?: ReviewModelDispatcher, generatedAgentNames?: readonly string[], agentModelRegistry?: ReviewAgentModelRegistry, activeAgentName?: string): Promise<LeanTurboReviewResult>;
 /**
  * Tool definition for lean_turbo_review
  */
+export declare function createLeanTurboReviewTool(dispatcher?: ReviewModelDispatcher, generatedAgentNames?: readonly string[], agentModelRegistry?: ReviewAgentModelRegistry, getActiveAgentName?: (sessionID: string) => string | undefined): ToolDefinition;
 export declare const lean_turbo_review: ToolDefinition;

package/dist/tools/lean-turbo-run-phase.d.ts

@@ -36,6 +36,7 @@ export interface LeanTurboRunPhaseResult {
 /**
  * Test-only dependency-injection seam.
  * Allows tests to inject mocks without mock.module leakage.
+ * @tool-opt-out Test-only dependency-injection seam; not a public tool.
  */
 export declare const _internals: {
     LeanTurboRunner: typeof LeanTurboRunner_import;
@@ -45,8 +46,9 @@ export declare const _internals: {
  * Execute the lean_turbo_run_phase tool.
  * Creates a LeanTurboRunner and executes the specified phase.
  */
-export declare function executeLeanTurboRunPhase(args: LeanTurboRunPhaseArgs): Promise<LeanTurboRunPhaseResult>;
+export declare function executeLeanTurboRunPhase(args: LeanTurboRunPhaseArgs, generatedAgentNames?: readonly string[]): Promise<LeanTurboRunPhaseResult>;
 /**
  * Tool definition for lean_turbo_run_phase
  */
+export declare function createLeanTurboRunPhaseTool(generatedAgentNames?: readonly string[]): ToolDefinition;
 export declare const lean_turbo_run_phase: ToolDefinition;

package/dist/tools/phase-complete/gates/final-review-gate.d.ts

@@ -0,0 +1,18 @@
+import { collectReviewDiff } from '../../../review/diff-source.js';
+import type { GateContext, GateResult } from './types.js';
+/**
+ * Evidence-only final review gate.
+ *
+ * The model dispatch belongs to the phase_complete tool body. This gate performs
+ * one bounded, model-free scope collection at the terminal decision point, then
+ * verifies that the persisted artifact and in-memory result both describe that
+ * current scope and that the configured blocking policy is satisfied.
+ */
+export declare function runFinalReviewGate(ctx: GateContext): Promise<GateResult>;
+/**
+ * File-scoped injection seam. Production always uses the bounded Git collector;
+ * tests replace only this boundary to avoid process-global module mocks.
+ */
+export declare const _internals: {
+    collectReviewDiff: typeof collectReviewDiff;
+};

package/dist/tools/phase-complete/gates/index.d.ts

@@ -6,6 +6,7 @@ export { runArchitectureSupervisorGate } from './architecture-supervisor-gate.js
 export { runCompletionVerifyGate } from './completion-verify-gate.js';
 export { runDriftGate } from './drift-gate.js';
 export { runFinalCouncilGate } from './final-council-gate.js';
+export { runFinalReviewGate } from './final-review-gate.js';
 export { runHallucinationGate } from './hallucination-gate.js';
 export { runMutationGate } from './mutation-gate.js';
 export { runPhaseCouncilGate } from './phase-council-gate.js';

package/dist/tools/phase-complete/gates/types.d.ts

@@ -40,4 +40,14 @@ export interface GateContext {
     loadedRetroBundle?: import('../../../config/evidence-schema').EvidenceBundle | null;
     /** Task id for the accepted retrospective bundle, if one was loaded */
     loadedRetroTaskId?: string | null;
+    /** Exact scope produced by the model-dispatching phase_complete body. */
+    autoReviewScopeHash?: string;
+    /** Completeness of the freshly collected in-memory review scope. */
+    autoReviewScopeComplete?: boolean;
+    /** Distinguishes ordinary phase review from the final durable plan phase. */
+    autoReviewTrigger?: 'phase_completion' | 'plan_completion';
+    /** Fresh in-memory disposition from the review run owned by phase_complete. */
+    autoReviewBlocked?: boolean;
+    /** Machine-readable reason from the current review run, when blocked. */
+    autoReviewBlockReason?: import('../../../review/engine').ReviewEngineResult['blockReason'];
 }

package/dist/tools/phase-complete.d.ts

@@ -3,6 +3,8 @@
  * Core implementation - gathers data, enforces policy, writes event, resets state.
  */
 import type { ToolDefinition } from '@opencode-ai/plugin/tool';
+import type { ReviewModelDispatcher } from '../review/contracts.js';
+import type { ReviewAgentModelRegistry } from '../review/runtime.js';
 /**
  * Arguments for the phase_complete tool
  */
@@ -24,6 +26,14 @@ export interface PhaseCompleteArgs {
     /** Calling agent identity (from tool ctx) — gates the override to the architect. */
     callerAgent?: string;
 }
+export interface PhaseCompleteRuntime {
+    reviewModelDispatcher?: ReviewModelDispatcher;
+    generatedAgentNames?: readonly string[];
+    reviewAgentModelRegistry?: ReviewAgentModelRegistry;
+    getActiveAgentName?: (sessionID: string) => string | undefined;
+}
+declare function resolvePhaseReviewAgentNames(runtime: PhaseCompleteRuntime): Iterable<string>;
+/** @tool-opt-out Output-size constant, not a tool definition. */
 export declare const MAX_OUTPUT_BYTES = 512000;
 declare function allCompletedTasksHavePassedGateEvidence(directory: string, tasks: Array<{
     id: string;
@@ -33,7 +43,7 @@ declare function allCompletedTasksHavePassedGateEvidence(directory: string, task
  * Execute the phase_complete tool
  * Gathers data, enforces policy, writes event, resets state
  */
-export declare function executePhaseComplete(args: PhaseCompleteArgs, workingDirectory?: string, directory?: string): Promise<string>;
+export declare function executePhaseComplete(args: PhaseCompleteArgs, workingDirectory?: string, directory?: string, runtime?: PhaseCompleteRuntime): Promise<string>;
 /** @internal exported for testing only */
 export declare function _buildOutputJson(outputData: {
     phase: number;
@@ -50,8 +60,10 @@ export declare function _buildOutputJson(outputData: {
 /**
  * Tool definition for phase_complete
  */
+export declare function createPhaseCompleteTool(runtime?: PhaseCompleteRuntime): ToolDefinition;
 export declare const phase_complete: ToolDefinition;
 export declare const _test_exports: {
     allCompletedTasksHavePassedGateEvidence: typeof allCompletedTasksHavePassedGateEvidence;
+    resolvePhaseReviewAgentNames: typeof resolvePhaseReviewAgentNames;
 };
 export {};

package/dist/tools/plugin-registration.d.ts

@@ -12,6 +12,8 @@ import type { ToolDefinition } from '@opencode-ai/plugin/tool';
 import type { AgentDefinition } from '../agents/index.js';
 import type { PluginConfig } from '../config/index.js';
 import type { EvaluationModelDispatcher } from '../evaluation/model-dispatcher.js';
+import type { ReviewModelDispatcher } from '../review/contracts.js';
+import type { ReviewAgentModelRegistry } from '../review/runtime.js';
 /**
  * Construct the plugin tool object: one handler per manifest entry, with
  * `swarm_command` overridden by its dependency-injected instance.
@@ -22,4 +24,4 @@ import type { EvaluationModelDispatcher } from '../evaluation/model-dispatcher.j
  *
  * Knowledge tools are conditionally excluded when config.knowledge.enabled = false.
  */
-export declare function buildPluginToolObject(agents: Record<string, AgentDefinition>, config?: PluginConfig, evaluationModelDispatcher?: EvaluationModelDispatcher): Record<string, ToolDefinition>;
+export declare function buildPluginToolObject(agents: Record<string, AgentDefinition>, config?: PluginConfig, evaluationModelDispatcher?: EvaluationModelDispatcher, reviewModelDispatcher?: ReviewModelDispatcher, generatedAgentNames?: Iterable<string>, reviewAgentModelRegistry?: ReviewAgentModelRegistry, getActiveAgentName?: (sessionID: string) => string | undefined): Record<string, ToolDefinition>;

package/dist/tools/swarm-command.d.ts

@@ -1,5 +1,8 @@
 import type { AgentDefinition } from '../agents/index.js';
+import type { AutoReviewConfig } from '../config/schema.js';
 import type { EvaluationModelDispatcher } from '../evaluation/model-dispatcher.js';
+import type { ReviewModelDispatcher } from '../review/contracts.js';
+import type { ReviewAgentModelRegistry } from '../review/runtime.js';
 import { createSwarmTool } from './create-tool.js';
-export declare function createSwarmCommandTool(agents: Record<string, AgentDefinition>, evaluationModelDispatcher?: EvaluationModelDispatcher): ReturnType<typeof createSwarmTool>;
+export declare function createSwarmCommandTool(agents: Record<string, AgentDefinition>, evaluationModelDispatcher?: EvaluationModelDispatcher, reviewModelDispatcher?: ReviewModelDispatcher, autoReviewConfig?: AutoReviewConfig, reviewAgentModelRegistry?: ReviewAgentModelRegistry, getActiveAgentName?: (sessionID: string) => string | undefined): ReturnType<typeof createSwarmTool>;
 export declare const swarm_command: ReturnType<typeof createSwarmTool>;

package/dist/tools/tool-metadata.d.ts

@@ -34,7 +34,7 @@ export interface ToolMeta {
 export declare const TOOL_METADATA: {
     diff: {
         description: string;
-        agents: ("reviewer" | "test_engineer" | "coder" | "critic_oversight" | "architect")[];
+        agents: ("reviewer" | "test_engineer" | "coder" | "critic_oversight" | "critic_finding_validator" | "architect")[];
         prWorkflow: {
             modes: ("PR_REVIEW" | "PR_FEEDBACK")[];
             capability: "observe";
@@ -42,7 +42,7 @@ export declare const TOOL_METADATA: {
     };
     diff_summary: {
         description: string;
-        agents: ("reviewer" | "critic_oversight" | "architect")[];
+        agents: ("reviewer" | "critic_oversight" | "critic_finding_validator" | "architect")[];
         prWorkflow: {
             modes: ("PR_REVIEW" | "PR_FEEDBACK")[];
             capability: "observe";
@@ -58,7 +58,7 @@ export declare const TOOL_METADATA: {
     };
     placeholder_scan: {
         description: string;
-        agents: ("reviewer" | "architect")[];
+        agents: ("reviewer" | "critic_finding_validator" | "architect")[];
         prWorkflow: {
             modes: ("PR_REVIEW" | "PR_FEEDBACK")[];
             capability: "observe";
@@ -66,7 +66,7 @@ export declare const TOOL_METADATA: {
     };
     imports: {
         description: string;
-        agents: ("reviewer" | "test_engineer" | "coder" | "docs" | "sme" | "critic" | "critic_sounding_board" | "critic_drift_verifier" | "critic_hallucination_verifier" | "architect" | "researcher" | "docs_design")[];
+        agents: ("reviewer" | "test_engineer" | "coder" | "docs" | "sme" | "critic" | "critic_sounding_board" | "critic_drift_verifier" | "critic_hallucination_verifier" | "critic_finding_validator" | "architect" | "researcher" | "docs_design")[];
         prWorkflow: {
             modes: ("PR_REVIEW" | "PR_FEEDBACK")[];
             capability: "observe";
@@ -74,7 +74,7 @@ export declare const TOOL_METADATA: {
     };
     lint: {
         description: string;
-        agents: ("reviewer" | "coder" | "architect")[];
+        agents: ("reviewer" | "coder" | "critic_finding_validator" | "architect")[];
         prWorkflow: {
             modes: "PR_REVIEW"[];
             capability: "validate";
@@ -82,7 +82,7 @@ export declare const TOOL_METADATA: {
     };
     secretscan: {
         description: string;
-        agents: ("reviewer" | "critic_oversight" | "architect")[];
+        agents: ("reviewer" | "critic_oversight" | "critic_finding_validator" | "architect")[];
         prWorkflow: {
             modes: "PR_REVIEW"[];
             capability: "validate";
@@ -90,7 +90,7 @@ export declare const TOOL_METADATA: {
     };
     sast_scan: {
         description: string;
-        agents: ("reviewer" | "critic_oversight" | "architect")[];
+        agents: ("reviewer" | "critic_oversight" | "critic_finding_validator" | "architect")[];
         prWorkflow: {
             modes: "PR_REVIEW"[];
             capability: "validate";
@@ -102,7 +102,7 @@ export declare const TOOL_METADATA: {
     };
     pre_check_batch: {
         description: string;
-        agents: ("reviewer" | "architect")[];
+        agents: ("reviewer" | "critic_finding_validator" | "architect")[];
     };
     quality_budget: {
         description: string;
@@ -114,11 +114,11 @@ export declare const TOOL_METADATA: {
     };
     symbols: {
         description: string;
-        agents: ("reviewer" | "test_engineer" | "coder" | "docs" | "designer" | "sme" | "critic" | "critic_sounding_board" | "critic_drift_verifier" | "critic_hallucination_verifier" | "architect" | "researcher" | "docs_design" | "spec_writer")[];
+        agents: ("reviewer" | "test_engineer" | "coder" | "docs" | "designer" | "sme" | "critic" | "critic_sounding_board" | "critic_drift_verifier" | "critic_hallucination_verifier" | "critic_finding_validator" | "architect" | "researcher" | "docs_design" | "spec_writer")[];
     };
     complexity_hotspots: {
         description: string;
-        agents: ("reviewer" | "test_engineer" | "explorer" | "sme" | "critic" | "critic_sounding_board" | "critic_drift_verifier" | "critic_hallucination_verifier" | "critic_oversight" | "architect" | "researcher")[];
+        agents: ("reviewer" | "test_engineer" | "explorer" | "sme" | "critic" | "critic_sounding_board" | "critic_drift_verifier" | "critic_hallucination_verifier" | "critic_oversight" | "critic_finding_validator" | "architect" | "researcher")[];
     };
     schema_drift: {
         description: string;
@@ -186,7 +186,7 @@ export declare const TOOL_METADATA: {
     };
     pkg_audit: {
         description: string;
-        agents: ("reviewer" | "test_engineer" | "critic_hallucination_verifier" | "critic_oversight" | "architect")[];
+        agents: ("reviewer" | "test_engineer" | "critic_hallucination_verifier" | "critic_oversight" | "critic_finding_validator" | "architect")[];
         prWorkflow: {
             modes: "PR_REVIEW"[];
             capability: "validate";
@@ -214,7 +214,7 @@ export declare const TOOL_METADATA: {
     };
     test_runner: {
         description: string;
-        agents: ("reviewer" | "test_engineer" | "architect")[];
+        agents: ("reviewer" | "test_engineer" | "critic_finding_validator" | "architect")[];
         prWorkflow: {
             modes: "PR_REVIEW"[];
             capability: "validate";
@@ -222,7 +222,7 @@ export declare const TOOL_METADATA: {
     };
     test_impact: {
         description: string;
-        agents: ("reviewer" | "test_engineer" | "critic_oversight" | "architect")[];
+        agents: ("reviewer" | "test_engineer" | "critic_oversight" | "critic_finding_validator" | "architect")[];
         prWorkflow: {
             modes: ("PR_REVIEW" | "PR_FEEDBACK")[];
             capability: "observe";
@@ -242,7 +242,7 @@ export declare const TOOL_METADATA: {
     };
     git_blame: {
         description: string;
-        agents: ("reviewer" | "explorer" | "architect")[];
+        agents: ("reviewer" | "explorer" | "critic_finding_validator" | "architect")[];
         prWorkflow: {
             modes: ("PR_REVIEW" | "PR_FEEDBACK")[];
             capability: "observe";
@@ -258,7 +258,7 @@ export declare const TOOL_METADATA: {
     };
     retrieve_summary: {
         description: string;
-        agents: ("reviewer" | "test_engineer" | "coder" | "docs" | "designer" | "sme" | "critic" | "critic_sounding_board" | "critic_drift_verifier" | "critic_hallucination_verifier" | "critic_architecture_supervisor" | "architect" | "docs_design" | "spec_writer")[];
+        agents: ("reviewer" | "test_engineer" | "coder" | "docs" | "designer" | "sme" | "critic" | "critic_sounding_board" | "critic_drift_verifier" | "critic_hallucination_verifier" | "critic_architecture_supervisor" | "critic_finding_validator" | "architect" | "docs_design" | "spec_writer")[];
         prWorkflow: {
             modes: ("PR_REVIEW" | "PR_FEEDBACK")[];
             capability: "observe";
@@ -338,7 +338,7 @@ export declare const TOOL_METADATA: {
     };
     knowledge_recall: {
         description: string;
-        agents: ("reviewer" | "test_engineer" | "coder" | "docs" | "designer" | "explorer" | "sme" | "critic" | "critic_sounding_board" | "critic_drift_verifier" | "critic_hallucination_verifier" | "critic_architecture_supervisor" | "critic_oversight" | "architect" | "docs_design" | "curator_init" | "curator_phase" | "skill_improver" | "spec_writer")[];
+        agents: ("reviewer" | "test_engineer" | "coder" | "docs" | "designer" | "explorer" | "sme" | "critic" | "critic_sounding_board" | "critic_drift_verifier" | "critic_hallucination_verifier" | "critic_architecture_supervisor" | "critic_oversight" | "critic_finding_validator" | "architect" | "docs_design" | "curator_init" | "curator_phase" | "skill_improver" | "spec_writer")[];
     };
     knowledge_remove: {
         description: string;
@@ -354,7 +354,7 @@ export declare const TOOL_METADATA: {
     };
     search: {
         description: string;
-        agents: ("reviewer" | "test_engineer" | "coder" | "docs" | "designer" | "explorer" | "sme" | "critic_hallucination_verifier" | "critic_oversight" | "architect" | "researcher" | "docs_design" | "skill_improver" | "spec_writer")[];
+        agents: ("reviewer" | "test_engineer" | "coder" | "docs" | "designer" | "explorer" | "sme" | "critic_hallucination_verifier" | "critic_oversight" | "critic_finding_validator" | "architect" | "researcher" | "docs_design" | "skill_improver" | "spec_writer")[];
     };
     ast_grep: {
         description: string;
@@ -394,11 +394,11 @@ export declare const TOOL_METADATA: {
     };
     batch_symbols: {
         description: string;
-        agents: ("reviewer" | "explorer" | "critic_hallucination_verifier" | "critic_oversight" | "architect")[];
+        agents: ("reviewer" | "explorer" | "critic_hallucination_verifier" | "critic_oversight" | "critic_finding_validator" | "architect")[];
     };
     suggest_patch: {
         description: string;
-        agents: ("reviewer" | "architect")[];
+        agents: ("reviewer" | "critic_finding_validator" | "architect")[];
     };
     req_coverage: {
         description: string;
@@ -410,7 +410,7 @@ export declare const TOOL_METADATA: {
     };
     repo_map: {
         description: string;
-        agents: ("reviewer" | "coder" | "explorer" | "critic" | "critic_sounding_board" | "critic_drift_verifier" | "critic_hallucination_verifier" | "critic_architecture_supervisor" | "critic_oversight" | "architect")[];
+        agents: ("reviewer" | "coder" | "explorer" | "critic" | "critic_sounding_board" | "critic_drift_verifier" | "critic_hallucination_verifier" | "critic_architecture_supervisor" | "critic_oversight" | "critic_finding_validator" | "architect")[];
         prWorkflow: {
             modes: ("PR_REVIEW" | "PR_FEEDBACK")[];
             capability: "observe";
@@ -478,7 +478,7 @@ export declare const TOOL_METADATA: {
     };
     knowledge_receipt: {
         description: string;
-        agents: ("reviewer" | "test_engineer" | "coder" | "docs" | "designer" | "sme" | "critic" | "critic_sounding_board" | "critic_drift_verifier" | "critic_hallucination_verifier" | "critic_architecture_supervisor" | "architect" | "docs_design" | "curator_init" | "curator_phase" | "skill_improver" | "spec_writer")[];
+        agents: ("reviewer" | "test_engineer" | "coder" | "docs" | "designer" | "sme" | "critic" | "critic_sounding_board" | "critic_drift_verifier" | "critic_hallucination_verifier" | "critic_architecture_supervisor" | "critic_finding_validator" | "architect" | "docs_design" | "curator_init" | "curator_phase" | "skill_improver" | "spec_writer")[];
     };
     knowledge_archive: {
         description: string;
@@ -494,7 +494,7 @@ export declare const TOOL_METADATA: {
     };
     swarm_command: {
         description: string;
-        agents: ("reviewer" | "test_engineer" | "coder" | "docs" | "designer" | "explorer" | "sme" | "critic" | "architect" | "researcher" | "docs_design")[];
+        agents: ("reviewer" | "test_engineer" | "coder" | "docs" | "designer" | "explorer" | "sme" | "critic" | "critic_finding_validator" | "architect" | "researcher" | "docs_design")[];
     };
     dispatch_lanes: {
         description: string;