@reticlehq/browser 2.0.0

package/dist/reticle.js

@@ -0,0 +1,379 @@
+import { EventType, RETICLE_DEFAULT_PORT, RETICLE_PROTOCOL_VERSION, RETICLE_URL_PARAM, RETICLE_WS_PATH, ReticleCommand, MessageKind, SESSION_AUTO, SessionState, TRANSPORT_LIMITS, isLoopbackHostname, } from '@reticlehq/core';
+import { createCommandRegistry } from './commands/commands.js';
+import { Transport } from './transport/transport.js';
+import { adapterNames } from './registry/adapters.js';
+import { registerCapabilities, hasCapabilities, } from './registry/capabilities.js';
+import { installDom } from './observers/dom.js';
+import { installNetwork } from './observers/network.js';
+import { installRoute } from './observers/route.js';
+import { installConsole } from './observers/console.js';
+import { installAnimation } from './observers/animation.js';
+import { installScroll } from './observers/scroll.js';
+import { installHealth } from './observers/health.js';
+import { installOverlay } from './presenter/overlay.js';
+import { Presenter, LOG_KIND, LOG_RESULT, } from './presenter/presenter.js';
+import { actionVerb } from './presenter/presenter-verbs.js';
+import { str, refLabel, modeForCommand, presentStatus } from './reticle-presenter-helpers.js';
+import { resetClock } from './timers/clock.js';
+import { installRecorder } from './recorder/recorder.js';
+import { Annotator } from './review/annotator.js';
+/**
+ * Runtime backstop for the dev-only SDK: block connecting when the build reports production, unless
+ * explicitly overridden. Pure so it's testable; connect() reads NODE_ENV safely (process may be absent
+ * in a raw browser). This is defense-in-depth — the primary guard is the consumer gating the import
+ * behind `import.meta.env.DEV` so the SDK is dead-code-eliminated from prod bundles entirely.
+ */
+export function shouldBlockProduction(nodeEnv, allowInProduction) {
+    return nodeEnv === 'production' && !allowInProduction;
+}
+export function connectionPolicy(pageHostname, bridgeUrl, allowNonLocalhost, token) {
+    let bridge;
+    try {
+        bridge = new URL(bridgeUrl);
+    }
+    catch {
+        return { allowed: false, reason: 'invalid Reticle bridge URL' };
+    }
+    if (bridge.protocol !== 'ws:' && bridge.protocol !== 'wss:') {
+        return { allowed: false, reason: 'Reticle bridge URL must use ws:// or wss://' };
+    }
+    if ((token?.length ?? 0) > TRANSPORT_LIMITS.MAX_TOKEN_LENGTH) {
+        return {
+            allowed: false,
+            reason: `Reticle pairing token exceeds ${String(TRANSPORT_LIMITS.MAX_TOKEN_LENGTH)} characters`,
+        };
+    }
+    const remoteBridge = !isLoopbackHostname(bridge.hostname);
+    if (remoteBridge && bridge.protocol !== 'wss:') {
+        return { allowed: false, reason: 'a non-local Reticle bridge must use wss://' };
+    }
+    const remote = !isLoopbackHostname(pageHostname) || remoteBridge;
+    if (!remote)
+        return { allowed: true };
+    if (!allowNonLocalhost) {
+        return {
+            allowed: false,
+            reason: 'Reticle is disabled outside localhost unless allowNonLocalhost is explicitly enabled',
+        };
+    }
+    if (token === undefined || token.length === 0) {
+        return { allowed: false, reason: 'a pairing token is required outside localhost' };
+    }
+    return { allowed: true };
+}
+/** HUD summary when the SDK self-ends a session because the bridge (server/agent) became unreachable. */
+const BRIDGE_LOST_SUMMARY = 'Session ended — lost connection to Reticle (the agent is no longer running).';
+/**
+ * Resolve the session label. An absent label or the `auto` sentinel yields a fresh per-tab id (via
+ * the injected generator) so multi-tab / new-tab routes never collide; any other label is used
+ * verbatim so tabs can intentionally share a session. `gen` is injected to keep this clock-free.
+ */
+export function resolveSessionLabel(option, gen) {
+    return option === undefined || option === SESSION_AUTO ? gen() : option;
+}
+// Re-exported from the protocol (the wire contract) so callers/tests can import it from the SDK too.
+export { RETICLE_URL_PARAM };
+/**
+ * Extract Reticle identity overrides from a `location.search` string. Pure (takes the string, not the
+ * window) so it's testable without a DOM. Explicit connect() options still win over these.
+ */
+export function reticleParamsFromSearch(search) {
+    const params = new URLSearchParams(search);
+    const out = {};
+    const session = params.get(RETICLE_URL_PARAM.SESSION);
+    const projectId = params.get(RETICLE_URL_PARAM.PROJECT);
+    if (session !== null && session.length > 0)
+        out.session = session;
+    if (projectId !== null && projectId.length > 0)
+        out.projectId = projectId;
+    return out;
+}
+/**
+ * Resolve the session + project identity for a connection: an explicit, non-`auto` option wins;
+ * otherwise a launcher-stamped URL param is used; otherwise undefined (caller generates a per-tab id).
+ * Crucially `auto` is treated like "unset" so an app that passes the auto sentinel still lets a pooled
+ * launcher correlate the lease via __reticle_session. Pure for testability.
+ */
+export function resolveConnectIdentity(options, search) {
+    const url = reticleParamsFromSearch(search);
+    const explicitSession = options.session !== undefined && options.session !== SESSION_AUTO ? options.session : undefined;
+    const projectId = options.projectId ?? url.projectId;
+    return {
+        session: explicitSession ?? url.session,
+        projectId: projectId !== undefined && projectId.length > 0 ? projectId : undefined,
+    };
+}
+/**
+ * The browser-side orchestrator. Wires observers -> events -> bridge, and bridge
+ * commands -> handlers. Embedded in the host app (dev only).
+ */
+export class Reticle {
+    #transport;
+    #registry = new Map();
+    #teardowns = [];
+    #connected = false;
+    #session = 'default';
+    #start = 0;
+    #overlay;
+    #presenter;
+    #recorder;
+    #annotator;
+    #eventCount = 0;
+    #token;
+    #projectId;
+    /** Act-row log handle for the in-flight act/act_sequence, so its outcome stamps the right row. */
+    #actHandle;
+    connect(options = {}) {
+        if (this.#connected)
+            return;
+        if (typeof window === 'undefined' || typeof document === 'undefined')
+            return;
+        // Dev-only backstop: refuse to activate in a production build (SSR healthcheck, prod bundle opened
+        // on localhost). `process` may not exist in a raw browser, so read NODE_ENV off globalThis.
+        const proc = globalThis.process;
+        const nodeEnv = proc?.env?.NODE_ENV;
+        if (shouldBlockProduction(nodeEnv, options.allowInProduction === true)) {
+            globalThis.console.warn('[Reticle] disabled in production (NODE_ENV=production). Gate the import behind ' +
+                'import.meta.env.DEV, or pass allowInProduction:true to override.');
+            return;
+        }
+        const url = options.url ?? `ws://localhost:${String(RETICLE_DEFAULT_PORT)}${RETICLE_WS_PATH}`;
+        const policy = connectionPolicy(window.location.hostname, url, options.allowNonLocalhost === true, options.token);
+        if (!policy.allowed) {
+            globalThis.console.warn(`[Reticle] ${policy.reason ?? 'connection blocked'}`);
+            return;
+        }
+        // A pooled/headless launcher can stamp identity via namespaced URL params; explicit (non-auto)
+        // options win, but the `auto` sentinel defers to the URL param so leases correlate.
+        const identity = resolveConnectIdentity(options, window.location.search);
+        this.#session = resolveSessionLabel(identity.session, () => typeof globalThis.crypto?.randomUUID === 'function'
+            ? `s${globalThis.crypto.randomUUID()}`
+            : `s${Date.now().toString(36)}`);
+        this.#token =
+            options.token !== undefined && options.token.length > 0 ? options.token : undefined;
+        this.#projectId = identity.projectId;
+        this.#start = performance.now();
+        this.#registry = createCommandRegistry();
+        this.#transport = new Transport({
+            url,
+            hello: () => this.#hello(),
+            handleCommand: (command) => this.#handleCommand(command),
+            // Show the presenter HUD as soon as the agent bridge connects — the user immediately sees
+            // the glow border and narration panel, even before the first tool call lands.
+            onConnected: () => this.#presenter?.sessionStart(),
+            // Liveness fallback: if the bridge stays unreachable (the agent killed the server process),
+            // no server-pushed end can arrive — so end the run we're presenting ourselves. A returning
+            // agent revives it via the normal sessionStart() path on its next command.
+            onConnectionLost: () => {
+                if (this.#presenter?.sessionActive === true) {
+                    this.#presenter.setState(SessionState.ENDED, BRIDGE_LOST_SUMMARY);
+                }
+            },
+            // First-connect never succeeded ⇒ the bridge is unreachable at this URL. Tell the developer
+            // exactly what went wrong and how to fix it, instead of retrying silently forever.
+            onUnreachable: ({ url: tried, attempts }) => {
+                globalThis.console.warn(`[Reticle] could not reach the bridge at ${tried} after ${String(attempts)} attempts. ` +
+                    `Is the Reticle daemon running on that port? If your app runs in a container/devcontainer/WSL, ` +
+                    `the daemon is on a different host — set the WS URL explicitly (Vite: VITE_RETICLE_WS_URL, ` +
+                    `or reticle.connect({ url })). Still retrying…`);
+            },
+        });
+        const emit = this.#emit;
+        this.#teardowns = [
+            installNetwork(emit),
+            installRoute(emit),
+            installConsole(emit),
+            installAnimation(emit),
+            installScroll(emit),
+            installDom(emit),
+            installHealth(emit), // page visibility/focus health + heartbeat
+        ];
+        if (options.overlay === true) {
+            this.#overlay = installOverlay();
+            this.#overlay.update({ connected: true, events: 0 });
+        }
+        if (options.present !== false) {
+            const presenterOptions = {};
+            if (options.pace !== undefined)
+                presenterOptions.paceMs = options.pace;
+            if (options.narrationDwellMs !== undefined) {
+                presenterOptions.narrationDwellMs = options.narrationDwellMs;
+            }
+            if (options.border !== undefined)
+                presenterOptions.border = options.border;
+            if (options.logMax !== undefined)
+                presenterOptions.logMax = options.logMax;
+            if (options.endedFadeMs !== undefined)
+                presenterOptions.endedFadeMs = options.endedFadeMs;
+            if (options.idleEndMs !== undefined)
+                presenterOptions.idleEndMs = options.idleEndMs;
+            presenterOptions.sessionId = this.#session;
+            // The panel calls this when the human pauses/resumes/ends or sends a message. We emit a
+            // HUMAN_CONTROL event over the existing transport; #emit stamps `t` from the elapsed clock.
+            presenterOptions.onControl = (intent) => this.#emit(EventType.HUMAN_CONTROL, intent.text !== undefined
+                ? { kind: intent.kind, text: intent.text }
+                : { kind: intent.kind });
+            this.#presenter = new Presenter(presenterOptions);
+            // Mount the overlay. The session (glow + HUD) activates on bridge connect via onConnected,
+            // so the presenter is visible as soon as the agent is reachable — not just on first command.
+            this.#presenter.mount();
+        }
+        if (options.recorder === true) {
+            this.#recorder = installRecorder({ emit, now: () => Date.now() });
+            this.#recorder.mount();
+        }
+        // The "Flag a bug" annotator rides with the presenter (the human surface) unless explicitly off.
+        if (options.annotate ?? options.present !== false) {
+            const presenter = this.#presenter;
+            this.#annotator = new Annotator({
+                emit,
+                now: () => Date.now(),
+                // Echo the flag into the live panel so the human watches their bug report land in the log.
+                onMark: (note, label) => presenter?.log(LOG_KIND.HUMAN, `🚩 ${label}: ${note}`),
+            });
+            this.#annotator.mount();
+        }
+        this.#transport.connect();
+        this.#connected = true;
+    }
+    /** Whether the in-page SDK is connected to the bridge (read by createReticleEmitter, P5a). */
+    get connected() {
+        return this.#connected;
+    }
+    /** Surface an arbitrary app-domain observation the DOM can't express (plan/03 §7). */
+    signal(name, data = {}) {
+        this.#emit(EventType.SIGNAL, { name, data });
+    }
+    /** Report a framework/store state change the agent can observe and assert on. */
+    state(name, value) {
+        this.#emit(EventType.STATE_CHANGE, { name, value });
+    }
+    /** Advertise the app's testable surface so the agent learns it without reading source. */
+    describe(input) {
+        registerCapabilities(input);
+    }
+    /** Live-control: end the session programmatically from the host app (drives the panel to ended). */
+    endSession() {
+        this.#presenter?.setState(SessionState.ENDED);
+    }
+    disconnect() {
+        if (!this.#connected)
+            return;
+        for (const teardown of this.#teardowns)
+            teardown();
+        this.#teardowns = [];
+        this.#transport?.close();
+        this.#transport = undefined;
+        this.#overlay?.destroy();
+        this.#overlay = undefined;
+        this.#presenter?.sessionEnd(); // fade the border out before tearing the overlay down
+        this.#presenter?.destroy();
+        this.#presenter = undefined;
+        this.#recorder?.destroy();
+        this.#recorder = undefined;
+        this.#annotator?.destroy();
+        this.#annotator = undefined;
+        resetClock(); // restore any frozen timers
+        this.#connected = false;
+    }
+    #emit = (type, data, ref) => {
+        const event = {
+            t: Math.round(performance.now() - this.#start),
+            type,
+            sessionId: this.#session,
+            ref,
+            data,
+        };
+        this.#transport?.sendEvent(event);
+        this.#eventCount += 1;
+        this.#overlay?.update({ connected: true, events: this.#eventCount });
+        // On a route change, re-scope the HUD's replay-flow chips to the page we're now on.
+        if (type === EventType.ROUTE_CHANGE)
+            this.#presenter?.refilterFlows();
+    };
+    #hello() {
+        return {
+            kind: MessageKind.HELLO,
+            protocolVersion: RETICLE_PROTOCOL_VERSION,
+            sessionId: this.#session,
+            ...(this.#projectId === undefined ? {} : { projectId: this.#projectId }),
+            url: location.href,
+            title: document.title,
+            adapters: adapterNames(),
+            ...(this.#token === undefined ? {} : { token: this.#token }),
+            hasCapabilities: hasCapabilities(),
+        };
+    }
+    async #handleCommand(command) {
+        // NARRATE: the agent tells the human what it's about to do / decide (presenter HUD).
+        if (command.name === ReticleCommand.NARRATE) {
+            this.#presenter?.sessionStart(); // first agent activity → reveal the glow + panel
+            this.#presenter?.narrate(str(command.args['text']), str(command.args['level'], 'info'));
+            return { ok: true, result: { shown: this.#presenter !== undefined } };
+        }
+        // SESSION_CONFIG: the agent tunes the session for the app (currently the idle-end window).
+        if (command.name === ReticleCommand.SESSION_CONFIG) {
+            const idleEndMs = command.args['idleEndMs'];
+            if (typeof idleEndMs === 'number')
+                this.#presenter?.setIdleEndMs(idleEndMs);
+            return { ok: true, result: { applied: this.#presenter !== undefined, idleEndMs } };
+        }
+        // Bridge → browser presenter pushes (PRESENTER state echo / FLOWS replay list). The presenter owns
+        // the parsing; here we only report whether a panel was mounted to apply it. setState-only, so a
+        // PRESENTER echo of a HUMAN_CONTROL can't loop back into a re-emit.
+        if (command.name === ReticleCommand.PRESENTER || command.name === ReticleCommand.FLOWS) {
+            this.#presenter?.handlePush(command);
+            return { ok: true, result: { applied: this.#presenter !== undefined } };
+        }
+        const handler = this.#registry.get(command.name);
+        if (handler === undefined) {
+            return { ok: false, error: `unknown command '${command.name}'` };
+        }
+        this.#presenter?.sessionStart(); // first agent command → reveal the glow + panel
+        await this.#presentBefore(command);
+        try {
+            const result = await handler(command.args);
+            this.#actHandle?.result(LOG_RESULT.PASS);
+            return { ok: true, result };
+        }
+        catch (error) {
+            this.#actHandle?.result(LOG_RESULT.FAIL);
+            return { ok: false, error: error instanceof Error ? error.message : String(error) };
+        }
+        finally {
+            this.#actHandle = undefined;
+            this.#presenter?.scheduleIdle();
+        }
+    }
+    /** Drive the presenter (cursor/effects/status) before the real action runs. */
+    async #presentBefore(command) {
+        const p = this.#presenter;
+        if (p === undefined)
+            return;
+        p.setMode(modeForCommand(command.name)); // paint reading vs acting intent first
+        this.#actHandle = undefined;
+        if (command.name === ReticleCommand.ACT) {
+            const ref = str(command.args['ref']);
+            const label = refLabel(ref);
+            this.#actHandle = p.log(LOG_KIND.ACT, `${actionVerb(str(command.args['action']))} ${label}`);
+            await p.beforeAct(ref, str(command.args['action']), label);
+        }
+        else if (command.name === ReticleCommand.ACT_SEQUENCE) {
+            const steps = Array.isArray(command.args['steps']) ? command.args['steps'] : [];
+            for (const step of steps) {
+                const s = step;
+                const ref = str(s.ref);
+                const label = refLabel(ref);
+                // one log row per step; the last handle carries the sequence outcome glyph
+                this.#actHandle = p.log(LOG_KIND.ACT, `${actionVerb(str(s.action))} ${label}`);
+                await p.beforeAct(ref, str(s.action), label);
+            }
+        }
+        else {
+            const label = presentStatus(command.name, command.args);
+            p.status(label);
+            p.log(LOG_KIND.READ, label);
+        }
+    }
+}
+//# sourceMappingURL=reticle.js.map

package/dist/reticle.js.map

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

package/dist/review/annotator.d.ts

@@ -0,0 +1,36 @@
+import { EventType } from '@reticlehq/core';
+/**
+ * The human "annotate the bug where you see it" surface. A dev toggles annotate mode, clicks the
+ * element that looks wrong, types what's wrong, and Reticle pins a numbered marker + emits a HUMAN_MARK
+ * event the agent drains (reticle_review). The mark carries the element's re-resolvable anchor and —
+ * when available — the source file:line, so the agent fixes the exact element/code, not a guess.
+ *
+ * Self-contained and dev-only: every node carries a `data-reticle-mark` attribute so Reticle's own
+ * observers ignore it (see dom-ignore.ts), and clicks on its own UI never become marks.
+ */
+/** Injected so the SDK wires the real emit/clock and tests can drive both. */
+export interface AnnotatorDeps {
+    emit: (type: EventType, data: Record<string, unknown>) => void;
+    now: () => number;
+    /**
+     * Optional: called after a mark is sent so the SDK can echo it into the live presenter panel — the
+     * human sees their flag land in the same activity log they watch the agent in. No-op when the
+     * presenter isn't mounted.
+     */
+    onMark?: (note: string, label: string) => void;
+}
+export declare class Annotator {
+    #private;
+    constructor(deps: AnnotatorDeps);
+    /** Whether annotate mode is currently capturing clicks. */
+    get active(): boolean;
+    /** Number of marks sent this session (drives the pin numbering). */
+    get markCount(): number;
+    mount(): void;
+    destroy(): void;
+    /** Turn annotate mode on/off. With no argument, flips the current state. */
+    toggle(on?: boolean): void;
+}
+/** Construct + mount the annotator (mirrors installRecorder's ergonomics). */
+export declare function installAnnotator(deps: AnnotatorDeps): Annotator;
+//# sourceMappingURL=annotator.d.ts.map

package/dist/review/annotator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotator.d.ts","sourceRoot":"","sources":["../../src/review/annotator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAO5C;;;;;;;;GAQG;AAEH,8EAA8E;AAC9E,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IAC/D,GAAG,EAAE,MAAM,MAAM,CAAC;IAClB;;;;OAIG;IACH,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CAChD;AAkDD,qBAAa,SAAS;;gBAkBR,IAAI,EAAE,aAAa;IAM/B,2DAA2D;IAC3D,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,oEAAoE;IACpE,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,KAAK,IAAI,IAAI;IAuCb,OAAO,IAAI,IAAI;IA0Bf,4EAA4E;IAC5E,MAAM,CAAC,EAAE,CAAC,EAAE,OAAO,GAAG,IAAI;CA4J3B;AAgBD,8EAA8E;AAC9E,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,aAAa,GAAG,SAAS,CAI/D"}