@love-moon/chat-web 0.3.2

package/dist/core/locator-score.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Heuristic scoring for "is this DOM node our input box / send button /
+ * assistant message?" — implements RFC §8.
+ *
+ * The scoring functions operate on a plain-object descriptor that the
+ * provider adapter assembles from a Playwright Locator. This keeps the
+ * scoring logic pure and testable.
+ */
+export interface ElementDescriptor {
+    tag: string;
+    role?: string | null;
+    ariaLabel?: string | null;
+    placeholder?: string | null;
+    type?: string | null;
+    contentEditable?: boolean;
+    visible?: boolean;
+    editable?: boolean;
+    enabled?: boolean;
+    text?: string | null;
+    /** Normalised viewport y in [0,1] where 1 == bottom. */
+    viewportY?: number;
+    /** Truthy if the element lives inside a sidebar / settings / search panel. */
+    inAuxiliaryRegion?: boolean;
+    /** Truthy if the element looks like a navigation/history item. */
+    inHistory?: boolean;
+    /** Approx distance in px to the message input. */
+    distanceToInput?: number;
+    /** Truthy if the element exposes a send/arrow-style icon. */
+    hasSendIcon?: boolean;
+    /** For assistant message scoring. */
+    authorRole?: string | null;
+    insideMainConversation?: boolean;
+    containsProse?: boolean;
+    appearedAfterUserMessage?: boolean;
+    textGrew?: boolean;
+}
+export declare function scoreInputCandidate(el: ElementDescriptor): number;
+export declare function scoreSendButtonCandidate(el: ElementDescriptor): number;
+export declare function scoreAssistantMessageCandidate(el: ElementDescriptor): number;
+/** Pick the highest-scoring candidate; ties keep the first listed. */
+export declare function pickBest<T>(items: T[], scorer: (item: T) => number): T | null;

package/dist/core/locator-score.js

@@ -0,0 +1,101 @@
+/**
+ * Heuristic scoring for "is this DOM node our input box / send button /
+ * assistant message?" — implements RFC §8.
+ *
+ * The scoring functions operate on a plain-object descriptor that the
+ * provider adapter assembles from a Playwright Locator. This keeps the
+ * scoring logic pure and testable.
+ */
+const INPUT_HINTS = [
+    "message",
+    "prompt",
+    "ask",
+    "ask anything", // ChatGPT 2026-era placeholder
+    "chat with chatgpt", // ChatGPT aria-label on the ProseMirror editor
+    "输入",
+    "提问",
+    "发送消息",
+    "给 deepseek",
+];
+const SEND_HINTS = ["send", "发送"];
+function containsAny(text, needles) {
+    if (!text)
+        return false;
+    const lower = text.toLowerCase();
+    return needles.some((n) => lower.includes(n.toLowerCase()));
+}
+export function scoreInputCandidate(el) {
+    let score = 0;
+    if (el.role === "textbox")
+        score += 5;
+    if (el.tag === "textarea" || el.contentEditable)
+        score += 5;
+    if (containsAny(el.placeholder, INPUT_HINTS))
+        score += 4;
+    if (containsAny(el.ariaLabel, INPUT_HINTS))
+        score += 4;
+    if (el.visible)
+        score += 3;
+    if (el.editable)
+        score += 3;
+    if (typeof el.viewportY === "number" && el.viewportY > 0.5)
+        score += 2;
+    if (el.inAuxiliaryRegion)
+        score -= 5;
+    if (el.visible === false)
+        score -= 5;
+    if (el.enabled === false)
+        score -= 5;
+    return score;
+}
+export function scoreSendButtonCandidate(el) {
+    let score = 0;
+    if (containsAny(el.ariaLabel, SEND_HINTS))
+        score += 5;
+    if (el.tag === "button")
+        score += 4;
+    if (typeof el.distanceToInput === "number" && el.distanceToInput < 200)
+        score += 3;
+    if (el.enabled)
+        score += 3;
+    if (el.hasSendIcon)
+        score += 2;
+    if (el.visible === false)
+        score -= 5;
+    if (el.enabled === false)
+        score -= 5;
+    return score;
+}
+export function scoreAssistantMessageCandidate(el) {
+    let score = 0;
+    if (el.authorRole === "assistant")
+        score += 5;
+    if (el.insideMainConversation)
+        score += 4;
+    if (el.containsProse)
+        score += 3;
+    if (el.appearedAfterUserMessage)
+        score += 2;
+    if (el.textGrew)
+        score += 2;
+    if (el.inAuxiliaryRegion || el.inHistory)
+        score -= 5;
+    return score;
+}
+/** Pick the highest-scoring candidate; ties keep the first listed. */
+export function pickBest(items, scorer) {
+    if (items.length === 0)
+        return null;
+    let best = items[0];
+    let bestScore = scorer(best);
+    for (let i = 1; i < items.length; i++) {
+        const candidate = items[i];
+        const s = scorer(candidate);
+        if (s > bestScore) {
+            best = candidate;
+            bestScore = s;
+        }
+    }
+    return best;
+}
+//# sourceMappingURL=locator-score.js.map

package/dist/core/locator-score.js.map

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

package/dist/core/logger.d.ts

@@ -0,0 +1,10 @@
+export type LogLevel = "silent" | "error" | "warn" | "info" | "debug";
+export interface Logger {
+    level: LogLevel;
+    error(...args: unknown[]): void;
+    warn(...args: unknown[]): void;
+    info(...args: unknown[]): void;
+    debug(...args: unknown[]): void;
+}
+export declare function createLogger(level?: LogLevel): Logger;
+export declare const defaultLogger: Logger;

package/dist/core/logger.js

@@ -0,0 +1,38 @@
+/* eslint-disable no-console */
+const LEVELS = {
+    silent: 0,
+    error: 1,
+    warn: 2,
+    info: 3,
+    debug: 4,
+};
+function envLevel() {
+    const raw = (process.env.CHAT_WEB_LOG ?? "info").toLowerCase();
+    if (raw in LEVELS)
+        return raw;
+    return "info";
+}
+export function createLogger(level = envLevel()) {
+    const should = (l) => LEVELS[l] <= LEVELS[level];
+    return {
+        level,
+        error(...args) {
+            if (should("error"))
+                console.error("[chat-web]", ...args);
+        },
+        warn(...args) {
+            if (should("warn"))
+                console.warn("[chat-web]", ...args);
+        },
+        info(...args) {
+            if (should("info"))
+                console.error("[chat-web]", ...args);
+        },
+        debug(...args) {
+            if (should("debug"))
+                console.error("[chat-web:debug]", ...args);
+        },
+    };
+}
+export const defaultLogger = createLogger();
+//# sourceMappingURL=logger.js.map

package/dist/core/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/core/logger.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAI/B,MAAM,MAAM,GAA6B;IACvC,MAAM,EAAE,CAAC;IACT,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;CACT,CAAC;AAEF,SAAS,QAAQ;IACf,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;IAC/D,IAAI,GAAG,IAAI,MAAM;QAAE,OAAO,GAAe,CAAC;IAC1C,OAAO,MAAM,CAAC;AAChB,CAAC;AAUD,MAAM,UAAU,YAAY,CAAC,QAAkB,QAAQ,EAAE;IACvD,MAAM,MAAM,GAAG,CAAC,CAAW,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC;IAE3D,OAAO;QACL,KAAK;QACL,KAAK,CAAC,GAAG,IAAI;YACX,IAAI,MAAM,CAAC,OAAO,CAAC;gBAAE,OAAO,CAAC,KAAK,CAAC,YAAY,EAAE,GAAG,IAAI,CAAC,CAAC;QAC5D,CAAC;QACD,IAAI,CAAC,GAAG,IAAI;YACV,IAAI,MAAM,CAAC,MAAM,CAAC;gBAAE,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,IAAI,CAAC,CAAC;QAC1D,CAAC;QACD,IAAI,CAAC,GAAG,IAAI;YACV,IAAI,MAAM,CAAC,MAAM,CAAC;gBAAE,OAAO,CAAC,KAAK,CAAC,YAAY,EAAE,GAAG,IAAI,CAAC,CAAC;QAC3D,CAAC;QACD,KAAK,CAAC,GAAG,IAAI;YACX,IAAI,MAAM,CAAC,OAAO,CAAC;gBAAE,OAAO,CAAC,KAAK,CAAC,kBAAkB,EAAE,GAAG,IAAI,CAAC,CAAC;QAClE,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAAW,YAAY,EAAE,CAAC"}

package/dist/core/navigate.d.ts

@@ -0,0 +1,52 @@
+import type { Page } from "playwright";
+import { type Logger } from "./logger.js";
+export interface GotoWithRetryOptions {
+    /** Hard upper bound per attempt. Default 15_000ms. */
+    timeoutMs?: number;
+    /** Maximum number of attempts. Default 3. */
+    attempts?: number;
+    /** Base backoff between attempts, exponentially scaled. Default 1500ms. */
+    backoffMs?: number;
+    /**
+     * Playwright `waitUntil`. Default `"commit"` — the fastest signal that
+     * navigation succeeded. We deliberately do NOT wait for `load` or
+     * `networkidle`: chat sites pull dozens of subresources (analytics,
+     * fonts, CDNs) that block whole-page load events on slow / proxied
+     * networks. The adapter waits for the specific composer locator
+     * separately, which is what we actually need.
+     */
+    waitUntil?: "commit" | "domcontentloaded" | "load" | "networkidle";
+    logger?: Logger;
+    signal?: AbortSignal;
+}
+/**
+ * True when the error looks like a transient network condition worth
+ * retrying. Excludes DNS-not-found and TLS cert errors — those won't
+ * fix themselves on the next attempt.
+ */
+export declare function isTransientNavigationError(err: unknown): boolean;
+/**
+ * Navigate to a URL with exponential-backoff retries on transient network
+ * errors. Intended for adapter `open()` where flaky proxies / unstable
+ * networks frequently cause Chromium's first connection to time out
+ * even when curl from the same shell works in 1–2s (a real condition
+ * we see in users with DNS-rewriting boxes that DPI-fingerprint
+ * Chromium's TLS handshake).
+ *
+ * Behaviour:
+ *   - Up to `attempts` tries (default 3).
+ *   - Default per-attempt timeout 15s; the *whole* operation is capped
+ *     at attempts × (timeoutMs + backoff*2^i).
+ *   - Only transient errors (see `isTransientNavigationError`) trigger
+ *     retries. DNS / TLS-cert failures bubble up immediately.
+ *   - On final failure, the last underlying error is rethrown verbatim
+ *     so callers can wrap it in their own typed error with context.
+ */
+export declare function gotoWithRetry(page: Page, url: string, options?: GotoWithRetryOptions): Promise<void>;
+/**
+ * Convenience: navigate and wrap any failure as a {@link ChatWebError}
+ * with a clear, user-actionable message. Adapters should use this
+ * inside `open()` so a connectivity problem surfaces with a useful
+ * hint instead of a raw `net::ERR_TIMED_OUT`.
+ */
+export declare function gotoOrThrowNetworkError(page: Page, url: string, provider: string, options?: GotoWithRetryOptions): Promise<void>;

package/dist/core/navigate.js

@@ -0,0 +1,102 @@
+import { ChatWebError } from "./errors.js";
+import { defaultLogger } from "./logger.js";
+const TRANSIENT_NET_ERROR_HINTS = [
+    "net::err_timed_out",
+    "net::err_connection_closed",
+    "net::err_connection_reset",
+    "net::err_connection_aborted",
+    "net::err_network_changed",
+    "net::err_aborted",
+    "net::err_socket_not_connected",
+    "navigation timeout",
+    "timeout",
+];
+/**
+ * True when the error looks like a transient network condition worth
+ * retrying. Excludes DNS-not-found and TLS cert errors — those won't
+ * fix themselves on the next attempt.
+ */
+export function isTransientNavigationError(err) {
+    const msg = String(err?.message ?? "").toLowerCase();
+    if (!msg)
+        return false;
+    // Don't retry permanent failures.
+    if (msg.includes("net::err_name_not_resolved"))
+        return false;
+    if (msg.includes("net::err_cert_"))
+        return false;
+    if (msg.includes("net::err_blocked_by"))
+        return false;
+    return TRANSIENT_NET_ERROR_HINTS.some((hint) => msg.includes(hint));
+}
+/**
+ * Navigate to a URL with exponential-backoff retries on transient network
+ * errors. Intended for adapter `open()` where flaky proxies / unstable
+ * networks frequently cause Chromium's first connection to time out
+ * even when curl from the same shell works in 1–2s (a real condition
+ * we see in users with DNS-rewriting boxes that DPI-fingerprint
+ * Chromium's TLS handshake).
+ *
+ * Behaviour:
+ *   - Up to `attempts` tries (default 3).
+ *   - Default per-attempt timeout 15s; the *whole* operation is capped
+ *     at attempts × (timeoutMs + backoff*2^i).
+ *   - Only transient errors (see `isTransientNavigationError`) trigger
+ *     retries. DNS / TLS-cert failures bubble up immediately.
+ *   - On final failure, the last underlying error is rethrown verbatim
+ *     so callers can wrap it in their own typed error with context.
+ */
+export async function gotoWithRetry(page, url, options = {}) {
+    const timeoutMs = options.timeoutMs ?? 15_000;
+    const attempts = Math.max(1, options.attempts ?? 3);
+    const backoffMs = options.backoffMs ?? 1_500;
+    const waitUntil = options.waitUntil ?? "commit";
+    const logger = options.logger ?? defaultLogger;
+    let lastError;
+    for (let attempt = 1; attempt <= attempts; attempt++) {
+        if (options.signal?.aborted) {
+            throw new DOMException("Aborted", "AbortError");
+        }
+        try {
+            await page.goto(url, { waitUntil, timeout: timeoutMs });
+            if (attempt > 1) {
+                logger.info(`chat-web: navigation to ${url} succeeded on attempt ${attempt}/${attempts}`);
+            }
+            return;
+        }
+        catch (err) {
+            lastError = err;
+            if (!isTransientNavigationError(err) || attempt === attempts)
+                break;
+            const delay = backoffMs * Math.pow(2, attempt - 1);
+            logger.warn(`chat-web: navigation to ${url} failed (attempt ${attempt}/${attempts}): ${err.message?.split("\n")[0] ?? "(unknown)"}. Retrying in ${delay}ms…`);
+            await new Promise((r) => setTimeout(r, delay));
+        }
+    }
+    // Re-throw the last error unchanged; callers add their own context.
+    throw lastError;
+}
+/**
+ * Convenience: navigate and wrap any failure as a {@link ChatWebError}
+ * with a clear, user-actionable message. Adapters should use this
+ * inside `open()` so a connectivity problem surfaces with a useful
+ * hint instead of a raw `net::ERR_TIMED_OUT`.
+ */
+export async function gotoOrThrowNetworkError(page, url, provider, options = {}) {
+    try {
+        await gotoWithRetry(page, url, options);
+    }
+    catch (err) {
+        if (isTransientNavigationError(err)) {
+            const summary = String(err.message ?? "").split("\n")[0];
+            throw new ChatWebError("BROWSER_LAUNCH_FAILED", `Chromium could not reach ${url} for "${provider}" (${summary}).`, {
+                provider,
+                cause: err,
+                hint: "curl from the same shell may still work — that usually means the local proxy / DNS box is DPI-fingerprinting Chromium's TLS handshake. " +
+                    "Try a different proxy that supports browser traffic, switch networks, or wait for the route to stabilise.",
+            });
+        }
+        throw err;
+    }
+}
+//# sourceMappingURL=navigate.js.map

package/dist/core/navigate.js.map

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

package/dist/core/paths.d.ts

@@ -0,0 +1,12 @@
+/**
+ * All filesystem layout for chat-web is centralised here so the CLI,
+ * daemon, doctor, and tests share one view of the world.
+ *
+ * Override the root via `CHAT_WEB_HOME` (useful in tests / CI).
+ */
+export declare function rootDir(): string;
+export declare function profilesDir(): string;
+export declare function profileDir(provider: string): string;
+export declare function logsDir(): string;
+export declare function configFile(): string;
+export declare function selectorCacheFile(): string;

package/dist/core/paths.js

@@ -0,0 +1,30 @@
+import { homedir } from "node:os";
+import path from "node:path";
+/**
+ * All filesystem layout for chat-web is centralised here so the CLI,
+ * daemon, doctor, and tests share one view of the world.
+ *
+ * Override the root via `CHAT_WEB_HOME` (useful in tests / CI).
+ */
+export function rootDir() {
+    return process.env.CHAT_WEB_HOME ?? path.join(homedir(), ".chat-web");
+}
+export function profilesDir() {
+    return path.join(rootDir(), "profiles");
+}
+export function profileDir(provider) {
+    return path.join(profilesDir(), sanitize(provider));
+}
+export function logsDir() {
+    return path.join(rootDir(), "logs");
+}
+export function configFile() {
+    return path.join(rootDir(), "config.json");
+}
+export function selectorCacheFile() {
+    return path.join(rootDir(), "selector-cache.json");
+}
+function sanitize(name) {
+    return name.replace(/[^a-zA-Z0-9_\-]/g, "_");
+}
+//# sourceMappingURL=paths.js.map

package/dist/core/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/core/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B;;;;;GAKG;AACH,MAAM,UAAU,OAAO;IACrB,OAAO,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,WAAW,CAAC,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,UAAU,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,QAAgB;IACzC,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,OAAO;IACrB,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,MAAM,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,aAAa,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,qBAAqB,CAAC,CAAC;AACrD,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY;IAC5B,OAAO,IAAI,CAAC,OAAO,CAAC,kBAAkB,EAAE,GAAG,CAAC,CAAC;AAC/C,CAAC"}

package/dist/core/profile-manager.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Profile manager owns the on-disk layout for persistent browser profiles.
+ *
+ * RFC §19.1: we persist the full Chromium userDataDir per provider
+ * (cookies + localStorage + IndexedDB + service workers), not just cookies.
+ */
+export interface BrowserProfileManager {
+    getProfileDir(provider: string): string;
+    ensureProfile(provider: string): Promise<string>;
+    clearProfile(provider: string): Promise<void>;
+    listProfiles(): Promise<string[]>;
+}
+export declare function createProfileManager(): BrowserProfileManager;

package/dist/core/profile-manager.js

@@ -0,0 +1,44 @@
+import fs from "node:fs/promises";
+import { ProfileError } from "./errors.js";
+import { profileDir, profilesDir, logsDir, rootDir } from "./paths.js";
+export function createProfileManager() {
+    return {
+        getProfileDir(provider) {
+            return profileDir(provider);
+        },
+        async ensureProfile(provider) {
+            const dir = profileDir(provider);
+            try {
+                await fs.mkdir(dir, { recursive: true });
+                await fs.mkdir(logsDir(), { recursive: true });
+                await fs.mkdir(rootDir(), { recursive: true });
+            }
+            catch (err) {
+                throw new ProfileError(provider, `Failed to create profile dir at ${dir}`, err);
+            }
+            return dir;
+        },
+        async clearProfile(provider) {
+            const dir = profileDir(provider);
+            try {
+                await fs.rm(dir, { recursive: true, force: true });
+            }
+            catch (err) {
+                throw new ProfileError(provider, `Failed to clear profile dir at ${dir}`, err);
+            }
+        },
+        async listProfiles() {
+            try {
+                const entries = await fs.readdir(profilesDir(), { withFileTypes: true });
+                return entries.filter((e) => e.isDirectory()).map((e) => e.name);
+            }
+            catch (err) {
+                const code = err.code;
+                if (code === "ENOENT")
+                    return [];
+                throw err;
+            }
+        },
+    };
+}
+//# sourceMappingURL=profile-manager.js.map

package/dist/core/profile-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile-manager.js","sourceRoot":"","sources":["../../src/core/profile-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAElC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAevE,MAAM,UAAU,oBAAoB;IAClC,OAAO;QACL,aAAa,CAAC,QAAQ;YACpB,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC;QAC9B,CAAC;QAED,KAAK,CAAC,aAAa,CAAC,QAAQ;YAC1B,MAAM,GAAG,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;YACjC,IAAI,CAAC;gBACH,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;gBACzC,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;gBAC/C,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACjD,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,IAAI,YAAY,CAAC,QAAQ,EAAE,mCAAmC,GAAG,EAAE,EAAE,GAAG,CAAC,CAAC;YAClF,CAAC;YACD,OAAO,GAAG,CAAC;QACb,CAAC;QAED,KAAK,CAAC,YAAY,CAAC,QAAQ;YACzB,MAAM,GAAG,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;YACjC,IAAI,CAAC;gBACH,MAAM,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YACrD,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,IAAI,YAAY,CAAC,QAAQ,EAAE,kCAAkC,GAAG,EAAE,EAAE,GAAG,CAAC,CAAC;YACjF,CAAC;QACH,CAAC;QAED,KAAK,CAAC,YAAY;YAChB,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;gBACzE,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACnE,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,IAAI,GAAI,GAA6B,CAAC,IAAI,CAAC;gBACjD,IAAI,IAAI,KAAK,QAAQ;oBAAE,OAAO,EAAE,CAAC;gBACjC,MAAM,GAAG,CAAC;YACZ,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/core/provider.d.ts

@@ -0,0 +1,64 @@
+import type { Locator, Page } from "playwright";
+export interface WaitOptions {
+    /** Hard upper bound for the whole response wait. Default 120_000ms. */
+    timeoutMs?: number;
+    /** How long the text must stop changing before we call it done. Default 2000ms. */
+    stableMs?: number;
+    /** Optional cancellation. */
+    signal?: AbortSignal;
+    /** Streaming progress callback. */
+    onProgress?: (text: string) => void;
+}
+/**
+ * The minimum surface every provider has to implement so `ask`, `doctor`,
+ * `new-chat` and the daemon can be provider-agnostic.
+ *
+ * Adapters MUST NOT share logic via mixins — RFC §13.2 explicitly calls
+ * out that ChatGPT and DeepSeek should not be merged into one branch.
+ */
+export interface ChatProvider {
+    readonly name: string;
+    readonly homeUrl: string;
+    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>;
+    waitForResponse(page: Page, options?: WaitOptions): Promise<string>;
+    extractLastAssistantMessage(page: Page): Promise<string>;
+    newChat?(page: Page): Promise<void>;
+    /** For doctor: cheap summary numbers (counts + booleans). */
+    diagnose?(page: Page): Promise<ProviderDiagnostics>;
+    /**
+     * Provider-side conversation identifier as exposed by the web UI.
+     *
+     * For ChatGPT this is the UUID at `https://chatgpt.com/c/{uuid}`. For
+     * Gemini AI Studio it would be the prompts/* id segment. Implement when
+     * the provider exposes a stable per-conversation id in its URL/state;
+     * the SDK surfaces it as the canonical session id and pushes it through
+     * `ChatSession.conversationId` / `SendResult.conversationId` so callers
+     * (ai-sdk, frontend) can render real-provider-side links.
+     */
+    getConversationId?(page: Page): string | null;
+}
+export interface ProviderDiagnostics {
+    loggedIn: boolean;
+    inputFound: boolean;
+    sendButtonFound: boolean;
+    assistantMessageCount: number;
+    stopButtonFound: boolean;
+    lastAssistantLength: number;
+    pageUrl: string;
+}
+declare class ProviderRegistry {
+    private providers;
+    register(provider: ChatProvider): void;
+    get(name: string): ChatProvider;
+    has(name: string): boolean;
+    list(): string[];
+}
+export declare const providerRegistry: ProviderRegistry;
+export declare function getProvider(name: string): ChatProvider;
+export declare function registerProvider(provider: ChatProvider): void;
+export declare function listProviders(): string[];
+export {};

package/dist/core/provider.js

@@ -0,0 +1,31 @@
+import { UnknownProviderError } from "./errors.js";
+class ProviderRegistry {
+    providers = new Map();
+    register(provider) {
+        this.providers.set(provider.name, provider);
+    }
+    get(name) {
+        const provider = this.providers.get(name);
+        if (!provider) {
+            throw new UnknownProviderError(name, [...this.providers.keys()]);
+        }
+        return provider;
+    }
+    has(name) {
+        return this.providers.has(name);
+    }
+    list() {
+        return [...this.providers.keys()];
+    }
+}
+export const providerRegistry = new ProviderRegistry();
+export function getProvider(name) {
+    return providerRegistry.get(name);
+}
+export function registerProvider(provider) {
+    providerRegistry.register(provider);
+}
+export function listProviders() {
+    return providerRegistry.list();
+}
+//# sourceMappingURL=provider.js.map

package/dist/core/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../src/core/provider.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AA8DnD,MAAM,gBAAgB;IACZ,SAAS,GAAG,IAAI,GAAG,EAAwB,CAAC;IAEpD,QAAQ,CAAC,QAAsB;QAC7B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC9C,CAAC;IAED,GAAG,CAAC,IAAY;QACd,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,oBAAoB,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QACnE,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,IAAI;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;IACpC,CAAC;CACF;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,gBAAgB,EAAE,CAAC;AAEvD,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,QAAsB;IACrD,gBAAgB,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,gBAAgB,CAAC,IAAI,EAAE,CAAC;AACjC,CAAC"}

package/dist/core/response-watcher.d.ts

@@ -0,0 +1,35 @@
+import type { Page } from "playwright";
+export interface WaitUntilStableOptions {
+    /** How long the text must stop changing before we consider it stable. Default 2000ms. */
+    stableMs?: number;
+    /** Hard upper bound. Default 120_000ms. */
+    timeoutMs?: number;
+    /** Poll interval between samples. Default 300ms. */
+    pollIntervalMs?: number;
+    /** AbortSignal so callers can cancel the wait. */
+    signal?: AbortSignal;
+    /** Optional callback whenever the sampled text grows (useful for progress UI). */
+    onProgress?: (text: string) => void;
+}
+/**
+ * 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 declare function waitUntilStable(getText: () => Promise<string>, options?: WaitUntilStableOptions): Promise<string>;
+export declare function sleep(ms: number): Promise<void>;
+/**
+ * Convenience: wait until the assistant message count grows past a baseline.
+ * Useful right after pressing Enter, so we know the streaming has started.
+ */
+export declare function waitForResponseStart(page: Page, selector: string, baseline: number, options?: {
+    timeoutMs?: number;
+    pollIntervalMs?: number;
+}): Promise<void>;