@wrongstack/core 0.270.0 → 0.272.1

package/dist/coordination/index.d.ts

@@ -1,25 +1,25 @@
-import { E as EventBus, B as BrainArbiter, f as BrainDecisionOption, k as BrainRisk, h as BrainDecisionRequest, e as BrainDecision, i as BrainDecisionSource } from '../brain-BYcK__Ym.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-BYcK__Ym.js';
-import { H as FleetManager, s as Director } from '../null-fleet-bus-QVshIsDx.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-QVshIsDx.js';
-import { b as AgentDefinition } from '../multi-agent-coordinator-CJSpTe5O.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-CJSpTe5O.js';
-import { F as FleetBus } from '../agent-subagent-runner-SHJW7t8q.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-SHJW7t8q.js';
-export { I as InMemoryAgentBridge, a as InMemoryBridgeTransport, c as createMessage } from '../agent-bridge-PcHQl_UQ.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-etbcbRwV.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-etbcbRwV.js';
+import { H as FleetManager, s as Director } from '../null-fleet-bus-DOGQcvrY.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-DOGQcvrY.js';
+import { b as AgentDefinition } from '../multi-agent-coordinator-jyimfo7D.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-jyimfo7D.js';
+import { F as FleetBus } from '../agent-subagent-runner-BZa_IEcd.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-BZa_IEcd.js';
+export { I as InMemoryAgentBridge, a as InMemoryBridgeTransport, c as createMessage } from '../agent-bridge-DFQYEeXf.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-Ct2hJq0P.js';
 export { k as MailboxMessageType, l as MailboxTaskContext, R as ReadReceipts, m as RegisteredAgent, n as normalizeRecipient } from '../mailbox-types-Ct2hJq0P.js';
-export { G as GlobalMailbox, al as resolveProjectDir } from '../global-mailbox-Bvrz1P3f.js';
-import { C as Context, T as Tool } from '../context-Dp87Bcaq.js';
+export { G as GlobalMailbox, aw as resolveProjectDir } from '../global-mailbox-DJ4EoRr0.js';
+import { C as Context, T as Tool } from '../context-Dw55zZ_Q.js';
+import { A as AdaptiveConcurrencyConfig } from '../config-rRS8yorV.js';
 import 'node:events';
 import '../logger-B63L5bTg.js';
 import '../director-state-BfeCUbmk.js';
-import '../config-C_ae2k86.js';
-import '../index-W4VJCzHa.js';
-import '../pipeline-l_zzFRh3.js';
+import '../index-DWm_PE9L.js';
+import '../pipeline-Ckkn3AOA.js';
 import '../observability-D-HZN_mF.js';
-import '../permission-CvYQNUqZ.js';
-import '../retry-policy-CtFhfwa8.js';
+import '../permission-CC7XFYWG.js';
+import '../retry-policy-BV7nzeAd.js';
 
 /** Phase 1 · Discovery — map the territory before any work begins. */
 declare const DISCOVERY_AGENTS: AgentDefinition[];
@@ -65,6 +65,10 @@ declare class DefaultMailbox implements Mailbox {
     private _messageCache;
     private _messageCacheMtime;
     private _messageCacheSize;
+    /** Primary index: recipient → Set of messages (points into _messageCache). */
+    private _byTo;
+    /** Secondary index: sender → Set of messages (points into _messageCache). */
+    private _byFrom;
     constructor(sessionDir: string);
     get mailboxPath(): string;
     send(input: MailboxSendInput): Promise<MailboxMessage>;
@@ -83,9 +87,20 @@ declare class DefaultMailbox implements Mailbox {
     clientHeartbeat(_input: ClientHeartbeatInput): Promise<void>;
     getClientStatuses(): Promise<ClientStatus[]>;
     private _readAll;
+    /**
+     * Read only newly-appended bytes from the file and append them to the
+     * in-memory cache, avoiding a full re-read when the file only grew.
+     */
+    private _readNewMessagesOnly;
+    /** Parse a JSONL string into MailboxMessage[], including migration. */
+    private _parseLines;
     private _readAllCached;
     private _setMessageCache;
     private _pushToCache;
+    /** Rebuild both indexes from a full message list. */
+    private _buildIndexes;
+    /** Add a single message to both indexes. */
+    private _indexMsg;
 }
 
 /**
@@ -1723,4 +1738,153 @@ declare class AutonomousCoordinator {
     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, Director, type EscalationDecision, type FactCategory, type FactNode, FleetBus, FleetManager, 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, startPackageOutdatedWatcher, updatePackageOutdatedStatus };
+interface AgentTimelineEntry {
+    /** Unique entry id (ULID or timestamp-based). */
+    id: string;
+    /** Subagent id this entry belongs to. */
+    subagentId: string;
+    /** Human-readable agent name/role. */
+    agentName: string;
+    /** ISO 8601 timestamp. */
+    ts: string;
+    /** Content type. */
+    kind: 'text' | 'tool_use' | 'tool_result' | 'error' | 'status' | 'system';
+    /** The message content (text, tool summary, error message, status text). */
+    content: string;
+    /** Iteration index within the subagent's run. */
+    iteration: number;
+    /** For tool entries: tool name. */
+    toolName?: string | undefined;
+    /** For tool entries: whether the tool succeeded. */
+    toolOk?: boolean | undefined;
+    /** Running cost estimate. */
+    costUsd?: number | undefined;
+}
+interface AgentVirtualSession {
+    subagentId: string;
+    agentName: string;
+    createdAt: string;
+    status: string;
+    task?: string | undefined;
+    /** Ordered transcript entries (newest last). */
+    transcript: AgentTimelineEntry[];
+}
+interface AgentMonitorOptions {
+    /** The FleetBus to listen on for subagent events. Optional — set via `setFleetBus()` before `start()`. */
+    fleetBus?: FleetBus | undefined;
+    /** Local EventBus for emitting agent.timeline.* and agent.status_changed events. */
+    events: EventBus;
+    /** Directory where per-subagent JSONL transcripts will be written. */
+    transcriptsDir: string;
+    /** Maximum in-memory entries per subagent (ring buffer). Default 500. */
+    maxEntriesPerAgent?: number;
+    /** Whether agent stream is initially enabled. Default false. */
+    streamEnabled?: boolean;
+    /** Called for each new timeline entry — used by HQ publisher bridge. */
+    onEntry?: ((entry: AgentTimelineEntry) => void) | undefined;
+}
+declare class AgentMonitorService {
+    private _fleetBus;
+    private readonly _events;
+    private readonly _transcriptsDir;
+    private readonly _maxEntries;
+    private _streamEnabled;
+    private _onEntry;
+    /** Per-subagent virtual sessions. */
+    private readonly _sessions;
+    /** Disposers for FleetBus subscriptions, keyed by subagentId. */
+    private readonly _subscriptions;
+    /** Generic fleet-wide subscription disposer. */
+    private _fleetDisposer;
+    /** Track whether service is running. */
+    private _started;
+    constructor(opts: AgentMonitorOptions);
+    /** Set the FleetBus to listen on. Must be called before `start()`. */
+    setFleetBus(bus: FleetBus): void;
+    get streamEnabled(): boolean;
+    /** Enable/disable streaming agent conversations to the main chat timeline. */
+    setStreamEnabled(enabled: boolean): void;
+    /** Get a snapshot of all known agent sessions. */
+    getAllSessions(): AgentVirtualSession[];
+    /** Get a specific agent's virtual session, or undefined. */
+    getSession(subagentId: string): AgentVirtualSession | undefined;
+    /** Get transcript entries for a specific agent, newest first. */
+    getTranscript(subagentId: string, limit?: number): AgentTimelineEntry[];
+    /** Set a callback for each new timeline entry (HQ bridge). */
+    setOnEntry(handler: ((entry: AgentTimelineEntry) => void) | undefined): void;
+    /** Start listening to FleetBus events. */
+    start(): void;
+    /** Stop listening and clean up all subscriptions. */
+    stop(): void;
+    /** Ensure a subagent is being tracked. Called when a subagent spawns. */
+    trackSubagent(subagentId: string, agentName: string, task?: string): void;
+    /** Mark a subagent as completed/failed/etc. Called on subagent finish. */
+    completeSubagent(subagentId: string, status: 'completed' | 'failed' | 'timeout' | 'stopped' | 'budget_exhausted', summary?: string): void;
+    private _routeEvent;
+    private _addEntry;
+    private _appendToFile;
+    private _uid;
+}
+declare function createAgentMonitorService(opts: AgentMonitorOptions): AgentMonitorService;
+
+/**
+ * Adaptive Concurrency Controller
+ *
+ * Automatically adjusts `maxConcurrent` based on:
+ * - Rate limit (429) errors → decrease concurrency
+ * - Sustained successful requests → increase concurrency
+ *
+ * This provides automatic backpressure without manual tuning.
+ */
+
+interface AdaptiveConcurrencyState {
+    current: number;
+    min: number;
+    max: number;
+    consecutiveSuccesses: number;
+    consecutiveFailures: number;
+    totalDecreases: number;
+    totalIncreases: number;
+    enabled: boolean;
+}
+/**
+ * Adaptive Concurrency Controller
+ *
+ * Monitors fleet events for rate-limit (429) errors and adjusts concurrency
+ * automatically to prevent overwhelming the API provider.
+ */
+declare class AdaptiveConcurrencyController {
+    private readonly config;
+    private state;
+    private readonly disposers;
+    private stateChangeHandlers;
+    constructor(fleetBus: FleetBus, setMaxConcurrent: (n: number) => void, config?: Partial<AdaptiveConcurrencyConfig>, onStateChange?: (state: AdaptiveConcurrencyState) => void);
+    private setupEventHandlers;
+    /**
+     * Handle a rate limit (429) error - decrease concurrency
+     */
+    private handleRateLimit;
+    /**
+     * Force a decrease (e.g., manual trigger or other error types)
+     */
+    decrease(target?: number): void;
+    /**
+     * Get the current state
+     */
+    getState(): AdaptiveConcurrencyState;
+    /**
+     * Update configuration at runtime
+     */
+    updateConfig(config: Partial<AdaptiveConcurrencyConfig>): void;
+    /**
+     * Dispose of the controller and clean up event listeners
+     */
+    dispose(): void;
+    private notifyStateChange;
+    /**
+     * Register a state change handler
+     */
+    onStateChange(handler: (state: AdaptiveConcurrencyState) => void): () => void;
+}
+
+export { 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, 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, 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, createAgentMonitorService, createMailboxHooks, detectEcosystem, getFullPackageLog, getManifestPackages, getPackageAuthor, getPackagesByAgent, mailboxSessionTag, makeDependencyWatcherConfig, makeMailInboxTool, makeMailSendTool, makeMailboxTool, recordPackageAction, resolveMailboxIdentity, startPackageOutdatedWatcher, updatePackageOutdatedStatus };