@love-moon/chat-web 0.3.2

package/dist/providers/chatgpt.js

@@ -0,0 +1,357 @@
+import { InputNotFoundError, ResponseExtractionError, ResponseTimeoutError, } from "../core/errors.js";
+import { typeMultiline } from "../core/keyboard.js";
+import { gotoOrThrowNetworkError } from "../core/navigate.js";
+import { sleep, waitUntilStable } from "../core/response-watcher.js";
+import { ChatGPTSSECollector } from "./chatgpt-sse-collector.js";
+/**
+ * ChatGPT (chatgpt.com) provider adapter.
+ *
+ * Selectors are intentionally written as fallbacks (RFC §8) — when one
+ * breaks we fall back to the next. The strongest contracts we rely on:
+ *   - the prompt input is a textarea or contenteditable in the viewport
+ *   - assistant messages carry data-message-author-role="assistant"
+ *   - while streaming, a "Stop generating" button is present
+ *
+ * Reply extraction has two paths (see `extractLastAssistantMessage`):
+ *   1. SSE collector — listens to `/backend-api/.../conversation` and
+ *      reconstructs the model's original markdown (bullets, fences,
+ *      tables, link URLs). Preferred.
+ *   2. DOM `innerText` fallback — used when SSE parsing returned nothing
+ *      (endpoint changed, request errored, ...).
+ */
+export class ChatGPTAdapter {
+    name = "chatgpt";
+    homeUrl = "https://chatgpt.com/";
+    /** One collector per Page. Lazily attached on `open()`. */
+    collectors = new WeakMap();
+    /**
+     * Promise that resolves to the assistant markdown for the currently
+     * in-flight turn (between `sendMessage` and `waitForResponse`).
+     * Per-page so concurrent pages don't collide.
+     */
+    pendingTurns = new WeakMap();
+    async open(page) {
+        // Install the SSE collector BEFORE navigating, so we capture any
+        // initial streaming responses (e.g. if the previous conversation was
+        // mid-stream when we attached). Idempotent across re-opens.
+        this.ensureCollector(page);
+        // gotoWithRetry uses waitUntil:"commit" + exponential-backoff retries.
+        // ChatGPT loads a lot from CDNs; relying on `load`/`domcontentloaded`
+        // wedges the open() on slow / proxied networks. The composer wait
+        // below is the real readiness check.
+        await gotoOrThrowNetworkError(page, this.homeUrl, this.name);
+        await this.waitForComposerReady(page).catch(() => undefined);
+    }
+    async isLoggedIn(page) {
+        // The signed-in state always exposes the ProseMirror composer.
+        // We probe the strongest identifier first (id=prompt-textarea), then
+        // softer fallbacks for layout changes.
+        const candidates = [
+            '#prompt-textarea[contenteditable="true"]',
+            'div[role="textbox"][contenteditable="true"]',
+            '[contenteditable="true"]',
+        ];
+        for (const sel of candidates) {
+            const loc = page.locator(sel).first();
+            const visible = await loc.isVisible().catch(() => false);
+            if (visible)
+                return true;
+        }
+        return false;
+    }
+    async findInput(page) {
+        // IMPORTANT: do NOT include `textarea` as a candidate. ChatGPT renders
+        // a `<textarea class="wcDTda_fallbackTextarea">` sibling to the
+        // ProseMirror editor for accessibility, but clicking it is intercepted
+        // by the ProseMirror placeholder `<p>`, leading to a 30s timeout.
+        const candidates = [
+            page.locator('#prompt-textarea[contenteditable="true"]').first(),
+            page.locator('div[role="textbox"][contenteditable="true"]').first(),
+            page.locator('[contenteditable="true"]').first(),
+        ];
+        for (const locator of candidates) {
+            if (await locator.isVisible().catch(() => false)) {
+                return locator;
+            }
+        }
+        throw new InputNotFoundError(this.name);
+    }
+    async findSendButton(page) {
+        const candidates = [
+            // Most stable: the explicit id ChatGPT uses on the composer submit.
+            page.locator("button#composer-submit-button").first(),
+            page.locator('button[aria-label="Send prompt"]').first(),
+            page.locator('button[data-testid="send-button"]').first(),
+            page.locator('button[aria-label*="Send" i]').first(),
+            page.locator('button[aria-label*="发送" i]').first(),
+            page.locator('form button[type="submit"]').first(),
+        ];
+        for (const locator of candidates) {
+            if (await locator.isVisible().catch(() => false)) {
+                return locator;
+            }
+        }
+        return null;
+    }
+    async sendMessage(page, message) {
+        const input = await this.findInput(page);
+        // Arm the SSE collector BEFORE we submit so we don't miss the first
+        // delta frames. The promise is stashed per-page and consumed by
+        // `extractLastAssistantMessage`/`waitForResponse`.
+        const collector = this.ensureCollector(page);
+        this.pendingTurns.set(page, collector.beginTurn());
+        // ProseMirror: click to focus (force:true bypasses the placeholder
+        // intercept check — the placeholder lives inside the editor, so a
+        // click through it still lands in the right place), then type via the
+        // keyboard so the editor's input handlers fire. `locator.fill` is a
+        // no-op on contenteditable and `insertText` skips IME handling.
+        await input.click({ force: true });
+        await input.focus().catch(() => undefined);
+        // CRITICAL: use `typeMultiline`, not `page.keyboard.type(message)`.
+        // ChatGPT's ProseMirror binds Enter to "submit prompt"; `keyboard.type`
+        // emits a literal Enter key event for every "\n" in the message, which
+        // causes multi-line prompts to be submitted line-by-line. The helper
+        // converts newlines into Shift+Enter (soft line break) presses.
+        await typeMultiline(page, message);
+        // Prefer clicking the send button — it gives us a cleaner state
+        // transition (the button toggles to "Stop generating" while streaming).
+        const send = await this.findSendButton(page);
+        if (send && (await send.isEnabled().catch(() => false))) {
+            await send.click({ force: true }).catch(async () => {
+                await page.keyboard.press("Enter");
+            });
+        }
+        else {
+            await page.keyboard.press("Enter");
+        }
+    }
+    /** Wait up to `timeoutMs` for the ProseMirror composer to be ready. */
+    async waitForComposerReady(page, timeoutMs = 15_000) {
+        const sel = '#prompt-textarea[contenteditable="true"], div[role="textbox"][contenteditable="true"]';
+        await page.locator(sel).first().waitFor({ state: "visible", timeout: timeoutMs });
+    }
+    async extractLastAssistantMessage(page) {
+        // Path 1: SSE collector. When wiring is healthy this gives us the
+        // model's original markdown (code fences, list prefixes, link URLs).
+        //
+        // IMPORTANT: use `getCurrentTurnText`, not `getLastAssistantText`.
+        // The latter used to return the most-recent *finalized* turn's text,
+        // which silently leaked the previous turn's answer when the current
+        // turn's SSE was empty / racy (task 09b34cf4-… symptom: "1+1=2" reply
+        // showing up under a long arXiv prompt).
+        const collector = this.collectors.get(page);
+        if (collector) {
+            const sseText = collector.getCurrentTurnText();
+            if (sseText && sseText.trim())
+                return sseText.trim();
+        }
+        // Path 2: DOM innerText fallback. Loses markdown structure but is the
+        // safety net when the streaming endpoint changes / is unreachable /
+        // hasn't finished yet.
+        const candidates = [
+            page.locator('[data-message-author-role="assistant"]').last(),
+            page.locator("main article").last(),
+            page.locator(".markdown, .prose").last(),
+        ];
+        for (const locator of candidates) {
+            if (await locator.count().then((n) => n > 0).catch(() => false)) {
+                const text = await locator.innerText().catch(() => "");
+                if (text && text.trim())
+                    return text.trim();
+            }
+        }
+        throw new ResponseExtractionError(this.name);
+    }
+    async waitForResponse(page, options = {}) {
+        const timeoutMs = options.timeoutMs ?? 120_000;
+        const stableMs = options.stableMs ?? 2_000;
+        const deadline = Date.now() + timeoutMs;
+        // Path A: if `sendMessage` armed the SSE collector, the most reliable
+        // "done" signal is the SSE response finishing. It also returns the
+        // model's original markdown, which is what we ultimately want.
+        const pending = this.pendingTurns.get(page);
+        if (pending) {
+            this.pendingTurns.delete(page);
+            const winner = await Promise.race([
+                pending.then((text) => ({ kind: "sse", text })),
+                new Promise((resolve) => setTimeout(() => resolve({ kind: "timeout" }), timeoutMs)),
+            ]);
+            if (winner.kind === "sse" && winner.text && winner.text.trim()) {
+                return winner.text.trim();
+            }
+            // Either timeout or empty SSE → fall through to the DOM fallback.
+        }
+        // Path B (fallback): RFC §10 — use the stop-button toggle + text
+        // stability. We get here when either the SSE wasn't armed (e.g. an
+        // older Page that bypassed `sendMessage`) or the SSE returned empty.
+        // Phase 1: wait for streaming to actually begin (stop button appears).
+        await this.waitForStopButton(page, { timeoutMs: 15_000 }).catch(() => undefined);
+        // Phase 2: wait until the stop button is gone (= generation ended).
+        const remaining = Math.max(deadline - Date.now(), 5_000);
+        await this.waitForStopButtonGone(page, remaining).catch(() => undefined);
+        // Phase 3: text-stability sanity check, with the rest of the budget.
+        const stable = await waitUntilStable(async () => {
+            const text = await this.extractLastAssistantMessage(page).catch(() => "");
+            if (isThinkingPlaceholder(text))
+                return "";
+            return text;
+        }, {
+            timeoutMs: Math.max(deadline - Date.now(), 1_500),
+            stableMs,
+            signal: options.signal,
+            onProgress: options.onProgress,
+        });
+        if (!stable) {
+            throw new ResponseTimeoutError(this.name, timeoutMs);
+        }
+        return stable;
+    }
+    /**
+     * Extract the ChatGPT conversation UUID from the page URL.
+     *
+     * Once a turn lands, ChatGPT navigates the page to
+     *   `https://chatgpt.com/c/{conversation-uuid}`
+     * The fresh-chat URL (`/` or `/?model=...`) has no UUID — return `null`
+     * in that case. The UUID is the natural cross-process session id and is
+     * what we plumb into ai-sdk's session model and onward to the UI.
+     */
+    getConversationId(page) {
+        const url = page.url();
+        // The path can have a trailing slash, query string, or hash; pull
+        // out exactly the path segment after `/c/`.
+        const match = url.match(/\/c\/([0-9a-fA-F-]{8,})/);
+        return match ? match[1] : null;
+    }
+    async newChat(page) {
+        const candidates = [
+            page.locator('a[href="/"]').first(),
+            page.getByRole("button", { name: /new chat/i }).first(),
+            page.getByRole("link", { name: /new chat/i }).first(),
+        ];
+        for (const locator of candidates) {
+            if (await locator.isVisible().catch(() => false)) {
+                await locator.click().catch(() => undefined);
+                return;
+            }
+        }
+        // Fallback: just navigate to the home URL.
+        await this.open(page);
+    }
+    async diagnose(page) {
+        const [loggedIn, sendBtn, assistantCount, stopFound] = await Promise.all([
+            this.isLoggedIn(page),
+            this.findSendButton(page).then((l) => l !== null),
+            page.locator('[data-message-author-role="assistant"]').count().catch(() => 0),
+            page
+                .locator('button[aria-label*="Stop" i], button[aria-label*="停止" i]')
+                .first()
+                .isVisible()
+                .catch(() => false),
+        ]);
+        let inputFound = false;
+        try {
+            await this.findInput(page);
+            inputFound = true;
+        }
+        catch {
+            inputFound = false;
+        }
+        let lastAssistantLength = 0;
+        try {
+            const text = await this.extractLastAssistantMessage(page);
+            lastAssistantLength = text.length;
+        }
+        catch {
+            lastAssistantLength = 0;
+        }
+        return {
+            loggedIn,
+            inputFound,
+            sendButtonFound: sendBtn,
+            assistantMessageCount: assistantCount,
+            stopButtonFound: stopFound,
+            lastAssistantLength,
+            pageUrl: page.url(),
+        };
+    }
+    /** Look up (and lazily create + attach) the SSE collector for a Page. */
+    ensureCollector(page) {
+        let c = this.collectors.get(page);
+        if (!c) {
+            c = new ChatGPTSSECollector();
+            c.attach(page);
+            this.collectors.set(page, c);
+            // Drop our reference when the page closes so the collector can GC.
+            page.once("close", () => {
+                c?.dispose();
+                this.collectors.delete(page);
+                this.pendingTurns.delete(page);
+            });
+        }
+        return c;
+    }
+    async waitForStopButton(page, options = {}) {
+        const timeoutMs = options.timeoutMs ?? 15_000;
+        const deadline = Date.now() + timeoutMs;
+        while (Date.now() < deadline) {
+            if (await this.isStopButtonVisible(page))
+                return;
+            await sleep(150);
+        }
+    }
+    async waitForStopButtonGone(page, timeoutMs = 5_000) {
+        const deadline = Date.now() + timeoutMs;
+        let consecutiveGone = 0;
+        while (Date.now() < deadline) {
+            const visible = await this.isStopButtonVisible(page);
+            if (!visible) {
+                // Require a few consecutive "gone" samples to avoid catching a
+                // brief click-debounce gap during the chain-of-thought / answer
+                // handoff that happens on reasoning models.
+                consecutiveGone += 1;
+                if (consecutiveGone >= 3)
+                    return;
+            }
+            else {
+                consecutiveGone = 0;
+            }
+            await sleep(200);
+        }
+    }
+    async isStopButtonVisible(page) {
+        // ChatGPT exposes the stop-generating control as the composer-submit
+        // button in "stop" mode. The aria-label changes ("Stop generating",
+        // "Stop streaming", "停止生成", ...). We probe the data-* fingerprint
+        // first, then fall back to aria-label heuristics.
+        const selectors = [
+            "button#composer-submit-button[data-state=stop]",
+            'button[data-testid="stop-button"]',
+            'button[aria-label*="Stop" i]',
+            'button[aria-label*="停止" i]',
+        ];
+        for (const sel of selectors) {
+            const visible = await page.locator(sel).first().isVisible().catch(() => false);
+            if (visible)
+                return true;
+        }
+        return false;
+    }
+}
+function isThinkingPlaceholder(text) {
+    const t = text.trim();
+    if (!t)
+        return true;
+    if (t.length > 80)
+        return false;
+    // Lower-cased prefix match covers ChatGPT's reasoning placeholders.
+    const lower = t.toLowerCase();
+    return (lower === "thinking" ||
+        lower === "thinking…" ||
+        lower === "thinking..." ||
+        lower.startsWith("thinking\n") ||
+        lower.startsWith("thought for ") ||
+        lower.startsWith("reasoning") ||
+        lower.startsWith("思考") ||
+        lower.startsWith("正在思考"));
+}
+//# sourceMappingURL=chatgpt.js.map

package/dist/providers/chatgpt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chatgpt.js","sourceRoot":"","sources":["../../src/providers/chatgpt.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAE9D,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAErE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEjE;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,cAAc;IAChB,IAAI,GAAG,SAAS,CAAC;IACjB,OAAO,GAAG,sBAAsB,CAAC;IAE1C,2DAA2D;IACnD,UAAU,GAAG,IAAI,OAAO,EAA6B,CAAC;IAC9D;;;;OAIG;IACK,YAAY,GAAG,IAAI,OAAO,EAAyB,CAAC;IAE5D,KAAK,CAAC,IAAI,CAAC,IAAU;QACnB,iEAAiE;QACjE,qEAAqE;QACrE,4DAA4D;QAC5D,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QAE3B,uEAAuE;QACvE,sEAAsE;QACtE,kEAAkE;QAClE,qCAAqC;QACrC,MAAM,uBAAuB,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7D,MAAM,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAC/D,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,IAAU;QACzB,+DAA+D;QAC/D,qEAAqE;QACrE,uCAAuC;QACvC,MAAM,UAAU,GAAG;YACjB,0CAA0C;YAC1C,6CAA6C;YAC7C,0BAA0B;SAC3B,CAAC;QACF,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;YAC7B,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC;YACtC,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;YACzD,IAAI,OAAO;gBAAE,OAAO,IAAI,CAAC;QAC3B,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,IAAU;QACxB,uEAAuE;QACvE,gEAAgE;QAChE,uEAAuE;QACvE,kEAAkE;QAClE,MAAM,UAAU,GAAc;YAC5B,IAAI,CAAC,OAAO,CAAC,0CAA0C,CAAC,CAAC,KAAK,EAAE;YAChE,IAAI,CAAC,OAAO,CAAC,6CAA6C,CAAC,CAAC,KAAK,EAAE;YACnE,IAAI,CAAC,OAAO,CAAC,0BAA0B,CAAC,CAAC,KAAK,EAAE;SACjD,CAAC;QAEF,KAAK,MAAM,OAAO,IAAI,UAAU,EAAE,CAAC;YACjC,IAAI,MAAM,OAAO,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;gBACjD,OAAO,OAAO,CAAC;YACjB,CAAC;QACH,CAAC;QAED,MAAM,IAAI,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,IAAU;QAC7B,MAAM,UAAU,GAAc;YAC5B,oEAAoE;YACpE,IAAI,CAAC,OAAO,CAAC,+BAA+B,CAAC,CAAC,KAAK,EAAE;YACrD,IAAI,CAAC,OAAO,CAAC,kCAAkC,CAAC,CAAC,KAAK,EAAE;YACxD,IAAI,CAAC,OAAO,CAAC,mCAAmC,CAAC,CAAC,KAAK,EAAE;YACzD,IAAI,CAAC,OAAO,CAAC,8BAA8B,CAAC,CAAC,KAAK,EAAE;YACpD,IAAI,CAAC,OAAO,CAAC,4BAA4B,CAAC,CAAC,KAAK,EAAE;YAClD,IAAI,CAAC,OAAO,CAAC,4BAA4B,CAAC,CAAC,KAAK,EAAE;SACnD,CAAC;QAEF,KAAK,MAAM,OAAO,IAAI,UAAU,EAAE,CAAC;YACjC,IAAI,MAAM,OAAO,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;gBACjD,OAAO,OAAO,CAAC;YACjB,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,IAAU,EAAE,OAAe;QAC3C,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAEzC,oEAAoE;QACpE,gEAAgE;QAChE,mDAAmD;QACnD,MAAM,SAAS,GAAG,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QAC7C,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,SAAS,EAAE,CAAC,CAAC;QAEnD,mEAAmE;QACnE,kEAAkE;QAClE,sEAAsE;QACtE,oEAAoE;QACpE,gEAAgE;QAChE,MAAM,KAAK,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACnC,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC3C,oEAAoE;QACpE,wEAAwE;QACxE,uEAAuE;QACvE,qEAAqE;QACrE,gEAAgE;QAChE,MAAM,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAEnC,gEAAgE;QAChE,wEAAwE;QACxE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QAC7C,IAAI,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;YACxD,MAAM,IAAI,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE;gBACjD,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACrC,CAAC,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IAED,uEAAuE;IAC/D,KAAK,CAAC,oBAAoB,CAAC,IAAU,EAAE,SAAS,GAAG,MAAM;QAC/D,MAAM,GAAG,GACP,uFAAuF,CAAC;QAC1F,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;IACpF,CAAC;IAED,KAAK,CAAC,2BAA2B,CAAC,IAAU;QAC1C,kEAAkE;QAClE,qEAAqE;QACrE,EAAE;QACF,mEAAmE;QACnE,qEAAqE;QACrE,oEAAoE;QACpE,sEAAsE;QACtE,yCAAyC;QACzC,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,OAAO,GAAG,SAAS,CAAC,kBAAkB,EAAE,CAAC;YAC/C,IAAI,OAAO,IAAI,OAAO,CAAC,IAAI,EAAE;gBAAE,OAAO,OAAO,CAAC,IAAI,EAAE,CAAC;QACvD,CAAC;QAED,sEAAsE;QACtE,oEAAoE;QACpE,uBAAuB;QACvB,MAAM,UAAU,GAAc;YAC5B,IAAI,CAAC,OAAO,CAAC,wCAAwC,CAAC,CAAC,IAAI,EAAE;YAC7D,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,IAAI,EAAE;YACnC,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC,IAAI,EAAE;SACzC,CAAC;QAEF,KAAK,MAAM,OAAO,IAAI,UAAU,EAAE,CAAC;YACjC,IAAI,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;gBAChE,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;gBACvD,IAAI,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE;oBAAE,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;YAC9C,CAAC;QACH,CAAC;QAED,MAAM,IAAI,uBAAuB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/C,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,IAAU,EAAE,UAAuB,EAAE;QACzD,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC;QAC/C,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,KAAK,CAAC;QAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;QAExC,sEAAsE;QACtE,mEAAmE;QACnE,+DAA+D;QAC/D,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC/B,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC;gBAChC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,KAAc,EAAE,IAAI,EAAE,CAAC,CAAC;gBACxD,IAAI,OAAO,CAAsB,CAAC,OAAO,EAAE,EAAE,CAC3C,UAAU,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,CAAC,CAC1D;aACF,CAAC,CAAC;YACH,IAAI,MAAM,CAAC,IAAI,KAAK,KAAK,IAAI,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;gBAC/D,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YAC5B,CAAC;YACD,kEAAkE;QACpE,CAAC;QAED,iEAAiE;QACjE,mEAAmE;QACnE,qEAAqE;QAErE,uEAAuE;QACvE,MAAM,IAAI,CAAC,iBAAiB,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAEjF,oEAAoE;QACpE,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,EAAE,KAAK,CAAC,CAAC;QACzD,MAAM,IAAI,CAAC,qBAAqB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAEzE,qEAAqE;QACrE,MAAM,MAAM,GAAG,MAAM,eAAe,CAClC,KAAK,IAAI,EAAE;YACT,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,2BAA2B,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;YAC1E,IAAI,qBAAqB,CAAC,IAAI,CAAC;gBAAE,OAAO,EAAE,CAAC;YAC3C,OAAO,IAAI,CAAC;QACd,CAAC,EACD;YACE,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,EAAE,KAAK,CAAC;YACjD,QAAQ;YACR,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,UAAU,EAAE,OAAO,CAAC,UAAU;SAC/B,CACF,CAAC;QAEF,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,oBAAoB,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QACvD,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;;;;;OAQG;IACH,iBAAiB,CAAC,IAAU;QAC1B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,kEAAkE;QAClE,4CAA4C;QAC5C,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;QACnD,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,IAAU;QACtB,MAAM,UAAU,GAAc;YAC5B,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,KAAK,EAAE;YACnC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC,KAAK,EAAE;YACvD,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC,KAAK,EAAE;SACtD,CAAC;QAEF,KAAK,MAAM,OAAO,IAAI,UAAU,EAAE,CAAC;YACjC,IAAI,MAAM,OAAO,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;gBACjD,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;gBAC7C,OAAO;YACT,CAAC;QACH,CAAC;QAED,2CAA2C;QAC3C,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,IAAU;QACvB,MAAM,CAAC,QAAQ,EAAE,OAAO,EAAE,cAAc,EAAE,SAAS,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YACvE,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YACrB,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC;YACjD,IAAI,CAAC,OAAO,CAAC,wCAAwC,CAAC,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;YAC7E,IAAI;iBACD,OAAO,CAAC,0DAA0D,CAAC;iBACnE,KAAK,EAAE;iBACP,SAAS,EAAE;iBACX,KAAK,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC;SACtB,CAAC,CAAC;QAEH,IAAI,UAAU,GAAG,KAAK,CAAC;QACvB,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YAC3B,UAAU,GAAG,IAAI,CAAC;QACpB,CAAC;QAAC,MAAM,CAAC;YACP,UAAU,GAAG,KAAK,CAAC;QACrB,CAAC;QAED,IAAI,mBAAmB,GAAG,CAAC,CAAC;QAC5B,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,2BAA2B,CAAC,IAAI,CAAC,CAAC;YAC1D,mBAAmB,GAAG,IAAI,CAAC,MAAM,CAAC;QACpC,CAAC;QAAC,MAAM,CAAC;YACP,mBAAmB,GAAG,CAAC,CAAC;QAC1B,CAAC;QAED,OAAO;YACL,QAAQ;YACR,UAAU;YACV,eAAe,EAAE,OAAO;YACxB,qBAAqB,EAAE,cAAc;YACrC,eAAe,EAAE,SAAS;YAC1B,mBAAmB;YACnB,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE;SACpB,CAAC;IACJ,CAAC;IAED,yEAAyE;IACjE,eAAe,CAAC,IAAU;QAChC,IAAI,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,CAAC,EAAE,CAAC;YACP,CAAC,GAAG,IAAI,mBAAmB,EAAE,CAAC;YAC9B,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACf,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YAC7B,mEAAmE;YACnE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE;gBACtB,CAAC,EAAE,OAAO,EAAE,CAAC;gBACb,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;gBAC7B,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACjC,CAAC,CAAC,CAAC;QACL,CAAC;QACD,OAAO,CAAC,CAAC;IACX,CAAC;IAEO,KAAK,CAAC,iBAAiB,CAC7B,IAAU,EACV,UAAkC,EAAE;QAEpC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,MAAM,CAAC;QAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;QACxC,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;YAC7B,IAAI,MAAM,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC;gBAAE,OAAO;YACjD,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,qBAAqB,CAAC,IAAU,EAAE,SAAS,GAAG,KAAK;QAC/D,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;QACxC,IAAI,eAAe,GAAG,CAAC,CAAC;QACxB,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;YAC7B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;YACrD,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,+DAA+D;gBAC/D,gEAAgE;gBAChE,4CAA4C;gBAC5C,eAAe,IAAI,CAAC,CAAC;gBACrB,IAAI,eAAe,IAAI,CAAC;oBAAE,OAAO;YACnC,CAAC;iBAAM,CAAC;gBACN,eAAe,GAAG,CAAC,CAAC;YACtB,CAAC;YACD,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,mBAAmB,CAAC,IAAU;QAC1C,qEAAqE;QACrE,oEAAoE;QACpE,kEAAkE;QAClE,kDAAkD;QAClD,MAAM,SAAS,GAAG;YAChB,gDAAgD;YAChD,mCAAmC;YACnC,8BAA8B;YAC9B,4BAA4B;SAC7B,CAAC;QACF,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;YAC5B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;YAC/E,IAAI,OAAO;gBAAE,OAAO,IAAI,CAAC;QAC3B,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;CACF;AAED,SAAS,qBAAqB,CAAC,IAAY;IACzC,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IACtB,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACpB,IAAI,CAAC,CAAC,MAAM,GAAG,EAAE;QAAE,OAAO,KAAK,CAAC;IAChC,oEAAoE;IACpE,MAAM,KAAK,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;IAC9B,OAAO,CACL,KAAK,KAAK,UAAU;QACpB,KAAK,KAAK,WAAW;QACrB,KAAK,KAAK,aAAa;QACvB,KAAK,CAAC,UAAU,CAAC,YAAY,CAAC;QAC9B,KAAK,CAAC,UAAU,CAAC,cAAc,CAAC;QAChC,KAAK,CAAC,UAAU,CAAC,WAAW,CAAC;QAC7B,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC;QACtB,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CACzB,CAAC;AACJ,CAAC"}

package/dist/providers/deepseek.d.ts

@@ -0,0 +1,22 @@
+import type { Locator, Page } from "playwright";
+import type { ChatProvider, ProviderDiagnostics, WaitOptions } from "../core/provider.js";
+/**
+ * DeepSeek (chat.deepseek.com) provider adapter.
+ *
+ * Per RFC §13.2 this is a sibling of ChatGPTAdapter, not a subclass —
+ * they implement the same interface but the selectors and login probes
+ * are different enough that sharing logic would be a footgun.
+ */
+export declare class DeepSeekAdapter implements ChatProvider {
+    readonly name = "deepseek";
+    readonly homeUrl = "https://chat.deepseek.com/";
+    open(page: Page): Promise<void>;
+    isLoggedIn(page: Page): Promise<boolean>;
+    findInput(page: Page): Promise<Locator>;
+    findSendButton(page: Page): Promise<Locator | null>;
+    sendMessage(page: Page, message: string): Promise<void>;
+    extractLastAssistantMessage(page: Page): Promise<string>;
+    waitForResponse(page: Page, options?: WaitOptions): Promise<string>;
+    newChat(page: Page): Promise<void>;
+    diagnose(page: Page): Promise<ProviderDiagnostics>;
+}

package/dist/providers/deepseek.js

@@ -0,0 +1,153 @@
+import { InputNotFoundError, ResponseExtractionError, ResponseTimeoutError, } from "../core/errors.js";
+import { sleep, waitUntilStable } from "../core/response-watcher.js";
+/**
+ * DeepSeek (chat.deepseek.com) provider adapter.
+ *
+ * Per RFC §13.2 this is a sibling of ChatGPTAdapter, not a subclass —
+ * they implement the same interface but the selectors and login probes
+ * are different enough that sharing logic would be a footgun.
+ */
+export class DeepSeekAdapter {
+    name = "deepseek";
+    homeUrl = "https://chat.deepseek.com/";
+    async open(page) {
+        await page.goto(this.homeUrl, { waitUntil: "domcontentloaded" }).catch(() => {
+            return page.goto(this.homeUrl, { waitUntil: "load", timeout: 30_000 });
+        });
+    }
+    async isLoggedIn(page) {
+        // DeepSeek's signed-out state shows a phone/login form. The signed-in
+        // state shows the chat composer (textarea) immediately.
+        const composer = page
+            .locator('textarea[placeholder*="DeepSeek" i], textarea[placeholder*="给 DeepSeek" i], textarea')
+            .first();
+        return await composer.isVisible().catch(() => false);
+    }
+    async findInput(page) {
+        const candidates = [
+            page.locator('textarea[placeholder*="DeepSeek" i]').first(),
+            page.locator('textarea[placeholder*="给 DeepSeek" i]').first(),
+            page.locator('textarea').first(),
+            page.locator('[contenteditable="true"]').first(),
+            page.locator('[role="textbox"]').first(),
+        ];
+        for (const locator of candidates) {
+            if (await locator.isVisible().catch(() => false)) {
+                return locator;
+            }
+        }
+        throw new InputNotFoundError(this.name);
+    }
+    async findSendButton(page) {
+        const candidates = [
+            page.locator('div[role="button"][aria-disabled="false"]').last(),
+            page.locator('button[aria-label*="send" i]').first(),
+            page.locator('button[aria-label*="发送" i]').first(),
+            page.locator('button:has(svg)').last(),
+        ];
+        for (const locator of candidates) {
+            if (await locator.isVisible().catch(() => false)) {
+                return locator;
+            }
+        }
+        return null;
+    }
+    async sendMessage(page, message) {
+        const input = await this.findInput(page);
+        await input.click();
+        const filled = await input.fill(message).then(() => true, () => false);
+        if (!filled) {
+            await page.keyboard.insertText(message);
+        }
+        // DeepSeek accepts Enter for submission; the dedicated send button
+        // sometimes only enables after a small debounce, so Enter is more
+        // reliable as the primary path.
+        await page.keyboard.press("Enter");
+    }
+    async extractLastAssistantMessage(page) {
+        const candidates = [
+            // DeepSeek doesn't expose data-message-author-role consistently,
+            // so we walk the message list and pick the last non-user message.
+            page.locator('div[class*="message"][class*="assistant" i]').last(),
+            page.locator('.markdown, .ds-markdown, .prose').last(),
+            page.locator('main article').last(),
+        ];
+        for (const locator of candidates) {
+            if (await locator.count().then((n) => n > 0).catch(() => false)) {
+                const text = await locator.innerText().catch(() => "");
+                if (text && text.trim())
+                    return text.trim();
+            }
+        }
+        throw new ResponseExtractionError(this.name);
+    }
+    async waitForResponse(page, options = {}) {
+        const timeoutMs = options.timeoutMs ?? 120_000;
+        const stableMs = options.stableMs ?? 2_000;
+        await sleep(500);
+        const stable = await waitUntilStable(() => this.extractLastAssistantMessage(page).catch(() => ""), {
+            timeoutMs,
+            stableMs,
+            signal: options.signal,
+            onProgress: options.onProgress,
+        });
+        if (!stable) {
+            throw new ResponseTimeoutError(this.name, timeoutMs);
+        }
+        return stable;
+    }
+    async newChat(page) {
+        const candidates = [
+            page.getByRole("button", { name: /new chat|新对话|新建对话/i }).first(),
+            page.getByRole("link", { name: /new chat|新对话/i }).first(),
+        ];
+        for (const locator of candidates) {
+            if (await locator.isVisible().catch(() => false)) {
+                await locator.click().catch(() => undefined);
+                return;
+            }
+        }
+        await this.open(page);
+    }
+    async diagnose(page) {
+        const [loggedIn, sendBtn] = await Promise.all([
+            this.isLoggedIn(page),
+            this.findSendButton(page).then((l) => l !== null),
+        ]);
+        let inputFound = false;
+        try {
+            await this.findInput(page);
+            inputFound = true;
+        }
+        catch {
+            inputFound = false;
+        }
+        let assistantMessageCount = 0;
+        try {
+            assistantMessageCount = await page
+                .locator('.markdown, .ds-markdown, .prose')
+                .count();
+        }
+        catch {
+            assistantMessageCount = 0;
+        }
+        let lastAssistantLength = 0;
+        try {
+            const text = await this.extractLastAssistantMessage(page);
+            lastAssistantLength = text.length;
+        }
+        catch {
+            lastAssistantLength = 0;
+        }
+        return {
+            loggedIn,
+            inputFound,
+            sendButtonFound: sendBtn,
+            assistantMessageCount,
+            stopButtonFound: false,
+            lastAssistantLength,
+            pageUrl: page.url(),
+        };
+    }
+}
+//# sourceMappingURL=deepseek.js.map

package/dist/providers/deepseek.js.map

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

package/dist/providers/gemini.d.ts

@@ -0,0 +1,102 @@
+import type { Locator, Page } from "playwright";
+import type { ChatProvider, ProviderDiagnostics, WaitOptions } from "../core/provider.js";
+/**
+ * Google AI Studio (aistudio.google.com/prompts/new_chat) provider
+ * adapter.
+ *
+ * This is what users colloquially mean by "Gemini" — the free web-chat
+ * interface that lets you talk to Gemini models without an API key
+ * (the "No API key selected" button on the page is a separate, optional
+ * feature for users who want to use their own key; the page is fully
+ * usable without it). chat-web does NOT target gemini.google.com — in
+ * practice many networks block that domain while AI Studio reaches
+ * fine, and AI Studio is the surface users actually expect.
+ *
+ * Observed structure (2026-05):
+ *   - Composer: `<ms-prompt-box>` (Angular Material) wrapping a textarea
+ *     with `aria="Enter a prompt"`, `placeholder="Start typing..."`.
+ *   - Run button: NO aria-label; visible text is "Run" + two Material
+ *     icon font ligatures (`keyboard_command_key`, `keyboard_return`).
+ *     `type="submit"`. Use `getByRole("button", { name: /^Run$/ })`.
+ *   - Stop: the same submit button flips to a stop state; its
+ *     aria-label changes to include "Stop". Detect via aria-label
+ *     substring.
+ *   - Assistant turn: `<ms-chat-turn>` containing a
+ *     `.chat-turn-container.model` with `.turn-content`. innerText
+ *     leaks "Model HH:MM AM/PM" headers and Material icon font
+ *     ligatures (`edit`, `more_vert`, `error`, ...) as plain text —
+ *     stripped by {@link stripChromeFromTurn}.
+ *   - Conversation id: `/prompts/{slug}` once the prompt is saved; the
+ *     placeholder `/prompts/new_chat` does NOT count.
+ */
+export declare class GeminiAdapter implements ChatProvider {
+    readonly name = "gemini";
+    readonly homeUrl = "https://aistudio.google.com/prompts/new_chat";
+    open(page: Page): Promise<void>;
+    isLoggedIn(page: Page): Promise<boolean>;
+    findInput(page: Page): Promise<Locator>;
+    findSendButton(page: Page): Promise<Locator | null>;
+    sendMessage(page: Page, message: string): Promise<void>;
+    /**
+     * AI Studio shows a "Grounding with Google Search" chip on every new
+     * chat by default. The chip has a close (×) button with
+     * `aria-label="Remove Grounding with Google Search"`. Clicking it
+     * disables the grounding step for this conversation — and removes a
+     * silent hang point on networks that can't reach Google Search.
+     */
+    private disableGroundingWithGoogleSearch;
+    extractLastAssistantMessage(page: Page): Promise<string>;
+    waitForResponse(page: Page, options?: WaitOptions): Promise<string>;
+    /**
+     * Inspect the freshly-extracted "assistant" text and raise a typed
+     * error if it's really an upstream failure that AI Studio just
+     * rendered in the model turn slot.
+     *
+     * Known patterns:
+     *   - "An internal error has occurred."  → typically quota /
+     *     server-side error (the user has reproduced this when their
+     *     free-tier daily quota was exhausted).
+     *   - "Failed to generate content: permission denied."  → API key
+     *     missing or model not enabled on the account.
+     *
+     * The actual root cause for "internal error" varies (preview model
+     * outage, daily quota cap, region restriction, transient backend
+     * error). We don't try to disambiguate further — the hint just lists
+     * the common ones so the user knows where to look.
+     */
+    private throwIfKnownUpstreamError;
+    private detectFailureCause;
+    /**
+     * Heuristic: are we stuck in the WAA-blocked state where AI Studio
+     * never moves past "Thinking" and the URL still says new_chat? Used
+     * to surface a clearer error than a generic timeout.
+     */
+    private looksAutomationBlocked;
+    /**
+     * AI Studio's per-prompt URL is `/prompts/{slug}` after the prompt is
+     * saved. Until then the URL stays at `/prompts/new_chat` (no
+     * conversation id).
+     */
+    getConversationId(page: Page): string | null;
+    newChat(page: Page): Promise<void>;
+    diagnose(page: Page): Promise<ProviderDiagnostics>;
+    private pressRunShortcut;
+    private waitForComposerReady;
+    private waitForStopButton;
+    private waitForStopButtonGone;
+    private isStopButtonVisible;
+}
+/**
+ * Strip the UI chrome that leaks into `innerText` on AI Studio model
+ * turns. Removes:
+ *   - The "Model HH:MM AM/PM" turn header
+ *   - Single-line Material icon font ligatures (rendered as plain text
+ *     words because the icon-font substitution doesn't affect text
+ *     extraction): edit, more_vert, error, content_copy, thumb_up,
+ *     thumb_down, refresh, delete, close, expand_more, expand_less,
+ *     code, play_arrow, stop, menu.
+ *
+ * Does NOT remove lines where the same word appears INSIDE a sentence
+ * (e.g. "an error occurred during parsing" stays as-is).
+ */
+export declare function stripChromeFromTurn(text: string): string;