@wrongstack/core 0.286.0 → 0.287.0

package/dist/kernel/events/agent-events.d.ts

@@ -0,0 +1,283 @@
+import type { Context } from '../../core/context.js';
+export interface AgentEventMap {
+    /**
+     * Fired around a single Agent.run() call. Status trackers use these to
+     * measure active-run elapsed time instead of inferring it from iterations.
+     */
+    'agent.run.started': {
+        sessionId?: string | undefined;
+        ctx: Context;
+        model: string;
+        at: string;
+    };
+    'agent.run.completed': {
+        sessionId?: string | undefined;
+        ctx: Context;
+        status: 'done' | 'failed' | 'max_iterations' | 'aborted';
+        iterations: number;
+        at: string;
+        durationMs: number;
+    };
+    'agent.run.error': {
+        sessionId?: string | undefined;
+        ctx: Context;
+        err: Error;
+        at: string;
+        durationMs: number;
+    };
+    /**
+     * Fired by the `delegate` tool right before it hands work to a subagent
+     * and blocks on the result. Lets UIs render a "started delegating" line
+     * immediately instead of looking idle for the (often minutes-long) life
+     * of the subagent. Paired with `delegate.completed`.
+     */
+    'delegate.started': {
+        /** Parent/host session id for the delegation lifecycle. */
+        sessionId?: string | undefined;
+        /** Resolved roster role or free-form subagent name. */
+        target: string;
+        /** The task instruction handed to the subagent (untruncated — UIs trim). */
+        task: string;
+    };
+    /**
+     * Fired by the `delegate` tool once the subagent settles (success,
+     * timeout, budget exhaustion, error). Carries human-friendly, untruncated
+     * fields so UIs / the Telegram bridge can render a readable summary
+     * instead of the JSON-stringified, ~400-char-truncated `tool.executed`
+     * preview.
+     */
+    'delegate.completed': {
+        /** Parent/host session id for the delegation lifecycle. */
+        sessionId?: string | undefined;
+        /** Resolved roster role or free-form subagent name. */
+        target: string;
+        /** The task instruction handed to the subagent. */
+        task: string;
+        /** True only when the subagent finished its task cleanly. */
+        ok: boolean;
+        /** Task status — 'success' | 'timeout' | 'host_timeout' | 'stopped' | ... */
+        status?: string | undefined;
+        /** One-line human summary (from `buildDelegateSummary`), untruncated. */
+        summary: string;
+        durationMs: number;
+        iterations: number;
+        toolCalls: number;
+        /** Estimated subagent cost in USD, from the director usage snapshot when known. */
+        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': {
+        /** Parent/host session id this subagent timeline belongs to. */
+        sessionId?: string | undefined;
+        /** 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;
+        /** Timeline entry kind. */
+        kind: 'text' | 'thinking' | 'tool_use' | 'tool_result' | 'error' | 'status' | 'system';
+        /** 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': {
+        /** Parent/host session id this subagent status belongs to. */
+        sessionId?: string | undefined;
+        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;
+    };
+    /**
+     * Subagent lifecycle events. Emitted by `MultiAgentHost` so the TUI can
+     * surface what's happening in the fleet without needing director-mode
+     * (which renders the live FleetPanel). These complement the FleetBus
+     * (director-only) by giving the TUI a uniform feed for both `/spawn`
+     * and director-orchestrated work.
+     */
+    'subagent.spawned': {
+        /** Parent/host session id. Subagents remain children of this session. */
+        sessionId?: string | undefined;
+        subagentId: string;
+        taskId: string;
+        name?: string | undefined;
+        provider?: string | undefined;
+        model?: string | undefined;
+        description?: string | undefined;
+        /**
+         * Absolute path to the per-subagent JSONL transcript on disk, when
+         * one was created. Undefined when the subagent shares the parent
+         * session writer (in-memory or single-file configurations).
+         * Surfaced so the TUI (FleetPanel) and `/fleet log` can show the
+         * user *where* to look without computing it from the run id.
+         */
+        transcriptPath?: string | undefined;
+    };
+    'subagent.task_started': {
+        /** Parent/host session id. */
+        sessionId?: string | undefined;
+        subagentId: string;
+        taskId: string;
+        description?: string | undefined;
+    };
+    /**
+     * Fired by `MultiAgentHost` when a subagent hits a soft budget limit
+     * and the coordinator is auto-extending. TUI renders this as a
+     * status-line notice: "⚡ agent#name hitting kind limit (used/limit) — extending".
+     * After the auto-extend the task either continues or the coordinator
+     * denies the extension and the task ends with 'budget_exhausted'.
+     */
+    'subagent.budget_warning': {
+        /** Parent/host session id. */
+        sessionId?: string | undefined;
+        subagentId: string;
+        kind: string;
+        used: number;
+        limit: number;
+    };
+    /**
+     * Emitted when the coordinator/director actually GRANTS a budget
+     * extension to a subagent (the resolution of a `budget.threshold_reached`
+     * negotiation). Distinct from `subagent.budget_warning`, which fires when
+     * a limit is merely *hit*. UIs use this to render a persistent "⚡ extended
+     * ×N" badge so users can see how often an agent self-extended to stay
+     * alive. `totalExtensions` is the cumulative count for this subagent across
+     * all kinds; `newLimit` is the patched value for `kind`.
+     */
+    'subagent.budget_extended': {
+        /** Parent/host session id. */
+        sessionId?: string | undefined;
+        subagentId: string;
+        kind: string;
+        newLimit: number;
+        totalExtensions: number;
+    };
+    /**
+     * Per-tool-call event re-emitted from a subagent's own EventBus
+     * onto the host EventBus, so the TUI / non-director surfaces can
+     * render "AGENT#1 ● bash 250ms" without having to subscribe to
+     * the director-only FleetBus. Fired AFTER the tool completes
+     * (paired with `tool.executed`). Includes the subagent id so
+     * multiple parallel subagents are distinguishable.
+     */
+    'subagent.tool_executed': {
+        /** Parent/host session id. */
+        sessionId?: string | undefined;
+        subagentId: string;
+        taskId?: string | undefined;
+        name: string;
+        durationMs: number;
+        ok: boolean;
+        input?: unknown | undefined;
+        outputBytes?: number | undefined;
+    };
+    /**
+     * Periodic progress snapshot emitted by the subagent runner every ~25
+     * iterations so the user can track what a subagent is doing without
+     * looking at the FleetPanel. The leader's TUI surfaces this as a
+     * chat history entry: "AGENT#2 💬 L25 · 47 tools · $0.023 · doing grep..."
+     * Fired on a best-effort basis — slow subagents may skip emissions if
+     * the 25-iteration window passes while the agent is between tool calls.
+     */
+    'subagent.iteration_summary': {
+        /** Parent/host session id. */
+        sessionId?: string | undefined;
+        subagentId: string;
+        iteration: number;
+        toolCalls: number;
+        costUsd: number;
+        currentTool?: string | undefined;
+        partialText?: string | undefined;
+    };
+    'subagent.task_completed': {
+        /** Parent/host session id. */
+        sessionId?: string | undefined;
+        subagentId: string;
+        taskId: string;
+        status: 'success' | 'failed' | 'timeout' | 'stopped';
+        iterations: number;
+        toolCalls: number;
+        durationMs: number;
+        /**
+         * Structured failure envelope when `status !== 'success'`. Carries
+         * `kind` (one of `SubagentErrorKind`), `message`, `retryable`, and
+         * optional `backoffMs`. UIs branch on `kind` to render the right
+         * chip (rate_limit vs auth vs tool_failed). The type is imported
+         * lazily as a structural object to avoid a coordination → kernel
+         * cycle in the dependency graph.
+         */
+        error?: {
+            kind: string;
+            message: string;
+            retryable: boolean;
+            backoffMs?: number | undefined;
+            cause?: {
+                name: string | undefined;
+                message: string;
+                stack?: string | undefined;
+            } | undefined;
+        } | undefined;
+        /** Final assistant text from the subagent's last turn. */
+        finalText?: string | undefined;
+    };
+    /**
+     * Fired after a subagent has been removed from the live coordinator and its
+     * resources released. Surfaces must delete the agent instead of retaining a
+     * terminal/idle card indefinitely.
+     */
+    'subagent.removed': {
+        sessionId?: string | undefined;
+        subagentId: string;
+        reason?: string | undefined;
+    };
+    /**
+     * Fired by the delegate tool when a subagent finishes. The agent's run
+     * loop listens for this to collect `delegateSummaries` for the RunResult,
+     * so the CLI/TUI can render flashy completion banners.
+     */
+    'subagent.done': {
+        sessionId?: string | undefined;
+        summary: string;
+        ok: boolean;
+    };
+    /**
+     * Fired by MultiAgentHost when a subagent's context window load changes.
+     * The leader agent's ctx.pct is emitted directly on the host EventBus;
+     * subagent ctx.pct events are forwarded here with subagentId attribution.
+     * TUI uses this to render live context fill bars per agent.
+     */
+    'subagent.ctx_pct': {
+        /** Parent/host session id. */
+        sessionId?: string | undefined;
+        subagentId: string;
+        /** Fraction of maxContext currently in use, clamped to 0..1 for display. */
+        load: number;
+        /** Unclamped fraction when available. Can exceed 1 when over budget. */
+        rawLoad?: number | undefined;
+        tokens: number;
+        maxContext: number;
+    };
+}
+//# sourceMappingURL=agent-events.d.ts.map

package/dist/kernel/events/agent-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-events.d.ts","sourceRoot":"","sources":["../../../src/kernel/events/agent-events.ts"],"names":[],"mappings":"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"}

package/dist/kernel/events/brain-events.d.ts

@@ -0,0 +1,176 @@
+import type { BrainDecision, BrainDecisionRequest } from '../../coordination/brain.js';
+import type { Usage } from '../../types/provider.js';
+import type { BrainInterventionKind } from '../events.js';
+export interface BrainEventMap {
+    'brain.decision_requested': {
+        sessionId?: string | undefined;
+        request: BrainDecisionRequest;
+        at: number;
+    };
+    'brain.decision_answered': {
+        sessionId?: string | undefined;
+        request: BrainDecisionRequest;
+        decision: BrainDecision;
+        at: number;
+    };
+    'brain.decision_ask_human': {
+        sessionId?: string | undefined;
+        request: BrainDecisionRequest;
+        decision: BrainDecision;
+        at: number;
+    };
+    'brain.human_answered': {
+        sessionId?: string | undefined;
+        id: string;
+        optionId?: string | undefined;
+        deny?: boolean | undefined;
+        text?: string | undefined;
+        at: number;
+    };
+    'brain.decision_denied': {
+        sessionId?: string | undefined;
+        request: BrainDecisionRequest;
+        decision: BrainDecision;
+        at: number;
+    };
+    /**
+     * Fired by the BrainMonitor when it PROACTIVELY engaged (self-activation):
+     * a watched signal (tool-failure streak, error storm, agent stall,
+     * file-churn oscillation) 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': {
+        sessionId?: string | undefined;
+        kind: BrainInterventionKind;
+        request: BrainDecisionRequest;
+        decision: BrainDecision;
+        /** True when a steer was actually delivered to the agent. */
+        intervened: boolean;
+        at: number;
+    };
+    /**
+     * Fired by the BrainDecisionLedger when the real-world outcome of an
+     * earlier Brain decision becomes observable (e.g. a budget-extended
+     * subagent's task later completed or failed, or a steered signal
+     * re-triggered). Closes the decide → observe → learn loop: outcome stats
+     * are fed back into the LLM/council decision prompts.
+     */
+    'brain.outcome': {
+        sessionId?: string | undefined;
+        /** The `BrainDecisionRequest.id` of the decision this outcome belongs to. */
+        requestId: string;
+        outcome: 'success' | 'failure';
+        detail?: string | undefined;
+        at: number;
+    };
+    'token.threshold': {
+        sessionId?: string | undefined;
+        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': {
+        sessionId?: string | undefined;
+        usage: Usage;
+        cost: {
+            input: number;
+            output: number;
+            total: number;
+        };
+        /** Provider id that produced this usage (e.g. 'anthropic'), when known. */
+        provider?: string | undefined;
+        /** Model id the cost was priced against, when known. */
+        model?: string | undefined;
+    };
+    /**
+     * Fired when the subagent budget hits a soft limit and the coordinator
+     * is being asked for an extension. The coordinator should call `extend()`
+     * to grant more budget, or the promise auto-resolves to `deny` after
+     * `timeoutMs` (default 30s), treating it as a hard stop.
+     *
+     * This event lets the CLI/TUI observe budget pressure in real time,
+     * surface extension requests to users, and give the coordinator a
+     * hook to implement custom extension policy without coupling to the
+     * runner/budget classes.
+     */
+    'budget.threshold_reached': {
+        sessionId?: string | undefined;
+        kind: 'iterations' | 'tool_calls' | 'tokens' | 'cost' | 'timeout' | 'idle_timeout';
+        used: number;
+        limit: number;
+        /**
+         * Call to grant more of the same budget type. `timeoutMs` extends the
+         * wall-clock budget; the coordinator's watchdog observes the patched
+         * limit and re-arms its timer for the new remainder.
+         */
+        extend: (extra: Partial<{
+            maxIterations: number;
+            maxToolCalls: number;
+            maxTokens: number;
+            maxCostUsd: number;
+            timeoutMs: number;
+        }>) => void;
+        /** Call to deny the extension — subagent will stop. */
+        deny: () => void;
+        /** Auto-resolves to deny after timeout. */
+        timeoutMs: number;
+    };
+    'token.cost_estimate_unavailable': {
+        sessionId?: string | undefined;
+        model: string;
+    };
+    /**
+     * Fired by the multi-agent coordinator on FleetBus whenever subagent
+     * counts change (spawn/stop/complete). The TUI subscribes to render
+     * live fleet counters without polling.
+     */
+    'coordinator.stats': {
+        sessionId?: string | undefined;
+        total: number;
+        running: number;
+        idle: number;
+        stopped: number;
+        inFlight: number;
+        pending: number;
+        completed: number;
+        /** Optional fleet-wide cost total (USD) — set by the host bridge when known. */
+        totalCostUsd?: number | undefined;
+        subagentStatuses: {
+            subagentId: string;
+            taskId: string;
+            status: string;
+            assigned: boolean;
+            /** Human label / role, when the host bridge joins Director usage data. */
+            name?: string | undefined;
+            role?: string | undefined;
+            model?: string | undefined;
+            /** Cumulative spend on this subagent (USD), when known. */
+            costUsd?: number | undefined;
+            /** Wall-clock runtime so far, in ms. */
+            runtimeMs?: number | undefined;
+            /** ISO timestamp of the most recent activity, when known. */
+            lastActivityAt?: string | undefined;
+            iterations?: number | undefined;
+            toolCalls?: number | undefined;
+        }[];
+    };
+    /**
+     * The coordinator's max-concurrent subagent ceiling was changed at runtime
+     * (e.g. via `/fleet concurrency <n>`). `n` is the new ceiling. Lets the
+     * TUI/WebUI reflect the updated limit without polling the host.
+     */
+    'concurrency.changed': {
+        sessionId?: string | undefined;
+        n: number;
+    };
+}
+//# sourceMappingURL=brain-events.d.ts.map

package/dist/kernel/events/brain-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brain-events.d.ts","sourceRoot":"","sources":["../../../src/kernel/events/brain-events.ts"],"names":[],"mappings":"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"}

package/dist/kernel/events/fleet-events.d.ts

@@ -0,0 +1,39 @@
+export interface FleetEventMap {
+    /**
+     * A supervision rule detected a condition worth engaging on (starvation,
+     * overload, backlog, stuck agent, failure streak). Fires even when the
+     * subsequent decision is "do nothing" — the signal trail is the audit log.
+     */
+    'fleet.supervisor.signal': {
+        sessionId?: string | undefined;
+        /** Rule kind, e.g. 'pinned_starvation' | 'overloaded_worker' | 'backlog' | 'stuck_agent' | 'failure_streak' | 'idle_with_work'. */
+        kind: string;
+        subagentId?: string | undefined;
+        taskId?: string | undefined;
+        detail: string;
+    };
+    /**
+     * The supervisor consulted its decision path for a signal. `via:'rule'`
+     * means the deterministic policy answered without an LLM; `via:'brain'`
+     * means the tiered BrainArbiter was engaged. `outcome:'escalated'` =
+     * unresolved ask_human, no action taken.
+     */
+    'fleet.supervisor.decision': {
+        sessionId?: string | undefined;
+        kind: string;
+        proposedAction: string;
+        via: 'rule' | 'brain';
+        outcome: 'approved' | 'denied' | 'escalated' | 'skipped';
+        rationale?: string | undefined;
+    };
+    /** The supervisor executed (or failed to execute) an approved action. */
+    'fleet.supervisor.action': {
+        sessionId?: string | undefined;
+        action: 'retarget' | 'spawn_helper' | 'steer' | 'notify_leader' | 'terminate';
+        subagentId?: string | undefined;
+        taskId?: string | undefined;
+        ok: boolean;
+        detail?: string | undefined;
+    };
+}
+//# sourceMappingURL=fleet-events.d.ts.map

package/dist/kernel/events/fleet-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fleet-events.d.ts","sourceRoot":"","sources":["../../../src/kernel/events/fleet-events.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAM5B;;;;OAIG;IACH,yBAAyB,EAAE;QACzB,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC/B,mIAAmI;QACnI,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAChC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC5B,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF;;;;;OAKG;IACH,2BAA2B,EAAE;QAC3B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC/B,IAAI,EAAE,MAAM,CAAC;QACb,cAAc,EAAE,MAAM,CAAC;QACvB,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QACtB,OAAO,EAAE,UAAU,GAAG,QAAQ,GAAG,WAAW,GAAG,SAAS,CAAC;QACzD,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAChC,CAAC;IACF,yEAAyE;IACzE,yBAAyB,EAAE;QACzB,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC/B,MAAM,EAAE,UAAU,GAAG,cAAc,GAAG,OAAO,GAAG,eAAe,GAAG,WAAW,CAAC;QAC9E,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAChC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC5B,EAAE,EAAE,OAAO,CAAC;QACZ,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAC7B,CAAC;CACH"}