teamshare-bridge 0.26.12 → 0.26.13

package/dist/lib/browser/page-events.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Persistent page-event buffer for the debug browser (2026-10).
+ *
+ * WHY THIS EXISTS. The auto-answer browser scrapes toasts/errors at capture
+ * time, and the debug browser had NOTHING: a toast that appeared after a form
+ * submit and vanished two seconds later was invisible to an agent that only
+ * looked on its next tool call. In the live Soludesks QA run the agent spent
+ * minutes re-reading the DOM for a dialog/error that had already been shown.
+ *
+ * This module injects a tiny, idempotent MutationObserver into the page that
+ * records toast / alert / status / dialog events in a bounded ring buffer
+ * (`window.__tsPageEvents`). It is installed:
+ *   - immediately when a session connects,
+ *   - on every new document via `Page.addScriptToEvaluateOnNewDocument`,
+ *   - again after a main-frame navigation (belt and braces).
+ *
+ * The script is dependency-free and returns a string so it can be injected
+ * with `Runtime.evaluate` or registered as a new-document script. It never
+ * reads field values and never logs anything.
+ */
+/** Maximum events retained in the page ring buffer (oldest dropped). */
+export declare const PAGE_EVENT_LIMIT = 80;
+export interface PageEvent {
+    /** toast | alert | status | error | dialog | dialog-closed */
+    type: string;
+    text: string;
+    /** epoch ms, page clock */
+    at: number;
+    role?: string;
+    count?: number;
+}
+/**
+ * Build the injected page-event script.
+ *
+ * IMPORTANT: regex escapes must be DOUBLE-escaped inside this template literal
+ * (`\\s`), otherwise the injected JS receives `s` (the exact bug the bridge lint
+ * gate found in another injected script).
+ */
+export declare function buildPageEventScript(): string;

package/dist/lib/browser/page-events.js

@@ -0,0 +1,128 @@
+"use strict";
+/**
+ * Persistent page-event buffer for the debug browser (2026-10).
+ *
+ * WHY THIS EXISTS. The auto-answer browser scrapes toasts/errors at capture
+ * time, and the debug browser had NOTHING: a toast that appeared after a form
+ * submit and vanished two seconds later was invisible to an agent that only
+ * looked on its next tool call. In the live Soludesks QA run the agent spent
+ * minutes re-reading the DOM for a dialog/error that had already been shown.
+ *
+ * This module injects a tiny, idempotent MutationObserver into the page that
+ * records toast / alert / status / dialog events in a bounded ring buffer
+ * (`window.__tsPageEvents`). It is installed:
+ *   - immediately when a session connects,
+ *   - on every new document via `Page.addScriptToEvaluateOnNewDocument`,
+ *   - again after a main-frame navigation (belt and braces).
+ *
+ * The script is dependency-free and returns a string so it can be injected
+ * with `Runtime.evaluate` or registered as a new-document script. It never
+ * reads field values and never logs anything.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PAGE_EVENT_LIMIT = void 0;
+exports.buildPageEventScript = buildPageEventScript;
+/** Maximum events retained in the page ring buffer (oldest dropped). */
+exports.PAGE_EVENT_LIMIT = 80;
+/**
+ * Build the injected page-event script.
+ *
+ * IMPORTANT: regex escapes must be DOUBLE-escaped inside this template literal
+ * (`\\s`), otherwise the injected JS receives `s` (the exact bug the bridge lint
+ * gate found in another injected script).
+ */
+function buildPageEventScript() {
+    return `
+    (() => {
+      if (window.__tsEventInstalled) return 'already';
+      window.__tsEventInstalled = true;
+      const MAX = ${exports.PAGE_EVENT_LIMIT};
+      const events = [];
+      window.__tsPageEvents = events;
+      const clean = (v) => String(v == null ? '' : v).replace(/\\s+/g, ' ').trim().slice(0, 500);
+      const now = () => Date.now();
+      const vis = (el) => {
+        if (!el || el.nodeType !== 1) return false;
+        const r = el.getBoundingClientRect();
+        if (r.width === 0 || r.height === 0) return false;
+        const cs = getComputedStyle(el);
+        return cs.visibility !== 'hidden' && cs.display !== 'none' && cs.opacity !== '0';
+      };
+      const push = (type, text, extra) => {
+        const t = clean(text);
+        if (!t || t.length < 2) return;
+        const last = events[events.length - 1];
+        if (last && last.type === type && last.text === t && now() - last.at < 1200) return;
+        const row = { type: type, text: t, at: now() };
+        if (extra) { if (extra.role) row.role = extra.role; if (extra.count != null) row.count = extra.count; }
+        events.push(row);
+        if (events.length > MAX) events.splice(0, events.length - MAX);
+      };
+      const TOAST_SEL = '[role="alert"],[role="status"],[aria-live],[data-sonner-toast],' +
+        '[class*="toast"],[class*="Toast"],[class*="snackbar"],[class*="Snackbar"],' +
+        '[class*="notification"],[class*="Notification"],[class*="alert"],[class*="Alert"],' +
+        '[class*="banner"],[class*="Banner"]';
+      const kindOf = (el) => {
+        const role = String((el.getAttribute && el.getAttribute('role')) || '').toLowerCase();
+        const cls = String((el.className && typeof el.className === 'string') ? el.className : '') + ' ' + String(el.id || '');
+        const live = String((el.getAttribute && el.getAttribute('aria-live')) || '').toLowerCase();
+        if (role === 'alert' || /error|danger|invalid/i.test(cls)) return 'error';
+        if (/toast|snackbar|notification/i.test(cls)) return 'toast';
+        if (role === 'status' || live === 'polite' || live === 'assertive') return 'status';
+        if (/alert|banner/i.test(cls)) return 'alert';
+        return null;
+      };
+      const record = (el) => {
+        if (!el || el.nodeType !== 1 || !vis(el)) return;
+        // A container that holds a nested toast should not be recorded as a
+        // second, duplicate event; use the deepest matching node.
+        const nested = el.querySelector && el.querySelector(TOAST_SEL);
+        if (nested && nested !== el) return;
+        const kind = kindOf(el);
+        if (!kind) return;
+        const text = el.innerText || el.textContent || el.getAttribute('aria-label') || '';
+        push(kind, text, { role: String((el.getAttribute && el.getAttribute('role')) || '') });
+      };
+      const scan = (root) => {
+        if (!root || root.nodeType !== 1) return;
+        if (root.matches && root.matches(TOAST_SEL)) record(root);
+        if (root.querySelectorAll) {
+          const nodes = root.querySelectorAll(TOAST_SEL);
+          for (let i = 0; i < nodes.length && i < 12; i++) record(nodes[i]);
+        }
+      };
+      const dialogs = () => [...document.querySelectorAll('dialog[open],[role="dialog"],[aria-modal="true"]')].filter(vis);
+      let dialogCount = dialogs().length;
+      const topDialogText = () => {
+        const list = dialogs();
+        const el = list[list.length - 1];
+        return el ? clean(el.innerText || el.textContent || '') : '';
+      };
+      const obs = new MutationObserver((mutations) => {
+        for (const m of mutations) {
+          if (m.type === 'childList') {
+            for (const n of m.addedNodes) if (n && n.nodeType === 1) scan(n);
+          } else if (m.type === 'characterData') {
+            const p = m.target && m.target.parentElement;
+            if (p) scan(p);
+          }
+        }
+        const count = dialogs().length;
+        if (count !== dialogCount) {
+          if (count > 0) push('dialog', topDialogText(), { count: count });
+          else push('dialog-closed', 'dialog closed', { count: 0 });
+          dialogCount = count;
+        }
+      });
+      const root = document.documentElement || document.body;
+      if (root) {
+        obs.observe(root, { childList: true, subtree: true, characterData: true });
+        // Record anything already on screen once (a login modal that opened
+        // before this script ran).
+        scan(document.body || root);
+      }
+      return 'ok';
+    })()
+  `;
+}
+//# sourceMappingURL=page-events.js.map

package/dist/lib/browser/page-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-events.js","sourceRoot":"","sources":["../../../src/lib/browser/page-events.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;GAmBG;;;AAsBH,oDA6FC;AAjHD,wEAAwE;AAC3D,QAAA,gBAAgB,GAAG,EAAE,CAAC;AAYnC;;;;;;GAMG;AACH,SAAgB,oBAAoB;IAClC,OAAO;;;;oBAIW,wBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuFjC,CAAC;AACJ,CAAC"}

package/dist/lib/browser/screen-change.js

@@ -117,6 +117,9 @@ function buildObserverScript() {
         });
         lastText = getText();
         window[KEY] = { observer: obs, changed: 0, mutated: 0 };
+        // String-addressable alias for OTHER injected scripts (the debug
+        // browser's waitFor reads it; a Symbol is not reachable by name).
+        window.__tsScreenObs = window[KEY];
         obs.observe(document.body || document.documentElement, {
           childList: true, subtree: true, characterData: true
         });

package/dist/lib/browser/screen-change.js.map

@@ -1 +1 @@
-{"version":3,"file":"screen-change.js","sourceRoot":"","sources":["../../../src/lib/browser/screen-change.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;GAaG;;;AAcH,kDAkBC;AAOD,sDAIC;AAQD,kDA8DC;AA/GD,0EAA0E;AAC7D,QAAA,uBAAuB,GAAG,EAAE,CAAC;AAE1C;;;;;;;;GAQG;AACH,SAAgB,mBAAmB,CACjC,QAAgB,EAChB,QAAgB;IAEhB,MAAM,UAAU,GAAG,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACxE,MAAM,UAAU,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACxD,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC;IACpC,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC;IACpC,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACpB,IAAI,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,MAAM;gBAAE,OAAO,EAAE,CAAC;;gBACpD,OAAO,EAAE,CAAC;QACjB,CAAC;IACH,CAAC;IACD,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAC/D,OAAO,KAAK,GAAG,EAAE,GAAG,OAAO,GAAG,EAAE,GAAG,OAAO,GAAG,CAAC,CAAC;AACjD,CAAC;AAED;;;;GAIG;AACH,SAAgB,qBAAqB,CACnC,MAA4D;IAE5D,OAAO,CAAC,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC;AACnD,CAAC;AAED;;;;;GAKG;AACH,SAAgB,mBAAmB;IACjC,OAAO;;;;;sCAK6B,mBAAmB,CAAC,QAAQ,EAAE;;;;;;;;;;;;;;;;qDAgBf,+BAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAuCvE,CAAC;AACN,CAAC"}
+{"version":3,"file":"screen-change.js","sourceRoot":"","sources":["../../../src/lib/browser/screen-change.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;GAaG;;;AAcH,kDAkBC;AAOD,sDAIC;AAQD,kDAiEC;AAlHD,0EAA0E;AAC7D,QAAA,uBAAuB,GAAG,EAAE,CAAC;AAE1C;;;;;;;;GAQG;AACH,SAAgB,mBAAmB,CACjC,QAAgB,EAChB,QAAgB;IAEhB,MAAM,UAAU,GAAG,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACxE,MAAM,UAAU,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACxD,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC;IACpC,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC;IACpC,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACpB,IAAI,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,MAAM;gBAAE,OAAO,EAAE,CAAC;;gBACpD,OAAO,EAAE,CAAC;QACjB,CAAC;IACH,CAAC;IACD,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAC/D,OAAO,KAAK,GAAG,EAAE,GAAG,OAAO,GAAG,EAAE,GAAG,OAAO,GAAG,CAAC,CAAC;AACjD,CAAC;AAED;;;;GAIG;AACH,SAAgB,qBAAqB,CACnC,MAA4D;IAE5D,OAAO,CAAC,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC;AACnD,CAAC;AAED;;;;;GAKG;AACH,SAAgB,mBAAmB;IACjC,OAAO;;;;;sCAK6B,mBAAmB,CAAC,QAAQ,EAAE;;;;;;;;;;;;;;;;qDAgBf,+BAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KA0CvE,CAAC;AACN,CAAC"}

package/dist/lib/browser/session.d.ts

@@ -2,6 +2,8 @@ import type { CdpPage, ElementInfo, PageInfo, PageText, PageLink } from './cdp';
 import { type NetworkEntry, type ConsoleEntry } from './network-log';
 import { type ReadStagedResult, type FillExcelResult } from './xlsx-template';
 import { type LoginResult, type PerformLoginOptions } from './login';
+import { type NativeDialogState, type PageSnapshot, type WaitForKind } from './page-context';
+import { type PageEvent } from './page-events';
 /**
  * Persistent Chrome profile for the AUTO-ANSWER browser (research reads,
  * `browse --auto-answer`, the web-auto-answer tool).
@@ -78,6 +80,13 @@ export declare class BrowserSession {
      * { action: "networkLog" }` when it needs to prove an API mismatch.
      */
     private network;
+    /**
+     * The native alert/confirm/prompt/beforeunload currently blocking the page
+     * (2026-10). Captured from `Page.javascriptDialogOpening`; other actions are
+     * refused while it is set, and `browser_action({action:"dialog"})` resolves
+     * it. A native dialog blocks the renderer, so a page snapshot would hang.
+     */
+    private _nativeDialog;
     constructor(id: string, opts?: BrowserSessionOptions);
     /** The stable session name the browser manager keys this session by. */
     get sessionKey(): string;
@@ -99,6 +108,8 @@ export declare class BrowserSession {
      */
     setAllowCredentials(allow: boolean): void;
     get allowCredentials(): boolean;
+    /** The native JS dialog currently blocking the page, if any. */
+    get nativeDialog(): NativeDialogState | null;
     /** Last time a command actually used this session (drives idle close). */
     private _lastUsedAt;
     /** When this session was last used — the idle-close timer reads this. */
@@ -133,6 +144,37 @@ export declare class BrowserSession {
      * Connect to a specific tab by targetId.
      */
     connectToTab(targetId: string): Promise<PageInfo>;
+    /**
+     * Install the debug browser's page instrumentation (2026-10):
+     *
+     *  - the persistent toast/alert/dialog ring buffer (`page-events.ts`),
+     *    registered for FUTURE documents via
+     *    `Page.addScriptToEvaluateOnNewDocument` and injected into the current
+     *    one immediately;
+     *  - the screen-change observer (`__tsScreenObs.mutated`) so `waitFor
+     *    {for:"change"}` knows a click had an effect without a blind sleep;
+     *  - the native-dialog listener (`Page.javascriptDialogOpening`), because an
+     *    alert/confirm/prompt blocks the renderer and must be surfaced and
+     *    resolved explicitly.
+     *
+     * All pieces are idempotent in the page. The CDP listeners are bound once per
+     * page object (a reconnect creates a new one).
+     */
+    private instrumentPage;
+    /**
+     * Resolve a native JS dialog (alert/confirm/prompt/beforeunload).
+     * `accept:false` dismisses it; `promptText` is used by a prompt.
+     */
+    dialogAction(opts: {
+        accept?: boolean;
+        promptText?: string;
+    }): Promise<{
+        ok: boolean;
+        accepted?: boolean;
+        type?: string;
+        message?: string;
+        error?: string;
+    }>;
     /**
      * Navigate to a URL. Returns page info after navigation.
      */
@@ -167,7 +209,9 @@ export declare class BrowserSession {
      * credential for the run - the debug browser is the QA surface, the
      * auto-answer loop is a separate path that still never touches credentials.
      */
-    type(text: string): Promise<void>;
+    type(text: string, opts?: {
+        clearFirst?: boolean;
+    }): Promise<void>;
     /**
      * Deterministically fill a login form (username + password) and submit.
      * Handles the common two-step email -> Continue -> password flow. Requires
@@ -311,6 +355,62 @@ export declare class BrowserSession {
      * Get current page info.
      */
     pageInfo(): Promise<PageInfo>;
+    /**
+     * Full page state (2026-10): dialogs (topmost with buttons/fields), toasts
+     * (persistent buffer), visible errors, form fields (lengths only), focus,
+     * busy, headings, optional page text, pending requests and console errors.
+     *
+     * This is the debug browser's equivalent of the auto-answer loop's rich
+     * `extractPageContext` - and it is what lets an agent see a login modal
+     * instead of guessing with raw `evaluate`.
+     */
+    snapshot(opts?: {
+        includeText?: boolean;
+        maxTextChars?: number;
+        maxFields?: number;
+    }): Promise<PageSnapshot>;
+    /**
+     * Bounded state attached to every mutating action result. Never include the
+     * page text (that is what `snapshot` is for); a failure returns null so an
+     * action result is never failed by its own observation.
+     */
+    compactSnapshot(): Promise<Record<string, unknown> | null>;
+    /**
+     * Recent toast / alert / dialog events from the persistent page buffer.
+     * This is how a toast that disappeared before the next tool call is still
+     * visible.
+     */
+    events(opts?: {
+        limit?: number;
+        clear?: boolean;
+        since?: number;
+    }): Promise<{
+        events: PageEvent[];
+        count: number;
+    }>;
+    /**
+     * Wait until a page condition is true, then return the current screen.
+     *
+     * This replaces the manual `evaluate` polling loop the QA agent used to run
+     * (and which broke on "Inspected target navigated"). On timeout it returns
+     * `matched:false` WITH the current screen, so the caller can see why.
+     */
+    waitFor(opts: {
+        for: WaitForKind;
+        selector?: string;
+        text?: string;
+        urlIncludes?: string;
+        state?: 'open' | 'closed';
+        loginPhase?: 'username' | 'password' | 'otp' | 'done';
+        timeoutMs?: number;
+        pollMs?: number;
+    }): Promise<{
+        matched: boolean;
+        elapsedMs: number;
+        for: WaitForKind;
+        screen: Record<string, unknown> | null;
+        nativeDialog: NativeDialogState | null;
+    }>;
     /**
      * Is the page actually usable right now? (2026-10)
      *