@love-moon/chat-web 0.3.2

package/CHANGELOG.md

@@ -0,0 +1,8 @@
+# @love-moon/chat-web
+
+## 0.3.2
+
+### Minor Changes
+
+- Introduce the browser-backed chat runtime for ChatGPT, DeepSeek, and Gemini
+  providers, packaged for integration with `@love-moon/ai-sdk`.

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,142 @@
+#!/usr/bin/env node
+/* eslint-disable no-console */
+import { doctor, formatDoctorReport } from "./commands/doctor.js";
+import { info, formatInfo } from "./commands/info.js";
+import { login } from "./commands/login.js";
+import { ChatWebError } from "./core/errors.js";
+import { createLogger } from "./core/logger.js";
+import { registerBuiltinProviders } from "./providers/index.js";
+const USAGE = `chat-web — chat web automation runtime
+
+Usage:
+  chat-web login <provider>                       Open a browser to sign in; profile is persisted.
+  chat-web doctor <provider> [--snapshot]         Inspect provider page state.
+                            [--screenshot]
+                            [--html]
+                            [--json]
+  chat-web info [<provider>] [--live] [--json]    Show login state for one or all providers.
+
+For programmatic multi-turn chat use the SDK:
+
+  import { ChatSession } from "@love-moon/chat-web";
+
+  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();
+  }
+
+Environment:
+  CHAT_WEB_HOME       Override the ~/.chat-web/ root directory.
+  CHAT_WEB_HEADLESS   "1" to launch Chromium headless by default.
+  CHAT_WEB_LOG        silent | error | warn | info | debug
+`;
+function parseArgs(argv) {
+    const positional = [];
+    const flags = new Map();
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        if (arg.startsWith("--")) {
+            const key = arg.slice(2);
+            const next = argv[i + 1];
+            if (next !== undefined && !next.startsWith("--")) {
+                flags.set(key, next);
+                i++;
+            }
+            else {
+                flags.set(key, true);
+            }
+        }
+        else {
+            positional.push(arg);
+        }
+    }
+    return { positional, flags };
+}
+function flagBool(flags, key) {
+    const v = flags.get(key);
+    return v === true || v === "true";
+}
+function flagString(flags, key) {
+    const v = flags.get(key);
+    return typeof v === "string" ? v : undefined;
+}
+async function main() {
+    registerBuiltinProviders();
+    const argv = process.argv.slice(2);
+    if (argv.length === 0 || argv[0] === "help" || argv[0] === "--help" || argv[0] === "-h") {
+        process.stdout.write(USAGE);
+        return 0;
+    }
+    const [command, ...rest] = argv;
+    const { positional, flags } = parseArgs(rest);
+    const logLevel = flagString(flags, "log") ?? undefined;
+    const logger = createLogger(logLevel ?? process.env.CHAT_WEB_LOG ?? "info");
+    switch (command) {
+        case "login": {
+            const provider = positional[0];
+            if (!provider)
+                throw new Error("Usage: chat-web login <provider>");
+            await login(provider, {
+                logger,
+                autoExit: flagBool(flags, "auto-exit"),
+            });
+            return 0;
+        }
+        case "doctor": {
+            const provider = positional[0];
+            if (!provider)
+                throw new Error("Usage: chat-web doctor <provider>");
+            const report = await doctor(provider, {
+                snapshot: flagBool(flags, "snapshot"),
+                screenshot: flagBool(flags, "screenshot"),
+                html: flagBool(flags, "html"),
+                headless: flagBool(flags, "headless") || undefined,
+                logger,
+            });
+            if (flagBool(flags, "json")) {
+                process.stdout.write(`${JSON.stringify(report, null, 2)}\n`);
+            }
+            else {
+                process.stdout.write(`${formatDoctorReport(report)}\n`);
+            }
+            return 0;
+        }
+        case "info": {
+            const provider = positional[0]; // optional
+            const rows = await info({
+                provider,
+                live: flagBool(flags, "live"),
+                headless: flagBool(flags, "headless") || undefined,
+                logger,
+            });
+            if (flagBool(flags, "json")) {
+                process.stdout.write(`${JSON.stringify(rows, null, 2)}\n`);
+            }
+            else {
+                process.stdout.write(`${formatInfo(rows)}\n`);
+            }
+            return 0;
+        }
+        default:
+            process.stderr.write(`Unknown command: ${command}\n\n${USAGE}`);
+            return 2;
+    }
+}
+main().then((code) => {
+    if (typeof code === "number")
+        process.exit(code);
+}, (err) => {
+    if (err instanceof ChatWebError) {
+        process.stderr.write(`Error [${err.code}]: ${err.message}\n`);
+        if (err.hint)
+            process.stderr.write(`Hint: ${err.hint}\n`);
+        process.exit(1);
+    }
+    process.stderr.write(`${err.stack ?? String(err)}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/commands/doctor.d.ts

@@ -0,0 +1,27 @@
+import { type Logger } from "../core/logger.js";
+import { type ProviderDiagnostics } from "../core/provider.js";
+export interface DoctorOptions {
+    /** Dump the lightweight snapshot to ~/.chat-web/logs/. */
+    snapshot?: boolean;
+    /** Dump a PNG screenshot to ~/.chat-web/logs/. */
+    screenshot?: boolean;
+    /** Dump the raw HTML to ~/.chat-web/logs/. */
+    html?: boolean;
+    logger?: Logger;
+    headless?: boolean;
+}
+export interface DoctorReport extends ProviderDiagnostics {
+    provider: string;
+    profileDir: string;
+    snapshotFile?: string;
+    screenshotFile?: string;
+    htmlFile?: string;
+}
+/**
+ * Run a non-destructive health check for a provider profile.
+ *
+ * Doctor never sends a real chat message — it only opens the provider,
+ * inspects the DOM, and optionally dumps debugging artifacts.
+ */
+export declare function doctor(providerName: string, options?: DoctorOptions): Promise<DoctorReport>;
+export declare function formatDoctorReport(r: DoctorReport): string;

package/dist/commands/doctor.js

@@ -0,0 +1,116 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { launchProviderBrowser } from "../core/browser.js";
+import { defaultLogger } from "../core/logger.js";
+import { logsDir } from "../core/paths.js";
+import { createProfileManager } from "../core/profile-manager.js";
+import { getProvider } from "../core/provider.js";
+import { formatSnapshot, takeSnapshot } from "../core/snapshot.js";
+/**
+ * Run a non-destructive health check for a provider profile.
+ *
+ * Doctor never sends a real chat message — it only opens the provider,
+ * inspects the DOM, and optionally dumps debugging artifacts.
+ */
+export async function doctor(providerName, options = {}) {
+    const logger = options.logger ?? defaultLogger;
+    const provider = getProvider(providerName);
+    const profileManager = createProfileManager();
+    const profileDir = profileManager.getProfileDir(providerName);
+    const { context, page } = await launchProviderBrowser(providerName, {
+        headless: options.headless ?? false,
+        profileManager,
+    });
+    try {
+        await provider.open(page);
+        // Best-effort settle: most chat sites finish JS init shortly after
+        // domcontentloaded. We don't fail on timeout — we just want to give
+        // ProseMirror / app shell a chance to render before snapshotting, so
+        // doctor sees the same DOM the runtime sees.
+        await page.waitForLoadState("networkidle", { timeout: 8_000 }).catch(() => undefined);
+        const diagnostics = provider.diagnose
+            ? await provider.diagnose(page)
+            : await fallbackDiagnose(provider, page);
+        let snapshotFile;
+        let screenshotFile;
+        let htmlFile;
+        if (options.snapshot || options.screenshot || options.html) {
+            await fs.mkdir(logsDir(), { recursive: true });
+        }
+        const ts = new Date().toISOString().replace(/[:.]/g, "-");
+        if (options.snapshot) {
+            const snap = await takeSnapshot(page);
+            snapshotFile = path.join(logsDir(), `${ts}-${providerName}-snapshot.json`);
+            await fs.writeFile(snapshotFile, JSON.stringify(snap, null, 2), "utf8");
+            logger.info(`Wrote snapshot to ${snapshotFile}`);
+            // Also print a human-readable form to stderr for quick inspection.
+            logger.debug(formatSnapshot(snap));
+        }
+        if (options.screenshot) {
+            screenshotFile = path.join(logsDir(), `${ts}-${providerName}-screenshot.png`);
+            await page.screenshot({ path: screenshotFile, fullPage: true });
+            logger.info(`Wrote screenshot to ${screenshotFile}`);
+        }
+        if (options.html) {
+            htmlFile = path.join(logsDir(), `${ts}-${providerName}-page.html`);
+            const html = await page.content();
+            await fs.writeFile(htmlFile, html, "utf8");
+            logger.info(`Wrote HTML to ${htmlFile}`);
+        }
+        return {
+            ...diagnostics,
+            provider: providerName,
+            profileDir,
+            snapshotFile,
+            screenshotFile,
+            htmlFile,
+        };
+    }
+    finally {
+        await context.close().catch(() => undefined);
+    }
+}
+async function fallbackDiagnose(provider, page) {
+    const [loggedIn, sendBtn] = await Promise.all([
+        provider.isLoggedIn(page),
+        provider.findSendButton(page).then((l) => l !== null).catch(() => false),
+    ]);
+    let inputFound = false;
+    try {
+        await provider.findInput(page);
+        inputFound = true;
+    }
+    catch {
+        inputFound = false;
+    }
+    return {
+        loggedIn,
+        inputFound,
+        sendButtonFound: sendBtn,
+        assistantMessageCount: 0,
+        stopButtonFound: false,
+        lastAssistantLength: 0,
+        pageUrl: page.url(),
+    };
+}
+export function formatDoctorReport(r) {
+    const lines = [
+        `Provider:                ${r.provider}`,
+        `Profile:                 ${r.profileDir}`,
+        `Page URL:                ${r.pageUrl}`,
+        `Login:                   ${r.loggedIn}`,
+        `Input found:             ${r.inputFound}`,
+        `Send button found:       ${r.sendButtonFound}`,
+        `Assistant messages:      ${r.assistantMessageCount}`,
+        `Stop button found:       ${r.stopButtonFound}`,
+        `Last assistant length:   ${r.lastAssistantLength}`,
+    ];
+    if (r.snapshotFile)
+        lines.push(`Snapshot:                ${r.snapshotFile}`);
+    if (r.screenshotFile)
+        lines.push(`Screenshot:              ${r.screenshotFile}`);
+    if (r.htmlFile)
+        lines.push(`HTML:                    ${r.htmlFile}`);
+    return lines.join("\n");
+}
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

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

package/dist/commands/index.d.ts

@@ -0,0 +1,3 @@
+export { login, type LoginOptions } from "./login.js";
+export { doctor, formatDoctorReport, type DoctorOptions, type DoctorReport } from "./doctor.js";
+export { info, formatInfo, type InfoOptions, type ProviderInfo } from "./info.js";

package/dist/commands/index.js

@@ -0,0 +1,4 @@
+export { login } from "./login.js";
+export { doctor, formatDoctorReport } from "./doctor.js";
+export { info, formatInfo } from "./info.js";
+//# sourceMappingURL=index.js.map

package/dist/commands/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAqB,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAyC,MAAM,aAAa,CAAC;AAChG,OAAO,EAAE,IAAI,EAAE,UAAU,EAAuC,MAAM,WAAW,CAAC"}

package/dist/commands/info.d.ts

@@ -0,0 +1,32 @@
+import { type Logger } from "../core/logger.js";
+export interface InfoOptions {
+    /** Restrict the report to a single provider. */
+    provider?: string;
+    /** Actually launch Chromium to verify isLoggedIn live. Default false (fast filesystem-only mode). */
+    live?: boolean;
+    /** When live, launch headless. Default true (info is usually run from scripts). */
+    headless?: boolean;
+    logger?: Logger;
+}
+export interface ProviderInfo {
+    name: string;
+    homeUrl: string;
+    profileDir: string;
+    profileExists: boolean;
+    /** Last-modified time of the profile dir (ISO-8601), if it exists. */
+    profileLastUsed?: string;
+    /** Only populated when `live: true`. */
+    loggedIn?: boolean;
+    /** Filled if a live check failed. */
+    liveError?: string;
+}
+/**
+ * Inspect provider login state.
+ *
+ * Default mode is filesystem-only: cheap, doesn't launch a browser, just
+ * tells you which providers have a persisted profile and when it was last
+ * touched. Pass `live: true` to actually open Chromium and call
+ * `isLoggedIn` on each provider — that's accurate but slow.
+ */
+export declare function info(options?: InfoOptions): Promise<ProviderInfo[]>;
+export declare function formatInfo(rows: ProviderInfo[]): string;

package/dist/commands/info.js

@@ -0,0 +1,81 @@
+import fs from "node:fs/promises";
+import { defaultLogger } from "../core/logger.js";
+import { createProfileManager } from "../core/profile-manager.js";
+import { listProviders, getProvider } from "../core/provider.js";
+import { ChatSession } from "../session.js";
+/**
+ * Inspect provider login state.
+ *
+ * Default mode is filesystem-only: cheap, doesn't launch a browser, just
+ * tells you which providers have a persisted profile and when it was last
+ * touched. Pass `live: true` to actually open Chromium and call
+ * `isLoggedIn` on each provider — that's accurate but slow.
+ */
+export async function info(options = {}) {
+    const logger = options.logger ?? defaultLogger;
+    const profileManager = createProfileManager();
+    const names = options.provider ? [options.provider] : listProviders();
+    const results = [];
+    for (const name of names) {
+        const provider = getProvider(name);
+        const dir = profileManager.getProfileDir(name);
+        const stat = await fs.stat(dir).catch(() => null);
+        const profileExists = stat !== null && stat.isDirectory();
+        const profileLastUsed = stat ? stat.mtime.toISOString() : undefined;
+        const entry = {
+            name,
+            homeUrl: provider.homeUrl,
+            profileDir: dir,
+            profileExists,
+            profileLastUsed,
+        };
+        if (options.live) {
+            try {
+                const session = await ChatSession.open(name, {
+                    headless: options.headless ?? true,
+                    logger,
+                });
+                try {
+                    entry.loggedIn = await session.isLoggedIn();
+                }
+                finally {
+                    await session.close();
+                }
+            }
+            catch (err) {
+                entry.liveError = err.message;
+            }
+        }
+        results.push(entry);
+    }
+    return results;
+}
+export function formatInfo(rows) {
+    if (rows.length === 0)
+        return "No providers registered.";
+    const lines = [];
+    for (const r of rows) {
+        lines.push(`Provider:        ${r.name}`);
+        lines.push(`  Home:          ${r.homeUrl}`);
+        lines.push(`  Profile dir:   ${r.profileDir}`);
+        lines.push(`  Profile saved: ${r.profileExists ? "yes" : "no"}`);
+        if (r.profileLastUsed) {
+            lines.push(`  Last used:     ${r.profileLastUsed}`);
+        }
+        if (r.loggedIn !== undefined) {
+            lines.push(`  Logged in:     ${r.loggedIn ? "yes" : "no"}`);
+        }
+        else if (r.liveError) {
+            lines.push(`  Logged in:     unknown (${r.liveError})`);
+        }
+        else if (!r.profileExists) {
+            lines.push(`  Logged in:     no (run: chat-web login ${r.name})`);
+        }
+        else {
+            lines.push(`  Logged in:     unknown (pass --live to check)`);
+        }
+        lines.push("");
+    }
+    return lines.join("\n").trimEnd();
+}
+//# sourceMappingURL=info.js.map

package/dist/commands/info.js.map

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

package/dist/commands/login.d.ts

@@ -0,0 +1,19 @@
+import { type Logger } from "../core/logger.js";
+export interface LoginOptions {
+    logger?: Logger;
+    /** When true, exit as soon as the provider reports a logged-in state instead of waiting for the user to press Enter. */
+    autoExit?: boolean;
+    /** Poll interval for autoExit. */
+    pollIntervalMs?: number;
+    /** Hard upper bound for the login flow. */
+    timeoutMs?: number;
+}
+/**
+ * Open a headed browser so the user can sign in manually.
+ *
+ * We never automate the actual sign-in (no email/password handling, no
+ * captcha bypass). The whole point of `chat-web login` is to give the
+ * user a one-time interactive window whose state is then persisted to
+ * the provider profile.
+ */
+export declare function login(providerName: string, options?: LoginOptions): Promise<void>;

package/dist/commands/login.js

@@ -0,0 +1,61 @@
+import readline from "node:readline";
+import { defaultLogger } from "../core/logger.js";
+import { ChatSession } from "../session.js";
+/**
+ * Open a headed browser so the user can sign in manually.
+ *
+ * We never automate the actual sign-in (no email/password handling, no
+ * captcha bypass). The whole point of `chat-web login` is to give the
+ * user a one-time interactive window whose state is then persisted to
+ * the provider profile.
+ */
+export async function login(providerName, options = {}) {
+    const logger = options.logger ?? defaultLogger;
+    const session = await ChatSession.open(providerName, {
+        headless: false,
+        logger,
+    });
+    try {
+        logger.info(`Opened ${session.provider} in a Chromium window backed by ${session.userDataDir}.`);
+        logger.info("Complete the sign-in flow in the browser window.");
+        if (options.autoExit) {
+            await waitForLoggedIn(session, options, logger);
+            logger.info(`Detected logged-in state for ${providerName}. Closing browser.`);
+        }
+        else {
+            logger.info("When done, press Enter in this terminal to close the browser.");
+            await waitForEnter();
+        }
+        if (await session.isLoggedIn()) {
+            logger.info(`Saved persistent profile for ${providerName} at ${session.userDataDir}.`);
+        }
+        else {
+            logger.warn(`Could not verify login for ${providerName}. The browser was closed without a confirmed signed-in state.`);
+        }
+    }
+    finally {
+        await session.close();
+    }
+}
+function waitForEnter() {
+    return new Promise((resolve) => {
+        const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+        rl.question("", () => {
+            rl.close();
+            resolve();
+        });
+    });
+}
+async function waitForLoggedIn(session, options, logger) {
+    const pollIntervalMs = options.pollIntervalMs ?? 2_000;
+    const timeoutMs = options.timeoutMs ?? 10 * 60 * 1000;
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        const ok = await session.isLoggedIn().catch(() => false);
+        if (ok)
+            return;
+        await new Promise((r) => setTimeout(r, pollIntervalMs));
+    }
+    logger.warn("Timed out waiting for login.");
+}
+//# sourceMappingURL=login.js.map

package/dist/commands/login.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"login.js","sourceRoot":"","sources":["../../src/commands/login.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,eAAe,CAAC;AAErC,OAAO,EAAE,aAAa,EAAe,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAY5C;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,YAAoB,EAAE,UAAwB,EAAE;IAC1E,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,aAAa,CAAC;IAE/C,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,YAAY,EAAE;QACnD,QAAQ,EAAE,KAAK;QACf,MAAM;KACP,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,MAAM,CAAC,IAAI,CACT,UAAU,OAAO,CAAC,QAAQ,mCAAmC,OAAO,CAAC,WAAW,GAAG,CACpF,CAAC;QACF,MAAM,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAC;QAEhE,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACrB,MAAM,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;YAChD,MAAM,CAAC,IAAI,CAAC,gCAAgC,YAAY,oBAAoB,CAAC,CAAC;QAChF,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,IAAI,CAAC,+DAA+D,CAAC,CAAC;YAC7E,MAAM,YAAY,EAAE,CAAC;QACvB,CAAC;QAED,IAAI,MAAM,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;YAC/B,MAAM,CAAC,IAAI,CAAC,gCAAgC,YAAY,OAAO,OAAO,CAAC,WAAW,GAAG,CAAC,CAAC;QACzF,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,IAAI,CACT,8BAA8B,YAAY,+DAA+D,CAC1G,CAAC;QACJ,CAAC;IACH,CAAC;YAAS,CAAC;QACT,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;AACH,CAAC;AAED,SAAS,YAAY;IACnB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,EAAE,GAAG,QAAQ,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QACtF,EAAE,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,EAAE;YACnB,EAAE,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,eAAe,CAC5B,OAAoB,EACpB,OAAqB,EACrB,MAAc;IAEd,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,KAAK,CAAC;IACvD,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IACtD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;IAExC,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;QAC7B,MAAM,EAAE,GAAG,MAAM,OAAO,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;QACzD,IAAI,EAAE;YAAE,OAAO;QACf,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC;IAC1D,CAAC;IACD,MAAM,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;AAC9C,CAAC"}

package/dist/core/browser.d.ts

@@ -0,0 +1,70 @@
+import { type BrowserContext, type Page } from "playwright";
+import { type Logger } from "./logger.js";
+import { type BrowserProfileManager } from "./profile-manager.js";
+export interface LaunchOptions {
+    /** Override headless. Defaults to headed (RFC §19.3) but `false` is overridden by env vars. */
+    headless?: boolean;
+    /** Width × height of the viewport. */
+    viewport?: {
+        width: number;
+        height: number;
+    };
+    /** Extra Chromium args. Merged after our defaults. */
+    args?: string[];
+    /** Inject a custom profile manager (mostly for testing). */
+    profileManager?: BrowserProfileManager;
+    /** Logger used for the (rare) auto-install path. */
+    logger?: Logger;
+    /**
+     * Disable the runtime auto-install of Chromium. Defaults to honouring
+     * the `CHAT_WEB_NO_AUTO_INSTALL` / `CHAT_WEB_SKIP_BROWSER_INSTALL`
+     * env vars; pass `true` to force-disable regardless.
+     */
+    noAutoInstall?: boolean;
+    /**
+     * Use a specific Chromium-family browser channel instead of the
+     * Playwright-bundled `chrome-headless-shell`. Accepts the standard
+     * Playwright channel ids: `"chrome"` / `"chrome-beta"` / `"msedge"` /
+     * `"chromium"`. Honours the `CHAT_WEB_BROWSER_CHANNEL` env var.
+     *
+     * When set, Playwright uses the system-installed binary (so e.g.
+     * `channel: "chrome"` means "the same Google Chrome you double-click
+     * on the dock"). Mutually exclusive with `executablePath` — if both
+     * are provided, `executablePath` wins.
+     *
+     * Note: this does NOT bypass Google's WAA anti-abuse on AI Studio
+     * (verified: system Chrome + headed + the same userDataDir still
+     * gets blocked because WAA detects the CDP connection itself, not
+     * the binary identity). It's still useful for the other providers
+     * (ChatGPT, DeepSeek) when the user's network treats Playwright's
+     * `chrome-headless-shell` differently from real Chrome.
+     */
+    channel?: string;
+    /**
+     * Explicit path to a Chrome / Chromium binary. Overrides `channel`.
+     * Honours the `CHAT_WEB_BROWSER_EXECUTABLE` env var.
+     *
+     * Example (macOS):
+     *   `/Applications/Google Chrome.app/Contents/MacOS/Google Chrome`
+     */
+    executablePath?: string;
+}
+export interface LaunchedBrowser {
+    context: BrowserContext;
+    page: Page;
+    /** The userDataDir that was used. Useful for doctor / debug output. */
+    userDataDir: string;
+}
+/**
+ * Launch (or reattach to) a persistent Chromium context for a provider.
+ *
+ * Important: we use `launchPersistentContext`, NOT `browser.newContext`,
+ * because ChatGPT / DeepSeek depend on more than just cookies (see RFC §19.1).
+ *
+ * First-run UX: if Playwright reports that the Chromium binary is not
+ * installed (a very common state under pnpm 10+, which silently blocks
+ * the `playwright` postinstall script), we run
+ * `npx playwright install chromium` once and retry the launch. Disable
+ * via `CHAT_WEB_NO_AUTO_INSTALL=1` (or `noAutoInstall: true` on the call).
+ */
+export declare function launchProviderBrowser(provider: string, options?: LaunchOptions): Promise<LaunchedBrowser>;