@love-moon/chat-web 0.3.2

package/dist/core/response-watcher.js

@@ -0,0 +1,70 @@
+/**
+ * Watch a streaming source (typically the last assistant message) until its
+ * text stops mutating for `stableMs` consecutive milliseconds, or the
+ * `timeoutMs` budget is exhausted.
+ *
+ * `getText` should return "" (or throw) while the message doesn't exist yet;
+ * we treat both cases the same and keep polling.
+ *
+ * RFC §10 — also recommends combining this with "stop button vanished"
+ * and "send button re-enabled"; those checks live in the provider adapters
+ * because the selectors are provider-specific.
+ */
+export async function waitUntilStable(getText, options = {}) {
+    const stableMs = options.stableMs ?? 2_000;
+    const timeoutMs = options.timeoutMs ?? 120_000;
+    const pollIntervalMs = options.pollIntervalMs ?? 300;
+    const deadline = Date.now() + timeoutMs;
+    let last = "";
+    let stableSince = Date.now();
+    let everSeen = false;
+    while (true) {
+        if (options.signal?.aborted) {
+            throw new DOMException("Aborted", "AbortError");
+        }
+        let current = "";
+        try {
+            current = await getText();
+        }
+        catch {
+            current = "";
+        }
+        if (current !== last) {
+            last = current;
+            stableSince = Date.now();
+            if (current) {
+                everSeen = true;
+                options.onProgress?.(current);
+            }
+        }
+        const sinceChange = Date.now() - stableSince;
+        if (everSeen && sinceChange >= stableMs) {
+            return last;
+        }
+        if (Date.now() > deadline) {
+            // Return whatever we have rather than throwing — the caller (provider
+            // adapter or `ask` flow) decides whether to error or surface partial.
+            return last;
+        }
+        await sleep(pollIntervalMs);
+    }
+}
+export function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Convenience: wait until the assistant message count grows past a baseline.
+ * Useful right after pressing Enter, so we know the streaming has started.
+ */
+export async function waitForResponseStart(page, selector, baseline, options = {}) {
+    const timeoutMs = options.timeoutMs ?? 30_000;
+    const pollIntervalMs = options.pollIntervalMs ?? 200;
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        const count = await page.locator(selector).count().catch(() => 0);
+        if (count > baseline)
+            return;
+        await sleep(pollIntervalMs);
+    }
+}
+//# sourceMappingURL=response-watcher.js.map

package/dist/core/response-watcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-watcher.js","sourceRoot":"","sources":["../../src/core/response-watcher.ts"],"names":[],"mappings":"AAeA;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,OAA8B,EAC9B,UAAkC,EAAE;IAEpC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,KAAK,CAAC;IAC3C,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC;IAC/C,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,GAAG,CAAC;IAErD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;IACxC,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,IAAI,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,IAAI,QAAQ,GAAG,KAAK,CAAC;IAErB,OAAO,IAAI,EAAE,CAAC;QACZ,IAAI,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;YAC5B,MAAM,IAAI,YAAY,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;QAClD,CAAC;QAED,IAAI,OAAO,GAAG,EAAE,CAAC;QACjB,IAAI,CAAC;YACH,OAAO,GAAG,MAAM,OAAO,EAAE,CAAC;QAC5B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,GAAG,EAAE,CAAC;QACf,CAAC;QAED,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACrB,IAAI,GAAG,OAAO,CAAC;YACf,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACzB,IAAI,OAAO,EAAE,CAAC;gBACZ,QAAQ,GAAG,IAAI,CAAC;gBAChB,OAAO,CAAC,UAAU,EAAE,CAAC,OAAO,CAAC,CAAC;YAChC,CAAC;QACH,CAAC;QAED,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,WAAW,CAAC;QAC7C,IAAI,QAAQ,IAAI,WAAW,IAAI,QAAQ,EAAE,CAAC;YACxC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;YAC1B,sEAAsE;YACtE,sEAAsE;YACtE,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,KAAK,CAAC,cAAc,CAAC,CAAC;IAC9B,CAAC;AACH,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,EAAU;IAC9B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,IAAU,EACV,QAAgB,EAChB,QAAgB,EAChB,UAA2D,EAAE;IAE7D,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,MAAM,CAAC;IAC9C,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,GAAG,CAAC;IACrD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;IAExC,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;QAClE,IAAI,KAAK,GAAG,QAAQ;YAAE,OAAO;QAC7B,MAAM,KAAK,CAAC,cAAc,CAAC,CAAC;IAC9B,CAAC;AACH,CAAC"}

package/dist/core/snapshot.d.ts

@@ -0,0 +1,38 @@
+import type { Locator, Page } from "playwright";
+/**
+ * Lightweight snapshot of the page's interactive elements, modelled after
+ * the `ref` concept from Stagehand / agent-browser (RFC §11).
+ *
+ * Unlike a full accessibility tree, this is a flat list of element
+ * descriptors with stable, opaque refs (`e1`, `e2`, ...) that the rest of
+ * the system can use to fill / click / extract. The refs survive the
+ * lifetime of a Page session but are not persisted.
+ */
+export interface SnapshotEntry {
+    ref: string;
+    tag: string;
+    role: string | null;
+    ariaLabel: string | null;
+    placeholder: string | null;
+    type: string | null;
+    visible: boolean;
+    editable: boolean;
+    enabled: boolean;
+    text: string;
+    selector: string;
+}
+export interface PageSnapshot {
+    url: string;
+    takenAt: string;
+    entries: SnapshotEntry[];
+}
+/**
+ * Collect a coarse snapshot of "things a user / agent might interact with"
+ * on the current page. The set of selectors is intentionally simple — it's
+ * fed to {@link locator-score} for ranking, not pretty-printed verbatim.
+ */
+export declare function takeSnapshot(page: Page): Promise<PageSnapshot>;
+/** Convert a snapshot entry back into a Playwright Locator. */
+export declare function locatorFromEntry(page: Page, entry: SnapshotEntry): Locator;
+/** Human-readable rendering, useful for `chat-web doctor --snapshot`. */
+export declare function formatSnapshot(snap: PageSnapshot): string;

package/dist/core/snapshot.js

@@ -0,0 +1,137 @@
+/**
+ * Collect a coarse snapshot of "things a user / agent might interact with"
+ * on the current page. The set of selectors is intentionally simple — it's
+ * fed to {@link locator-score} for ranking, not pretty-printed verbatim.
+ */
+export async function takeSnapshot(page) {
+    // We query JS-side so we don't have to round-trip 100s of locator calls.
+    const raw = await page.evaluate(() => {
+        const SELECTORS = [
+            // contenteditable first — ChatGPT's ProseMirror has both a fallback
+            // textarea AND the real contenteditable; the contenteditable is what
+            // the user actually types into.
+            '[contenteditable="true"]',
+            '[role="textbox"]',
+            "#prompt-textarea",
+            "textarea",
+            "input[type=text]",
+            "button",
+            '[role="button"]',
+            "[data-message-author-role]",
+            "main article",
+            ".markdown",
+            ".prose",
+        ];
+        const seen = new Set();
+        const out = [];
+        function cssPath(el) {
+            const parts = [];
+            let cur = el;
+            while (cur && cur.nodeType === 1 && parts.length < 6) {
+                const node = cur;
+                let part = node.tagName.toLowerCase();
+                if (node.id) {
+                    part += `#${node.id}`;
+                    parts.unshift(part);
+                    break;
+                }
+                const cls = (node.getAttribute("class") || "")
+                    .split(/\s+/)
+                    .filter(Boolean)
+                    .slice(0, 2)
+                    .map((c) => `.${CSS.escape(c)}`)
+                    .join("");
+                if (cls)
+                    part += cls;
+                const parentEl = node.parentElement;
+                if (parentEl) {
+                    const siblings = Array.from(parentEl.children).filter((s) => s.tagName === node.tagName);
+                    if (siblings.length > 1) {
+                        const idx = siblings.indexOf(node) + 1;
+                        part += `:nth-of-type(${idx})`;
+                    }
+                }
+                parts.unshift(part);
+                cur = parentEl;
+            }
+            return parts.join(" > ");
+        }
+        function isVisible(el) {
+            const rect = el.getBoundingClientRect();
+            if (rect.width === 0 || rect.height === 0)
+                return false;
+            const style = window.getComputedStyle(el);
+            if (style.visibility === "hidden" || style.display === "none")
+                return false;
+            if (parseFloat(style.opacity) === 0)
+                return false;
+            return true;
+        }
+        for (const sel of SELECTORS) {
+            const nodes = document.querySelectorAll(sel);
+            nodes.forEach((node) => {
+                if (seen.has(node))
+                    return;
+                seen.add(node);
+                const html = node;
+                out.push({
+                    tag: html.tagName.toLowerCase(),
+                    role: html.getAttribute("role"),
+                    ariaLabel: html.getAttribute("aria-label"),
+                    placeholder: html.getAttribute("placeholder"),
+                    type: html.getAttribute("type"),
+                    visible: isVisible(html),
+                    editable: html.tagName === "TEXTAREA" ||
+                        (html.tagName === "INPUT" && html.getAttribute("type") !== "hidden") ||
+                        html.isContentEditable,
+                    enabled: !html.disabled,
+                    text: (html.innerText || html.textContent || "").trim().slice(0, 240),
+                    selector: cssPath(html),
+                });
+            });
+        }
+        return out;
+    });
+    const entries = raw.map((r, i) => ({
+        ref: `e${i + 1}`,
+        tag: String(r.tag ?? ""),
+        role: r.role ?? null,
+        ariaLabel: r.ariaLabel ?? null,
+        placeholder: r.placeholder ?? null,
+        type: r.type ?? null,
+        visible: Boolean(r.visible),
+        editable: Boolean(r.editable),
+        enabled: Boolean(r.enabled),
+        text: String(r.text ?? ""),
+        selector: String(r.selector ?? ""),
+    }));
+    return {
+        url: page.url(),
+        takenAt: new Date().toISOString(),
+        entries,
+    };
+}
+/** Convert a snapshot entry back into a Playwright Locator. */
+export function locatorFromEntry(page, entry) {
+    return page.locator(entry.selector);
+}
+/** Human-readable rendering, useful for `chat-web doctor --snapshot`. */
+export function formatSnapshot(snap) {
+    const lines = [`URL: ${snap.url}`, `At:  ${snap.takenAt}`, ""];
+    for (const e of snap.entries) {
+        const bits = [
+            `[${e.ref}]`,
+            e.tag,
+            e.role ? `role=${e.role}` : null,
+            e.ariaLabel ? `aria=${JSON.stringify(e.ariaLabel)}` : null,
+            e.placeholder ? `placeholder=${JSON.stringify(e.placeholder)}` : null,
+            e.visible ? "visible" : "hidden",
+            e.editable ? "editable" : null,
+            e.enabled ? "enabled" : "disabled",
+            e.text ? `text=${JSON.stringify(e.text.slice(0, 60))}` : null,
+        ].filter(Boolean);
+        lines.push(bits.join(" "));
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=snapshot.js.map

package/dist/core/snapshot.js.map

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

package/dist/core/sse-parser.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Minimal Server-Sent Events parser.
+ *
+ * Implements the subset of the WHATWG EventSource spec that ChatGPT,
+ * DeepSeek and similar streaming endpoints actually use:
+ *   - Events separated by a blank line.
+ *   - `data:` fields concatenated with "\n" within an event.
+ *   - `event:` and `id:` fields read into the corresponding properties.
+ *   - Lines starting with ":" are comments and discarded.
+ *   - A single leading space after the field colon is stripped.
+ *
+ * Doesn't handle retry hints (`retry:`) or BOM stripping — neither matters
+ * for our consumers.
+ */
+export interface SSEEvent {
+    event?: string;
+    data: string;
+    id?: string;
+}
+export declare function parseSSE(text: string): SSEEvent[];

package/dist/core/sse-parser.js

@@ -0,0 +1,49 @@
+export function parseSSE(text) {
+    const events = [];
+    // Normalise newlines so the blank-line split is robust against \r\n vs \n.
+    const normalised = text.replace(/\r\n?/g, "\n");
+    for (const block of normalised.split(/\n\n+/)) {
+        const ev = parseBlock(block);
+        if (ev)
+            events.push(ev);
+    }
+    return events;
+}
+function parseBlock(block) {
+    if (!block.trim())
+        return null;
+    const ev = { data: "" };
+    const dataLines = [];
+    for (const rawLine of block.split("\n")) {
+        if (!rawLine)
+            continue;
+        if (rawLine.startsWith(":"))
+            continue; // comment
+        const colon = rawLine.indexOf(":");
+        const field = colon === -1 ? rawLine : rawLine.slice(0, colon);
+        let value = colon === -1 ? "" : rawLine.slice(colon + 1);
+        if (value.startsWith(" "))
+            value = value.slice(1);
+        switch (field) {
+            case "data":
+                dataLines.push(value);
+                break;
+            case "event":
+                ev.event = value;
+                break;
+            case "id":
+                ev.id = value;
+                break;
+            default:
+                // ignore unknown fields (retry, etc.)
+                break;
+        }
+    }
+    if (dataLines.length === 0) {
+        // An event with no data line is meaningless to us; drop it.
+        return null;
+    }
+    ev.data = dataLines.join("\n");
+    return ev;
+}
+//# sourceMappingURL=sse-parser.js.map

package/dist/core/sse-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse-parser.js","sourceRoot":"","sources":["../../src/core/sse-parser.ts"],"names":[],"mappings":"AAoBA,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,MAAM,MAAM,GAAe,EAAE,CAAC;IAC9B,2EAA2E;IAC3E,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAChD,KAAK,MAAM,KAAK,IAAI,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9C,MAAM,EAAE,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;QAC7B,IAAI,EAAE;YAAE,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC1B,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,UAAU,CAAC,KAAa;IAC/B,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE;QAAE,OAAO,IAAI,CAAC;IAC/B,MAAM,EAAE,GAAa,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;IAClC,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACxC,IAAI,CAAC,OAAO;YAAE,SAAS;QACvB,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS,CAAC,UAAU;QACjD,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACnC,MAAM,KAAK,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QAC/D,IAAI,KAAK,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QACzD,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAClD,QAAQ,KAAK,EAAE,CAAC;YACd,KAAK,MAAM;gBACT,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBACtB,MAAM;YACR,KAAK,OAAO;gBACV,EAAE,CAAC,KAAK,GAAG,KAAK,CAAC;gBACjB,MAAM;YACR,KAAK,IAAI;gBACP,EAAE,CAAC,EAAE,GAAG,KAAK,CAAC;gBACd,MAAM;YACR;gBACE,sCAAsC;gBACtC,MAAM;QACV,CAAC;IACH,CAAC;IACD,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,4DAA4D;QAC5D,OAAO,IAAI,CAAC;IACd,CAAC;IACD,EAAE,CAAC,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/B,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Public entry point for `@love-moon/chat-web`.
+ *
+ * The primary SDK surface is `ChatSession` — multi-turn dialogue against
+ * a persistent browser profile. CLI users get `login`, `doctor`, `info`;
+ * everything else (ask, daemon, ...) lives at the SDK level.
+ *
+ * @example
+ *   import { ChatSession, registerBuiltinProviders } from "@love-moon/chat-web";
+ *
+ *   registerBuiltinProviders();
+ *   const session = await ChatSession.open("chatgpt");
+ *   try {
+ *     const r1 = await session.send("Hello");
+ *     const r2 = await session.send("Tell me more");
+ *     console.log(r1.response, r2.response);
+ *   } finally {
+ *     await session.close();
+ *   }
+ */
+export { ChatSession, withSession, type SendOptions, type SendResult, type SessionOpenOptions, } from "./session.js";
+export * from "./core/provider.js";
+export * from "./providers/index.js";
+export * from "./core/errors.js";
+export * from "./core/profile-manager.js";
+export * from "./core/browser.js";
+export * from "./core/install-chromium.js";
+export * from "./core/paths.js";
+export * from "./core/response-watcher.js";
+export * from "./core/snapshot.js";
+export * from "./core/locator-score.js";
+export * from "./core/logger.js";
+export * from "./commands/index.js";

package/dist/index.js

@@ -0,0 +1,40 @@
+/**
+ * Public entry point for `@love-moon/chat-web`.
+ *
+ * The primary SDK surface is `ChatSession` — multi-turn dialogue against
+ * a persistent browser profile. CLI users get `login`, `doctor`, `info`;
+ * everything else (ask, daemon, ...) lives at the SDK level.
+ *
+ * @example
+ *   import { ChatSession, registerBuiltinProviders } from "@love-moon/chat-web";
+ *
+ *   registerBuiltinProviders();
+ *   const session = await ChatSession.open("chatgpt");
+ *   try {
+ *     const r1 = await session.send("Hello");
+ *     const r2 = await session.send("Tell me more");
+ *     console.log(r1.response, r2.response);
+ *   } finally {
+ *     await session.close();
+ *   }
+ */
+// Primary session API.
+export { ChatSession, withSession, } from "./session.js";
+// Provider plumbing.
+export * from "./core/provider.js";
+export * from "./providers/index.js";
+// Supporting types & utilities — exposed because SDK consumers occasionally
+// need them (custom providers, custom snapshots, custom error handling, ...).
+export * from "./core/errors.js";
+export * from "./core/profile-manager.js";
+export * from "./core/browser.js";
+export * from "./core/install-chromium.js";
+export * from "./core/paths.js";
+export * from "./core/response-watcher.js";
+export * from "./core/snapshot.js";
+export * from "./core/locator-score.js";
+export * from "./core/logger.js";
+// CLI commands as SDK functions, in case callers want to drive them
+// programmatically (e.g. a UI that runs doctor and renders the report).
+export * from "./commands/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,uBAAuB;AACvB,OAAO,EACL,WAAW,EACX,WAAW,GAIZ,MAAM,cAAc,CAAC;AAEtB,qBAAqB;AACrB,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AAErC,4EAA4E;AAC5E,8EAA8E;AAC9E,cAAc,kBAAkB,CAAC;AACjC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iBAAiB,CAAC;AAChC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AAEjC,oEAAoE;AACpE,wEAAwE;AACxE,cAAc,qBAAqB,CAAC"}

package/dist/providers/chatgpt-sse-collector.d.ts

@@ -0,0 +1,76 @@
+import type { Page } from "playwright";
+/**
+ * URL pattern for ChatGPT's streaming conversation endpoint. The exact
+ * path has shifted historically (`/backend-api/conversation`,
+ * `/backend-api/f/conversation`, `/backend-api/lat/r/conversation`, ...);
+ * `conversation` has stayed as the final path segment in every form.
+ *
+ * NOTE: must NOT match the sibling JSON endpoints `/conversation/init`,
+ * `/conversation/prepare`, `/conversation/textdocs/...` — those land
+ * before the real SSE response and would otherwise be captured first.
+ */
+export declare const CHATGPT_CONVERSATION_URL: RegExp;
+/**
+ * Listens to ChatGPT's streaming conversation responses and reconstructs
+ * the assistant's original markdown (code fences, list prefixes, table
+ * pipes, link URLs — everything that `innerText` would have stripped).
+ *
+ * Usage:
+ *   const collector = new ChatGPTSSECollector();
+ *   collector.attach(page);
+ *   …
+ *   const wait = collector.beginTurn();
+ *   await adapter.sendMessage(page, "...");
+ *   const markdown = await wait; // resolves to the assistant's raw markdown
+ *
+ * Robust to multiple SSE formats observed in the wild:
+ *   - Full message snapshots: `{message: {author, content: {parts}, status}, ...}`
+ *   - v1 delta encoding: `{p, o: "append", v}` followed by `{v}` shorthand frames
+ *   - Terminators: `[DONE]` or `{"type": "message_stream_complete"}`
+ */
+export declare class ChatGPTSSECollector {
+    private detach?;
+    private pendingTurn;
+    private currentTurn;
+    /** Attach to a Playwright Page. Idempotent. */
+    attach(page: Page): void;
+    dispose(): void;
+    /**
+     * Start watching for the next conversation response. Returns a promise
+     * that resolves to the accumulated markdown once that response finishes
+     * streaming (or rejects on the supplied timeout).
+     */
+    beginTurn(options?: {
+        timeoutMs?: number;
+    }): Promise<string>;
+    /**
+     * Assistant text accumulated for the CURRENT turn only.
+     *
+     * Returns "" until SSE events for the current turn arrive. NEVER returns
+     * text from a previous turn — that would leak stale answers into the
+     * next prompt's extraction fallback. Bug fixed in this method: an
+     * earlier implementation also returned the latest *finalized* turn's
+     * text, which made the DOM-fallback path silently substitute the prior
+     * turn's reply when the current turn's SSE was empty / racy.
+     */
+    getCurrentTurnText(): string;
+    /**
+     * @deprecated Use {@link getCurrentTurnText}. Kept as a hard error so
+     * callers fail loudly rather than silently consume stale data.
+     */
+    getLastAssistantText(): string;
+    /** Has the current turn's SSE stream ended? */
+    isStreamComplete(): boolean;
+    /**
+     * Apply a raw SSE body directly. Exposed for tests and for callers that
+     * want to feed in a recorded transcript.
+     */
+    ingest(body: string): void;
+    private maybeConsume;
+    private applyEvent;
+    private applyDelta;
+    private finishPendingTurn;
+    private finishPendingTurnWithError;
+    /** Best-effort assistant text from the current turn's snapshots. */
+    private bestAssistantText;
+}