@wrongstack/core 0.155.0 → 0.250.0

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

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

package/dist/{agent-subagent-runner-Bsueu0J2.d.ts → agent-subagent-runner-Dz-9kiE6.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-B5wz-GXm.js';
-import { C as Container, R as ReadonlyPipeline, a as Renderer } from './pipeline-BG7UgbDc.js';
-import { E as EventBus, c as EventName, L as Listener } from './brain-CS_B0vIE.js';
-import { R as RetryPolicy, E as ErrorHandler } from './retry-policy-rutAfVeR.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-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 { L as Logger } from './logger-B63L5bTg.js';
 import { T as Tracer } from './observability-D-HZN_mF.js';
-import { P as PermissionPolicy } from './permission-B7nKnEvQ.js';
-import { U as Usage, C as Context, J as JSONSchema, R as Request, b as Response, g as ContentBlock, l as TextBlock, T as Tool, P as Provider, o as RunOptions } from './context-C7G_MtLV.js';
-import { W as WireFamily, H as HookEvent, e as HookMatcher, I as InProcessHook, h as Config } from './config-BaVThgnT.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';
 
 /**
  * Single fleet-wide event with subagent attribution. Whatever a child
@@ -737,7 +737,7 @@ interface SlashCommand {
      * the model's response starts streaming. `{ metadata }` carries
      * structured data for the REPL/TUI to act on (e.g. SDD session state).
      */
-    run(args: string, ctx: Context): Promise<{
+    run(args: string, ctx?: Context | undefined): Promise<{
         exit?: boolean | undefined;
         message?: string | undefined;
         runText?: string | undefined;
@@ -982,6 +982,7 @@ declare class Agent {
     private readonly _toolHandler;
     private readonly _responseHandler;
     private readonly _loopHandler;
+    private readonly _logger;
     constructor(init: AgentInit);
     get logger(): Logger;
     get retry(): RetryPolicy;

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

@@ -1,4 +1,4 @@
-import { U as Usage, C as Context, j as ToolProgressEvent, T as Tool } from './context-C7G_MtLV.js';
+import { U as Usage, C as Context, j as ToolProgressEvent, T as Tool } from './context-CLz3z_E8.js';
 
 type MemoryScope = 'project-agents' | 'project-memory' | 'user-memory';
 type MemoryType = 'fact' | 'decision' | 'convention' | 'preference' | 'reference' | 'anti_pattern';
@@ -115,6 +115,20 @@ interface EventMap {
         decision: BrainDecision;
         at: number;
     };
+    /**
+     * Fired by the BrainMonitor when it PROACTIVELY engaged (self-activation):
+     * a watched signal (tool-failure streak, error storm) crossed its
+     * threshold, the Brain was consulted, and — when the decision called for
+     * it — a corrective steer was delivered to the working agent.
+     */
+    'brain.intervention': {
+        kind: 'tool_failure_streak' | 'error_storm';
+        request: BrainDecisionRequest;
+        decision: BrainDecision;
+        /** True when a steer was actually delivered to the agent. */
+        intervened: boolean;
+        at: number;
+    };
     'session.started': {
         id: string;
     };
@@ -699,6 +713,16 @@ interface EventMap {
         branch?: string | undefined;
         error: string;
     };
+    /**
+     * Auto-proceed countdown tick, emitted once per second by the REPL while
+     * autonomy mode `auto` is counting down to self-driving the next suggestion.
+     * `remaining` is the number of whole seconds left. Display-only: the TUI
+     * StatusBar renders it as an "auto-proceed in Ns" chip; no consumer should
+     * derive behavior from it (the REPL owns the actual timer).
+     */
+    'countdown.tick': {
+        remaining: number;
+    };
     'memory.remembered': MemoryRememberedPayload;
     'memory.forgotten': MemoryForgottenPayload;
     'memory.cleared': MemoryClearedPayload;
@@ -959,4 +983,4 @@ declare class DefaultBrainArbiter implements BrainArbiter {
 }
 declare function formatHumanPrompt(request: BrainDecisionRequest): string;
 
-export { type BrainDecision as B, DefaultBrainArbiter as D, EventBus as E, HumanEscalatingBrainArbiter as H, type Listener as L, type MemoryScope as M, ObservableBrainArbiter as O, type ScoredEntry as S, type BrainDecisionRequest as a, type BrainArbiter as b, type EventName as c, type BrainDecisionOption as d, BrainDecisionQueue as e, type BrainDecisionSource as f, type BrainFallback as g, type BrainRisk as h, type DefaultBrainArbiterOptions as i, formatHumanPrompt as j, type MemoryEntry as k, type MemoryStore as l, type MemoryRelevanceContext as m, type EventLogger as n, type EventMap as o, MEMORY_TYPE_LABELS as p, type MemoryClearedPayload as q, type MemoryConsolidatedPayload as r, type MemoryForgottenPayload as s, type MemoryPriority as t, type MemoryRememberedPayload as u, type MemoryType as v, ScopedEventBus as w };
+export { type BrainArbiter as B, DefaultBrainArbiter as D, EventBus as E, HumanEscalatingBrainArbiter as H, type Listener as L, type MemoryScope as M, ObservableBrainArbiter as O, type ScoredEntry as S, type EventName as a, type BrainDecision as b, type BrainDecisionOption as c, BrainDecisionQueue as d, type BrainDecisionRequest as e, type BrainDecisionSource as f, type BrainFallback as g, type BrainRisk as h, type DefaultBrainArbiterOptions as i, formatHumanPrompt as j, type MemoryEntry as k, type MemoryStore as l, type MemoryRelevanceContext as m, type EventLogger as n, type EventMap as o, MEMORY_TYPE_LABELS as p, type MemoryClearedPayload as q, type MemoryConsolidatedPayload as r, type MemoryForgottenPayload as s, type MemoryPriority as t, type MemoryRememberedPayload as u, type MemoryType as v, ScopedEventBus as w };

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

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

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

@@ -1,4 +1,4 @@
-import { k as Capabilities, f as Permission } from './context-C7G_MtLV.js';
+import { k as Capabilities, f as Permission } from './context-CLz3z_E8.js';
 
 type ContextWindowModeId = 'balanced' | 'frugal' | 'deep' | 'archival';
 type ContextWindowAggressiveOn = 'hard' | 'soft' | 'warn';
@@ -393,6 +393,12 @@ interface IndexingConfig {
     watchExternal: boolean;
     /** Debounce window (ms) coalescing rapid edits to the same file. Default: 400. */
     debounceMs: number;
+    /**
+     * Watchdog timeout (ms) for a full index run. A run exceeding this is
+     * aborted (so it can never wedge the indexing mutex or freeze the terminal)
+     * and counts toward the indexing circuit breaker. Default: 120000.
+     */
+    indexTimeoutMs?: number | undefined;
 }
 /**
  * Saved launch preferences — restored on next boot so the pre-launch prompt
@@ -604,4 +610,4 @@ interface ConfigStore {
     watch(cb: (next: Readonly<Config>, prev: Readonly<Config>) => void): () => void;
 }
 
-export { type AutonomyConfig as A, type SyncCategory as B, type ContextWindowAggressiveOn as C, DEFAULT_CONTEXT_WINDOW_MODE_ID as D, formatContextWindowModeList as E, type FeaturesConfig as F, getContextWindowMode as G, type HookEvent as H, type InProcessHook as I, isContextWindowModeId as J, listContextWindowModes as K, type LaunchConfig as L, type ModelsRegistry as M, resolveContextWindowPolicy as N, type ProviderConfig as P, type ResolvedProvider as R, type ShellHook as S, type ToolsConfig as T, type WireFamily as W, type ModelsDevPayload as a, type ResolvedModel as b, type MCPServerConfig as c, type ModelMatrixEntry as d, type HookMatcher as e, type HookEntry as f, type ContextWindowPolicy as g, type Config as h, type ConfigStore as i, type ConfigLoader as j, type SyncConfig as k, type HookInput as l, type HookOutcome as m, CONTEXT_WINDOW_MODES as n, type ContextConfig as o, type ContextWindowConfigLike as p, type ContextWindowMode as q, type ContextWindowModeId as r, type ContextWindowThresholds as s, type CustomModelDefinition as t, type IndexingConfig as u, type LogConfig as v, type ModelsDevProvider as w, type PluginConfig as x, type ProviderApiKey as y, type SessionLoggingConfig as z };
+export { type AutonomyConfig as A, type SessionLoggingConfig as B, type ContextWindowAggressiveOn as C, DEFAULT_CONTEXT_WINDOW_MODE_ID as D, type SyncCategory as E, type FeaturesConfig as F, formatContextWindowModeList as G, type HookEvent as H, type InProcessHook as I, getContextWindowMode as J, isContextWindowModeId as K, type LaunchConfig as L, type ModelsRegistry as M, listContextWindowModes as N, resolveContextWindowPolicy as O, type ProviderConfig as P, type ResolvedProvider as R, type ShellHook as S, type ToolsConfig as T, type WireFamily as W, type ModelsDevPayload as a, type ResolvedModel as b, type MCPServerConfig as c, type ModelMatrixEntry as d, type HookMatcher as e, type HookEntry as f, type ContextWindowPolicy as g, type Config as h, type ConfigStore as i, type ConfigLoader as j, type SyncConfig as k, type HookInput as l, type HookOutcome as m, CONTEXT_WINDOW_MODES as n, type ContextConfig as o, type ContextWindowConfigLike as p, type ContextWindowMode as q, type ContextWindowModeId as r, type ContextWindowThresholds as s, type CustomModelDefinition as t, type IndexingConfig as u, type LogConfig as v, type ModelsDevModel as w, type ModelsDevProvider as x, type PluginConfig as y, type ProviderApiKey as z };

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

@@ -79,6 +79,23 @@ type MessageRole = 'user' | 'assistant' | 'system';
 interface Message {
     role: MessageRole;
     content: string | ContentBlock[];
+    /**
+     * ISO-8601 timestamp from the originating SessionEvent.
+     * Populated by SessionStore.replay() during session load/resume
+     * so consumers (WebUI, TUI, exports) can reconstruct the original
+     * conversation timeline instead of seeing every message stamped
+     * with "now". Absent for in-memory messages created during a live
+     * run — those use wall-clock time from the caller.
+     */
+    ts?: string | undefined;
+    /**
+     * Pre-computed token estimate for this message, set by
+     * ConversationState on append/replace. Used by estimateMessageTokens
+     * and estimateRequestTokens to skip the O(n·m) content-block walk
+     * on every context-pressure check. Undefined means "not yet computed"
+     * — the estimator falls back to walking content blocks.
+     */
+    _estTokens?: number | undefined;
 }
 declare function asBlocks(content: string | ContentBlock[]): ContentBlock[];
 declare function asText(content: string | ContentBlock[]): string;
@@ -140,6 +157,11 @@ declare const ERROR_CODES: {
     readonly FS_MKDIR_FAILED: "FS_MKDIR_FAILED";
     readonly FS_DELETE_FAILED: "FS_DELETE_FAILED";
     readonly FS_ATOMIC_WRITE_FAILED: "FS_ATOMIC_WRITE_FAILED";
+    readonly SDD_VALIDATION_FAILED: "SDD_VALIDATION_FAILED";
+    readonly SDD_PARSE_FAILED: "SDD_PARSE_FAILED";
+    readonly SDD_INVALID_STATE: "SDD_INVALID_STATE";
+    readonly SDD_NOT_READY: "SDD_NOT_READY";
+    readonly VALIDATION_ERROR: "VALIDATION_ERROR";
     readonly UNKNOWN: "UNKNOWN";
 };
 /**
@@ -148,7 +170,7 @@ declare const ERROR_CODES: {
  * a new code is added to `ERROR_CODES` — no need to keep two lists in sync.
  */
 type ErrorCode = (typeof ERROR_CODES)[keyof typeof ERROR_CODES];
-type ErrorSubsystem = 'provider' | 'tool' | 'config' | 'plugin' | 'agent' | 'session' | 'container' | 'fs' | 'general';
+type ErrorSubsystem = 'provider' | 'tool' | 'config' | 'plugin' | 'agent' | 'session' | 'sdd' | 'container' | 'fs' | 'general';
 type ErrorSeverity = 'fatal' | 'error' | 'warning';
 declare class WrongStackError extends Error {
     readonly code: ErrorCode;
@@ -242,6 +264,18 @@ declare class SessionError extends WrongStackError {
         cause?: unknown | undefined;
     });
 }
+/**
+ * SDD (Spec-Driven Development) errors — spec validation, parsing, and
+ * state machine violations in the AISpecBuilder, TaskFlow, and TaskTracker.
+ */
+declare class SddError extends WrongStackError {
+    constructor(opts: {
+        message: string;
+        code: Extract<ErrorCode, 'SDD_VALIDATION_FAILED' | 'SDD_PARSE_FAILED' | 'SDD_INVALID_STATE' | 'SDD_NOT_READY'>;
+        context?: Record<string, unknown> | undefined;
+        cause?: unknown | undefined;
+    });
+}
 /**
  * File system operation errors.
  */
@@ -262,6 +296,7 @@ declare function isPluginError(err: unknown): err is PluginError;
 declare function isSessionError(err: unknown): err is SessionError;
 declare function isAgentError(err: unknown): err is AgentError;
 declare function isFsError(err: unknown): err is FsError;
+declare function isSddError(err: unknown): err is SddError;
 
 type Permission = 'auto' | 'confirm' | 'deny';
 /**
@@ -317,6 +352,13 @@ type ToolStreamEvent<O = unknown> = ToolProgressEvent | ToolFinalEvent<O>;
 interface Tool<I = unknown, O = unknown> {
     name: string;
     description: string;
+    /**
+     * Pre-computed token estimate for this tool's definition (name +
+     * description + JSON-serialized inputSchema). Set by ToolRegistry on
+     * registration; consumed by estimateToolDefTokens / estimateRequestTokens
+     * to skip redundant JSON.stringify on every context-pressure check.
+     */
+    _estDefTokens?: number | undefined;
     usageHint?: string | undefined;
     /** Optional category for grouping in help lists and system prompts. */
     category?: string | undefined;
@@ -921,6 +963,16 @@ interface SessionData {
     events: SessionEvent[];
     messages: Message[];
     usage: Usage;
+    /** Tool execution records extracted from `tool_call_end` events — used for TUI tool entry rendering on resume. */
+    toolCallEnds: Array<{
+        name: string;
+        id: string;
+        durationMs: number;
+        ok: boolean;
+        outputBytes?: number | undefined;
+        outputTokens?: number | undefined;
+        outputLines?: number | undefined;
+    }>;
 }
 interface ResumedSession {
     writer: SessionWriter;
@@ -972,6 +1024,20 @@ interface SessionWriter {
      * Used by the REPL to serialize pending state into `session_end` for proper resume. */
     readonly pendingToolUses: string[];
     append(event: SessionEvent): Promise<void>;
+    /**
+     * Append a batch of events in one call. Semantically equivalent to calling
+     * `append()` for each event sequentially, but avoids N individual function
+     * calls, scrub/observe cycles, and timer rescheduling. The caller is
+     * responsible for ensuring events are in the correct order.
+     */
+    appendBatch(events: SessionEvent[]): Promise<void>;
+    /**
+     * Flush any buffered events to disk immediately. Use after critical
+     * events (user_input, llm_response) to ensure they survive a crash
+     * or SIGKILL that would otherwise leave them in the in-memory buffer.
+     * Idempotent — safe to call even when the buffer is empty.
+     */
+    flush(): Promise<void>;
     close(): Promise<void>;
     /**
      * Register a file change for later snapshotting.
@@ -1109,6 +1175,12 @@ declare class ConversationState {
     /**
      * Cheap immutable snapshot. Useful for tests and for compaction passes
      * that need a stable view across an async boundary.
+     *
+     * Uses shallow-freeze instead of deep-freeze: only the wrapper object
+     * and the three content arrays are frozen. Individual message/todo
+     * objects are NOT recursively frozen — they are reconstructed via
+     * spread copies and are immutable by convention. This cuts the freeze
+     * count from O(n·m·d) (n=messages, m=content blocks, d=depth) to O(1).
      */
     snapshot(): ReadonlyConversationState;
     appendMessage(message: Message): void;
@@ -1154,9 +1226,13 @@ interface RunEnv {
     readonly tokenCounter: TokenCounter;
     readonly cwd: string;
     readonly projectRoot: string;
+    /** Mutable working directory — starts as `cwd`. */
+    readonly workingDir: string;
     readonly model: string;
     readonly systemPrompt: readonly TextBlock[];
     readonly tools: readonly Tool[];
+    readonly agentId: string;
+    readonly agentName: string;
 }
 /**
  * Build a `RunEnv` view from a Context. The returned object is a shallow
@@ -1173,6 +1249,10 @@ interface TodoItem {
     content: string;
     status: 'pending' | 'in_progress' | 'completed';
     activeForm?: string | undefined;
+    /** When promoted from a plan item, stores the plan item's id. */
+    promotedFromPlan?: string | undefined;
+    /** When promoted from a task, stores the task's id. */
+    promotedFromTask?: string | undefined;
 }
 interface RunOptions {
     signal?: AbortSignal | undefined;
@@ -1195,8 +1275,14 @@ interface ContextInit {
     tokenCounter: TokenCounter;
     cwd: string;
     projectRoot: string;
+    /** Mutable working directory. Defaults to `cwd`. Must stay within `projectRoot`. */
+    workingDir?: string | undefined;
     model: string;
     tools?: Tool[] | undefined;
+    /** Agent id performing this run (e.g. 'leader', 'executor', 'tech-stack'). */
+    agentId?: string | undefined;
+    /** Human-readable agent name. */
+    agentName?: string | undefined;
 }
 /**
  * L1-A: `Context` is the live agent-run object. Its read-only environment
@@ -1205,6 +1291,15 @@ interface ContextInit {
  * `state` accessor). New code should declare the narrower type at its
  * parameter — pass `ctx` for it. Existing tools that accept `Context`
  * still work because `Context` structurally satisfies both.
+ *
+ * The single source of truth for the project directory is `projectRoot`.
+ * All tools (read/write/bash/exec) resolve paths relative to this.
+ * Sessions, config, memory, and logs are also stored under this root.
+ *
+ * There IS a mutable `workingDir` (separate from `projectRoot`) that can be
+ * changed at runtime via `setWorkingDir()`. It starts as `cwd` and allows
+ * the agent and user to navigate within the project without spawning a new
+ * process. All changes must stay inside `projectRoot`.
  */
 declare class Context implements RunEnv {
     messages: Message[];
@@ -1218,9 +1313,24 @@ declare class Context implements RunEnv {
     tokenCounter: TokenCounter;
     cwd: string;
     projectRoot: string;
+    /** Mutable working directory — starts as `cwd`. Change via `setWorkingDir()`. */
+    workingDir: string;
     model: string;
     tools: Tool[];
     meta: Record<string, unknown>;
+    /** Agent id performing this run (e.g. 'leader', 'executor'). */
+    agentId: string;
+    /** Human-readable agent name. */
+    agentName: string;
+    /** Callbacks fired when `setWorkingDir()` changes the working directory. */
+    private _onWorkingDirChanged;
+    /**
+     * Set to true when the conversation gains new tool_use or tool_result
+     * blocks — the only time repairToolUseAdjacency() can find new issues.
+     * buildAndRunRequestPipeline() checks this flag to skip an O(n) scan
+     * on iterations where no tool content was added (pure text responses).
+     */
+    toolAdjacencyDirty: boolean;
     constructor(init: ContextInit);
     /**
      * Observable wrapper over the mutable conversation state. Lazy so
@@ -1252,7 +1362,21 @@ declare class Context implements RunEnv {
     clearFileTracking(): void;
     hasRead(absPath: string): boolean;
     lastReadMtime(absPath: string): number | undefined;
+    /**
+     * Change the working directory for path resolution. Resolves relative paths
+     * against `projectRoot` and validates the result is within the project root.
+     * Fires all registered `onWorkingDirChanged` callbacks.
+     * Returns the resolved absolute path.
+     */
+    setWorkingDir(dir: string): string;
+    /**
+     * Register a callback that fires when the working directory changes.
+     * Returns an unsubscribe function. Callbacks are fired synchronously
+     * inside `setWorkingDir()` — errors in callbacks are swallowed so one
+     * bad listener doesn't prevent others from executing.
+     */
+    onWorkingDirChanged(cb: (newDir: string, oldDir: string) => void): () => void;
     usage(): Usage;
 }
 
-export { type ToolFinalEvent 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, SessionError as N, type StateChange as O, type Provider as P, type StateChangeHandler as Q, type Request as R, type SessionEvent as S, type Tool as T, type Usage as U, type StopReason as V, type StreamEvent as W, StreamHangError as X, type ThinkingBlock as Y, type ToolCallContext as Z, ToolError as _, type SessionWriter as a, type ToolStreamEvent as a0, WrongStackError as a1, asBlocks as a2, asText as a3, extractRunEnv as a4, isAgentError as a5, isConfigError as a6, isFsError as a7, isImageBlock as a8, isPluginError as a9, isSessionError as aa, isTextBlock as ab, isThinkingBlock as ac, isToolError as ad, isToolResultBlock as ae, isToolUseBlock as af, isWrongStackError as ag, toWrongStackError as ah, wrapAsState as ai, 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 TextBlock as l, type ToolUseBlock as m, type ToolResultBlock 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 { 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 };

package/dist/coordination/index.d.ts

@@ -1,19 +1,21 @@
-export { b as BrainArbiter, B as BrainDecision, d as BrainDecisionOption, e as BrainDecisionQueue, a 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-CS_B0vIE.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-CGOez8Le.js';
-import { A as AgentDefinition } from '../multi-agent-coordinator-BSKSFNhv.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-BSKSFNhv.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-Bsueu0J2.js';
-export { I as InMemoryAgentBridge, a as InMemoryBridgeTransport, c as createMessage } from '../agent-bridge-BbZU5TPN.js';
-import '../context-C7G_MtLV.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-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';
 import 'node:events';
 import '../director-state-BfeCUbmk.js';
-import '../config-BaVThgnT.js';
-import '../index-B5wz-GXm.js';
+import '../config-eSsrto5d.js';
+import '../index-IehiNryU.js';
 import '../logger-B63L5bTg.js';
-import '../pipeline-BG7UgbDc.js';
 import '../observability-D-HZN_mF.js';
-import '../permission-B7nKnEvQ.js';
-import '../retry-policy-rutAfVeR.js';
+import '../permission-DbWPbuoA.js';
+import '../retry-policy-BVnkbMET.js';
 
 /** Phase 1 · Discovery — map the territory before any work begins. */
 declare const DISCOVERY_AGENTS: AgentDefinition[];
@@ -42,4 +44,59 @@ declare const DELIVERY_AGENTS: AgentDefinition[];
 /** Phase 9 · Meta — agents that improve the agent system itself. */
 declare const META_AGENTS: AgentDefinition[];
 
-export { AgentDefinition, BUILD_AGENTS, DELIVERY_AGENTS, DISCOVERY_AGENTS, DOMAIN_AGENTS, KNOWLEDGE_AGENTS, META_AGENTS, PLANNING_AGENTS, REVIEW_AGENTS, VERIFY_AGENTS };
+/**
+ * mailbox-hooks — Tool-execution hooks for mailbox integration.
+ *
+ * 1. Before each tool call, checks the mailbox for unread high-priority
+ *    steer messages and emits a `mailbox.unread_count` event.
+ * 2. After each tool call, updates the agent heartbeat so other agents
+ *    know this one is still alive.
+ *
+ * This gives near-real-time mailbox checking (every tool call, not just
+ * iteration boundaries) and powers the "new mail" badge in the WebUI/TUI.
+ *
+ * @module mailbox-hooks
+ */
+
+interface MailboxHooksOptions {
+    /** The mailbox instance. */
+    mailbox: Mailbox;
+    /** Agent id for read-receipt and unread-check purposes. */
+    agentId: string;
+    /** Whether to emit new-mail notifications. Default: true. */
+    notifyNewMail?: boolean | undefined;
+    /** Whether to update heartbeat. Default: true. */
+    heartbeat?: boolean | undefined;
+}
+/**
+ * Create a pair of hooks for the tool execution pipeline.
+ *
+ * Usage:
+ *   const hooks = createMailboxHooks({ mailbox, agentId });
+ *   // In the tool executor, before each tool call:
+ *   await hooks.beforeTool({ events });
+ *   // After each tool call:
+ *   await hooks.afterTool();
+ *
+ * The `beforeTool` hook checks for unread messages and emits
+ * `mailbox.unread_count` events. The `afterTool` hook updates
+ * the agent heartbeat.
+ */
+declare function createMailboxHooks(opts: MailboxHooksOptions): {
+    /**
+     * Call before each tool execution. Checks mailbox and emits events.
+     * @param events — EventBus-like object with emit method.
+     */
+    beforeTool(events: {
+        emit: (type: string, payload: unknown) => void;
+    }): Promise<void>;
+    /**
+     * Call after each tool execution. Updates heartbeat and optionally
+     * current tool status.
+     */
+    afterTool(toolName?: string): Promise<void>;
+    /** Reset the cached unread count (e.g., after the agent checks manually). */
+    reset(): void;
+};
+
+export { AgentDefinition, BUILD_AGENTS, DELIVERY_AGENTS, DISCOVERY_AGENTS, DOMAIN_AGENTS, KNOWLEDGE_AGENTS, META_AGENTS, Mailbox, type MailboxHooksOptions, PLANNING_AGENTS, REVIEW_AGENTS, VERIFY_AGENTS, createMailboxHooks };