@wrongstack/core 0.284.1 → 0.286.0

package/dist/autophase/types.d.ts

@@ -0,0 +1,329 @@
+/**
+ * AutoPhase - types for autonomous phase-based workflows.
+ *
+ * A project is split into phases; each phase contains tasks.
+ * Phases are dependency-aware: the next phase cannot start until all tasks
+ * in the current phase complete. Parallel phases are optionally supported.
+ */
+import type { BrainArbiter } from '../coordination/brain.js';
+import type { TaskGraph, TaskNode } from '../types/task-graph.js';
+export type PhaseStatus = 'pending' | 'ready' | 'running' | 'paused' | 'completed' | 'failed' | 'skipped';
+export interface PhaseNode {
+    id: string;
+    /** Phase name, e.g. "Discovery", "Design", "Implementation", "Testing". */
+    name: string;
+    description: string;
+    status: PhaseStatus;
+    /** Task graph for this phase. */
+    taskGraph: TaskGraph;
+    /** Previous phase IDs; this phase cannot start until they complete. */
+    dependsOn: string[];
+    /** Next phase IDs. */
+    nextPhases: string[];
+    /** Whether this phase can run in parallel before the previous phase finishes. */
+    parallelizable: boolean;
+    /** Phase priority. */
+    priority: 'critical' | 'high' | 'medium' | 'low';
+    /** Estimated duration in hours. */
+    estimateHours: number;
+    /** Actual duration in milliseconds. */
+    actualDurationMs?: number | undefined;
+    /** Start time. */
+    startedAt?: number | undefined;
+    /** Completion time. */
+    completedAt?: number | undefined;
+    /** Agents assigned to this phase. */
+    assignedAgents: string[];
+    /** Phase metadata. */
+    metadata?: Record<string, unknown> | undefined;
+    createdAt: number;
+    updatedAt: number;
+}
+export interface PhaseGraph {
+    id: string;
+    /** Project title. */
+    title: string;
+    description: string;
+    phases: Map<string, PhaseNode>;
+    /** Starting phase IDs. */
+    rootPhaseIds: string[];
+    /** Active phase IDs with running status. */
+    activePhaseIds: string[];
+    /** Completed phase IDs. */
+    completedPhaseIds: string[];
+    /** Failed phase IDs. */
+    failedPhaseIds: string[];
+    /** Whether autonomous mode is active. */
+    autonomous: boolean;
+    /** Stop when all phases complete. */
+    stopOnComplete: boolean;
+    createdAt: number;
+    updatedAt: number;
+    startedAt?: number | undefined;
+    completedAt?: number | undefined;
+}
+export interface PhaseProgress {
+    totalPhases: number;
+    pending: number;
+    ready: number;
+    running: number;
+    paused: number;
+    completed: number;
+    failed: number;
+    skipped: number;
+    percentComplete: number;
+    totalTasks: number;
+    completedTasks: number;
+    failedTasks: number;
+    estimatedHours: number;
+    actualHours: number;
+}
+export interface PhaseEventMap {
+    'phase.statusChange': {
+        phaseId: string;
+        from: PhaseStatus;
+        to: PhaseStatus;
+    };
+    'phase.started': {
+        phaseId: string;
+        name: string;
+    };
+    'phase.completed': {
+        phaseId: string;
+        name: string;
+        durationMs: number;
+    };
+    'phase.failed': {
+        phaseId: string;
+        name: string;
+        error?: string | undefined;
+    };
+    /** A task began executing — carries the worker agent so boards can show who is on it. */
+    'phase.taskStarted': {
+        phaseId: string;
+        taskId: string;
+        taskTitle: string;
+        agentId?: string | undefined;
+        agentName?: string | undefined;
+    };
+    'phase.taskCompleted': {
+        phaseId: string;
+        taskId: string;
+        taskTitle: string;
+    };
+    'phase.taskFailed': {
+        phaseId: string;
+        taskId: string;
+        taskTitle: string;
+        error: string;
+    };
+    'phase.taskRetrying': {
+        phaseId: string;
+        taskId: string;
+        taskTitle: string;
+        attempt: number;
+        maxRetries: number;
+    };
+    /** A task timed out — exceeded `taskTimeoutMs`. */
+    'phase.taskTimedOut': {
+        phaseId: string;
+        taskId: string;
+        taskTitle: string;
+        timeoutMs: number;
+    };
+    'phase.allTasksDone': {
+        phaseId: string;
+        completed: number;
+        failed: number;
+    };
+    'phase.verifying': {
+        phaseId: string;
+        name: string;
+        attempt: number;
+    };
+    'phase.verifyFailed': {
+        phaseId: string;
+        name: string;
+        attempt: number;
+        error?: string | undefined;
+    };
+    'phase.repairing': {
+        phaseId: string;
+        name: string;
+        attempt: number;
+    };
+    'phase.conflictResolving': {
+        phaseId: string;
+        name: string;
+        files: string[];
+    };
+    'phase.conflictResolved': {
+        phaseId: string;
+        name: string;
+    };
+    'graph.completed': {
+        graphId: string;
+        durationMs: number;
+    };
+    'graph.failed': {
+        graphId: string;
+        failedPhaseId: string;
+        error: string;
+    };
+    'autonomous.tick': {
+        activePhases: string[];
+        queuedPhases: string[];
+    };
+    'agent.assigned': {
+        phaseId: string;
+        agentId: string;
+    };
+    'agent.released': {
+        phaseId: string;
+        agentId: string;
+    };
+    /** A task was moved between phases from an interactive board. */
+    'phase.taskMoved': {
+        taskId: string;
+        fromPhaseId: string;
+        toPhaseId: string;
+    };
+    /** A task was (re)assigned to a specific agent from an interactive board. */
+    'phase.taskAssigned': {
+        phaseId: string;
+        taskId: string;
+        agentId?: string | undefined;
+        agentName?: string | undefined;
+    };
+    /** A task was added to a phase from an interactive board. */
+    'phase.taskAdded': {
+        phaseId: string;
+        taskId: string;
+        taskTitle: string;
+    };
+}
+export type PhaseEventName = keyof PhaseEventMap;
+/**
+ * All phase event names as a const array. Consumers (TUI, WebUI) should
+ * import this rather than hardcoding string literals, so the compiler
+ * catches drift when events are added or renamed.
+ */
+export declare const PHASE_EVENT_NAMES: readonly PhaseEventName[];
+export interface PhaseExecutionContext {
+    /**
+     * Execute a task through an AI agent. `env` points to the phase git
+     * worktree when available, so the agent runs in an isolated working directory.
+     */
+    executeTask: (task: TaskNode, phaseId: string, env?: {
+        cwd?: string | undefined;
+        branch?: string | undefined;
+    }) => Promise<unknown>;
+    /**
+     * Optional verification gate. Called after all tasks in a phase finish,
+     * but before the phase is marked "completed" and its worktree is merged
+     * back to the base branch. `env` points to the phase worktree when available;
+     * verification should run in that isolated directory, such as typecheck/test.
+     * If `ok:false` is returned, merge is blocked and `repairPhase` is attempted when available.
+     *
+     * If undefined, the gate is skipped for backward compatibility.
+     */
+    verifyPhase?: ((phase: PhaseNode, env?: {
+        cwd?: string | undefined;
+        branch?: string | undefined;
+    }) => Promise<{
+        ok: boolean;
+        output?: string | undefined;
+    }>) | undefined;
+    /**
+     * Optional repair pass. When `verifyPhase` fails, it is called with the
+     * captured error output. It should try to fix the code in the worktree
+     * for example, through a repair subagent. Its return value is ignored;
+     * the orchestrator reruns `verifyPhase` afterward. It is never called when `verifyPhase` is undefined.
+     */
+    repairPhase?: ((phase: PhaseNode, failure: string, attempt: number, env?: {
+        cwd?: string | undefined;
+        branch?: string | undefined;
+    }) => Promise<void>) | undefined;
+    /**
+     * Optional merge-conflict resolver. Called when a phase worktree conflicts
+     * during squash-merge into the base branch. `info.cwd` points to the base
+     * working tree where conflict markers exist; the resolver should clean those
+     * markers and return `true`. On success the merge is committed; otherwise
+     * the merge is aborted and the worktree is kept in `needs-review`.
+     * If undefined, conflicts keep the old parked-for-review behavior.
+     */
+    resolveConflict?: ((phase: PhaseNode, info: {
+        conflictFiles: string[];
+        cwd: string;
+    }) => Promise<boolean>) | undefined;
+    /** Optional global Brain arbiter for the policy, decision, and escalation layer. */
+    brain?: BrainArbiter | undefined;
+    /** Called when a phase completes. */
+    onPhaseComplete?: ((phase: PhaseNode) => void) | undefined;
+    /** Called when a phase fails. */
+    onPhaseFail?: ((phase: PhaseNode, error: Error) => void) | undefined;
+    /** Called on every tick in autonomous mode. */
+    onTick?: ((ctx: {
+        activePhases: PhaseNode[];
+        readyPhases: PhaseNode[];
+    }) => void) | undefined;
+}
+export interface AutoPhaseOptions {
+    /** Maximum number of parallel phases. */
+    maxConcurrentPhases?: number | undefined;
+    /** Maximum number of parallel tasks within a phase. */
+    maxConcurrentTasks?: number | undefined;
+    /** Retry count for failed tasks. */
+    maxRetries?: number | undefined;
+    /**
+     * Maximum number of repair attempts after the verification gate fails.
+     * Total verification runs = maxVerifyAttempts + 1: the first run plus one
+     * rerun after each repair. Defaults to 2. Has no effect without `verifyPhase`.
+     */
+    maxVerifyAttempts?: number | undefined;
+    /** Autonomous mode: automatically advance as phases complete. */
+    autonomous?: boolean | undefined;
+    /** Delay between phases in milliseconds. */
+    phaseDelayMs?: number | undefined;
+    /** Stop when a phase fails. */
+    stopOnFailure?: boolean | undefined;
+    /**
+     * Per-task timeout in milliseconds. A single task exceeding this
+     * is marked failed and `phase.taskTimedOut` is emitted.
+     * Defaults to 600_000 (10 min). Set to 0 to disable.
+     */
+    taskTimeoutMs?: number | undefined;
+    /** Event bus */
+    events?: import('../kernel/events.js').EventBus | undefined;
+    /**
+     * Optional git-worktree manager. When provided, each phase runs in its own
+     * isolated worktree and branch, then is squash-merged back into the base
+     * branch in order. Without it, behavior is unchanged and uses the shared working tree.
+     */
+    worktrees?: import('../worktree/worktree-manager.js').WorktreeManager | undefined;
+}
+export interface PhaseFilter {
+    status?: PhaseStatus[] | undefined;
+    priority?: PhaseNode['priority'][] | undefined;
+}
+export interface PhaseSort {
+    field: 'priority' | 'createdAt' | 'startedAt' | 'completedAt';
+    direction: 'asc' | 'desc';
+}
+export interface PhaseTemplate {
+    name: string;
+    description: string;
+    priority: PhaseNode['priority'];
+    estimateHours: number;
+    parallelizable: boolean;
+    /** Task templates to create automatically. */
+    taskTemplates?: Array<{
+        title: string;
+        description: string;
+        type: import('../types/task-graph.js').TaskType;
+        priority: import('../types/task-graph.js').TaskPriority;
+        estimateHours: number;
+        tags?: string[] | undefined;
+    }>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/autophase/types.d.ts.map

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

package/dist/boot.d.ts

@@ -0,0 +1,73 @@
+import { DefaultLogger } from './infrastructure/logger.js';
+import { DefaultPathResolver } from './infrastructure/path-resolver.js';
+import { DefaultSecretVault } from './security/secret-vault.js';
+import { type Config } from './types/config.js';
+import { type WstackPaths } from './utils/wstack-paths.js';
+/**
+ * Options for {@link bootConfig}. Both the CLI and the WebUI server boot the
+ * same way; the only intentional differences are the label used in the
+ * plaintext-secret migration notice and whether CLI flags are supplied.
+ */
+export interface BootConfigOptions {
+    /**
+     * Parsed CLI flags. `cwd` relocates path resolution; `provider`/`model`/
+     * `log-level`/`verbose`/`trace`/`yolo`/`no-features` are patched into the
+     * loaded config (see {@link flagsToConfigPatch}). Defaults to `{}` (the
+     * WebUI server passes no flags).
+     */
+    flags?: Record<string, string | boolean>;
+    /**
+     * Label shown in the `[<label>] Encrypted N plaintext secret(s) in FILE`
+     * stderr notice emitted when legacy plaintext secrets get auto-encrypted.
+     * The CLI passes `wstack`; the WebUI server passes `WebUI`. Default
+     * `wstack`.
+     */
+    appLabel?: string | undefined;
+    /**
+     * Load `~/.wrongstack/sync.json` and merge it into `config.sync` so the
+     * ConfigStore starts with the correct CloudSync state. Default `true`.
+     */
+    loadSyncConfig?: boolean | undefined;
+    /**
+     * Skip the provider/model identity validation during config load. When
+     * `true`, a missing provider or model in config does NOT throw — the
+     * boot caller is responsible for handling the missing-provider case
+     * (e.g. showing a setup screen). Used by `--webui` mode so the WebUI
+     * can boot without a configured provider and show the setup screen.
+     */
+    skipIdentityValidation?: boolean | undefined;
+}
+/**
+ * Everything the boot phase resolves before DI-container wiring. Superset of
+ * what the CLI and WebUI server each consumed previously, so both can pick the
+ * fields they need from a single canonical result.
+ */
+export interface BootConfigResult {
+    cwd: string;
+    projectRoot: string;
+    userHome: string;
+    wpaths: WstackPaths;
+    pathResolver: DefaultPathResolver;
+    config: Config;
+    vault: DefaultSecretVault;
+    logger: DefaultLogger;
+    /** Convenience alias for `wpaths.globalConfig`. */
+    globalConfigPath: string;
+}
+/**
+ * Canonical boot routine shared by `@wrongstack/cli` and `@wrongstack/webui`.
+ * Resolves paths, creates the real AES-GCM secret vault, migrates any
+ * plaintext secrets, loads + merges config (with CLI-flag overrides and an
+ * optional sync overlay), and builds a logger.
+ *
+ * The per-package `bootConfig()` wrappers re-shape this result into their own
+ * legacy return types for backward compatibility — keep this the single source
+ * of boot behavior so the two consumers can't drift.
+ */
+export declare function bootConfig(options?: BootConfigOptions): Promise<BootConfigResult>;
+/**
+ * Translate parsed CLI flags into a partial Config patch applied on top of the
+ * file-loaded config. Explicit `--log-level` wins over `--verbose`/`--trace`.
+ */
+export declare function flagsToConfigPatch(flags: Record<string, string | boolean>): Partial<Config>;
+//# sourceMappingURL=boot.d.ts.map

package/dist/boot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boot.d.ts","sourceRoot":"","sources":["../src/boot.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAc,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AACxE,OAAO,EAAE,kBAAkB,EAA2B,MAAM,4BAA4B,CAAC;AAEzF,OAAO,EAAE,KAAK,MAAM,EAA4B,MAAM,mBAAmB,CAAC;AAG1E,OAAO,EAAE,KAAK,WAAW,EAAsB,MAAM,yBAAyB,CAAC;AAE/E;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC;IACzC;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACrC;;;;;;OAMG;IACH,sBAAsB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC9C;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,WAAW,CAAC;IACpB,YAAY,EAAE,mBAAmB,CAAC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,kBAAkB,CAAC;IAC1B,MAAM,EAAE,aAAa,CAAC;IACtB,mDAAmD;IACnD,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;GASG;AACH,wBAAsB,UAAU,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAsI3F;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CA0C3F"}

package/dist/coordination/adaptive-concurrency.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Adaptive Concurrency Controller
+ *
+ * Automatically adjusts `maxConcurrent` based on:
+ * - Rate limit (429) errors → decrease concurrency
+ * - Sustained successful requests → increase concurrency
+ *
+ * This provides automatic backpressure without manual tuning.
+ */
+import type { FleetBus } from './fleet-bus.js';
+import type { AdaptiveConcurrencyConfig } from '../types/config.js';
+import type { Logger } from '../types/logger.js';
+export interface AdaptiveConcurrencyState {
+    current: number;
+    min: number;
+    max: number;
+    consecutiveSuccesses: number;
+    consecutiveFailures: number;
+    totalDecreases: number;
+    totalIncreases: number;
+    enabled: boolean;
+}
+/**
+ * Adaptive Concurrency Controller
+ *
+ * Monitors fleet events for rate-limit (429) errors and adjusts concurrency
+ * automatically to prevent overwhelming the API provider.
+ */
+export declare class AdaptiveConcurrencyController {
+    private readonly config;
+    private state;
+    private readonly disposers;
+    private stateChangeHandlers;
+    private readonly logger;
+    constructor(fleetBus: FleetBus, setMaxConcurrent: (n: number) => void, config?: Partial<AdaptiveConcurrencyConfig>, onStateChange?: (state: AdaptiveConcurrencyState) => void, logger?: Pick<Logger, 'warn'>);
+    private setupEventHandlers;
+    /**
+     * Handle a rate limit (429) error - decrease concurrency
+     */
+    private handleRateLimit;
+    /**
+     * Force a decrease (e.g., manual trigger or other error types)
+     */
+    decrease(target?: number): void;
+    /**
+     * Get the current state
+     */
+    getState(): AdaptiveConcurrencyState;
+    /**
+     * Update configuration at runtime
+     */
+    updateConfig(config: Partial<AdaptiveConcurrencyConfig>): void;
+    /**
+     * Dispose of the controller and clean up event listeners
+     */
+    dispose(): void;
+    private notifyStateChange;
+    /**
+     * Register a state change handler
+     */
+    onStateChange(handler: (state: AdaptiveConcurrencyState) => void): () => void;
+}
+//# sourceMappingURL=adaptive-concurrency.d.ts.map

package/dist/coordination/adaptive-concurrency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adaptive-concurrency.d.ts","sourceRoot":"","sources":["../../src/coordination/adaptive-concurrency.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAc,MAAM,gBAAgB,CAAC;AAC3D,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,oBAAoB,EAAE,MAAM,CAAC;IAC7B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;CAClB;AAoBD;;;;;GAKG;AACH,qBAAa,6BAA6B;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,KAAK,CAA2B;IACxC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsB;IAChD,OAAO,CAAC,mBAAmB,CAAqD;IAChF,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmC;IAE1D,YACE,QAAQ,EAAE,QAAQ,EAClB,gBAAgB,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,EACrC,MAAM,GAAE,OAAO,CAAC,yBAAyB,CAAM,EAC/C,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,wBAAwB,KAAK,IAAI,EAGzD,MAAM,CAAC,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,EAmC9B;IAED,OAAO,CAAC,kBAAkB;IAkB1B;;OAEG;IACH,OAAO,CAAC,eAAe;IAkCvB;;OAEG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAuB9B;IAED;;OAEG;IACH,QAAQ,IAAI,wBAAwB,CAEnC;IAED;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,yBAAyB,CAAC,GAAG,IAAI,CA2B7D;IAED;;OAEG;IACH,OAAO,IAAI,IAAI,CAMd;IAED,OAAO,CAAC,iBAAiB;IAOzB;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,wBAAwB,KAAK,IAAI,GAAG,MAAM,IAAI,CAQ5E;CACF"}

package/dist/coordination/agent-bridge.d.ts

@@ -0,0 +1,24 @@
+import type { AgentBridge, AgentBridgeConfig, BridgeMessage, BridgeTransport } from '../types/agent-bridge.js';
+import { InMemoryBridgeTransport } from './in-memory-transport.js';
+export { InMemoryBridgeTransport };
+export declare class InMemoryAgentBridge implements AgentBridge {
+    readonly agentId: string;
+    readonly coordinatorId: string;
+    private readonly transport;
+    private readonly subscriptions;
+    private readonly pendingRequests;
+    private stopped;
+    private timeoutMs;
+    /** Guards request() so concurrent calls on the same id can't silently overwrite. */
+    private readonly inflightGuards;
+    /** Stores the transport unsubscribe function so it can be called on stop(). */
+    private _transportUnsubscribe?;
+    constructor(config: AgentBridgeConfig, transport: BridgeTransport);
+    send(msg: BridgeMessage): Promise<void>;
+    broadcast(msg: BridgeMessage): Promise<void>;
+    subscribe(handler: (msg: BridgeMessage) => void | Promise<void>): () => void;
+    request<T>(msg: BridgeMessage, timeoutMs?: number): Promise<BridgeMessage<T>>;
+    stop(): Promise<void>;
+}
+export declare function createMessage<T = unknown>(type: BridgeMessage['type'], from: string, payload: T, to?: string | undefined): BridgeMessage<T>;
+//# sourceMappingURL=agent-bridge.d.ts.map

package/dist/coordination/agent-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-bridge.d.ts","sourceRoot":"","sources":["../../src/coordination/agent-bridge.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,WAAW,EACX,iBAAiB,EACjB,aAAa,EACb,eAAe,EAChB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAGnE,OAAO,EAAE,uBAAuB,EAAE,CAAC;AAEnC,qBAAa,mBAAoB,YAAW,WAAW;IACrD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkB;IAC5C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgD;IAC9E,OAAO,CAAC,QAAQ,CAAC,eAAe,CAO5B;IACJ,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,SAAS,CAAS;IAC1B,oFAAoF;IACpF,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAqB;IACpD,+EAA+E;IAC/E,OAAO,CAAC,qBAAqB,CAAC,CAA6B;IAE3D,YAAY,MAAM,EAAE,iBAAiB,EAAE,SAAS,EAAE,eAAe,EA0BhE;IAEK,IAAI,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAG5C;IAEK,SAAS,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAIjD;IAED,SAAS,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI,CAG3E;IAEK,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,aAAa,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CA8DlF;IAEK,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAiB1B;CACF;AAED,wBAAgB,aAAa,CAAC,CAAC,GAAG,OAAO,EACvC,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,EAC3B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,CAAC,EACV,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,GACtB,aAAa,CAAC,CAAC,CAAC,CAUlB"}

package/dist/coordination/agent-monitor.d.ts

@@ -0,0 +1,129 @@
+import type { EventBus } from '../kernel/events.js';
+import type { FleetBus } from './fleet-bus.js';
+export 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' | 'thinking' | '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;
+}
+export interface AgentVirtualSession {
+    subagentId: string;
+    agentName: string;
+    createdAt: string;
+    status: string;
+    task?: string | undefined;
+    /** Ordered transcript entries (newest last). */
+    transcript: AgentTimelineEntry[];
+}
+export interface AgentMonitorOptions {
+    /** Parent/host session id for emitted agent timeline/status events. */
+    sessionId?: string | undefined;
+    /** 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;
+}
+export declare class AgentMonitorService {
+    private _fleetBus;
+    private readonly _events;
+    private readonly _sessionId;
+    private readonly _transcriptsDir;
+    private readonly _maxEntries;
+    private _streamEnabled;
+    private _onEntry;
+    /** Per-subagent virtual sessions. */
+    private readonly _sessions;
+    /**
+     * Per-subagent OPEN streaming segment. Provider text/thinking deltas
+     * arrive word-by-word; writing one transcript entry per delta fragments
+     * every surface (ring, JSONL, HQ) into unreadable single-word lines.
+     * Instead, consecutive same-kind/same-iteration deltas append into ONE
+     * entry that is already in the ring (live views see it grow in place);
+     * the JSONL line is written once, when the segment closes.
+     */
+    private readonly _openStreams;
+    /** 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;
+    /** Drop a retired subagent from every live in-memory monitor surface. */
+    removeSubagent(subagentId: string): void;
+    private _routeEvent;
+    /** Max characters accumulated into one streaming segment before rolling over. */
+    private static readonly _MAX_SEGMENT_CHARS;
+    /**
+     * Fold a provider text/thinking delta into the subagent's open streaming
+     * segment, or open a new one. A segment breaks on kind change, iteration
+     * change, size cap, or any non-delta entry (see `_addEntry`). The entry
+     * is pushed to the ring when the segment OPENS (live views poll the ring
+     * and watch it grow in place); the JSONL line AND the timeline/HQ
+     * announcement happen once, on close, with the COMPLETE segment — so
+     * downstream consumers get one whole message instead of a word-per-event
+     * firehose (or, worse, only the first word).
+     */
+    private _appendStreamDelta;
+    /**
+     * Close the subagent's open streaming segment: persist it to JSONL and
+     * announce the completed entry on the local bus + HQ callback.
+     */
+    private _closeStream;
+    private _addEntry;
+    /** Announce a transcript entry on the local bus + HQ callback. */
+    private _emitEntry;
+    private _appendToFile;
+    private _uid;
+    private _formatToolUse;
+    private _formatToolResult;
+    private _stringifyForTimeline;
+    private _capTimelineText;
+}
+export declare function createAgentMonitorService(opts: AgentMonitorOptions): AgentMonitorService;
+//# sourceMappingURL=agent-monitor.d.ts.map

package/dist/coordination/agent-monitor.d.ts.map

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