@wrongstack/core 0.264.0 → 0.265.1

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-BXd_61kQ.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-BXd_61kQ.js';
+import { H as FleetManager, s as Director } from '../null-fleet-bus-CG9QY2aP.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-CG9QY2aP.js';
+import { b as AgentDefinition } from '../multi-agent-coordinator-DyCkCZnU.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-DyCkCZnU.js';
+import { F as FleetBus } from '../agent-subagent-runner-DM2pP-B6.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-DM2pP-B6.js';
+export { I as InMemoryAgentBridge, a as InMemoryBridgeTransport, c as createMessage } from '../agent-bridge-DrkBxszZ.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-DPDxH_7m.js';
+export { i as MailboxMessageType, l as MailboxTaskContext, o as ReadReceipts, p as RegisteredAgent, r as normalizeRecipient } from '../pipeline-DPDxH_7m.js';
+import { C as Context, T as Tool } from '../context-MRk5PhNv.js';
 import 'node:events';
 import '../director-state-BfeCUbmk.js';
-import '../config-Dz2F3H2K.js';
-import '../index-CbLSI66_.js';
+import '../config-BMCj_XDs.js';
+import '../index-CEDeNodM.js';
 import '../logger-B63L5bTg.js';
 import '../observability-D-HZN_mF.js';
-import '../permission-4yvGmMRB.js';
-import '../retry-policy-CFhdtRzz.js';
+import '../permission-B9SB45lp.js';
+import '../retry-policy-CN0khdlj.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 };