teamshare-bridge 0.26.12 → 0.26.14

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

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

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

@@ -1,7 +1,9 @@
 import type { CdpPage, ElementInfo, PageInfo, PageText, PageLink } from './cdp';
-import { type NetworkEntry, type ConsoleEntry } from './network-log';
+import { type NetworkEntry, type ConsoleEntry, type WebSocketFrame, type NetworkLogStatus } from './network-log';
 import { type ReadStagedResult, type FillExcelResult } from './xlsx-template';
 import { type LoginResult, type PerformLoginOptions } from './login';
+import { type NativeDialogState, type PagePaginationState, 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. */
@@ -134,8 +145,93 @@ export declare class BrowserSession {
      */
     connectToTab(targetId: string): Promise<PageInfo>;
     /**
-     * Navigate to a URL. Returns page info after navigation.
+     * 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;
+    }>;
+    /**
+     * Current pagination state (controls, page, page size, total, rows).
+     * Scoped to the top dialog by the page-state script.
+     */
+    pagination(): Promise<PagePaginationState>;
+    /** Stable-ish signature used to prove a page actually changed. */
+    private paginationSignature;
+    private waitPaginationChange;
+    private clickPagination;
+    /** Move to the next page (or Load more) and wait for the content to change. */
+    nextPage(timeoutMs?: number): Promise<{
+        moved: boolean;
+        elapsedMs: number;
+        state: PagePaginationState;
+        reason?: string;
+    }>;
+    /** Move to the previous page. */
+    prevPage(timeoutMs?: number): Promise<{
+        moved: boolean;
+        elapsedMs: number;
+        state: PagePaginationState;
+        reason?: string;
+    }>;
+    /** Go to a numbered page; walks next if the page control is not rendered. */
+    gotoPage(page: number, timeoutMs?: number): Promise<{
+        moved: boolean;
+        elapsedMs: number;
+        state: PagePaginationState;
+        reason?: string;
+    }>;
+    /** Select a native page-size option (custom comboboxes use click + waitFor). */
+    setPageSize(size: number): Promise<{
+        ok: boolean;
+        state: PagePaginationState;
+        error?: string;
+    }>;
+    /**
+     * Read the current table (headers + rows), then walk every page and return
+     * the deduplicated rows. Bounded by maxPages/maxRows; stops on a repeated
+     * page signature, a disabled pager, or an unchanged table.
      */
+    collectTable(opts?: {
+        selector?: string;
+        maxPages?: number;
+        maxRows?: number;
+        pageSize?: number;
+    }): Promise<{
+        headers: string[];
+        rows: string[][];
+        rowCount: number;
+        pagesVisited: number;
+        total?: number;
+        complete: boolean;
+        duplicates: number;
+        truncated: boolean;
+        stoppedBecause: string;
+    }>;
     navigate(url: string): Promise<PageInfo>;
     /**
      * Capture a screenshot. Returns base64-encoded data.
@@ -154,6 +250,8 @@ export declare class BrowserSession {
     }): Promise<{
         requests: NetworkEntry[];
         console: ConsoleEntry[];
+        websockets: WebSocketFrame[];
+        status: NetworkLogStatus;
     }>;
     /**
      * Click at (x, y) coordinates.
@@ -167,7 +265,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 +411,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)
      *