@reticlehq/browser 2.2.0 → 2.3.0

package/dist/observers/scroll.js

@@ -66,4 +66,3 @@ export function installScroll(emit) {
         io?.disconnect();
     };
 }
-//# sourceMappingURL=scroll.js.map

package/dist/observers/sdk-failure.d.ts

@@ -0,0 +1,28 @@
+import type { Emit } from './types.js';
+/**
+ * Where in the SDK a failure happened. A fixed vocabulary of OUR module names — never a file path,
+ * never anything derived from the user's app — so the field stays low-cardinality and non-identifying
+ * while still telling a maintainer which subsystem to open.
+ */
+export declare const SdkSite: {
+    readonly CONNECT: "connect";
+    readonly DOM_OBSERVER: "dom_observer";
+    readonly NETWORK_OBSERVER: "network_observer";
+    readonly CONSOLE_OBSERVER: "console_observer";
+    readonly IPC_OBSERVER: "ipc_observer";
+    readonly HEALTH_OBSERVER: "health_observer";
+    readonly ROUTER_OBSERVER: "router_observer";
+    readonly ANIMATION_OBSERVER: "animation_observer";
+    readonly STORE_ADAPTER: "store_adapter";
+    readonly SNAPSHOT: "snapshot";
+    readonly ACTION: "action";
+    readonly COMMAND: "command";
+    readonly RECORDER: "recorder";
+    readonly TRANSPORT: "transport";
+};
+export type SdkSite = (typeof SdkSite)[keyof typeof SdkSite];
+/**
+ * Report that a piece of the SDK failed. Never throws, and never prevents the caller from doing what
+ * it was going to do anyway (which is almost always: carry on degraded).
+ */
+export declare function reportSdkFailure(emit: Emit, site: SdkSite, error: unknown): void;

package/dist/observers/sdk-failure.js

@@ -0,0 +1,60 @@
+/**
+ * The SDK reporting its OWN failures.
+ *
+ * Half of Reticle runs inside the page, and that half was completely silent. Every `catch` in the SDK
+ * swallows by design — correctly, because an instrumentation layer must never break the app it
+ * observes — but the consequence was that an observer throwing on page load just produced a quieter
+ * product. No error, no signal, no way to know. A user would report "Reticle doesn't see my network
+ * calls" and there would be nothing on our side to look at.
+ *
+ * Two properties make this safe to add:
+ *
+ *   1. IT MAKES NO NETWORK REQUEST. The report rides the bridge WebSocket the SDK is already connected
+ *      to — localhost, the same channel every other event uses. The published promise that the SDK
+ *      talks only to a local bridge stays exactly true, and the daemon decides what (if anything) goes
+ *      anywhere else. Adding an outbound call from inside someone's app would have been a different
+ *      product with a different privacy posture.
+ *   2. IT CANNOT BREAK THE APP. Reporting is wrapped in its own try/catch and is strictly additive to
+ *      an existing `catch` block. A failure to report a failure is discarded.
+ */
+import { EventType } from '@reticlehq/core';
+/**
+ * Where in the SDK a failure happened. A fixed vocabulary of OUR module names — never a file path,
+ * never anything derived from the user's app — so the field stays low-cardinality and non-identifying
+ * while still telling a maintainer which subsystem to open.
+ */
+export const SdkSite = {
+    CONNECT: 'connect',
+    DOM_OBSERVER: 'dom_observer',
+    NETWORK_OBSERVER: 'network_observer',
+    CONSOLE_OBSERVER: 'console_observer',
+    IPC_OBSERVER: 'ipc_observer',
+    HEALTH_OBSERVER: 'health_observer',
+    ROUTER_OBSERVER: 'router_observer',
+    ANIMATION_OBSERVER: 'animation_observer',
+    STORE_ADAPTER: 'store_adapter',
+    SNAPSHOT: 'snapshot',
+    ACTION: 'action',
+    COMMAND: 'command',
+    RECORDER: 'recorder',
+    TRANSPORT: 'transport',
+};
+/** Cap the message here too — the server strips variables, but an unbounded string is a bad idea twice. */
+const MAX_MESSAGE = 500;
+/**
+ * Report that a piece of the SDK failed. Never throws, and never prevents the caller from doing what
+ * it was going to do anyway (which is almost always: carry on degraded).
+ */
+export function reportSdkFailure(emit, site, error) {
+    try {
+        const message = error instanceof Error ? error.message : String(error);
+        emit(EventType.SDK_FAILED, {
+            site,
+            message: message.slice(0, MAX_MESSAGE),
+            ...(error instanceof Error ? { errorType: error.constructor.name.slice(0, 64) } : {}),
+        });
+    }
+    catch {
+        /* a failure report must never become a second failure */
+    }
+}

package/dist/observers/state.d.ts

@@ -17,4 +17,3 @@ export declare function diffState(prev: unknown, next: unknown): StateChange[];
  */
 export declare function installStoreState(emit: Emit): Teardown;
 export {};
-//# sourceMappingURL=state.d.ts.map

package/dist/observers/state.js

@@ -84,4 +84,3 @@ export function installStoreState(emit) {
         active.clear();
     };
 }
-//# sourceMappingURL=state.js.map

package/dist/observers/storage.d.ts

@@ -20,4 +20,3 @@ export declare function readStorage(area?: string): StorageSnapshot | Record<str
  * method access) and re-dispatched via `.call(this)`. Fully reversible; values redacted like the reads.
  */
 export declare function installStorage(emit: Emit): Teardown;
-//# sourceMappingURL=storage.d.ts.map

package/dist/observers/storage.js

@@ -174,4 +174,3 @@ export function installStorage(emit) {
             proto.clear = origClear;
     };
 }
-//# sourceMappingURL=storage.js.map

package/dist/observers/types.d.ts

@@ -18,4 +18,3 @@ export type Teardown = () => void;
 export declare function observeSafely(observation: () => void): void;
 /** Like observeSafely, but for reading a value the observation needs; undefined if the read throws. */
 export declare function observeValue<T>(read: () => T): T | undefined;
-//# sourceMappingURL=types.d.ts.map

package/dist/observers/types.js

@@ -27,4 +27,3 @@ export function observeValue(read) {
         return undefined;
     }
 }
-//# sourceMappingURL=types.js.map

package/dist/patching/capture-method.d.ts

@@ -24,4 +24,3 @@ export declare function captureMethod<T, K extends keyof T>(target: T, key: K):
  * `set` is an unbound function, and naming that intention once beats disabling the rule at each use.
  */
 export declare function captureValueSetter(proto: object): ((this: HTMLElement, value: string) => void) | undefined;
-//# sourceMappingURL=capture-method.d.ts.map

package/dist/patching/capture-method.js

@@ -34,4 +34,3 @@ export function captureValueSetter(proto) {
     const setter = captureMethod(descriptor, 'set');
     return setter;
 }
-//# sourceMappingURL=capture-method.js.map

package/dist/presenter/overlay.d.ts

@@ -9,4 +9,3 @@ export interface OverlayHandle {
 /** A tiny in-page status chip: connection + event count. Off by default. */
 export declare function installOverlay(): OverlayHandle;
 export {};
-//# sourceMappingURL=overlay.d.ts.map

package/dist/presenter/overlay.js

@@ -28,4 +28,3 @@ export function installOverlay() {
         },
     };
 }
-//# sourceMappingURL=overlay.js.map

package/dist/presenter/presenter-config.d.ts

@@ -83,4 +83,3 @@ export declare const DATA_ON = "data-on";
 /** Overlay-root attribute toggled when the panel is minimised to a bar. */
 export declare const MIN_ATTR = "data-reticle-min";
 export declare const THROTTLED_ATTR = "data-reticle-throttled";
-//# sourceMappingURL=presenter-config.d.ts.map

package/dist/presenter/presenter-config.js

@@ -48,4 +48,3 @@ export const DATA_ON = 'data-on';
 /** Overlay-root attribute toggled when the panel is minimised to a bar. */
 export const MIN_ATTR = 'data-reticle-min';
 export const THROTTLED_ATTR = 'data-reticle-throttled';
-//# sourceMappingURL=presenter-config.js.map

package/dist/presenter/presenter-controls.d.ts

@@ -71,4 +71,3 @@ export declare class ControlPanel {
     setState(state: SessionState, text?: string, tone?: PresenterTone): void;
 }
 export { DATA_RETICLE_STATE };
-//# sourceMappingURL=presenter-controls.d.ts.map

package/dist/presenter/presenter-controls.js

@@ -365,4 +365,3 @@ export class ControlPanel {
     }
 }
 export { DATA_RETICLE_STATE };
-//# sourceMappingURL=presenter-controls.js.map

package/dist/presenter/presenter-effects.d.ts

@@ -11,4 +11,3 @@ export declare function ringAround(ring: HTMLElement | undefined, rect: DOMRect)
 export declare function spawnRipple(root: HTMLElement | undefined, x: number, y: number): void;
 /** Pace for the human so an action is watchable, not instant. */
 export declare function pace(ms: number): Promise<void>;
-//# sourceMappingURL=presenter-effects.d.ts.map

package/dist/presenter/presenter-effects.js

@@ -37,4 +37,3 @@ export function spawnRipple(root, x, y) {
 export function pace(ms) {
     return new Promise((res) => nativeSetTimeout(res, ms));
 }
-//# sourceMappingURL=presenter-effects.js.map

package/dist/presenter/presenter-glow.d.ts

@@ -40,4 +40,3 @@ export declare class GlowController {
     teardown(): void;
 }
 export {};
-//# sourceMappingURL=presenter-glow.d.ts.map

package/dist/presenter/presenter-glow.js

@@ -123,4 +123,3 @@ export class GlowController {
         }, this.#glowFadeMs);
     }
 }
-//# sourceMappingURL=presenter-glow.js.map

package/dist/presenter/presenter-log.d.ts

@@ -40,4 +40,3 @@ export declare function formatElapsed(ms: number): string;
  * Uses createElement/textContent (never innerHTML) so arbitrary narration text can't inject markup.
  */
 export declare function appendLogRow(container: HTMLElement, kind: LogKind, text: string, ts: string, logMax: number): LogHandle;
-//# sourceMappingURL=presenter-log.d.ts.map

package/dist/presenter/presenter-log.js

@@ -115,4 +115,3 @@ export function appendLogRow(container, kind, text, ts, logMax) {
         },
     };
 }
-//# sourceMappingURL=presenter-log.js.map

package/dist/presenter/presenter-run-state.d.ts

@@ -45,4 +45,3 @@ interface RunStateInput {
  */
 export declare function buildRunState(input: RunStateInput): PresenterRunState;
 export {};
-//# sourceMappingURL=presenter-run-state.d.ts.map

package/dist/presenter/presenter-run-state.js

@@ -34,4 +34,3 @@ export function buildRunState(input) {
         log: input.runLog.map((e) => ({ ...e })),
     };
 }
-//# sourceMappingURL=presenter-run-state.js.map

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

@@ -4,4 +4,3 @@
  * pure style data (no behavior). LOG_CSS + CONTROLS_CSS are composed in at the end as before.
  */
 export declare const PRESENTER_CSS = "\n[data-reticle-glow]{position:fixed;inset:0;pointer-events:none;z-index:2147483600;opacity:0;\n  transition:opacity .25s ease;box-shadow:inset 0 0 0 3px rgba(99,102,241,.9),inset 0 0 28px 6px rgba(99,102,241,.45);}\n[data-reticle-glow][data-on=\"1\"]{opacity:1;animation:reticle-pulse 1.6s ease-in-out infinite;}\n[data-reticle-glow][data-on=\"1\"][data-busy=\"1\"]{animation:reticle-shimmer 1.1s ease-in-out infinite;}\n@keyframes reticle-pulse{0%,100%{box-shadow:inset 0 0 0 3px rgba(99,102,241,.9),inset 0 0 22px 4px rgba(99,102,241,.35)}\n  50%{box-shadow:inset 0 0 0 3px rgba(124,127,242,1),inset 0 0 40px 10px rgba(99,102,241,.6)}}\n@keyframes reticle-shimmer{0%,100%{box-shadow:inset 0 0 0 3px rgba(124,127,242,1),inset 0 0 34px 8px rgba(99,102,241,.55)}\n  50%{box-shadow:inset 0 0 0 3px rgba(140,142,255,1),inset 0 0 48px 12px rgba(99,102,241,.7)}}\n[data-reticle-cursor]{position:fixed;top:0;left:0;width:22px;height:22px;margin:-11px 0 0 -11px;\n  border:2px solid #6366f1;border-radius:50%;background:rgba(99,102,241,.25);pointer-events:none;\n  z-index:2147483646;opacity:0;transition:transform .32s cubic-bezier(.22,1,.36,1),opacity .2s ease;}\n[data-reticle-cursor][data-on=\"1\"]{opacity:1;}\n[data-reticle-cursor]::after{content:\"\";position:absolute;inset:7px;border-radius:50%;background:#6366f1;}\n[data-reticle-ripple]{position:fixed;width:14px;height:14px;margin:-7px 0 0 -7px;border-radius:50%;\n  background:rgba(99,102,241,.5);pointer-events:none;z-index:2147483645;animation:reticle-ripple .5s ease-out forwards;}\n@keyframes reticle-ripple{from{transform:scale(.4);opacity:.8}to{transform:scale(5);opacity:0}}\n[data-reticle-ring]{position:fixed;pointer-events:none;z-index:2147483644;border:2px solid #22c55e;border-radius:8px;\n  box-shadow:0 0 0 3px rgba(34,197,94,.25);opacity:0;transition:opacity .15s ease;}\n[data-reticle-ring][data-on=\"1\"]{opacity:1;}\n[data-reticle-hud]{\n  --reticle-accent:#7c83ff;--reticle-accent-soft:rgba(124,131,255,.16);\n  --reticle-bg:rgba(13,15,22,.92);--reticle-bg2:rgba(19,22,32,.88);\n  --reticle-fg:#e9ebf2;--reticle-muted:#9aa0b2;--reticle-faint:#6a7186;\n  --reticle-line:rgba(255,255,255,.09);--reticle-line2:rgba(255,255,255,.05);\n  --reticle-read:#54d2e6;--reticle-ok:#3dd7a6;--reticle-bad:#ff7a7a;\n  --reticle-font:\"Inter\",system-ui,-apple-system,\"Segoe UI\",Roboto,\"Helvetica Neue\",Arial,sans-serif;\n  --reticle-serif:\"IBM Plex Serif\",Georgia,\"Times New Roman\",serif;\n  position:fixed;left:50%;right:auto;bottom:20px;box-sizing:border-box;\n  width:384px;height:468px;max-width:calc(100vw - 32px);max-height:calc(100vh - 32px);\n  display:flex;flex-direction:column;overflow:hidden;text-align:left;z-index:2147483647;pointer-events:none;\n  font-family:var(--reticle-font);font-size:13px;line-height:1.5;color:var(--reticle-fg);-webkit-font-smoothing:antialiased;\n  background:linear-gradient(180deg,var(--reticle-bg),var(--reticle-bg2));\n  /* No backdrop-filter here, deliberately. blur(24px) on this panel was measured as the single most\n     expensive thing the whole SDK does: a backdrop blur must re-sample everything behind it whenever\n     that content changes, and on a page repainting at 60fps that is continuous full-panel work. On\n     the hostile fixture it cost +4.0pp of main thread \u2014 five times the rest of the presenter, and\n     more than every observer combined. Removing it took total main-thread time from 2.15s to 1.67s\n     over an 8s window. The panel background is ~85% opaque, so the glass effect it bought was\n     marginal. If you want it back, add it here and expect to pay that. */\n  border:1px solid var(--reticle-line);border-radius:20px;\n  box-shadow:0 28px 70px -18px rgba(0,0,0,.66),0 0 0 1px rgba(0,0,0,.35),inset 0 1px 0 rgba(255,255,255,.07),0 0 54px -22px var(--reticle-accent);\n  opacity:0;transform:translateX(-50%) translateY(14px) scale(.985);\n  transition:opacity .3s ease,transform .42s cubic-bezier(.16,1,.3,1),height .42s cubic-bezier(.16,1,.3,1),border-radius .42s ease,box-shadow .35s ease;}\n[data-reticle-overlay][data-reticle-state=\"paused\"] [data-reticle-hud]{--reticle-accent:#f6b44c;--reticle-accent-soft:rgba(246,180,76,.16);}\n[data-reticle-overlay][data-reticle-state=\"ended\"] [data-reticle-hud]{--reticle-accent:#3dd7a6;--reticle-accent-soft:rgba(61,215,166,.14);}\n[data-reticle-hud]::before{content:\"\";position:absolute;inset:0;border-radius:inherit;pointer-events:none;\n  background:radial-gradient(130% 90% at 50% 0%,var(--reticle-accent-soft),transparent 60%);}\n[data-reticle-hud]>*{position:relative;}\n[data-reticle-hud][data-on=\"1\"]{opacity:1;transform:translateX(-50%) translateY(0) scale(1);}\n/* Click-through: the glassy panel itself never blocks the app \u2014 only its interactive controls\n   capture clicks (buttons / inputs), so a human can click straight through the HUD to the page.\n   The log auto-scrolls, so it stays click-through too (drag-scroll is traded for click-through). */\n[data-reticle-hud] button,[data-reticle-hud] input,[data-reticle-hud] textarea,\n[data-reticle-hud] select,[data-reticle-hud] [contenteditable]{pointer-events:auto;}\n/* When minimised to a pill, the whole bar is the (single) click target to restore. */\n[data-reticle-overlay][data-reticle-min=\"1\"] [data-reticle-hud][data-on=\"1\"]{pointer-events:auto;}\n[data-reticle-hud] .reticle-hud-head{display:flex;align-items:center;gap:8px;flex:none;\n  padding:12px 12px 12px 15px;border-bottom:1px solid var(--reticle-line2);}\n[data-reticle-hud] .reticle-dot{width:9px;height:9px;border-radius:50%;flex:none;background:var(--reticle-accent);\n  animation:reticle-breathe 2.6s ease-in-out infinite;}\n@keyframes reticle-breathe{0%,100%{box-shadow:0 0 0 0 var(--reticle-accent),0 0 7px 1px var(--reticle-accent);opacity:.85}\n  50%{box-shadow:0 0 0 4px var(--reticle-accent-soft),0 0 15px 3px var(--reticle-accent);opacity:1}}\n[data-reticle-hud] .reticle-brand{font-family:var(--reticle-serif);font-weight:500;font-size:15px;letter-spacing:.01em;color:var(--reticle-fg);}\n[data-reticle-hud] .reticle-head-sp{flex:1;}\n[data-reticle-hud] .reticle-live{display:none;flex:1;min-width:0;color:var(--reticle-muted);font-size:12.5px;\n  white-space:nowrap;overflow:hidden;text-overflow:ellipsis;}\n[data-reticle-hud] .reticle-maxhint{display:none;flex:none;color:var(--reticle-faint);font-size:13px;line-height:1;}\n[data-reticle-hud] .reticle-act-strip{flex:none;padding:7px 15px;border-bottom:1px solid var(--reticle-line2);background:rgba(0,0,0,.14);}\n[data-reticle-hud] .reticle-act{display:block;color:var(--reticle-muted);font-size:11.5px;\n  white-space:nowrap;overflow:hidden;text-overflow:ellipsis;}\n[data-reticle-hud] [data-reticle-min-btn]{flex:none;cursor:pointer;display:inline-flex;align-items:center;justify-content:center;\n  width:26px;height:26px;border-radius:8px;border:1px solid var(--reticle-line);background:rgba(255,255,255,.04);\n  color:var(--reticle-muted);font-size:15px;line-height:1;transition:background .15s,color .15s,transform .1s;}\n[data-reticle-hud] [data-reticle-min-btn]:hover{color:var(--reticle-fg);background:rgba(255,255,255,.08);}\n[data-reticle-hud] [data-reticle-min-btn]:active{transform:scale(.94);}\n[data-reticle-hud] .reticle-pass{color:var(--reticle-ok);}[data-reticle-hud] .reticle-fail{color:var(--reticle-bad);}\n[data-reticle-hud] .reticle-tally{flex:none;display:inline-flex;align-items:center;gap:8px;font-size:11.5px;\n  font-weight:600;font-variant-numeric:tabular-nums;letter-spacing:.01em;}\n[data-reticle-hud] .reticle-tally[hidden]{display:none;}\n[data-reticle-hud] .reticle-tally .reticle-t-pass{color:var(--reticle-ok);}\n[data-reticle-hud] .reticle-tally .reticle-t-fail{color:var(--reticle-bad);}\n[data-reticle-hud] .reticle-tally [data-z=\"1\"]{opacity:.4;}\n@keyframes reticle-tally-pop{0%{transform:scale(1)}38%{transform:scale(1.3)}100%{transform:scale(1)}}\n[data-reticle-hud] .reticle-tally [data-bump=\"1\"]{display:inline-block;animation:reticle-tally-pop .36s cubic-bezier(.16,1,.3,1);}\n[data-reticle-hud] .reticle-chip{display:none;flex:none;font-size:9px;font-weight:600;letter-spacing:.08em;\n  padding:2px 7px;border-radius:6px;vertical-align:middle;}\n[data-reticle-hud] .reticle-chip[data-mode=\"reading\"]{display:inline-block;color:var(--reticle-read);\n  background:rgba(84,210,230,.12);border:1px solid rgba(84,210,230,.32);}\n[data-reticle-hud] .reticle-chip[data-mode=\"acting\"]{display:inline-block;color:var(--reticle-accent);\n  background:var(--reticle-accent-soft);border:1px solid var(--reticle-accent);}\n[data-reticle-hud] .reticle-chip[data-mode=\"idle\"]{display:none;}\n[data-reticle-overlay][data-reticle-min=\"1\"] [data-reticle-hud]{height:50px;border-radius:25px;cursor:pointer;}\n[data-reticle-overlay][data-reticle-min=\"1\"] [data-reticle-hud] .reticle-hud-head{border-bottom:none;height:50px;padding:0 12px 0 16px;}\n[data-reticle-overlay][data-reticle-min=\"1\"] [data-reticle-hud] .reticle-brand,\n[data-reticle-overlay][data-reticle-min=\"1\"] [data-reticle-hud] .reticle-chip,\n[data-reticle-overlay][data-reticle-min=\"1\"] [data-reticle-hud] .reticle-head-sp,\n[data-reticle-overlay][data-reticle-min=\"1\"] [data-reticle-hud] [data-reticle-min-btn],\n[data-reticle-overlay][data-reticle-min=\"1\"] [data-reticle-hud] .reticle-ctl,\n[data-reticle-overlay][data-reticle-min=\"1\"] [data-reticle-hud] .reticle-badge,\n[data-reticle-overlay][data-reticle-min=\"1\"] [data-reticle-hud] .reticle-act-strip,\n[data-reticle-overlay][data-reticle-min=\"1\"] [data-reticle-hud] [data-reticle-log],\n[data-reticle-overlay][data-reticle-min=\"1\"] [data-reticle-hud] [data-reticle-foot],\n[data-reticle-overlay][data-reticle-min=\"1\"] [data-reticle-hud] .reticle-banner{display:none;}\n[data-reticle-overlay][data-reticle-min=\"1\"] [data-reticle-hud] .reticle-live{display:block;}\n[data-reticle-overlay][data-reticle-min=\"1\"] [data-reticle-hud] .reticle-maxhint{display:inline-flex;}\n[data-reticle-mode=\"reading\"] [data-reticle-glow][data-on=\"1\"]{\n  box-shadow:inset 0 0 0 3px rgba(34,211,238,.9),inset 0 0 28px 6px rgba(34,211,238,.4);}\n[data-reticle-mode=\"reading\"] [data-reticle-ring]{border-color:#22d3ee;\n  box-shadow:0 0 0 3px rgba(34,211,238,.25);}\n[data-reticle-overlay][data-reticle-throttled=\"1\"] [data-reticle-glow][data-on=\"1\"]{\n  box-shadow:inset 0 0 0 3px rgba(251,191,36,.9),inset 0 0 28px 6px rgba(251,191,36,.45);}\n[data-reticle-overlay][data-reticle-throttled=\"1\"] [data-reticle-hud]{--reticle-accent:#fbbf24;--reticle-accent-soft:rgba(251,191,36,.16);}\n\n[data-reticle-log]{flex:1;min-height:0;overflow-y:auto;overscroll-behavior:contain;display:flex;flex-direction:column;\n  gap:7px;padding:12px 14px;scrollbar-width:thin;scrollbar-color:rgba(255,255,255,.16) transparent;}\n[data-reticle-log]::-webkit-scrollbar{width:9px;}\n[data-reticle-log]::-webkit-scrollbar-thumb{background:rgba(255,255,255,.14);border-radius:9px;border:2px solid transparent;background-clip:content-box;}\n[data-reticle-log]::-webkit-scrollbar-thumb:hover{background:rgba(255,255,255,.26);background-clip:content-box;}\n[data-reticle-log-row]{display:flex;align-items:baseline;gap:8px;font-size:12px;line-height:1.45;\n  animation:reticle-row-in .26s cubic-bezier(.16,1,.3,1);}\n@keyframes reticle-row-in{from{opacity:0;transform:translateY(5px);}to{opacity:1;transform:none;}}\n[data-reticle-log-ts]{flex:none;color:var(--reticle-faint);font-size:10px;font-variant-numeric:tabular-nums;padding-top:1px;}\n[data-reticle-log] .reticle-log-text{flex:1;min-width:0;color:#d6dae4;overflow-wrap:anywhere;word-break:break-word;}\n[data-reticle-log] .reticle-res{flex:none;font-weight:700;}\n[data-reticle-log-row][data-kind=\"human\"]{align-self:flex-end;max-width:88%;\n  background:var(--reticle-accent-soft);border:1px solid var(--reticle-accent);border-radius:13px 13px 4px 13px;padding:6px 11px;}\n[data-reticle-log-row][data-kind=\"human\"] [data-reticle-log-ts]{display:none;}\n[data-reticle-log-row][data-kind=\"human\"] .reticle-log-text{color:var(--reticle-fg);}\n\n\n[data-reticle-hud] .reticle-ctl{pointer-events:auto;cursor:pointer;flex:none;display:inline-flex;align-items:center;justify-content:center;\n  height:26px;padding:0 11px;border-radius:8px;border:1px solid var(--reticle-line);background:rgba(255,255,255,.04);\n  color:var(--reticle-muted);font-family:var(--reticle-font);font-size:11px;font-weight:500;letter-spacing:.01em;line-height:1;\n  transition:background .15s,color .15s,border-color .15s,transform .1s;}\n[data-reticle-hud] .reticle-ctl:hover{color:var(--reticle-fg);background:rgba(255,255,255,.09);}\n[data-reticle-hud] .reticle-ctl:active{transform:scale(.95);}\n[data-reticle-hud] .reticle-ctl:disabled{opacity:.35;cursor:default;}\n[data-reticle-hud] [data-reticle-end]{color:#ff9aa2;border-color:rgba(255,107,107,.22);}\n[data-reticle-hud] [data-reticle-end]:hover{color:#ff7a7a;border-color:rgba(255,107,107,.5);background:rgba(255,107,107,.1);}\n[data-reticle-hud] .reticle-badge{display:none;align-items:center;flex:none;font-weight:600;letter-spacing:.1em;font-size:9px;\n  color:var(--reticle-accent);border:1px solid var(--reticle-accent);background:var(--reticle-accent-soft);padding:2px 8px;border-radius:999px;}\n[data-reticle-overlay][data-reticle-state=\"paused\"] [data-reticle-badge]{display:inline-flex;}\n[data-reticle-hud] [data-reticle-foot]{flex:none;padding:10px 12px 12px;border-top:1px solid var(--reticle-line2);background:rgba(0,0,0,.16);}\n[data-reticle-hud] .reticle-composer{display:flex;align-items:flex-end;gap:6px;background:rgba(255,255,255,.05);\n  border:1px solid var(--reticle-line);border-radius:14px;padding:5px 6px 5px 14px;transition:border-color .15s,box-shadow .15s;}\n[data-reticle-hud] .reticle-composer:focus-within{border-color:var(--reticle-accent);box-shadow:0 0 0 3px var(--reticle-accent-soft);}\n[data-reticle-hud] .reticle-msg{flex:1;min-width:0;pointer-events:auto;background:transparent;border:none;outline:none;resize:none;\n  box-sizing:border-box;color:var(--reticle-fg);font-family:var(--reticle-font);font-size:13px;line-height:18px;\n  height:28px;min-height:28px;max-height:96px;padding:5px 0;overflow-y:auto;\n  scrollbar-width:thin;scrollbar-color:rgba(255,255,255,.14) transparent;}\n[data-reticle-hud] .reticle-msg::-webkit-scrollbar{width:9px;}\n[data-reticle-hud] .reticle-msg::-webkit-scrollbar-thumb{background:rgba(255,255,255,.14);border-radius:9px;border:2px solid transparent;background-clip:content-box;}\n[data-reticle-hud] .reticle-msg::placeholder{color:var(--reticle-faint);}\n[data-reticle-hud] .reticle-msg:disabled{opacity:.5;}\n[data-reticle-hud] .reticle-send{flex:none;width:30px;height:30px;padding:0;border-radius:10px;border:none;cursor:pointer;pointer-events:auto;\n  background:var(--reticle-accent);color:#0b0d14;display:inline-flex;align-items:center;justify-content:center;transition:filter .15s,transform .1s;}\n[data-reticle-hud] .reticle-send svg{display:block;}\n[data-reticle-hud] .reticle-send:hover{filter:brightness(1.12);}\n[data-reticle-hud] .reticle-send:active{transform:scale(.9);}\n[data-reticle-hud] .reticle-send:disabled{opacity:.4;cursor:default;}\n[data-reticle-hud] .reticle-banner{display:none;flex:none;padding:8px 15px;color:var(--reticle-accent);\n  font-size:11.5px;font-weight:500;border-bottom:1px solid var(--reticle-line2);background:var(--reticle-accent-soft);}\n[data-reticle-overlay][data-reticle-state=\"ended\"] [data-reticle-banner]{display:block;}\n/* Export row: hidden during a live session; revealed when ended so the run can be copied/saved. */\n[data-reticle-hud] .reticle-export{display:none;align-items:center;gap:8px;margin-top:9px;}\n[data-reticle-overlay][data-reticle-state=\"ended\"] [data-reticle-hud] .reticle-export{display:flex;}\n[data-reticle-hud] .reticle-export-msg{color:var(--reticle-ok);font-size:11px;opacity:0;transition:opacity .15s;}\n[data-reticle-hud] .reticle-export-msg[data-show=\"1\"]{opacity:1;}\n[data-reticle-overlay][data-reticle-state=\"paused\"] [data-reticle-glow][data-on=\"1\"]{animation:none;\n  box-shadow:inset 0 0 0 3px rgba(246,180,76,.9),inset 0 0 30px 6px rgba(246,180,76,.4);}\n[data-reticle-overlay][data-reticle-state=\"ended\"] [data-reticle-glow][data-on=\"1\"]{animation:none;\n  box-shadow:inset 0 0 0 2px rgba(61,215,166,.55);}\n/* Handoff tones tell the human the agent's mode at a glance. waiting = calm teal \"your turn\" (no\n   alarm); ask = amber \"answer me\" with a pulse; warn = amber \"agent crashed\" with a pulse. Each leads\n   the banner with an icon and overrides the calm ended-green accent. */\n[data-reticle-overlay][data-reticle-tone=\"waiting\"] [data-reticle-hud]{--reticle-accent:#38bdf8;--reticle-accent-soft:rgba(56,189,248,.16);}\n[data-reticle-overlay][data-reticle-tone=\"waiting\"] [data-reticle-banner]{font-weight:600;color:#7dd3fc;}\n[data-reticle-overlay][data-reticle-tone=\"waiting\"] [data-reticle-banner]::before{content:\"\\270B  \";}\n[data-reticle-overlay][data-reticle-tone=\"waiting\"] [data-reticle-glow][data-on=\"1\"]{animation:none;\n  box-shadow:inset 0 0 0 2px rgba(56,189,248,.5);}\n[data-reticle-overlay][data-reticle-tone=\"ask\"] [data-reticle-hud],\n[data-reticle-overlay][data-reticle-tone=\"warn\"] [data-reticle-hud]{--reticle-accent:#fb923c;--reticle-accent-soft:rgba(251,146,60,.18);}\n[data-reticle-overlay][data-reticle-tone=\"ask\"] [data-reticle-banner],\n[data-reticle-overlay][data-reticle-tone=\"warn\"] [data-reticle-banner]{font-weight:600;color:#fdba74;}\n[data-reticle-overlay][data-reticle-tone=\"ask\"] [data-reticle-banner]::before{content:\"\\2753  \";}\n[data-reticle-overlay][data-reticle-tone=\"warn\"] [data-reticle-banner]::before{content:\"\\26A0\\FE0F  \";}\n[data-reticle-overlay][data-reticle-tone=\"ask\"] [data-reticle-glow][data-on=\"1\"],\n[data-reticle-overlay][data-reticle-tone=\"warn\"] [data-reticle-glow][data-on=\"1\"]{animation:reticle-warn-pulse 1.5s ease-in-out infinite;\n  box-shadow:inset 0 0 0 2px rgba(251,146,60,.7);}\n@keyframes reticle-warn-pulse{0%,100%{box-shadow:inset 0 0 0 2px rgba(251,146,60,.32);}\n  50%{box-shadow:inset 0 0 0 3px rgba(251,146,60,.85),inset 0 0 26px 5px rgba(251,146,60,.34);}}\n/* Replay-a-flow row: the human re-runs a saved flow with no agent. Hidden until flows are pushed.\n   Bounded + self-scrolling: it sits between the flex:1 log and the flex:none composer, so without a\n   height cap a long flow list would squeeze the log to nothing and push the message input past the\n   panel's overflow:hidden clip. flex:none + max-height + overflow-y keep the log and input always\n   visible; extra flow chips scroll inside this section instead of growing the panel. */\n[data-reticle-hud] .reticle-flows{display:none;flex:none;flex-wrap:wrap;align-content:flex-start;gap:6px;\n  padding:9px 12px;border-top:1px solid var(--reticle-line2);max-height:88px;overflow-y:auto;overscroll-behavior:contain;}\n[data-reticle-hud] .reticle-flows[data-has=\"1\"]{display:flex;}\n[data-reticle-hud] .reticle-flows::-webkit-scrollbar{width:9px;}\n[data-reticle-hud] .reticle-flows::-webkit-scrollbar-thumb{background:rgba(255,255,255,.14);border-radius:9px;border:2px solid transparent;background-clip:content-box;}\n[data-reticle-hud] .reticle-flows-cap{flex:0 0 100%;margin-bottom:1px;color:var(--reticle-faint);font-size:9.5px;letter-spacing:.09em;text-transform:uppercase;}\n[data-reticle-hud] .reticle-flow{pointer-events:auto;cursor:pointer;display:inline-flex;align-items:center;gap:5px;height:24px;padding:0 10px;\n  border-radius:7px;border:1px solid var(--reticle-line);background:rgba(255,255,255,.04);color:var(--reticle-muted);\n  font-family:var(--reticle-font);font-size:11px;font-weight:500;transition:background .15s,color .15s,border-color .15s,transform .1s;}\n[data-reticle-hud] .reticle-flow:hover{color:var(--reticle-fg);background:var(--reticle-accent-soft);border-color:var(--reticle-accent);}\n[data-reticle-hud] .reticle-flow:active{transform:scale(.95);}\n";
-//# sourceMappingURL=presenter-styles.d.ts.map

package/dist/presenter/presenter-styles.js

@@ -124,4 +124,3 @@ export const PRESENTER_CSS = `
 [data-reticle-overlay][data-reticle-throttled="1"] [data-reticle-hud]{--reticle-accent:#fbbf24;--reticle-accent-soft:rgba(251,191,36,.16);}
 ${LOG_CSS}
 ${CONTROLS_CSS}`;
-//# sourceMappingURL=presenter-styles.js.map

package/dist/presenter/presenter-tally.d.ts

@@ -17,4 +17,3 @@ export declare function countVerdicts(runLog: {
 export declare function renderTally(el: HTMLElement | undefined, runLog: {
     result?: LogResult;
 }[], prev: TallyCounts): TallyCounts;
-//# sourceMappingURL=presenter-tally.d.ts.map

package/dist/presenter/presenter-tally.js

@@ -35,4 +35,3 @@ export function renderTally(el, runLog, prev) {
             `<span class="reticle-t-fail"${dimF}${bumpFail}>✗ ${String(next.fails)}</span>`;
     return next;
 }
-//# sourceMappingURL=presenter-tally.js.map

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

@@ -13,4 +13,3 @@ export interface GlowFlips {
     stop: () => void;
 }
 export declare function trackGlowFlips(glow: HTMLElement): GlowFlips;
-//# sourceMappingURL=presenter-test-helpers.d.ts.map

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

@@ -39,4 +39,3 @@ export function trackGlowFlips(glow) {
         stop: () => obs.disconnect(),
     };
 }
-//# sourceMappingURL=presenter-test-helpers.js.map

package/dist/presenter/presenter-verbs.d.ts

@@ -1,2 +1 @@
 export declare function actionVerb(action: string): string;
-//# sourceMappingURL=presenter-verbs.d.ts.map

package/dist/presenter/presenter-verbs.js

@@ -26,4 +26,3 @@ export function actionVerb(action) {
             return action;
     }
 }
-//# sourceMappingURL=presenter-verbs.js.map

package/dist/presenter/presenter.d.ts

@@ -84,4 +84,3 @@ export declare class Presenter {
     /** 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.js

@@ -421,4 +421,3 @@ export class Presenter {
             spawnRipple(this.#root, cx, cy);
     }
 }
-//# sourceMappingURL=presenter.js.map

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

@@ -9,4 +9,3 @@ 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.js

@@ -42,4 +42,3 @@ export const NAME_CSS = [
 ].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.d.ts

@@ -57,4 +57,3 @@ export declare function compileRecording(name: string, steps: FlowStep[], annota
 /** Install the floating recorder toolbar. Default off; gated by the host (reticle.ts recorder flag). */
 export declare function installRecorder(deps: RecorderDeps): RecorderHandle;
 export {};
-//# sourceMappingURL=recorder.d.ts.map

package/dist/recorder/recorder.js

@@ -451,4 +451,3 @@ class Recorder {
 export function installRecorder(deps) {
     return new Recorder(deps);
 }
-//# sourceMappingURL=recorder.js.map

package/dist/registry/adapters.d.ts

@@ -28,4 +28,3 @@ export declare function readComponentState(el: Element): unknown;
  */
 export declare function elementHasHoverHandlers(el: Element): boolean;
 export declare function adapterNames(): string[];
-//# sourceMappingURL=adapters.d.ts.map

package/dist/registry/adapters.js

@@ -44,4 +44,3 @@ export function elementHasHoverHandlers(el) {
 export function adapterNames() {
     return adapters.map((a) => a.name);
 }
-//# sourceMappingURL=adapters.js.map

package/dist/registry/capabilities.d.ts

@@ -22,4 +22,3 @@ export declare function registerCapabilities(input: CapabilitiesInput): void;
 export declare function getCapabilities(): Capabilities;
 /** Whether the app has advertised any capabilities (used in the HELLO flag). */
 export declare function hasCapabilities(): boolean;
-//# sourceMappingURL=capabilities.d.ts.map

package/dist/registry/capabilities.js

@@ -45,4 +45,3 @@ export function hasCapabilities() {
         capabilities.stores.length > 0 ||
         capabilities.flows.length > 0);
 }
-//# sourceMappingURL=capabilities.js.map

package/dist/registry/commit-and-signal.d.ts

@@ -6,4 +6,3 @@
  */
 import type { ReticleEmitter } from './emitter.js';
 export declare function commitAndSignal<T>(emitter: ReticleEmitter, mutate: () => T, name: string, data?: Record<string, unknown>): T;
-//# sourceMappingURL=commit-and-signal.d.ts.map

package/dist/registry/commit-and-signal.js

@@ -9,4 +9,3 @@ export function commitAndSignal(emitter, mutate, name, data) {
     emitter.signal(name, data);
     return result;
 }
-//# sourceMappingURL=commit-and-signal.js.map

package/dist/registry/domains.d.ts

@@ -12,4 +12,3 @@ export interface ReticleDomain {
     stores?: readonly string[];
 }
 export declare function registerReticleDomain(domain: ReticleDomain): void;
-//# sourceMappingURL=domains.d.ts.map

package/dist/registry/domains.js

@@ -16,4 +16,3 @@ export function registerReticleDomain(domain) {
         input.stores = [...domain.stores];
     registerCapabilities(input);
 }
-//# sourceMappingURL=domains.js.map

package/dist/registry/emitter.d.ts

@@ -25,4 +25,3 @@ export interface CreateReticleEmitterOptions {
  * made at module load — before `reticle.connect` — starts working the moment Reticle connects.
  */
 export declare function createReticleEmitter(options?: CreateReticleEmitterOptions): ReticleEmitter;
-//# sourceMappingURL=emitter.d.ts.map

package/dist/registry/emitter.js

@@ -24,4 +24,3 @@ export function createReticleEmitter(options = {}) {
         },
     };
 }
-//# sourceMappingURL=emitter.js.map

package/dist/registry/store-adapters.d.ts

@@ -60,10 +60,19 @@ export interface QuerySnapshot {
  * ```
  */
 export declare function tanstackQueryStore(client: QueryClientLike): StoreLike;
-/** The minimum of a Jotai vanilla store this adapter touches. */
-interface JotaiStoreLike {
-    get: (atom: object) => unknown;
-    sub: (atom: object, listener: () => void) => () => void;
+/**
+ * The minimum of a Jotai vanilla store this adapter touches, generic in the ATOM type.
+ *
+ * `atom: object` was rejected by TypeScript for a real store and the reason is contravariance, not
+ * pedantry: Jotai's `get` is `<Value>(atom: Atom<Value>) => Value`, and a function that requires an
+ * `Atom` cannot stand in for one that accepts any `object`. So `jotaiStore(createStore(), …)` did
+ * not compile — the adapter was advertised, shipped, and unusable from TypeScript without a cast,
+ * which the shape-matched fake in the sibling test could never reveal because the fake was written
+ * to the same belief the adapter was.
+ */
+interface JotaiStoreLike<A> {
+    get: (atom: A) => unknown;
+    sub: (atom: A, listener: () => void) => () => void;
 }
 /**
  * Expose a chosen set of Jotai atoms as one Reticle store.
@@ -76,7 +85,7 @@ interface JotaiStoreLike {
  * registerStore('app', jotaiStore(getDefaultStore(), { cart: cartAtom, user: userAtom }));
  * ```
  */
-export declare function jotaiStore(store: JotaiStoreLike, atoms: Record<string, object>): StoreLike;
+export declare function jotaiStore<A>(store: JotaiStoreLike<A>, atoms: Record<string, A>): StoreLike;
 /** The minimum of an XState actor this adapter touches. */
 interface ActorLike {
     getSnapshot: () => unknown;
@@ -125,4 +134,3 @@ export declare function pushStore(initial: unknown): {
     push: (value: unknown) => void;
 };
 export {};
-//# sourceMappingURL=store-adapters.d.ts.map

package/dist/registry/store-adapters.js

@@ -132,4 +132,3 @@ export function pushStore(initial) {
         },
     };
 }
-//# sourceMappingURL=store-adapters.js.map

package/dist/registry/stores.d.ts

@@ -48,4 +48,3 @@ export declare function readStoresWithTruncation(only?: string): {
     stores: Record<string, unknown>;
     truncation?: Record<string, TruncationReport>;
 };
-//# sourceMappingURL=stores.d.ts.map

package/dist/registry/stores.js

@@ -1,4 +1,5 @@
 import { RETICLE_RENDERS_STORE } from '@reticlehq/core';
+import { nativeWarn } from '../timers/native-console.js';
 import { sanitizeWithReport } from '../security/serialization.js';
 const globalStore = globalThis;
 const stores = (globalStore.__reticleStores ??= new Map());
@@ -41,6 +42,14 @@ export function registerStore(name, source, subscribe) {
         notifyRegistered(name, getter, sub);
         return;
     }
+    if (typeof source !== 'function') {
+        const hasSubscribe = typeof source === 'object' && source !== null && 'subscribe' in source;
+        nativeWarn(`[reticle] store "${name}" is neither a getter function nor a {getState, subscribe} store` +
+            (hasSubscribe
+                ? ` — it has subscribe but no getState. Wrap it with an adapter or add getState.`
+                : '.'));
+        return;
+    }
     stores.set(name, source);
     if (subscribe !== undefined) {
         subscribers.set(name, subscribe);
@@ -136,8 +145,7 @@ function warnSilentStoreOnce(name) {
     if (RETICLE_OWNED_STORES.has(name) || warnedSilent.has(name))
         return;
     warnedSilent.add(name);
-    console.warn(`[reticle] store "${name}" was registered without a subscribe function. It can be READ, but its ` +
+    nativeWarn(`[reticle] store "${name}" was registered without a subscribe function. It can be READ, but its ` +
         `changes are invisible: no STATE_CHANGE events, no state diffs in causal summaries, and a state ` +
         `predicate will never see it update. Pass the store object (or a subscribe callback) to fix.`);
 }
-//# sourceMappingURL=stores.js.map

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

@@ -16,4 +16,3 @@ export declare function modeForCommand(commandName: string): PresenterMode;
  * element". Falls back to the bare verb when no target is in the args.
  */
 export declare function presentStatus(commandName: string, args?: Record<string, unknown>): string;
-//# sourceMappingURL=reticle-presenter-helpers.d.ts.map

package/dist/reticle-presenter-helpers.js

@@ -78,4 +78,3 @@ function queryTarget(q) {
         return name !== undefined ? `"${value}" (${name})` : `"${value}"`;
     return name !== undefined ? `"${name}"` : undefined;
 }
-//# sourceMappingURL=reticle-presenter-helpers.js.map

package/dist/reticle.d.ts

@@ -64,7 +64,9 @@ export interface ReticleConnectOptions {
  * behind `import.meta.env.DEV` so the SDK is dead-code-eliminated from prod bundles entirely.
  */
 export declare function shouldBlockProduction(nodeEnv: string | undefined, allowInProduction: boolean): boolean;
-export declare function connectionPolicy(pageHostname: string, bridgeUrl: string, allowNonLocalhost: boolean, token: string | undefined): {
+export declare function connectionPolicy(pageHostname: string, bridgeUrl: string, allowNonLocalhost: boolean, token: string | undefined, 
+/** The page's protocol. Desktop webviews (file:, app:, tauri:) are local despite a non-loopback host. */
+pageProtocol?: string): {
     allowed: boolean;
     reason?: string;
 };
@@ -134,4 +136,3 @@ export declare class Reticle {
     endSession(): void;
     disconnect(): void;
 }
-//# sourceMappingURL=reticle.d.ts.map