@wrongstack/core 0.73.1 → 0.82.6

package/dist/{null-fleet-bus-BCIRT_nV.d.ts → null-fleet-bus-BY0AN-sr.d.ts}

@@ -1,11 +1,11 @@
-import { c as AgentPhase, b as AgentDefinition, d as DefaultMultiAgentCoordinator, f as DispatchClassifier } from './multi-agent-coordinator-BSBbZt0e.js';
-import { F as FleetBus, r as FleetUsage, L as SubagentConfig, s as FleetUsageAggregator, X as TaskResult, o as CoordinatorStatus, Y as TaskSpec, u as MultiAgentConfig, U as SubagentRunner } from './agent-subagent-runner-BmITbs1Q.js';
-import { B as SessionWriter, Q as Tool, y as SessionStore } from './context-y87Jc5ei.js';
+import { c as AgentPhase, b as AgentDefinition, d as DefaultMultiAgentCoordinator, f as DispatchClassifier } from './multi-agent-coordinator-DllpCVkF.js';
+import { F as FleetBus, r as FleetUsage, L as SubagentConfig, s as FleetUsageAggregator, X as TaskResult, o as CoordinatorStatus, Y as TaskSpec, u as MultiAgentConfig, U as SubagentRunner } from './agent-subagent-runner-2Aq0jOSj.js';
+import { B as SessionWriter, Q as Tool, y as SessionStore } from './context-ToHAp4-U.js';
+import { B as BrainArbiter, E as EventBus } from './events-DnRqXaZ3.js';
 import { EventEmitter } from 'node:events';
-import { B as BrainArbiter, E as EventBus } from './events-BBAlxBuw.js';
-import { a as DirectorStateSnapshot } from './director-state-BmYi3DGA.js';
-import { r as ModelMatrixEntry } from './config-Dy0CK_o6.js';
-import { I as InMemoryAgentBridge } from './agent-bridge-C0Ze7Ldm.js';
+import { a as DirectorStateSnapshot } from './director-state-CgIc30qi.js';
+import { r as ModelMatrixEntry } from './config-_DZ7dN-T.js';
+import { I as InMemoryAgentBridge } from './agent-bridge-C9P_HPez.js';
 
 /**
  * Agent catalog aggregator.
@@ -51,13 +51,13 @@ interface DirectorAlert {
     /** Human-readable message for UI/logs */
     message: string;
     /** Budget kind that triggered this alert, if any */
-    budgetKind?: 'timeout' | 'idle_timeout' | 'iterations' | 'tool_calls' | 'tokens' | 'cost';
+    budgetKind?: 'timeout' | 'idle_timeout' | 'iterations' | 'tool_calls' | 'tokens' | 'cost' | undefined;
     /** Elapsed ms at time of alert */
-    elapsedMs?: number;
+    elapsedMs?: number | undefined;
     /** Limit that was hit */
-    limit?: number;
+    limit?: number | undefined;
     /** /btw notes the director has collected (may be empty) */
-    btwNotes?: string[];
+    btwNotes?: string[] | undefined;
 }
 /**
  * Immutable snapshot of target files at the start of a collab session.
@@ -71,7 +71,7 @@ interface SharedFileSnapshot {
 interface SharedFileEntry {
     path: string;
     content: string;
-    language?: string;
+    language?: string | undefined;
 }
 /**
  * Bug finding emitted by BugHunter and consumed by RefactorPlanner + Critic.
@@ -85,7 +85,7 @@ interface BugFinding {
         line: number;
     };
     description: string;
-    suggestedFix?: string;
+    suggestedFix?: string | undefined;
 }
 /**
  * Refactoring plan emitted by RefactorPlanner, consuming BugFinding(s).
@@ -121,7 +121,7 @@ interface CriticEvaluation {
 interface CriticConcern {
     description: string;
     location?: {
-        file: string;
+        file: string | undefined;
         line: number;
     };
     severity: 'blocking' | 'advisory';
@@ -175,7 +175,7 @@ interface CollabBudgetWarningPayload {
     kind: 'timeout' | 'idle_timeout' | 'iterations' | 'tool_calls' | 'tokens' | 'cost';
     used: number;
     limit: number;
-    timeoutMs?: number;
+    timeoutMs?: number | undefined;
     elapsedMs: number;
 }
 /**
@@ -191,29 +191,29 @@ interface CollabSessionOptions {
     /** Paths to scan — used to build the SharedFileSnapshot. */
     targetPaths: string[];
     /** Files already read and snapshot. When provided, snapshot is skipped. */
-    prebuiltSnapshot?: SharedFileSnapshot;
+    prebuiltSnapshot?: SharedFileSnapshot | undefined;
     /** Max time to wait for the session to resolve (ms). Default: 10 min. */
-    timeoutMs?: number;
+    timeoutMs?: number | undefined;
     /**
      * Maximum number of files to include in the snapshot.
      * - If set explicitly: use this value (hard override).
      * - If `contextWindow` is set: calculate dynamically from estimated token budget.
      * - If neither: use `DEFAULT_MAX_TARGET_FILES` (30).
      */
-    maxTargetFiles?: number;
+    maxTargetFiles?: number | undefined;
     /**
      * Context window size (in tokens) of the model running the subagents.
      * When provided and `maxTargetFiles` is not set, the limit is computed
      * dynamically: `floor((contextWindow * 0.4) / AVG_TOKENS_PER_FILE)`.
      * If not provided, `DEFAULT_MAX_TARGET_FILES` is used as the fallback.
      */
-    contextWindow?: number;
+    contextWindow?: number | undefined;
     /**
      * Budget overrides per role. When provided, these override the hard-coded
      * defaults so the Director can enforce fleet-wide budget policy.
      * Keys must match role names: 'bug-hunter', 'refactor-planner', 'critic'.
      */
-    budgetOverrides?: CollabBudgetOverrides;
+    budgetOverrides?: CollabBudgetOverrides | undefined;
     /**
      * Called by the Director when a collab agent hits a soft budget limit.
      * The Director uses this to decide whether to cancel the session or extend.
@@ -221,7 +221,7 @@ interface CollabSessionOptions {
      * with the agent's proposed new limits; 'ignore' to let the default
      * auto-extend logic handle it.
      */
-    onBudgetWarning?: (alert: DirectorAlert) => 'cancel' | 'extend' | 'ignore';
+    onBudgetWarning?: (((alert: DirectorAlert) => 'cancel' | 'extend' | 'ignore')) | undefined;
 }
 declare class CollabSession extends EventEmitter {
     readonly sessionId: string;
@@ -306,9 +306,9 @@ interface IFleetManager {
      * Returns undefined if the subagent is not known to this manager.
      */
     getSubagentMeta(id: string): {
-        provider?: string;
-        model?: string;
-        name?: string;
+        provider?: string | undefined;
+        model?: string | undefined;
+        name?: string | undefined;
     } | undefined;
     /**
      * Called before a spawn is recorded. Returns a reason string if the
@@ -376,7 +376,7 @@ interface IFleetManager {
         live: {
             subagentId: string;
             status: string;
-            task?: string;
+            task?: string | undefined;
         }[];
     };
     /**
@@ -443,18 +443,18 @@ interface IFleetManager {
 
 /** Options for constructing a FleetManager. */
 interface FleetManagerOptions {
-    manifestPath?: string;
-    sessionsRoot?: string;
-    directorRunId?: string;
-    maxSpawns?: number;
-    maxSpawnDepth?: number;
-    spawnDepth?: number;
-    stateCheckpointPath?: string;
-    sessionWriter?: SessionWriter;
-    manifestDebounceMs?: number;
-    checkpointDebounceMs?: number;
+    manifestPath?: string | undefined;
+    sessionsRoot?: string | undefined;
+    directorRunId?: string | undefined;
+    maxSpawns?: number | undefined;
+    maxSpawnDepth?: number | undefined;
+    spawnDepth?: number | undefined;
+    stateCheckpointPath?: string | undefined;
+    sessionWriter?: SessionWriter | undefined;
+    manifestDebounceMs?: number | undefined;
+    checkpointDebounceMs?: number | undefined;
     directorBudget?: {
-        maxCostUsd?: number;
+        maxCostUsd?: number | undefined;
     };
     /**
      * Maximum context load (as a fraction of maxContext) the leader agent
@@ -463,7 +463,7 @@ interface FleetManagerOptions {
      * a new subagent is refused — the leader must compact first.
      * Set to 1.0 to disable this check.
      */
-    maxLeaderContextLoad?: number;
+    maxLeaderContextLoad?: number | undefined;
     /**
      * Provider's max context window in tokens. Used with `maxLeaderContextLoad`
      * to compute the absolute token threshold. Default: 128_000.
@@ -541,9 +541,9 @@ declare class FleetManager implements IFleetManager {
     setCoordinator(coordinator: DefaultMultiAgentCoordinator): void;
     snapshot(): FleetUsage;
     getSubagentMeta(id: string): {
-        provider?: string;
-        model?: string;
-        name?: string;
+        provider?: string | undefined;
+        model?: string | undefined;
+        name?: string | undefined;
     } | undefined;
     /**
      * Returns null if the spawn is allowed, or an object describing
@@ -586,10 +586,10 @@ declare class FleetManager implements IFleetManager {
      * @param priceLookup Optional per-subagent pricing data
      */
     recordSpawn(subagentId: string, config: SubagentConfig, priceLookup?: {
-        input?: number;
-        output?: number;
-        cacheRead?: number;
-        cacheWrite?: number;
+        input?: number | undefined;
+        output?: number | undefined;
+        cacheRead?: number | undefined;
+        cacheWrite?: number | undefined;
     }): void;
     writeManifest(): Promise<string | null>;
     /**
@@ -636,7 +636,7 @@ declare class FleetManager implements IFleetManager {
         live: {
             subagentId: string;
             status: string;
-            task?: string;
+            task?: string | undefined;
         }[];
     };
     /**
@@ -688,7 +688,7 @@ interface ICoordinator {
     assign(task: {
         id: string;
         description: string;
-        subagentId?: string;
+        subagentId?: string | undefined;
     }): Promise<string>;
     /**
      * Synchronously ask a subagent something via the in-memory bridge.
@@ -697,7 +697,7 @@ interface ICoordinator {
      *
      * Only available in director mode — raw coordinator has no bridge.
      */
-    ask<T = unknown>(subagentId: string, payload: unknown, timeoutMs?: number): Promise<T>;
+    ask<T = unknown>(subagentId: string, payload: unknown, timeoutMs?: number): Promise<T> | undefined;
     /**
      * Wait for one or more tasks to complete and return their results.
      * If a task is already done when called, returns immediately.
@@ -757,7 +757,7 @@ declare class LargeAnswerStore {
      * If the value is below sizeThreshold, returns it as-is (no store entry).
      */
     storeAnswer(value: unknown): {
-        key?: string;
+        key?: string | undefined;
         summary: string;
         inline: boolean;
     };
@@ -786,7 +786,7 @@ declare class FleetSpawnBudgetError extends Error {
     readonly kind: 'max_spawns' | 'max_spawn_depth';
     readonly limit: number;
     readonly observed: number;
-    constructor(kind: 'max_spawns' | 'max_spawn_depth', limit: number, observed: number, message?: string);
+    constructor(kind: 'max_spawns' | 'max_spawn_depth', limit: number, observed: number, message?: string | undefined);
 }
 declare class FleetCostCapError extends Error {
     readonly kind: 'max_cost_usd';
@@ -810,9 +810,9 @@ declare class FleetCostCapError extends Error {
  */
 interface DirectorOptions {
     config: MultiAgentConfig;
-    runner?: SubagentRunner;
+    runner?: SubagentRunner | undefined;
     /** Optional Brain arbiter above the director for policy/decision escalation. */
-    brain?: BrainArbiter;
+    brain?: BrainArbiter | undefined;
     /**
      * When set, the director writes a `fleet.json` manifest to this path
      * recording every spawned subagent (id, provider, model, role, task
@@ -820,7 +820,7 @@ interface DirectorOptions {
      * absolute file path — the directory must already exist (the
      * director-session factory creates it when used together).
      */
-    manifestPath?: string;
+    manifestPath?: string | undefined;
     /**
      * Optional roster used by `leaderSystemPrompt()` to render a roles
      * summary into the leader's preamble. Same shape as the roster passed
@@ -831,12 +831,12 @@ interface DirectorOptions {
      * Override the built-in fleet preamble (see `DEFAULT_DIRECTOR_PREAMBLE`).
      * Pass an empty string to suppress the preamble entirely.
      */
-    directorPreamble?: string;
+    directorPreamble?: string | undefined;
     /**
      * Override the built-in subagent baseline (see
      * `DEFAULT_SUBAGENT_BASELINE`). Pass an empty string to suppress.
      */
-    subagentBaseline?: string;
+    subagentBaseline?: string | undefined;
     /**
      * Absolute path to a directory the fleet can use as a shared scratchpad
      * (read + write by every subagent). When set, the director creates it on
@@ -848,7 +848,7 @@ interface DirectorOptions {
      * Convention: under a fleet run rooted at `<sessionsRoot>/<runId>/`,
      * pass `<sessionsRoot>/<runId>/shared/` here.
      */
-    sharedScratchpadPath?: string;
+    sharedScratchpadPath?: string | undefined;
     /**
      * Maximum number of spawns this director can perform across its
      * lifetime. Default: unlimited. Acts as a hard fleet-wide cost cap —
@@ -856,7 +856,7 @@ interface DirectorOptions {
      * instead of burning provider tokens until the user kills the
      * process. The N+1-th spawn call rejects with a `FleetSpawnBudgetError`.
      */
-    maxSpawns?: number;
+    maxSpawns?: number | undefined;
     /**
      * Maximum nesting depth for spawns. The director constructed by the
      * user is at depth `spawnDepth` (default 0); any subagent that itself
@@ -867,13 +867,13 @@ interface DirectorOptions {
      * This stops infinite recursive director chains from a hostile or
      * confused prompt.
      */
-    maxSpawnDepth?: number;
+    maxSpawnDepth?: number | undefined;
     /**
      * Current spawn-chain depth for this director instance. Defaults to 0.
      * A nested director should pass `parent.spawnDepth + 1`. Together with
      * `maxSpawnDepth` this bounds the chain.
      */
-    spawnDepth?: number;
+    spawnDepth?: number | undefined;
     /**
      * Absolute path to a director-state checkpoint file. When set, the
      * director writes an incremental snapshot of pending/running/completed
@@ -882,7 +882,7 @@ interface DirectorOptions {
      * the checkpoint is a live mirror useful for crash recovery and the
      * `wstack resume` "you had N tasks in flight" banner.
      */
-    stateCheckpointPath?: string;
+    stateCheckpointPath?: string | undefined;
     /**
      * Session writer the director should forward task lifecycle events to
      * (`agent_spawned`, `task_created`, `task_completed`, `task_failed`).
@@ -890,13 +890,13 @@ interface DirectorOptions {
      * lossy in production. Production callers (the CLI) pass the same
      * writer the host Agent uses so all events land in a single JSONL.
      */
-    sessionWriter?: SessionWriter;
+    sessionWriter?: SessionWriter | undefined;
     /**
      * Debounce window for periodic manifest writes triggered by spawn/
      * assign/complete events. Default: 2000ms. Pass 0 to disable periodic
      * writes (the manifest will then only be written on `shutdown()`).
      */
-    manifestDebounceMs?: number;
+    manifestDebounceMs?: number | undefined;
     /**
      * Fleet-wide cost ceiling. When set, `spawn()` refuses any new subagent
      * that would push the fleet's total cost above this limit. The cap
@@ -913,8 +913,8 @@ interface DirectorOptions {
          * Maximum total USD the fleet may spend across all subagents.
          * Default: Infinity (no cap).
          */
-        maxCostUsd?: number;
-    };
+        maxCostUsd?: number | undefined;
+    } | undefined;
     /**
      * Maximum auto-extensions per subagent per budget kind before the
      * director denies further extensions. A subagent hitting the same
@@ -924,7 +924,7 @@ interface DirectorOptions {
      * disable the cap (use with caution — a misconfigured subagent
      * could burn unlimited budget).
      */
-    maxBudgetExtensions?: number;
+    maxBudgetExtensions?: number | undefined;
     /**
      * Debounce window for state-checkpoint writes. Default: 250ms.
      * Bursts of spawn/assign/complete events collapse into one disk
@@ -932,19 +932,19 @@ interface DirectorOptions {
      * lower values improve crash-recovery fidelity (less state lost
      * on sudden process exit).
      */
-    checkpointDebounceMs?: number;
+    checkpointDebounceMs?: number | undefined;
     /**
      * Sessions root directory for per-subagent JSONL transcripts.
      * When set, the director can read subagent transcripts directly for
      * `fleet_session` tool — no bridge round-trip needed. Path convention:
      * `<sessionsRoot>/<directorRunId>/<subagentId>.jsonl`.
      */
-    sessionsRoot?: string;
+    sessionsRoot?: string | undefined;
     /**
      * Director run id — namespaced under `sessionsRoot` to locate per-subagent
      * JSONLs. Defaults to the director's own `id` when omitted.
      */
-    directorRunId?: string;
+    directorRunId?: string | undefined;
     /**
      * Pre-built fleet manager. When provided the Director delegates all
      * fleet-level policy (spawn budgets, manifest assembly, checkpointing)
@@ -955,7 +955,7 @@ interface DirectorOptions {
      * When omitted the Director creates its own fleet infrastructure
      * (same behavior as before this field was added).
      */
-    fleetManager?: FleetManager;
+    fleetManager?: FleetManager | undefined;
     /**
      * Optional LLM classifier for the smart dispatcher. When set, the
      * `spawn_subagent` tool can accept a free-form `description` field
@@ -966,7 +966,7 @@ interface DirectorOptions {
      * Build from a `complete(prompt) => string` function using
      * `makeLLMClassifier(complete)` from the dispatcher module.
      */
-    dispatchClassifier?: DispatchClassifier;
+    dispatchClassifier?: DispatchClassifier | undefined;
     /**
      * Maximum context load (as a fraction of maxContext) the leader agent
      * is allowed to reach before a new spawn is rejected. Default: 0.85.
@@ -975,7 +975,7 @@ interface DirectorOptions {
      * Only used when no `fleetManager` is provided (inline mode).
      * Set to 1.0 to disable this check.
      */
-    maxLeaderContextLoad?: number;
+    maxLeaderContextLoad?: number | undefined;
     /**
      * Provider's max context window in tokens. Used with `maxLeaderContextLoad`
      * to compute the absolute token threshold. Default: 128_000.
@@ -997,7 +997,7 @@ interface DirectorOptions {
      * mid-session `/setmodel` takes effect on the next spawn. A static record
      * is also accepted for tests and one-shot runs.
      */
-    modelMatrix?: ModelMatrixSource;
+    modelMatrix?: ModelMatrixSource | undefined;
 }
 /** Either a static matrix or a live getter (re-read on every spawn). */
 type ModelMatrixSource = Record<string, ModelMatrixEntry> | (() => Record<string, ModelMatrixEntry> | undefined);
@@ -1119,7 +1119,7 @@ declare class Director implements ICoordinator {
      */
     private taskCompletedListener;
     /** Optional LLM classifier for smart dispatch. Passed from options. */
-    readonly dispatchClassifier?: DispatchClassifier;
+    readonly dispatchClassifier?: DispatchClassifier | undefined;
     /** Leader agent's current context pressure (full request tokens). */
     private leaderContextPressure;
     /** Maximum context load fraction before spawn is refused. */
@@ -1237,10 +1237,10 @@ declare class Director implements ICoordinator {
      * it the `cost` column in `usage.snapshot()` stays at 0.
      */
     spawn(config: SubagentConfig, priceLookup?: {
-        input?: number;
-        output?: number;
-        cacheRead?: number;
-        cacheWrite?: number;
+        input?: number | undefined;
+        output?: number | undefined;
+        cacheRead?: number | undefined;
+        cacheWrite?: number | undefined;
     }): Promise<string>;
     /**
      * Synchronously ask a subagent something via the bridge. Sends a
@@ -1342,12 +1342,12 @@ declare class Director implements ICoordinator {
      * tool-use count, and line count — or null if the file is unavailable.
      * Requires `sessionsRoot` to be set on construction.
      */
-    readSession(subagentId: string, tail?: number): Promise<{
-        lastAssistantText?: string;
-        lastStopReason?: string;
+    readSession(subagentId: string, tail?: number | undefined): Promise<{
+        lastAssistantText?: string | undefined;
+        lastStopReason?: string | undefined;
         toolUsesObserved: number;
         events: number;
-        path?: string;
+        path?: string | undefined;
     } | null>;
     snapshot(): FleetUsage;
     /**
@@ -1358,9 +1358,9 @@ declare class Director implements ICoordinator {
      * subagent row without reaching into private state.
      */
     getSubagentMeta(id: string): {
-        provider?: string;
-        model?: string;
-        name?: string;
+        provider?: string | undefined;
+        model?: string | undefined;
+        name?: string | undefined;
     } | undefined;
     /**
      * Compose the leader/director-agent system prompt: fleet preamble +
@@ -1524,7 +1524,7 @@ interface CreateDelegateToolOptions {
      * without being killed for being slow — the orchestrator must
      * decide per-call when a task needs to be cut short.
      */
-    defaultTimeoutMs?: number;
+    defaultTimeoutMs?: number | undefined;
     /**
      * Absolute directory under which per-subagent JSONL transcripts live —
      * matches `MultiAgentHostOptions.sessionsRoot`. When set, the delegate
@@ -1532,13 +1532,13 @@ interface CreateDelegateToolOptions {
      * to extract partial output, so the host LLM gets *something* useful
      * back instead of just an error.
      */
-    sessionsRoot?: string;
+    sessionsRoot?: string | undefined;
     /**
      * The directorRunId used to namespace transcripts (typically the host
      * session id). Combined with `sessionsRoot` to locate per-subagent
      * JSONLs at `<sessionsRoot>/<runId>/<subagentId>.jsonl`.
      */
-    directorRunId?: string;
+    directorRunId?: string | undefined;
     /**
      * Buffer subtracted from the caller's `timeoutMs` before passing it
      * to the subagent. Gives the host a window to detect a subagent that
@@ -1546,7 +1546,16 @@ interface CreateDelegateToolOptions {
      * timeout. Default: 60_000 ms (raised from 30s to give subagents
      * more headroom before the host kills them).
      */
-    subagentTimeoutBufferMs?: number;
+    subagentTimeoutBufferMs?: number | undefined;
+    /**
+     * Host EventBus. When supplied, `delegate` emits `delegate.started`
+     * (before it blocks on the subagent) and `delegate.completed` (once the
+     * subagent settles) so UIs / the Telegram bridge can render readable
+     * start/finish lines instead of inferring them from the truncated
+     * `tool.executed` JSON preview. Optional — emits are best-effort and a
+     * missing bus never affects delegation behaviour.
+     */
+    events?: EventBus | undefined;
 }
 /**
  * `delegate` — the only multi-agent tool a regular (non-director) agent
@@ -1591,14 +1600,14 @@ interface DirectorSessionFactoryOptions {
      * director run directory. Tests pass an in-memory store for isolation;
      * production code passes the path under `~/.wrongstack/sessions/`.
      */
-    store?: SessionStore;
-    sessionsRoot?: string;
+    store?: SessionStore | undefined;
+    sessionsRoot?: string | undefined;
     /**
      * Director run id — namespaces all subagent JSONLs under one folder.
      * Defaults to a timestamped id; supplied explicitly when resuming a
      * prior fleet manifest.
      */
-    directorRunId?: string;
+    directorRunId?: string | undefined;
 }
 interface DirectorSessionFactory {
     /** Absolute directory where this director run's transcripts live. */
@@ -1612,9 +1621,9 @@ interface DirectorSessionFactory {
      */
     createSubagentSession(args: {
         subagentId: string;
-        provider?: string;
-        model?: string;
-        title?: string;
+        provider?: string | undefined;
+        model?: string | undefined;
+        title?: string | undefined;
     }): Promise<SessionWriter>;
 }
 /**
@@ -1667,13 +1676,13 @@ declare const DEFAULT_SUBAGENT_BASELINE = "You are a subagent operating under a
 interface DirectorPromptParts {
     /** The user's existing leader system prompt — typically what was passed
      *  via `MultiAgentConfig.leaderSystemPrompt`. */
-    basePrompt?: string;
+    basePrompt?: string | undefined;
     /** Override the built-in fleet preamble. Pass empty string to suppress. */
-    directorPreamble?: string;
+    directorPreamble?: string | undefined;
     /** Optional roster summary block — a short list of pre-configured roles
      *  the director can spawn (e.g. "researcher, coder, reviewer"). Helps
      *  small models discover the available shapes without scanning tools. */
-    rosterSummary?: string;
+    rosterSummary?: string | undefined;
 }
 /**
  * Compose the leader/director's system prompt. Order:
@@ -1690,13 +1699,13 @@ declare function composeDirectorPrompt(parts?: DirectorPromptParts): string;
 interface SubagentPromptParts {
     /** Base persona/identity for *every* subagent. Defaults to the bridge
      *  contract baseline. Pass empty string to suppress. */
-    baseline?: string;
+    baseline?: string | undefined;
     /** Role-specific block, e.g. "You are a code reviewer. Focus on…". */
-    role?: string;
+    role?: string | undefined;
     /** Task brief — usually the same string the runner passes as user input,
      *  but exposed here in case the factory wants it duplicated in the
      *  system prompt for reinforcement. */
-    task?: string;
+    task?: string | undefined;
     /**
      * Absolute path to a shared scratchpad directory the whole fleet can
      * read/write. When set, the composer adds a "Shared notes" block that
@@ -1706,18 +1715,18 @@ interface SubagentPromptParts {
      * conclusions. Falls between `task` and `override` so the override
      * can still narrow or replace it.
      */
-    sharedScratchpad?: string;
+    sharedScratchpad?: string | undefined;
     /**
      * Optional skill body content injected into the subagent's system prompt.
      * Use this to provide domain-specific knowledge (SKILL.md bodies) to
      * subagents that need it. Placed after `sharedScratchpad` and before
      * `override` so the override can still narrow or replace it.
      */
-    skills?: string;
+    skills?: string | undefined;
     /** Final per-spawn override from `SubagentConfig.systemPromptOverride`.
      *  Added last so it wins on conflict — that's by design: the spawn site
      *  knows the most about what this specific subagent should do. */
-    override?: string;
+    override?: string | undefined;
 }
 /**
  * Compose a subagent's system prompt. Order:
@@ -1749,10 +1758,10 @@ declare function composeSubagentPrompt(parts?: SubagentPromptParts): string;
  */
 declare function rosterSummaryFromConfigs(roster: Record<string, {
     name: string;
-    provider?: string;
-    model?: string;
-    prompt?: string;
-    role?: string;
+    provider?: string | undefined;
+    model?: string | undefined;
+    prompt?: string | undefined;
+    role?: string | undefined;
 }>): string;
 
 /**
@@ -1789,13 +1798,13 @@ declare const SECURITY_SCANNER_AGENT: SubagentConfig;
  */
 declare const FLEET_ROSTER: Record<string, SubagentConfig>;
 interface FleetRosterBudget {
-    timeoutMs?: number;
+    timeoutMs?: number | undefined;
     /** Idle reap window (ms). Resets on activity — see `applyRosterBudget`. */
-    idleTimeoutMs?: number;
-    maxIterations?: number;
-    maxToolCalls?: number;
-    maxTokens?: number;
-    maxCostUsd?: number;
+    idleTimeoutMs?: number | undefined;
+    maxIterations?: number | undefined;
+    maxToolCalls?: number | undefined;
+    maxTokens?: number | undefined;
+    maxCostUsd?: number | undefined;
 }
 declare const FLEET_ROSTER_BUDGETS: Record<string, FleetRosterBudget>;
 declare function applyRosterBudget(cfg: SubagentConfig): SubagentConfig;
@@ -1828,23 +1837,23 @@ declare const FLEET_ROSTER_WITHACP: Record<string, SubagentConfig>;
  */
 
 interface AutoExtendCeiling {
-    maxIterations?: number;
-    maxToolCalls?: number;
-    maxTokens?: number;
-    maxCostUsd?: number;
-    timeoutMs?: number;
+    maxIterations?: number | undefined;
+    maxToolCalls?: number | undefined;
+    maxTokens?: number | undefined;
+    maxCostUsd?: number | undefined;
+    timeoutMs?: number | undefined;
 }
 interface AutoExtendPolicy {
     /** Multiplier applied to the tripped limit when extending. Default 0.5 (+50%). */
-    factor?: number;
+    factor?: number | undefined;
     /**
      * Max extensions per NON-timeout kind before denying. Timeout is governed by
      * the heartbeat check, not this cap, so it can extend indefinitely while the
      * agent makes progress. Default 8.
      */
-    maxExtensionsPerKind?: number;
+    maxExtensionsPerKind?: number | undefined;
     /** Absolute ceilings — an extension never pushes a limit past these. */
-    ceiling?: AutoExtendCeiling;
+    ceiling?: AutoExtendCeiling | undefined;
 }
 /**
  * Attach an auto-extend policy to a subagent's EventBus. Returns an unsubscribe