opencode-swarm 7.132.2 → 7.133.0

package/dist/state.d.ts

@@ -64,6 +64,54 @@ 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';
+/** 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.
@@ -172,6 +220,16 @@ export interface AgentSessionState {
     scopeViolationDetected?: boolean;
     /** Files modified by the current coder task (populated by guardrails toolBefore/toolAfter, reset on new coder delegation) */
     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 +507,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

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

@@ -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/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;

package/dist/turbo/lean/integration.d.ts

@@ -1,3 +1,5 @@
+import type { ReviewModelDispatcher } from '../../review/contracts';
+import { type ReviewAgentModelRegistry } from '../../review/runtime';
 import { type ModelOverride } from '../../utils/model-dispatch-fallback';
 import { type LaneEvidence, listLaneEvidence, readPhaseEvidence, type ValidationArtifact } from './evidence';
 /**
@@ -15,6 +17,20 @@ export interface LeanTurboPhaseCriticConfig {
      * Default: no timeout (critic is awaited indefinitely).
      */
     timeoutMs?: number;
+    /**
+     * Instance-local dispatcher bound to the active plugin client.
+     * New runtime call paths inject this instead of reading global client state.
+     */
+    dispatcher?: ReviewModelDispatcher;
+    /**
+     * Immutable agent-name registry captured by the plugin instance.
+     * Direct callers may omit this only when a single/default critic suffices.
+     */
+    generatedAgentNames?: readonly string[];
+    /** Exact active agent identity used to select this session's swarm. */
+    activeAgentName?: string;
+    /** Immutable plugin-instance model configuration for fallback ownership. */
+    agentModelRegistry?: ReviewAgentModelRegistry;
 }
 /**
  * Result of a phase critic dispatch.
@@ -43,7 +59,7 @@ interface ReviewerEvidence {
  * for the default swarm. Follows the same suffix-based resolution used by
  * `getCanonicalAgentRole` so that arbitrary swarm prefixes are handled correctly.
  */
-declare function resolveDefaultCriticAgent(generatedAgentNames: string[]): string;
+declare function resolveDefaultCriticAgent(generatedAgentNames: readonly string[], activeAgentName?: string): string;
 /**
  * Reads the reviewer evidence from .swarm/evidence/{phase}/lean-turbo-reviewer.json.
  *
@@ -114,7 +130,7 @@ export declare const _internals: {
     compileCriticPackage: typeof compileCriticPackage;
     parseCriticVerdict: typeof parseCriticVerdict;
     writeCriticEvidence: typeof writeCriticEvidence;
-    dispatchCriticAgent: (directory: string, pkg: CriticPackage, agentName: string, timeoutMs: number, parentSessionId?: string, model?: ModelOverride) => Promise<string>;
+    dispatchCriticAgent: (directory: string, pkg: CriticPackage, agentName: string, timeoutMs: number, parentSessionId?: string, model?: ModelOverride, dispatcher?: ReviewModelDispatcher) => Promise<string>;
     resolveDefaultCriticAgent: typeof resolveDefaultCriticAgent;
     readReviewerEvidence: typeof readReviewerEvidence;
     listLaneEvidence: typeof listLaneEvidence;