@wrongstack/core 0.283.1 → 0.284.1

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

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

package/dist/{config-DkCbA3Bw.d.ts → config-MRqn1V-u.d.ts}

@@ -1,4 +1,4 @@
-import { a as ReasoningConfig, p as ReasoningEffort, q as CacheTtl, r as Capabilities, f as Permission } from './tool-LVSLiE1s.js';
+import { a as ReasoningConfig, p as ReasoningEffort, q as CacheTtl, r as Capabilities, f as Permission } from './tool-BNlnIJvo.js';
 
 type ContextWindowModeId = 'balanced' | 'frugal' | 'deep' | 'archival';
 type ContextWindowAggressiveOn = 'hard' | 'soft' | 'warn';
@@ -53,6 +53,35 @@ type HookEvent = 'PreToolUse' | 'PostToolUse' | 'UserPromptSubmit' | 'SessionSta
  * `"edit|write"`, `"*"`. Ignored (treated as `*`) for non-tool events.
  */
 type HookMatcher = string;
+/** What to do when a hook crashes, times out, or returns malformed output. */
+type HookFailurePolicy = 'open' | 'closed';
+/**
+ * PreToolUse hooks run in two phases. Mutators compose first; validators then
+ * inspect the final arguments and may no longer rewrite them.
+ */
+type PreToolUseStage = 'mutate' | 'validate';
+/** Per-registration runtime controls shared by every hook transport. */
+interface HookRegistrationOptions {
+    /** Stable name used in logs and model-visible fail-closed errors. */
+    name?: string | undefined;
+    /** Per-invocation deadline in milliseconds (default 5000). */
+    timeoutMs?: number | undefined;
+    /** `open` skips a failed hook; `closed` converts failure to a denial. */
+    failurePolicy?: HookFailurePolicy | undefined;
+    /** PreToolUse phase. Legacy registrations default to `mutate`. */
+    stage?: PreToolUseStage | undefined;
+    /**
+     * Trusted enforcement hook. Policy hooks remain active under `--no-hooks`;
+     * ordinary automation hooks do not.
+     */
+    policy?: boolean | undefined;
+}
+/** Deadline/cancellation context passed to in-process hooks. */
+interface HookInvocationContext {
+    signal: AbortSignal;
+    /** Absolute Unix epoch deadline in milliseconds. */
+    deadlineAt: number;
+}
 /**
  * The JSON payload handed to a hook. For shell hooks this is serialized to
  * stdin; for in-process hooks it is passed as the sole argument. Kept flat and
@@ -107,35 +136,70 @@ interface HookOutcome {
      */
     contextAs?: 'inline' | 'separate' | undefined;
 }
+/**
+ * Preferred, mutually-exclusive PreToolUse result. `allow` means only that
+ * this hook has no objection; it never bypasses the core permission policy.
+ */
+type PreToolUseOutcome = {
+    additionalContext?: string | undefined;
+    contextAs?: 'inline' | 'separate' | undefined;
+} & ({
+    action: 'allow';
+} | {
+    action: 'deny';
+    reason: string;
+} | {
+    action: 'mutate';
+    input: Record<string, unknown>;
+    reason?: string | undefined;
+});
+/** New and legacy hook outputs accepted at the transport boundary. */
+type AnyHookOutcome = HookOutcome | PreToolUseOutcome;
 /** An in-process hook function (registered via the plugin API). */
-type InProcessHook = (input: HookInput) => HookOutcome | void | Promise<HookOutcome | void>;
+type InProcessHook = (input: HookInput, runtime: HookInvocationContext) => AnyHookOutcome | void | Promise<AnyHookOutcome | void>;
+interface ConfiguredHookBase extends HookRegistrationOptions {
+    /** Tool-name matcher (defaults to `*`). */
+    matcher?: HookMatcher | undefined;
+}
 /**
  * A shell-command hook (declared in `config.hooks`). Claude-compatible: the
  * `HookInput` JSON is written to the command's stdin; a JSON `HookOutcome` may
  * be printed to stdout, and exit code 2 forces `decision: 'block'`.
  */
-interface ShellHook {
+interface ShellHook extends ConfiguredHookBase {
+    type?: 'command' | undefined;
     /** Command line run via the platform shell. */
     command: string;
-    /** Tool-name matcher (defaults to `*`). */
-    matcher?: HookMatcher | undefined;
-    /** Per-invocation timeout in ms (default 5000). */
+}
+/** Native HTTP hook. The HookInput JSON is POSTed and JSON output is parsed. */
+interface HttpHook extends ConfiguredHookBase {
+    type: 'http';
+    url: string;
+    headers?: Record<string, string> | undefined;
+}
+type ConfiguredHook = ShellHook | HttpHook;
+interface HookEntryBase {
+    event: HookEvent;
+    matcher: HookMatcher;
+    name: string;
     timeoutMs?: number | undefined;
+    failurePolicy: HookFailurePolicy;
+    stage: PreToolUseStage;
+    policy: boolean;
 }
 /** A registered hook entry, discriminated by transport. */
-type HookEntry = {
+type HookEntry = (HookEntryBase & {
     kind: 'inprocess';
-    event: HookEvent;
-    matcher: HookMatcher;
     hook: InProcessHook;
     owner?: string | undefined;
-} | {
+}) | (HookEntryBase & {
     kind: 'shell';
-    event: HookEvent;
-    matcher: HookMatcher;
     command: string;
-    timeoutMs?: number | undefined;
-};
+}) | (HookEntryBase & {
+    kind: 'http';
+    url: string;
+    headers?: Record<string, string> | undefined;
+});
 
 /**
  * Mirror of the models.dev/api.json schema. Top-level is keyed by provider id.
@@ -489,6 +553,41 @@ interface ToolsConfig {
      * it is honored from any source.
      */
     exec?: ExecToolConfig | undefined;
+    /**
+     * Agent-loop repetition detector tuning. The detector watches two signals:
+     * consecutive effectively-identical iterations (same tool-name set + inputs
+     * + text) and per-call repeats (the same tool invoked with identical
+     * arguments N times within a sliding window, even when interleaved with
+     * other calls). In the default `steer-then-cut` mode the first detection
+     * folds a corrective note into the conversation and lets the run continue;
+     * only persistent repetition cuts the turn. Omitted fields use built-in
+     * defaults (see DEFAULT_TOOLS_CONFIG.loopDetection).
+     */
+    loopDetection?: LoopDetectionConfig | undefined;
+}
+/** Tuning for the agent-loop repetition detector (`tools.loopDetection`). */
+interface LoopDetectionConfig {
+    /**
+     * `steer-then-cut` (default): inject a corrective note at the steer
+     * threshold, cut the turn only if repetition persists to the cut threshold.
+     * `cut`: legacy behavior — hard-stop at the steer threshold, per-call
+     * detector disabled. `off`: disable loop detection entirely.
+     */
+    mode?: 'steer-then-cut' | 'cut' | 'off' | undefined;
+    /** Consecutive identical iterations before the detector acts (default 3, min 2). */
+    steerThreshold?: number | undefined;
+    /**
+     * Consecutive identical iterations at which the turn is cut in
+     * `steer-then-cut` mode (default steerThreshold + 2, min steerThreshold + 1).
+     */
+    cutThreshold?: number | undefined;
+    /** Sliding window of recent tool calls for per-call repeat detection (default 12, min 4). */
+    windowSize?: number | undefined;
+    /**
+     * Identical (name + canonicalized args) calls within the window that
+     * trigger a steer note (default 4, min 2).
+     */
+    callRepeatThreshold?: number | undefined;
 }
 /** Allow/deny extension of the `exec` tool's built-in command allowlist. */
 interface ExecToolConfig {
@@ -874,7 +973,7 @@ interface IndexingConfig {
     /**
      * Watchdog timeout (ms) for a full index run. A run exceeding this is
      * aborted (so it can never wedge the indexing mutex or freeze the terminal)
-     * and counts toward the indexing circuit breaker. Default: 120000.
+     * and counts toward the indexing circuit breaker. Default: 240000.
      */
     indexTimeoutMs?: number | undefined;
 }
@@ -1013,6 +1112,15 @@ interface SkillsConfig {
  * supervisor semantics.
  */
 interface FleetConfig {
+    /** Fleet-wide hard ceilings. In-flight work may finish; new spawns are refused at the cap. */
+    budget?: {
+        /** Maximum subagents spawned during one Director lifetime. Default 64 in CLI. */
+        maxSpawns?: number | undefined;
+        /** Maximum cumulative input+output tokens across all fleet subagents. */
+        maxTokens?: number | undefined;
+        /** Maximum cumulative estimated USD cost across all fleet subagents. */
+        maxCostUsd?: number | undefined;
+    } | undefined;
     /** Periodic "[FLEET PULSE]" peer-status digest folded into each agent's context. */
     pulse?: {
         /** Default true. */
@@ -1077,7 +1185,7 @@ interface FleetSupervisorConfig {
     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. */
+    /** Running subagent with no observable fleet 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;
@@ -1174,12 +1282,12 @@ interface Config {
      */
     fallbackAuto?: boolean | undefined;
     /**
-     * Lifecycle shell hooks, keyed by event. Each command receives the hook
-     * `HookInput` JSON on stdin; a JSON `HookOutcome` on stdout (and exit code 2
-     * = block) steers the agent. In-process hooks are registered separately via
-     * the plugin API. Disabled entirely under `--bare` / `--no-hooks`.
+     * Lifecycle command/HTTP hooks, keyed by event. Commands receive HookInput
+     * JSON on stdin; HTTP hooks receive the same object as a POST body. A typed
+     * outcome can allow, deny, or mutate. `policy: true` enforcement hooks remain
+     * active under `--no-hooks`; ordinary automation is disabled.
      */
-    hooks?: Partial<Record<HookEvent, ShellHook[]>>;
+    hooks?: Partial<Record<HookEvent, ConfiguredHook[]>>;
     plugins?: (string | PluginConfig)[] | undefined;
     log: LogConfig;
     features: FeaturesConfig;
@@ -1299,4 +1407,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 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 };
+export { type LoopDetectionConfig as $, type AdaptiveConcurrencyConfig as A, type ContextWindowModeId as B, type ConfiguredHook as C, type ContextWindowThresholds as D, type CustomModelDefinition as E, type FleetConfig as F, DEFAULT_CONTEXT_WINDOW_MODE_ID as G, type HookEvent as H, type InProcessHook as I, DEFAULT_TUI_THINKING_WORD as J, type ExecDangerConfig as K, type ExecToolConfig as L, type ModelsRegistry as M, type FeaturesConfig as N, type FleetSupervisorConfig as O, type ProviderConfig as P, type HookFailurePolicy as Q, type ResolvedModel as R, type ShellHook as S, type ToolResultRenderMode as T, type HookInvocationContext as U, type HqClientConfig as V, type WireFamily as W, type IndexingConfig as X, type InputHistoryConfig as Y, type LaunchConfig as Z, type LogConfig as _, type ModelMatrixEntry as a, MAX_TUI_THINKING_WORD_LENGTH as a0, type ModelRuntimeCacheConfig as a1, type ModelRuntimeParametersConfig as a2, type ModelRuntimeReasoningConfig as a3, type ModelsDevProvider as a4, type PluginConfig as a5, type PreToolUseOutcome as a6, type PreToolUseStage as a7, type ProviderApiKey as a8, type SessionLoggingConfig as a9, type SkillsConfig as aa, type SyncCategory as ab, type ToolDescriptionMode as ac, type ToolDescriptionModeConfig as ad, type ToolResultRenderModeConfig as ae, type ToolsConfig as af, formatContextWindowModeList as ag, getContextWindowMode as ah, isContextWindowModeId as ai, listContextWindowModes as aj, normalizeTokenSavingTier as ak, normalizeTuiThinkingWord as al, resolveContextWindowPolicy as am, type MCPServerConfig as b, type ModelsDevPayload as c, type ResolvedProvider as d, type ModelsDevModel as e, type HookMatcher as f, type HookRegistrationOptions as g, type HttpHook as h, type HookEntry as i, type Config as j, type ModelRuntimeConfig as k, type ConfigLoader as l, type SyncConfig as m, type ConfigStore as n, type ContextWindowAggressiveOn as o, type ContextWindowPolicy as p, type TokenSavingTier as q, type HookInput as r, type HookOutcome as s, type AnyHookOutcome as t, type AutonomyConfig as u, CONTEXT_WINDOW_MODES as v, type CircuitBreakerRuntimeConfig as w, type ContextConfig as x, type ContextWindowConfigLike as y, type ContextWindowMode as z };

package/dist/coordination/index.d.ts

@@ -1,28 +1,26 @@
-import { H as FleetManager, s as Director } from '../null-fleet-bus-D4e9R7Qc.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 makeKanbanQueueTool, ai as makeQualityGateTool, aj as makeRollUpTool, ak as makeSpawnTool, al as makeTerminateAllTool, am as makeTerminateTool, an as makeWorkCompleteTool, ao as resolveSubagentWorktreeDecision, ap as rosterSummaryFromConfigs, aq as subagentNeedsWorktree, ar as wrapSubagentRunnerWithWorktrees } from '../null-fleet-bus-D4e9R7Qc.js';
-import { F as FleetBus, T as TaskSpec } from '../agent-subagent-runner-BsuWhB28.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-BsuWhB28.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-KmxSmvho.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-KmxSmvho.js';
+import { H as FleetManager, s as Director } from '../null-fleet-bus-CFoNVQEK.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 FleetTokenCapError, M as FleetWorktreePolicy, N as ICoordinator, O as IFleetManager, P as InMemoryAgentBridge, Q as InMemoryBridgeTransport, R as LargeAnswerStore, S as NULL_FLEET_BUS, T as REFACTOR_PLANNER_AGENT, U as RefactorPhase, V as RefactorPlan, W as SECURITY_SCANNER_AGENT, X as SharedFileEntry, Y as SharedFileSnapshot, Z as SubagentPromptParts, _ as TaskResultNotification, $ as WorktreeIntegrationError, a0 as WorktreeIsolationDecision, a1 as WorktreeTaskRunnerOptions, a2 as WorktreeTaskStateUpdate, a3 as applyRosterBudget, a4 as attachAutoExtend, a5 as composeDirectorPrompt, a6 as composeSubagentPrompt, a7 as createDelegateTool, a8 as createMessage, a9 as getAgentDefinition, aa as makeAskResultTool, ab as makeAskTool, ac as makeAssignTool, ad as makeAwaitTasksTool, ae as makeCollabDebugTool, af as makeDirectorSessionFactory, ag as makeFleetEmitTool, ah as makeFleetHealthTool, ah as makeFleetSessionTool, ah as makeFleetTool, ah as makeFleetUsageTool, ai as makeKanbanQueueTool, aj as makeQualityGateTool, ak as makeRollUpTool, al as makeSpawnTool, am as makeTerminateAllTool, an as makeTerminateTool, ao as makeWorkCompleteTool, ap as resolveSubagentWorktreeDecision, aq as rosterSummaryFromConfigs, ar as subagentNeedsWorktree, as as wrapSubagentRunnerWithWorktrees } from '../null-fleet-bus-CFoNVQEK.js';
+import { h as AgentDefinition, F as FleetBus, T as TaskSpec, ai as SubagentStructuredReport } from '../multi-agent-coordinator-4RCRZKjN.js';
+export { z as AGENT_TOOL_PRESETS, E as AgentBudgetTier, G as AgentCapability, a as AgentFactory, H as AgentFactoryResult, g as AgentPhase, I as AgentRunnerOptions, J as BudgetExceededError, K as BudgetKind, L as BudgetLimits, N as BudgetNegotiationMode, O as BudgetThresholdDecision, Q as BudgetThresholdHandler, R as BudgetThresholdSignal, U as BudgetUsage, W as DECISION_TIMEOUT_MS, X as DEFAULT_DISPATCH_ROLE, b as DefaultMultiAgentCoordinator, Y as DispatchCandidate, D as DispatchClassifier, Z as DispatchMethod, _ as DispatchOptions, $ as DispatchResult, a0 as FleetEvent, a1 as FleetHandler, j as FleetUsage, k as FleetUsageAggregator, a2 as HEAVY_BUDGET, a3 as LIGHT_BUDGET, a4 as MEDIUM_BUDGET, a6 as MultiAgentCoordinatorOptions, aa as SubagentBudget, aj as SubagentUsageSnapshot, ak as TIMEOUT_PREEMPT_FRACTION, am as dispatchAgent, an as makeAgentSubagentRunner, ao as makeLLMClassifier, ap as scoreAgents, aq as withDisabledToolFiltering } from '../multi-agent-coordinator-4RCRZKjN.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-Bgnh43r9.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-Bgnh43r9.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-CrjeTB9i.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-CrjeTB9i.js';
 import { A as AgentEntry } from '../session-registry-Dvg7i_IA.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-DkCbA3Bw.js';
-import { G as GlobalMailbox } from '../global-mailbox-rWVt8YlO.js';
-export { aA as resolveProjectDir } from '../global-mailbox-rWVt8YlO.js';
+import { d as Context, g as Tool } from '../tool-BNlnIJvo.js';
+import { O as FleetSupervisorConfig, a as ModelMatrixEntry, j as Config, A as AdaptiveConcurrencyConfig } from '../config-MRqn1V-u.js';
+import { G as GlobalMailbox } from '../global-mailbox-sZwyI6CS.js';
+export { aA as resolveProjectDir } from '../global-mailbox-sZwyI6CS.js';
 import { L as Logger } from '../logger-B63L5bTg.js';
 import 'node:events';
-import '../director-state-B_GPa78Q.js';
-import '../worktree-manager-BjyAW30D.js';
-import '../index-BhCteHAF.js';
-import '../pipeline-ixSFe5jg.js';
-import '../permission-B6YAtNFz.js';
+import '../director-state-CMS_bMs4.js';
+import '../worktree-manager-DzwxKE35.js';
+import '../index--Gm41aBJ.js';
+import '../pipeline-DGDyIohT.js';
+import '../permission-ByDKXEcG.js';
 import '../observability-D-HZN_mF.js';
 import '../secret-scrubber-3MHDDAtm.js';
-import '../retry-policy-V67lBOJz.js';
+import '../retry-policy-CQ7KwXJa.js';
 
 /** Phase 1 · Discovery — map the territory before any work begins. */
 declare const DISCOVERY_AGENTS: AgentDefinition[];
@@ -396,6 +394,8 @@ interface FleetSupervisorActions {
     /** Spawn an additional helper worker. Return {error} to degrade gracefully. */
     spawnHelper(input: {
         reason: string;
+        /** Oldest queued task used to route the helper's role/tool profile. */
+        task?: TaskSpec | undefined;
     }): Promise<{
         subagentId: string;
     } | {
@@ -452,7 +452,7 @@ declare class FleetSupervisor {
     private stopped;
     /** taskId → first tick timestamp we saw it pending. */
     private readonly pendingSince;
-    /** subagentId → last tool.executed timestamp (fleet-wide activity map). */
+    /** subagentId → last observable fleet event timestamp. */
     private readonly lastActivityAt;
     /** subagentId → consecutive non-success completions. */
     private readonly failStreaks;
@@ -498,6 +498,29 @@ declare class FleetSupervisor {
     private engageIdleWithWork;
 }
 
+/** Absolute recursion ceiling. Configuration may narrow this, never widen it. */
+declare const HARD_MAX_SPAWN_DEPTH = 2;
+/** CLI fleet default; core embedders retain their historical Infinity default. */
+declare const DEFAULT_MAX_FLEET_SPAWNS = 64;
+declare function resolveMaxSpawnDepth(requested?: number | undefined): number;
+
+/** Context metadata key used to hand the submitted report to the task runner. */
+declare const SUBAGENT_STRUCTURED_REPORT_META_KEY = "subagentStructuredReport";
+declare const MAX_SUBAGENT_STRUCTURED_REPORT_CHARS = 8000;
+/**
+ * Validate and normalize a model-supplied structured result. The tool executor
+ * already applies JSON Schema validation, but this guard keeps direct callers,
+ * custom executors, and data read back from Context metadata honest too.
+ */
+declare function normalizeSubagentStructuredReport(value: unknown): SubagentStructuredReport | undefined;
+declare function readSubagentStructuredReport(ctx: Pick<Context, 'meta'> | {
+    meta?: Record<string, unknown>;
+} | undefined): SubagentStructuredReport | undefined;
+/** Stable compact text form for mailbox/roll-up surfaces. */
+declare function formatSubagentStructuredReport(report: SubagentStructuredReport): string;
+/** Safe, task-local handoff channel from a subagent to its Director. */
+declare function makeSubagentResultTool(): Tool;
+
 /**
  * mail-tools — thin, high-affordance wrappers over the project mailbox.
  *
@@ -2561,4 +2584,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, 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 };
+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_MAX_FLEET_SPAWNS, 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, HARD_MAX_SPAWN_DEPTH, 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, MAX_SUBAGENT_STRUCTURED_REPORT_CHARS, 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, SUBAGENT_STRUCTURED_REPORT_META_KEY, 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, formatSubagentStructuredReport, getFullPackageLog, getManifestPackages, getPackageAuthor, getPackagesByAgent, isValidMatrixKey, mailboxSessionTag, makeDependencyWatcherConfig, makeFleetStatusTool, makeMailInboxTool, makeMailSendTool, makeMailboxTool, makeSubagentResultTool, matrixKeyKind, normalizeSubagentStructuredReport, phaseForRole, readLiveLock, readSubagentStructuredReport, recordPackageAction, release, resolveImplementationModelTarget, resolveMailboxIdentity, resolveMaxSpawnDepth, resolveModelMatrix, resolveModelMatrixResolution, resolveModelTargetFromEntry, resolveSubagentModelTarget, roleNeedsIndependentReviewModel, sameModelReference, startPackageOutdatedWatcher, updatePackageOutdatedStatus, validateWatchdogOptions };