@bbclaw/core 0.1.0

package/dist/providers/web-bridge/shared/BrowserSession.js.map

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

package/dist/providers/web-bridge/shared/WebBridgeAdapter.d.ts

@@ -0,0 +1,97 @@
+/**
+ * WebBridgeAdapter — service-agnostic driver for chat-web targets.
+ *
+ * Given a {@link WebBridgeSpec}, this class manages the browser session,
+ * injects the DOM observer, and exposes a high-level streaming API for the
+ * upper layers (WebBridgeProvider). Adding a new service (Kimi, ChatGPT, ...)
+ * is just providing another spec — no subclassing needed.
+ *
+ * Lifecycle:
+ *   1. start()           — open the browser, navigate, inject observer.
+ *   2. isLoggedIn()      — verify the composer is reachable.
+ *   3. newChat()         — try locator strategies, fall back to URL nav.
+ *   4. askStream(prompt) — fill composer, submit, yield streaming text.
+ *   5. stop()            — close the context.
+ *
+ * Concurrency model: one in-flight ask at a time. The upper layer is
+ * responsible for serializing turns; concurrent `askStream` calls reject
+ * with a clear error.
+ */
+import { type Logger } from '@bbclaw/shared';
+import { type BrowserSessionOptions } from './BrowserSession.js';
+import { type ExternalUserMessageListener, type ResponseTextListener, type StateChangeListener, type WebBridgeSpec, type WebBridgeState } from './types.js';
+export interface WebBridgeAdapterOptions {
+    /** Persistent data dir (cookies, localStorage). */
+    userDataDir: string;
+    /** Default to headless. */
+    headless?: boolean;
+    /** Throw if no first response text arrives within this many ms. */
+    askTimeoutMs?: number;
+    /**
+     * After the response text stops changing for this many ms, declare the
+     * turn done. Defaults to 2_000ms — DeepSeek-class services have small
+     * inter-token gaps but multi-second pauses while rendering markdown.
+     */
+    stabilityWindowMs?: number;
+    /** Logger; defaults to silent. */
+    logger?: Logger;
+    /** Customize browser session options (user agent, viewport, etc). */
+    browserSessionOptions?: Partial<Omit<BrowserSessionOptions, 'userDataDir' | 'headless'>>;
+}
+export declare class WebBridgeAdapter {
+    private readonly spec;
+    private readonly opts;
+    private readonly session;
+    private page;
+    private inFlight;
+    /** Messages we sent ourselves and haven't yet seen reflected in DOM — used to skip our own as "external". */
+    private pendingOwnUserMessages;
+    /** Cumulative text across all observed deltas for the current turn. */
+    private currentTurnText;
+    /** Stability timer that fires when text stops changing. */
+    private stabilityTimer;
+    /** Observer-exposed callback, registered once per context. */
+    private observerExposed;
+    private responseListeners;
+    private externalListeners;
+    private stateListeners;
+    constructor(spec: WebBridgeSpec, opts: WebBridgeAdapterOptions);
+    get serviceId(): string;
+    get displayName(): string;
+    get isRunning(): boolean;
+    getState(): WebBridgeState;
+    /** Current URL the page is showing, or undefined if no page open. */
+    currentUrl(): string | undefined;
+    /** Start the browser, navigate to home, install observer. Idempotent. */
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    /** Toggle visibility. The browser is restarted on the next start() call. */
+    setHeadless(headless: boolean): Promise<void>;
+    /**
+     * Probe whether the composer is visible (i.e. user is logged in and the
+     * service is reachable). Starts the bridge if needed.
+     */
+    isLoggedIn(timeoutMs?: number): Promise<boolean>;
+    /**
+     * Click the service's "new chat" button using its fallback ladder. If
+     * every locator strategy fails, fall back to a fresh navigation to the
+     * home URL — most services treat that as starting a new conversation.
+     */
+    newChat(): Promise<void>;
+    /**
+     * Send a prompt and return an async iterable of cumulative text + done flag.
+     * The caller is responsible for diffing to deltas.
+     */
+    askStream(prompt: string): AsyncIterable<{
+        text: string;
+        done: boolean;
+    }>;
+    onResponseProgress(cb: ResponseTextListener): () => void;
+    onExternalUserMessage(cb: ExternalUserMessageListener): () => void;
+    onStateChange(cb: StateChangeListener): () => void;
+    private cleanupAsk;
+    private emitState;
+    private installObserver;
+    private handleObserverEvent;
+}
+//# sourceMappingURL=WebBridgeAdapter.d.ts.map

package/dist/providers/web-bridge/shared/WebBridgeAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebBridgeAdapter.d.ts","sourceRoot":"","sources":["../../../../src/providers/web-bridge/shared/WebBridgeAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,EAAE,KAAK,MAAM,EAAgB,MAAM,gBAAgB,CAAA;AAC1D,OAAO,EAAkB,KAAK,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAEhF,OAAO,EAGL,KAAK,2BAA2B,EAChC,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAClB,KAAK,cAAc,EACpB,MAAM,YAAY,CAAA;AAEnB,MAAM,WAAW,uBAAuB;IACtC,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAA;IACnB,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,mEAAmE;IACnE,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,kCAAkC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,qEAAqE;IACrE,qBAAqB,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,qBAAqB,EAAE,aAAa,GAAG,UAAU,CAAC,CAAC,CAAA;CACzF;AAgBD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAe;IACpC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAGpB;IAED,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,IAAI,CAAoB;IAEhC,OAAO,CAAC,QAAQ,CAA2B;IAC3C,6GAA6G;IAC7G,OAAO,CAAC,sBAAsB,CAAI;IAClC,uEAAuE;IACvE,OAAO,CAAC,eAAe,CAAK;IAC5B,2DAA2D;IAC3D,OAAO,CAAC,cAAc,CAA8B;IACpD,8DAA8D;IAC9D,OAAO,CAAC,eAAe,CAAQ;IAE/B,OAAO,CAAC,iBAAiB,CAA6B;IACtD,OAAO,CAAC,iBAAiB,CAAoC;IAC7D,OAAO,CAAC,cAAc,CAA4B;gBAEtC,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,uBAAuB;IAmB9D,IAAI,SAAS,IAAI,MAAM,CAEtB;IACD,IAAI,WAAW,IAAI,MAAM,CAExB;IACD,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,QAAQ,IAAI,cAAc;IAS1B,qEAAqE;IACrE,UAAU,IAAI,MAAM,GAAG,SAAS;IAKhC,yEAAyE;IACnE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAYtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ3B,4EAA4E;IACtE,WAAW,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAQnD;;;OAGG;IACG,UAAU,CAAC,SAAS,SAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;IAcrD;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA8B9B;;;OAGG;IACI,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC;IAyGhF,kBAAkB,CAAC,EAAE,EAAE,oBAAoB,GAAG,MAAM,IAAI;IAOxD,qBAAqB,CAAC,EAAE,EAAE,2BAA2B,GAAG,MAAM,IAAI;IAOlE,aAAa,CAAC,EAAE,EAAE,mBAAmB,GAAG,MAAM,IAAI;IASlD,OAAO,CAAC,UAAU;IAWlB,OAAO,CAAC,SAAS;YAKH,eAAe;IAoB7B,OAAO,CAAC,mBAAmB;CAsC5B"}

package/dist/providers/web-bridge/shared/WebBridgeAdapter.js

@@ -0,0 +1,359 @@
+/**
+ * WebBridgeAdapter — service-agnostic driver for chat-web targets.
+ *
+ * Given a {@link WebBridgeSpec}, this class manages the browser session,
+ * injects the DOM observer, and exposes a high-level streaming API for the
+ * upper layers (WebBridgeProvider). Adding a new service (Kimi, ChatGPT, ...)
+ * is just providing another spec — no subclassing needed.
+ *
+ * Lifecycle:
+ *   1. start()           — open the browser, navigate, inject observer.
+ *   2. isLoggedIn()      — verify the composer is reachable.
+ *   3. newChat()         — try locator strategies, fall back to URL nav.
+ *   4. askStream(prompt) — fill composer, submit, yield streaming text.
+ *   5. stop()            — close the context.
+ *
+ * Concurrency model: one in-flight ask at a time. The upper layer is
+ * responsible for serializing turns; concurrent `askStream` calls reject
+ * with a clear error.
+ */
+import { silentLogger } from '@bbclaw/shared';
+import { BrowserSession } from './BrowserSession.js';
+import { buildObserverScriptSource } from './observerScript.js';
+import { BridgeDOMUnrecognizedError, BridgeLoginRequiredError, } from './types.js';
+const DEFAULT_STABILITY_MS = 2_000;
+const DEFAULT_ASK_TIMEOUT_MS = 180_000;
+export class WebBridgeAdapter {
+    spec;
+    opts;
+    session;
+    page = null;
+    inFlight = null;
+    /** Messages we sent ourselves and haven't yet seen reflected in DOM — used to skip our own as "external". */
+    pendingOwnUserMessages = 0;
+    /** Cumulative text across all observed deltas for the current turn. */
+    currentTurnText = '';
+    /** Stability timer that fires when text stops changing. */
+    stabilityTimer = null;
+    /** Observer-exposed callback, registered once per context. */
+    observerExposed = false;
+    responseListeners = [];
+    externalListeners = [];
+    stateListeners = [];
+    constructor(spec, opts) {
+        this.spec = spec;
+        this.opts = {
+            userDataDir: opts.userDataDir,
+            headless: opts.headless ?? true,
+            askTimeoutMs: opts.askTimeoutMs ?? DEFAULT_ASK_TIMEOUT_MS,
+            stabilityWindowMs: opts.stabilityWindowMs ?? DEFAULT_STABILITY_MS,
+            browserSessionOptions: opts.browserSessionOptions ?? {},
+            logger: opts.logger ?? silentLogger,
+        };
+        this.session = new BrowserSession({
+            userDataDir: this.opts.userDataDir,
+            headless: this.opts.headless,
+            ...this.opts.browserSessionOptions,
+        });
+    }
+    // ---- public surface ----
+    get serviceId() {
+        return this.spec.serviceId;
+    }
+    get displayName() {
+        return this.spec.displayName;
+    }
+    get isRunning() {
+        return this.session.isOpen;
+    }
+    getState() {
+        return {
+            running: this.session.isOpen,
+            headless: this.session.headless,
+            busy: this.inFlight !== null,
+            loggedIn: 'unknown',
+        };
+    }
+    /** Current URL the page is showing, or undefined if no page open. */
+    currentUrl() {
+        if (!this.page || this.page.isClosed())
+            return undefined;
+        return this.page.url();
+    }
+    /** Start the browser, navigate to home, install observer. Idempotent. */
+    async start() {
+        if (this.page && !this.page.isClosed())
+            return;
+        this.page = await this.session.ensurePage(this.spec.homeUrl);
+        this.page.on('close', () => {
+            if (this.inFlight)
+                this.inFlight.reject(new Error('Web bridge: page closed mid-turn'));
+            this.page = null;
+            this.emitState();
+        });
+        await this.installObserver(this.page);
+        this.emitState();
+    }
+    async stop() {
+        if (this.inFlight)
+            this.inFlight.reject(new Error('Web bridge stopped'));
+        this.observerExposed = false;
+        await this.session.close();
+        this.page = null;
+        this.emitState();
+    }
+    /** Toggle visibility. The browser is restarted on the next start() call. */
+    async setHeadless(headless) {
+        if (this.session.headless === headless && this.session.isOpen)
+            return;
+        await this.session.restart(headless);
+        this.observerExposed = false;
+        this.page = null;
+        this.emitState();
+    }
+    /**
+     * Probe whether the composer is visible (i.e. user is logged in and the
+     * service is reachable). Starts the bridge if needed.
+     */
+    async isLoggedIn(timeoutMs = 3_000) {
+        await this.start();
+        if (!this.page || this.page.isClosed())
+            return false;
+        try {
+            await this.page.waitForSelector(this.spec.selectors.composer, {
+                state: 'visible',
+                timeout: timeoutMs,
+            });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Click the service's "new chat" button using its fallback ladder. If
+     * every locator strategy fails, fall back to a fresh navigation to the
+     * home URL — most services treat that as starting a new conversation.
+     */
+    async newChat() {
+        await this.start();
+        const page = this.page;
+        if (!page)
+            throw new Error('Web bridge: cannot newChat without a page');
+        for (const strategy of this.spec.newChatStrategies) {
+            try {
+                const loc = strategy(page);
+                await loc.click({ timeout: 1_500 });
+                // After clicking new chat, the observer's turnStartIdx self-resets via the userCount drop.
+                this.currentTurnText = '';
+                return;
+            }
+            catch {
+                // try next strategy
+            }
+        }
+        // Last resort.
+        try {
+            await page.goto(this.spec.homeUrl, { waitUntil: 'domcontentloaded', timeout: 8_000 });
+            this.currentTurnText = '';
+            return;
+        }
+        catch (e) {
+            throw new BridgeDOMUnrecognizedError(`Couldn't start new chat on ${this.spec.serviceId} — all fallbacks (including URL navigation) failed. Underlying: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    }
+    /**
+     * Send a prompt and return an async iterable of cumulative text + done flag.
+     * The caller is responsible for diffing to deltas.
+     */
+    async *askStream(prompt) {
+        await this.start();
+        const page = this.page;
+        if (!page)
+            throw new Error('Web bridge: cannot ask without a page');
+        if (this.inFlight)
+            throw new Error('Web bridge: another ask is in flight');
+        // Verify composer reachable; surface login-required cleanly.
+        try {
+            await page.waitForSelector(this.spec.selectors.composer, { state: 'visible', timeout: 8_000 });
+        }
+        catch {
+            throw new BridgeLoginRequiredError(`${this.spec.displayName} composer not visible — service likely needs login.`);
+        }
+        let resolveOne = null;
+        const queue = [];
+        const push = (item) => {
+            if (resolveOne) {
+                const fn = resolveOne;
+                resolveOne = null;
+                fn(item);
+            }
+            else {
+                queue.push(item);
+            }
+        };
+        const progressEmit = (text, done) => {
+            push({ kind: 'progress', text, done });
+        };
+        const ask = {
+            resolve: () => progressEmit(this.currentTurnText, true),
+            reject: (err) => {
+                this.opts.logger.warn(`[${this.spec.serviceId}] askStream rejected:`, err.message);
+                // Surface the error to the consumer via the queue. The generator will
+                // see it and re-throw, instead of silently completing with empty text.
+                push({ kind: 'error', error: err });
+            },
+            lastText: '',
+            watchdog: setTimeout(() => {
+                if (this.inFlight !== ask)
+                    return;
+                if (ask.lastText) {
+                    ask.resolve();
+                }
+                else {
+                    ask.reject(new Error(`Web bridge: response timeout after ${this.opts.askTimeoutMs}ms — no text observed. ` +
+                        `Likely causes: DOM selectors out of date (responseRoot did not match anything), the service is showing a captcha, or the request was silently dropped. ` +
+                        `Run with --no-headless to see what's on screen.`));
+                }
+            }, this.opts.askTimeoutMs),
+            progressEmit,
+        };
+        this.inFlight = ask;
+        this.pendingOwnUserMessages++;
+        this.currentTurnText = '';
+        this.emitState();
+        // Fire-and-forget the actual send. We DON'T await it here because the
+        // browser-side observer will start firing events as soon as the response
+        // begins streaming; we want to consume those concurrently.
+        void (async () => {
+            try {
+                await page.fill(this.spec.selectors.composer, prompt);
+                await page.keyboard.press('Enter');
+                this.opts.logger.debug(`[${this.spec.serviceId}] prompt sent (${prompt.length} chars); waiting for response...`);
+            }
+            catch (e) {
+                ask.reject(new Error(`Web bridge: failed to send prompt — ${e instanceof Error ? e.message : String(e)}. ` +
+                    `The composer (${this.spec.selectors.composer}) might have moved or become disabled.`));
+            }
+        })();
+        try {
+            while (true) {
+                const next = await new Promise((resolve) => {
+                    if (queue.length > 0) {
+                        resolve(queue.shift());
+                    }
+                    else {
+                        resolveOne = resolve;
+                    }
+                });
+                if (next.kind === 'error') {
+                    throw next.error;
+                }
+                yield { text: next.text, done: next.done };
+                if (next.done)
+                    return;
+            }
+        }
+        finally {
+            this.cleanupAsk(ask);
+        }
+    }
+    // ---- subscriptions ----
+    onResponseProgress(cb) {
+        this.responseListeners.push(cb);
+        return () => {
+            this.responseListeners = this.responseListeners.filter((f) => f !== cb);
+        };
+    }
+    onExternalUserMessage(cb) {
+        this.externalListeners.push(cb);
+        return () => {
+            this.externalListeners = this.externalListeners.filter((f) => f !== cb);
+        };
+    }
+    onStateChange(cb) {
+        this.stateListeners.push(cb);
+        return () => {
+            this.stateListeners = this.stateListeners.filter((f) => f !== cb);
+        };
+    }
+    // ---- internals ----
+    cleanupAsk(ask) {
+        if (this.inFlight !== ask)
+            return;
+        clearTimeout(ask.watchdog);
+        if (this.stabilityTimer) {
+            clearTimeout(this.stabilityTimer);
+            this.stabilityTimer = null;
+        }
+        this.inFlight = null;
+        this.emitState();
+    }
+    emitState() {
+        const s = this.getState();
+        for (const fn of this.stateListeners)
+            fn(s);
+    }
+    async installObserver(page) {
+        if (!this.observerExposed) {
+            try {
+                await page.exposeFunction('__bbclawBridgeEvent', (event) => {
+                    this.handleObserverEvent(event);
+                });
+                this.observerExposed = true;
+            }
+            catch {
+                // Already exposed for this context.
+                this.observerExposed = true;
+            }
+        }
+        // We pass the script as a plain JS string (not a function) so it bypasses
+        // any compiler-added wrappers (esbuild's __name, etc.) that would crash
+        // in the page context.
+        const source = buildObserverScriptSource(this.spec.selectors);
+        await page.addInitScript({ content: source });
+        await page.evaluate(source);
+    }
+    handleObserverEvent(event) {
+        if (event.type === 'response-progress') {
+            const text = event.text ?? '';
+            if (text === this.currentTurnText)
+                return;
+            this.currentTurnText = text;
+            // Forward to passive listeners.
+            for (const fn of this.responseListeners)
+                fn(text, false);
+            // Forward to the in-flight ask, if any.
+            const ask = this.inFlight;
+            if (ask) {
+                ask.lastText = text;
+                ask.progressEmit(text, false);
+            }
+            // Reset the stability timer.
+            if (this.stabilityTimer)
+                clearTimeout(this.stabilityTimer);
+            this.stabilityTimer = setTimeout(() => {
+                this.stabilityTimer = null;
+                const finalText = this.currentTurnText;
+                for (const fn of this.responseListeners)
+                    fn(finalText, true);
+                if (this.inFlight) {
+                    this.inFlight.lastText = finalText;
+                    this.inFlight.resolve();
+                }
+            }, this.opts.stabilityWindowMs);
+        }
+        else if (event.type === 'external-user-message') {
+            // Skip our own messages — they always echo via the observer first.
+            if (this.pendingOwnUserMessages > 0) {
+                this.pendingOwnUserMessages--;
+                return;
+            }
+            const text = event.text ?? '';
+            for (const fn of this.externalListeners)
+                fn(text);
+        }
+        // composer-ready: we currently don't act on this; future use for state machine.
+    }
+}
+//# sourceMappingURL=WebBridgeAdapter.js.map

package/dist/providers/web-bridge/shared/WebBridgeAdapter.js.map

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

package/dist/providers/web-bridge/shared/observerScript.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Browser-side observer script (string template form).
+ *
+ * Why a string and not a function? When we pass a TypeScript function to
+ * Playwright's page.evaluate/addInitScript, it stringifies the function with
+ * Function.prototype.toString(). But tsx/esbuild (and other TS compilers)
+ * wrap functions with helpers like `__name` for name-reflection support.
+ * Those helpers don't exist in the page's browser context, so the injected
+ * script crashes with "__name is not defined".
+ *
+ * By writing the body as a string, we bypass the compiler entirely — what
+ * goes to the page is exactly what we wrote.
+ *
+ * The script is parameterized by selectors, injected as a JSON literal.
+ *
+ * It watches the DOM for two things:
+ *   1. New user-bubble appearances — each one marks a turn boundary and may
+ *      indicate a user typed directly into the chat (passive capture).
+ *   2. Text changes in the response container that follows the latest user
+ *      bubble — these are streamed back as response progress.
+ * It calls back into Node via the exposed function `__bbclawBridgeEvent`.
+ */
+export interface BridgeObserverSelectors {
+    composer: string;
+    responseRoot: string;
+    userMessage: string;
+}
+export interface BridgeObserverEvent {
+    type: 'response-progress' | 'external-user-message' | 'composer-ready';
+    text?: string;
+}
+/**
+ * Build a self-contained JS source string that can be passed to Playwright's
+ * page.evaluate / page.addInitScript via the `{ content }` form.
+ *
+ * The selectors are inlined as a JSON literal, so the page receives a single
+ * standalone IIFE invocation — no compiler artifacts, no closures over
+ * Node-side values.
+ */
+export declare function buildObserverScriptSource(selectors: BridgeObserverSelectors): string;
+//# sourceMappingURL=observerScript.d.ts.map

package/dist/providers/web-bridge/shared/observerScript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observerScript.d.ts","sourceRoot":"","sources":["../../../../src/providers/web-bridge/shared/observerScript.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,EAAE,MAAM,CAAA;IACpB,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,mBAAmB,GAAG,uBAAuB,GAAG,gBAAgB,CAAA;IACtE,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AA2GD;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,uBAAuB,GAAG,MAAM,CAEpF"}

package/dist/providers/web-bridge/shared/observerScript.js

@@ -0,0 +1,138 @@
+/**
+ * Browser-side observer script (string template form).
+ *
+ * Why a string and not a function? When we pass a TypeScript function to
+ * Playwright's page.evaluate/addInitScript, it stringifies the function with
+ * Function.prototype.toString(). But tsx/esbuild (and other TS compilers)
+ * wrap functions with helpers like `__name` for name-reflection support.
+ * Those helpers don't exist in the page's browser context, so the injected
+ * script crashes with "__name is not defined".
+ *
+ * By writing the body as a string, we bypass the compiler entirely — what
+ * goes to the page is exactly what we wrote.
+ *
+ * The script is parameterized by selectors, injected as a JSON literal.
+ *
+ * It watches the DOM for two things:
+ *   1. New user-bubble appearances — each one marks a turn boundary and may
+ *      indicate a user typed directly into the chat (passive capture).
+ *   2. Text changes in the response container that follows the latest user
+ *      bubble — these are streamed back as response progress.
+ * It calls back into Node via the exposed function `__bbclawBridgeEvent`.
+ */
+const OBSERVER_BODY = String.raw `(function(selectors) {
+  if (window.__bbclawBridgeInstalled) return;
+
+  // addInitScript runs before any page scripts — document.body may not exist
+  // yet. Defer the actual installation until the body is available so that
+  // MutationObserver.observe doesn't throw on null. We set the installed flag
+  // only AFTER successful attach, so a transient race doesn't permanently
+  // mark the observer as installed.
+  function install() {
+    if (window.__bbclawBridgeInstalled) return;
+    if (!document.body) {
+      // Try again on next tick.
+      setTimeout(install, 50);
+      return;
+    }
+    window.__bbclawBridgeInstalled = true;
+
+    // The starting index of response nodes BEFORE the latest user turn.
+    // Everything at or after this index belongs to the in-progress / latest
+    // assistant turn.
+    var turnStartIdx = document.querySelectorAll(selectors.responseRoot).length;
+    var prevUserCount = document.querySelectorAll(selectors.userMessage).length;
+    var prevResponseText = '';
+
+    function isReasoningNode(el) {
+      // Walk up the ancestor chain — many services wrap CoT inside a collapsed
+      // <details> or a div with a "thinking"/"reasoning" class.
+      var cur = el;
+      while (cur && cur !== document.body) {
+        if (cur.tagName === 'DETAILS') return true;
+        var cls = typeof cur.className === 'string' ? cur.className.toLowerCase() : '';
+        if (/think|reason|thought|chain-of-thought|深度思考|思考/.test(cls)) return true;
+        cur = cur.parentElement;
+      }
+      return false;
+    }
+
+    function computeCurrentResponseText() {
+      var all = Array.prototype.slice.call(document.querySelectorAll(selectors.responseRoot));
+      var slice = all.slice(turnStartIdx);
+      if (slice.length === 0) return '';
+      // Drop wrappers — keep only leaves (nodes that don't contain other matched nodes).
+      var leaves = [];
+      for (var i = 0; i < slice.length; i++) {
+        var node = slice[i];
+        var hasInner = false;
+        for (var j = 0; j < slice.length; j++) {
+          if (i !== j && node.contains(slice[j])) { hasInner = true; break; }
+        }
+        if (!hasInner) leaves.push(node);
+      }
+      // Drop reasoning / CoT blocks; they're model-internal scratch.
+      var answers = [];
+      for (var k = 0; k < leaves.length; k++) {
+        if (!isReasoningNode(leaves[k])) answers.push(leaves[k]);
+      }
+      var parts = [];
+      for (var m = 0; m < answers.length; m++) parts.push(answers[m].innerText);
+      return parts.join('\n\n');
+    }
+
+    function emit(ev) {
+      if (typeof window.__bbclawBridgeEvent === 'function') {
+        window.__bbclawBridgeEvent(ev);
+      }
+    }
+
+    var obs = new MutationObserver(function() {
+      var userNodes = document.querySelectorAll(selectors.userMessage);
+
+      if (userNodes.length > prevUserCount) {
+        turnStartIdx = document.querySelectorAll(selectors.responseRoot).length;
+        for (var i = prevUserCount; i < userNodes.length; i++) {
+          emit({ type: 'external-user-message', text: userNodes[i].innerText });
+        }
+        prevUserCount = userNodes.length;
+        prevResponseText = '';
+      } else if (userNodes.length < prevUserCount) {
+        prevUserCount = userNodes.length;
+        turnStartIdx = document.querySelectorAll(selectors.responseRoot).length;
+        prevResponseText = '';
+      }
+
+      var text = computeCurrentResponseText();
+      if (text !== prevResponseText) {
+        prevResponseText = text;
+        emit({ type: 'response-progress', text: text });
+      }
+    });
+
+    obs.observe(document.body, { childList: true, subtree: true, characterData: true });
+
+    // Poll composer reachability for "logged-in" detection.
+    var composerCheck = setInterval(function() {
+      if (document.querySelector(selectors.composer)) {
+        emit({ type: 'composer-ready' });
+        clearInterval(composerCheck);
+      }
+    }, 200);
+    setTimeout(function() { clearInterval(composerCheck); }, 30000);
+  }
+
+  install();
+})`;
+/**
+ * Build a self-contained JS source string that can be passed to Playwright's
+ * page.evaluate / page.addInitScript via the `{ content }` form.
+ *
+ * The selectors are inlined as a JSON literal, so the page receives a single
+ * standalone IIFE invocation — no compiler artifacts, no closures over
+ * Node-side values.
+ */
+export function buildObserverScriptSource(selectors) {
+    return `${OBSERVER_BODY}(${JSON.stringify(selectors)});`;
+}
+//# sourceMappingURL=observerScript.js.map