@love-moon/chat-web 0.3.2

package/dist/providers/chatgpt-sse-collector.js

@@ -0,0 +1,298 @@
+import { parseSSE } from "../core/sse-parser.js";
+/**
+ * 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 const CHATGPT_CONVERSATION_URL = /\/backend-api\/(?:[^/]+\/)*conversation(?:\?|$)/;
+/**
+ * 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 class ChatGPTSSECollector {
+    detach;
+    pendingTurn;
+    currentTurn = freshTurn();
+    /** Attach to a Playwright Page. Idempotent. */
+    attach(page) {
+        if (this.detach)
+            return;
+        const handler = (response) => {
+            void this.maybeConsume(response);
+        };
+        page.on("response", handler);
+        this.detach = () => page.off("response", handler);
+    }
+    dispose() {
+        this.detach?.();
+        this.detach = undefined;
+        if (this.pendingTurn?.timer)
+            clearTimeout(this.pendingTurn.timer);
+        this.pendingTurn = undefined;
+    }
+    /**
+     * 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 = {}) {
+        // Reject any prior unresolved turn first — we only track one in flight.
+        if (this.pendingTurn) {
+            this.pendingTurn.reject(new Error("Superseded by a new turn"));
+            if (this.pendingTurn.timer)
+                clearTimeout(this.pendingTurn.timer);
+        }
+        this.currentTurn = freshTurn();
+        const timeoutMs = options.timeoutMs ?? 180_000;
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                if (this.pendingTurn) {
+                    const partial = this.bestAssistantText();
+                    this.pendingTurn = undefined;
+                    // Resolve with whatever we got rather than rejecting — callers
+                    // can decide to fall back. Empty string means "no SSE captured".
+                    resolve(partial);
+                }
+            }, timeoutMs);
+            this.pendingTurn = { resolve, reject, captured: false, timer };
+        });
+    }
+    /**
+     * 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() {
+        return this.bestAssistantText();
+    }
+    /**
+     * @deprecated Use {@link getCurrentTurnText}. Kept as a hard error so
+     * callers fail loudly rather than silently consume stale data.
+     */
+    getLastAssistantText() {
+        throw new Error("ChatGPTSSECollector.getLastAssistantText() was removed; use getCurrentTurnText() — it never returns stale text from a prior turn.");
+    }
+    /** Has the current turn's SSE stream ended? */
+    isStreamComplete() {
+        return this.currentTurn.streamComplete;
+    }
+    /**
+     * Apply a raw SSE body directly. Exposed for tests and for callers that
+     * want to feed in a recorded transcript.
+     */
+    ingest(body) {
+        const events = parseSSE(body);
+        for (const ev of events)
+            this.applyEvent(ev);
+        this.currentTurn.streamComplete = true;
+        this.finishPendingTurn();
+    }
+    async maybeConsume(response) {
+        if (!this.pendingTurn || this.pendingTurn.captured)
+            return;
+        const url = response.url();
+        if (!CHATGPT_CONVERSATION_URL.test(url))
+            return;
+        if (response.request().method() !== "POST")
+            return;
+        // Only the streaming reply matters. ChatGPT's sibling POSTs to the
+        // same path family (`/conversation/init`, `/conversation/prepare`)
+        // return `application/json` and would otherwise race us to claim the
+        // pendingTurn before the real `text/event-stream` arrives.
+        const contentType = response.headers()["content-type"] ?? "";
+        if (!contentType.includes("event-stream"))
+            return;
+        // Claim this response so concurrent matches don't double-process.
+        this.pendingTurn.captured = true;
+        let body;
+        try {
+            // `response.finished()` resolves only after the entire body has been
+            // fetched (the network-level "request finished" signal). For chunked
+            // SSE this is non-trivial: the `response` event fires when headers
+            // arrive, but the body keeps streaming. Without this wait, certain
+            // Playwright builds let `response.text()` return whatever was
+            // buffered at handler-time — usually a partial SSE that cuts the
+            // assistant reply mid-token.
+            await response.finished().catch(() => undefined);
+            body = await response.text();
+        }
+        catch (err) {
+            // Network aborted etc. Don't reject — let the caller fall back.
+            this.finishPendingTurnWithError(err);
+            return;
+        }
+        this.ingest(body);
+    }
+    applyEvent(ev) {
+        this.currentTurn.rawEvents.push(ev);
+        const raw = ev.data.trim();
+        if (raw === "[DONE]") {
+            this.currentTurn.streamComplete = true;
+            return;
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(raw);
+        }
+        catch {
+            // delta_encoding marker: `event: delta_encoding\ndata: "v1"`. The
+            // bare-string data isn't valid as a top-level JSON value in our
+            // pipeline (it parses but doesn't carry payload), so ignore quietly.
+            return;
+        }
+        if (!parsed || typeof parsed !== "object")
+            return;
+        const obj = parsed;
+        // Case 1: full message snapshot.
+        if (isMessageEnvelope(obj)) {
+            const msg = obj.message;
+            const id = String(msg.id ?? `snap-${this.currentTurn.messages.size}`);
+            const role = (msg.author?.role ?? "");
+            const content = msg.content;
+            const rawParts = Array.isArray(content?.parts) ? content.parts : [];
+            const parts = rawParts.map((p) => (typeof p === "string" ? p : ""));
+            const status = String(msg.status ?? "in_progress");
+            this.currentTurn.messages.set(id, { parts, status, authorRole: role });
+            this.currentTurn.lastDeltaTargetId = id;
+            if (status === "finished_successfully" && role === "assistant") {
+                // Don't set streamComplete here — a later [DONE] is the real signal.
+            }
+            return;
+        }
+        // Case 2: terminator frame.
+        if (obj.type === "message_stream_complete") {
+            this.currentTurn.streamComplete = true;
+            return;
+        }
+        // Case 3: v1 delta encoding.
+        if ("v" in obj) {
+            this.applyDelta(obj);
+            return;
+        }
+        // Case 4: anything else (heartbeats, moderation hints, …) — ignore.
+    }
+    applyDelta(obj) {
+        const path = typeof obj.p === "string" ? obj.p : this.currentTurn.lastDeltaPath;
+        const op = typeof obj.o === "string" ? obj.o : this.currentTurn.lastDeltaOp ?? "append";
+        if (path !== undefined)
+            this.currentTurn.lastDeltaPath = path;
+        this.currentTurn.lastDeltaOp = op;
+        // PATCH first: ChatGPT delivers the message's CLOSING tokens (the
+        // final "```", the status flip to "finished_successfully", end_turn,
+        // metadata, ...) inside one wrapper frame:
+        //   {"p":"", "o":"patch", "v":[ {p,o,v}, {p,o,v}, ... ]}
+        // The wrapper's own `p` is empty, so we MUST recurse before we
+        // bail on the parts-path check below — otherwise the closing
+        // backticks of code blocks (and any trailing content) get dropped.
+        if (op === "patch" && Array.isArray(obj.v)) {
+            for (const sub of obj.v) {
+                if (sub && typeof sub === "object")
+                    this.applyDelta(sub);
+            }
+            return;
+        }
+        // Beyond patches, we only care about deltas that mutate assistant
+        // message text. ChatGPT uses paths shaped like
+        // "/message/content/parts/0".
+        const partMatch = path?.match(/parts\/(\d+)/);
+        if (!partMatch)
+            return;
+        const idx = parseInt(partMatch[1], 10);
+        // Identify the target message. v1 delta frames often omit the id, in
+        // which case the prior snapshot's id is the active one.
+        const id = this.currentTurn.lastDeltaTargetId ?? "__current";
+        let snap = this.currentTurn.messages.get(id);
+        if (!snap) {
+            snap = { parts: [], status: "in_progress", authorRole: "assistant" };
+            this.currentTurn.messages.set(id, snap);
+        }
+        while (snap.parts.length <= idx)
+            snap.parts.push("");
+        const v = obj.v;
+        if (op === "append") {
+            const piece = typeof v === "string" ? v : "";
+            snap.parts[idx] = (snap.parts[idx] ?? "") + piece;
+        }
+        else if (op === "replace") {
+            const piece = typeof v === "string" ? v : "";
+            snap.parts[idx] = piece;
+        }
+    }
+    finishPendingTurn() {
+        if (!this.pendingTurn)
+            return;
+        const text = this.bestAssistantText();
+        if (this.pendingTurn.timer)
+            clearTimeout(this.pendingTurn.timer);
+        const { resolve } = this.pendingTurn;
+        this.pendingTurn = undefined;
+        resolve(text);
+    }
+    finishPendingTurnWithError(_err) {
+        if (!this.pendingTurn)
+            return;
+        if (this.pendingTurn.timer)
+            clearTimeout(this.pendingTurn.timer);
+        const { resolve } = this.pendingTurn;
+        this.pendingTurn = undefined;
+        // Surface as empty so the caller falls back to innerText extraction.
+        resolve("");
+    }
+    /** Best-effort assistant text from the current turn's snapshots. */
+    bestAssistantText() {
+        // Prefer the most recently-seen finished assistant message; fall back
+        // to whatever's most recent in any status.
+        let lastFinished;
+        let lastAny;
+        for (const snap of this.currentTurn.messages.values()) {
+            if (snap.authorRole !== "assistant")
+                continue;
+            lastAny = snap;
+            if (snap.status === "finished_successfully")
+                lastFinished = snap;
+        }
+        const target = lastFinished ?? lastAny;
+        if (!target)
+            return "";
+        return target.parts.join("");
+    }
+}
+function freshTurn() {
+    return {
+        messages: new Map(),
+        streamComplete: false,
+        rawEvents: [],
+    };
+}
+function isMessageEnvelope(obj) {
+    const msg = obj.message;
+    if (!msg || typeof msg !== "object")
+        return false;
+    const author = msg.author;
+    return Boolean(author && typeof author === "object");
+}
+//# sourceMappingURL=chatgpt-sse-collector.js.map

package/dist/providers/chatgpt-sse-collector.js.map

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

package/dist/providers/chatgpt.d.ts

@@ -0,0 +1,56 @@
+import type { Locator, Page } from "playwright";
+import type { ChatProvider, ProviderDiagnostics, WaitOptions } from "../core/provider.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 declare class ChatGPTAdapter implements ChatProvider {
+    readonly name = "chatgpt";
+    readonly homeUrl = "https://chatgpt.com/";
+    /** One collector per Page. Lazily attached on `open()`. */
+    private collectors;
+    /**
+     * 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.
+     */
+    private pendingTurns;
+    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>;
+    /** Wait up to `timeoutMs` for the ProseMirror composer to be ready. */
+    private waitForComposerReady;
+    extractLastAssistantMessage(page: Page): Promise<string>;
+    waitForResponse(page: Page, options?: WaitOptions): Promise<string>;
+    /**
+     * 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: Page): string | null;
+    newChat(page: Page): Promise<void>;
+    diagnose(page: Page): Promise<ProviderDiagnostics>;
+    /** Look up (and lazily create + attach) the SSE collector for a Page. */
+    private ensureCollector;
+    private waitForStopButton;
+    private waitForStopButtonGone;
+    private isStopButtonVisible;
+}