@reticlehq/browser 2.0.0

package/dist/presenter/presenter.d.ts

@@ -0,0 +1,89 @@
+import { PresenterMode, type PresenterTone, SessionState } from '@reticlehq/core';
+import { type LogKind, type LogResult, type LogHandle } from './presenter-log.js';
+import { GlowPhase, type PresenterOptions } from './presenter-config.js';
+import { type PresenterRunState } from './presenter-run-state.js';
+import { type ControlHandler } from './presenter-controls.js';
+export type { ControlHandler, ControlIntent } from './presenter-controls.js';
+export { GlowPhase, type PresenterOptions } from './presenter-config.js';
+export { LOG_KIND, LOG_RESULT, type LogKind, type LogResult, type LogHandle, } from './presenter-log.js';
+export declare class Presenter {
+    #private;
+    constructor(options?: PresenterOptions);
+    /** Setter so reticle.ts can wire the control callback after construction. */
+    setControlHandler(handler: ControlHandler): void;
+    /** Current live-control session state mirrored onto the panel (data-reticle-state). */
+    get state(): SessionState;
+    /** Whether a run is currently being presented (false before the agent's first activity / after end). */
+    get sessionActive(): boolean;
+    /** Drive the panel's live-control visual state (server-push / agent path; never emits). */
+    setState(state: SessionState, text?: string, tone?: PresenterTone): void;
+    /** Apply a bridge→browser presenter push: PRESENTER (state echo) or FLOWS (replay list, the human's
+     *  no-agent replay surface). Owns the wire parsing so the SDK dispatcher stays a thin router;
+     *  setState-only so an echo can't re-emit. */
+    /** Re-scope the replay-flow chips to the current page (called by the SDK on route change). */
+    refilterFlows(): void;
+    handlePush(command: {
+        name: string;
+        args: Record<string, unknown>;
+    }): void;
+    /** Current cap on accumulated log rows. */
+    get logMax(): number;
+    set logMax(n: number);
+    mount(): void;
+    destroy(): void;
+    /**
+     * Session start: in 'session' border mode this fades the base border IN and keeps it on until
+     * sessionEnd(). Idempotent, and a no-op when unmounted or in 'busy' border mode.
+     */
+    sessionStart(): void;
+    /**
+     * Session end: hides the log/HUD and (in 'session' mode) clears the base border. Idempotent; a
+     * no-op without a prior sessionStart or when unmounted.
+     */
+    sessionEnd(): void;
+    /**
+     * Record agent activity. Idempotent while busy — only the first activity from idle/fading flips
+     * the glow on, so a burst never restarts the reticle-pulse animation (no strobe). Subsequent calls
+     * just refresh the last-activity timestamp and re-arm the idle check.
+     */
+    markActivity(): void;
+    /** Re-arm the quiet-window idle check (kept for reticle.ts's finally block). */
+    scheduleIdle(): void;
+    /** Test/diagnostic accessor for the current glow phase. */
+    glowPhase(): GlowPhase;
+    /** Current intent (reading vs acting), exposed for tests + the watcher. */
+    get mode(): PresenterMode;
+    /**
+     * Set the presenter intent. READING shows a cyan scan + chip and hides the cursor; ACTING
+     * keeps the warm cursor/ripple + chip; IDLE clears the chip. Drives color via data-reticle-mode.
+     */
+    setMode(mode: PresenterMode): void;
+    status(text: string): void;
+    /** Agent-tunable idle-end window (reticle_session). Floored so it can't be set uselessly small. */
+    setIdleEndMs(ms: number): void;
+    /**
+     * The exported "run state" for the Copy/Export buttons — everything the page holds about this
+     * run: session id, url, duration, capability surface, per-kind counts, and the full activity log.
+     * (The full network/console ring-buffer lives server-side; this is the in-page run summary.)
+     */
+    runState(): PresenterRunState;
+    /**
+     * Append an activity-log row. Accumulates (never overwrites): each call adds a timestamped row
+     * with a mode chip + text. Returns a handle to stamp the row's outcome glyph (✓/✗) later, or
+     * undefined when unmounted / when the text is empty after trimming.
+     */
+    log(kind: LogKind, text: string, result?: LogResult): LogHandle | undefined;
+    /** Back-compat: narration appends to the live log (append-only, never overwrites). */
+    narrate(text: string, level?: string): LogHandle | undefined;
+    /** Legacy no-op kept for source compat; outcomes now flow through LogHandle.result(). */
+    result(_ok: boolean): void;
+    /**
+     * Mirror the server's session.throttled() state onto the HUD border. When throttled (tab
+     * backgrounded or stale), the border turns amber so the developer knows actions are no-oping —
+     * the same signal the agent already reads from result.session.throttled.
+     */
+    setThrottled(throttled: boolean): void;
+    /** Fly the cursor to an element, play the action's effect, then pace for the human. */
+    beforeAct(refId: string, action: string, label: string): Promise<void>;
+}
+//# sourceMappingURL=presenter.d.ts.map

package/dist/presenter/presenter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presenter.d.ts","sourceRoot":"","sources":["../../src/presenter/presenter.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,aAAa,EACb,KAAK,aAAa,EAClB,YAAY,EAGb,MAAM,iBAAiB,CAAC;AAIzB,OAAO,EASL,KAAK,OAAO,EACZ,KAAK,SAAS,EACd,KAAK,SAAS,EACf,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAML,SAAS,EAYT,KAAK,gBAAgB,EACtB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAiB,KAAK,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAIjF,OAAO,EAOL,KAAK,cAAc,EACpB,MAAM,yBAAyB,CAAC;AAEjC,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAG7E,OAAO,EAAE,SAAS,EAAE,KAAK,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzE,OAAO,EACL,QAAQ,EACR,UAAU,EACV,KAAK,OAAO,EACZ,KAAK,SAAS,EACd,KAAK,SAAS,GACf,MAAM,oBAAoB,CAAC;AAO5B,qBAAa,SAAS;;gBA2CR,OAAO,GAAE,gBAAqB;IA2B1C,6EAA6E;IAC7E,iBAAiB,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAIhD,uFAAuF;IACvF,IAAI,KAAK,IAAI,YAAY,CAExB;IAED,wGAAwG;IACxG,IAAI,aAAa,IAAI,OAAO,CAE3B;IAED,2FAA2F;IAC3F,QAAQ,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,IAAI;IAIxE;;kDAE8C;IAC9C,8FAA8F;IAC9F,aAAa,IAAI,IAAI;IAIrB,UAAU,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAAG,IAAI;IAS1E,2CAA2C;IAC3C,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,MAAM,CAAC,CAAC,EAAE,MAAM,EAGnB;IAED,KAAK,IAAI,IAAI;IA+Cb,OAAO,IAAI,IAAI;IAaf;;;OAGG;IACH,YAAY,IAAI,IAAI;IAgCpB;;;OAGG;IACH,UAAU,IAAI,IAAI;IAclB;;;;OAIG;IACH,YAAY,IAAI,IAAI;IAIpB,gFAAgF;IAChF,YAAY,IAAI,IAAI;IAIpB,2DAA2D;IAC3D,SAAS,IAAI,SAAS;IAItB,2EAA2E;IAC3E,IAAI,IAAI,IAAI,aAAa,CAExB;IAED;;;OAGG;IACH,OAAO,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI;IAWlC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IA4C1B,mGAAmG;IACnG,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAK9B;;;;OAIG;IACH,QAAQ,IAAI,iBAAiB;IAW7B;;;;OAIG;IACH,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS;IAqC3E,sFAAsF;IACtF,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,SAAS,GAAG,SAAS,GAAG,SAAS;IAY5D,yFAAyF;IACzF,MAAM,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI;IAI1B;;;;OAIG;IACH,YAAY,CAAC,SAAS,EAAE,OAAO,GAAG,IAAI;IAQtC,uFAAuF;IACjF,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAgB7E"}

package/dist/presenter/presenter.js

@@ -0,0 +1,428 @@
+import { ReticleCommand, PresenterMode, SessionState, isPresenterTone, isSessionState, } from '@reticlehq/core';
+import { refs } from '../dom/refs.js';
+import { actionVerb } from './presenter-verbs.js';
+import { nativeSetTimeout, nativeClearTimeout, nativeNow } from '../timers/native-timers.js';
+import { LOG_KIND, CHIP_LABEL, DATA_RETICLE_LOG, HUMAN_ROW_PREFIX, clampLogMax, formatElapsed, humanDuration, appendLogRow, } from './presenter-log.js';
+import { PRESENTER_CSS } from './presenter-styles.js';
+import { BorderMode, DEFAULT_BORDER_MODE, DATA_BUSY, BUSY_OFF, DEFAULT_PACE, GlowPhase, IDLE_AFTER_MS, HEARTBEAT_MS, IDLE_NOTICE_MS, IDLE_END_MS, IDLE_END_MIN_MS, GLOW_FADE_MS, GLOW_ON, GLOW_OFF, DATA_ON, MIN_ATTR, THROTTLED_ATTR, } from './presenter-config.js';
+import { buildRunState } from './presenter-run-state.js';
+import { moveCursor, ringAround, spawnRipple, pace } from './presenter-effects.js';
+import { GlowController } from './presenter-glow.js';
+import { renderTally } from './presenter-tally.js';
+import { CONTROLS_HEAD_HTML, CONTROLS_BANNER_HTML, CONTROLS_FLOWS_HTML, CONTROLS_FOOT_HTML, ENDED_FADE_MS, ControlPanel, } from './presenter-controls.js';
+// Re-export the config surface so the public import path (`./presenter.js`) is unchanged.
+export { GlowPhase } from './presenter-config.js';
+export { LOG_KIND, LOG_RESULT, } from './presenter-log.js';
+// Presenter / transparency layer: a human watches the agent work. Glowing border while
+// active, a synthetic cursor that flies to targets, click/hover/type effects, and a HUD that
+// shows the current action + the agent's narrated intent. All nodes carry data-reticle-* attrs
+// so they're excluded from snapshots/observers (see dom-ignore.ts).
+export class Presenter {
+    #paceMs;
+    #root;
+    #glow;
+    #cursor;
+    #ring;
+    #hud;
+    #actLine;
+    #chip;
+    /** Live verdict tally (✓N ✗M) in the header — the running testing score the human watches. */
+    #tally;
+    #tallied = { passes: 0, fails: 0 };
+    #liveLine;
+    #mode = PresenterMode.IDLE;
+    #now;
+    #heartbeatMs;
+    #idleNoticeMs;
+    #borderMode;
+    /** The glow / activity state machine (border shimmer + cursor visibility from activity timing). */
+    #glowCtl;
+    /** Liveness: the most recent action text + a 1s ticker that ages it into an "idle · {dur}" clock. */
+    #lastActionText = '';
+    #heartbeatTimer;
+    /** Session lifecycle: idle-end window (tweakable), session id, start/end cursors, structured run log. */
+    #idleEndMs;
+    #sessionId;
+    #startMs;
+    #endMs;
+    #runLog = [];
+    /** Tracks sessionStart/sessionEnd so both are idempotent (no strobe / no spurious off-write). */
+    #sessionActive = false;
+    // v2: narration + action status accumulate in a persistent, timestamped, scrollable log.
+    #logMax;
+    #log;
+    /** now() of the first row, the baseline for the +elapsed timestamps. */
+    #logBaseMs;
+    // Live-control panel: the two-way control surface (Pause/Resume + End + message Send).
+    #onControl;
+    #panel;
+    constructor(options = {}) {
+        this.#paceMs = options.paceMs ?? DEFAULT_PACE;
+        this.#now = options.now ?? nativeNow;
+        this.#heartbeatMs = options.heartbeatMs ?? HEARTBEAT_MS;
+        this.#idleNoticeMs = options.idleNoticeMs ?? IDLE_NOTICE_MS;
+        this.#idleEndMs = options.idleEndMs ?? IDLE_END_MS;
+        this.#sessionId = options.sessionId ?? '';
+        this.#borderMode = options.border ?? DEFAULT_BORDER_MODE;
+        this.#glowCtl = new GlowController({
+            now: this.#now,
+            idleAfterMs: options.idleAfterMs ?? IDLE_AFTER_MS,
+            glowFadeMs: options.glowFadeMs ?? GLOW_FADE_MS,
+            borderMode: this.#borderMode,
+            setMode: (mode) => this.setMode(mode),
+        });
+        this.#logMax = clampLogMax(options.logMax);
+        this.#onControl = options.onControl;
+        this.#panel = new ControlPanel({
+            emit: (kind, text) => this.#onControl?.(text !== undefined ? { kind, text } : { kind }),
+            logHuman: (text) => {
+                this.log(LOG_KIND.HUMAN, HUMAN_ROW_PREFIX + text);
+            },
+            endedFadeMs: options.endedFadeMs ?? ENDED_FADE_MS,
+            runState: () => this.runState(),
+        });
+    }
+    /** Setter so reticle.ts can wire the control callback after construction. */
+    setControlHandler(handler) {
+        this.#onControl = handler;
+    }
+    /** Current live-control session state mirrored onto the panel (data-reticle-state). */
+    get state() {
+        return this.#panel.state;
+    }
+    /** Whether a run is currently being presented (false before the agent's first activity / after end). */
+    get sessionActive() {
+        return this.#sessionActive;
+    }
+    /** Drive the panel's live-control visual state (server-push / agent path; never emits). */
+    setState(state, text, tone) {
+        this.#panel.setState(state, text, tone);
+    }
+    /** Apply a bridge→browser presenter push: PRESENTER (state echo) or FLOWS (replay list, the human's
+     *  no-agent replay surface). Owns the wire parsing so the SDK dispatcher stays a thin router;
+     *  setState-only so an echo can't re-emit. */
+    /** Re-scope the replay-flow chips to the current page (called by the SDK on route change). */
+    refilterFlows() {
+        this.#panel.refilterFlows();
+    }
+    handlePush(command) {
+        const a = command.args;
+        if (command.name === ReticleCommand.FLOWS)
+            return void this.#panel.setFlows(a['flows']);
+        const state = a['state'];
+        const tone = a['tone'];
+        const text = typeof a['text'] === 'string' && a['text'].length > 0 ? a['text'] : undefined;
+        if (isSessionState(state))
+            this.setState(state, text, isPresenterTone(tone) ? tone : undefined);
+    }
+    /** Current cap on accumulated log rows. */
+    get logMax() {
+        return this.#logMax;
+    }
+    set logMax(n) {
+        this.#logMax = clampLogMax(n);
+        this.#pruneLog();
+    }
+    mount() {
+        if (this.#root !== undefined || typeof document === 'undefined')
+            return;
+        const style = document.createElement('style');
+        style.setAttribute('data-reticle-overlay', '');
+        style.textContent = PRESENTER_CSS;
+        document.head.appendChild(style);
+        const root = document.createElement('div');
+        root.setAttribute('data-reticle-overlay', '');
+        root.innerHTML = `
+      <div data-reticle-glow></div>
+      <div data-reticle-cursor></div>
+      <div data-reticle-ring></div>
+      <div data-reticle-hud>
+        <div class="reticle-hud-head"><span class="reticle-dot"></span><span class="reticle-brand">Reticle</span><span class="reticle-chip" data-reticle-chip></span><span class="reticle-tally" data-reticle-tally hidden></span><span class="reticle-live"></span><span class="reticle-head-sp"></span><button type="button" data-reticle-min-btn title="Minimise" aria-label="Minimise the panel">⌄</button>${CONTROLS_HEAD_HTML}<span class="reticle-maxhint" aria-hidden="true">⌃</span></div>
+        <div class="reticle-act-strip"><span class="reticle-act">idle</span></div>
+        ${CONTROLS_BANNER_HTML}
+        <div ${DATA_RETICLE_LOG}></div>
+        ${CONTROLS_FLOWS_HTML}
+        ${CONTROLS_FOOT_HTML}
+      </div>`;
+        document.body.appendChild(root);
+        this.#root = root;
+        this.#glow = root.querySelector('[data-reticle-glow]') ?? undefined;
+        this.#cursor = root.querySelector('[data-reticle-cursor]') ?? undefined;
+        this.#ring = root.querySelector('[data-reticle-ring]') ?? undefined;
+        this.#hud = root.querySelector('[data-reticle-hud]') ?? undefined;
+        this.#actLine = root.querySelector('.reticle-act') ?? undefined;
+        this.#log = root.querySelector(`[${DATA_RETICLE_LOG}]`) ?? undefined;
+        this.#chip = root.querySelector('[data-reticle-chip]') ?? undefined;
+        this.#tally = root.querySelector('[data-reticle-tally]') ?? undefined;
+        this.#liveLine = root.querySelector('.reticle-live') ?? undefined;
+        // Minimise → collapse the panel to a bar (only the live line streams). Click the bar to restore.
+        const setMin = (on) => root.setAttribute(MIN_ATTR, on ? '1' : '0');
+        root.querySelector('[data-reticle-min-btn]')?.addEventListener('click', (e) => {
+            e.stopPropagation(); // don't let the head's maximise handler immediately re-open it
+            setMin(true);
+        });
+        root.querySelector('.reticle-hud-head')?.addEventListener('click', () => {
+            if (root.getAttribute(MIN_ATTR) === '1')
+                setMin(false); // clicking the minimised bar restores
+        });
+        this.#glowCtl.setElements(this.#glow, this.#cursor);
+        // The panel queries its refs, binds listeners, and paints the initial active state.
+        this.#panel.mount(root, this.#glow);
+        this.setMode(this.#mode);
+    }
+    destroy() {
+        this.#glowCtl.teardown();
+        if (this.#heartbeatTimer !== undefined)
+            nativeClearTimeout(this.#heartbeatTimer);
+        this.#heartbeatTimer = undefined;
+        this.#panel.teardown();
+        this.#sessionActive = false;
+        this.#logBaseMs = undefined;
+        this.#log = undefined;
+        this.#root?.remove();
+        document.querySelectorAll('style[data-reticle-overlay]').forEach((s) => s.remove());
+        this.#root = undefined;
+    }
+    /**
+     * Session start: in 'session' border mode this fades the base border IN and keeps it on until
+     * sessionEnd(). Idempotent, and a no-op when unmounted or in 'busy' border mode.
+     */
+    sessionStart() {
+        // Returning agent activity after the session ended (idle or explicit) revives it as a fresh run.
+        if (this.state === SessionState.ENDED) {
+            this.#revive();
+            return;
+        }
+        if (this.#sessionActive)
+            return;
+        this.#sessionActive = true;
+        this.#startMs ??= this.#now();
+        this.#endMs = undefined;
+        this.#showSession();
+        this.#glowCtl.resetActivity(this.#now());
+        this.#startHeartbeat();
+    }
+    /** Turn the base border (session mode) + the HUD/log on — the visible "session is live" state. */
+    #showSession() {
+        // The activity log/HUD persists the WHOLE session, like the border — it never fades on idle.
+        this.#hud?.setAttribute(DATA_ON, GLOW_ON);
+        // Base border persists in 'session' mode; 'busy' mode leaves it to the busy machine.
+        if (this.#borderMode === BorderMode.SESSION)
+            this.#glow?.setAttribute(DATA_ON, GLOW_ON);
+    }
+    /** Revive after an ended session (new agent activity): clear the ended state + glow back on. */
+    #revive() {
+        this.#panel.setState(SessionState.ACTIVE);
+        this.#endMs = undefined;
+        this.#showSession();
+        this.#glowCtl.resetActivity(this.#now());
+        this.#startHeartbeat();
+    }
+    /**
+     * Session end: hides the log/HUD and (in 'session' mode) clears the base border. Idempotent; a
+     * no-op without a prior sessionStart or when unmounted.
+     */
+    sessionEnd() {
+        if (!this.#sessionActive)
+            return;
+        this.#sessionActive = false;
+        if (this.#heartbeatTimer !== undefined) {
+            nativeClearTimeout(this.#heartbeatTimer);
+            this.#heartbeatTimer = undefined;
+        }
+        this.#hud?.setAttribute(DATA_ON, GLOW_OFF);
+        if (this.#borderMode === BorderMode.SESSION) {
+            this.#glow?.setAttribute(DATA_ON, GLOW_OFF);
+            this.#glow?.setAttribute(DATA_BUSY, BUSY_OFF);
+        }
+    }
+    /**
+     * Record agent activity. Idempotent while busy — only the first activity from idle/fading flips
+     * the glow on, so a burst never restarts the reticle-pulse animation (no strobe). Subsequent calls
+     * just refresh the last-activity timestamp and re-arm the idle check.
+     */
+    markActivity() {
+        this.#glowCtl.markActivity();
+    }
+    /** Re-arm the quiet-window idle check (kept for reticle.ts's finally block). */
+    scheduleIdle() {
+        this.#glowCtl.scheduleIdle();
+    }
+    /** Test/diagnostic accessor for the current glow phase. */
+    glowPhase() {
+        return this.#glowCtl.phase();
+    }
+    /** Current intent (reading vs acting), exposed for tests + the watcher. */
+    get mode() {
+        return this.#mode;
+    }
+    /**
+     * Set the presenter intent. READING shows a cyan scan + chip and hides the cursor; ACTING
+     * keeps the warm cursor/ripple + chip; IDLE clears the chip. Drives color via data-reticle-mode.
+     */
+    setMode(mode) {
+        this.#mode = mode;
+        this.#root?.setAttribute('data-reticle-mode', mode);
+        if (this.#chip !== undefined) {
+            this.#chip.textContent = CHIP_LABEL[mode];
+            this.#chip.setAttribute('data-mode', mode);
+        }
+        // READING has no real pointer to show (synthetic-hover pointer is native-only) — hide the cursor.
+        if (mode === PresenterMode.READING)
+            this.#cursor?.setAttribute(DATA_ON, GLOW_OFF);
+    }
+    status(text) {
+        this.markActivity();
+        this.#lastActionText = text;
+        if (this.#actLine !== undefined)
+            this.#actLine.textContent = text;
+    }
+    /**
+     * Liveness heartbeat (native 1s timer — never rAF, so it ticks in a foreground tab regardless of
+     * agent activity). Once the agent has been quiet for IDLE_NOTICE_MS, the act strip shows a LIVE,
+     * growing "◌ idle · {duration} since last action" — the signal that was missing when a stopped
+     * agent left the panel frozen and indistinguishable from one still thinking.
+     */
+    #startHeartbeat() {
+        if (this.#heartbeatTimer !== undefined)
+            nativeClearTimeout(this.#heartbeatTimer);
+        const tick = () => {
+            this.#tickLiveness();
+            this.#heartbeatTimer = nativeSetTimeout(tick, this.#heartbeatMs);
+        };
+        this.#heartbeatTimer = nativeSetTimeout(tick, this.#heartbeatMs);
+    }
+    #tickLiveness() {
+        if (!this.#sessionActive || this.#actLine === undefined)
+            return;
+        if (this.state === SessionState.ENDED)
+            return; // already ended — leave the summary
+        const idleMs = this.#now() - this.#glowCtl.lastActivityMs();
+        if (idleMs >= this.#idleEndMs) {
+            this.#endIdle(idleMs); // crossed the idle-end window → auto-end (glow off, panel kept)
+            return;
+        }
+        if (idleMs < this.#idleNoticeMs)
+            return; // still active (or a brief think) — keep the action text
+        const since = this.#lastActionText !== '' ? ` since last action` : '';
+        this.#actLine.textContent = `◌ idle · ${humanDuration(idleMs)}${since}`;
+    }
+    /** Auto-end after the idle window: stamp the end, drive the panel to ENDED, stop the heartbeat. */
+    #endIdle(idleMs) {
+        this.#endMs = this.#now();
+        this.#panel.setState(SessionState.ENDED, `idle ${humanDuration(idleMs)}`);
+        if (this.#heartbeatTimer !== undefined) {
+            nativeClearTimeout(this.#heartbeatTimer);
+            this.#heartbeatTimer = undefined;
+        }
+    }
+    /** Agent-tunable idle-end window (reticle_session). Floored so it can't be set uselessly small. */
+    setIdleEndMs(ms) {
+        if (!Number.isFinite(ms))
+            return;
+        this.#idleEndMs = Math.max(IDLE_END_MIN_MS, Math.floor(ms));
+    }
+    /**
+     * The exported "run state" for the Copy/Export buttons — everything the page holds about this
+     * run: session id, url, duration, capability surface, per-kind counts, and the full activity log.
+     * (The full network/console ring-buffer lives server-side; this is the in-page run summary.)
+     */
+    runState() {
+        return buildRunState({
+            sessionId: this.#sessionId,
+            state: this.state,
+            startMs: this.#startMs,
+            endMs: this.#endMs,
+            now: this.#now(),
+            runLog: this.#runLog,
+        });
+    }
+    /**
+     * Append an activity-log row. Accumulates (never overwrites): each call adds a timestamped row
+     * with a mode chip + text. Returns a handle to stamp the row's outcome glyph (✓/✗) later, or
+     * undefined when unmounted / when the text is empty after trimming.
+     */
+    log(kind, text, result) {
+        const ms = this.#now();
+        this.#glowCtl.markActivity(ms);
+        if (this.#log === undefined)
+            return undefined;
+        const trimmed = text.trim();
+        if (trimmed.length === 0)
+            return undefined;
+        this.#logBaseMs ??= ms;
+        // Structured run-log entry (mirrors the DOM row) for the exported run state, capped like the DOM.
+        const entry = result !== undefined
+            ? { at: ms - this.#logBaseMs, kind, text: trimmed, result }
+            : { at: ms - this.#logBaseMs, kind, text: trimmed };
+        this.#runLog.push(entry);
+        while (this.#runLog.length > this.#logMax)
+            this.#runLog.shift();
+        const ts = formatElapsed(ms - this.#logBaseMs);
+        const handle = appendLogRow(this.#log, kind, trimmed, ts, this.#logMax);
+        if (result !== undefined)
+            handle.result(result);
+        // Feed the minimised-bar live line so the latest activity always shows when collapsed.
+        if (this.#liveLine !== undefined)
+            this.#liveLine.textContent = trimmed;
+        this.#renderTally(); // a row that landed with a verdict updates the header score immediately
+        // Wrap the handle so a later outcome stamp updates BOTH the DOM glyph and the run-log entry.
+        return {
+            result: (r) => {
+                handle.result(r);
+                entry.result = r;
+                this.#renderTally(); // a deferred ✓/✗ stamp bumps the header tally
+            },
+        };
+    }
+    /** Repaint the header verdict tally from the run log; the side that grew gets a one-shot pop. */
+    #renderTally() {
+        this.#tallied = renderTally(this.#tally, this.#runLog, this.#tallied);
+    }
+    /** Back-compat: narration appends to the live log (append-only, never overwrites). */
+    narrate(text, level = 'info') {
+        const line = level === 'info' ? text : `[${level}] ${text}`;
+        return this.log(LOG_KIND.NARRATION, line);
+    }
+    #pruneLog() {
+        if (this.#log === undefined)
+            return;
+        while (this.#log.childElementCount > this.#logMax) {
+            this.#log.firstElementChild?.remove();
+        }
+    }
+    /** Legacy no-op kept for source compat; outcomes now flow through LogHandle.result(). */
+    result(_ok) {
+        /* no-op */
+    }
+    /**
+     * Mirror the server's session.throttled() state onto the HUD border. When throttled (tab
+     * backgrounded or stale), the border turns amber so the developer knows actions are no-oping —
+     * the same signal the agent already reads from result.session.throttled.
+     */
+    setThrottled(throttled) {
+        this.#root?.setAttribute(THROTTLED_ATTR, throttled ? '1' : '0');
+        if (throttled && this.#actLine !== undefined) {
+            this.#actLine.textContent =
+                'Tab backgrounded — actions throttled. Bring tab to front or use `reticle drive`.';
+        }
+    }
+    /** Fly the cursor to an element, play the action's effect, then pace for the human. */
+    async beforeAct(refId, action, label) {
+        const el = refs.resolve(refId);
+        this.status(`${actionVerb(action)} ${label}`);
+        if (!(el instanceof HTMLElement)) {
+            await pace(this.#paceMs);
+            return;
+        }
+        const rect = el.getBoundingClientRect();
+        const cx = rect.left + rect.width / 2;
+        const cy = rect.top + rect.height / 2;
+        moveCursor(this.#cursor, cx, cy);
+        ringAround(this.#ring, rect);
+        await pace(this.#paceMs);
+        if (action === 'click' || action === 'dblclick' || action === 'submit')
+            spawnRipple(this.#root, cx, cy);
+    }
+}
+//# sourceMappingURL=presenter.js.map

package/dist/presenter/presenter.js.map

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

package/dist/recorder/recorder-styles.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Inline style strings for the floating recorder toolbar. Browser-local UI
+ * text (never crosses the wire), split out of recorder.ts to keep that file under the 500-line cap
+ * (mirrors how presenter.ts extracts presenter-log.ts). All toolbar nodes also carry
+ * data-reticle-overlay, so they are snapshot-excluded via dom-ignore.ts regardless of these styles.
+ */
+export declare const TOOLBAR_CSS: string;
+export declare const BTN_CSS: string;
+export declare const NAME_CSS: string;
+export declare const STATUS_CSS: string;
+export declare const MENU_CSS: string;
+//# sourceMappingURL=recorder-styles.d.ts.map

package/dist/recorder/recorder-styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recorder-styles.d.ts","sourceRoot":"","sources":["../../src/recorder/recorder-styles.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,WAAW,QAkBb,CAAC;AAEZ,eAAO,MAAM,OAAO,QAQT,CAAC;AAEZ,eAAO,MAAM,QAAQ,QAOV,CAAC;AAEZ,eAAO,MAAM,UAAU,QAA+C,CAAC;AACvE,eAAO,MAAM,QAAQ,QAEpB,CAAC"}

package/dist/recorder/recorder-styles.js

@@ -0,0 +1,45 @@
+/**
+ * Inline style strings for the floating recorder toolbar. Browser-local UI
+ * text (never crosses the wire), split out of recorder.ts to keep that file under the 500-line cap
+ * (mirrors how presenter.ts extracts presenter-log.ts). All toolbar nodes also carry
+ * data-reticle-overlay, so they are snapshot-excluded via dom-ignore.ts regardless of these styles.
+ */
+export const TOOLBAR_CSS = [
+    'position:fixed',
+    'top:8px',
+    'left:50%',
+    'transform:translateX(-50%)',
+    'z-index:2147483647',
+    'display:flex',
+    'gap:6px',
+    'align-items:center',
+    'flex-wrap:wrap',
+    'max-width:90vw',
+    'font:12px ui-sans-serif,system-ui,sans-serif',
+    'background:#151823',
+    'color:#e6e9f0',
+    'border:1px solid #2a2f3d',
+    'border-radius:10px',
+    'padding:6px 10px',
+    'box-shadow:0 8px 30px rgba(0,0,0,.5)',
+].join(';');
+export const BTN_CSS = [
+    'font:inherit',
+    'cursor:pointer',
+    'background:#262b3a',
+    'color:#e6e9f0',
+    'border:1px solid #3a4151',
+    'border-radius:7px',
+    'padding:3px 9px',
+].join(';');
+export const NAME_CSS = [
+    'font:inherit',
+    'background:#0e1018',
+    'color:#e6e9f0',
+    'border:1px solid #3a4151',
+    'border-radius:7px',
+    'padding:3px 8px',
+].join(';');
+export const STATUS_CSS = ['opacity:.75', 'margin-left:4px'].join(';');
+export const MENU_CSS = ['display:flex', 'gap:6px', 'align-items:center', 'flex-wrap:wrap'].join(';');
+//# sourceMappingURL=recorder-styles.js.map

package/dist/recorder/recorder-styles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recorder-styles.js","sourceRoot":"","sources":["../../src/recorder/recorder-styles.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,gBAAgB;IAChB,SAAS;IACT,UAAU;IACV,4BAA4B;IAC5B,oBAAoB;IACpB,cAAc;IACd,SAAS;IACT,oBAAoB;IACpB,gBAAgB;IAChB,gBAAgB;IAChB,8CAA8C;IAC9C,oBAAoB;IACpB,eAAe;IACf,0BAA0B;IAC1B,oBAAoB;IACpB,kBAAkB;IAClB,sCAAsC;CACvC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAEZ,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,cAAc;IACd,gBAAgB;IAChB,oBAAoB;IACpB,eAAe;IACf,0BAA0B;IAC1B,mBAAmB;IACnB,iBAAiB;CAClB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAEZ,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,cAAc;IACd,oBAAoB;IACpB,eAAe;IACf,0BAA0B;IAC1B,mBAAmB;IACnB,iBAAiB;CAClB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAEZ,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,aAAa,EAAE,iBAAiB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACvE,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,cAAc,EAAE,SAAS,EAAE,oBAAoB,EAAE,gBAAgB,CAAC,CAAC,IAAI,CAC9F,GAAG,CACJ,CAAC"}