@avi770/testteam 3.0.0 → 3.2.0

package/dist/core/run-events/loop-event-sink.d.ts

@@ -0,0 +1,56 @@
+/**
+ * SSE framing for the live loop-cognition channel (S11 live cockpit — Option C/B).
+ *
+ * The Loop Engine kernel (core/loop-engine) can emit each per-cycle `LoopEvent` to a live
+ * observer. This layer serialises those events as Server-Sent-Events frames on a SEPARATE
+ * `event: loop-event` channel — deliberately DISTINCT from the run-event stream (sse.ts) and
+ * from the screencast `event: frame` channel (frame-sink.ts).
+ *
+ * Why a separate channel (decision D-UI-14): loop cognition is high-volume and ephemeral —
+ * it must NOT enter the RunEventEmitter's bounded replay log or its folded RunStateView, and
+ * it is never persisted to a run artifact (honours D-UI-13's live-only rule). It simply rides
+ * the same SSE response so the client's EventSource can `addEventListener('loop-event', …)`
+ * independently of the run-event kinds.
+ *
+ * Pure serialisation + a fail-safe writer: a closed/destroyed socket is skipped, so a dead
+ * consumer can never throw or break the kernel cycle that feeds it.
+ */
+import type { LoopEvent } from '../loop-engine/index.js';
+import type { SseResponse } from './sse.js';
+/**
+ * A LoopEvent tagged with the agent that produced it. On the multi-agent run stream
+ * (Option B), loop events from several agents interleave, so the frame carries `agentId`
+ * + `agentName` alongside the full, unchanged LoopEvent. The demo endpoint (Option C) streams
+ * bare LoopEvents (single kernel, no attribution); a client reads `agentId` only when present.
+ */
+export interface AttributedLoopEvent extends LoopEvent {
+    readonly agentId: number;
+    readonly agentName: string;
+}
+/**
+ * Serialise one LoopEvent to an SSE frame (`id` + `event: loop-event` + JSON `data`, blank-line
+ * terminated). The channel name is a fixed literal (not derived from input) and `seq` is a
+ * number, so — unlike the run-event framer — there is no CR/LF-injection surface in the framing
+ * fields; the `data` payload is JSON-encoded, which escapes control characters. `seq` is still
+ * coerced defensively via String() for parity with the sibling framers.
+ */
+export declare function formatLoopEventSseFrame(event: LoopEvent): string;
+/**
+ * A sink that writes each LoopEvent as an SSE `event: loop-event` chunk to an HTTP response.
+ * Bind `push` to a LoopKernel's `onEvent` option to stream live cognition to the Cockpit. The
+ * `isClosed()` guard silently skips a finished/dropped socket — a dead live consumer must never
+ * throw or interrupt the run (matches the SseFrameSink / SseRunEventSink contract).
+ */
+export declare class SseLoopEventSink {
+    private readonly res;
+    constructor(res: SseResponse);
+    push(event: LoopEvent): void;
+    /**
+     * Write an agent-attributed loop event (Option B run stream). Same `event: loop-event`
+     * channel + fail-safe guard as {@link push}; the frame additionally carries agentId/agentName
+     * so a multi-agent run's interleaved cognition can be attributed to the right agent.
+     */
+    pushForAgent(agentId: number, agentName: string, event: LoopEvent): void;
+    private isClosed;
+}
+//# sourceMappingURL=loop-event-sink.d.ts.map

package/dist/core/run-events/loop-event-sink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop-event-sink.d.ts","sourceRoot":"","sources":["../../../core/run-events/loop-event-sink.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAEzC;;;;;GAKG;AACH,MAAM,WAAW,mBAAoB,SAAQ,SAAS;IACpD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAGhE;AAED;;;;;GAKG;AACH,qBAAa,gBAAgB;IACf,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,WAAW;IAE7C,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAK5B;;;;OAIG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI;IAMxE,OAAO,CAAC,QAAQ;CAGjB"}

package/dist/core/run-events/loop-event-sink.js

@@ -0,0 +1,60 @@
+/**
+ * SSE framing for the live loop-cognition channel (S11 live cockpit — Option C/B).
+ *
+ * The Loop Engine kernel (core/loop-engine) can emit each per-cycle `LoopEvent` to a live
+ * observer. This layer serialises those events as Server-Sent-Events frames on a SEPARATE
+ * `event: loop-event` channel — deliberately DISTINCT from the run-event stream (sse.ts) and
+ * from the screencast `event: frame` channel (frame-sink.ts).
+ *
+ * Why a separate channel (decision D-UI-14): loop cognition is high-volume and ephemeral —
+ * it must NOT enter the RunEventEmitter's bounded replay log or its folded RunStateView, and
+ * it is never persisted to a run artifact (honours D-UI-13's live-only rule). It simply rides
+ * the same SSE response so the client's EventSource can `addEventListener('loop-event', …)`
+ * independently of the run-event kinds.
+ *
+ * Pure serialisation + a fail-safe writer: a closed/destroyed socket is skipped, so a dead
+ * consumer can never throw or break the kernel cycle that feeds it.
+ */
+/**
+ * Serialise one LoopEvent to an SSE frame (`id` + `event: loop-event` + JSON `data`, blank-line
+ * terminated). The channel name is a fixed literal (not derived from input) and `seq` is a
+ * number, so — unlike the run-event framer — there is no CR/LF-injection surface in the framing
+ * fields; the `data` payload is JSON-encoded, which escapes control characters. `seq` is still
+ * coerced defensively via String() for parity with the sibling framers.
+ */
+export function formatLoopEventSseFrame(event) {
+    const seq = String(event.seq).replace(/[\r\n]/g, '');
+    return `id: ${seq}\nevent: loop-event\ndata: ${JSON.stringify(event)}\n\n`;
+}
+/**
+ * A sink that writes each LoopEvent as an SSE `event: loop-event` chunk to an HTTP response.
+ * Bind `push` to a LoopKernel's `onEvent` option to stream live cognition to the Cockpit. The
+ * `isClosed()` guard silently skips a finished/dropped socket — a dead live consumer must never
+ * throw or interrupt the run (matches the SseFrameSink / SseRunEventSink contract).
+ */
+export class SseLoopEventSink {
+    res;
+    constructor(res) {
+        this.res = res;
+    }
+    push(event) {
+        if (this.isClosed())
+            return;
+        this.res.write(formatLoopEventSseFrame(event));
+    }
+    /**
+     * Write an agent-attributed loop event (Option B run stream). Same `event: loop-event`
+     * channel + fail-safe guard as {@link push}; the frame additionally carries agentId/agentName
+     * so a multi-agent run's interleaved cognition can be attributed to the right agent.
+     */
+    pushForAgent(agentId, agentName, event) {
+        if (this.isClosed())
+            return;
+        const attributed = { ...event, agentId, agentName };
+        this.res.write(formatLoopEventSseFrame(attributed));
+    }
+    isClosed() {
+        return this.res.writableEnded === true || this.res.destroyed === true;
+    }
+}
+//# sourceMappingURL=loop-event-sink.js.map

package/dist/core/run-events/loop-event-sink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop-event-sink.js","sourceRoot":"","sources":["../../../core/run-events/loop-event-sink.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAgBH;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAAgB;IACtD,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IACrD,OAAO,OAAO,GAAG,8BAA8B,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC;AAC7E,CAAC;AAED;;;;;GAKG;AACH,MAAM,OAAO,gBAAgB;IACE;IAA7B,YAA6B,GAAgB;QAAhB,QAAG,GAAH,GAAG,CAAa;IAAG,CAAC;IAEjD,IAAI,CAAC,KAAgB;QACnB,IAAI,IAAI,CAAC,QAAQ,EAAE;YAAE,OAAO;QAC5B,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,uBAAuB,CAAC,KAAK,CAAC,CAAC,CAAC;IACjD,CAAC;IAED;;;;OAIG;IACH,YAAY,CAAC,OAAe,EAAE,SAAiB,EAAE,KAAgB;QAC/D,IAAI,IAAI,CAAC,QAAQ,EAAE;YAAE,OAAO;QAC5B,MAAM,UAAU,GAAwB,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;QACzE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,uBAAuB,CAAC,UAAU,CAAC,CAAC,CAAC;IACtD,CAAC;IAEO,QAAQ;QACd,OAAO,IAAI,CAAC,GAAG,CAAC,aAAa,KAAK,IAAI,IAAI,IAAI,CAAC,GAAG,CAAC,SAAS,KAAK,IAAI,CAAC;IACxE,CAAC;CACF"}

package/dist/core/run-events/sse.d.ts

@@ -0,0 +1,47 @@
+/**
+ * SSE framing for the run-event stream (Phase 3.3 commit 2).
+ *
+ * Pure serialization + a RunEventSink that writes Server-Sent-Events frames to an HTTP
+ * response. No timers, no I/O scheduling here — the keep-alive `ping()` is a method the
+ * server drives on an interval, so this layer stays fully unit-testable with a mock writable.
+ *
+ * Frame shape (SSE spec): `id:` = the event seq (enables Last-Event-ID resume), `event:` = the
+ * RunEvent kind (so the EventSource client can addEventListener per kind), `data:` = JSON.
+ */
+import type { RunEvent, RunEventSink } from './types.js';
+/**
+ * The minimal HTTP-response surface this layer needs. Node's http.ServerResponse satisfies it
+ * structurally, so the same sink works in production and against a mock in tests.
+ */
+export interface SseResponse {
+    setHeader(name: string, value: string): void;
+    write(chunk: string): boolean | void;
+    /** Node http.ServerResponse exposes these — used to stop writing to a finished/dropped socket. */
+    readonly writableEnded?: boolean;
+    readonly destroyed?: boolean;
+}
+/** Headers that put a response into SSE mode. `X-Accel-Buffering: no` stops proxy buffering. */
+export declare const SSE_HEADERS: Readonly<Record<string, string>>;
+/** Apply the SSE headers to a response. Call once, before the first frame. */
+export declare function initSse(res: SseResponse): void;
+/** Serialize one run event to an SSE frame (id + event + data, terminated by a blank line). */
+export declare function formatSseFrame(event: RunEvent): string;
+/**
+ * A RunEventSink that writes each event as an SSE frame to an HTTP response. Pair it with a
+ * RunEventEmitter: `new RunEventEmitter(new SseRunEventSink(res))`. The emitter already wraps
+ * sink.emit in try/catch, so a write failure on a dropped connection cannot break the run.
+ */
+export declare class SseRunEventSink implements RunEventSink {
+    private readonly res;
+    constructor(res: SseResponse);
+    emit(event: RunEvent): void;
+    /** Write an SSE keep-alive comment. The server calls this on an interval to hold the socket open. */
+    ping(): void;
+    /**
+     * True once the response is finished or the socket was destroyed (e.g. the client disconnected).
+     * Writing past that point is wasted work on a dead socket — so we skip it. Note: this does NOT
+     * cancel an in-flight orchestrator run (it has no native abort); it only spares the transport.
+     */
+    private isClosed;
+}
+//# sourceMappingURL=sse.d.ts.map

package/dist/core/run-events/sse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../../core/run-events/sse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEtD;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7C,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;IACrC,kGAAkG;IAClG,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,gGAAgG;AAChG,eAAO,MAAM,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAKxD,CAAC;AAEF,8EAA8E;AAC9E,wBAAgB,OAAO,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CAI9C;AAED,+FAA+F;AAC/F,wBAAgB,cAAc,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAOtD;AAED;;;;GAIG;AACH,qBAAa,eAAgB,YAAW,YAAY;IAClD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAc;gBACtB,GAAG,EAAE,WAAW;IAG5B,IAAI,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAI3B,qGAAqG;IACrG,IAAI,IAAI,IAAI;IAKZ;;;;OAIG;IACH,OAAO,CAAC,QAAQ;CAGjB"}

package/dist/core/run-events/sse.js

@@ -0,0 +1,64 @@
+/**
+ * SSE framing for the run-event stream (Phase 3.3 commit 2).
+ *
+ * Pure serialization + a RunEventSink that writes Server-Sent-Events frames to an HTTP
+ * response. No timers, no I/O scheduling here — the keep-alive `ping()` is a method the
+ * server drives on an interval, so this layer stays fully unit-testable with a mock writable.
+ *
+ * Frame shape (SSE spec): `id:` = the event seq (enables Last-Event-ID resume), `event:` = the
+ * RunEvent kind (so the EventSource client can addEventListener per kind), `data:` = JSON.
+ */
+/** Headers that put a response into SSE mode. `X-Accel-Buffering: no` stops proxy buffering. */
+export const SSE_HEADERS = {
+    'Content-Type': 'text/event-stream; charset=utf-8',
+    'Cache-Control': 'no-cache, no-transform',
+    Connection: 'keep-alive',
+    'X-Accel-Buffering': 'no',
+};
+/** Apply the SSE headers to a response. Call once, before the first frame. */
+export function initSse(res) {
+    for (const [name, value] of Object.entries(SSE_HEADERS)) {
+        res.setHeader(name, value);
+    }
+}
+/** Serialize one run event to an SSE frame (id + event + data, terminated by a blank line). */
+export function formatSseFrame(event) {
+    // Strip CR/LF from the framing fields so a crafted seq/kind cannot inject
+    // extra SSE frames or break out of the `data:` line. The data payload is
+    // JSON-encoded, which already escapes control characters.
+    const seq = String(event.seq).replace(/[\r\n]/g, '');
+    const kind = String(event.kind).replace(/[\r\n]/g, '');
+    return `id: ${seq}\nevent: ${kind}\ndata: ${JSON.stringify(event)}\n\n`;
+}
+/**
+ * A RunEventSink that writes each event as an SSE frame to an HTTP response. Pair it with a
+ * RunEventEmitter: `new RunEventEmitter(new SseRunEventSink(res))`. The emitter already wraps
+ * sink.emit in try/catch, so a write failure on a dropped connection cannot break the run.
+ */
+export class SseRunEventSink {
+    res;
+    constructor(res) {
+        this.res = res;
+    }
+    emit(event) {
+        if (this.isClosed())
+            return;
+        this.res.write(formatSseFrame(event));
+    }
+    /** Write an SSE keep-alive comment. The server calls this on an interval to hold the socket open. */
+    ping() {
+        if (this.isClosed())
+            return;
+        // A line beginning with ':' is an SSE comment — ignored by EventSource, holds the socket open.
+        this.res.write(': keep-alive\n\n');
+    }
+    /**
+     * True once the response is finished or the socket was destroyed (e.g. the client disconnected).
+     * Writing past that point is wasted work on a dead socket — so we skip it. Note: this does NOT
+     * cancel an in-flight orchestrator run (it has no native abort); it only spares the transport.
+     */
+    isClosed() {
+        return this.res.writableEnded === true || this.res.destroyed === true;
+    }
+}
+//# sourceMappingURL=sse.js.map

package/dist/core/run-events/sse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.js","sourceRoot":"","sources":["../../../core/run-events/sse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAgBH,gGAAgG;AAChG,MAAM,CAAC,MAAM,WAAW,GAAqC;IAC3D,cAAc,EAAE,kCAAkC;IAClD,eAAe,EAAE,wBAAwB;IACzC,UAAU,EAAE,YAAY;IACxB,mBAAmB,EAAE,IAAI;CAC1B,CAAC;AAEF,8EAA8E;AAC9E,MAAM,UAAU,OAAO,CAAC,GAAgB;IACtC,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QACxD,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC7B,CAAC;AACH,CAAC;AAED,+FAA+F;AAC/F,MAAM,UAAU,cAAc,CAAC,KAAe;IAC5C,0EAA0E;IAC1E,yEAAyE;IACzE,0DAA0D;IAC1D,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IACrD,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IACvD,OAAO,OAAO,GAAG,YAAY,IAAI,WAAW,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC;AAC1E,CAAC;AAED;;;;GAIG;AACH,MAAM,OAAO,eAAe;IACT,GAAG,CAAc;IAClC,YAAY,GAAgB;QAC1B,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;IACD,IAAI,CAAC,KAAe;QAClB,IAAI,IAAI,CAAC,QAAQ,EAAE;YAAE,OAAO;QAC5B,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC;IACxC,CAAC;IACD,qGAAqG;IACrG,IAAI;QACF,IAAI,IAAI,CAAC,QAAQ,EAAE;YAAE,OAAO;QAC5B,+FAA+F;QAC/F,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;IACrC,CAAC;IACD;;;;OAIG;IACK,QAAQ;QACd,OAAO,IAAI,CAAC,GAAG,CAAC,aAAa,KAAK,IAAI,IAAI,IAAI,CAAC,GAAG,CAAC,SAAS,KAAK,IAAI,CAAC;IACxE,CAAC;CACF"}

package/dist/core/run-events/types.d.ts

@@ -0,0 +1,147 @@
+/**
+ * Run-event stream — shared types (Phase 3.3 enabler / Cockpit live-stream foundation).
+ *
+ * The orchestrator emits a monotonic, event-sourced stream describing a pipeline run's
+ * lifecycle (phase boundaries, per-agent start/finish/skip, budget, gate). This is the
+ * SEAM the live Cockpit consumes: the Bridge SSE layer (commit 2) serialises these events
+ * and the dashboard EventSource reducer (commit 3) folds them into a live view.
+ *
+ * Distinct from `core/run-mode` Frames (screencast pixels) — this stream is the pipeline
+ * STATE, not the browser image. Default is a no-op sink, so existing runs are unchanged and
+ * cost nothing. Pure data + a fail-safe fan-out; no I/O here.
+ *
+ * Spec: blueprint/03-BUILD-PLAN.md 3.3 (real pipeline stream, kill the setTimeout mock),
+ * blueprint/rules/dashboard-ux-vision.md.
+ */
+import type { Phase, AgentStatus, FindingSeverity } from '../types.js';
+/** Why an agent never ran this phase. */
+export type SkipReason = 'disabled' | 'unregistered' | 'license-gated';
+/** Discriminator for the run-event union. */
+export type RunEventKind = 'run-started' | 'phase-started' | 'agent-started' | 'agent-finished' | 'agent-skipped' | 'budget-exceeded' | 'gate-evaluated' | 'phase-finished' | 'run-finished' | 'question-asked' | 'question-answered';
+/** Pause-and-ask decision (mirrors core/escalation AnswerDecision; kept local so this stream stays self-contained). */
+export type RunAnswerDecision = 'approve' | 'reject' | 'modify';
+/** Fields every event carries. `seq` is monotonic (0-based); `atMs` is wall-clock from an injected clock. */
+interface BaseRunEvent {
+    readonly seq: number;
+    readonly atMs: number;
+    readonly kind: RunEventKind;
+}
+/** A whole run (possibly multiple phases) began. Emitted by the run driver, not runPhase. */
+export interface RunStartedEvent extends BaseRunEvent {
+    readonly kind: 'run-started';
+    readonly runId: string;
+    readonly phase: Phase;
+    readonly scheduledAgentIds: readonly number[];
+}
+export interface PhaseStartedEvent extends BaseRunEvent {
+    readonly kind: 'phase-started';
+    readonly phase: Phase;
+    readonly totalAgents: number;
+}
+export interface AgentStartedEvent extends BaseRunEvent {
+    readonly kind: 'agent-started';
+    readonly phase: Phase;
+    readonly agentId: number;
+    readonly agentName: string;
+}
+export interface AgentFinishedEvent extends BaseRunEvent {
+    readonly kind: 'agent-finished';
+    readonly phase: Phase;
+    readonly agentId: number;
+    readonly agentName: string;
+    readonly status: AgentStatus;
+    readonly durationMs: number;
+    readonly findingsCount: number;
+    readonly worstSeverity: FindingSeverity | null;
+}
+export interface AgentSkippedEvent extends BaseRunEvent {
+    readonly kind: 'agent-skipped';
+    readonly phase: Phase;
+    readonly agentId: number;
+    readonly agentName: string;
+    readonly reason: SkipReason;
+}
+export interface BudgetExceededEvent extends BaseRunEvent {
+    readonly kind: 'budget-exceeded';
+    readonly phase: Phase;
+    readonly totalCost: number;
+}
+export interface GateEvaluatedEvent extends BaseRunEvent {
+    readonly kind: 'gate-evaluated';
+    readonly phase: Phase;
+    readonly passed: boolean;
+    readonly failedBlockingAgents: readonly number[];
+}
+export interface PhaseFinishedEvent extends BaseRunEvent {
+    readonly kind: 'phase-finished';
+    readonly phase: Phase;
+    readonly passed: boolean;
+    readonly agentCount: number;
+    readonly skippedCount: number;
+}
+export interface RunFinishedEvent extends BaseRunEvent {
+    readonly kind: 'run-finished';
+    readonly runId: string;
+    readonly passed: boolean;
+}
+/** An agent paused and is asking the human (pause-and-ask). Mirrors core/escalation PendingQuestion. */
+export interface QuestionAskedEvent extends BaseRunEvent {
+    readonly kind: 'question-asked';
+    readonly questionId: string;
+    readonly agentId: number;
+    readonly title: string;
+    readonly detail: string;
+    readonly proposedAction?: string;
+}
+/** The human answered a pending question; the paused agent resumes. */
+export interface QuestionAnsweredEvent extends BaseRunEvent {
+    readonly kind: 'question-answered';
+    readonly questionId: string;
+    readonly decision: RunAnswerDecision;
+    readonly note?: string;
+}
+/** The full run-event union. Exhaustive — switch on `.kind`. */
+export type RunEvent = RunStartedEvent | PhaseStartedEvent | AgentStartedEvent | AgentFinishedEvent | AgentSkippedEvent | BudgetExceededEvent | GateEvaluatedEvent | PhaseFinishedEvent | RunFinishedEvent | QuestionAskedEvent | QuestionAnsweredEvent;
+/** Where run events are pushed (SSE transport, recorder, in-memory test sink, …). */
+export interface RunEventSink {
+    emit(event: RunEvent): void;
+}
+/** One agent's row in the folded live view. */
+export interface AgentView {
+    readonly agentId: number;
+    readonly agentName: string;
+    readonly status: AgentStatus;
+    readonly durationMs?: number;
+    readonly findingsCount?: number;
+    readonly worstSeverity?: FindingSeverity | null;
+    readonly skipReason?: SkipReason;
+}
+/** A question awaiting the human's answer, projected into the live view. */
+export interface PendingQuestionView {
+    readonly questionId: string;
+    readonly agentId: number;
+    readonly title: string;
+    readonly detail: string;
+    readonly proposedAction?: string;
+    readonly askedAtMs: number;
+}
+/** The result of folding a run-event stream — the Cockpit's live pipeline state. */
+export interface RunStateView {
+    runId: string | null;
+    phase: Phase | null;
+    phaseActive: boolean;
+    agents: Record<number, AgentView>;
+    gate: {
+        readonly evaluated: boolean;
+        readonly passed: boolean;
+        readonly failedBlockingAgents: readonly number[];
+    } | null;
+    budgetExceeded: boolean;
+    finished: boolean;
+    /** Open pause-and-ask questions, keyed by questionId (removed when answered). */
+    pendingQuestions: Record<string, PendingQuestionView>;
+    /** seq of the last applied event, or -1 if none. */
+    lastSeq: number;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/core/run-events/types.d.ts.map

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

package/dist/core/run-events/types.js

@@ -0,0 +1,17 @@
+/**
+ * Run-event stream — shared types (Phase 3.3 enabler / Cockpit live-stream foundation).
+ *
+ * The orchestrator emits a monotonic, event-sourced stream describing a pipeline run's
+ * lifecycle (phase boundaries, per-agent start/finish/skip, budget, gate). This is the
+ * SEAM the live Cockpit consumes: the Bridge SSE layer (commit 2) serialises these events
+ * and the dashboard EventSource reducer (commit 3) folds them into a live view.
+ *
+ * Distinct from `core/run-mode` Frames (screencast pixels) — this stream is the pipeline
+ * STATE, not the browser image. Default is a no-op sink, so existing runs are unchanged and
+ * cost nothing. Pure data + a fail-safe fan-out; no I/O here.
+ *
+ * Spec: blueprint/03-BUILD-PLAN.md 3.3 (real pipeline stream, kill the setTimeout mock),
+ * blueprint/rules/dashboard-ux-vision.md.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/run-events/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../core/run-events/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG"}

package/dist/core/run-mode/capture.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Screencast capture (Phase 3.2) — turns a live browser Page into a stream of screencast Frames.
+ *
+ * A browser-launching agent calls `startScreencast(page, frames)` after opening its Page (only on
+ * a headed run, when the Bridge supplied a FrameStreamer) and `stop()`s it before closing the Page.
+ * Each tick screenshots the page and pushes a Frame; a transient screenshot failure (navigation in
+ * flight, page already closed) is swallowed so a flaky screencast can NEVER break the actual test.
+ *
+ * Pure of any Playwright import — it depends only on the minimal `ScreencastPage` surface, so it is
+ * fully unit-testable with a mock page + injected timers.
+ */
+import type { FrameStreamer } from './run-mode.js';
+/** The minimal Playwright `Page` surface the screencast needs. A real Page satisfies it structurally. */
+export interface ScreencastPage {
+    screenshot(options?: {
+        readonly type?: 'jpeg' | 'png';
+        readonly quality?: number;
+    }): Promise<Buffer | Uint8Array>;
+}
+/**
+ * Capture a single frame from `page` and push it to `frames`. Best-effort: a screenshot failure
+ * (page closed, mid-navigation) is swallowed — the screencast is never allowed to break the run.
+ */
+export declare function captureFrame(page: ScreencastPage, frames: FrameStreamer): Promise<void>;
+/** Handle returned by {@link startScreencast}; call `stop()` before closing the page. */
+export interface ScreencastHandle {
+    stop(): void;
+}
+/**
+ * Start a periodic screencast of `page` into `frames`, returning a stop handle. Self-scheduling:
+ * each capture awaits before the next tick is scheduled, so a slow screenshot can't pile up timers,
+ * and `stop()` prevents any further capture.
+ */
+export declare function startScreencast(page: ScreencastPage, frames: FrameStreamer, options?: {
+    readonly intervalMs?: number;
+}): ScreencastHandle;
+//# sourceMappingURL=capture.d.ts.map

package/dist/core/run-mode/capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../../../core/run-mode/capture.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,yGAAyG;AACzG,MAAM,WAAW,cAAc;IAC7B,UAAU,CAAC,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;QAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,GAAG,UAAU,CAAC,CAAC;CACnH;AAMD;;;GAGG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAO7F;AAED,yFAAyF;AACzF,MAAM,WAAW,gBAAgB;IAC/B,IAAI,IAAI,IAAI,CAAC;CACd;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,cAAc,EACpB,MAAM,EAAE,aAAa,EACrB,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GACzC,gBAAgB,CAoBlB"}

package/dist/core/run-mode/capture.js

@@ -0,0 +1,43 @@
+function toBase64(buf) {
+    return Buffer.isBuffer(buf) ? buf.toString('base64') : Buffer.from(buf).toString('base64');
+}
+/**
+ * Capture a single frame from `page` and push it to `frames`. Best-effort: a screenshot failure
+ * (page closed, mid-navigation) is swallowed — the screencast is never allowed to break the run.
+ */
+export async function captureFrame(page, frames) {
+    try {
+        const buf = await page.screenshot({ type: 'jpeg', quality: 50 });
+        frames.emit(toBase64(buf), 'image/jpeg');
+    }
+    catch {
+        // best-effort screencast — a failed screenshot is ignored, not propagated
+    }
+}
+/**
+ * Start a periodic screencast of `page` into `frames`, returning a stop handle. Self-scheduling:
+ * each capture awaits before the next tick is scheduled, so a slow screenshot can't pile up timers,
+ * and `stop()` prevents any further capture.
+ */
+export function startScreencast(page, frames, options) {
+    const intervalMs = options?.intervalMs ?? 500;
+    let active = true;
+    let timer = null;
+    const loop = () => {
+        if (!active)
+            return;
+        void captureFrame(page, frames).finally(() => {
+            if (active)
+                timer = setTimeout(loop, intervalMs);
+        });
+    };
+    timer = setTimeout(loop, intervalMs);
+    return {
+        stop() {
+            active = false;
+            if (timer !== null)
+                clearTimeout(timer);
+        },
+    };
+}
+//# sourceMappingURL=capture.js.map

package/dist/core/run-mode/capture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture.js","sourceRoot":"","sources":["../../../core/run-mode/capture.ts"],"names":[],"mappings":"AAkBA,SAAS,QAAQ,CAAC,GAAwB;IACxC,OAAO,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AAC7F,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAoB,EAAE,MAAqB;IAC5E,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;QACjE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,YAAY,CAAC,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,0EAA0E;IAC5E,CAAC;AACH,CAAC;AAOD;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAC7B,IAAoB,EACpB,MAAqB,EACrB,OAA0C;IAE1C,MAAM,UAAU,GAAG,OAAO,EAAE,UAAU,IAAI,GAAG,CAAC;IAC9C,IAAI,MAAM,GAAG,IAAI,CAAC;IAClB,IAAI,KAAK,GAAyC,IAAI,CAAC;IAEvD,MAAM,IAAI,GAAG,GAAS,EAAE;QACtB,IAAI,CAAC,MAAM;YAAE,OAAO;QACpB,KAAK,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE;YAC3C,IAAI,MAAM;gBAAE,KAAK,GAAG,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QACnD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,KAAK,GAAG,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAErC,OAAO;QACL,IAAI;YACF,MAAM,GAAG,KAAK,CAAC;YACf,IAAI,KAAK,KAAK,IAAI;gBAAE,YAAY,CAAC,KAAK,CAAC,CAAC;QAC1C,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/core/run-mode/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Run-mode & frame streaming — public surface (Phase 3.2 seam).
+ * Headed/headless single-source-of-truth + the Cockpit frame-stream sink.
+ */
+export type { RunMode, LaunchOptions, Frame, FrameSink } from './types.js';
+export { DEFAULT_RUN_MODE, resolveRunMode, launchOptions, NoopFrameSink, InMemoryFrameSink, FrameStreamer, } from './run-mode.js';
+export type { ScreencastPage, ScreencastHandle } from './capture.js';
+export { captureFrame, startScreencast } from './capture.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/run-mode/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../core/run-mode/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,YAAY,EAAE,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACxE,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,aAAa,GACd,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC"}

package/dist/core/run-mode/index.js

@@ -0,0 +1,3 @@
+export { DEFAULT_RUN_MODE, resolveRunMode, launchOptions, NoopFrameSink, InMemoryFrameSink, FrameStreamer, } from './run-mode.js';
+export { captureFrame, startScreencast } from './capture.js';
+//# sourceMappingURL=index.js.map

package/dist/core/run-mode/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../core/run-mode/index.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,aAAa,GACd,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC"}

package/dist/core/run-mode/run-mode.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Run-mode resolution + frame streaming (Phase 3.2 seam). Spec: build-plan 3.2.
+ */
+import type { Frame, FrameSink, LaunchOptions, RunMode } from './types.js';
+/** Default: headless (backward-compatible with every existing engine launch site). */
+export declare const DEFAULT_RUN_MODE: RunMode;
+/** Resolve a RunMode from partial config/flags (e.g. a `--headed` CLI option or the Cockpit). */
+export declare function resolveRunMode(input?: {
+    readonly headed?: boolean;
+    readonly slowMoMs?: number;
+}): RunMode;
+/** Derive Playwright launch options — the single place headed/headless is decided. */
+export declare function launchOptions(mode?: RunMode): LaunchOptions;
+/** Zero-cost default sink — non-streamed runs pay nothing. */
+export declare class NoopFrameSink implements FrameSink {
+    push(): void;
+}
+/** In-memory sink for tests/recording. */
+export declare class InMemoryFrameSink implements FrameSink {
+    private readonly frames;
+    push(frame: Frame): void;
+    get all(): readonly Frame[];
+}
+/** Emits sequenced, timestamped frames to a sink (default no-op). */
+export declare class FrameStreamer {
+    private seq;
+    private readonly sink;
+    private readonly now;
+    constructor(sink?: FrameSink, options?: {
+        readonly clock?: () => number;
+    });
+    emit(dataBase64: string, mime?: string): Frame;
+    get frameCount(): number;
+}
+//# sourceMappingURL=run-mode.d.ts.map

package/dist/core/run-mode/run-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-mode.d.ts","sourceRoot":"","sources":["../../../core/run-mode/run-mode.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAExE,sFAAsF;AACtF,eAAO,MAAM,gBAAgB,EAAE,OAA2B,CAAC;AAE3D,iGAAiG;AACjG,wBAAgB,cAAc,CAAC,KAAK,CAAC,EAAE;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAKzG;AAED,sFAAsF;AACtF,wBAAgB,aAAa,CAAC,IAAI,GAAE,OAA0B,GAAG,aAAa,CAK7E;AAED,8DAA8D;AAC9D,qBAAa,aAAc,YAAW,SAAS;IAC7C,IAAI,IAAI,IAAI;CAGb;AAED,0CAA0C;AAC1C,qBAAa,iBAAkB,YAAW,SAAS;IACjD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,IAAI,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAGxB,IAAI,GAAG,IAAI,SAAS,KAAK,EAAE,CAE1B;CACF;AAED,qEAAqE;AACrE,qBAAa,aAAa;IACxB,OAAO,CAAC,GAAG,CAAK;IAChB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAY;IACjC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;gBAEvB,IAAI,GAAE,SAA+B,EAAE,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,MAAM,CAAA;KAAE;IAK9F,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,SAAe,GAAG,KAAK;IAMpD,IAAI,UAAU,IAAI,MAAM,CAEvB;CACF"}

package/dist/core/run-mode/run-mode.js

@@ -0,0 +1,51 @@
+/** Default: headless (backward-compatible with every existing engine launch site). */
+export const DEFAULT_RUN_MODE = { headed: false };
+/** Resolve a RunMode from partial config/flags (e.g. a `--headed` CLI option or the Cockpit). */
+export function resolveRunMode(input) {
+    return {
+        headed: input?.headed ?? false,
+        ...(input?.slowMoMs !== undefined ? { slowMoMs: input.slowMoMs } : {}),
+    };
+}
+/** Derive Playwright launch options — the single place headed/headless is decided. */
+export function launchOptions(mode = DEFAULT_RUN_MODE) {
+    return {
+        headless: !mode.headed,
+        ...(mode.slowMoMs !== undefined ? { slowMo: mode.slowMoMs } : {}),
+    };
+}
+/** Zero-cost default sink — non-streamed runs pay nothing. */
+export class NoopFrameSink {
+    push() {
+        // intentionally does nothing
+    }
+}
+/** In-memory sink for tests/recording. */
+export class InMemoryFrameSink {
+    frames = [];
+    push(frame) {
+        this.frames.push(frame);
+    }
+    get all() {
+        return this.frames.slice();
+    }
+}
+/** Emits sequenced, timestamped frames to a sink (default no-op). */
+export class FrameStreamer {
+    seq = 0;
+    sink;
+    now;
+    constructor(sink = new NoopFrameSink(), options) {
+        this.sink = sink;
+        this.now = options?.clock ?? (() => Date.now());
+    }
+    emit(dataBase64, mime = 'image/jpeg') {
+        const frame = { seq: this.seq++, atMs: this.now(), dataBase64, mime };
+        this.sink.push(frame);
+        return frame;
+    }
+    get frameCount() {
+        return this.seq;
+    }
+}
+//# sourceMappingURL=run-mode.js.map

package/dist/core/run-mode/run-mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-mode.js","sourceRoot":"","sources":["../../../core/run-mode/run-mode.ts"],"names":[],"mappings":"AAKA,sFAAsF;AACtF,MAAM,CAAC,MAAM,gBAAgB,GAAY,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AAE3D,iGAAiG;AACjG,MAAM,UAAU,cAAc,CAAC,KAAiE;IAC9F,OAAO;QACL,MAAM,EAAE,KAAK,EAAE,MAAM,IAAI,KAAK;QAC9B,GAAG,CAAC,KAAK,EAAE,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACvE,CAAC;AACJ,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,aAAa,CAAC,OAAgB,gBAAgB;IAC5D,OAAO;QACL,QAAQ,EAAE,CAAC,IAAI,CAAC,MAAM;QACtB,GAAG,CAAC,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAClE,CAAC;AACJ,CAAC;AAED,8DAA8D;AAC9D,MAAM,OAAO,aAAa;IACxB,IAAI;QACF,6BAA6B;IAC/B,CAAC;CACF;AAED,0CAA0C;AAC1C,MAAM,OAAO,iBAAiB;IACX,MAAM,GAAY,EAAE,CAAC;IACtC,IAAI,CAAC,KAAY;QACf,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IACD,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IAC7B,CAAC;CACF;AAED,qEAAqE;AACrE,MAAM,OAAO,aAAa;IAChB,GAAG,GAAG,CAAC,CAAC;IACC,IAAI,CAAY;IAChB,GAAG,CAAe;IAEnC,YAAY,OAAkB,IAAI,aAAa,EAAE,EAAE,OAA2C;QAC5F,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,GAAG,GAAG,OAAO,EAAE,KAAK,IAAI,CAAC,GAAW,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,IAAI,CAAC,UAAkB,EAAE,IAAI,GAAG,YAAY;QAC1C,MAAM,KAAK,GAAU,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;QAC7E,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACtB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,GAAG,CAAC;IAClB,CAAC;CACF"}