browser-autopilot 0.1.0

package/dist/browser/snapshot.js

@@ -0,0 +1,70 @@
+/**
+ * DOM snapshot serialization for LLM consumption.
+ *
+ * Inspired by agent-browser's snapshot.ts — converts the accessibility tree
+ * into indexed text the LLM can reason about and reference elements by [ref=eN].
+ */
+const INTERACTIVE_ROLES = new Set([
+    "button", "link", "textbox", "searchbox", "combobox", "listbox",
+    "checkbox", "radio", "switch", "tab", "menuitem", "menuitemcheckbox",
+    "menuitemradio", "option", "slider", "spinbutton", "progressbar",
+    "scrollbar", "treeitem",
+]);
+const CONTENT_ROLES = new Set([
+    "heading", "paragraph", "blockquote", "code", "figure",
+    "img", "math", "table", "cell", "row", "list", "listitem",
+    "article", "main", "navigation", "banner", "contentinfo",
+    "complementary", "form", "region", "status", "alert", "dialog",
+    "tooltip", "log", "marquee", "timer",
+]);
+export function serializeAXNodes(nodes, opts = {}) {
+    const refs = new Map();
+    const lines = [];
+    let refCounter = 0;
+    for (const node of nodes) {
+        const role = node.role?.value ?? "";
+        const name = node.name?.value ?? "";
+        const value = node.value?.value ?? "";
+        if (!role || role === "none" || role === "generic" || role === "InlineTextBox")
+            continue;
+        if (opts.interactive && !INTERACTIVE_ROLES.has(role))
+            continue;
+        const isInteractive = INTERACTIVE_ROLES.has(role);
+        const isContent = CONTENT_ROLES.has(role);
+        if (!isInteractive && !isContent)
+            continue;
+        let ref = "";
+        if (isInteractive) {
+            refCounter++;
+            ref = `e${refCounter}`;
+            refs.set(ref, {
+                ref,
+                role,
+                name,
+                selector: buildSelector(role, name, node),
+            });
+        }
+        const parts = [role];
+        if (name)
+            parts.push(`"${name}"`);
+        if (value)
+            parts.push(`value="${value}"`);
+        if (ref)
+            parts.push(`[ref=${ref}]`);
+        lines.push(parts.join(" "));
+    }
+    return { text: lines.join("\n"), refs };
+}
+function buildSelector(role, name, node) {
+    if (role === "textbox" || role === "searchbox") {
+        return name ? `input[name="${name}"], input[placeholder="${name}"]` : "input";
+    }
+    if (role === "button") {
+        return name ? `button:has-text("${name}"), [role="button"]:has-text("${name}")` : "button";
+    }
+    if (role === "link") {
+        return name ? `a:has-text("${name}")` : "a";
+    }
+    return `[role="${role}"]`;
+}
+//# sourceMappingURL=snapshot.js.map

package/dist/browser/snapshot.js.map

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

package/dist/captcha/solver.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Universal captcha solver — Capsolver (primary), 2Captcha (fallback).
+ * Supports: reCAPTCHA v2/v3, hCaptcha, Cloudflare Turnstile, DataDome.
+ */
+interface SolveResult {
+    token?: string;
+    cookie?: string;
+    provider: string;
+}
+type CaptchaType = "recaptcha_v2" | "recaptcha_v3" | "hcaptcha" | "turnstile" | "datadome";
+export declare function solve(opts: {
+    type: CaptchaType;
+    siteUrl: string;
+    siteKey?: string;
+    captchaUrl?: string;
+    userAgent?: string;
+    proxy?: string;
+    action?: string;
+}): Promise<SolveResult>;
+export {};

package/dist/captcha/solver.js

@@ -0,0 +1,101 @@
+/**
+ * Universal captcha solver — Capsolver (primary), 2Captcha (fallback).
+ * Supports: reCAPTCHA v2/v3, hCaptcha, Cloudflare Turnstile, DataDome.
+ */
+import { config } from "../config.js";
+// ── Capsolver ────────────────────────────────────────────────────────────────
+async function capsolverSolve(task) {
+    const resp = await fetch("https://api.capsolver.com/createTask", {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ clientKey: config.captcha.capsolverKey, task }),
+    });
+    const data = await resp.json();
+    if (data.errorId !== 0)
+        throw new Error(`capsolver: ${data.errorDescription}`);
+    const taskId = data.taskId;
+    for (let i = 0; i < 60; i++) {
+        await sleep(3000);
+        const r = await fetch("https://api.capsolver.com/getTaskResult", {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ clientKey: config.captcha.capsolverKey, taskId }),
+        });
+        const result = await r.json();
+        if (result.status === "ready")
+            return result.solution;
+    }
+    throw new Error("capsolver timeout");
+}
+// ── 2Captcha ─────────────────────────────────────────────────────────────────
+async function twoCaptchaSolve(task) {
+    const resp = await fetch("https://api.2captcha.com/createTask", {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ clientKey: config.captcha.twocaptchaKey, task }),
+    });
+    const data = await resp.json();
+    if (data.errorId !== 0)
+        throw new Error(`2captcha: ${JSON.stringify(data)}`);
+    const taskId = data.taskId;
+    for (let i = 0; i < 60; i++) {
+        await sleep(5000);
+        const r = await fetch("https://api.2captcha.com/getTaskResult", {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ clientKey: config.captcha.twocaptchaKey, taskId }),
+        });
+        const result = await r.json();
+        if (result.status === "ready")
+            return result.solution;
+    }
+    throw new Error("2captcha timeout");
+}
+const TASK_MAP = {
+    capsolver: {
+        recaptcha_v2: (o) => ({ type: "ReCaptchaV2TaskProxyLess", websiteURL: o.siteUrl, websiteKey: o.siteKey }),
+        recaptcha_v3: (o) => ({ type: "ReCaptchaV3TaskProxyLess", websiteURL: o.siteUrl, websiteKey: o.siteKey, pageAction: o.action ?? "verify" }),
+        hcaptcha: (o) => ({ type: "HCaptchaTaskProxyLess", websiteURL: o.siteUrl, websiteKey: o.siteKey }),
+        turnstile: (o) => ({ type: "AntiTurnstileTaskProxyLess", websiteURL: o.siteUrl, websiteKey: o.siteKey }),
+        datadome: (o) => ({ type: "DatadomeSliderTask", websiteURL: o.siteUrl, captchaUrl: o.captchaUrl, userAgent: o.userAgent, proxy: o.proxy }),
+    },
+    twocaptcha: {
+        recaptcha_v2: (o) => ({ type: "RecaptchaV2TaskProxyless", websiteURL: o.siteUrl, websiteKey: o.siteKey }),
+        recaptcha_v3: (o) => ({ type: "RecaptchaV3TaskProxyless", websiteURL: o.siteUrl, websiteKey: o.siteKey, pageAction: o.action ?? "verify" }),
+        hcaptcha: (o) => ({ type: "HCaptchaTaskProxyless", websiteURL: o.siteUrl, websiteKey: o.siteKey }),
+        turnstile: (o) => ({ type: "TurnstileTaskProxyless", websiteURL: o.siteUrl, websiteKey: o.siteKey }),
+        datadome: (o) => ({ type: "DataDomeSliderTask", websiteURL: o.siteUrl, captchaUrl: o.captchaUrl, userAgent: o.userAgent, proxyType: "http", proxyAddress: o.proxy }),
+    },
+};
+const SOLVERS = {
+    capsolver: capsolverSolve,
+    twocaptcha: twoCaptchaSolve,
+};
+export async function solve(opts) {
+    const providers = [
+        ...(config.captcha.capsolverKey ? ["capsolver"] : []),
+        ...(config.captcha.twocaptchaKey ? ["twocaptcha"] : []),
+    ];
+    for (const provider of providers) {
+        const taskBuilder = TASK_MAP[provider]?.[opts.type];
+        if (!taskBuilder)
+            continue;
+        try {
+            const task = taskBuilder(opts);
+            const solution = await SOLVERS[provider](task);
+            return {
+                token: solution.gRecaptchaResponse ?? solution.token,
+                cookie: solution.cookie,
+                provider,
+            };
+        }
+        catch (e) {
+            console.log(`  ${provider} failed: ${e.message}`);
+        }
+    }
+    throw new Error(`All providers failed for ${opts.type}`);
+}
+function sleep(ms) {
+    return new Promise((r) => setTimeout(r, ms));
+}
+//# sourceMappingURL=solver.js.map

package/dist/captcha/solver.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Shared configuration — single source of truth for all env vars.
+ *
+ * Platform-aware defaults:
+ *   Docker/Linux: /data/ (container volume mount)
+ *   macOS/local:  ~/.browser-autopilot/
+ */
+export interface Credentials {
+    username: string;
+    password: string;
+    email: string;
+    totpKey: string;
+}
+export interface ProxyConfig {
+    host: string;
+    port: string;
+}
+export interface BrowserConfig {
+    profileDir: string;
+    cdpPort: number;
+    dataDir: string;
+}
+export interface CaptchaConfig {
+    capsolverKey: string;
+    twocaptchaKey: string;
+    proxy: string;
+}
+export declare const config: {
+    isDocker: boolean;
+    credentials: Credentials;
+    proxy: ProxyConfig;
+    browser: BrowserConfig;
+    captcha: CaptchaConfig;
+    readonly cdpUrl: string;
+    readonly socks5Url: string;
+};

package/dist/config.js

@@ -0,0 +1,44 @@
+/**
+ * Shared configuration — single source of truth for all env vars.
+ *
+ * Platform-aware defaults:
+ *   Docker/Linux: /data/ (container volume mount)
+ *   macOS/local:  ~/.browser-autopilot/
+ */
+import { homedir } from "os";
+import { join } from "path";
+const isDocker = process.env.DOCKER === "1" || process.env.container != null
+    || (await import("fs")).existsSync("/.dockerenv");
+const localBase = join(homedir(), ".browser-autopilot");
+export const config = {
+    isDocker,
+    credentials: {
+        username: process.env.TWITTER_USER ?? "",
+        password: process.env.TWITTER_PASS ?? "",
+        email: process.env.TWITTER_EMAIL ?? "",
+        totpKey: process.env.TWITTER_TOTP_KEY ?? "",
+    },
+    proxy: {
+        host: process.env.PROXY_HOST ?? "127.0.0.1",
+        port: process.env.PROXY_PORT ?? "1080",
+    },
+    browser: {
+        profileDir: process.env.PROFILE_DIR
+            ?? (isDocker ? "/data/browser_sessions" : join(localBase, "sessions")),
+        cdpPort: parseInt(process.env.CDP_PORT ?? "9222"),
+        dataDir: process.env.DATA_DIR
+            ?? (isDocker ? "/data" : join(localBase, "data")),
+    },
+    captcha: {
+        capsolverKey: process.env.CAPSOLVER_KEY ?? "",
+        twocaptchaKey: process.env.TWOCAPTCHA_KEY ?? "",
+        proxy: process.env.CAPTCHA_PROXY ?? "",
+    },
+    get cdpUrl() {
+        return `http://127.0.0.1:${this.browser.cdpPort}`;
+    },
+    get socks5Url() {
+        return `socks5://${this.proxy.host}:${this.proxy.port}`;
+    },
+};
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,KAAK,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,IAAI;OACxE,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AAEnD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,oBAAoB,CAAC,CAAC;AA0BxD,MAAM,CAAC,MAAM,MAAM,GAAG;IACrB,QAAQ;IAER,WAAW,EAAE;QACZ,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,EAAE;QACxC,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,EAAE;QACxC,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,EAAE;QACtC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,EAAE;KAC5B;IAEhB,KAAK,EAAE;QACN,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,WAAW;QAC3C,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,MAAM;KACvB;IAEhB,OAAO,EAAE;QACR,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW;eAC/B,CAAC,QAAQ,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;QACvE,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,MAAM,CAAC;QACjD,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ;eACzB,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;KACjC;IAElB,OAAO,EAAE;QACR,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,EAAE;QAC7C,aAAa,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,EAAE;QAC/C,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,EAAE;KACrB;IAElB,IAAI,MAAM;QACT,OAAO,oBAAoB,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;IACnD,CAAC;IAED,IAAI,SAAS;QACZ,OAAO,YAAY,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IACzD,CAAC;CACD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Encumbrance — Autonomous browser agent.
+ *
+ * Automatically picks the right mode:
+ *   - Cached session? → straight to CDP agent
+ *   - CDP login works? → use it (fast)
+ *   - Bot detection? → fall back to X11 (stealth)
+ */
+export { X11Agent } from "./x11/agent.js";
+export { CDPBrowser } from "./browser/cdp.js";
+export { DOMIndexer, type IndexedElement } from "./browser/dom.js";
+export { runAgent, type AgentOptions } from "./agent/loop.js";
+export { createBrowserTools } from "./agent/tools.js";
+export { AgentHistory, type StepRecord } from "./agent/history.js";
+export { captureBrowserState, formatStateForLLM } from "./agent/state.js";
+export { solve as solveCaptcha } from "./captcha/solver.js";
+export { login } from "./x11/login.js";
+export { orchestrate, type OrchestratorOptions, type OrchestratorResult } from "./orchestrator.js";
+export { startViewer } from "./viewer/server.js";
+export { config } from "./config.js";

package/dist/index.js

@@ -0,0 +1,43 @@
+/**
+ * Encumbrance — Autonomous browser agent.
+ *
+ * Automatically picks the right mode:
+ *   - Cached session? → straight to CDP agent
+ *   - CDP login works? → use it (fast)
+ *   - Bot detection? → fall back to X11 (stealth)
+ */
+// Library exports
+export { X11Agent } from "./x11/agent.js";
+export { CDPBrowser } from "./browser/cdp.js";
+export { DOMIndexer } from "./browser/dom.js";
+export { runAgent } from "./agent/loop.js";
+export { createBrowserTools } from "./agent/tools.js";
+export { AgentHistory } from "./agent/history.js";
+export { captureBrowserState, formatStateForLLM } from "./agent/state.js";
+export { solve as solveCaptcha } from "./captcha/solver.js";
+export { login } from "./x11/login.js";
+export { orchestrate } from "./orchestrator.js";
+export { startViewer } from "./viewer/server.js";
+export { config } from "./config.js";
+// CLI entrypoint
+import { orchestrate } from "./orchestrator.js";
+import { config } from "./config.js";
+async function main() {
+    const { result, success, loginMethod } = await orchestrate({
+        credentials: config.credentials,
+        loginUrl: process.env.LOGIN_URL ?? "https://x.com/login",
+        successUrlContains: process.env.SUCCESS_URL ?? "/home",
+        task: process.env.AGENT_TASK ?? "Navigate to the home page and describe what you see.",
+        maxSteps: parseInt(process.env.MAX_STEPS ?? "80"),
+    });
+    console.log("\n" + "=".repeat(50));
+    console.log(`Login: ${loginMethod}`);
+    console.log(`Success: ${success}`);
+    if (result)
+        console.log(`Result:\n${result}`);
+    console.log("=".repeat(50));
+}
+if (process.argv[1]?.endsWith("index.ts") || process.argv[1]?.endsWith("index.js")) {
+    main().catch((e) => { console.error(e); process.exit(1); });
+}
+//# 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;;;;;;;GAOG;AAEH,kBAAkB;AAClB,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAuB,MAAM,kBAAkB,CAAC;AACnE,OAAO,EAAE,QAAQ,EAAqB,MAAM,iBAAiB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAmB,MAAM,oBAAoB,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,KAAK,IAAI,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAE,WAAW,EAAqD,MAAM,mBAAmB,CAAC;AACnG,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,iBAAiB;AACjB,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,KAAK,UAAU,IAAI;IAClB,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,MAAM,WAAW,CAAC;QAC1D,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,qBAAqB;QACxD,kBAAkB,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,OAAO;QACtD,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,sDAAsD;QACtF,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,IAAI,CAAC;KACjD,CAAC,CAAC;IAEH,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IACnC,OAAO,CAAC,GAAG,CAAC,UAAU,WAAW,EAAE,CAAC,CAAC;IACrC,OAAO,CAAC,GAAG,CAAC,YAAY,OAAO,EAAE,CAAC,CAAC;IACnC,IAAI,MAAM;QAAE,OAAO,CAAC,GAAG,CAAC,YAAY,MAAM,EAAE,CAAC,CAAC;IAC9C,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;AAC7B,CAAC;AAED,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,UAAU,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;IACpF,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC7D,CAAC"}

package/dist/orchestrator.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Orchestrator — automatically decides between CDP and X11 modes.
+ *
+ * Flow:
+ *   1. Launch Chrome with CDP port open (but no client attached)
+ *   2. Check if already logged in (cookies from previous run)
+ *   3. If logged in → skip to CDP agent
+ *   4. If not logged in → try CDP login first (fast, indexed DOM)
+ *   5. If CDP login fails (bot detection) → disconnect CDP, fall back to X11
+ *   6. After login → connect CDP agent for the actual task
+ *
+ * The user never needs to specify which mode to use.
+ */
+import { CDPBrowser } from "./browser/cdp.js";
+import { type Credentials } from "./config.js";
+interface OrchestratorOptions {
+    credentials: Credentials;
+    loginUrl: string;
+    successUrlContains: string;
+    task: string;
+    maxSteps?: number;
+    extraTools?: Record<string, any>;
+    loginPrompt?: string;
+    keepBrowser?: boolean;
+}
+interface OrchestratorResult {
+    result: string | null;
+    success: boolean;
+    loginMethod: "cached" | "cdp" | "x11" | "failed";
+    browser?: CDPBrowser;
+}
+export declare function orchestrate(opts: OrchestratorOptions): Promise<OrchestratorResult>;
+export { type OrchestratorOptions, type OrchestratorResult };

package/dist/orchestrator.js

@@ -0,0 +1,197 @@
+/**
+ * Orchestrator — automatically decides between CDP and X11 modes.
+ *
+ * Flow:
+ *   1. Launch Chrome with CDP port open (but no client attached)
+ *   2. Check if already logged in (cookies from previous run)
+ *   3. If logged in → skip to CDP agent
+ *   4. If not logged in → try CDP login first (fast, indexed DOM)
+ *   5. If CDP login fails (bot detection) → disconnect CDP, fall back to X11
+ *   6. After login → connect CDP agent for the actual task
+ *
+ * The user never needs to specify which mode to use.
+ */
+import { CDPBrowser } from "./browser/cdp.js";
+import { X11Agent } from "./x11/agent.js";
+import * as chrome from "./x11/chrome.js";
+import * as x11Input from "./x11/input.js";
+import { runAgent } from "./agent/loop.js";
+import { authenticator } from "otplib";
+const BOT_DETECTION_SIGNALS = [
+    "could not log you in",
+    "something went wrong",
+    "try again later",
+    "unusual login activity",
+    "suspicious activity",
+    "verify you are human",
+    "captcha",
+    "challenge",
+];
+export async function orchestrate(opts) {
+    const { credentials, loginUrl, successUrlContains, task, maxSteps = 80, extraTools = {}, } = opts;
+    console.log("╔══════════════════════════════════════╗");
+    console.log("║      browser-autopilot orchestrator   ║");
+    console.log("╚══════════════════════════════════════╝");
+    console.log(`  user: ${credentials.username}`);
+    console.log(`  login: ${loginUrl}`);
+    console.log(`  success: URL contains "${successUrlContains}"`);
+    console.log();
+    // ── Step 1: Launch Chrome ────────────────────────────────────────────
+    const pid = chrome.launch(loginUrl, credentials.username);
+    console.log(`Chrome launched (pid=${pid})`);
+    // Wait for Chrome + page load
+    console.log("Waiting for Chrome...");
+    for (let i = 0; i < 30; i++) {
+        if (chrome.getPageUrls().length > 0)
+            break;
+        x11Input.sleep(1000);
+    }
+    x11Input.sleep(5000);
+    // ── Step 2: Check if already logged in ──────────────────────────────
+    if (chrome.pageUrlContains(successUrlContains)) {
+        console.log("✓ Already logged in (cached session)\n");
+        return await runCDPAgent(task, maxSteps, extraTools, "cached", opts.keepBrowser);
+    }
+    // ── Step 3: Try CDP login first ─────────────────────────────────────
+    console.log("Attempting CDP login...");
+    const cdpResult = await tryCDPLogin(credentials, loginUrl, successUrlContains);
+    if (cdpResult === "success") {
+        console.log("✓ CDP login succeeded\n");
+        return await runCDPAgent(task, maxSteps, extraTools, "cdp", opts.keepBrowser);
+    }
+    if (cdpResult === "bot_detected") {
+        console.log("⚠ Bot detection triggered — falling back to X11\n");
+    }
+    else {
+        console.log("⚠ CDP login failed — falling back to X11\n");
+    }
+    // ── Step 4: Fall back to X11 login ──────────────────────────────────
+    // Kill Chrome and relaunch fresh (CDP tainted the session)
+    try {
+        process.kill(pid);
+        x11Input.sleep(2000);
+    }
+    catch { }
+    const freshPid = chrome.launch(loginUrl, credentials.username);
+    console.log(`Fresh Chrome launched (pid=${freshPid})`);
+    for (let i = 0; i < 30; i++) {
+        if (chrome.getPageUrls().length > 0)
+            break;
+        x11Input.sleep(1000);
+    }
+    x11Input.sleep(5000);
+    x11Input.focusWindow("Log in", "X", "x.com", "Twitter", "Google Chrome", "Sign in");
+    x11Input.sleep(2000);
+    const x11Success = await runX11Login(credentials, successUrlContains, opts.loginPrompt);
+    if (!x11Success) {
+        console.log("✗ X11 login also failed\n");
+        return { result: null, success: false, loginMethod: "failed" };
+    }
+    console.log("✓ X11 login succeeded\n");
+    return await runCDPAgent(task, maxSteps, extraTools, "x11", opts.keepBrowser);
+}
+// ── CDP login attempt ────────────────────────────────────────────────────────
+async function tryCDPLogin(creds, loginUrl, successUrl) {
+    const browser = new CDPBrowser();
+    try {
+        await browser.connect();
+        // Navigate to login
+        await browser.navigate(loginUrl);
+        await browser.waitMs(3000);
+        // Check page text for bot detection signals
+        const text = await browser.getPageText();
+        const lowerText = text.toLowerCase();
+        if (BOT_DETECTION_SIGNALS.some((sig) => lowerText.includes(sig))) {
+            await browser.disconnect();
+            return "bot_detected";
+        }
+        // Try quick login via CDP
+        const loginTask = `
+Login to this page with:
+- Username: ${creds.username}
+- Email: ${creds.email}
+- Password: ${creds.password}
+- For 2FA, call get_totp_code
+
+After login, call done with "login complete".
+If you see "could not log you in", "something went wrong", or any bot detection message, call done with "bot_detected".
+`;
+        const { result } = await runAgent({
+            task: loginTask,
+            browser,
+            maxSteps: 15,
+            maxFailures: 3,
+        });
+        await browser.disconnect();
+        if (result?.includes("bot_detected"))
+            return "bot_detected";
+        if (chrome.pageUrlContains(successUrl))
+            return "success";
+        return "failed";
+    }
+    catch {
+        try {
+            await browser.disconnect();
+        }
+        catch { }
+        return "failed";
+    }
+}
+// ── X11 login ────────────────────────────────────────────────────────────────
+async function runX11Login(creds, successUrl, customPrompt) {
+    const prompt = customPrompt ?? buildDefaultLoginPrompt(creds);
+    const agent = new X11Agent();
+    return agent.run({
+        systemPrompt: prompt,
+        successCheck: () => chrome.pageUrlContains(successUrl),
+        onAction: (type, value) => {
+            if (type === "inject" && value === "TOTP") {
+                const code = authenticator.generate(creds.totpKey);
+                console.log(`  totp: ${code}`);
+                x11Input.typeText(code, 100);
+            }
+        },
+    });
+}
+function buildDefaultLoginPrompt(creds) {
+    return `You are controlling a Chrome browser via X11 keyboard input to log in.
+You see screenshots of the browser. Based on what you see, tell me what action to take.
+
+Credentials:
+- Username: ${creds.username}
+- Email: ${creds.email}
+- Password: ${creds.password}
+- For 2FA/TOTP: say ACTION: INJECT TOTP
+
+RULES:
+- Use ONLY keyboard. No clicking.
+- If you see a login form, TYPE the username immediately, then KEY Return.
+- If asked for email/phone verification, TYPE the email, then KEY Return.
+- If you see a password field, TYPE the password, then KEY Return.
+- For 2FA, use INJECT TOTP then KEY Return.
+- NEVER wait more than 3 seconds. NEVER wait more than 2 times in a row.
+
+Actions (ONE per message):
+ACTION: TYPE text
+ACTION: KEY keyname (Return, Tab, Escape)
+ACTION: WAIT seconds (max 3)
+ACTION: INJECT TOTP
+ACTION: DONE (when logged in)
+ACTION: FAILED reason`;
+}
+// ── CDP agent (post-login) ───────────────────────────────────────────────────
+async function runCDPAgent(task, maxSteps, extraTools, loginMethod, keepBrowser = false) {
+    const browser = new CDPBrowser();
+    await browser.connect();
+    console.log("CDP connected\n");
+    const { result, success } = await runAgent({
+        task,
+        browser,
+        maxSteps,
+        extraTools,
+    });
+    if (!keepBrowser)
+        await browser.disconnect();
+    return { result, success, loginMethod, browser: keepBrowser ? browser : undefined };
+}
+//# sourceMappingURL=orchestrator.js.map

package/dist/orchestrator.js.map

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

package/dist/viewer/server.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Live browser viewer — streams the Xvfb display over WebSocket.
+ *
+ * Uses x11vnc + websockify to expose the virtual display as a
+ * noVNC-compatible stream. Open the URL in any browser to watch
+ * the agent work in real-time.
+ *
+ * Architecture:
+ *   Xvfb (:99) → x11vnc (port 5900) → websockify (port 6080) → browser
+ */
+export declare function startViewer(): {
+    url: string;
+    stop: () => void;
+};