@reticlehq/browser 2.13.1 → 3.1.0

package/dist/presenter/presenter-report-copy.d.ts

@@ -1,112 +0,0 @@
-import { type ImpactScope, type ImpactSnapshot } from '@reticlehq/core';
-/**
- * What the report SAYS, kept away from how it looks.
- *
- * The wording here is the product's only claim about its own worth, so it is written once, in one
- * place, and tested. Two audiences, two registers:
- *
- *  - The REPORT is private. It is the user's own data, so it can carry everything, estimates
- *    included, as long as each estimate shows what it is measured against.
- *  - The SHARE card is public, and the research on developer stat-cards is blunt about what happens
- *    to a public card that leads with vendor savings: estimated token/time savings are the most
- *    mocked class of number in AI tooling (JetBrains measured ~10% against a viral 65% claim), and
- *    percentiles without a denominator get called misleading. So the card leads with what the
- *    user's own setup CAUGHT, and publishes its unknowns - the credibility move, and the thing a
- *    scoreboard would never do.
- */
-/** Reticle's own links, as they appear in the report footer. */
-export declare const REPORT_LINKS: {
-    readonly DOCS: "https://docs.reticle.sh";
-    readonly SITE: "https://reticle.sh";
-    readonly GITHUB: "https://github.com/reticlehq/reticle";
-    readonly DISCORD: "https://discord.gg/BwAbzv9ZRz";
-};
-/**
- * The X handle used for `via=` on a share.
- *
- * Empty until somebody who owns the account fills it in, and the share URL omits the parameter
- * while it is - a guessed handle credits a stranger, and there is no way for code to know.
- */
-export declare const SHARE_VIA_HANDLE = "";
-export declare const REPORT_TEXT: {
-    readonly TITLE: "Impact";
-    readonly PROJECT: "This project";
-    readonly GLOBAL: "Everything on this machine";
-    /**
-     * What `counts.failed` actually is: a verdict whose declared consequence did not hold.
-     *
-     * It used to read "defects caught before you saw them", which overclaims in the one direction a
-     * verification tool must never overclaim. A failed verdict is not proof of a defect in the app —
-     * it is equally the shape of an assertion that was wrong. Measured in the field: an agent
-     * asserted a clean console on an app with ordinary dev-mode logging, the verdict went red, and
-     * the panel reported a defect nobody had found.
-     *
-     * The honest word is what Reticle DID: it refused to pass them. That is true of the assertion
-     * error and the real bug alike, and it still reads as the tool having done its job.
-     */
-    readonly HERO_DEFECTS: "checks Reticle refused to pass";
-    readonly VERDICTS: "Verdicts";
-    readonly PASSED: "passed";
-    readonly FAILED: "failed";
-    readonly UNKNOWN: "unknown";
-    readonly UNKNOWN_HELP: "Reticle drove the app and could not tell what happened. Not a pass - shown, not hidden.";
-    readonly CALLS: "Tool calls";
-    readonly TOKENS: "Tokens returned";
-    readonly DRIVING: "Time driving";
-    readonly SESSIONS: "Sessions";
-    readonly STREAK: "day streak";
-    readonly LONGEST: "Longest run";
-    readonly SAVED_TOKENS: "Tokens saved";
-    readonly SAVED_MINUTES: "Time saved";
-    readonly ESTIMATE_TAG: "estimate";
-    readonly CHART: "Verdicts, last 30 days";
-    readonly DEFECTS: "What broke";
-    readonly DEFECTS_MORE: "Manage all of them on the dashboard";
-    /**
-     * What an UNLINKED user is told, and the only place the product tells them.
-     *
-     * The dashboard link renders only when `dashboardUrl` exists, which means only once a repo is
-     * already linked — so the person most likely to want one, watching this record climb on their own
-     * machine, was never told it existed. The single mention anywhere else is a daemon log line.
-     *
-     * Stated as a FACT about where the record lives, not as a pitch. It sits at the foot of a panel
-     * somebody opened on purpose, so it informs rather than interrupts, and it appears only once
-     * there is a verdict worth keeping — an offer to preserve nothing is just an advert.
-     */
-    readonly LOCAL_ONLY: "This record stops at this machine.";
-    readonly LOCAL_ONLY_ACTION: "reticle login";
-    readonly LOCAL_ONLY_TAIL: "keeps it, and lets a team see it.";
-    readonly DEFECTS_NONE: "Nothing has failed a declared consequence yet.";
-    readonly EMPTY: "Nothing recorded yet. Drive the app once and this fills in.";
-    readonly SHARE: "Share";
-    readonly COPY: "Copy";
-    readonly COPIED: "Copied";
-    readonly REFER: "Send to a friend";
-};
-/** "4.2k", "1.3M" - a number a person reads at a glance rather than counts digits in. */
-export declare function compactNumber(n: number): string;
-/** "2h 14m", "47m", "38s" - the same duration vocabulary the activity strip uses. */
-export declare function compactDuration(ms: number): string;
-/**
- * The post itself.
- *
- * Leads with defects caught, then the verdict split INCLUDING unknowns, then the superlative. No
- * estimated savings, no percentile, no leaderboard: those are the four things the evidence says get
- * a dev-tool card mocked rather than shared.
- */
-export declare function buildShareText(scope: ImpactScope, projectName?: string): string;
-/** X share intent. `via` is omitted while no handle is configured. */
-export declare function buildXShareUrl(text: string): string;
-/**
- * LinkedIn share.
- *
- * `share-offsite` takes a url and NOTHING else - the title/summary parameters were deprecated in
- * 2018 and are ignored, so the caption has to reach the composer some other way. The report copies
- * it to the clipboard before opening this, which is the only path that works without asking the
- * user for posting permissions.
- */
-export declare function buildLinkedInShareUrl(): string;
-/** What a referral says: the tool, not the sender's numbers. */
-export declare function buildReferralText(): string;
-/** Narrow an unknown push payload to a snapshot. Invalid shapes are ignored, never rendered. */
-export declare function parseImpactSnapshot(value: unknown): ImpactSnapshot | undefined;

package/dist/presenter/presenter-report-copy.js

@@ -1,156 +0,0 @@
-import { ImpactSnapshotSchema } from '@reticlehq/core';
-/**
- * What the report SAYS, kept away from how it looks.
- *
- * The wording here is the product's only claim about its own worth, so it is written once, in one
- * place, and tested. Two audiences, two registers:
- *
- *  - The REPORT is private. It is the user's own data, so it can carry everything, estimates
- *    included, as long as each estimate shows what it is measured against.
- *  - The SHARE card is public, and the research on developer stat-cards is blunt about what happens
- *    to a public card that leads with vendor savings: estimated token/time savings are the most
- *    mocked class of number in AI tooling (JetBrains measured ~10% against a viral 65% claim), and
- *    percentiles without a denominator get called misleading. So the card leads with what the
- *    user's own setup CAUGHT, and publishes its unknowns - the credibility move, and the thing a
- *    scoreboard would never do.
- */
-/** Reticle's own links, as they appear in the report footer. */
-export const REPORT_LINKS = {
-    DOCS: 'https://docs.reticle.sh',
-    SITE: 'https://reticle.sh',
-    GITHUB: 'https://github.com/reticlehq/reticle',
-    DISCORD: 'https://discord.gg/BwAbzv9ZRz',
-};
-/**
- * The X handle used for `via=` on a share.
- *
- * Empty until somebody who owns the account fills it in, and the share URL omits the parameter
- * while it is - a guessed handle credits a stranger, and there is no way for code to know.
- */
-export const SHARE_VIA_HANDLE = '';
-export const REPORT_TEXT = {
-    TITLE: 'Impact',
-    PROJECT: 'This project',
-    GLOBAL: 'Everything on this machine',
-    /**
-     * What `counts.failed` actually is: a verdict whose declared consequence did not hold.
-     *
-     * It used to read "defects caught before you saw them", which overclaims in the one direction a
-     * verification tool must never overclaim. A failed verdict is not proof of a defect in the app —
-     * it is equally the shape of an assertion that was wrong. Measured in the field: an agent
-     * asserted a clean console on an app with ordinary dev-mode logging, the verdict went red, and
-     * the panel reported a defect nobody had found.
-     *
-     * The honest word is what Reticle DID: it refused to pass them. That is true of the assertion
-     * error and the real bug alike, and it still reads as the tool having done its job.
-     */
-    HERO_DEFECTS: 'checks Reticle refused to pass',
-    VERDICTS: 'Verdicts',
-    PASSED: 'passed',
-    FAILED: 'failed',
-    UNKNOWN: 'unknown',
-    UNKNOWN_HELP: 'Reticle drove the app and could not tell what happened. Not a pass - shown, not hidden.',
-    CALLS: 'Tool calls',
-    TOKENS: 'Tokens returned',
-    DRIVING: 'Time driving',
-    SESSIONS: 'Sessions',
-    STREAK: 'day streak',
-    LONGEST: 'Longest run',
-    SAVED_TOKENS: 'Tokens saved',
-    SAVED_MINUTES: 'Time saved',
-    ESTIMATE_TAG: 'estimate',
-    CHART: 'Verdicts, last 30 days',
-    DEFECTS: 'What broke',
-    DEFECTS_MORE: 'Manage all of them on the dashboard',
-    /**
-     * What an UNLINKED user is told, and the only place the product tells them.
-     *
-     * The dashboard link renders only when `dashboardUrl` exists, which means only once a repo is
-     * already linked — so the person most likely to want one, watching this record climb on their own
-     * machine, was never told it existed. The single mention anywhere else is a daemon log line.
-     *
-     * Stated as a FACT about where the record lives, not as a pitch. It sits at the foot of a panel
-     * somebody opened on purpose, so it informs rather than interrupts, and it appears only once
-     * there is a verdict worth keeping — an offer to preserve nothing is just an advert.
-     */
-    LOCAL_ONLY: 'This record stops at this machine.',
-    LOCAL_ONLY_ACTION: 'reticle login',
-    LOCAL_ONLY_TAIL: 'keeps it, and lets a team see it.',
-    DEFECTS_NONE: 'Nothing has failed a declared consequence yet.',
-    EMPTY: 'Nothing recorded yet. Drive the app once and this fills in.',
-    SHARE: 'Share',
-    COPY: 'Copy',
-    COPIED: 'Copied',
-    REFER: 'Send to a friend',
-};
-/** "4.2k", "1.3M" - a number a person reads at a glance rather than counts digits in. */
-export function compactNumber(n) {
-    if (n < 1000)
-        return String(Math.round(n));
-    if (n < 1_000_000)
-        return `${trim(n / 1000)}k`;
-    return `${trim(n / 1_000_000)}M`;
-}
-function trim(n) {
-    return n >= 10 ? String(Math.round(n)) : String(Math.round(n * 10) / 10);
-}
-/** "2h 14m", "47m", "38s" - the same duration vocabulary the activity strip uses. */
-export function compactDuration(ms) {
-    const s = Math.floor(ms / 1000);
-    if (s < 60)
-        return `${String(s)}s`;
-    const m = Math.floor(s / 60);
-    if (m < 60)
-        return `${String(m)}m`;
-    const h = Math.floor(m / 60);
-    return 0 === m % 60 ? `${String(h)}h` : `${String(h)}h ${String(m % 60)}m`;
-}
-/**
- * The post itself.
- *
- * Leads with defects caught, then the verdict split INCLUDING unknowns, then the superlative. No
- * estimated savings, no percentile, no leaderboard: those are the four things the evidence says get
- * a dev-tool card mocked rather than shared.
- */
-export function buildShareText(scope, projectName) {
-    const c = scope.counts;
-    const where = projectName !== undefined && projectName.length > 0 ? ` on ${projectName}` : '';
-    const lines = [
-        `My agent verified its own work ${String(c.verdicts)} times${where}.`,
-        `${String(c.failed)} checks it refused to pass before I looked at any of them.`,
-    ];
-    if (c.unknown > 0) {
-        lines.push(`${String(c.unknown)} came back "unknown" - it drove the app and could not tell. That is the number I watch.`);
-    }
-    if (scope.records.longestRunMs > 0) {
-        lines.push(`Longest unattended run: ${compactDuration(scope.records.longestRunMs)}.`);
-    }
-    return lines.join('\n');
-}
-/** X share intent. `via` is omitted while no handle is configured. */
-export function buildXShareUrl(text) {
-    const params = new URLSearchParams({ text, url: REPORT_LINKS.SITE });
-    if (SHARE_VIA_HANDLE.length > 0)
-        params.set('via', SHARE_VIA_HANDLE);
-    return `https://twitter.com/intent/tweet?${params.toString()}`;
-}
-/**
- * LinkedIn share.
- *
- * `share-offsite` takes a url and NOTHING else - the title/summary parameters were deprecated in
- * 2018 and are ignored, so the caption has to reach the composer some other way. The report copies
- * it to the clipboard before opening this, which is the only path that works without asking the
- * user for posting permissions.
- */
-export function buildLinkedInShareUrl() {
-    return `https://www.linkedin.com/sharing/share-offsite/?url=${encodeURIComponent(REPORT_LINKS.SITE)}`;
-}
-/** What a referral says: the tool, not the sender's numbers. */
-export function buildReferralText() {
-    return `I have been verifying my agent's work from inside the running app with Reticle - it returns pass/fail with the file:line to fix. ${REPORT_LINKS.SITE}`;
-}
-/** Narrow an unknown push payload to a snapshot. Invalid shapes are ignored, never rendered. */
-export function parseImpactSnapshot(value) {
-    const parsed = ImpactSnapshotSchema.safeParse(value);
-    return parsed.success ? parsed.data : undefined;
-}

package/dist/presenter/presenter-test-helpers.d.ts

@@ -1,16 +0,0 @@
-/** Shared fixtures for the presenter test suites (presenter.test.ts + presenter-lifecycle.test.ts). */
-export declare const FAST_IDLE_MS = 20;
-export declare const FAST_FADE_MS = 5;
-export declare const flush: () => Promise<void>;
-export declare const wait: (ms: number) => Promise<void>;
-/** Poll a predicate until true or timeout - robust to real-timer lateness under load (no flake). */
-export declare const until: (pred: () => boolean, ms?: number) => Promise<boolean>;
-export declare const dataOn: () => string | null;
-export declare const dataBusy: () => string | null;
-interface GlowFlips {
-    enters: number;
-    exits: number;
-    stop: () => void;
-}
-export declare function trackGlowFlips(glow: HTMLElement): GlowFlips;
-export {};

package/dist/presenter/presenter-test-helpers.js

@@ -1,41 +0,0 @@
-/** Shared fixtures for the presenter test suites (presenter.test.ts + presenter-lifecycle.test.ts). */
-export const FAST_IDLE_MS = 20;
-export const FAST_FADE_MS = 5;
-export const flush = () => new Promise((r) => setTimeout(r, 0));
-export const wait = (ms) => new Promise((r) => setTimeout(r, ms));
-/** Poll a predicate until true or timeout - robust to real-timer lateness under load (no flake). */
-export const until = async (pred, ms = 1000) => {
-    const t0 = Date.now();
-    while (!pred()) {
-        if (Date.now() - t0 > ms)
-            return false;
-        await wait(5);
-    }
-    return true;
-};
-export const dataOn = () => document.querySelector('[data-reticle-glow]')?.getAttribute('data-on') ?? null;
-export const dataBusy = () => document.querySelector('[data-reticle-glow]')?.getAttribute('data-busy') ?? null;
-export function trackGlowFlips(glow) {
-    const counts = { enters: 0, exits: 0 };
-    const obs = new MutationObserver((recs) => {
-        for (const r of recs) {
-            if (r.attributeName !== 'data-on')
-                continue;
-            const v = glow.getAttribute('data-on');
-            if ('1' === v)
-                counts.enters++;
-            if ('0' === v)
-                counts.exits++;
-        }
-    });
-    obs.observe(glow, { attributes: true, attributeFilter: ['data-on'] });
-    return {
-        get enters() {
-            return counts.enters;
-        },
-        get exits() {
-            return counts.exits;
-        },
-        stop: () => obs.disconnect(),
-    };
-}

package/dist/timers/native-console.js

@@ -1,9 +0,0 @@
-// Native console.warn captured at module load, BEFORE installConsole patches console.
-// SDK-internal diagnostics (transport failures, unreachable-bridge, store registration warnings)
-// MUST use this instead of bare `console.warn` — otherwise they emit spurious CONSOLE_WARN
-// events to the agent, polluting the observation stream with SDK internals.
-const g = globalThis;
-const realWarn = 'function' === typeof g.console?.warn ? g.console.warn.bind(g.console) : null;
-export const nativeWarn = (...args) => {
-    realWarn?.(...args);
-};

package/dist/timers/native-timers.d.ts

@@ -1,36 +0,0 @@
-/**
- * Monotonic "now" bound at load. clock.ts deliberately does NOT patch performance.now, so this
- * stays live even when the app clock (reticle_clock) is frozen — the presenter state machine relies
- * on it. Falls back to 0 in SSR where performance is absent.
- */
-export declare const nativeNow: () => number;
-export declare const nativeSetTimeout: (cb: () => void, ms?: number) => number;
-export declare const nativeClearTimeout: (id: number) => void;
-/**
- * A self-rescheduling interval built on the bound real timer. We do NOT use
- * `setInterval` because reticle_clock can freeze the app's timers — a native, pre-bound
- * timer keeps the page-health heartbeat ticking so a frozen clock never reads as stale.
- * Returns a stop function.
- */
-export declare const nativeSetInterval: (cb: () => void, ms: number) => (() => void);
-/** Outcome of a bounded frame/settle wait. */
-interface FrameOutcome {
-    /** true = a real rAF fired within budget; false = the timeout fallback fired. */
-    settled: boolean;
-}
-/**
- * One animation frame, BOUNDED: races real rAF against a nativeSetTimeout(FRAME_BUDGET_MS).
- * In a throttled/background tab rAF never fires, so the timer wins and we still resolve.
- * Returns whether rAF won (settled:true) or the fallback fired (settled:false).
- */
-export declare const boundedFrame: (budgetMs?: number) => Promise<FrameOutcome>;
-/** One animation frame, BOUNDED — delegates to boundedFrame so it never hangs in a throttled tab. */
-export declare const nativeFrame: () => Promise<void>;
-/**
- * "Settle": let the framework flush. Awaits a microtask then one BOUNDED animation frame so a
- * React commit (and the MutationObserver records it triggers) lands before the caller returns.
- * Uses native timers/rAF so a frozen app clock (reticle_clock) never stalls it, AND is bounded so a
- * throttled/background tab (rAF never fires) never deadlocks. Reports whether a real frame fired.
- */
-export declare const settle: (budgetMs?: number) => Promise<FrameOutcome>;
-export {};

package/dist/timers/native-timers.js

@@ -1,78 +0,0 @@
-// Native timers captured (bound) at module load, BEFORE any fake-clock patch. The SDK uses
-// these for its own internal waits (presenter pacing, hover dwell, transport reconnect) so
-// that freezing the app's clock (reticle_clock) never deadlocks Reticle itself.
-//
-// Important: we bind the reference now. Resolving `setTimeout` at call time would pick up the
-// patched (frozen) timer once reticle_clock freezes the clock — which would hang the SDK.
-const g = globalThis;
-const realSetTimeout = 'function' === typeof g.setTimeout ? g.setTimeout.bind(g) : null;
-const realClearTimeout = 'function' === typeof g.clearTimeout ? g.clearTimeout.bind(g) : null;
-const realRaf = 'function' === typeof g.requestAnimationFrame ? g.requestAnimationFrame.bind(g) : null;
-const realPerfNow = 'function' === typeof g.performance?.now ? g.performance.now.bind(g.performance) : null;
-/**
- * Monotonic "now" bound at load. clock.ts deliberately does NOT patch performance.now, so this
- * stays live even when the app clock (reticle_clock) is frozen — the presenter state machine relies
- * on it. Falls back to 0 in SSR where performance is absent.
- */
-export const nativeNow = () => (realPerfNow ? realPerfNow() : 0);
-export const nativeSetTimeout = (cb, ms = 0) => realSetTimeout ? realSetTimeout(cb, ms) : 0;
-export const nativeClearTimeout = (id) => {
-    realClearTimeout?.(id);
-};
-/**
- * A self-rescheduling interval built on the bound real timer. We do NOT use
- * `setInterval` because reticle_clock can freeze the app's timers — a native, pre-bound
- * timer keeps the page-health heartbeat ticking so a frozen clock never reads as stale.
- * Returns a stop function.
- */
-export const nativeSetInterval = (cb, ms) => {
-    let stopped = false;
-    let id = 0;
-    const tick = () => {
-        if (stopped)
-            return;
-        cb();
-        if (stopped)
-            return;
-        id = nativeSetTimeout(tick, ms);
-    };
-    id = nativeSetTimeout(tick, ms);
-    return () => {
-        stopped = true;
-        nativeClearTimeout(id);
-    };
-};
-/** Max time we wait for a real animation frame before giving up and resolving anyway. */
-const FRAME_BUDGET_MS = 200;
-/**
- * One animation frame, BOUNDED: races real rAF against a nativeSetTimeout(FRAME_BUDGET_MS).
- * In a throttled/background tab rAF never fires, so the timer wins and we still resolve.
- * Returns whether rAF won (settled:true) or the fallback fired (settled:false).
- */
-export const boundedFrame = (budgetMs = FRAME_BUDGET_MS) => new Promise((resolve) => {
-    let done = false;
-    const finish = (settled) => {
-        if (done)
-            return;
-        done = true;
-        nativeClearTimeout(timer);
-        resolve({ settled });
-    };
-    const timer = nativeSetTimeout(() => finish(false), budgetMs);
-    if (realRaf)
-        realRaf(() => finish(true));
-    else
-        nativeSetTimeout(() => finish(true), 0); // jsdom/SSR: 0ms timer "is" the frame
-});
-/** One animation frame, BOUNDED — delegates to boundedFrame so it never hangs in a throttled tab. */
-export const nativeFrame = () => boundedFrame().then(() => undefined);
-/**
- * "Settle": let the framework flush. Awaits a microtask then one BOUNDED animation frame so a
- * React commit (and the MutationObserver records it triggers) lands before the caller returns.
- * Uses native timers/rAF so a frozen app clock (reticle_clock) never stalls it, AND is bounded so a
- * throttled/background tab (rAF never fires) never deadlocks. Reports whether a real frame fired.
- */
-export const settle = async (budgetMs = FRAME_BUDGET_MS) => {
-    await Promise.resolve(); // drain the current microtask queue (React scheduler tick)
-    return boundedFrame(budgetMs); // one bounded frame so commit + MutationObserver records flush
-};