@wrongstack/core 0.280.1 → 0.281.0

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

@@ -1,12 +1,12 @@
-import { c as ToolCallPipelinePayload, d as ToolWrapper, E as ExtensionRegistry, S as SystemPromptContributor, e as ToolRegistry, P as ProviderRegistry, A as AgentPipelines, f as ToolExecutorLike, g as AgentInit, h as AgentInput, R as RunResult } from './index-kidebiDh.js';
-import { C as Container, R as ReadonlyPipeline, a as Renderer } from './pipeline-BwAP21_4.js';
-import { E as EventBus, a as EventName, L as Listener } from './events-Bs2fmldo.js';
-import { R as RetryPolicy, E as ErrorHandler } from './retry-policy-D4feSLk3.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-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 { 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-Dx6dIqS2.js';
-import { C as Context, J as JSONSchema, c as Request, d as Response, i as ContentBlock, s as TextBlock, T as Tool, P as Provider, v as RunOptions, U as Usage } from './tool-BkOgs_KL.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-Cr3312zc.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 { b as Mailbox } from './mailbox-types-BGZWrYTJ.js';
 
 type BridgeMessageType = 'task' | 'result' | 'progress' | 'error' | 'heartbeat' | 'stop' | 'delegate' | 'budget_threshold';
@@ -1050,6 +1050,18 @@ interface CoordinatorEvents {
         totalIterations: number;
     };
 }
+/**
+ * Result of {@link MultiAgentCoordinator.awaitTasksAny} — a partial drain of a
+ * task-id batch. `completed` holds every requested id that has already
+ * settled (at least one, unless `timedOut`); `pending` holds the rest, so the
+ * caller can loop "handle finishers, re-await the remainder".
+ */
+interface AwaitAnyResult {
+    completed: TaskResult[];
+    pending: string[];
+    /** Set when `timeoutMs` elapsed with zero completions among the requested ids. */
+    timedOut?: boolean;
+}
 interface MultiAgentCoordinator {
     readonly coordinatorId: string;
     readonly config: MultiAgentConfig;
@@ -1070,8 +1082,27 @@ interface MultiAgentCoordinator {
      * Resolves to an array in the same order as `taskIds`.
      */
     awaitTasks(taskIds: string[]): Promise<TaskResult[]>;
+    /**
+     * Wait until AT LEAST ONE of the named tasks completes, then return every
+     * requested result available at that moment plus the still-pending ids.
+     * Ids that already completed resolve immediately (drain-what's-done). With
+     * `timeoutMs`, resolves (never rejects) with `timedOut: true` and zero
+     * completions when the window elapses first.
+     */
+    awaitTasksAny(taskIds: string[], opts?: {
+        timeoutMs?: number;
+    }): Promise<AwaitAnyResult>;
     /** Snapshot of completed task results. */
     results(): readonly TaskResult[];
+    /** Defensive snapshot of the still-queued (not yet dispatched) tasks. */
+    listPendingTasks(): readonly TaskSpec[];
+    /**
+     * Re-pin a still-pending task to a different subagent (`undefined` =
+     * unpin) and try to dispatch. Returns `false` when the task is no longer
+     * pending (dispatched/completed/unknown) or the target subagent does not
+     * exist. Running tasks can never be pulled — steer or terminate instead.
+     */
+    retargetPendingTask(taskId: string, subagentId: string | undefined): boolean;
 }
 /**
  * Caller-supplied runner that actually executes a task. The coordinator
@@ -1317,4 +1348,4 @@ interface AgentRunnerOptions {
  */
 declare function makeAgentSubagentRunner(opts: AgentRunnerOptions): SubagentRunner;
 
-export { type SubagentRunOutcome as $, type AgentBridge as A, type BridgeTransport as B, type CoordinatorStatus as C, type DoneCondition as D, type BudgetKind as E, FleetBus as F, type BudgetLimits as G, type BudgetNegotiationMode as H, type BudgetThresholdDecision as I, type BudgetThresholdHandler as J, BudgetThresholdSignal as K, type BudgetUsage as L, type MultiAgentCoordinator as M, type CoordinatorEvents as N, DECISION_TIMEOUT_MS as O, type PluginAPI as P, type FleetEvent as Q, type FleetHandler as R, type SubagentConfig as S, type TaskSpec as T, type PluginLLMOptions as U, type PluginLLMResult as V, SubagentBudget as W, type SubagentContext as X, type SubagentError as Y, type SubagentErrorKind as Z, type SubagentRunContext as _, type BridgeMessage as a, type SubagentUsageSnapshot as a0, TIMEOUT_PREEMPT_FRACTION as a1, type TaskDelegation as a2, makeAgentSubagentRunner as a3, withDisabledToolFiltering as a4, type ProviderFactory as a5, type AgentBridgeConfig as b, type MultiAgentConfig as c, type SubagentRunner as d, type BudgetSessionIdSource as e, type SpawnResult as f, type TaskResult as g, Agent as h, type AgentFactory as i, type FleetUsage as j, FleetUsageAggregator as k, type SlashCommand as l, type PluginPipelines as m, type ToolRegistryView as n, type ProviderRegistryView as o, type MCPRegistryView as p, type SlashCommandRegistryView as q, type SessionWriterView as r, type MetricsSinkView as s, type PluginLLM as t, type PluginCapabilities as u, type PluginDependency as v, type Plugin as w, type AgentFactoryResult as x, type AgentRunnerOptions as y, BudgetExceededError as z };
+export { type SubagentRunContext as $, Agent as A, type BudgetSessionIdSource as B, type CoordinatorStatus as C, type DoneCondition as D, BudgetExceededError as E, FleetBus as F, type BudgetKind as G, type BudgetLimits as H, type BudgetNegotiationMode as I, type BudgetThresholdDecision as J, type BudgetThresholdHandler as K, BudgetThresholdSignal as L, type MultiAgentCoordinator as M, type BudgetUsage as N, type CoordinatorEvents as O, type PluginAPI as P, DECISION_TIMEOUT_MS as Q, type FleetEvent as R, type SubagentConfig as S, type TaskSpec as T, type FleetHandler as U, type PluginLLMOptions as V, type PluginLLMResult as W, SubagentBudget as X, type SubagentContext as Y, type SubagentError as Z, type SubagentErrorKind as _, type AgentFactory as a, type SubagentRunOutcome as a0, type SubagentUsageSnapshot as a1, TIMEOUT_PREEMPT_FRACTION as a2, type TaskDelegation as a3, makeAgentSubagentRunner as a4, withDisabledToolFiltering as a5, type ProviderFactory as a6, type MultiAgentConfig as b, type SubagentRunner as c, type SpawnResult as d, type BridgeMessage as e, type AgentBridge as f, type TaskResult as g, type AwaitAnyResult as h, type BridgeTransport as i, type AgentBridgeConfig as j, type FleetUsage as k, FleetUsageAggregator as l, type SlashCommand as m, type PluginPipelines as n, type ToolRegistryView as o, type ProviderRegistryView as p, type MCPRegistryView as q, type SlashCommandRegistryView as r, type SessionWriterView as s, type MetricsSinkView as t, type PluginLLM as u, type PluginCapabilities as v, type PluginDependency as w, type Plugin as x, type AgentFactoryResult as y, type AgentRunnerOptions as z };

package/dist/{compactor-U3agvUIG.d.ts → compactor-BxddyCFu.d.ts}

@@ -1,4 +1,4 @@
-import { C as Context } from './tool-BkOgs_KL.js';
+import { d as Context } from './tool-LVSLiE1s.js';
 
 interface CompactRepairReport {
     removedToolUses: string[];

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

@@ -1,4 +1,4 @@
-import { a as ReasoningConfig, p as ReasoningEffort, q as CacheTtl, r as Capabilities, e as Permission } from './tool-BkOgs_KL.js';
+import { a as ReasoningConfig, p as ReasoningEffort, q as CacheTtl, r as Capabilities, f as Permission } from './tool-LVSLiE1s.js';
 
 type ContextWindowModeId = 'balanced' | 'frugal' | 'deep' | 'archival';
 type ContextWindowAggressiveOn = 'hard' | 'soft' | 'warn';
@@ -810,6 +810,23 @@ interface AutonomyConfig {
     statuslineMode?: 'minimum' | 'detailed' | undefined;
     /** Single short word shown in the TUI rainbow working-state chip. Default: "thinking". */
     thinkingWord?: string | undefined;
+    /**
+     * Persist the TUI prompt input history to disk per project so Up/Down
+     * navigation recalls prompts across sessions. Secrets are scrubbed before
+     * they reach disk. Default: enabled, 100 entries.
+     */
+    inputHistory?: InputHistoryConfig | undefined;
+}
+/**
+ * Per-project TUI input history persistence options. Lives under
+ * `config.autonomy.inputHistory` because the TUI-specific knobs on Config
+ * are grouped there.
+ */
+interface InputHistoryConfig {
+    /** Persist history to ~/.wrongstack/projects/<slug>/input-history.json. Default: true. */
+    enabled?: boolean | undefined;
+    /** Max entries kept on disk (and in memory). Default: 100. */
+    maxEntries?: number | undefined;
 }
 /**
  * Automatic codebase symbol-index maintenance. Keeps the `codebase-search`
@@ -960,6 +977,61 @@ interface SkillsConfig {
      */
     registryUrl?: string | undefined;
 }
+/**
+ * Fleet peer-awareness + supervision settings. All sub-features are
+ * enabled-by-default with conservative throttles; each has its own kill
+ * switch. See `FleetSupervisor` (coordination/fleet-supervisor.ts) for the
+ * supervisor semantics.
+ */
+interface FleetConfig {
+    /** Periodic "[FLEET PULSE]" peer-status digest folded into each agent's context. */
+    pulse?: {
+        /** Default true. */
+        enabled?: boolean | undefined;
+        /** Inject at most every N agent iterations. Default 5. */
+        everyNIterations?: number | undefined;
+        /** Hard cap on digest characters. Default 900. */
+        maxChars?: number | undefined;
+        /** Max peers listed per digest. Default 15. */
+        maxAgents?: number | undefined;
+    } | undefined;
+    /** Broadcast `type:'status'` mails on meaningful subagent transitions. */
+    statusBroadcasts?: {
+        /** Default true. */
+        enabled?: boolean | undefined;
+        /** Min interval between broadcasts about the same subagent. Default 15000. */
+        minIntervalMsPerAgent?: number | undefined;
+        /** Global cap on broadcasts per minute (excess dropped + counted). Default 20. */
+        globalPerMinuteCap?: number | undefined;
+    } | undefined;
+    /** Brain-gated fleet supervisor (rebalance/steer/spawn-helper). */
+    supervisor?: FleetSupervisorConfig | undefined;
+}
+/** Config surface for the brain-gated FleetSupervisor. */
+interface FleetSupervisorConfig {
+    /** Kill switch. Default true (active whenever a Director is running). */
+    enabled?: boolean | undefined;
+    /** Evaluation tick. Default 20000. */
+    intervalMs?: number | undefined;
+    /** Per-(signal,subject) re-engagement cooldown. Default 120000. */
+    cooldownMs?: number | undefined;
+    /** Hard cap on interventions touching one subagent per run. Default 3. */
+    maxInterventionsPerSubagent?: number | undefined;
+    /** Pending task pinned to a busy worker longer than this → starvation signal. Default 60000. */
+    pinnedWaitMs?: number | undefined;
+    /** ≥ this many pending tasks pinned to one worker (with an idle sibling) → overload signal. Default 2. */
+    overloadPinnedThreshold?: number | undefined;
+    /** pending > backlogFactor × live workers (sustained) → spawn-helper signal. Default 2. */
+    backlogFactor?: number | undefined;
+    /** Running subagent with no tool activity for this long → stuck signal. Default 180000. */
+    stuckMs?: number | undefined;
+    /** Consecutive failed/timeout results from one subagent → failure-streak signal. Default 2. */
+    failureStreak?: number | undefined;
+    /** Allow the supervisor to spawn helper subagents. Default true. */
+    allowSpawn?: boolean | undefined;
+    /** Allow the supervisor to terminate subagents (highest risk). Default false. */
+    allowTerminate?: boolean | undefined;
+}
 interface Config {
     version: 1;
     provider: string;
@@ -1104,6 +1176,14 @@ interface Config {
     modelRuntime?: ModelRuntimeConfig | undefined;
     /** HQ client publishing settings, used by CLI/REPL/TUI/WebUI consistently. */
     hq?: HqClientConfig | undefined;
+    /**
+     * Fleet awareness + supervision settings (peer-status pulse digests,
+     * status-broadcast mails, and the brain-gated FleetSupervisor). SECURITY:
+     * in the in-project config DENY list — a repo-committed config must not be
+     * able to enable autonomous spawning/steering or mailbox traffic. Only
+     * honoured from the user's `~/.wrongstack/config.json`.
+     */
+    fleet?: FleetConfig | undefined;
     /**
      * Cloud sync configuration. Stored separately in sync.json to avoid
      * accidentally committing the GitHub token to project configs.
@@ -1165,4 +1245,4 @@ interface ConfigStore {
     watch(cb: (next: Readonly<Config>, prev: Readonly<Config>) => void): () => void;
 }
 
-export { type SyncCategory 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 HqClientConfig as G, type HookEvent as H, type InProcessHook as I, type IndexingConfig as J, type LogConfig as K, type LaunchConfig as L, type ModelsRegistry as M, MAX_TUI_THINKING_WORD_LENGTH as N, type ModelRuntimeCacheConfig as O, type ProviderConfig as P, type ModelRuntimeParametersConfig as Q, type ResolvedProvider as R, type ShellHook as S, type ToolResultRenderMode as T, type ModelRuntimeReasoningConfig as U, type ModelsDevProvider as V, type WireFamily as W, type PluginConfig as X, type ProviderApiKey as Y, type SessionLoggingConfig as Z, type SkillsConfig as _, type ModelsDevPayload as a, type ToolDescriptionMode as a0, type ToolDescriptionModeConfig as a1, type ToolResultRenderModeConfig as a2, type ToolsConfig as a3, formatContextWindowModeList as a4, getContextWindowMode as a5, isContextWindowModeId as a6, listContextWindowModes as a7, normalizeTokenSavingTier as a8, normalizeTuiThinkingWord as a9, resolveContextWindowPolicy as aa, type ResolvedModel as b, type MCPServerConfig as c, type ModelMatrixEntry as d, type ModelsDevModel as e, type HookMatcher as f, type HookEntry as g, type ModelRuntimeConfig as h, type ContextWindowAggressiveOn as i, type ContextWindowPolicy as j, type ConfigLoader as k, type SyncConfig as l, type ConfigStore 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 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 };

package/dist/coordination/index.d.ts

@@ -1,27 +1,27 @@
-export { I as InMemoryAgentBridge, a as InMemoryBridgeTransport, c as createMessage } from '../agent-bridge-DXC6QDJ4.js';
-import { F as FleetBus } from '../agent-subagent-runner-PoqNKiR4.js';
-export { i as AgentFactory, x as AgentFactoryResult, y as AgentRunnerOptions, z as BudgetExceededError, E as BudgetKind, G as BudgetLimits, H as BudgetNegotiationMode, I as BudgetThresholdDecision, J as BudgetThresholdHandler, K as BudgetThresholdSignal, L as BudgetUsage, O as DECISION_TIMEOUT_MS, Q as FleetEvent, R as FleetHandler, j as FleetUsage, k as FleetUsageAggregator, W as SubagentBudget, a0 as SubagentUsageSnapshot, a1 as TIMEOUT_PREEMPT_FRACTION, a3 as makeAgentSubagentRunner, a4 as withDisabledToolFiltering } from '../agent-subagent-runner-PoqNKiR4.js';
-import { H as FleetManager, s as Director } from '../null-fleet-bus-DkdmZJ_W.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 LargeAnswerStore, O as NULL_FLEET_BUS, R as REFACTOR_PLANNER_AGENT, P as RefactorPhase, Q as RefactorPlan, S as SECURITY_SCANNER_AGENT, T as SharedFileEntry, U as SharedFileSnapshot, V as SubagentPromptParts, W as applyRosterBudget, X as attachAutoExtend, Y as composeDirectorPrompt, Z as composeSubagentPrompt, _ as createDelegateTool, $ as getAgentDefinition, a0 as makeAskResultTool, a1 as makeAskTool, a2 as makeAssignTool, a3 as makeAwaitTasksTool, a4 as makeCollabDebugTool, a5 as makeDirectorSessionFactory, a6 as makeFleetEmitTool, a7 as makeFleetHealthTool, a7 as makeFleetSessionTool, a7 as makeFleetStatusTool, a7 as makeFleetTool, a7 as makeFleetUsageTool, a8 as makeRollUpTool, a9 as makeSpawnTool, aa as makeTerminateAllTool, ab as makeTerminateTool, ac as makeWorkCompleteTool, ad as rosterSummaryFromConfigs } from '../null-fleet-bus-DkdmZJ_W.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-Bs2fmldo.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-Bs2fmldo.js';
+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 { 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-CieyUoEL.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-CieyUoEL.js';
-import { G as GlobalMailbox } from '../global-mailbox-Ct7IorLJ.js';
-export { aA as resolveProjectDir } from '../global-mailbox-Ct7IorLJ.js';
-import { C as Context, T as Tool } from '../tool-BkOgs_KL.js';
-import { A as AdaptiveConcurrencyConfig } from '../config-Cr3312zc.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 { A as AgentEntry } from '../session-registry-Dvg7i_IA.js';
+import { J as FleetSupervisorConfig, A as AdaptiveConcurrencyConfig } from '../config-CN-vdDEI.js';
 import { L as Logger } from '../logger-B63L5bTg.js';
-import '../index-kidebiDh.js';
-import '../pipeline-BwAP21_4.js';
-import '../permission-Dx6dIqS2.js';
-import '../observability-D-HZN_mF.js';
-import '../secret-scrubber-3MHDDAtm.js';
-import '../retry-policy-D4feSLk3.js';
 import 'node:events';
 import '../director-state-BfeCUbmk.js';
+import '../index-C1E-_71T.js';
+import '../pipeline-E7_jqGyV.js';
+import '../permission-B6YAtNFz.js';
+import '../observability-D-HZN_mF.js';
+import '../secret-scrubber-3MHDDAtm.js';
+import '../retry-policy-V67lBOJz.js';
 
 /** Phase 1 · Discovery — map the territory before any work begins. */
 declare const DISCOVERY_AGENTS: AgentDefinition[];
@@ -346,6 +346,189 @@ interface MailToolsOptions {
 declare function makeMailSendTool(opts?: MailToolsOptions): Tool;
 declare function makeMailInboxTool(opts?: MailToolsOptions): Tool;
 
+/**
+ * fleet-status-tool — read-only live peer snapshot for any agent.
+ *
+ * The pull half of peer awareness (the push half is the fleet-pulse
+ * digest): any agent — leader or fleet subagent — can ask "who else is
+ * working on this project right now, and on what?" before starting work
+ * that might overlap, or when deciding whether to wait or proceed.
+ *
+ * Data source: the project mailbox registry (`getAgentStatuses`), which is
+ * cross-process by construction. When the host passes `getLocalAgents`
+ * (an AgentStatusTracker view), same-process entries are enriched with the
+ * richer live fields the registry doesn't carry (ctxPct, costUsd,
+ * partialText tail).
+ *
+ * @module fleet-status-tool
+ */
+
+interface FleetStatusToolOptions {
+    /** 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 registration surface events. */
+    events?: EventBus | undefined;
+    /**
+     * Same-process rich agent state (AgentStatusTracker snapshot). Merged
+     * into registry rows by name when provided — cross-process peers keep
+     * registry-only fields.
+     */
+    getLocalAgents?: (() => AgentEntry[]) | undefined;
+}
+declare function makeFleetStatusTool(opts?: FleetStatusToolOptions): Tool;
+
+/**
+ * FleetSupervisor — brain-gated shadow watcher over the generic fleet.
+ *
+ * The Director gives a leader agent orchestration TOOLS; this module gives
+ * the fleet a SUPERVISOR that works even while the leader is deep in its
+ * own task: it continuously watches queue shape + worker activity, detects
+ * imbalance (a pending task starving behind a busy worker while a sibling
+ * idles, a deep backlog, a stuck or repeatedly-failing worker), and — after
+ * clearing every proposal through the tiered BrainArbiter (policy → LLM →
+ * human, honoring the /brain risk ceiling) — acts: retargets pending
+ * tasks ("I'm reducing your workload"), spawns a helper, steers an agent
+ * by mail, notifies the leader, or (opt-in) terminates.
+ *
+ * Design lineage: BrainMonitor (watch bus → decide → intervene, cooldowns,
+ * single engagement in flight) generalized from "steer the leader" to the
+ * full fleet action set; SddSupervisor's brain-verdict contract reused for
+ * the decision step. The SDD subsystem itself is untouched.
+ *
+ * Non-interference guarantees (also pinned by tests):
+ *   - never calls extend/deny on budget negotiations — the Director's
+ *     budgetFilter remains the sole negotiator; we only OBSERVE events
+ *   - never preempts a RUNNING task — only still-pending tasks move
+ *   - never flips autonomy mode
+ *   - dormant once the director declares work complete
+ *
+ * @module fleet-supervisor
+ */
+
+/** One subagent row of the snapshot the supervisor reasons over. */
+interface SupervisedSubagent {
+    id: string;
+    name: string;
+    status: 'running' | 'idle' | 'stopped' | 'error';
+    currentTask?: string | undefined;
+}
+/** Read port — implemented over Director/coordinator state by the host. */
+interface FleetSupervisorSource {
+    subagents(): SupervisedSubagent[];
+    listPendingTasks(): readonly TaskSpec[];
+    isWorkComplete(): boolean;
+}
+/** Action port — every mutation the supervisor may perform, brain-gated. */
+interface FleetSupervisorActions {
+    /** Move a still-pending task to another (or any idle) worker. */
+    retargetPendingTask(taskId: string, subagentId: string | undefined): boolean | Promise<boolean>;
+    /** Spawn an additional helper worker. Return {error} to degrade gracefully. */
+    spawnHelper(input: {
+        reason: string;
+    }): Promise<{
+        subagentId: string;
+    } | {
+        error: string;
+    }>;
+    /** High-priority steer mail to one agent. */
+    steerAgent(subagentId: string, subject: string, body: string): Promise<void>;
+    /** Status/steer mail to the session leader. */
+    notifyLeader(subject: string, body: string): Promise<void>;
+    /** Abort a subagent (only used when config.allowTerminate). */
+    terminate(subagentId: string): Promise<void>;
+}
+interface FleetSupervisorOptions {
+    events: EventBus;
+    fleet: FleetBus;
+    brain: BrainArbiter;
+    source: FleetSupervisorSource;
+    actions: FleetSupervisorActions;
+    /** Active host session id, read lazily (resume/session-swap safe). */
+    sessionId?: (() => string | undefined) | undefined;
+    config?: FleetSupervisorConfig | undefined;
+    /** Injectable clock for tests. Default Date.now. */
+    now?: (() => number) | undefined;
+}
+interface SupervisorLogEntry {
+    at: number;
+    kind: string;
+    subagentId?: string | undefined;
+    taskId?: string | undefined;
+    proposedAction: string;
+    outcome: 'approved' | 'denied' | 'escalated' | 'skipped' | 'error';
+    detail: string;
+}
+interface ResolvedSupervisorConfig {
+    enabled: boolean;
+    intervalMs: number;
+    cooldownMs: number;
+    maxInterventionsPerSubagent: number;
+    pinnedWaitMs: number;
+    overloadPinnedThreshold: number;
+    backlogFactor: number;
+    stuckMs: number;
+    failureStreak: number;
+    allowSpawn: boolean;
+    allowTerminate: boolean;
+}
+declare class FleetSupervisor {
+    private readonly opts;
+    private readonly cfg;
+    private readonly now;
+    private timer;
+    private readonly offHandles;
+    private engaging;
+    private stopped;
+    /** taskId → first tick timestamp we saw it pending. */
+    private readonly pendingSince;
+    /** subagentId → last tool.executed timestamp (fleet-wide activity map). */
+    private readonly lastActivityAt;
+    /** subagentId → consecutive non-success completions. */
+    private readonly failStreaks;
+    /** Consecutive ticks the backlog condition held. */
+    private backlogTicks;
+    /** `${kind}|${subject}` → last engagement ts. */
+    private readonly lastEngagedAt;
+    private readonly interventionsBySubagent;
+    /** Tasks already retargeted once — never bounced twice. */
+    private readonly retargetedTasks;
+    private readonly log;
+    constructor(opts: FleetSupervisorOptions);
+    /** Idempotent; also re-arms after a stop() so `/supervisor on` works. */
+    start(): void;
+    stop(): void;
+    history(): readonly SupervisorLogEntry[];
+    /** True while the evaluation loop is armed. */
+    isRunning(): boolean;
+    /** Resolved (defaulted) configuration — for status surfaces. */
+    configSnapshot(): Readonly<ResolvedSupervisorConfig>;
+    private nudgeTimer;
+    private scheduleNudge;
+    private isCollab;
+    /** One evaluation pass. Public for tests; production runs it on the tick. */
+    evaluate(): Promise<void>;
+    private cooldownOk;
+    private interventionBudgetOk;
+    private recordIntervention;
+    private emitSignal;
+    private record;
+    private emitAction;
+    /**
+     * Ask the brain to approve a proposal. Same contract as BrainMonitor:
+     * `source:'system'`, the rule's proposal `recommended:true`, fallback
+     * 'ask_human' (routes to the LLM tier under the risk ceiling before any
+     * human). Returns the chosen option id, or null for deny/escalate.
+     */
+    private decide;
+    private engageRebalance;
+    private engageBacklog;
+    private engageStuck;
+    private engageFailureStreak;
+    private engageIdleWithWork;
+}
+
 /**
  * DefaultMailbox — append-only JSONL inter-agent mailbox (per-session).
  *
@@ -2279,4 +2462,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, 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 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, 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, 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 };