@holostaff/sdk 0.9.8 → 0.9.9

package/dist/observations.d.ts

@@ -1,40 +1,35 @@
 /**
  * Observations — rrweb session capture (vision-reconciliation wave,
- * Phase A).
+ * Phase A; Browserbase cost-optimization, Phase A/B).
  *
  * Records the visitor's session with rrweb and ships event batches to
  * `POST /api/runtime/sessions/:sessionId/observations`, where the
  * server's vision bridge replays them in Browserbase and screenshots
  * feed the Gemini perceive+decide tick.
  *
+ * Cost gating (Browserbase is the expensive resource, rrweb is free):
+ *   - We RECORD from page load but BUFFER client-side — nothing is sent
+ *     (so the server never spins up a Browserbase session) until the
+ *     first *trusted* interaction. Bots and bounces that load the page
+ *     but never interact cost nothing. The pre-gate buffer is trimmed to
+ *     the latest FullSnapshot so it stays small AND replayable, and the
+ *     whole lead-up is flushed at gate-open — we never lose the first
+ *     moments, the server just receives them a beat later once we know
+ *     it's a human.
+ *   - `navigator.webdriver` is reported so the server can reap automated
+ *     clients that drive trusted input (headless browsers).
+ *   - A visibility-gated heartbeat keeps the session marked live while
+ *     the tab is visible; it stops the instant the tab is hidden or
+ *     closed, so the server reaps the Browserbase session within seconds
+ *     instead of waiting out a 30-minute timeout.
+ *
  * Capture policy (wave doc §Phase A — "everything the user sees,
- * except PII"):
- *   - Full DOM, canvas (sampled at ~2 fps — the VLM only ticks every
- *     2–5s), media playback state, fonts + images inlined so replay
- *     doesn't depend on URLs staying reachable.
- *   - Typed PII never leaves the page: password / email / tel inputs
- *     are masked at the keystroke level. Rendered PII is the
- *     customer's to mark: `holostaff-mask` masks text content,
- *     `holostaff-block` blanks a region, `holostaff-ignore` skips an
- *     input entirely.
+ * except PII"): full DOM, canvas (~2 fps), media state, fonts + images
+ * inlined. Typed PII never leaves the page (password/email/tel masked;
+ * `holostaff-mask`/`-block`/`-ignore` for rendered PII).
  *
  * Version pin: rrweb 2.0.0-alpha.4 — MUST match the server's replay
- * bundle (server/src/bowtie/vision/rrweb.bundle.js); recorder and
- * replayer share the event format.
- *
- * Loading: rrweb is imported dynamically so hosts that disable
- * observation (or render server-side) never evaluate it; a failed
- * import degrades to no-capture and routes to onError, per the SDK's
- * fail-soft contract.
- *
- * Batching:
- *   - flush every FLUSH_INTERVAL_MS, or at MAX_BATCH_EVENTS, or when
- *     the approximate batch size passes MAX_BATCH_BYTES (full
- *     snapshots with inlined images are heavy — don't let them queue).
- *   - final flush on dispose goes over sendBeacon (survives unload);
- *     beacons cap at ~64KB so an oversized final batch is truncated to
- *     the most recent events — replay loses the tail of a dying
- *     session, never the session.
+ * bundle (server/src/bowtie/vision/rrweb.bundle.js).
  */
 import { type TransportConfig } from './transport.js';
 import type { ObserveOptions } from './types.js';

package/dist/observations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"observations.d.ts","sourceRoot":"","sources":["../src/observations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,OAAO,EAAwB,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAC3E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAOhD,MAAM,WAAW,uBAAuB;IACtC,GAAG,EAAE,eAAe,CAAA;IACpB,SAAS,EAAE,MAAM,CAAA;IACjB,kEAAkE;IAClE,SAAS,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACxC,OAAO,CAAC,EAAE,cAAc,CAAA;CACzB;AAED,MAAM,WAAW,mBAAmB;IAClC,iDAAiD;IACjD,OAAO,IAAI,IAAI,CAAA;CAChB;AAID,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,uBAAuB,GAAG,mBAAmB,CAyFpF"}
+{"version":3,"file":"observations.d.ts","sourceRoot":"","sources":["../src/observations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,EAAwB,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAC3E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAiBhD,MAAM,WAAW,uBAAuB;IACtC,GAAG,EAAE,eAAe,CAAA;IACpB,SAAS,EAAE,MAAM,CAAA;IACjB,kEAAkE;IAClE,SAAS,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACxC,OAAO,CAAC,EAAE,cAAc,CAAA;CACzB;AAED,MAAM,WAAW,mBAAmB;IAClC,iDAAiD;IACjD,OAAO,IAAI,IAAI,CAAA;CAChB;AAID,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,uBAAuB,GAAG,mBAAmB,CAoLpF"}

package/dist/observations.js

@@ -1,97 +1,206 @@
 /**
  * Observations — rrweb session capture (vision-reconciliation wave,
- * Phase A).
+ * Phase A; Browserbase cost-optimization, Phase A/B).
  *
  * Records the visitor's session with rrweb and ships event batches to
  * `POST /api/runtime/sessions/:sessionId/observations`, where the
  * server's vision bridge replays them in Browserbase and screenshots
  * feed the Gemini perceive+decide tick.
  *
+ * Cost gating (Browserbase is the expensive resource, rrweb is free):
+ *   - We RECORD from page load but BUFFER client-side — nothing is sent
+ *     (so the server never spins up a Browserbase session) until the
+ *     first *trusted* interaction. Bots and bounces that load the page
+ *     but never interact cost nothing. The pre-gate buffer is trimmed to
+ *     the latest FullSnapshot so it stays small AND replayable, and the
+ *     whole lead-up is flushed at gate-open — we never lose the first
+ *     moments, the server just receives them a beat later once we know
+ *     it's a human.
+ *   - `navigator.webdriver` is reported so the server can reap automated
+ *     clients that drive trusted input (headless browsers).
+ *   - A visibility-gated heartbeat keeps the session marked live while
+ *     the tab is visible; it stops the instant the tab is hidden or
+ *     closed, so the server reaps the Browserbase session within seconds
+ *     instead of waiting out a 30-minute timeout.
+ *
  * Capture policy (wave doc §Phase A — "everything the user sees,
- * except PII"):
- *   - Full DOM, canvas (sampled at ~2 fps — the VLM only ticks every
- *     2–5s), media playback state, fonts + images inlined so replay
- *     doesn't depend on URLs staying reachable.
- *   - Typed PII never leaves the page: password / email / tel inputs
- *     are masked at the keystroke level. Rendered PII is the
- *     customer's to mark: `holostaff-mask` masks text content,
- *     `holostaff-block` blanks a region, `holostaff-ignore` skips an
- *     input entirely.
+ * except PII"): full DOM, canvas (~2 fps), media state, fonts + images
+ * inlined. Typed PII never leaves the page (password/email/tel masked;
+ * `holostaff-mask`/`-block`/`-ignore` for rendered PII).
  *
  * Version pin: rrweb 2.0.0-alpha.4 — MUST match the server's replay
- * bundle (server/src/bowtie/vision/rrweb.bundle.js); recorder and
- * replayer share the event format.
- *
- * Loading: rrweb is imported dynamically so hosts that disable
- * observation (or render server-side) never evaluate it; a failed
- * import degrades to no-capture and routes to onError, per the SDK's
- * fail-soft contract.
- *
- * Batching:
- *   - flush every FLUSH_INTERVAL_MS, or at MAX_BATCH_EVENTS, or when
- *     the approximate batch size passes MAX_BATCH_BYTES (full
- *     snapshots with inlined images are heavy — don't let them queue).
- *   - final flush on dispose goes over sendBeacon (survives unload);
- *     beacons cap at ~64KB so an oversized final batch is truncated to
- *     the most recent events — replay loses the tail of a dying
- *     session, never the session.
+ * bundle (server/src/bowtie/vision/rrweb.bundle.js).
  */
 import { postJson, postBeacon } from './transport.js';
 const FLUSH_INTERVAL_MS = 5000;
 const MAX_BATCH_EVENTS = 200;
 const MAX_BATCH_BYTES = 800000;
 const BEACON_SAFE_BYTES = 55000;
+/** Force a periodic FullSnapshot so the pre-gate buffer can be trimmed to
+ *  a replayable checkpoint and the server replay self-heals. */
+const CHECKOUT_EVERY_MS = 30000;
+/** Pre-gate buffer caps — trimmed to the latest FullSnapshot when hit. */
+const PREGATE_MAX_EVENTS = 800;
+const PREGATE_MAX_BYTES = 3000000;
+/** Liveness ping cadence while visible (server reap grace must exceed it). */
+const HEARTBEAT_INTERVAL_MS = 15000;
+/** rrweb EventType.FullSnapshot. */
+const RRWEB_FULL_SNAPSHOT = 2;
 export function startObservations(deps) {
     if (typeof window === 'undefined')
         return { dispose: () => { } };
     if (deps.observe?.enabled === false)
         return { dispose: () => { } };
     let disposed = false;
+    let gateOpen = false;
     let stopRecording = null;
+    // Post-gate send buffer.
     let buffer = [];
     let bufferBytes = 0;
+    // Pre-gate buffer: recorded but withheld until a human interacts.
+    let pregate = [];
+    let pregateBytes = 0;
     let flushTimer = null;
+    let heartbeatTimer = null;
     const path = `/api/runtime/sessions/${deps.sessionId}/observations`;
+    const heartbeatPath = `/api/runtime/sessions/${deps.sessionId}/heartbeat`;
+    // Trusted interaction can still come from a headless browser driving
+    // real input — flag automation so the server can reap it.
+    const automated = typeof navigator !== 'undefined'
+        && navigator.webdriver === true;
+    const bodyExtra = automated ? { automated: true } : {};
     const flush = () => {
         if (!buffer.length)
             return;
         const events = buffer;
         buffer = [];
         bufferBytes = 0;
-        void postJson(deps.cfg, path, { ...deps.buildBody(), events });
+        void postJson(deps.cfg, path, { ...deps.buildBody(), ...bodyExtra, events });
     };
-    /** Unload-safe flush. Beacon payloads cap at ~64KB; keep the most
-     *  recent events if the tail batch is oversized — replay loses the
-     *  tail of a dying session, never the session. */
+    /** Unload-safe flush over sendBeacon (≤64KB; keep the most recent
+     *  events if the tail is oversized — lose the tail, never the session). */
     const flushBeacon = () => {
         if (!buffer.length)
             return;
         let events = buffer;
         buffer = [];
         bufferBytes = 0;
-        // Size by the events alone (body adds ~200 constant bytes); halving
-        // converges in ≤4 rounds from the 800KB batch cap.
         while (events.length > 1 && JSON.stringify(events).length > BEACON_SAFE_BYTES) {
             events = events.slice(Math.ceil(events.length / 2));
         }
-        postBeacon(deps.cfg, path, { ...deps.buildBody(), events });
+        postBeacon(deps.cfg, path, { ...deps.buildBody(), ...bodyExtra, events });
+    };
+    const sizeof = (e) => {
+        try {
+            return JSON.stringify(e).length;
+        }
+        catch {
+            return 1000;
+        }
+    };
+    /** Drop everything before the latest FullSnapshot — bounds memory while
+     *  keeping the buffer independently replayable. */
+    const trimPregate = () => {
+        let lastSnap = -1;
+        for (let i = pregate.length - 1; i >= 0; i--) {
+            if (pregate[i].type === RRWEB_FULL_SNAPSHOT) {
+                lastSnap = i;
+                break;
+            }
+        }
+        if (lastSnap > 0)
+            pregate = pregate.slice(lastSnap);
+        pregateBytes = pregate.reduce((n, e) => n + sizeof(e), 0);
     };
     const push = (event) => {
         if (disposed)
             return;
+        if (!gateOpen) {
+            pregate.push(event);
+            pregateBytes += sizeof(event);
+            if (pregate.length > PREGATE_MAX_EVENTS || pregateBytes > PREGATE_MAX_BYTES)
+                trimPregate();
+            return;
+        }
         buffer.push(event);
-        // Approximate sizing — exact enough to keep batches under the cap.
-        try {
-            bufferBytes += JSON.stringify(event).length;
+        bufferBytes += sizeof(event);
+        if (buffer.length >= MAX_BATCH_EVENTS || bufferBytes >= MAX_BATCH_BYTES)
+            flush();
+    };
+    const startSending = () => {
+        if (flushTimer == null)
+            flushTimer = setInterval(flush, FLUSH_INTERVAL_MS);
+    };
+    const stopSending = () => {
+        if (flushTimer != null) {
+            clearInterval(flushTimer);
+            flushTimer = null;
         }
-        catch {
-            bufferBytes += 1000;
+    };
+    const startHeartbeat = () => {
+        if (heartbeatTimer != null)
+            return;
+        heartbeatTimer = setInterval(() => {
+            if (typeof document !== 'undefined' && document.hidden)
+                return;
+            void postJson(deps.cfg, heartbeatPath, { ...deps.buildBody(), ...bodyExtra });
+        }, HEARTBEAT_INTERVAL_MS);
+    };
+    const stopHeartbeat = () => {
+        if (heartbeatTimer != null) {
+            clearInterval(heartbeatTimer);
+            heartbeatTimer = null;
         }
-        if (buffer.length >= MAX_BATCH_EVENTS || bufferBytes >= MAX_BATCH_BYTES)
+    };
+    // -- The human gate -------------------------------------------------
+    const GATE_EVENTS = ['pointerdown', 'pointermove', 'keydown', 'wheel', 'scroll', 'touchstart'];
+    const gateOpts = { passive: true, capture: true };
+    const openGate = () => {
+        if (gateOpen || disposed)
+            return;
+        gateOpen = true;
+        removeGateListeners();
+        // Hand the buffered lead-up to the send queue (already trimmed to a
+        // valid FullSnapshot) and flush it now — this is what creates the BB
+        // session, only now that we've seen a human.
+        buffer = pregate;
+        bufferBytes = pregateBytes;
+        pregate = [];
+        pregateBytes = 0;
+        flush();
+        startSending();
+        startHeartbeat();
+    };
+    const onGateEvent = (e) => { if (e.isTrusted)
+        openGate(); };
+    const addGateListeners = () => {
+        for (const t of GATE_EVENTS)
+            window.addEventListener(t, onGateEvent, gateOpts);
+    };
+    const removeGateListeners = () => {
+        for (const t of GATE_EVENTS)
+            window.removeEventListener(t, onGateEvent, gateOpts);
+    };
+    // -- Visibility: pause sending + heartbeat when hidden --------------
+    const onVisibility = () => {
+        if (!gateOpen)
+            return;
+        if (document.hidden) {
             flush();
+            stopSending();
+            stopHeartbeat();
+        }
+        else {
+            startSending();
+            startHeartbeat();
+        }
     };
-    // Dynamic import keeps rrweb out of hosts that never observe and
-    // makes a missing/incompatible module a soft failure.
+    if (typeof document !== 'undefined') {
+        document.addEventListener('visibilitychange', onVisibility);
+    }
+    addGateListeners();
+    // Dynamic import keeps rrweb out of hosts that never observe and makes
+    // a missing/incompatible module a soft failure.
     void import('rrweb')
         .then((rrweb) => {
         if (disposed)
@@ -103,6 +212,8 @@ export function startObservations(deps) {
         }
         stopRecording = record({
             emit: (event) => push(event),
+            // Periodic FullSnapshot → trimmable pre-gate buffer + self-healing replay.
+            checkoutEveryNms: CHECKOUT_EVERY_MS,
             // -- everything the user sees --
             recordCanvas: true,
             sampling: { canvas: 2 },
@@ -117,7 +228,7 @@ export function startObservations(deps) {
             ...(deps.observe?.blockSelector ? { blockSelector: deps.observe.blockSelector } : {}),
             ...(deps.observe?.rrweb ?? {}),
         }) ?? null;
-        flushTimer = setInterval(flush, FLUSH_INTERVAL_MS);
+        // NB: sending does NOT start here — it starts at the human gate.
     })
         .catch((err) => {
         deps.cfg.onError?.(err instanceof Error ? err : new Error(String(err)), { method: 'OBSERVE', path });
@@ -127,16 +238,20 @@ export function startObservations(deps) {
             if (disposed)
                 return;
             disposed = true;
-            if (flushTimer != null) {
-                clearInterval(flushTimer);
-                flushTimer = null;
+            stopSending();
+            stopHeartbeat();
+            removeGateListeners();
+            if (typeof document !== 'undefined') {
+                document.removeEventListener('visibilitychange', onVisibility);
             }
             try {
                 stopRecording?.();
             }
             catch { /* recorder already gone */ }
             stopRecording = null;
-            flushBeacon();
+            // Only beacon a tail if we'd opened the gate (a real human session).
+            if (gateOpen)
+                flushBeacon();
         },
     };
 }

package/dist/observations.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@holostaff/sdk",
-  "version": "0.9.8",
+  "version": "0.9.9",
   "description": "Holostaff SDK — lifetime identity, stage detection, custom signal probes, and the living-portrait presence layer (chip, note, Theater, voice Stage) for the Holostaff runtime.",
   "license": "Apache-2.0",
   "homepage": "https://docs.holostaff.ai",