wotann 0.5.0

package/dist/browser/browser-tools.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Browser Agent Tools — tool schemas and dispatch wrappers for the Chrome
+ * DevTools bridge + Camoufox stealth backend.
+ *
+ * Design:
+ * - `browser.goto`, `browser.click`, `browser.type`, `browser.screenshot`,
+ *   `browser.read_page` are the five agent-facing operations.
+ * - At dispatch time the handler picks a backend (Chrome bridge when CDP
+ *   is available, else Camoufox when the Python driver boots, else
+ *   returns `not_configured`). The selection is honest — if neither
+ *   backend is reachable we refuse rather than silently succeeding.
+ * - Every URL passed to `browser.goto` is SSRF-guarded so the agent
+ *   cannot be tricked into scraping cloud metadata endpoints.
+ */
+import type { ToolDefinition } from "../core/types.js";
+import { ChromeBridge } from "./chrome-bridge.js";
+import { CamoufoxBrowser } from "./camoufox-backend.js";
+import type { BrowsePlan, BrowsePlanStep } from "./agentic-browser.js";
+import type { TabRegistry } from "./tab-registry.js";
+export type BrowserToolOk<T> = {
+    readonly ok: true;
+    readonly data: T;
+};
+export type BrowserToolErr = {
+    readonly ok: false;
+    readonly error: "not_configured" | "bad_input" | "ssrf_blocked" | "navigation_failed" | "upstream_error";
+    readonly detail?: string;
+};
+export type BrowserToolResult<T> = BrowserToolOk<T> | BrowserToolErr;
+export declare const BROWSER_TOOL_NAMES: readonly ["browser.goto", "browser.click", "browser.type", "browser.screenshot", "browser.read_page", "browser.plan", "browser.spawn_tab", "browser.approve_action"];
+export type BrowserToolName = (typeof BROWSER_TOOL_NAMES)[number];
+export declare function isBrowserTool(name: string): name is BrowserToolName;
+export declare function buildBrowserToolDefinitions(): readonly ToolDefinition[];
+/**
+ * Injected orchestrator hooks for the agentic trio
+ * (browser.plan / browser.spawn_tab / browser.approve_action).
+ *
+ * All three fields are optional: when an orchestrator callback is
+ * absent the corresponding tool returns an honest empty/failed
+ * envelope rather than silently succeeding (QB #6).
+ */
+export interface BrowserAgenticDep {
+    /**
+     * Returns the current plan for `task`. When missing or throwing,
+     * browser.plan responds with `{plan:[]}` so callers can distinguish
+     * "no planner available" from "planner produced 0 steps".
+     */
+    readonly plan?: (task: string) => Promise<BrowsePlan> | BrowsePlan;
+    /** Per-session tab registry (see src/browser/tab-registry.ts). */
+    readonly tabRegistry?: TabRegistry;
+    /**
+     * Factory for new CDP target IDs. Tests inject a deterministic
+     * counter; prod wires this to the CDP `Target.createTarget` result.
+     */
+    readonly spawnTabId?: (url?: string) => string;
+    /**
+     * Delegate the allow/deny decision to the approval queue. Returns
+     * `true` iff the queue accepted the decision. A throw or a `false`
+     * return collapses to `{ok:false}` on the tool result.
+     */
+    readonly decideApproval?: (actionId: string, decision: "allow" | "deny") => Promise<boolean> | boolean;
+}
+export interface BrowserDep {
+    chrome?: ChromeBridge | null;
+    camoufox?: CamoufoxBrowser | null;
+    agentic?: BrowserAgenticDep;
+}
+export declare function dispatchBrowserTool(toolName: BrowserToolName, input: Record<string, unknown>, dep: BrowserDep): Promise<BrowserToolResult<unknown>>;
+/**
+ * Plan-step summary returned by browser.plan. Slimmed vs. the full
+ * `BrowsePlanStep` so the LLM sees only what it needs to reason about
+ * next actions (id / kind / rationale / optional target).
+ */
+export interface BrowserPlanStepSummary {
+    readonly id: string;
+    readonly kind: BrowsePlanStep["kind"];
+    readonly rationale: string;
+    readonly target?: string;
+}
+export type BrowserSpawnTabResult = {
+    readonly tabId: string;
+    readonly ownership: "user" | "agent";
+} | {
+    readonly rejected: string;
+};
+//# sourceMappingURL=browser-tools.d.ts.map

package/dist/browser/browser-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-tools.d.ts","sourceRoot":"","sources":["../../src/browser/browser-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,KAAK,EAAE,WAAW,EAAY,MAAM,mBAAmB,CAAC;AAI/D,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAA;CAAE,CAAC;AACvE,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IACnB,QAAQ,CAAC,KAAK,EACV,gBAAgB,GAChB,WAAW,GACX,cAAc,GACd,mBAAmB,GACnB,gBAAgB,CAAC;IACrB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AACF,MAAM,MAAM,iBAAiB,CAAC,CAAC,IAAI,aAAa,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC;AAIrE,eAAO,MAAM,kBAAkB,sKASrB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAElE,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,eAAe,CAEnE;AAQD,wBAAgB,2BAA2B,IAAI,SAAS,cAAc,EAAE,CA0FvE;AAID;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,GAAG,UAAU,CAAC;IACnE,kEAAkE;IAClE,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC;IACnC;;;OAGG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IAC/C;;;;OAIG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,CACxB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,OAAO,GAAG,MAAM,KACvB,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;CACjC;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;IAClC,OAAO,CAAC,EAAE,iBAAiB,CAAC;CAC7B;AA2BD,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,eAAe,EACzB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,GAAG,EAAE,UAAU,GACd,OAAO,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CA4GrC;AAID;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,MAAM,qBAAqB,GAC7B;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,GAChE;IAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/dist/browser/browser-tools.js

@@ -0,0 +1,329 @@
+/**
+ * Browser Agent Tools — tool schemas and dispatch wrappers for the Chrome
+ * DevTools bridge + Camoufox stealth backend.
+ *
+ * Design:
+ * - `browser.goto`, `browser.click`, `browser.type`, `browser.screenshot`,
+ *   `browser.read_page` are the five agent-facing operations.
+ * - At dispatch time the handler picks a backend (Chrome bridge when CDP
+ *   is available, else Camoufox when the Python driver boots, else
+ *   returns `not_configured`). The selection is honest — if neither
+ *   backend is reachable we refuse rather than silently succeeding.
+ * - Every URL passed to `browser.goto` is SSRF-guarded so the agent
+ *   cannot be tricked into scraping cloud metadata endpoints.
+ */
+import { isSafeUrl } from "../security/ssrf-guard.js";
+// ── Tool Names ──────────────────────────────────────────────
+export const BROWSER_TOOL_NAMES = [
+    "browser.goto",
+    "browser.click",
+    "browser.type",
+    "browser.screenshot",
+    "browser.read_page",
+    "browser.plan",
+    "browser.spawn_tab",
+    "browser.approve_action",
+];
+export function isBrowserTool(name) {
+    return BROWSER_TOOL_NAMES.includes(name);
+}
+// ── Schemas ─────────────────────────────────────────────────
+function stringProp(description) {
+    return { type: "string", description };
+}
+export function buildBrowserToolDefinitions() {
+    return [
+        {
+            name: "browser.goto",
+            description: "Navigate the agent-controlled browser to `url`. Uses the Chrome CDP bridge when a " +
+                "Chromium browser is running with --remote-debugging-port=9222, else falls back to " +
+                "Camoufox (stealth Firefox) when the python driver is installed. Blocks cloud " +
+                "metadata endpoints and private IPs.",
+            inputSchema: {
+                type: "object",
+                properties: { url: stringProp("Absolute http(s) URL to navigate to") },
+                required: ["url"],
+            },
+        },
+        {
+            name: "browser.click",
+            description: "Click the first element matching the CSS selector on the current page.",
+            inputSchema: {
+                type: "object",
+                properties: { selector: stringProp("CSS selector") },
+                required: ["selector"],
+            },
+        },
+        {
+            name: "browser.type",
+            description: "Type text into the element matching the CSS selector.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    selector: stringProp("CSS selector for the input"),
+                    text: stringProp("Text to type"),
+                },
+                required: ["selector", "text"],
+            },
+        },
+        {
+            name: "browser.screenshot",
+            description: "Capture a screenshot of the current page. Returns the saved path.",
+            inputSchema: { type: "object", properties: {} },
+        },
+        {
+            name: "browser.read_page",
+            description: "Read visible text content from the current page. Preferred for non-vision models " +
+                "since the DOM is converted to a structured text tree.",
+            inputSchema: { type: "object", properties: {} },
+        },
+        {
+            name: "browser.plan",
+            description: "Return the agentic-browser orchestrator's current plan for `task` as an ordered list " +
+                "of step rationales. Inspection-only — execution stays with browser.goto/click/type.",
+            inputSchema: {
+                type: "object",
+                properties: { task: stringProp("Natural-language task the agent should plan for") },
+                required: ["task"],
+            },
+        },
+        {
+            name: "browser.spawn_tab",
+            description: 'Spawn a new browser tab and register it in the tab-registry. `ownership` is "user" ' +
+                '(user-driven) or "agent" (agent-driven, counted against maxAgentTabs). Returns the ' +
+                "new tabId, or `{rejected}` with a reason when the agent cap is exceeded.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    ownership: { type: "string", description: '"user" or "agent"' },
+                    url: stringProp("Optional initial URL for the new tab"),
+                    taskId: stringProp("Optional taskId when ownership=agent (groups tabs by task)"),
+                },
+                required: ["ownership"],
+            },
+        },
+        {
+            name: "browser.approve_action",
+            description: "Dispatch an allow/deny decision for a pending approval raised by the agentic browser. " +
+                "Returns `{ok:false}` when the approvalId is unknown or already decided (honest failure).",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    actionId: stringProp("The approvalId (or queued actionId) returned at request time"),
+                    decision: { type: "string", description: '"allow" or "deny"' },
+                },
+                required: ["actionId", "decision"],
+            },
+        },
+    ];
+}
+async function pickBackend(dep) {
+    if (dep.chrome) {
+        try {
+            if (await dep.chrome.isAvailable())
+                return "chrome";
+        }
+        catch {
+            // fall through
+        }
+    }
+    if (dep.camoufox) {
+        if (dep.camoufox.isLaunched())
+            return "camoufox";
+        try {
+            if (await dep.camoufox.launch())
+                return "camoufox";
+        }
+        catch {
+            /* fall through */
+        }
+    }
+    return null;
+}
+function errEnv(error, detail) {
+    return { ok: false, error, ...(detail !== undefined ? { detail } : {}) };
+}
+// ── Dispatcher ──────────────────────────────────────────────
+export async function dispatchBrowserTool(toolName, input, dep) {
+    // Agentic trio — these don't need a page-bound backend; they
+    // delegate to the orchestrator / tab-registry / approval queue.
+    if (toolName === "browser.plan" ||
+        toolName === "browser.spawn_tab" ||
+        toolName === "browser.approve_action") {
+        return dispatchAgenticTool(toolName, input, dep.agentic);
+    }
+    const backend = await pickBackend(dep);
+    if (!backend) {
+        return errEnv("not_configured", "no browser backend available (need Chromium CDP or Camoufox)");
+    }
+    switch (toolName) {
+        case "browser.goto": {
+            const url = input["url"];
+            if (typeof url !== "string" || url.trim().length === 0)
+                return errEnv("bad_input", "url required");
+            if (!isSafeUrl(url))
+                return errEnv("ssrf_blocked", url);
+            if (backend === "chrome" && dep.chrome) {
+                const result = await dep.chrome.execute({ type: "navigate", url });
+                return result.success
+                    ? { ok: true, data: { url, backend } }
+                    : errEnv("navigation_failed", result.error);
+            }
+            if (backend === "camoufox" && dep.camoufox) {
+                const result = await dep.camoufox.newPage(url);
+                return result.success
+                    ? { ok: true, data: { url: result.url, title: result.title, backend } }
+                    : errEnv("navigation_failed", result.error);
+            }
+            return errEnv("not_configured", "backend vanished");
+        }
+        case "browser.click": {
+            const selector = input["selector"];
+            if (typeof selector !== "string" || selector.trim().length === 0)
+                return errEnv("bad_input", "selector required");
+            if (backend === "chrome" && dep.chrome) {
+                const result = await dep.chrome.execute({ type: "click", selector });
+                return result.success
+                    ? { ok: true, data: { selector } }
+                    : errEnv("navigation_failed", result.error);
+            }
+            if (backend === "camoufox" && dep.camoufox) {
+                const result = await dep.camoufox.click(selector);
+                return result.success
+                    ? { ok: true, data: { selector } }
+                    : errEnv("navigation_failed", result.error);
+            }
+            return errEnv("not_configured", "backend vanished");
+        }
+        case "browser.type": {
+            const selector = input["selector"];
+            const text = input["text"];
+            if (typeof selector !== "string" || typeof text !== "string")
+                return errEnv("bad_input", "selector + text required");
+            if (backend === "chrome" && dep.chrome) {
+                const result = await dep.chrome.execute({ type: "type", selector, value: text });
+                return result.success
+                    ? { ok: true, data: { selector, bytes: text.length } }
+                    : errEnv("navigation_failed", result.error);
+            }
+            if (backend === "camoufox" && dep.camoufox) {
+                const result = await dep.camoufox.type(selector, text);
+                return result.success
+                    ? { ok: true, data: { selector, bytes: text.length } }
+                    : errEnv("navigation_failed", result.error);
+            }
+            return errEnv("not_configured", "backend vanished");
+        }
+        case "browser.screenshot": {
+            if (backend === "chrome" && dep.chrome) {
+                const result = await dep.chrome.execute({ type: "screenshot" });
+                return result.success
+                    ? { ok: true, data: { path: result.screenshotPath ?? "", backend } }
+                    : errEnv("upstream_error", result.error);
+            }
+            if (backend === "camoufox" && dep.camoufox) {
+                const result = await dep.camoufox.screenshot();
+                return result.success
+                    ? { ok: true, data: { path: result.path, backend } }
+                    : errEnv("upstream_error", result.error);
+            }
+            return errEnv("not_configured", "backend vanished");
+        }
+        case "browser.read_page": {
+            if (backend === "chrome" && dep.chrome) {
+                const result = await dep.chrome.execute({ type: "read_dom" });
+                if (!result.success)
+                    return errEnv("upstream_error", result.error);
+                const text = result.domTree ? dep.chrome.domToText(result.domTree) : (result.data ?? "");
+                return { ok: true, data: { text, backend } };
+            }
+            if (backend === "camoufox" && dep.camoufox) {
+                const result = await dep.camoufox.getText();
+                return result.success
+                    ? { ok: true, data: { text: result.text, backend } }
+                    : errEnv("upstream_error", result.error);
+            }
+            return errEnv("not_configured", "backend vanished");
+        }
+        default: {
+            const _exhaustive = toolName;
+            return errEnv("bad_input", `unknown tool: ${String(_exhaustive)}`);
+        }
+    }
+}
+async function dispatchAgenticTool(toolName, input, agentic) {
+    switch (toolName) {
+        case "browser.plan": {
+            const task = input["task"];
+            if (typeof task !== "string" || task.trim().length === 0)
+                return errEnv("bad_input", "task required");
+            // Honest failure: with no planner we return an empty plan rather
+            // than fabricate steps (QB #6).
+            if (!agentic || !agentic.plan) {
+                return { ok: true, data: { plan: [] } };
+            }
+            try {
+                const plan = await agentic.plan(task);
+                const summary = plan.steps.map((s) => ({
+                    id: s.id,
+                    kind: s.kind,
+                    rationale: s.rationale,
+                    ...(s.target !== undefined ? { target: s.target } : {}),
+                }));
+                return { ok: true, data: { plan: summary } };
+            }
+            catch (err) {
+                const detail = err instanceof Error ? err.message : String(err);
+                return errEnv("upstream_error", `planner: ${detail.slice(0, 200)}`);
+            }
+        }
+        case "browser.spawn_tab": {
+            const ownership = input["ownership"];
+            if (ownership !== "user" && ownership !== "agent")
+                return errEnv("bad_input", 'ownership must be "user" or "agent"');
+            const urlRaw = input["url"];
+            const url = typeof urlRaw === "string" && urlRaw.length > 0 ? urlRaw : undefined;
+            if (url !== undefined && !isSafeUrl(url))
+                return errEnv("ssrf_blocked", url);
+            const taskIdRaw = input["taskId"];
+            const taskId = typeof taskIdRaw === "string" && taskIdRaw.length > 0 ? taskIdRaw : "default";
+            if (!agentic || !agentic.tabRegistry)
+                return errEnv("not_configured", "tab-registry not wired");
+            const tabId = agentic.spawnTabId?.(url) ?? `tab-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+            const owner = ownership === "user" ? { kind: "user" } : { kind: "agent", taskId };
+            const result = agentic.tabRegistry.register(url !== undefined ? { tabId, owner, url } : { tabId, owner });
+            if (!result.ok) {
+                const data = {
+                    rejected: result.error === "max-agent-tabs-exceeded" ? "max agent tabs exceeded" : result.error,
+                };
+                return { ok: true, data };
+            }
+            const data = { tabId: result.tab.tabId, ownership };
+            return { ok: true, data };
+        }
+        case "browser.approve_action": {
+            const actionId = input["actionId"];
+            const decision = input["decision"];
+            if (typeof actionId !== "string" || actionId.trim().length === 0)
+                return errEnv("bad_input", "actionId required");
+            if (decision !== "allow" && decision !== "deny")
+                return errEnv("bad_input", 'decision must be "allow" or "deny"');
+            if (!agentic || !agentic.decideApproval) {
+                return { ok: true, data: { ok: false, detail: "approval-queue not wired" } };
+            }
+            try {
+                const accepted = await agentic.decideApproval(actionId, decision);
+                return { ok: true, data: { ok: accepted === true } };
+            }
+            catch (err) {
+                const detail = err instanceof Error ? err.message : String(err);
+                return { ok: true, data: { ok: false, detail: detail.slice(0, 200) } };
+            }
+        }
+        default: {
+            const _exhaustive = toolName;
+            return errEnv("bad_input", `unknown agentic tool: ${String(_exhaustive)}`);
+        }
+    }
+}
+//# sourceMappingURL=browser-tools.js.map

package/dist/browser/browser-tools.js.map

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

package/dist/browser/camoufox-backend.d.ts

@@ -0,0 +1,166 @@
+/**
+ * Camoufox Stealth Browser Backend — anti-detect browsing for web scraping.
+ *
+ * Camoufox is a Firefox fork that injects fingerprints at the C++ level,
+ * making it virtually undetectable by anti-bot systems. It integrates with
+ * Playwright via a Python wrapper (camoufox package).
+ *
+ * ARCHITECTURE (persistent JSON-RPC):
+ *
+ *   TS client  ──stdin──>  python driver  ──stdout──>  TS client
+ *                               │
+ *                               └── Camoufox (or Playwright, or stub)
+ *
+ * The driver process is spawned ONCE on first call and kept alive across
+ * every subsequent op. Cookies, fingerprint, and page state persist for
+ * the lifetime of the CamoufoxBrowser instance. `close()` terminates the
+ * driver cleanly by sending `{method:"close"}` and awaiting exit.
+ *
+ * Wire format is one JSON object per line:
+ *
+ *   request  = { "id": "<uuid>", "method": "<name>", "params": { ... } }
+ *   response = { "id": "<uuid>", "result": <json> } | { "id": ..., "error": {"message": "..."} }
+ *   banner   = { "ready": true, "backend": "camoufox" | "playwright" | "stub" }
+ *
+ * Stdout is RPC-only. The python side writes every diagnostic to stderr
+ * so the JSON channel stays clean. Parser failures are treated as fatal
+ * and surface through pending RPC rejections.
+ *
+ * BACKEND SELECTION (in the driver):
+ *   1. camoufox    — real stealth browser when the pip package is installed
+ *   2. playwright  — fallback to vanilla Chromium when only playwright is installed
+ *   3. stub        — deterministic no-op for CI / local test runs
+ *
+ * Set `WOTANN_CAMOUFOX_REAL=1` to refuse the stub path and surface an error
+ * instead when no real browser backend is available.
+ *
+ * USAGE:
+ *   const browser = new CamoufoxBrowser();
+ *   await browser.launch();
+ *   const page = await browser.newPage("https://example.com");
+ *   const text = await browser.getText();
+ *   await browser.close();
+ */
+export interface CamoufoxConfig {
+    readonly headless: boolean;
+    readonly humanize: boolean;
+    readonly timeout: number;
+    readonly screenshotDir: string;
+    /** Override the driver script path (primarily for tests). */
+    readonly driverScript?: string;
+    /** Override the python interpreter command. */
+    readonly pythonCmd?: string;
+}
+export interface PageResult {
+    readonly url: string;
+    readonly title: string;
+    readonly success: boolean;
+    readonly error?: string;
+}
+export interface ScreenshotResult {
+    readonly path: string;
+    readonly success: boolean;
+    readonly error?: string;
+}
+export interface TextResult {
+    readonly text: string;
+    readonly success: boolean;
+    readonly error?: string;
+}
+export interface ClickResult {
+    readonly success: boolean;
+    readonly error?: string;
+}
+export interface TypeResult {
+    readonly success: boolean;
+    readonly error?: string;
+}
+/** Which backend the python driver actually booted. */
+export type DriverBackend = "camoufox" | "playwright" | "stub";
+/**
+ * Check whether the camoufox Python package is installed and importable.
+ * Returns true if the package is available, false otherwise.
+ *
+ * This is the "real stealth" check. The persistent driver will still boot
+ * in playwright or stub mode when this returns false.
+ */
+export declare function isAvailable(pythonCmd?: string): boolean;
+/**
+ * Long-lived Camoufox session backed by a persistent python subprocess.
+ *
+ * Methods are async because they speak JSON-RPC to the driver. Each call
+ * writes one request line on the driver's stdin and resolves when the
+ * matching id appears on stdout. Driver stderr is logged to Node's stderr
+ * so users can diagnose python-side failures without polluting the RPC
+ * channel.
+ *
+ * Crash handling: if the driver exits between calls, the next call will
+ * respawn the driver once (MAX_CRASH_RETRIES). If it crashes again the
+ * method returns an error result and leaves the instance in a closed
+ * state — callers may call `launch()` again to retry.
+ */
+export declare class CamoufoxBrowser {
+    private readonly config;
+    private readonly pythonCmd;
+    private readonly driverScript;
+    private child;
+    private stdoutRl;
+    private readyPromise;
+    private readonly pending;
+    private nextId;
+    private closed;
+    private crashRetries;
+    private currentUrl;
+    private lastBackend;
+    constructor(config?: Partial<CamoufoxConfig>);
+    /**
+     * Launch the persistent driver subprocess and wait for the ready banner.
+     * Safe to call multiple times — subsequent calls short-circuit.
+     */
+    launch(): Promise<boolean>;
+    /**
+     * Navigate the persistent browser to `url`. The session (cookies,
+     * fingerprint, local storage) carries over from previous calls.
+     */
+    newPage(url: string): Promise<PageResult>;
+    /** Click an element on the current page. */
+    click(selector: string): Promise<ClickResult>;
+    /** Type text into a selector on the current page. */
+    type(selector: string, text: string): Promise<TypeResult>;
+    /** Evaluate a JS expression in the current page context. */
+    evaluate<T = unknown>(expression: string): Promise<{
+        value: T | null;
+        success: boolean;
+        error?: string;
+    }>;
+    /** Capture a screenshot of the current page. */
+    screenshot(): Promise<ScreenshotResult>;
+    /** Extract visible text content from the current page. */
+    getText(): Promise<TextResult>;
+    /**
+     * Send `{method:"close"}` and wait for the driver to exit. Idempotent.
+     */
+    close(): Promise<boolean>;
+    /** Whether the driver subprocess is currently running. */
+    isLaunched(): boolean;
+    /** The currently loaded URL, if any. */
+    getCurrentUrl(): string;
+    /** Which driver backend booted — 'camoufox', 'playwright', or 'stub'. */
+    getBackend(): DriverBackend | null;
+    private ensureStarted;
+    private spawnDriver;
+    private handleRpcResponse;
+    private handleChildExit;
+    private forceKill;
+    private logStderr;
+    /**
+     * Send a JSON-RPC request to the driver and await the matching response.
+     *
+     * Restarts the driver once if it crashed between calls (MAX_CRASH_RETRIES).
+     * Times out after `config.timeout + 10s` to match the driver-side timeout
+     * with slack for serialisation.
+     */
+    private sendRpc;
+    private sendRpcWithTimeout;
+}
+//# sourceMappingURL=camoufox-backend.d.ts.map

package/dist/browser/camoufox-backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"camoufox-backend.d.ts","sourceRoot":"","sources":["../../src/browser/camoufox-backend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAWH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,6DAA6D;IAC7D,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,+CAA+C;IAC/C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,uDAAuD;AACvD,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,YAAY,GAAG,MAAM,CAAC;AAqD/D;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,SAAS,GAAE,MAA2B,GAAG,OAAO,CAU3E;AAID;;;;;;;;;;;;;GAaG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IAEtC,OAAO,CAAC,KAAK,CAA+C;IAC5D,OAAO,CAAC,QAAQ,CAAkC;IAClD,OAAO,CAAC,YAAY,CAAuC;IAC3D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0C;IAClE,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,UAAU,CAAM;IACxB,OAAO,CAAC,WAAW,CAA8B;gBAErC,MAAM,GAAE,OAAO,CAAC,cAAc,CAAM;IAMhD;;;OAGG;IACG,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAkBhC;;;OAGG;IACG,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAkB/C,4CAA4C;IACtC,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAYnD,qDAAqD;IAC/C,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAY/D,4DAA4D;IACtD,QAAQ,CAAC,CAAC,GAAG,OAAO,EACxB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC;QAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAajE,gDAAgD;IAC1C,UAAU,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAgB7C,0DAA0D;IACpD,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC;IAapC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC;IAc/B,0DAA0D;IAC1D,UAAU,IAAI,OAAO;IAIrB,wCAAwC;IACxC,aAAa,IAAI,MAAM;IAIvB,yEAAyE;IACzE,UAAU,IAAI,aAAa,GAAG,IAAI;YAMpB,aAAa;IAe3B,OAAO,CAAC,WAAW;IAsEnB,OAAO,CAAC,iBAAiB;IAqBzB,OAAO,CAAC,eAAe;YAgBT,SAAS;IAwCvB,OAAO,CAAC,SAAS;IAOjB;;;;;;OAMG;YACW,OAAO;YAKP,kBAAkB;CAyDjC"}