@xopcai/xopc 0.0.251 → 0.0.253

package/dist/src/browser/actions/types.d.ts

@@ -1,65 +0,0 @@
-/**
- * Browser Action types — shared by browser_use tool, CLI, and pipeline runner.
- */
-import type { Page } from 'playwright-core';
-import type { Config } from '../../config/schema.js';
-import type { BrowserManager } from '../manager.js';
-import type { CdpSupervisor } from '../cdp-supervisor.js';
-export type BrowserActionName = 'open' | 'navigate' | 'state' | 'snapshot' | 'click' | 'type' | 'input' | 'scroll' | 'screenshot' | 'back' | 'keys' | 'press' | 'console' | 'eval' | 'evaluate' | 'images' | 'dialog' | 'cdp' | 'close' | 'wait' | 'assert' | 'output' | 'network_start' | 'network_events' | 'network_stop' | 'wait_for_navigation' | 'wait_for_timeout' | 'wait_for_function' | 'wait_for_network_idle' | 'element_text' | 'element_attribute' | 'bounding_box' | 'set_input_files' | 'cookies' | 'get_cookies' | 'add_cookies' | 'clear_cookies' | 'tabs' | 'list_tabs' | 'new_tab' | 'switch_tab' | 'select' | 'map' | 'filter' | 'sort' | 'limit' | 'fetch' | 'collect' | 'tap';
-export interface BrowserArtifact {
-    type: 'screenshot' | 'file' | 'network_har';
-    path?: string;
-    /** Base64 data (screenshots returned inline when no path). */
-    data?: string;
-    mimeType?: string;
-}
-export interface BrowserDiagnostics {
-    url?: string;
-    title?: string;
-    snapshot?: string;
-    screenshot?: string;
-    console?: string[];
-    network?: string[];
-    warnings?: string[];
-}
-export interface BrowserActionResult {
-    ok: boolean;
-    /** The action that was executed. */
-    action: string;
-    /** Structured output data (e.g. extracted content, page state). */
-    data?: unknown;
-    /** Text summary for display / LLM consumption. */
-    text?: string;
-    /** Error details on failure. */
-    error?: {
-        code: string;
-        message: string;
-    };
-    artifacts?: BrowserArtifact[];
-    diagnostics?: BrowserDiagnostics;
-}
-export interface BrowserActionContext {
-    page: Page;
-    manager: BrowserManager;
-    config: Config | undefined;
-    taskId: string;
-    supervisor?: CdpSupervisor;
-    signal?: AbortSignal;
-    pipeline?: {
-        args: Record<string, unknown>;
-        last: unknown;
-        outputs: unknown[];
-        vars: Record<string, unknown>;
-        error?: {
-            code?: string;
-            message?: string;
-        };
-    };
-}
-export type BrowserActionHandler = (ctx: BrowserActionContext, args: Record<string, unknown>) => Promise<BrowserActionResult>;
-export interface BrowserActionRegistry {
-    get(name: string): BrowserActionHandler | undefined;
-    has(name: string): boolean;
-    names(): string[];
-    execute(name: string, ctx: BrowserActionContext, args: Record<string, unknown>): Promise<BrowserActionResult>;
-}

package/dist/src/browser/backend-from-config.d.ts

@@ -1,22 +0,0 @@
-import type { Config } from '../config/schema.js';
-import type { BrowserBackend, CloakBrowserConfig } from './providers/types.js';
-export interface ExtensionBridgeServerConfig {
-    host: string;
-    port: number;
-    connectionTimeout?: number;
-    commandTimeout?: number;
-}
-/**
- * Whether the gateway should keep the Chrome extension WebSocket bridge listening.
- * True when browser tools are enabled and the resolved backend is extension (including default).
- */
-export declare function shouldRunExtensionBridgeServer(cfg: Config | undefined): boolean;
-/** Resolve the extension bridge listener config, or null when that backend is inactive. */
-export declare function resolveExtensionBridgeServerConfig(cfg: Config | undefined): ExtensionBridgeServerConfig | null;
-/**
- * Resolve browser backend from root browser runtime config.
- * Precedence: `backend: 'extension'` → `cloakbrowser` → `cdpUrl` (CDP) → `cloudProvider` (remote) → `local` (explicit) → extension (default).
- */
-export declare function resolveBrowserBackendFromConfig(cfg: Config | undefined): BrowserBackend;
-/** CloakBrowser launch options aligned with saved agent defaults (headed for manual use). */
-export declare function cloakBrowserConfigFromAgentDefaults(cfg: Config | undefined): CloakBrowserConfig;

package/dist/src/browser/backend-from-config.js

@@ -1,99 +0,0 @@
-//#region src/browser/backend-from-config.ts
-const DEFAULT_EXTENSION_HOST = "127.0.0.1";
-const DEFAULT_EXTENSION_PORT = 19820;
-/**
-* Whether the gateway should keep the Chrome extension WebSocket bridge listening.
-* True when browser tools are enabled and the resolved backend is extension (including default).
-*/
-function shouldRunExtensionBridgeServer(cfg) {
-	return cfg?.browser?.enabled !== false && resolveBrowserBackendFromConfig(cfg).mode === "extension";
-}
-/** Resolve the extension bridge listener config, or null when that backend is inactive. */
-function resolveExtensionBridgeServerConfig(cfg) {
-	if (!shouldRunExtensionBridgeServer(cfg)) return null;
-	const backend = resolveBrowserBackendFromConfig(cfg);
-	if (backend.mode !== "extension") return null;
-	const config = backend.config;
-	return {
-		host: config?.host ?? DEFAULT_EXTENSION_HOST,
-		port: config?.port ?? DEFAULT_EXTENSION_PORT,
-		...config?.connectionTimeout !== void 0 ? { connectionTimeout: config.connectionTimeout } : {},
-		...config?.commandTimeout !== void 0 ? { commandTimeout: config.commandTimeout } : {}
-	};
-}
-/**
-* Resolve browser backend from root browser runtime config.
-* Precedence: `backend: 'extension'` → `cloakbrowser` → `cdpUrl` (CDP) → `cloudProvider` (remote) → `local` (explicit) → extension (default).
-*/
-function resolveBrowserBackendFromConfig(cfg) {
-	const browser = cfg?.browser;
-	if (browser?.enabled === false) return {
-		mode: "extension",
-		config: {}
-	};
-	const commandTimeout = resolveCommandTimeoutMs(browser?.commandTimeout);
-	const backend = browser?.backend ?? "extension";
-	if (backend === "extension") {
-		const ext = browser?.extension;
-		return {
-			mode: "extension",
-			config: {
-				...ext?.port !== void 0 ? { port: ext.port } : {},
-				...ext?.host ? { host: ext.host } : {},
-				...ext?.connectionTimeout !== void 0 ? { connectionTimeout: ext.connectionTimeout } : {},
-				commandTimeout
-			}
-		};
-	}
-	if (backend === "cloakbrowser") return {
-		mode: "cloakbrowser",
-		config: cloakBrowserConfigFromAgentDefaults(cfg)
-	};
-	if (backend === "cdp" && browser?.cdpUrl?.trim()) return {
-		mode: "cdp",
-		config: { wsEndpoint: browser.cdpUrl.trim() }
-	};
-	if (backend === "cloud") return {
-		mode: "cloud",
-		config: {
-			type: browser?.cloudProvider === "browserbase" || browser?.cloudProvider === "browser-use" ? browser.cloudProvider : "browserbase",
-			...browser?.cloud?.apiKey ? { apiKey: browser.cloud.apiKey } : {},
-			...browser?.cloud?.projectId ? { projectId: browser.cloud.projectId } : {},
-			...browser?.cloud?.region ? { region: browser.cloud.region } : {}
-		}
-	};
-	if (backend === "local") return {
-		mode: "local",
-		headless: browser?.headless === true
-	};
-	return {
-		mode: "extension",
-		config: { commandTimeout }
-	};
-}
-/** CloakBrowser launch options aligned with saved agent defaults (headed for manual use). */
-function cloakBrowserConfigFromAgentDefaults(cfg) {
-	const browser = cfg?.browser;
-	const cloak = browser?.cloakbrowser;
-	return {
-		headless: false,
-		...cloak?.keepOpen !== void 0 ? { keepOpen: cloak.keepOpen } : {},
-		...cloak?.temporaryProfile !== void 0 ? { temporaryProfile: cloak.temporaryProfile } : {},
-		...cloak?.cacheDir ? { cacheDir: cloak.cacheDir } : {},
-		...cloak?.binaryPath ? { binaryPath: cloak.binaryPath } : {},
-		...cloak?.timezone ? { timezone: cloak.timezone } : {},
-		...cloak?.locale ? { locale: cloak.locale } : {},
-		...cloak?.webrtcIp ? { webrtcIp: cloak.webrtcIp } : {},
-		...cloak?.fingerprintPlatform ? { fingerprintPlatform: cloak.fingerprintPlatform } : {},
-		...cloak?.extraArgs ? { extraArgs: cloak.extraArgs } : {},
-		humanize: browser?.humanize ?? true,
-		humanPreset: browser?.humanPreset ?? "careful",
-		reuseExisting: true
-	};
-}
-function resolveCommandTimeoutMs(value) {
-	if (typeof value !== "number" || !Number.isFinite(value)) return 3e4;
-	return Math.min(900, Math.max(5, Math.floor(value))) * 1e3;
-}
-//#endregion
-export { cloakBrowserConfigFromAgentDefaults, resolveBrowserBackendFromConfig, resolveExtensionBridgeServerConfig, shouldRunExtensionBridgeServer };

package/dist/src/browser/browser-command-timeout.d.ts

@@ -1,2 +0,0 @@
-import type { Config } from '../config/schema.js';
-export declare function resolveBrowserCommandTimeoutMs(cfg: Config | undefined): number;

package/dist/src/browser/browser-command-timeout.js

@@ -1,11 +0,0 @@
-//#region src/browser/browser-command-timeout.ts
-const DEFAULT_MS = 3e4;
-const MIN_SEC = 5;
-const MAX_SEC = 900;
-function resolveBrowserCommandTimeoutMs(cfg) {
-	const raw = cfg?.browser?.commandTimeout;
-	if (typeof raw !== "number" || !Number.isFinite(raw)) return DEFAULT_MS;
-	return Math.min(MAX_SEC, Math.max(MIN_SEC, Math.floor(raw))) * 1e3;
-}
-//#endregion
-export { resolveBrowserCommandTimeoutMs };

package/dist/src/browser/cdp-local-launcher.d.ts

@@ -1,35 +0,0 @@
-/**
- * Launches a Chromium / Chrome instance locally with `--remote-debugging-port`
- * so the user can wire CDP backend without typing the command themselves.
- *
- * Instances live for the lifetime of the gateway process (no on-disk state).
- * Launching binds the debug port to 127.0.0.1; the user-data-dir is rooted
- * under `~/.xopc/cdp-launch/` and removed on stop.
- */
-export interface LaunchedCdpInstance {
-    /** Debug port the instance listens on (loopback). */
-    port: number;
-    /** Browser-level WS endpoint, ready for Playwright `connectOverCDP`. */
-    wsEndpoint: string;
-    /** Browser process pid. */
-    pid: number;
-    /** Resolved Chrome / Chromium binary path used to spawn. */
-    executablePath: string;
-    /** Temporary `--user-data-dir`. Deleted on stop. */
-    userDataDir: string;
-    /** Wall-clock spawn time (ms epoch). */
-    startedAt: number;
-}
-/** Resolve a Chrome / Chromium executable for the current platform. */
-export declare function resolveChromeBinary(override?: string): Promise<string>;
-export interface LaunchOptions {
-    /** Optional override for the Chrome / Chromium binary. */
-    executablePath?: string;
-    /** Run headless. Default false (visible window so user can interact). */
-    headless?: boolean;
-}
-export declare function launchLocalCdpChrome(opts?: LaunchOptions): Promise<LaunchedCdpInstance>;
-export declare function stopLocalCdpChrome(port: number): Promise<boolean>;
-export declare function listLocalCdpInstances(): LaunchedCdpInstance[];
-/** Graceful shutdown — call from gateway exit hooks. */
-export declare function stopAllLocalCdpChromes(): Promise<void>;

package/dist/src/browser/cdp-local-launcher.js

@@ -1,154 +0,0 @@
-import { createLogger } from "../utils/logger/index.js";
-import { init_logger } from "../utils/logger.js";
-import { loadPlaywrightCoreModule } from "./providers/playwright-doctor.js";
-import { pickFreePort } from "./free-port.js";
-import { homedir, platform } from "node:os";
-import { join } from "node:path";
-import { existsSync } from "node:fs";
-import { spawn } from "node:child_process";
-import { mkdir, rm } from "node:fs/promises";
-//#region src/browser/cdp-local-launcher.ts
-/**
-* Launches a Chromium / Chrome instance locally with `--remote-debugging-port`
-* so the user can wire CDP backend without typing the command themselves.
-*
-* Instances live for the lifetime of the gateway process (no on-disk state).
-* Launching binds the debug port to 127.0.0.1; the user-data-dir is rooted
-* under `~/.xopc/cdp-launch/` and removed on stop.
-*/
-init_logger();
-const log = createLogger("CdpLocalLauncher");
-const READY_TIMEOUT_MS = 2e4;
-const READY_POLL_INTERVAL_MS = 250;
-const instances = /* @__PURE__ */ new Map();
-function defaultUserDataRoot() {
-	return join(homedir(), ".xopc", "cdp-launch");
-}
-/** Resolve a Chrome / Chromium executable for the current platform. */
-async function resolveChromeBinary(override) {
-	if (override && override.trim()) {
-		const candidate = override.trim();
-		if (!existsSync(candidate)) throw new Error(`Chrome executable not found at ${candidate}`);
-		return candidate;
-	}
-	try {
-		const pw = await loadPlaywrightCoreModule();
-		const exec = (pw.chromium ?? pw.default?.chromium)?.executablePath?.();
-		if (exec && existsSync(exec)) return exec;
-	} catch {}
-	const os = platform();
-	const probes = os === "darwin" ? [
-		"/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
-		"/Applications/Chromium.app/Contents/MacOS/Chromium",
-		"/Applications/Google Chrome Canary.app/Contents/MacOS/Google Chrome Canary"
-	] : os === "win32" ? ["C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe", "C:\\Program Files (x86)\\Google\\Chrome\\Application\\chrome.exe"] : [
-		"/usr/bin/google-chrome",
-		"/usr/bin/chromium",
-		"/usr/bin/chromium-browser",
-		"/snap/bin/chromium"
-	];
-	for (const path of probes) if (existsSync(path)) return path;
-	throw new Error("No Chrome / Chromium binary found. Install Chrome or run `npx playwright install chromium` first.");
-}
-async function waitForCdpEndpoint(port) {
-	const deadline = Date.now() + READY_TIMEOUT_MS;
-	while (Date.now() < deadline) {
-		try {
-			const res = await fetch(`http://127.0.0.1:${port}/json/version`, { signal: AbortSignal.timeout(1500) });
-			if (res.ok) {
-				const data = await res.json();
-				if (data.webSocketDebuggerUrl) return data.webSocketDebuggerUrl;
-			}
-		} catch {}
-		await new Promise((r) => setTimeout(r, READY_POLL_INTERVAL_MS));
-	}
-	throw new Error(`Chrome did not expose CDP within ${READY_TIMEOUT_MS / 1e3}s on port ${port}`);
-}
-async function launchLocalCdpChrome(opts = {}) {
-	const executablePath = await resolveChromeBinary(opts.executablePath);
-	const port = await pickFreePort();
-	const root = defaultUserDataRoot();
-	await mkdir(root, { recursive: true });
-	const userDataDir = join(root, `${process.pid}-${port}`);
-	await mkdir(userDataDir, { recursive: true });
-	const args = [
-		`--remote-debugging-address=127.0.0.1`,
-		`--remote-debugging-port=${port}`,
-		`--user-data-dir=${userDataDir}`,
-		"--no-first-run",
-		"--no-default-browser-check"
-	];
-	if (opts.headless) args.push("--headless=new");
-	if (platform() === "darwin") args.push("--use-mock-keychain");
-	log.info({
-		executablePath,
-		port,
-		userDataDir
-	}, "Spawning local debuggable Chrome");
-	const child = spawn(executablePath, args, {
-		stdio: [
-			"ignore",
-			"ignore",
-			"ignore"
-		],
-		detached: false
-	});
-	const launchFailure = new Promise((_resolve, reject) => {
-		const onErr = (err) => reject(/* @__PURE__ */ new Error(`spawn failed: ${err.message}`));
-		const onExit = (code, signal) => {
-			const reason = signal ? `signal ${signal}` : `exit ${code ?? "unknown"}`;
-			reject(/* @__PURE__ */ new Error(`Chrome exited before CDP came up (${reason})`));
-		};
-		child.once("error", onErr);
-		child.once("exit", onExit);
-	});
-	let wsEndpoint;
-	try {
-		wsEndpoint = await Promise.race([waitForCdpEndpoint(port), launchFailure]);
-	} catch (e) {
-		child.kill();
-		await rm(userDataDir, {
-			recursive: true,
-			force: true
-		}).catch(() => {});
-		throw e;
-	}
-	const entry = {
-		port,
-		wsEndpoint,
-		pid: child.pid ?? -1,
-		executablePath,
-		userDataDir,
-		startedAt: Date.now(),
-		child
-	};
-	instances.set(port, entry);
-	child.once("exit", () => {
-		instances.delete(port);
-		rm(userDataDir, {
-			recursive: true,
-			force: true
-		}).catch(() => {});
-		log.info({ port }, "Local CDP Chrome exited");
-	});
-	return toPublic(entry);
-}
-async function stopLocalCdpChrome(port) {
-	const entry = instances.get(port);
-	if (!entry) return false;
-	entry.child.kill();
-	return true;
-}
-function listLocalCdpInstances() {
-	return [...instances.values()].map(toPublic);
-}
-function toPublic(entry) {
-	const { child: _child, ...pub } = entry;
-	return pub;
-}
-/** Graceful shutdown — call from gateway exit hooks. */
-async function stopAllLocalCdpChromes() {
-	for (const [port] of instances) await stopLocalCdpChrome(port);
-}
-//#endregion
-export { launchLocalCdpChrome, listLocalCdpInstances, resolveChromeBinary, stopAllLocalCdpChromes, stopLocalCdpChrome };

package/dist/src/browser/cdp-supervisor.d.ts

@@ -1,58 +0,0 @@
-import type { Page } from 'playwright-core';
-/** Represents a captured JS dialog event. */
-export interface DialogEvent {
-    id: string;
-    type: 'alert' | 'confirm' | 'prompt' | 'beforeunload';
-    message: string;
-    defaultValue: string;
-    timestamp: number;
-    handled: boolean;
-    response?: 'accepted' | 'dismissed';
-}
-/** Console message captured by the supervisor. */
-export interface ConsoleEntry {
-    type: string;
-    text: string;
-    timestamp: number;
-}
-export type DialogPolicy = 'must_respond' | 'auto_dismiss' | 'auto_accept';
-export interface CdpSupervisorOptions {
-    dialogPolicy: DialogPolicy;
-    dialogTimeoutSeconds: number;
-    maxConsoleEntries: number;
-}
-/**
- * CDP Supervisor — persistent event listener for browser pages.
- *
- * Monitors Dialog events, console output, and frame navigation.
- * Aligned with hermes-agent's `CDPSupervisor` pattern but using
- * Playwright's high-level event API instead of raw CDP WebSocket.
- */
-export declare class CdpSupervisor {
-    private readonly options;
-    private dialogQueue;
-    private consoleBuffer;
-    private attachedPages;
-    private dialogCounter;
-    private pendingDialog;
-    constructor(options?: Partial<CdpSupervisorOptions>);
-    /** Attach the supervisor to a page to begin monitoring. */
-    attach(page: Page): void;
-    /** Get all pending (unhandled) dialogs. */
-    getPendingDialogs(): DialogEvent[];
-    /** Get all captured dialog events (including handled). */
-    getAllDialogs(): DialogEvent[];
-    /** Get recent console entries. */
-    getConsoleEntries(limit?: number): ConsoleEntry[];
-    /** Handle a pending dialog by id or the most recent one. */
-    handleDialog(action: 'accept' | 'dismiss', options?: {
-        dialogId?: string;
-        promptText?: string;
-    }): Promise<DialogEvent | undefined>;
-    /** Clear all dialog history. */
-    clearDialogs(): void;
-    /** Clear console buffer. */
-    clearConsole(): void;
-    private _onDialog;
-    private _onConsole;
-}

package/dist/src/browser/cdp-supervisor.js

@@ -1,133 +0,0 @@
-import { createLogger } from "../utils/logger/index.js";
-import { init_logger } from "../utils/logger.js";
-//#region src/browser/cdp-supervisor.ts
-init_logger();
-const log = createLogger("CDPSupervisor");
-const DEFAULT_OPTIONS = {
-	dialogPolicy: "auto_dismiss",
-	dialogTimeoutSeconds: 300,
-	maxConsoleEntries: 200
-};
-/**
-* CDP Supervisor — persistent event listener for browser pages.
-*
-* Monitors Dialog events, console output, and frame navigation.
-* Aligned with hermes-agent's `CDPSupervisor` pattern but using
-* Playwright's high-level event API instead of raw CDP WebSocket.
-*/
-var CdpSupervisor = class {
-	options;
-	dialogQueue = [];
-	consoleBuffer = [];
-	attachedPages = /* @__PURE__ */ new WeakSet();
-	dialogCounter = 0;
-	pendingDialog = null;
-	constructor(options) {
-		this.options = {
-			...DEFAULT_OPTIONS,
-			...options
-		};
-	}
-	/** Attach the supervisor to a page to begin monitoring. */
-	attach(page) {
-		if (this.attachedPages.has(page)) return;
-		this.attachedPages.add(page);
-		page.on("dialog", (dialog) => this._onDialog(dialog));
-		page.on("console", (msg) => this._onConsole(msg));
-		page.on("close", () => this.attachedPages.delete(page));
-		log.debug("Supervisor attached to page");
-	}
-	/** Get all pending (unhandled) dialogs. */
-	getPendingDialogs() {
-		return this.dialogQueue.filter((d) => !d.handled);
-	}
-	/** Get all captured dialog events (including handled). */
-	getAllDialogs() {
-		return [...this.dialogQueue];
-	}
-	/** Get recent console entries. */
-	getConsoleEntries(limit) {
-		const max = limit ?? this.options.maxConsoleEntries;
-		return this.consoleBuffer.slice(-max);
-	}
-	/** Handle a pending dialog by id or the most recent one. */
-	async handleDialog(action, options) {
-		let targetEvent;
-		if (options?.dialogId) targetEvent = this.dialogQueue.find((d) => d.id === options.dialogId && !d.handled);
-		else targetEvent = this.dialogQueue.findLast((d) => !d.handled);
-		if (!targetEvent) return void 0;
-		if (this.pendingDialog) {
-			try {
-				if (action === "accept") await this.pendingDialog.accept(options?.promptText ?? "");
-				else await this.pendingDialog.dismiss();
-			} catch {}
-			this.pendingDialog = null;
-		}
-		targetEvent.handled = true;
-		targetEvent.response = action === "accept" ? "accepted" : "dismissed";
-		return targetEvent;
-	}
-	/** Clear all dialog history. */
-	clearDialogs() {
-		this.dialogQueue = [];
-	}
-	/** Clear console buffer. */
-	clearConsole() {
-		this.consoleBuffer = [];
-	}
-	_onDialog(dialog) {
-		this.dialogCounter += 1;
-		const event = {
-			id: `dialog-${this.dialogCounter}`,
-			type: dialog.type(),
-			message: dialog.message(),
-			defaultValue: dialog.defaultValue(),
-			timestamp: Date.now(),
-			handled: false
-		};
-		this.dialogQueue.push(event);
-		this.pendingDialog = dialog;
-		log.info({
-			dialogId: event.id,
-			type: event.type,
-			message: event.message
-		}, "Dialog detected");
-		switch (this.options.dialogPolicy) {
-			case "auto_accept":
-				dialog.accept().then(() => {
-					event.handled = true;
-					event.response = "accepted";
-					this.pendingDialog = null;
-				}).catch(() => {});
-				break;
-			case "auto_dismiss":
-				dialog.dismiss().then(() => {
-					event.handled = true;
-					event.response = "dismissed";
-					this.pendingDialog = null;
-				}).catch(() => {});
-				break;
-			case "must_respond":
-				setTimeout(() => {
-					if (!event.handled) dialog.dismiss().then(() => {
-						event.handled = true;
-						event.response = "dismissed";
-						this.pendingDialog = null;
-						log.warn({ dialogId: event.id }, "Dialog auto-dismissed after timeout");
-					}).catch(() => {});
-				}, this.options.dialogTimeoutSeconds * 1e3);
-				break;
-		}
-	}
-	_onConsole(msg) {
-		const entry = {
-			type: msg.type(),
-			text: msg.text(),
-			timestamp: Date.now()
-		};
-		this.consoleBuffer.push(entry);
-		if (this.consoleBuffer.length > this.options.maxConsoleEntries * 1.5) this.consoleBuffer = this.consoleBuffer.slice(-this.options.maxConsoleEntries);
-	}
-};
-//#endregion
-export { CdpSupervisor };

package/dist/src/browser/humanize.d.ts

@@ -1,80 +0,0 @@
-/**
- * Human-like interaction primitives for browser automation.
- *
- * Implements Bezier mouse movement, humanized clicking, per-character typing
- * with random delays, and wheel-based scrolling with acceleration/deceleration.
- *
- * Ported from brocli's human.rs — all input is dispatched via CDP Input domain
- * through Playwright's CDPSession, bypassing Playwright's high-level API to
- * produce more realistic event patterns.
- */
-import type { Page } from 'playwright-core';
-/** All tunable parameters for human-like behavior. */
-export interface HumanConfig {
-    typingDelayMs: number;
-    typingDelaySpreadMs: number;
-    typingPauseChance: number;
-    typingPauseRangeMs: [number, number];
-    keyHoldMs: [number, number];
-    mouseStepsDivisor: number;
-    mouseMinSteps: number;
-    mouseMaxSteps: number;
-    mouseWobbleMax: number;
-    mouseOvershootChance: number;
-    mouseOvershootPx: [number, number];
-    mouseBurstSize: [number, number];
-    mouseBurstPauseMs: [number, number];
-    clickAimDelayMs: [number, number];
-    clickHoldMs: [number, number];
-    clickInputXRange: [number, number];
-    scrollDeltaBase: [number, number];
-    scrollDeltaVariance: number;
-    scrollPauseFastMs: [number, number];
-    scrollPauseSlowMs: [number, number];
-    scrollAccelSteps: [number, number];
-    scrollDecelSteps: [number, number];
-    scrollOvershootChance: number;
-    scrollOvershootPx: [number, number];
-    scrollSettleDelayMs: [number, number];
-    initialCursorX: [number, number];
-    initialCursorY: [number, number];
-}
-export type HumanPreset = 'default' | 'careful';
-export declare function resolveHumanConfig(preset?: HumanPreset): HumanConfig;
-interface Point {
-    x: number;
-    y: number;
-}
-/** Generate a human-like mouse path from start to end using cubic Bezier with wobble. */
-export declare function generateMousePath(start: Point, end: Point, cfg: HumanConfig): Point[];
-export type TypeAction = {
-    kind: 'char';
-    ch: string;
-    holdMs: number;
-} | {
-    kind: 'delay';
-    ms: number;
-} | {
-    kind: 'pause';
-    ms: number;
-};
-/** Generate a plan of typing actions for a given text. */
-export declare function generateTypingPlan(text: string, cfg: HumanConfig): TypeAction[];
-export type ScrollAction = {
-    kind: 'wheel';
-    deltaY: number;
-} | {
-    kind: 'pause';
-    ms: number;
-};
-/** Generate a scroll plan to move totalDelta pixels vertically. */
-export declare function generateScrollPlan(totalDelta: number, cfg: HumanConfig): ScrollAction[];
-/** Humanized click on a CSS selector. */
-export declare function humanizedClick(page: Page, selector: string, preset?: HumanPreset): Promise<void>;
-/** Humanized fill: click the field, clear, type character by character. */
-export declare function humanizedFill(page: Page, selector: string, value: string, preset?: HumanPreset): Promise<void>;
-/** Humanized key press with hold delay. */
-export declare function humanizedPress(page: Page, key: string, preset?: HumanPreset): Promise<void>;
-/** Humanized scroll by deltaY pixels using wheel events. */
-export declare function humanizedScroll(page: Page, deltaY: number, preset?: HumanPreset): Promise<void>;
-export {};