@wrongstack/core 0.250.0 → 0.256.0

package/dist/{agent-bridge-4gc0vfW2.d.ts → agent-bridge-BrxWHEOm.d.ts}

@@ -1,4 +1,4 @@
-import { B as BridgeTransport, a as BridgeMessage, A as AgentBridge, b as AgentBridgeConfig } from './agent-subagent-runner-Dz-9kiE6.js';
+import { B as BridgeTransport, a as BridgeMessage, A as AgentBridge, b as AgentBridgeConfig } from './agent-subagent-runner-US741uBH.js';
 
 /**
  * In-memory pub/sub transport for agent-to-agent messaging.

package/dist/{agent-subagent-runner-Dz-9kiE6.d.ts → agent-subagent-runner-US741uBH.d.ts}

@@ -1,12 +1,12 @@
-import { c as ToolCallPipelinePayload, d as ToolWrapper, E as ExtensionRegistry, S as SystemPromptContributor, e as ToolRegistry, P as ProviderRegistry, A as AgentPipelines, f as ToolExecutorLike, g as AgentInit, h as AgentInput, R as RunResult } from './index-IehiNryU.js';
-import { C as Container, R as ReadonlyPipeline, a as Renderer } from './pipeline-D1n-gQI-.js';
-import { E as EventBus, a as EventName, L as Listener } from './brain-sCZ3lCjq.js';
-import { R as RetryPolicy, E as ErrorHandler } from './retry-policy-BVnkbMET.js';
+import { c as ToolCallPipelinePayload, d as ToolWrapper, E as ExtensionRegistry, S as SystemPromptContributor, e as ToolRegistry, P as ProviderRegistry, A as AgentPipelines, f as ToolExecutorLike, g as AgentInit, h as AgentInput, R as RunResult } from './index-CitPrI3a.js';
+import { C as Container, R as ReadonlyPipeline, a as Renderer } from './pipeline-JG8XoudC.js';
+import { E as EventBus, a as EventName, L as Listener } from './brain-TjEEwSpw.js';
+import { R as RetryPolicy, E as ErrorHandler } from './retry-policy-Tg7LXkoK.js';
 import { L as Logger } from './logger-B63L5bTg.js';
 import { T as Tracer } from './observability-D-HZN_mF.js';
-import { P as PermissionPolicy } from './permission-DbWPbuoA.js';
-import { U as Usage, C as Context, J as JSONSchema, R as Request, b as Response, g as ContentBlock, n as TextBlock, T as Tool, P as Provider, o as RunOptions } from './context-CLz3z_E8.js';
-import { W as WireFamily, H as HookEvent, e as HookMatcher, I as InProcessHook, h as Config } from './config-eSsrto5d.js';
+import { P as PermissionPolicy } from './permission-CwBBpCoF.js';
+import { U as Usage, C as Context, J as JSONSchema, R as Request, b as Response, g as ContentBlock, n as TextBlock, T as Tool, P as Provider, o as RunOptions } from './context-CGdgA0q6.js';
+import { W as WireFamily, H as HookEvent, e as HookMatcher, I as InProcessHook, h as Config } from './config-DuAu23zm.js';
 
 /**
  * Single fleet-wide event with subagent attribution. Whatever a child
@@ -900,6 +900,15 @@ interface PluginCapabilities {
     slashCommands?: boolean | undefined;
     /** Will start MCP servers via `api.mcp.start()`. */
     mcp?: boolean | undefined;
+    /**
+     * Capabilities required to mutate (wrap, unregister, override) tools
+     * the plugin does not own. If empty or omitted, the plugin may only
+     * mutate its own tools. Official plugins bypass this check.
+     *
+     * Example: `['fs.read', 'net.outbound']` allows the plugin to wrap
+     * read-only tools, but not `fs.write` or `shell.arbitrary` tools.
+     */
+    toolMutateCapabilities?: string[] | undefined;
 }
 /**
  * Structured dependency declaration. The string form (`dependsOn: ['foo']`)
@@ -1053,4 +1062,4 @@ interface AgentRunnerOptions {
  */
 declare function makeAgentSubagentRunner(opts: AgentRunnerOptions): SubagentRunner;
 
-export { type AgentBridge as A, type BridgeTransport as B, type CoordinatorStatus as C, type DoneCondition as D, type PluginPipelines as E, FleetBus as F, type ToolRegistryView as G, type ProviderRegistryView as H, type MCPRegistryView as I, type SlashCommandRegistryView as J, type SessionWriterView as K, type MetricsSinkView as L, type MultiAgentCoordinator as M, type Plugin as N, type CoordinatorEvents as O, type PluginAPI as P, type PluginCapabilities as Q, type PluginDependency as R, type SubagentConfig as S, type TaskSpec as T, type SubagentContext as U, type SubagentError as V, type SubagentErrorKind as W, type SubagentRunContext as X, type SubagentRunOutcome as Y, type TaskDelegation as Z, type ProviderFactory as _, type BridgeMessage as a, type AgentBridgeConfig as b, type MultiAgentConfig as c, type SubagentRunner as d, type SpawnResult as e, type TaskResult as f, Agent as g, type AgentFactory as h, type AgentFactoryResult as i, type AgentRunnerOptions as j, BudgetExceededError as k, type BudgetKind as l, type BudgetLimits as m, type BudgetNegotiationMode as n, type BudgetThresholdDecision as o, type BudgetThresholdHandler as p, BudgetThresholdSignal as q, type BudgetUsage as r, type FleetEvent as s, type FleetHandler as t, type FleetUsage as u, FleetUsageAggregator as v, SubagentBudget as w, type SubagentUsageSnapshot as x, makeAgentSubagentRunner as y, type SlashCommand as z };
+export { type AgentBridge as A, type BridgeTransport as B, type CoordinatorStatus as C, type DoneCondition as D, type PluginPipelines as E, FleetBus as F, type ToolRegistryView as G, type ProviderRegistryView as H, type MCPRegistryView as I, type SlashCommandRegistryView as J, type SessionWriterView as K, type MetricsSinkView as L, type MultiAgentCoordinator as M, type PluginCapabilities as N, type Plugin as O, type PluginAPI as P, type CoordinatorEvents as Q, type PluginDependency as R, type SubagentConfig as S, type TaskSpec as T, type SubagentContext as U, type SubagentError as V, type SubagentErrorKind as W, type SubagentRunContext as X, type SubagentRunOutcome as Y, type TaskDelegation as Z, type ProviderFactory as _, type BridgeMessage as a, type AgentBridgeConfig as b, type MultiAgentConfig as c, type SubagentRunner as d, type SpawnResult as e, type TaskResult as f, Agent as g, type AgentFactory as h, type AgentFactoryResult as i, type AgentRunnerOptions as j, BudgetExceededError as k, type BudgetKind as l, type BudgetLimits as m, type BudgetNegotiationMode as n, type BudgetThresholdDecision as o, type BudgetThresholdHandler as p, BudgetThresholdSignal as q, type BudgetUsage as r, type FleetEvent as s, type FleetHandler as t, type FleetUsage as u, FleetUsageAggregator as v, SubagentBudget as w, type SubagentUsageSnapshot as x, makeAgentSubagentRunner as y, type SlashCommand as z };

package/dist/{brain-sCZ3lCjq.d.ts → brain-TjEEwSpw.d.ts}

@@ -1,4 +1,4 @@
-import { U as Usage, C as Context, j as ToolProgressEvent, T as Tool } from './context-CLz3z_E8.js';
+import { U as Usage, C as Context, j as ToolProgressEvent, T as Tool } from './context-CGdgA0q6.js';
 
 type MemoryScope = 'project-agents' | 'project-memory' | 'user-memory';
 type MemoryType = 'fact' | 'decision' | 'convention' | 'preference' | 'reference' | 'anti_pattern';
@@ -374,6 +374,23 @@ interface EventMap {
         used: number;
         limit: number;
     };
+    /**
+     * Fired by `DefaultTokenCounter` after each call to `account()` /
+     * `accountWithModel()` updates its internal state. The payload carries
+     * the live snapshot so subscribers (notably the TUI's `StatusBar`) can
+     * re-render fresh token/cost/cache data immediately instead of waiting
+     * for a slow polling interval. Cost fields may be zero when the model
+     * is unknown to the ModelsRegistry — that is already signalled separately
+     * by `token.cost_estimate_unavailable`.
+     */
+    'token.accounted': {
+        usage: Usage;
+        cost: {
+            input: number;
+            output: number;
+            total: number;
+        };
+    };
     /**
      * Fired when the subagent budget hits a soft limit and the coordinator
      * is being asked for an extension. The coordinator should call `extend()`

package/dist/{compactor-BRfg3QPd.d.ts → compactor-C5sT4U7I.d.ts}

@@ -1,4 +1,4 @@
-import { C as Context } from './context-CLz3z_E8.js';
+import { C as Context } from './context-CGdgA0q6.js';
 
 interface CompactRepairReport {
     removedToolUses: string[];

package/dist/{config-eSsrto5d.d.ts → config-DuAu23zm.d.ts}

@@ -1,4 +1,4 @@
-import { k as Capabilities, f as Permission } from './context-CLz3z_E8.js';
+import { k as Capabilities, f as Permission } from './context-CGdgA0q6.js';
 
 type ContextWindowModeId = 'balanced' | 'frugal' | 'deep' | 'archival';
 type ContextWindowAggressiveOn = 'hard' | 'soft' | 'warn';
@@ -374,6 +374,14 @@ interface FeaturesConfig {
     modelsRegistry: boolean;
     /** Discover + load skills from disk. */
     skills: boolean;
+    /**
+     * Token-saving mode: when enabled, non-essential tools are omitted,
+     * skill descriptions are trimmed, and the system prompt is shortened
+     * to reduce per-request token consumption without compromising core
+     * functionality. Enable with `--token-saving-mode` or
+     * `features.tokenSavingMode: true` in config.
+     */
+    tokenSavingMode?: boolean | undefined;
 }
 interface AutonomyConfig {
     /** ms to wait before auto-proceeding in 'auto' mode. Default: 45000. */
@@ -514,6 +522,13 @@ interface Config {
      * re-tried first at the start of every user turn. See `createFallbackModelExtension`.
      */
     fallbackModels?: string[] | undefined;
+    /**
+     * When `true` (the default) and `fallbackModels` is empty, a fallback chain
+     * is derived automatically from the other keyed providers/models so 429s
+     * recover out of the box. Set `false` to disable the smart default and only
+     * use an explicit `fallbackModels` list. Toggle via `/fallback auto on|off`.
+     */
+    fallbackAuto?: boolean | undefined;
     /**
      * Lifecycle shell hooks, keyed by event. Each command receives the hook
      * `HookInput` JSON on stdin; a JSON `HookOutcome` on stdout (and exit code 2

package/dist/{context-CLz3z_E8.d.ts → context-CGdgA0q6.d.ts}

@@ -1331,6 +1331,19 @@ declare class Context implements RunEnv {
      * on iterations where no tool content was added (pure text responses).
      */
     toolAdjacencyDirty: boolean;
+    /**
+     * H1: pre-computed total-request token estimate from the most recent
+     * `estimateRequestTokens()` call in the agent loop's pre-flight step.
+     * The middleware that decides when to compact, the `emitContextPct`
+     * helper that drives the live context-fill bar, and the pre-flight
+     * itself all need this number; previously each one walked the same
+     * messages/system/tools arrays independently. Stashing it here lets
+     * the three call sites share a single compute per iteration.
+     *
+     * The value is the **uncalibrated** total. Callers that want the
+     * calibrated number apply the per-(provider,model) ratio themselves.
+     */
+    lastRequestTokens: number | undefined;
     constructor(init: ContextInit);
     /**
      * Observable wrapper over the mutable conversation state. Lazy so

package/dist/coordination/index.d.ts

@@ -1,21 +1,21 @@
-export { B as BrainArbiter, b as BrainDecision, c as BrainDecisionOption, d as BrainDecisionQueue, e as BrainDecisionRequest, f as BrainDecisionSource, g as BrainFallback, h as BrainRisk, D as DefaultBrainArbiter, i as DefaultBrainArbiterOptions, H as HumanEscalatingBrainArbiter, O as ObservableBrainArbiter, j as formatHumanPrompt } from '../brain-sCZ3lCjq.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, H as FleetManager, 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-Do1OLYpj.js';
-import { A as AgentDefinition } from '../multi-agent-coordinator-CnbEqpv0.js';
-export { T as AGENT_TOOL_PRESETS, b as AgentBudgetTier, c as AgentCapability, d 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-CnbEqpv0.js';
-export { h as AgentFactory, i as AgentFactoryResult, j as AgentRunnerOptions, k as BudgetExceededError, l as BudgetKind, m as BudgetLimits, n as BudgetNegotiationMode, o as BudgetThresholdDecision, p as BudgetThresholdHandler, q as BudgetThresholdSignal, r as BudgetUsage, F as FleetBus, s as FleetEvent, t as FleetHandler, u as FleetUsage, v as FleetUsageAggregator, w as SubagentBudget, x as SubagentUsageSnapshot, y as makeAgentSubagentRunner } from '../agent-subagent-runner-Dz-9kiE6.js';
-export { I as InMemoryAgentBridge, a as InMemoryBridgeTransport, c as createMessage } from '../agent-bridge-4gc0vfW2.js';
-export { B as BrainInterventionInput, a as BrainMonitor, b as BrainMonitorOptions, D as DEPENDENCY_FILE_PATTERNS, c as DefaultMailbox, d as DepWatchEntry, e as DepWatcherBridgeOptions, f as DependencyWatcherConfig, G as GlobalMailbox, M as MailToolsOptions, g as MailboxResolver, h as MailboxToolOptions, O as OutdatedNotifyMessage, P as PackageAuthorEntry, i as PackageAuthorLog, j as PackageAuthorTrackerOptions, k as PackageOutdatedEntry, l as PackageOutdatedResult, m as PackageOutdatedWatcherOptions, n as attachDepWatcherBridge, o as detectEcosystem, p as getFullPackageLog, q as getManifestPackages, r as getPackageAuthor, s as getPackagesByAgent, t as mailboxSessionTag, u as makeDependencyWatcherConfig, v as makeMailInboxTool, w as makeMailSendTool, x as makeMailboxTool, y as recordPackageAction, z as resolveMailboxIdentity, A as resolveProjectDir, C as startPackageOutdatedWatcher, E as updatePackageOutdatedStatus } from '../package-outdated-watcher-CA5GGB4C.js';
-import { b as Mailbox } from '../pipeline-D1n-gQI-.js';
-export { h as AgentHeartbeatInput, A as AgentRegistrationInput, f as MailboxAckInput, g as MailboxAgentStatus, d as MailboxMessage, i as MailboxMessageType, e as MailboxQuery, c as MailboxSendInput, j as MailboxTaskContext, k as ReadReceipts, l as RegisteredAgent, n as normalizeRecipient } from '../pipeline-D1n-gQI-.js';
-import '../context-CLz3z_E8.js';
+export { B as BrainArbiter, b as BrainDecision, c as BrainDecisionOption, d as BrainDecisionQueue, e as BrainDecisionRequest, f as BrainDecisionSource, g as BrainFallback, h as BrainRisk, D as DefaultBrainArbiter, i as DefaultBrainArbiterOptions, H as HumanEscalatingBrainArbiter, O as ObservableBrainArbiter, j as formatHumanPrompt } from '../brain-TjEEwSpw.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, H as FleetManager, 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-B5mfTJXT.js';
+import { A as AgentDefinition } from '../multi-agent-coordinator-DqTUEAeC.js';
+export { T as AGENT_TOOL_PRESETS, b as AgentBudgetTier, c as AgentCapability, d 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-DqTUEAeC.js';
+export { h as AgentFactory, i as AgentFactoryResult, j as AgentRunnerOptions, k as BudgetExceededError, l as BudgetKind, m as BudgetLimits, n as BudgetNegotiationMode, o as BudgetThresholdDecision, p as BudgetThresholdHandler, q as BudgetThresholdSignal, r as BudgetUsage, F as FleetBus, s as FleetEvent, t as FleetHandler, u as FleetUsage, v as FleetUsageAggregator, w as SubagentBudget, x as SubagentUsageSnapshot, y as makeAgentSubagentRunner } from '../agent-subagent-runner-US741uBH.js';
+export { I as InMemoryAgentBridge, a as InMemoryBridgeTransport, c as createMessage } from '../agent-bridge-BrxWHEOm.js';
+export { B as BrainInterventionInput, a as BrainMonitor, b as BrainMonitorOptions, D as DEPENDENCY_FILE_PATTERNS, c as DefaultMailbox, d as DepWatchEntry, e as DepWatcherBridgeOptions, f as DependencyWatcherConfig, G as GlobalMailbox, M as MailToolsOptions, g as MailboxResolver, h as MailboxToolOptions, O as OutdatedNotifyMessage, P as PackageAuthorEntry, i as PackageAuthorLog, j as PackageAuthorTrackerOptions, k as PackageOutdatedEntry, l as PackageOutdatedResult, m as PackageOutdatedWatcherOptions, n as attachDepWatcherBridge, o as detectEcosystem, p as getFullPackageLog, q as getManifestPackages, r as getPackageAuthor, s as getPackagesByAgent, t as mailboxSessionTag, u as makeDependencyWatcherConfig, v as makeMailInboxTool, w as makeMailSendTool, x as makeMailboxTool, y as recordPackageAction, z as resolveMailboxIdentity, A as resolveProjectDir, C as startPackageOutdatedWatcher, E as updatePackageOutdatedStatus } from '../package-outdated-watcher-BSgR_kK-.js';
+import { b as Mailbox } from '../pipeline-JG8XoudC.js';
+export { h as AgentHeartbeatInput, A as AgentRegistrationInput, f as MailboxAckInput, g as MailboxAgentStatus, d as MailboxMessage, l as MailboxMessageType, e as MailboxQuery, c as MailboxSendInput, m as MailboxTaskContext, n as ReadReceipts, o as RegisteredAgent, p as normalizeRecipient } from '../pipeline-JG8XoudC.js';
+import '../context-CGdgA0q6.js';
 import 'node:events';
 import '../director-state-BfeCUbmk.js';
-import '../config-eSsrto5d.js';
-import '../index-IehiNryU.js';
+import '../config-DuAu23zm.js';
+import '../index-CitPrI3a.js';
 import '../logger-B63L5bTg.js';
 import '../observability-D-HZN_mF.js';
-import '../permission-DbWPbuoA.js';
-import '../retry-policy-BVnkbMET.js';
+import '../permission-CwBBpCoF.js';
+import '../retry-policy-Tg7LXkoK.js';
 
 /** Phase 1 · Discovery — map the territory before any work begins. */
 declare const DISCOVERY_AGENTS: AgentDefinition[];

package/dist/coordination/index.js

@@ -6701,6 +6701,17 @@ var Director = class _Director {
    * default cap.
    */
   taskCompletedListener = null;
+  /**
+   * Unsub handles for the two `FleetBus.filter()` calls installed in the
+   * constructor for timeout-heartbeat tracking. Without capturing these
+   * and calling them in `shutdown()`, repeated Director construction
+   * (tests, hot reloads, `--director` restarts) accumulates 2 dangling
+   * listeners per Director on the FleetBus, slowly drifting the
+   * EventEmitter past its default cap. Mirrors the rationale on
+   * `taskCompletedListener` above.
+   */
+  toolExecFilter = null;
+  budgetFilter = null;
   /** Optional LLM classifier for smart dispatch. Passed from options. */
   dispatchClassifier;
   /** Leader agent's current context pressure (full request tokens). */
@@ -6838,10 +6849,10 @@ var Director = class _Director {
     const extendCounts = /* @__PURE__ */ new Map();
     const progressBySubagent = /* @__PURE__ */ new Map();
     const lastTimeoutProgress = /* @__PURE__ */ new Map();
-    this.fleet.filter("tool.executed", (e) => {
+    this.toolExecFilter = this.fleet.filter("tool.executed", (e) => {
       progressBySubagent.set(e.subagentId, (progressBySubagent.get(e.subagentId) ?? 0) + 1);
     });
-    this.fleet.filter("budget.threshold_reached", (e) => {
+    this.budgetFilter = this.fleet.filter("budget.threshold_reached", (e) => {
       const payload = e.payload;
       if (e.subagentId.startsWith("bug-hunter-") || e.subagentId.startsWith("refactor-planner-") || e.subagentId.startsWith("critic-")) {
         return;
@@ -7372,6 +7383,14 @@ var Director = class _Director {
       this.coordinator.off("task.completed", this.taskCompletedListener);
       this.taskCompletedListener = null;
     }
+    if (this.toolExecFilter) {
+      this.toolExecFilter();
+      this.toolExecFilter = null;
+    }
+    if (this.budgetFilter) {
+      this.budgetFilter();
+      this.budgetFilter = null;
+    }
     await this.coordinator.stopAll();
     for (const b of this.subagentBridges.values()) {
       await b.stop().catch((err) => this.logShutdownError("subagent_bridge_stop", err));
@@ -10041,6 +10060,14 @@ var DefaultMailbox = class {
       await fsp6.writeFile(this.filePath, "", "utf8");
     });
   }
+  // ── Client registry stubs (not applicable per-session) ─────────────────
+  async registerClient(_input) {
+  }
+  async clientHeartbeat(_input) {
+  }
+  async getClientStatuses() {
+    return [];
+  }
   // ── Internal ──────────────────────────────────────────────────────────
   async _readAll() {
     try {
@@ -10217,7 +10244,9 @@ function wstackGlobalRoot() {
 
 // src/coordination/global-mailbox.ts
 var MAILBOX_FILE2 = "_mailbox.jsonl";
+var CLIENT_REGISTRY_FILE = "_mailbox.clients.json";
 var AGENT_STALE_MS = 6e4;
+var CLIENT_STALE_MS = 6e4;
 var HEARTBEAT_THROTTLE_MS = 5e3;
 var REGISTRY_CACHE_TTL_MS = 2e3;
 var LINE_SEPARATOR2 = "\n";
@@ -10229,6 +10258,8 @@ var GlobalMailbox = class {
   messagePath;
   /** Path to the JSON agent registry file. */
   registryPath;
+  /** Path to the JSON client registry file. */
+  clientRegistryPath;
   /** Optional event bus for emitting agent registration/heartbeat events. */
   _events;
   /**
@@ -10240,8 +10271,17 @@ var GlobalMailbox = class {
   _registryCache = null;
   /** When the registry cache was last refreshed from disk (epoch ms). */
   _registryCacheAt = 0;
+  /**
+   * Local cache of the client registry to avoid re-reading on every call.
+   * Same reasoning as agent registry cache.
+   */
+  _clientRegistryCache = null;
+  /** When the client registry cache was last refreshed from disk (epoch ms). */
+  _clientRegistryCacheAt = 0;
   /** Last time each local agent sent a heartbeat (throttle). */
   _lastHeartbeat = /* @__PURE__ */ new Map();
+  /** Last time each local client sent a heartbeat (throttle). */
+  _lastClientHeartbeat = /* @__PURE__ */ new Map();
   /**
    * @param projectDir — `~/.wrongstack/projects/<slug>/`
    * @param events — optional EventBus for real-time TUI/WebUI notifications
@@ -10249,6 +10289,7 @@ var GlobalMailbox = class {
   constructor(projectDir, events) {
     this.messagePath = path4.join(projectDir, MAILBOX_FILE2);
     this.registryPath = path4.join(projectDir, "_mailbox.registry.json");
+    this.clientRegistryPath = path4.join(projectDir, CLIENT_REGISTRY_FILE);
     this._events = events;
   }
   // ── Messages ────────────────────────────────────────────────────────────
@@ -10430,9 +10471,74 @@ var GlobalMailbox = class {
     const all = await this.getAgentStatuses();
     return all.filter((a) => a.online);
   }
+  // ── Client registry ─────────────────────────────────────────────────────
+  async registerClient(input) {
+    await this._ensureClientRegistry();
+    const now = (/* @__PURE__ */ new Date()).toISOString();
+    const client = {
+      clientId: input.clientId,
+      sessionId: input.sessionId,
+      name: input.name,
+      source: input.source,
+      registeredAt: now,
+      lastSeenAt: now,
+      pid: input.pid
+    };
+    await withFileLock(this.clientRegistryPath, async () => {
+      const registry = await this._readClientRegistry({ fresh: true });
+      this._pruneStaleClientsInPlace(registry);
+      registry.set(input.clientId, client);
+      this._clientRegistryCache = registry;
+      this._clientRegistryCacheAt = Date.now();
+      await this._writeClientRegistry(registry);
+    });
+    this._events?.emitCustom("mailbox.client_registered", {
+      clientId: input.clientId,
+      sessionId: input.sessionId,
+      name: input.name,
+      source: input.source
+    });
+  }
+  async clientHeartbeat(input) {
+    const last = this._lastClientHeartbeat.get(input.clientId) ?? 0;
+    const now = Date.now();
+    if (now - last < HEARTBEAT_THROTTLE_MS) return;
+    this._lastClientHeartbeat.set(input.clientId, now);
+    await this._ensureClientRegistry();
+    await withFileLock(this.clientRegistryPath, async () => {
+      const registry = await this._readClientRegistry({ fresh: true });
+      this._pruneStaleClientsInPlace(registry);
+      const client = registry.get(input.clientId);
+      if (client) {
+        client.lastSeenAt = (/* @__PURE__ */ new Date()).toISOString();
+      }
+      this._clientRegistryCache = registry;
+      this._clientRegistryCacheAt = Date.now();
+      await this._writeClientRegistry(registry);
+    });
+    this._events?.emitCustom("mailbox.client_heartbeat", {
+      clientId: input.clientId
+    });
+  }
+  async getClientStatuses() {
+    await this._ensureClientRegistry();
+    const registry = await this._readClientRegistry();
+    this._pruneStaleClientsInPlace(registry);
+    const now = Date.now();
+    return Array.from(registry.values()).map((c) => ({
+      clientId: c.clientId,
+      name: c.name,
+      source: c.source,
+      sessionId: c.sessionId,
+      lastSeenAt: c.lastSeenAt,
+      online: now - new Date(c.lastSeenAt).getTime() < CLIENT_STALE_MS,
+      pid: c.pid
+    })).sort((a, b) => b.lastSeenAt.localeCompare(a.lastSeenAt));
+  }
   // ── Lifecycle ───────────────────────────────────────────────────────────
   async close() {
     this._registryCache = null;
+    this._clientRegistryCache = null;
   }
   async clearAll() {
     await withFileLock(this.messagePath, async () => {
@@ -10511,6 +10617,51 @@ var GlobalMailbox = class {
     await fsp6.writeFile(tmp, JSON.stringify(obj, null, 2), "utf8");
     await fsp6.rename(tmp, this.registryPath);
   }
+  // ── Client registry internals ───────────────────────────────────────────
+  async _ensureClientRegistry() {
+    await fsp6.mkdir(path4.dirname(this.clientRegistryPath), { recursive: true });
+  }
+  async _readClientRegistry(opts) {
+    if (!opts?.fresh && this._clientRegistryCache && Date.now() - this._clientRegistryCacheAt < REGISTRY_CACHE_TTL_MS) {
+      return new Map(this._clientRegistryCache);
+    }
+    try {
+      const raw = await fsp6.readFile(this.clientRegistryPath, "utf8");
+      const data = JSON.parse(raw);
+      const map = /* @__PURE__ */ new Map();
+      for (const [id, client] of Object.entries(data)) {
+        map.set(id, client);
+      }
+      this._clientRegistryCache = map;
+      this._clientRegistryCacheAt = Date.now();
+      return new Map(map);
+    } catch (err) {
+      if (err.code === "ENOENT") {
+        const empty = /* @__PURE__ */ new Map();
+        this._clientRegistryCache = empty;
+        this._clientRegistryCacheAt = Date.now();
+        return empty;
+      }
+      throw err;
+    }
+  }
+  _pruneStaleClientsInPlace(registry) {
+    const cutoff = Date.now() - CLIENT_STALE_MS;
+    for (const client of registry.values()) {
+      if (new Date(client.lastSeenAt).getTime() < cutoff) {
+        client.lastSeenAt = new Date(cutoff).toISOString();
+      }
+    }
+  }
+  async _writeClientRegistry(registry) {
+    const obj = {};
+    for (const [id, client] of registry) {
+      obj[id] = client;
+    }
+    const tmp = `${this.clientRegistryPath}.${randomUUID().slice(0, 8)}.tmp`;
+    await fsp6.writeFile(tmp, JSON.stringify(obj, null, 2), "utf8");
+    await fsp6.rename(tmp, this.clientRegistryPath);
+  }
 };
 function defaultResolveProjectDir(ctx) {
   return resolveProjectDir(ctx.projectRoot, wstackGlobalRoot());