@wrongstack/core 0.281.1 → 0.282.0

package/dist/{agent-subagent-runner-DyOSK2Wy.d.ts → agent-subagent-runner-Dksf0QVU.d.ts}

@@ -1,12 +1,12 @@
-import { T as ToolCallPipelinePayload, a as ToolWrapper, E as ExtensionRegistry, S as SystemPromptContributor, b as ToolRegistry, P as ProviderRegistry, A as AgentPipelines, c as ToolExecutorLike, d as AgentInit, e as AgentInput, R as RunResult } from './index-C1E-_71T.js';
-import { C as Container, R as ReadonlyPipeline, a as Renderer } from './pipeline-E7_jqGyV.js';
-import { E as EventBus, a as EventName, L as Listener } from './events-C5hLU0AT.js';
+import { T as ToolCallPipelinePayload, a as ToolWrapper, E as ExtensionRegistry, S as SystemPromptContributor, b as ToolRegistry, P as ProviderRegistry, A as AgentPipelines, c as ToolExecutorLike, d as AgentInit, e as AgentInput, R as RunResult } from './index-D5HB7WkV.js';
+import { C as Container, R as ReadonlyPipeline, a as Renderer } from './pipeline-DM-CPTUs.js';
+import { E as EventBus, a as EventName, L as Listener } from './events-CovDylaH.js';
 import { R as RetryPolicy, E as ErrorHandler } from './retry-policy-V67lBOJz.js';
 import { L as Logger } from './logger-B63L5bTg.js';
 import { T as Tracer } from './observability-D-HZN_mF.js';
 import { P as PermissionPolicy } from './permission-B6YAtNFz.js';
 import { d as Context, J as JSONSchema, c as Request, e as Response, i as ContentBlock, s as TextBlock, g as Tool, P as Provider, t as RunOptions, U as Usage } from './tool-LVSLiE1s.js';
-import { W as WireFamily, H as HookEvent, f as HookMatcher, I as InProcessHook, C as Config, M as ModelsRegistry, h as ModelRuntimeConfig } from './config-CN-vdDEI.js';
+import { W as WireFamily, H as HookEvent, f as HookMatcher, I as InProcessHook, C as Config, M as ModelsRegistry, h as ModelRuntimeConfig } from './config-BCAEJicb.js';
 import { b as Mailbox } from './mailbox-types-BGZWrYTJ.js';
 
 type BridgeMessageType = 'task' | 'result' | 'progress' | 'error' | 'heartbeat' | 'stop' | 'delegate' | 'budget_threshold';
@@ -844,6 +844,17 @@ interface SubagentConfig {
      * worktree's `.git` gitlink from `cwd` while staying bounded to the repo.
      */
     cwd?: string | undefined;
+    /**
+     * Git-worktree isolation override for this subagent.
+     *
+     * - `undefined` / `'auto'`: follow the fleet policy. Mutating/build-capable
+     *   agents get isolated worktrees; read-only review agents can stay on the
+     *   shared checkout.
+     * - `true` / `'required'`: require an isolated worktree. If allocation fails,
+     *   the task fails instead of falling back to the shared cwd.
+     * - `false` / `'off'`: never allocate a worktree for this subagent.
+     */
+    worktree?: boolean | 'auto' | 'required' | 'off' | undefined;
     /**
      * Provider registry id (e.g. `'anthropic'`, `'openai'`, `'google'`).
      * Allows a director to mix providers across siblings — one subagent on

package/dist/{config-CN-vdDEI.d.ts → config-BCAEJicb.d.ts}

@@ -99,6 +99,13 @@ interface HookOutcome {
      * (SessionStart).
      */
     additionalContext?: string | undefined;
+    /**
+     * Where the additionalContext should appear. `inline` (default) appends it
+     * to the tool_result / user message content so it renders as part of that
+     * block. `separate` appends it as a new user message, keeping plugin notices
+     * visually separated from the actual tool output.
+     */
+    contextAs?: 'inline' | 'separate' | undefined;
 }
 /** An in-process hook function (registered via the plugin API). */
 type InProcessHook = (input: HookInput) => HookOutcome | void | Promise<HookOutcome | void>;
@@ -1004,6 +1011,31 @@ interface FleetConfig {
         /** Global cap on broadcasts per minute (excess dropped + counted). Default 20. */
         globalPerMinuteCap?: number | undefined;
     } | undefined;
+    /**
+     * Per-subagent git-worktree isolation for Director fleets. The default is
+     * `auto`: mutating/build-capable subagents run in isolated checkouts and are
+     * squash-merged back on success; read-only review agents usually stay on the
+     * shared checkout. Set `enabled:false` or `mode:'off'` when a workflow cannot
+     * use worktrees.
+     */
+    worktrees?: {
+        /** Kill switch. Default true. */
+        enabled?: boolean | undefined;
+        /**
+         * `auto` (default): isolate only side-effectful subagents.
+         * `required`: side-effectful subagents must get a worktree or fail.
+         * `off`: never allocate worktrees.
+         */
+        mode?: 'auto' | 'required' | 'off' | undefined;
+        /**
+         * Merge successful task branches back into the base checkout. Default
+         * true. When false, successful worktrees are committed and kept for
+         * manual `/worktree merge`.
+         */
+        autoMerge?: boolean | undefined;
+        /** Keep failed/timeout worktrees when they contain changes. Default true. */
+        keepFailed?: boolean | undefined;
+    } | undefined;
     /** Brain-gated fleet supervisor (rebalance/steer/spawn-helper). */
     supervisor?: FleetSupervisorConfig | undefined;
 }
@@ -1245,4 +1277,4 @@ interface ConfigStore {
     watch(cb: (next: Readonly<Config>, prev: Readonly<Config>) => void): () => void;
 }
 
-export { type ProviderApiKey as $, type AdaptiveConcurrencyConfig as A, type ExecToolConfig as B, type Config as C, DEFAULT_CONTEXT_WINDOW_MODE_ID as D, type ExecDangerConfig as E, type FeaturesConfig as F, type FleetConfig as G, type HookEvent as H, type InProcessHook as I, type FleetSupervisorConfig as J, type HqClientConfig as K, type IndexingConfig as L, type ModelsRegistry as M, type InputHistoryConfig as N, type LaunchConfig as O, type ProviderConfig as P, type LogConfig as Q, type ResolvedModel as R, type ShellHook as S, type ToolResultRenderMode as T, MAX_TUI_THINKING_WORD_LENGTH as U, type ModelRuntimeCacheConfig as V, type WireFamily as W, type ModelRuntimeParametersConfig as X, type ModelRuntimeReasoningConfig as Y, type ModelsDevProvider as Z, type PluginConfig as _, type ModelMatrixEntry as a, type SessionLoggingConfig as a0, type SkillsConfig as a1, type SyncCategory as a2, type ToolDescriptionMode as a3, type ToolDescriptionModeConfig as a4, type ToolResultRenderModeConfig as a5, type ToolsConfig as a6, formatContextWindowModeList as a7, getContextWindowMode as a8, isContextWindowModeId as a9, listContextWindowModes as aa, normalizeTokenSavingTier as ab, normalizeTuiThinkingWord as ac, resolveContextWindowPolicy as ad, type MCPServerConfig as b, type ModelsDevPayload as c, type ResolvedProvider as d, type ModelsDevModel as e, type HookMatcher as f, type HookEntry as g, type ModelRuntimeConfig as h, type ConfigLoader as i, type SyncConfig as j, type ConfigStore as k, type ContextWindowAggressiveOn as l, type ContextWindowPolicy as m, type HookInput as n, type HookOutcome as o, type TokenSavingTier as p, type AutonomyConfig as q, CONTEXT_WINDOW_MODES as r, type CircuitBreakerRuntimeConfig as s, type ContextConfig as t, type ContextWindowConfigLike as u, type ContextWindowMode as v, type ContextWindowModeId as w, type ContextWindowThresholds as x, type CustomModelDefinition as y, DEFAULT_TUI_THINKING_WORD as z };
+export { type ProviderApiKey as $, type AdaptiveConcurrencyConfig as A, type ExecToolConfig as B, type Config as C, DEFAULT_CONTEXT_WINDOW_MODE_ID as D, type ExecDangerConfig as E, type FleetConfig as F, type FeaturesConfig as G, type HookEvent as H, type InProcessHook as I, type FleetSupervisorConfig as J, type HqClientConfig as K, type IndexingConfig as L, type ModelsRegistry as M, type InputHistoryConfig as N, type LaunchConfig as O, type ProviderConfig as P, type LogConfig as Q, type ResolvedModel as R, type ShellHook as S, type ToolResultRenderMode as T, MAX_TUI_THINKING_WORD_LENGTH as U, type ModelRuntimeCacheConfig as V, type WireFamily as W, type ModelRuntimeParametersConfig as X, type ModelRuntimeReasoningConfig as Y, type ModelsDevProvider as Z, type PluginConfig as _, type ModelMatrixEntry as a, type SessionLoggingConfig as a0, type SkillsConfig as a1, type SyncCategory as a2, type ToolDescriptionMode as a3, type ToolDescriptionModeConfig as a4, type ToolResultRenderModeConfig as a5, type ToolsConfig as a6, formatContextWindowModeList as a7, getContextWindowMode as a8, isContextWindowModeId as a9, listContextWindowModes as aa, normalizeTokenSavingTier as ab, normalizeTuiThinkingWord as ac, resolveContextWindowPolicy as ad, type MCPServerConfig as b, type ModelsDevPayload as c, type ResolvedProvider as d, type ModelsDevModel as e, type HookMatcher as f, type HookEntry as g, type ModelRuntimeConfig as h, type ConfigLoader as i, type SyncConfig as j, type ConfigStore as k, type ContextWindowAggressiveOn as l, type ContextWindowPolicy as m, type TokenSavingTier as n, type HookInput as o, type HookOutcome as p, type AutonomyConfig as q, CONTEXT_WINDOW_MODES as r, type CircuitBreakerRuntimeConfig as s, type ContextConfig as t, type ContextWindowConfigLike as u, type ContextWindowMode as v, type ContextWindowModeId as w, type ContextWindowThresholds as x, type CustomModelDefinition as y, DEFAULT_TUI_THINKING_WORD as z };

package/dist/coordination/index.d.ts

@@ -1,23 +1,24 @@
-import { H as FleetManager, s as Director } from '../null-fleet-bus-ZBkKGR9j.js';
-export { A as ACP_AGENTS, a as AGENTS_BY_PHASE, b as AGENT_CATALOG, c as ALL_AGENT_DEFINITIONS, d as ALL_FLEET_AGENTS, e as AUDIT_LOG_AGENT, f as AutoExtendCeiling, g as AutoExtendPolicy, B as BUG_HUNTER_AGENT, h as BugFinding, C as CollabBudgetConfig, i as CollabBudgetOverrides, j as CollabBudgetWarningPayload, k as CollabDebugReport, l as CollabSession, m as CollabSessionOptions, n as CreateDelegateToolOptions, o as CriticConcern, p as CriticEvaluation, D as DEFAULT_DIRECTOR_PREAMBLE, q as DEFAULT_SUBAGENT_BASELINE, r as DelegateHost, t as DirectorAlert, u as DirectorAlertLevel, v as DirectorCancelCollabPayload, w as DirectorPromptParts, x as DirectorSessionFactory, y as DirectorSessionFactoryOptions, F as FLEET_ROSTER, z as FLEET_ROSTER_BUDGETS, E as FLEET_ROSTER_WITHACP, G as FleetCostCapError, I as FleetManagerOptions, J as FleetRosterBudget, K as FleetSpawnBudgetError, L as ICoordinator, M as IFleetManager, N as InMemoryAgentBridge, O as InMemoryBridgeTransport, P as LargeAnswerStore, Q as NULL_FLEET_BUS, R as REFACTOR_PLANNER_AGENT, S as RefactorPhase, T as RefactorPlan, U as SECURITY_SCANNER_AGENT, V as SharedFileEntry, W as SharedFileSnapshot, X as SubagentPromptParts, Y as TaskResultNotification, Z as applyRosterBudget, _ as attachAutoExtend, $ as composeDirectorPrompt, a0 as composeSubagentPrompt, a1 as createDelegateTool, a2 as createMessage, a3 as getAgentDefinition, a4 as makeAskResultTool, a5 as makeAskTool, a6 as makeAssignTool, a7 as makeAwaitTasksTool, a8 as makeCollabDebugTool, a9 as makeDirectorSessionFactory, aa as makeFleetEmitTool, ab as makeFleetHealthTool, ab as makeFleetSessionTool, ab as makeFleetTool, ab as makeFleetUsageTool, ac as makeRollUpTool, ad as makeSpawnTool, ae as makeTerminateAllTool, af as makeTerminateTool, ag as makeWorkCompleteTool, ah as rosterSummaryFromConfigs } from '../null-fleet-bus-ZBkKGR9j.js';
-import { F as FleetBus, T as TaskSpec } from '../agent-subagent-runner-DyOSK2Wy.js';
-export { a as AgentFactory, y as AgentFactoryResult, z as AgentRunnerOptions, E as BudgetExceededError, G as BudgetKind, H as BudgetLimits, I as BudgetNegotiationMode, J as BudgetThresholdDecision, K as BudgetThresholdHandler, L as BudgetThresholdSignal, N as BudgetUsage, Q as DECISION_TIMEOUT_MS, R as FleetEvent, U as FleetHandler, k as FleetUsage, l as FleetUsageAggregator, X as SubagentBudget, a1 as SubagentUsageSnapshot, a2 as TIMEOUT_PREEMPT_FRACTION, a4 as makeAgentSubagentRunner, a5 as withDisabledToolFiltering } from '../agent-subagent-runner-DyOSK2Wy.js';
-import { E as EventBus, B as BrainArbiter, f as BrainDecisionOption, k as BrainRisk, h as BrainDecisionRequest, e as BrainDecision, i as BrainDecisionSource } from '../events-C5hLU0AT.js';
-export { g as BrainDecisionQueue, j as BrainFallback, D as DefaultBrainArbiter, l as DefaultBrainArbiterOptions, H as HumanEscalatingBrainArbiter, O as ObservableBrainArbiter, w as formatHumanPrompt } from '../events-C5hLU0AT.js';
+import { H as FleetManager, s as Director } from '../null-fleet-bus-DuvA8PIR.js';
+export { A as ACP_AGENTS, a as AGENTS_BY_PHASE, b as AGENT_CATALOG, c as ALL_AGENT_DEFINITIONS, d as ALL_FLEET_AGENTS, e as AUDIT_LOG_AGENT, f as AutoExtendCeiling, g as AutoExtendPolicy, B as BUG_HUNTER_AGENT, h as BugFinding, C as CollabBudgetConfig, i as CollabBudgetOverrides, j as CollabBudgetWarningPayload, k as CollabDebugReport, l as CollabSession, m as CollabSessionOptions, n as CreateDelegateToolOptions, o as CriticConcern, p as CriticEvaluation, D as DEFAULT_DIRECTOR_PREAMBLE, q as DEFAULT_SUBAGENT_BASELINE, r as DelegateHost, t as DirectorAlert, u as DirectorAlertLevel, v as DirectorCancelCollabPayload, w as DirectorPromptParts, x as DirectorSessionFactory, y as DirectorSessionFactoryOptions, F as FLEET_ROSTER, z as FLEET_ROSTER_BUDGETS, E as FLEET_ROSTER_WITHACP, G as FleetCostCapError, I as FleetManagerOptions, J as FleetRosterBudget, K as FleetSpawnBudgetError, L as FleetWorktreePolicy, M as ICoordinator, N as IFleetManager, O as InMemoryAgentBridge, P as InMemoryBridgeTransport, Q as LargeAnswerStore, R as NULL_FLEET_BUS, S as REFACTOR_PLANNER_AGENT, T as RefactorPhase, U as RefactorPlan, V as SECURITY_SCANNER_AGENT, W as SharedFileEntry, X as SharedFileSnapshot, Y as SubagentPromptParts, Z as TaskResultNotification, _ as WorktreeIntegrationError, $ as WorktreeIsolationDecision, a0 as WorktreeTaskRunnerOptions, a1 as WorktreeTaskStateUpdate, a2 as applyRosterBudget, a3 as attachAutoExtend, a4 as composeDirectorPrompt, a5 as composeSubagentPrompt, a6 as createDelegateTool, a7 as createMessage, a8 as getAgentDefinition, a9 as makeAskResultTool, aa as makeAskTool, ab as makeAssignTool, ac as makeAwaitTasksTool, ad as makeCollabDebugTool, ae as makeDirectorSessionFactory, af as makeFleetEmitTool, ag as makeFleetHealthTool, ag as makeFleetSessionTool, ag as makeFleetTool, ag as makeFleetUsageTool, ah as makeQualityGateTool, ai as makeRollUpTool, aj as makeSpawnTool, ak as makeTerminateAllTool, al as makeTerminateTool, am as makeWorkCompleteTool, an as resolveSubagentWorktreeDecision, ao as rosterSummaryFromConfigs, ap as subagentNeedsWorktree, aq as wrapSubagentRunnerWithWorktrees } from '../null-fleet-bus-DuvA8PIR.js';
+import { F as FleetBus, T as TaskSpec } from '../agent-subagent-runner-Dksf0QVU.js';
+export { a as AgentFactory, y as AgentFactoryResult, z as AgentRunnerOptions, E as BudgetExceededError, G as BudgetKind, H as BudgetLimits, I as BudgetNegotiationMode, J as BudgetThresholdDecision, K as BudgetThresholdHandler, L as BudgetThresholdSignal, N as BudgetUsage, Q as DECISION_TIMEOUT_MS, R as FleetEvent, U as FleetHandler, k as FleetUsage, l as FleetUsageAggregator, X as SubagentBudget, a1 as SubagentUsageSnapshot, a2 as TIMEOUT_PREEMPT_FRACTION, a4 as makeAgentSubagentRunner, a5 as withDisabledToolFiltering } from '../agent-subagent-runner-Dksf0QVU.js';
+import { E as EventBus, B as BrainArbiter, f as BrainDecisionOption, k as BrainRisk, h as BrainDecisionRequest, e as BrainDecision, i as BrainDecisionSource } from '../events-CovDylaH.js';
+export { g as BrainDecisionQueue, j as BrainFallback, D as DefaultBrainArbiter, l as DefaultBrainArbiterOptions, H as HumanEscalatingBrainArbiter, O as ObservableBrainArbiter, w as formatHumanPrompt } from '../events-CovDylaH.js';
 import { b as Mailbox, c as MailboxSendInput, M as MailboxMessage, d as MailboxQuery, e as MailboxAckInput, f as MailboxAckBatchInput, a as MailboxAgentStatus, A as AgentRegistrationInput, g as AgentHeartbeatInput, P as PurgeOptions, j as PurgeResult, C as ClientRegistrationInput, h as ClientHeartbeatInput, i as ClientStatus } from '../mailbox-types-BGZWrYTJ.js';
 export { k as ClientSource, l as MailboxMessageType, m as MailboxTaskContext, R as ReadReceipts, n as RegisteredAgent, o as normalizeRecipient } from '../mailbox-types-BGZWrYTJ.js';
-import { b as AgentDefinition } from '../multi-agent-coordinator-IpHCuHUa.js';
-export { T as AGENT_TOOL_PRESETS, c as AgentBudgetTier, d as AgentCapability, A as AgentPhase, e as DEFAULT_DISPATCH_ROLE, a as DefaultMultiAgentCoordinator, f as DispatchCandidate, D as DispatchClassifier, g as DispatchMethod, h as DispatchOptions, i as DispatchResult, H as HEAVY_BUDGET, L as LIGHT_BUDGET, M as MEDIUM_BUDGET, j as MultiAgentCoordinatorOptions, k as dispatchAgent, m as makeLLMClassifier, s as scoreAgents } from '../multi-agent-coordinator-IpHCuHUa.js';
-import { G as GlobalMailbox } from '../global-mailbox-CHM1QkCi.js';
-export { aA as resolveProjectDir } from '../global-mailbox-CHM1QkCi.js';
-import { d as Context, g as Tool } from '../tool-LVSLiE1s.js';
+import { b as AgentDefinition } from '../multi-agent-coordinator-4DC31QWu.js';
+export { T as AGENT_TOOL_PRESETS, c as AgentBudgetTier, d as AgentCapability, A as AgentPhase, e as DEFAULT_DISPATCH_ROLE, a as DefaultMultiAgentCoordinator, f as DispatchCandidate, D as DispatchClassifier, g as DispatchMethod, h as DispatchOptions, i as DispatchResult, H as HEAVY_BUDGET, L as LIGHT_BUDGET, M as MEDIUM_BUDGET, j as MultiAgentCoordinatorOptions, k as dispatchAgent, m as makeLLMClassifier, s as scoreAgents } from '../multi-agent-coordinator-4DC31QWu.js';
 import { A as AgentEntry } from '../session-registry-Dvg7i_IA.js';
-import { J as FleetSupervisorConfig, A as AdaptiveConcurrencyConfig } from '../config-CN-vdDEI.js';
+import { d as Context, g as Tool } from '../tool-LVSLiE1s.js';
+import { J as FleetSupervisorConfig, a as ModelMatrixEntry, C as Config, A as AdaptiveConcurrencyConfig } from '../config-BCAEJicb.js';
+import { G as GlobalMailbox } from '../global-mailbox-CNfgvRw3.js';
+export { aA as resolveProjectDir } from '../global-mailbox-CNfgvRw3.js';
 import { L as Logger } from '../logger-B63L5bTg.js';
 import 'node:events';
-import '../director-state-BfeCUbmk.js';
-import '../index-C1E-_71T.js';
-import '../pipeline-E7_jqGyV.js';
+import '../director-state-B_GPa78Q.js';
+import '../worktree-manager-BBXdJq-Y.js';
+import '../index-D5HB7WkV.js';
+import '../pipeline-DM-CPTUs.js';
 import '../permission-B6YAtNFz.js';
 import '../observability-D-HZN_mF.js';
 import '../secret-scrubber-3MHDDAtm.js';
@@ -314,38 +315,6 @@ declare function resolveMailboxIdentity(ctx: Context, fallbackBase?: string): {
 };
 declare function makeMailboxTool(opts?: MailboxToolOptions): Tool;
 
-/**
- * mail-tools — thin, high-affordance wrappers over the project mailbox.
- *
- * These are the PREFERRED mailbox tools for agents. The multi-action `mailbox`
- * tool is the low-level power surface for advanced queries and agent status;
- * `mail_send` and `mail_inbox` exist because explicit verbs ("send a mail",
- * "read my inbox") are what makes agents USE the mailbox autonomously — a model
- * reaches for `mail_send` mid-task far more readily than for
- * `mailbox action=send ...`.
- *
- *   mail_send  — message one agent (`to: "leader@a1b2c3d4"`), every leader
- *                (`to: "leader"`), or everyone (`to: "*"`)
- *   mail_inbox — read unread mail (unique id + base alias + broadcasts),
- *                marking it read so it isn't re-injected next iteration
- *
- * Both share the identity convention with the agent-loop checker
- * (`<base>@<sessionTag>`, see mailbox-attach) via `resolveMailboxIdentity`.
- *
- * @module mail-tools
- */
-
-interface MailToolsOptions {
-    /** How to obtain a Mailbox given the execution Context (tests). */
-    resolveMailbox?: MailboxResolver | undefined;
-    /** Project dir for the shared mailbox. Prefer wpaths.projectDir. */
-    projectDir?: string | undefined;
-    /** EventBus for mailbox.agent_registered / heartbeat surface events. */
-    events?: EventBus | undefined;
-}
-declare function makeMailSendTool(opts?: MailToolsOptions): Tool;
-declare function makeMailInboxTool(opts?: MailToolsOptions): Tool;
-
 /**
  * fleet-status-tool — read-only live peer snapshot for any agent.
  *
@@ -529,6 +498,38 @@ declare class FleetSupervisor {
     private engageIdleWithWork;
 }
 
+/**
+ * mail-tools — thin, high-affordance wrappers over the project mailbox.
+ *
+ * These are the PREFERRED mailbox tools for agents. The multi-action `mailbox`
+ * tool is the low-level power surface for advanced queries and agent status;
+ * `mail_send` and `mail_inbox` exist because explicit verbs ("send a mail",
+ * "read my inbox") are what makes agents USE the mailbox autonomously — a model
+ * reaches for `mail_send` mid-task far more readily than for
+ * `mailbox action=send ...`.
+ *
+ *   mail_send  — message one agent (`to: "leader@a1b2c3d4"`), every leader
+ *                (`to: "leader"`), or everyone (`to: "*"`)
+ *   mail_inbox — read unread mail (unique id + base alias + broadcasts),
+ *                marking it read so it isn't re-injected next iteration
+ *
+ * Both share the identity convention with the agent-loop checker
+ * (`<base>@<sessionTag>`, see mailbox-attach) via `resolveMailboxIdentity`.
+ *
+ * @module mail-tools
+ */
+
+interface MailToolsOptions {
+    /** How to obtain a Mailbox given the execution Context (tests). */
+    resolveMailbox?: MailboxResolver | undefined;
+    /** Project dir for the shared mailbox. Prefer wpaths.projectDir. */
+    projectDir?: string | undefined;
+    /** EventBus for mailbox.agent_registered / heartbeat surface events. */
+    events?: EventBus | undefined;
+}
+declare function makeMailSendTool(opts?: MailToolsOptions): Tool;
+declare function makeMailInboxTool(opts?: MailToolsOptions): Tool;
+
 /**
  * DefaultMailbox — append-only JSONL inter-agent mailbox (per-session).
  *
@@ -851,6 +852,104 @@ declare function createMailboxHooks(opts: MailboxHooksOptions): {
     reset(): void;
 };
 
+/**
+ * Per-task model matrix resolution.
+ *
+ * The matrix (Config.modelMatrix) maps a catalog **role**, a **phase** name, or
+ * the `*` default to a {@link ModelMatrixEntry} (model + optional provider).
+ * At subagent spawn time we resolve the most specific match so different task
+ * types can run on different models — e.g. `security-scanner` on one model,
+ * `documentation` on another — while the leader keeps its own model.
+ *
+ * Resolution precedence (most → least specific):
+ *   1. exact role          (matrix["security-scanner"])
+ *   2. the role's phase     (matrix["review"])
+ *   3. the `*` default      (matrix["*"])
+ *   4. undefined            (caller falls back to the leader model)
+ *
+ * Set via the `/setmodel` slash command; this module is the single source of
+ * truth both that command and the spawn path use to validate + resolve keys.
+ */
+
+/** All valid phase keys, in catalog order. */
+declare const MATRIX_PHASE_KEYS: readonly string[];
+/** The phase a catalog role belongs to, or undefined for unknown roles. */
+declare function phaseForRole(role: string | undefined): string | undefined;
+type ModelMatrixResolutionSource = 'role' | 'phase' | 'default';
+interface ModelMatrixResolution {
+    entry: ModelMatrixEntry;
+    source: ModelMatrixResolutionSource;
+    key: string;
+}
+/**
+ * Resolve the matrix entry plus the key tier it came from. Use this when the
+ * caller needs to distinguish an explicit role/phase pin from the global `*`
+ * default.
+ */
+declare function resolveModelMatrixResolution(matrix: Record<string, ModelMatrixEntry> | undefined, role: string | undefined): ModelMatrixResolution | undefined;
+/**
+ * Resolve the matrix entry for a subagent role. Returns the most specific
+ * match (role → phase → `*`), or undefined when nothing matches.
+ */
+declare function resolveModelMatrix(matrix: Record<string, ModelMatrixEntry> | undefined, role: string | undefined): ModelMatrixEntry | undefined;
+interface ResolvedModelTarget {
+    provider?: string | undefined;
+    model?: string | undefined;
+    modelRuntime?: Config['modelRuntime'] | undefined;
+    fallbackModels?: string[] | undefined;
+    fallbackProfile?: string | undefined;
+}
+interface ResolvedSubagentModelTarget extends ResolvedModelTarget {
+    /** Where the concrete provider/model came from. */
+    source: 'matrix' | 'diversity' | 'none';
+    /** Matrix tier used before any reviewer diversity adjustment. */
+    matrixSource?: ModelMatrixResolutionSource | undefined;
+    /** True when a reviewer model was shifted away from the implementation model. */
+    diversified?: boolean | undefined;
+}
+/**
+ * Expand a matrix entry into a concrete primary model plus optional fallback
+ * chain. A profile-only matrix entry treats the first profile model as primary
+ * and the remaining profile entries as that subagent's fallback chain.
+ */
+declare function resolveModelTargetFromEntry(config: Config, entry: ModelMatrixEntry | undefined): ResolvedModelTarget | undefined;
+interface ModelReference {
+    provider?: string | undefined;
+    model?: string | undefined;
+}
+/**
+ * Roles whose output is meant to challenge an implementer. When these roles
+ * would otherwise use the same provider/model as the implementation path,
+ * WrongStack tries to pick a different available model to reduce correlated
+ * model-family mistakes. Exact role/phase `/setmodel` entries still win.
+ */
+declare function roleNeedsIndependentReviewModel(role: string | undefined): boolean;
+/**
+ * Resolve a subagent's matrix target with the reviewer diversity rule applied.
+ *
+ * Precedence:
+ *   1. Exact role or phase matrix entry.
+ *   2. Global `*` matrix entry when it is already different from the
+ *      implementation model.
+ *   3. A different configured provider/model for review roles.
+ *   4. The matrix/leader fallback.
+ */
+declare function resolveSubagentModelTarget(config: Config, role: string | undefined, opts?: {
+    implementationTarget?: ModelReference | undefined;
+}): ResolvedSubagentModelTarget | undefined;
+/**
+ * Resolve the default implementation lane. The generic Executor is the closest
+ * stable proxy for "the implementer" when a reviewer is spawned without a
+ * concrete sibling id.
+ */
+declare function resolveImplementationModelTarget(config: Config): ModelReference;
+declare function sameModelReference(a: ModelReference | undefined, b: ModelReference | undefined): boolean;
+type MatrixKeyKind = 'role' | 'phase' | 'default' | 'unknown';
+/** Classify a matrix key so `/setmodel` can reject typos before persisting. */
+declare function matrixKeyKind(key: string): MatrixKeyKind;
+/** True when `key` is a usable matrix key (role, phase, or `*`). */
+declare function isValidMatrixKey(key: string): boolean;
+
 /**
  * package-author-tracker — Tracks which agent added which package to which manifest.
  *
@@ -2462,4 +2561,4 @@ declare class AutonomousCoordinator {
     private _emit;
 }
 
-export { type AcquireOptions, type AcquireResult, AdaptiveConcurrencyController, type AdaptiveConcurrencyState, AgentDefinition, AgentHeartbeatInput, type AgentMonitorOptions, AgentMonitorService, AgentRegistrationInput, type AgentTimelineEntry, type AgentVirtualSession, type ApplyResult, type ApprovalDecision, AutonomousBrain, type AutonomousBrainOptions, AutonomousCoordinator, type AutonomousCoordinatorOptions, type AutonomousDecisionRequest, type AutonomousDecisionType, BUILD_AGENTS, BrainArbiter, BrainDecision, BrainDecisionOption, BrainDecisionRequest, BrainDecisionSource, type BrainInterventionInput, BrainMonitor, type BrainMonitorOptions, BrainRisk, type ChangeFile, ChangeManager, type ChangeManagerOptions, type ChangeNode, type ChangeProposal, type ChangeStatus, ClientHeartbeatInput, ClientRegistrationInput, ClientStatus, type ConsensusOptions, ConsensusProtocol, type ConsensusResult, type CoordinatorEvent, type CoordinatorStats, type DAGEdgeEvent, type DAGEdgeHandler, type DAGNode, type DAGNodeStatus, DEFAULT_QUALITY_CHECKS, DELIVERY_AGENTS, DEPENDENCY_FILE_PATTERNS, DISCOVERY_AGENTS, DOMAIN_AGENTS, type DecisionNode, type DecisionPrompt, DefaultMailbox, type DepWatchEntry, type DepWatcherBridgeOptions, type DependencyWatcherConfig, Director, type DownAlertInput, type EscalationDecision, type FactCategory, type FactNode, FleetBus, FleetManager, type FleetStatusToolOptions, FleetSupervisor, type FleetSupervisorActions, FleetSupervisorConfig, type FleetSupervisorOptions, type FleetSupervisorSource, GlobalMailbox, type GoalNode, type GoalPriority, type GoalStatus, type GraphSubscription, KNOWLEDGE_AGENTS, KnowledgeGraph, type LLMProvider, type LiveLockResult, MAILBOX_BRIDGE_LOCK_FILENAME, MAILBOX_BRIDGE_TOKEN_FILENAME, MAILBOX_HEALTH_DEFAULT_FAILURE_THRESHOLD, MAILBOX_HEALTH_DEFAULT_FROM, MAILBOX_HEALTH_DEFAULT_INTERVAL_MS, MAILBOX_HEALTH_DEFAULT_TIMEOUT_MS, META_AGENTS, type MailToolsOptions, Mailbox, MailboxAckBatchInput, MailboxAckInput, type MailboxActionInput, type MailboxActionResult, MailboxAgentStatus, type MailboxBridgeLock, type MailboxHealthEvent, MailboxHealthWatchdog, type MailboxHealthWatchdogOptions, type MailboxHooksOptions, MailboxMessage, type MailboxMessageAction, MailboxQuery, type MailboxResolver, MailboxSendInput, type MailboxToolOptions, type NodeFilter, type NodeType, type OutdatedNotifyMessage, PLANNING_AGENTS, type PackageAuthorEntry, type PackageAuthorLog, type PackageAuthorTrackerOptions, type PackageOutdatedEntry, type PackageOutdatedResult, type PackageOutdatedWatcherOptions, type PrioritizationDecision, PurgeOptions, PurgeResult, type QualityCheck, type QualityGateChecks, type QualityGateResult, type QuorumRule, REVIEW_AGENTS, type RecoveryAlertInput, type RollbackResult, type RunOptions, type RunnablesHandler, type SpawnDecision, type SupervisedSubagent, type SupervisorLogEntry, type TaskAuctionOptions, TaskAuctioneer, type TaskBid, TaskDAG, VERIFY_AGENTS, type VoteNode, type VoteRecord, type VoteValue, type VoterConfig, type WatchdogConfig, acquireOrJoin, actionToAckInput, attachDepWatcherBridge, buildDownAlert, buildRecoveryAlert, createAgentMonitorService, createMailboxHooks, detectEcosystem, finalize, getFullPackageLog, getManifestPackages, getPackageAuthor, getPackagesByAgent, mailboxSessionTag, makeDependencyWatcherConfig, makeFleetStatusTool, makeMailInboxTool, makeMailSendTool, makeMailboxTool, readLiveLock, recordPackageAction, release, resolveMailboxIdentity, startPackageOutdatedWatcher, updatePackageOutdatedStatus, validateWatchdogOptions };
+export { type AcquireOptions, type AcquireResult, AdaptiveConcurrencyController, type AdaptiveConcurrencyState, AgentDefinition, AgentHeartbeatInput, type AgentMonitorOptions, AgentMonitorService, AgentRegistrationInput, type AgentTimelineEntry, type AgentVirtualSession, type ApplyResult, type ApprovalDecision, AutonomousBrain, type AutonomousBrainOptions, AutonomousCoordinator, type AutonomousCoordinatorOptions, type AutonomousDecisionRequest, type AutonomousDecisionType, BUILD_AGENTS, BrainArbiter, BrainDecision, BrainDecisionOption, BrainDecisionRequest, BrainDecisionSource, type BrainInterventionInput, BrainMonitor, type BrainMonitorOptions, BrainRisk, type ChangeFile, ChangeManager, type ChangeManagerOptions, type ChangeNode, type ChangeProposal, type ChangeStatus, ClientHeartbeatInput, ClientRegistrationInput, ClientStatus, type ConsensusOptions, ConsensusProtocol, type ConsensusResult, type CoordinatorEvent, type CoordinatorStats, type DAGEdgeEvent, type DAGEdgeHandler, type DAGNode, type DAGNodeStatus, DEFAULT_QUALITY_CHECKS, DELIVERY_AGENTS, DEPENDENCY_FILE_PATTERNS, DISCOVERY_AGENTS, DOMAIN_AGENTS, type DecisionNode, type DecisionPrompt, DefaultMailbox, type DepWatchEntry, type DepWatcherBridgeOptions, type DependencyWatcherConfig, Director, type DownAlertInput, type EscalationDecision, type FactCategory, type FactNode, FleetBus, FleetManager, type FleetStatusToolOptions, FleetSupervisor, type FleetSupervisorActions, FleetSupervisorConfig, type FleetSupervisorOptions, type FleetSupervisorSource, GlobalMailbox, type GoalNode, type GoalPriority, type GoalStatus, type GraphSubscription, KNOWLEDGE_AGENTS, KnowledgeGraph, type LLMProvider, type LiveLockResult, MAILBOX_BRIDGE_LOCK_FILENAME, MAILBOX_BRIDGE_TOKEN_FILENAME, MAILBOX_HEALTH_DEFAULT_FAILURE_THRESHOLD, MAILBOX_HEALTH_DEFAULT_FROM, MAILBOX_HEALTH_DEFAULT_INTERVAL_MS, MAILBOX_HEALTH_DEFAULT_TIMEOUT_MS, MATRIX_PHASE_KEYS, META_AGENTS, type MailToolsOptions, Mailbox, MailboxAckBatchInput, MailboxAckInput, type MailboxActionInput, type MailboxActionResult, MailboxAgentStatus, type MailboxBridgeLock, type MailboxHealthEvent, MailboxHealthWatchdog, type MailboxHealthWatchdogOptions, type MailboxHooksOptions, MailboxMessage, type MailboxMessageAction, MailboxQuery, type MailboxResolver, MailboxSendInput, type MailboxToolOptions, type MatrixKeyKind, type ModelMatrixResolution, type ModelMatrixResolutionSource, type ModelReference, type NodeFilter, type NodeType, type OutdatedNotifyMessage, PLANNING_AGENTS, type PackageAuthorEntry, type PackageAuthorLog, type PackageAuthorTrackerOptions, type PackageOutdatedEntry, type PackageOutdatedResult, type PackageOutdatedWatcherOptions, type PrioritizationDecision, PurgeOptions, PurgeResult, type QualityCheck, type QualityGateChecks, type QualityGateResult, type QuorumRule, REVIEW_AGENTS, type RecoveryAlertInput, type ResolvedModelTarget, type ResolvedSubagentModelTarget, type RollbackResult, type RunOptions, type RunnablesHandler, type SpawnDecision, type SupervisedSubagent, type SupervisorLogEntry, type TaskAuctionOptions, TaskAuctioneer, type TaskBid, TaskDAG, VERIFY_AGENTS, type VoteNode, type VoteRecord, type VoteValue, type VoterConfig, type WatchdogConfig, acquireOrJoin, actionToAckInput, attachDepWatcherBridge, buildDownAlert, buildRecoveryAlert, createAgentMonitorService, createMailboxHooks, detectEcosystem, finalize, getFullPackageLog, getManifestPackages, getPackageAuthor, getPackagesByAgent, isValidMatrixKey, mailboxSessionTag, makeDependencyWatcherConfig, makeFleetStatusTool, makeMailInboxTool, makeMailSendTool, makeMailboxTool, matrixKeyKind, phaseForRole, readLiveLock, recordPackageAction, release, resolveImplementationModelTarget, resolveMailboxIdentity, resolveModelMatrix, resolveModelMatrixResolution, resolveModelTargetFromEntry, resolveSubagentModelTarget, roleNeedsIndependentReviewModel, sameModelReference, startPackageOutdatedWatcher, updatePackageOutdatedStatus, validateWatchdogOptions };