@wrongstack/core 0.264.0 → 0.267.0

package/dist/{context-BGSpZNSE.d.ts → context-dT5Ueund.d.ts}

@@ -309,6 +309,11 @@ type Permission = 'auto' | 'confirm' | 'deny';
  * - `destructive` — irreversible or broadside effects (recursive deletes, db drops, etc.)
  */
 type RiskTier = 'safe' | 'standard' | 'destructive';
+/**
+ * Icon identifiers for tools — each UI (WebUI/TUI/REPL) maps these to its own icon library.
+ * Add the icon directly on each Tool so all UIs consume the same canonical value.
+ */
+type ToolIconId = 'file' | 'edit' | 'search' | 'folder' | 'terminal' | 'web' | 'git' | 'tree' | 'code' | 'test' | 'package' | 'document' | 'scaffold' | 'todo' | 'plan' | 'task' | 'meta' | 'index' | 'json' | 'diff' | 'logs' | 'settings' | 'fallback';
 interface JSONSchema {
     type?: string | undefined;
     properties?: Record<string, JSONSchema>;
@@ -405,6 +410,12 @@ interface Tool<I = unknown, O = unknown> {
      * treated conservatively by guards.
      */
     capabilities?: readonly string[] | undefined;
+    /**
+     * Icon identifier for this tool — consumed by all UIs (WebUI/TUI/REPL) to
+     * render a tool-specific icon instead of a generic fallback.
+     * Each UI maps this id to its own icon library.
+     */
+    icon?: ToolIconId | undefined;
     execute(input: I, ctx: Context, opts: {
         signal: AbortSignal;
     }): Promise<O>;
@@ -764,6 +775,21 @@ type SessionEvent = {
         phase: string;
         saved: number;
     }>;
+    /** Context budget snapshot used to trigger this compaction. */
+    budget?: {
+        maxContext: number;
+        inputTokens: number;
+        availableInputTokens: number;
+        remainingInputTokens: number;
+        reservedOutputTokens: number;
+        reservedSafetyTokens: number;
+        load: number;
+        overflowTokens: number;
+    } | undefined;
+    /** Adaptive trigger signals observed alongside token pressure. */
+    signals?: {
+        repeatedReadCount?: number | undefined;
+    } | undefined;
     /**
      * Lossless digest of the range collapsed during this compaction (text
      * content preserved; raw tool I/O omitted). Captures *what* was collapsed
@@ -1104,6 +1130,54 @@ interface SessionWriter {
     clearInFlightMarker(reason: 'clean' | 'aborted' | 'recovered'): Promise<void>;
 }
 
+type ToolEvidenceStatus = 'seen' | 'referenced';
+interface ToolOutputMetadata {
+    toolUseId: string;
+    toolName: string;
+    ok: boolean;
+    inputSummary?: string | undefined;
+    summary: string;
+    files: string[];
+    symbols: string[];
+    commands: string[];
+    errors: string[];
+    status: ToolEvidenceStatus;
+    referenceCount: number;
+    seenAt: number;
+    referencedAt?: number | undefined;
+    outputBytes?: number | undefined;
+    outputTokens?: number | undefined;
+    outputLines?: number | undefined;
+}
+interface ContextFileEvidence {
+    path: string;
+    reads: number;
+    writes: number;
+    tools: string[];
+    referenced: boolean;
+    lastToolUseId?: string | undefined;
+}
+interface ContextIntentEvidence {
+    text: string;
+    updatedAt: number;
+}
+interface ContextRepeatedReadEvidence {
+    file: string;
+    count: number;
+    lastToolUseId: string;
+}
+interface ContextEvidenceState {
+    currentIntent?: ContextIntentEvidence | undefined;
+    sessionGoals: string[];
+    implicitFacts: string[];
+    activeErrors: string[];
+    toolCalls: ToolOutputMetadata[];
+    fileGraph: Record<string, ContextFileEvidence>;
+    repeatedReads: ContextRepeatedReadEvidence[];
+    lastReadPath?: string | undefined;
+    updatedAt: number;
+}
+
 interface CacheStats {
     /** Tokens served from cache (cheaper). */
     readTokens: number;
@@ -1285,6 +1359,13 @@ interface ContextInit {
     projectRoot: string;
     /** Mutable working directory. Defaults to `cwd`. Must stay within `projectRoot`. */
     workingDir?: string | undefined;
+    /**
+     * When false, file tools and `setWorkingDir()` are confined to `projectRoot`.
+     * Defaults to `false` (restrictive) when omitted so directly-constructed
+     * contexts (tests, embedded callers) keep the safe behavior; the runtime
+     * passes the config-derived value (default `true` — permissive) explicitly.
+     */
+    allowOutsideProjectRoot?: boolean | undefined;
     model: string;
     tools?: Tool[] | undefined;
     /** Agent id performing this run (e.g. 'leader', 'executor', 'tech-stack'). */
@@ -1299,12 +1380,6 @@ interface ContextInit {
      * `session.traceId` automatically.
      */
     traceId?: string | undefined;
-    /**
-     * Allow tools to read/write paths outside the project root directory.
-     * When true, tools can access any path on the filesystem.
-     * When false or undefined, tools are restricted to the project root.
-     */
-    allowOutsideProjectRoot?: boolean | undefined;
 }
 /**
  * L1-A: `Context` is the live agent-run object. Its read-only environment
@@ -1328,6 +1403,7 @@ declare class Context implements RunEnv {
     todos: TodoItem[];
     readFiles: Set<string>;
     fileMtimes: Map<string, number>;
+    contextEvidence: ContextEvidenceState;
     systemPrompt: TextBlock[];
     provider: Provider;
     session: SessionWriter;
@@ -1337,6 +1413,13 @@ declare class Context implements RunEnv {
     projectRoot: string;
     /** Mutable working directory — starts as `cwd`. Change via `setWorkingDir()`. */
     workingDir: string;
+    /**
+     * When true, file tools (via `_util.ts`) and `setWorkingDir()` reject paths
+     * outside `projectRoot`. When false, those boundary checks are bypassed so
+     * tools may reach paths outside the project (still gated by permission
+     * tiers). Mutable so `/settings` can toggle it live on the running session.
+     */
+    allowOutsideProjectRoot: boolean;
     model: string;
     tools: Tool[];
     meta: Record<string, unknown>;
@@ -1350,11 +1433,6 @@ declare class Context implements RunEnv {
      * so storage operations can include it in `storage.*` events.
      */
     traceId: string | undefined;
-    /**
-     * When true, tools can access any path on the filesystem.
-     * When false or undefined, tools are restricted to the project root.
-     */
-    allowOutsideProjectRoot: boolean;
     /** Callbacks fired when `setWorkingDir()` changes the working directory. */
     private _onWorkingDirChanged;
     /**
@@ -1425,4 +1503,4 @@ declare class Context implements RunEnv {
     usage(): Usage;
 }
 
-export { ToolError as $, AgentError as A, type MessageRole as B, Context as C, PluginError as D, ERROR_CODES as E, type FileSnapshot as F, type ProviderErrorBody as G, type ReadonlyConversationState as H, type ImageBlock as I, type JSONSchema as J, type RiskTier as K, type RunEnv as L, type Message as M, SddError as N, SessionError as O, type Provider as P, type StateChange as Q, type Request as R, type SessionEvent as S, type Tool as T, type Usage as U, type StateChangeHandler as V, type StopReason as W, type StreamEvent as X, StreamHangError as Y, type ThinkingBlock as Z, type ToolCallContext as _, type SessionWriter as a, type ToolFinalEvent as a0, type ToolStreamEvent as a1, WrongStackError as a2, asBlocks as a3, asText as a4, extractRunEnv as a5, isAgentError as a6, isConfigError as a7, isFsError as a8, isImageBlock as a9, isPluginError as aa, isSddError as ab, isSessionError as ac, isTextBlock as ad, isThinkingBlock as ae, isToolError as af, isToolResultBlock as ag, isToolUseBlock as ah, isWrongStackError as ai, toWrongStackError as aj, wrapAsState as ak, type Response as b, type TokenCounter as c, type CacheStats as d, ProviderError as e, type Permission as f, type ContentBlock as g, type SessionMetadata as h, type SessionStore as i, type ToolProgressEvent as j, type Capabilities as k, type ToolUseBlock as l, type ToolResultBlock as m, type TextBlock as n, type RunOptions as o, type ResumedSession as p, type SessionData as q, type SessionSummary as r, type TodoItem as s, ConversationState as t, ConfigError as u, type ContextInit as v, type ErrorCode as w, type ErrorSeverity as x, type ErrorSubsystem as y, FsError as z };
+export { type StopReason as $, AgentError as A, type ContextRepeatedReadEvidence as B, Context as C, type ErrorCode as D, ERROR_CODES as E, type ErrorSeverity as F, type ErrorSubsystem as G, type FileSnapshot as H, FsError as I, type JSONSchema as J, type ImageBlock as K, type MessageRole as L, type Message as M, PluginError as N, type ProviderErrorBody as O, type Provider as P, type ReadonlyConversationState as Q, type Request as R, type SessionEvent as S, type Tool as T, type Usage as U, type RiskTier as V, type RunEnv as W, SddError as X, SessionError as Y, type StateChange as Z, type StateChangeHandler as _, type SessionWriter as a, type StreamEvent as a0, StreamHangError as a1, type ThinkingBlock as a2, type ToolCallContext as a3, ToolError as a4, type ToolEvidenceStatus as a5, type ToolFinalEvent as a6, type ToolIconId as a7, type ToolStreamEvent as a8, WrongStackError as a9, asBlocks as aa, asText as ab, extractRunEnv as ac, isAgentError as ad, isConfigError as ae, isFsError as af, isImageBlock as ag, isPluginError as ah, isSddError as ai, isSessionError as aj, isTextBlock as ak, isThinkingBlock as al, isToolError as am, isToolResultBlock as an, isToolUseBlock as ao, isWrongStackError as ap, toWrongStackError as aq, wrapAsState as ar, type Response as b, type TokenCounter as c, type CacheStats as d, ProviderError as e, type Permission as f, type ContentBlock as g, type SessionMetadata as h, type SessionStore as i, type ToolProgressEvent as j, type ToolOutputMetadata as k, type Capabilities as l, type ToolUseBlock as m, type ToolResultBlock as n, type TextBlock as o, type RunOptions as p, type ResumedSession as q, type SessionData as r, type SessionSummary as s, type TodoItem as t, ConversationState as u, ConfigError as v, type ContextEvidenceState as w, type ContextFileEvidence as x, type ContextInit as y, type ContextIntentEvidence as z };

package/dist/coordination/index.d.ts

@@ -1,23 +1,23 @@
-import { E as EventBus, B as BrainArbiter, f as BrainDecisionOption, k as BrainRisk, h as BrainDecisionRequest, e as BrainDecision, i as BrainDecisionSource } from '../brain-O1IdKPaK.js';
-export { g as BrainDecisionQueue, j as BrainFallback, D as DefaultBrainArbiter, l as DefaultBrainArbiterOptions, H as HumanEscalatingBrainArbiter, O as ObservableBrainArbiter, w as formatHumanPrompt } from '../brain-O1IdKPaK.js';
-import { H as FleetManager } from '../null-fleet-bus-DgvD4SCO.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, s as Director, 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, a8 as makeFleetSessionTool, a9 as makeFleetStatusTool, aa as makeFleetUsageTool, ab as makeRollUpTool, ac as makeSpawnTool, ad as makeTerminateTool, ae as makeWorkCompleteTool, af as rosterSummaryFromConfigs } from '../null-fleet-bus-DgvD4SCO.js';
-import { b as AgentDefinition } from '../multi-agent-coordinator-CK5Jdj9K.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-CK5Jdj9K.js';
-import { F as FleetBus } from '../agent-subagent-runner-c9DLkaas.js';
-export { h as AgentFactory, u as AgentFactoryResult, v as AgentRunnerOptions, w as BudgetExceededError, x as BudgetKind, y as BudgetLimits, z as BudgetNegotiationMode, E as BudgetThresholdDecision, G as BudgetThresholdHandler, H as BudgetThresholdSignal, I as BudgetUsage, K as FleetEvent, L as FleetHandler, i as FleetUsage, j as FleetUsageAggregator, O as SubagentBudget, X as SubagentUsageSnapshot, Z as makeAgentSubagentRunner, _ as withDisabledToolFiltering } from '../agent-subagent-runner-c9DLkaas.js';
-export { I as InMemoryAgentBridge, a as InMemoryBridgeTransport, c as createMessage } from '../agent-bridge-D8sa1vtv.js';
-import { c as Mailbox, k as MailboxSendInput, d as MailboxMessage, j as MailboxQuery, g as MailboxAckInput, s as MailboxAckBatchInput, h as MailboxAgentStatus, e as AgentRegistrationInput, A as AgentHeartbeatInput, t as PurgeOptions, u as PurgeResult, v as ClientRegistrationInput, w as ClientHeartbeatInput, x as ClientStatus } from '../pipeline-CXCeMz8J.js';
-export { i as MailboxMessageType, l as MailboxTaskContext, o as ReadReceipts, p as RegisteredAgent, r as normalizeRecipient } from '../pipeline-CXCeMz8J.js';
-import { C as Context, T as Tool } from '../context-BGSpZNSE.js';
+import { E as EventBus, B as BrainArbiter, f as BrainDecisionOption, k as BrainRisk, h as BrainDecisionRequest, e as BrainDecision, i as BrainDecisionSource } from '../brain-Cdg77tVN.js';
+export { g as BrainDecisionQueue, j as BrainFallback, D as DefaultBrainArbiter, l as DefaultBrainArbiterOptions, H as HumanEscalatingBrainArbiter, O as ObservableBrainArbiter, w as formatHumanPrompt } from '../brain-Cdg77tVN.js';
+import { H as FleetManager, s as Director } from '../null-fleet-bus-CnXa5oTH.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, a8 as makeFleetSessionTool, a9 as makeFleetStatusTool, aa as makeFleetUsageTool, ab as makeRollUpTool, ac as makeSpawnTool, ad as makeTerminateTool, ae as makeWorkCompleteTool, af as rosterSummaryFromConfigs } from '../null-fleet-bus-CnXa5oTH.js';
+import { b as AgentDefinition } from '../multi-agent-coordinator-B8R43uPz.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-B8R43uPz.js';
+import { F as FleetBus } from '../agent-subagent-runner-CzPGP3jA.js';
+export { h as AgentFactory, v as AgentFactoryResult, w as AgentRunnerOptions, x as BudgetExceededError, y as BudgetKind, z as BudgetLimits, E as BudgetNegotiationMode, G as BudgetThresholdDecision, H as BudgetThresholdHandler, I as BudgetThresholdSignal, J as BudgetUsage, L as DECISION_TIMEOUT_MS, N as FleetEvent, O as FleetHandler, i as FleetUsage, j as FleetUsageAggregator, Q as SubagentBudget, Y as SubagentUsageSnapshot, Z as TIMEOUT_PREEMPT_FRACTION, $ as makeAgentSubagentRunner, a0 as withDisabledToolFiltering } from '../agent-subagent-runner-CzPGP3jA.js';
+export { I as InMemoryAgentBridge, a as InMemoryBridgeTransport, c as createMessage } from '../agent-bridge-STJ3JwwK.js';
+import { c as Mailbox, k as MailboxSendInput, d as MailboxMessage, j as MailboxQuery, g as MailboxAckInput, s as MailboxAckBatchInput, h as MailboxAgentStatus, e as AgentRegistrationInput, A as AgentHeartbeatInput, t as PurgeOptions, u as PurgeResult, v as ClientRegistrationInput, w as ClientHeartbeatInput, x as ClientStatus } from '../pipeline-BfD2k1rT.js';
+export { i as MailboxMessageType, l as MailboxTaskContext, o as ReadReceipts, p as RegisteredAgent, r as normalizeRecipient } from '../pipeline-BfD2k1rT.js';
+import { C as Context, T as Tool } from '../context-dT5Ueund.js';
 import 'node:events';
-import '../director-state-BfeCUbmk.js';
-import '../config-Dz2F3H2K.js';
-import '../index-CbLSI66_.js';
 import '../logger-B63L5bTg.js';
+import '../director-state-BfeCUbmk.js';
+import '../config-Du3pYYln.js';
+import '../index-Bms0m4oy.js';
 import '../observability-D-HZN_mF.js';
-import '../permission-4yvGmMRB.js';
-import '../retry-policy-CFhdtRzz.js';
+import '../permission-B75JAi3-.js';
+import '../retry-policy-BilV1ujH.js';
 
 /** Phase 1 · Discovery — map the territory before any work begins. */
 declare const DISCOVERY_AGENTS: AgentDefinition[];
@@ -435,6 +435,10 @@ interface DependencyWatcherConfig {
     onChange: (entry: DepWatchEntry) => Promise<void>;
     /** Debounce window in ms — multiple changes to the same file within this window are collapsed. */
     debounceMs: number;
+    /** Cancel all in-flight debounce timers. Call when the file watcher is
+     *  stopped (session end / project switch) so pending setTimeouts — each
+     *  holding a closure over the mailbox + entry — don't leak. */
+    dispose: () => void;
 }
 interface DependencyWatcherOptions {
     /** Absolute path to the project root. */
@@ -866,6 +870,8 @@ declare class KnowledgeGraph {
     private readonly pendingDeliveries;
     private readonly filePath;
     private readonly graphFilePath;
+    /** Exposed for unit-testing only: read current index contents. */
+    getIndex(): ReadonlyMap<string, ReadonlySet<string>>;
     constructor(sessionDir: string);
     /**
      * Add a node. Fires to all matching subscriptions synchronously.
@@ -915,7 +921,12 @@ declare class KnowledgeGraph {
         passed: boolean;
         detail?: string;
     }[]): QualityGateResult;
-    private _index;
+    /** Pure: compute the set of index keys a node would belong to. */
+    private _indexKeys;
+    /** Mutate the index: add a node's id to every set for the given keys. */
+    private _addToIndex;
+    /** Remove a node's id from all index sets for the given keys. */
+    private _removeFromIndex;
     private _matches;
     private _deliver;
     private _persist;
@@ -1103,7 +1114,10 @@ interface VoterConfig {
     weight: number;
     /** If true, a 'reject' vote from this role is a hard veto. Default: false. */
     veto?: boolean;
-    /** If true, this voter auto-approves low-risk changes. Default: true. */
+    /**
+     * @deprecated Not yet implemented. Auto-approve of low-risk changes is planned
+     * but not wired up in the vote resolution logic.
+     */
     autoApprovesLowRisk?: boolean;
 }
 interface QuorumRule {
@@ -1497,6 +1511,12 @@ interface TaskAuctionOptions {
     maxTasksPerAgent?: number | undefined;
     /** Minimum confidence threshold for dispatcher scoring. Default: 0.3 */
     minConfidence?: number | undefined;
+    /**
+     * Maximum times a task can be republished when no bids are received.
+     * After this, the task is marked as 'failed' with reason 'no_bids'.
+     * Default: 3.
+     */
+    maxBidRetries?: number | undefined;
 }
 declare class TaskAuctioneer {
     private readonly graph;
@@ -1506,13 +1526,24 @@ declare class TaskAuctioneer {
     private readonly bidWindowMs;
     private readonly maxTasksPerAgent;
     private readonly minConfidence;
+    private readonly maxBidRetries;
     /** Pending bids keyed by taskId. */
     private readonly pendingBids;
     /** Active bid windows keyed by taskId. */
     private readonly bidTimers;
+    /** FleetBus subscription disposers, detached in dispose(). */
+    private readonly unsubs;
+    /** How many times a task has been republished with no bids received. */
+    private readonly bidRetryCounts;
     /** Agent → current task count (from graph + in-flight). */
     private readonly agentTaskCounts;
     constructor(opts: TaskAuctionOptions);
+    /**
+     * Detach all FleetBus subscriptions and cancel any open bid-window timers.
+     * Call when the owning coordinator stops/restarts so handlers and timers
+     * don't accumulate across cycles.
+     */
+    dispose(): void;
     /**
      * Publish a new task to the auction. Creates a GoalNode and broadcasts
      * it to all online agents. Returns the goal id.
@@ -1527,6 +1558,8 @@ declare class TaskAuctioneer {
         targetAgent?: string;
         parentGoal?: string;
         satisfiesGoals?: string[];
+        /** Goal ids that must reach 'done' before this goal becomes workable. */
+        blockedBy?: string[];
         deadline?: string;
         reward?: string;
     }): Promise<string>;
@@ -1638,6 +1671,9 @@ type CoordinatorEvent = {
     type: 'deadlock:detected';
     goalId: string;
     text?: string;
+} | {
+    type: 'coordinator:mode';
+    mode: 'standalone' | 'fleet';
 };
 
 interface AutonomousCoordinatorOptions {
@@ -1646,6 +1682,7 @@ interface AutonomousCoordinatorOptions {
     selfAgentName: string;
     fleet?: FleetBus | undefined;
     fleetManager?: FleetManager | undefined;
+    director?: Director | undefined;
     mailbox?: Mailbox | undefined;
     events?: EventBus | undefined;
     llmProvider: LLMProvider;
@@ -1653,6 +1690,11 @@ interface AutonomousCoordinatorOptions {
     disableSelfImprove?: boolean;
     /** Max concurrent subagents. Default: 5. */
     maxConcurrentAgents?: number;
+    /**
+     * Called with every CoordinatorEvent so the caller (e.g. execution.ts)
+     * can forward it to the TUI coordinator panel timeline.
+     */
+    onCoordinatorEvent?: (event: CoordinatorEvent) => void;
 }
 interface RunOptions {
     /** Top-level goal description. Default: "Improve the codebase". */
@@ -1712,10 +1754,16 @@ declare class AutonomousCoordinator {
     private readonly selfAgentId;
     private readonly fleet?;
     private readonly fleetManager?;
+    private readonly director?;
     private readonly mailbox?;
     private readonly events?;
+    private readonly onCoordinatorEvent?;
     private running;
     private iterationCount;
+    /** Tasks already handled by _onSubagentTerminated (to avoid double goal:failed on fleet event). */
+    private readonly _handledBySubagent;
+    /** FleetBus subscription disposers, detached in dispose(). */
+    private readonly unsubs;
     constructor(opts: AutonomousCoordinatorOptions);
     /**
      * Run the autonomous loop until the goal is satisfied or max iterations reached.
@@ -1724,6 +1772,14 @@ declare class AutonomousCoordinator {
     run(opts?: RunOptions): Promise<CoordinatorStats>;
     /** Stop the autonomous loop. */
     stop(): void;
+    /**
+     * Tear down the coordinator for good: stop the loop and detach all FleetBus
+     * subscriptions (this coordinator's + the auctioneer's) plus any open bid
+     * timers. Call this when discarding the instance (e.g. `/coordinator stop`
+     * that recreates a fresh coordinator on the next start) so handlers and
+     * timers don't accumulate across cycles. `stop()` only pauses the loop.
+     */
+    dispose(): void;
     /** Get a stats snapshot. */
     getStats(): CoordinatorStats;
     /**
@@ -1752,7 +1808,6 @@ declare class AutonomousCoordinator {
     private _decomposeGoal;
     private _inferCategory;
     private _processGoal;
-    private _waitForClaim;
     private _handlePendingChange;
     private _onDagEvent;
     private _onSubagentTerminated;
@@ -1762,7 +1817,8 @@ declare class AutonomousCoordinator {
     private _optionToGoal;
     private _dagPriorityToGoal;
     private _mailboxBroadcast;
-    private _sleep;
+    /** Emit a CoordinatorEvent to the subscriber (e.g. TUI panel timeline). */
+    private _emit;
 }
 
-export { AgentDefinition, AgentHeartbeatInput, AgentRegistrationInput, 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, 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, type EscalationDecision, type FactCategory, type FactNode, FleetBus, FleetManager, GlobalMailbox, type GoalNode, type GoalPriority, type GoalStatus, type GraphSubscription, KNOWLEDGE_AGENTS, KnowledgeGraph, type LLMProvider, META_AGENTS, type MailToolsOptions, Mailbox, MailboxAckInput, MailboxAgentStatus, type MailboxHooksOptions, MailboxMessage, 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, type QualityCheck, type QualityGateChecks, type QualityGateResult, type QuorumRule, REVIEW_AGENTS, type RollbackResult, type RunOptions, type RunnablesHandler, type SpawnDecision, type TaskAuctionOptions, TaskAuctioneer, type TaskBid, TaskDAG, VERIFY_AGENTS, type VoteNode, type VoteRecord, type VoteValue, type VoterConfig, attachDepWatcherBridge, createMailboxHooks, detectEcosystem, getFullPackageLog, getManifestPackages, getPackageAuthor, getPackagesByAgent, mailboxSessionTag, makeDependencyWatcherConfig, makeMailInboxTool, makeMailSendTool, makeMailboxTool, recordPackageAction, resolveMailboxIdentity, resolveProjectDir, startPackageOutdatedWatcher, updatePackageOutdatedStatus };
+export { AgentDefinition, AgentHeartbeatInput, AgentRegistrationInput, 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, 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 EscalationDecision, type FactCategory, type FactNode, FleetBus, FleetManager, GlobalMailbox, type GoalNode, type GoalPriority, type GoalStatus, type GraphSubscription, KNOWLEDGE_AGENTS, KnowledgeGraph, type LLMProvider, META_AGENTS, type MailToolsOptions, Mailbox, MailboxAckInput, MailboxAgentStatus, type MailboxHooksOptions, MailboxMessage, 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, type QualityCheck, type QualityGateChecks, type QualityGateResult, type QuorumRule, REVIEW_AGENTS, type RollbackResult, type RunOptions, type RunnablesHandler, type SpawnDecision, type TaskAuctionOptions, TaskAuctioneer, type TaskBid, TaskDAG, VERIFY_AGENTS, type VoteNode, type VoteRecord, type VoteValue, type VoterConfig, attachDepWatcherBridge, createMailboxHooks, detectEcosystem, getFullPackageLog, getManifestPackages, getPackageAuthor, getPackagesByAgent, mailboxSessionTag, makeDependencyWatcherConfig, makeMailInboxTool, makeMailSendTool, makeMailboxTool, recordPackageAction, resolveMailboxIdentity, resolveProjectDir, startPackageOutdatedWatcher, updatePackageOutdatedStatus };