@wrongstack/core 0.269.0 → 0.272.0

package/dist/{agent-bridge-PcHQl_UQ.d.ts → agent-bridge-jVSZiygR.d.ts}

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

package/dist/{agent-subagent-runner-SHJW7t8q.d.ts → agent-subagent-runner-DOLIwBRo.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-W4VJCzHa.js';
-import { C as Container, R as ReadonlyPipeline, a as Renderer } from './pipeline-l_zzFRh3.js';
-import { E as EventBus, a as EventName, L as Listener } from './brain-BYcK__Ym.js';
-import { R as RetryPolicy, E as ErrorHandler } from './retry-policy-CtFhfwa8.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-Qo4kTzgw.js';
+import { C as Container, R as ReadonlyPipeline, a as Renderer } from './pipeline-sNIkhXeB.js';
+import { E as EventBus, a as EventName, L as Listener } from './brain-CdbbJWi3.js';
+import { R as RetryPolicy, E as ErrorHandler } from './retry-policy-BV7nzeAd.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-CvYQNUqZ.js';
-import { U as Usage, C as Context, J as JSONSchema, R as Request, b as Response, g as ContentBlock, p as TextBlock, T as Tool, P as Provider, s as RunOptions } from './context-Dp87Bcaq.js';
-import { W as WireFamily, H as HookEvent, f as HookMatcher, I as InProcessHook, i as Config } from './config-C_ae2k86.js';
+import { P as PermissionPolicy } from './permission-CC7XFYWG.js';
+import { U as Usage, C as Context, J as JSONSchema, c as Request, d as Response, i as ContentBlock, q as TextBlock, T as Tool, P as Provider, t as RunOptions } from './context-Dw55zZ_Q.js';
+import { W as WireFamily, H as HookEvent, f as HookMatcher, I as InProcessHook, i as Config } from './config-D2DGoGSQ.js';
 
 /**
  * Single fleet-wide event with subagent attribution. Whatever a child

package/dist/{brain-BYcK__Ym.d.ts → brain-CdbbJWi3.d.ts}

@@ -1,4 +1,4 @@
-import { U as Usage, C as Context, j as ToolProgressEvent, T as Tool, k as ToolOutputMetadata } from './context-Dp87Bcaq.js';
+import { U as Usage, C as Context, l as ToolProgressEvent, T as Tool, m as ToolOutputMetadata } from './context-Dw55zZ_Q.js';
 
 type MemoryScope = 'project-agents' | 'project-memory' | 'user-memory';
 type MemoryType = 'fact' | 'decision' | 'convention' | 'preference' | 'reference' | 'anti_pattern';
@@ -94,6 +94,27 @@ interface MemoryStore {
  * Subscribers cannot modify or cancel. Subscriber exceptions are caught.
  */
 
+/**
+ * Structural shape of a tracked agent as flushed by AgentStatusTracker. Kept
+ * structural (not imported from the root `session-registry` module) so the
+ * low-level kernel layer takes on no dependency on composition modules. The
+ * real `AgentEntry` is assignable to this.
+ */
+interface TrackedAgentSnapshot {
+    id: string;
+    name: string;
+    status: string;
+    currentTool?: string | undefined;
+    iterations: number;
+    toolCalls: number;
+    costUsd?: number | undefined;
+    tokensIn?: number | undefined;
+    tokensOut?: number | undefined;
+    ctxPct?: number | undefined;
+    model?: string | undefined;
+    partialText?: string | undefined;
+    lastActivityAt: string;
+}
 interface EventMap {
     'brain.decision_requested': {
         request: BrainDecisionRequest;
@@ -146,6 +167,15 @@ interface EventMap {
         sessionId: string;
         detail: string;
     };
+    /**
+     * Fired by AgentStatusTracker after every flush with the full agent list
+     * (leader + subagents). In-process consumers (e.g. the HQ session-telemetry
+     * bridge) read this to build live snapshots without re-reading the shared
+     * session-registry file.
+     */
+    'session.agents_updated': {
+        agents: readonly TrackedAgentSnapshot[];
+    };
     'iteration.started': {
         ctx: Context;
         index: number;
@@ -408,6 +438,46 @@ interface EventMap {
         costUsd?: number | undefined;
         subagentId?: string | undefined;
     };
+    /**
+     * Fired when a subagent produces an assistant text block that should
+     * appear in the main chat timeline (when agent streaming is enabled).
+     * The payload carries the subagent's identity, the message content,
+     * and the iteration index so UIs can render a threaded timeline.
+     */
+    'agent.timeline.message': {
+        /** Subagent id (e.g. "bug-hunter@abc123"). */
+        subagentId: string;
+        /** Human-readable name or role label. */
+        agentName: string;
+        /** The assistant text block content, or a tool-call summary. */
+        content: string;
+        /** 'text' | 'tool_use' | 'error' | 'status' */
+        kind: 'text' | 'tool_use' | 'error' | 'status';
+        /** Iteration index within the subagent's own run. */
+        iteration: number;
+        /** ISO 8601 timestamp. */
+        ts: string;
+        /** When kind='tool_use', the tool name. */
+        toolName?: string | undefined;
+        /** Running cost estimate for this subagent so far. */
+        costUsd?: number | undefined;
+    };
+    /**
+     * Fired when a subagent's status changes (started, completed, failed,
+     * timed out, stopped). UIs use this to update agent status indicators
+     * and add status-change entries to the timeline.
+     */
+    'agent.status_changed': {
+        subagentId: string;
+        agentName: string;
+        status: 'spawned' | 'running' | 'completed' | 'failed' | 'timeout' | 'stopped' | 'budget_exhausted';
+        /** ISO 8601 timestamp. */
+        ts: string;
+        /** Human-readable summary or error message. */
+        summary?: string | undefined;
+        /** Task description when available. */
+        task?: string | undefined;
+    };
     /**
      * Fired on every `iteration.completed`. UIs subscribe to render a live
      * context-window fill bar per agent (e.g. "67% ████████░░"). The

package/dist/{compactor-C2RKEBtC.d.ts → compactor-72ug-ZRB.d.ts}

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

package/dist/{config-C_ae2k86.d.ts → config-D2DGoGSQ.d.ts}

@@ -1,4 +1,4 @@
-import { l as ReasoningConfig, m as Capabilities, f as Permission, n as ReasoningEffort, o as CacheTtl } from './context-Dp87Bcaq.js';
+import { a as ReasoningConfig, n as Capabilities, h as Permission, o as ReasoningEffort, p as CacheTtl } from './context-Dw55zZ_Q.js';
 
 type ContextWindowModeId = 'balanced' | 'frugal' | 'deep' | 'archival';
 type ContextWindowAggressiveOn = 'hard' | 'soft' | 'warn';
@@ -264,6 +264,33 @@ interface ModelRuntimeCacheConfig {
 interface ModelRuntimeConfig {
     reasoning?: ModelRuntimeReasoningConfig | undefined;
     cache?: ModelRuntimeCacheConfig | undefined;
+    /**
+     * Generic generation parameters mapped directly onto `Request` fields.
+     * Only sent when the active model's `Capabilities` advertise support.
+     */
+    parameters?: ModelRuntimeParametersConfig | undefined;
+}
+/**
+ * Generic generation parameters the user can set per-session / per-project.
+ * Each field maps to a `Request` field of the same name and is gated by the
+ * corresponding `Capabilities` flag so unsupported models don't receive
+ * parameters they'd reject.
+ */
+interface ModelRuntimeParametersConfig {
+    /** Top-K sampling (Anthropic, Gemini). Gated by `capabilities.topK`. */
+    topK?: number | undefined;
+    /** Frequency penalty (OpenAI, Gemini). Gated by `capabilities.frequencyPenalty`. */
+    frequencyPenalty?: number | undefined;
+    /** Presence penalty (OpenAI, Gemini). Gated by `capabilities.presencePenalty`. */
+    presencePenalty?: number | undefined;
+    /** Random seed (OpenAI, Gemini). Gated by `capabilities.seed`. */
+    seed?: number | undefined;
+    /** End-user identifier for abuse monitoring. */
+    user?: string | undefined;
+    /** Log probabilities (OpenAI, Gemini). Gated by `capabilities.logprobs`. */
+    logprobs?: boolean | undefined;
+    /** Number of top logprobs to return (OpenAI). Only when `logprobs` is true. */
+    topLogprobs?: number | undefined;
 }
 /**
  * HQ client connection settings. Same-machine clients can auto-discover the
@@ -827,4 +854,4 @@ interface ConfigStore {
     watch(cb: (next: Readonly<Config>, prev: Readonly<Config>) => void): () => void;
 }
 
-export { normalizeTokenSavingTier as $, type AutonomyConfig as A, MAX_TUI_THINKING_WORD_LENGTH as B, type ContextWindowAggressiveOn as C, DEFAULT_CONTEXT_WINDOW_MODE_ID as D, type ModelRuntimeCacheConfig as E, type FeaturesConfig as F, type ModelRuntimeConfig as G, type HookEvent as H, type InProcessHook as I, type ModelRuntimeReasoningConfig as J, type ModelsDevProvider as K, type LaunchConfig as L, type ModelsRegistry as M, type PluginConfig as N, type ProviderApiKey as O, type ProviderConfig as P, type SessionLoggingConfig as Q, type ResolvedProvider as R, type ShellHook as S, type TokenSavingTier as T, type SyncCategory as U, type ToolsConfig as V, type WireFamily as W, formatContextWindowModeList as X, getContextWindowMode as Y, isContextWindowModeId as Z, listContextWindowModes as _, type ModelsDevPayload as a, normalizeTuiThinkingWord as a0, resolveContextWindowPolicy as a1, type ResolvedModel as b, type MCPServerConfig as c, type ModelMatrixEntry as d, type ModelsDevModel as e, type HookMatcher as f, type HookEntry as g, type ContextWindowPolicy as h, type Config as i, type ConfigStore as j, type ConfigLoader as k, type SyncConfig as l, type HookInput as m, type HookOutcome as n, CONTEXT_WINDOW_MODES as o, type CircuitBreakerRuntimeConfig as p, type ContextConfig as q, type ContextWindowConfigLike as r, type ContextWindowMode as s, type ContextWindowModeId as t, type ContextWindowThresholds as u, type CustomModelDefinition as v, DEFAULT_TUI_THINKING_WORD as w, type HqClientConfig as x, type IndexingConfig as y, type LogConfig as z };
+export { listContextWindowModes as $, type AutonomyConfig as A, MAX_TUI_THINKING_WORD_LENGTH as B, type ContextWindowAggressiveOn as C, DEFAULT_CONTEXT_WINDOW_MODE_ID as D, type ModelRuntimeCacheConfig as E, type FeaturesConfig as F, type ModelRuntimeConfig as G, type HookEvent as H, type InProcessHook as I, type ModelRuntimeParametersConfig as J, type ModelRuntimeReasoningConfig as K, type LaunchConfig as L, type ModelsRegistry as M, type ModelsDevProvider as N, type PluginConfig as O, type ProviderConfig as P, type ProviderApiKey as Q, type ResolvedProvider as R, type ShellHook as S, type TokenSavingTier as T, type SessionLoggingConfig as U, type SyncCategory as V, type WireFamily as W, type ToolsConfig as X, formatContextWindowModeList as Y, getContextWindowMode as Z, isContextWindowModeId as _, type ModelsDevPayload as a, normalizeTokenSavingTier as a0, normalizeTuiThinkingWord as a1, resolveContextWindowPolicy as a2, type ResolvedModel as b, type MCPServerConfig as c, type ModelMatrixEntry as d, type ModelsDevModel as e, type HookMatcher as f, type HookEntry as g, type ContextWindowPolicy as h, type Config as i, type ConfigStore as j, type ConfigLoader as k, type SyncConfig as l, type HookInput as m, type HookOutcome as n, CONTEXT_WINDOW_MODES as o, type CircuitBreakerRuntimeConfig as p, type ContextConfig as q, type ContextWindowConfigLike as r, type ContextWindowMode as s, type ContextWindowModeId as t, type ContextWindowThresholds as u, type CustomModelDefinition as v, DEFAULT_TUI_THINKING_WORD as w, type HqClientConfig as x, type IndexingConfig as y, type LogConfig as z };

package/dist/{context-Dp87Bcaq.d.ts → context-Dw55zZ_Q.d.ts}

@@ -527,6 +527,50 @@ interface ToolErrorInfo {
  */
 type ReasoningEffort = 'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | 'max';
 type CacheTtl = '5m' | '1h';
+/**
+ * Provider-agnostic response-format directive.
+ *
+ * - `{ type: 'text' }` — free-form text (default).
+ * - `{ type: 'json_object' }` — valid JSON without a schema constraint.
+ * - `{ type: 'json_schema', jsonSchema: { name, schema, strict? } }` — JSON
+ *   constrained to the supplied JSON Schema. The `strict` flag is
+ *   OpenAI-specific; Gemini ignores it in favour of `responseMimeType`.
+ *
+ * Each provider adapter maps this into its own wire format:
+ *   OpenAI  → `response_format`
+ *   Gemini  → `responseMimeType` + `responseSchema`
+ *   Anthropic → (not yet supported; uses tools for structured output)
+ */
+interface JsonSchemaSpec {
+    name: string;
+    /** OpenAI-specific: enable strict schema adherence. */
+    strict?: boolean | undefined;
+    /** The JSON Schema object describing the expected shape. */
+    schema: Record<string, unknown>;
+    /** Optional human-readable description (OpenAI). */
+    description?: string | undefined;
+}
+type ResponseFormat = {
+    type: 'text';
+} | {
+    type: 'json_object';
+} | {
+    type: 'json_schema';
+    jsonSchema: JsonSchemaSpec;
+};
+/**
+ * Safety category threshold pair used by Google Gemini's `safetySettings`.
+ *
+ * Categories: `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_HATE_SPEECH`,
+ * `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_DANGEROUS_CONTENT`.
+ *
+ * Thresholds: `BLOCK_NONE`, `BLOCK_ONLY_HIGH`, `BLOCK_MEDIUM_AND_ABOVE`,
+ * `BLOCK_LOW_AND_ABOVE`.
+ */
+interface SafetySetting {
+    category: string;
+    threshold: string;
+}
 interface Usage {
     input: number;
     output: number;
@@ -563,6 +607,26 @@ interface Capabilities {
     reasoning: boolean;
     maxContext: number;
     cacheControl: 'native' | 'auto' | 'none';
+    /** Model accepts `top_k` / `topK` sampling parameter. */
+    topK?: boolean | undefined;
+    /** Model accepts `frequency_penalty` / `frequencyPenalty` parameter. */
+    frequencyPenalty?: boolean | undefined;
+    /** Model accepts `presence_penalty` / `presencePenalty` parameter. */
+    presencePenalty?: boolean | undefined;
+    /** Model accepts `seed` parameter for deterministic generation. */
+    seed?: boolean | undefined;
+    /**
+     * Model accepts JSON Schema / structured-output constraints
+     * (OpenAI `response_format.json_schema`, Gemini `responseMimeType`+`responseSchema`).
+     * Distinct from `jsonMode` (which is just a system-prompt hint).
+     */
+    structuredOutput?: boolean | undefined;
+    /** Model supports log-probability output (`logprobs`, `top_logprobs`). */
+    logprobs?: boolean | undefined;
+    /** Model supports audio input/output modality. */
+    audio?: boolean | undefined;
+    /** Model supports the `n` parameter for multiple completions. */
+    multipleCompletions?: boolean | undefined;
 }
 interface Request {
     model: string;
@@ -572,6 +636,36 @@ interface Request {
     maxTokens: number;
     temperature?: number | undefined;
     topP?: number | undefined;
+    topK?: number | undefined;
+    frequencyPenalty?: number | undefined;
+    presencePenalty?: number | undefined;
+    seed?: number | undefined;
+    /**
+     * End-user identifier for abuse monitoring and per-user rate limiting.
+     * - Anthropic → `metadata.user_id`
+     * - OpenAI   → `user`
+     * - Gemini   → (not supported)
+     */
+    user?: string | undefined;
+    /**
+     * Number of response candidates to generate. Google Gemini supports
+     * this via `generationConfig.candidateCount`. OpenAI does not have
+     * an equivalent (`n` is conceptually similar but distinct).
+     */
+    candidateCount?: number | undefined;
+    /**
+     * Whether to return log probabilities for output tokens.
+     * - OpenAI → `logprobs: boolean` (+ `topLogprobs: number`)
+     * - Gemini → `generationConfig.logprobs: number` (how many top candidates)
+     * Default undefined = no logprobs requested.
+     */
+    logprobs?: boolean | undefined;
+    /**
+     * Number of most probable tokens to return log probabilities for
+     * (OpenAI `top_logprobs`). Only meaningful when `logprobs` is true.
+     * Range: 0-20. Gemini ignores this (uses `logprobs` as the count).
+     */
+    topLogprobs?: number | undefined;
     stopSequences?: string[] | undefined;
     toolChoice?: 'auto' | 'required' | 'none' | {
         type: 'tool' | undefined;
@@ -579,6 +673,21 @@ interface Request {
     };
     reasoning?: ReasoningRequest | undefined;
     cache?: RequestCacheControl | undefined;
+    /**
+     * Structured-output / response-format directive.
+     * When set, the provider adapter maps this to its native response-format
+     * parameter (OpenAI `response_format`, Gemini `responseMimeType`, etc.).
+     * The model must advertise `capabilities.structuredOutput` for this to be
+     * honoured; unsupported models will likely 400 or ignore it.
+     */
+    responseFormat?: ResponseFormat | undefined;
+    /**
+     * Safety category thresholds for filtering harmful content.
+     * - Gemini → top-level `safetySettings` array with `{ category, threshold }`
+     * - OpenAI → not supported (uses server-side moderation)
+     * - Anthropic → not supported
+     */
+    safetySettings?: SafetySetting[] | undefined;
 }
 type StopReason = 'end_turn' | 'tool_use' | 'max_tokens' | 'stop_sequence' | 'refusal';
 interface Response {
@@ -1549,4 +1658,4 @@ declare class Context implements RunEnv {
     usage(): Usage;
 }
 
-export { type RunEnv as $, AgentError as A, type ContextFileEvidence as B, Context as C, type ContextInit as D, type ContextIntentEvidence as E, type ContextRepeatedReadEvidence as F, ERROR_CODES as G, type ErrorCode as H, type ErrorSeverity as I, type JSONSchema as J, type ErrorSubsystem as K, type FileSnapshot as L, type Message as M, FsError as N, type ImageBlock as O, type Provider as P, type MessageRole as Q, type Request as R, type SessionEvent as S, type Tool as T, type Usage as U, PluginError as V, type ProviderErrorBody as W, type ReadonlyConversationState as X, type ReasoningRequest as Y, type RequestCacheControl as Z, type RiskTier as _, type SessionWriter as a, SddError as a0, SessionError as a1, type StateChange as a2, type StateChangeHandler as a3, type StopReason as a4, type StreamEvent as a5, StreamHangError as a6, type ThinkingBlock as a7, type ToolCallContext as a8, ToolError as a9, ToolErrorCategory as aa, type ToolErrorInfo as ab, type ToolEvidenceStatus as ac, type ToolFinalEvent as ad, type ToolIconId as ae, type ToolStreamEvent as af, WrongStackError as ag, asBlocks as ah, asText as ai, extractRunEnv as aj, isAgentError as ak, isConfigError as al, isFsError as am, isImageBlock as an, isPluginError as ao, isSddError as ap, isSessionError as aq, isTextBlock as ar, isThinkingBlock as as, isToolError as at, isToolResultBlock as au, isToolUseBlock as av, isWrongStackError as aw, toWrongStackError as ax, wrapAsState as ay, type Response as b, type TokenCounter as c, type CacheStats as d, ProviderError as e, type Permission as f, type ContentBlock as g, type SessionMetadata as h, type SessionStore as i, type ToolProgressEvent as j, type ToolOutputMetadata as k, type ReasoningConfig as l, type Capabilities as m, type ReasoningEffort as n, type CacheTtl as o, type TextBlock as p, type ToolUseBlock as q, type ToolResultBlock as r, type RunOptions as s, type ResumedSession as t, type SessionData as u, type SessionSummary as v, type TodoItem as w, ConversationState as x, ConfigError as y, type ContextEvidenceState as z };
+export { type ResponseFormat as $, AgentError as A, type ContextEvidenceState as B, Context as C, type ContextFileEvidence as D, type ContextInit as E, type ContextIntentEvidence as F, type ContextRepeatedReadEvidence as G, ERROR_CODES as H, type ErrorCode as I, type JSONSchema as J, type ErrorSeverity as K, type ErrorSubsystem as L, type Message as M, type FileSnapshot as N, FsError as O, type Provider as P, type ImageBlock as Q, type ReasoningRequest as R, type SessionEvent as S, type Tool as T, type Usage as U, type JsonSchemaSpec as V, type MessageRole as W, PluginError as X, type ProviderErrorBody as Y, type ReadonlyConversationState as Z, type RequestCacheControl as _, type ReasoningConfig as a, type RiskTier as a0, type RunEnv as a1, type SafetySetting as a2, SddError as a3, SessionError as a4, type StateChange as a5, type StateChangeHandler as a6, type StopReason as a7, type StreamEvent as a8, StreamHangError as a9, toWrongStackError as aA, wrapAsState as aB, type ThinkingBlock as aa, type ToolCallContext as ab, ToolError as ac, ToolErrorCategory as ad, type ToolErrorInfo as ae, type ToolEvidenceStatus as af, type ToolFinalEvent as ag, type ToolIconId as ah, type ToolStreamEvent as ai, WrongStackError as aj, asBlocks as ak, asText as al, extractRunEnv as am, isAgentError as an, isConfigError as ao, isFsError as ap, isImageBlock as aq, isPluginError as ar, isSddError as as, isSessionError as at, isTextBlock as au, isThinkingBlock as av, isToolError as aw, isToolResultBlock as ax, isToolUseBlock as ay, isWrongStackError as az, type SessionWriter as b, type Request as c, type Response as d, type TokenCounter as e, type CacheStats as f, ProviderError as g, type Permission as h, type ContentBlock as i, type SessionMetadata as j, type SessionStore as k, type ToolProgressEvent as l, type ToolOutputMetadata as m, type Capabilities as n, type ReasoningEffort as o, type CacheTtl as p, type TextBlock as q, type ToolUseBlock as r, type ToolResultBlock as s, type RunOptions as t, type ResumedSession as u, type SessionData as v, type SessionSummary as w, type TodoItem as x, ConversationState as y, ConfigError as z };

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-CdbbJWi3.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-CdbbJWi3.js';
+import { H as FleetManager, s as Director } from '../null-fleet-bus-BxTfXBKo.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-BxTfXBKo.js';
+import { b as AgentDefinition } from '../multi-agent-coordinator-BvbdNQ14.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-BvbdNQ14.js';
+import { F as FleetBus } from '../agent-subagent-runner-DOLIwBRo.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-DOLIwBRo.js';
+export { I as InMemoryAgentBridge, a as InMemoryBridgeTransport, c as createMessage } from '../agent-bridge-jVSZiygR.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-CQj_C9Dp.js';
+import { C as Context, T as Tool } from '../context-Dw55zZ_Q.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 '../config-D2DGoGSQ.js';
+import '../index-Qo4kTzgw.js';
+import '../pipeline-sNIkhXeB.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,93 @@ 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;
+
+export { 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 };