@xopcai/xopc 0.0.251 → 0.0.252

package/dist/src/browser/humanize.js

@@ -1,363 +0,0 @@
-//#region src/browser/humanize.ts
-const DEFAULT_CONFIG = {
-	typingDelayMs: 70,
-	typingDelaySpreadMs: 40,
-	typingPauseChance: .1,
-	typingPauseRangeMs: [400, 1e3],
-	keyHoldMs: [15, 35],
-	mouseStepsDivisor: 8,
-	mouseMinSteps: 25,
-	mouseMaxSteps: 80,
-	mouseWobbleMax: 1.5,
-	mouseOvershootChance: .15,
-	mouseOvershootPx: [3, 6],
-	mouseBurstSize: [3, 5],
-	mouseBurstPauseMs: [8, 18],
-	clickAimDelayMs: [60, 140],
-	clickHoldMs: [40, 100],
-	clickInputXRange: [.05, .3],
-	scrollDeltaBase: [80, 130],
-	scrollDeltaVariance: .2,
-	scrollPauseFastMs: [30, 80],
-	scrollPauseSlowMs: [80, 200],
-	scrollAccelSteps: [2, 3],
-	scrollDecelSteps: [2, 3],
-	scrollOvershootChance: .1,
-	scrollOvershootPx: [50, 150],
-	scrollSettleDelayMs: [300, 600],
-	initialCursorX: [400, 700],
-	initialCursorY: [45, 60]
-};
-const CAREFUL_CONFIG = {
-	...DEFAULT_CONFIG,
-	typingDelayMs: 100,
-	typingDelaySpreadMs: 50,
-	typingPauseChance: .15,
-	typingPauseRangeMs: [500, 1200],
-	keyHoldMs: [20, 45],
-	mouseBurstPauseMs: [12, 25],
-	clickAimDelayMs: [80, 200],
-	clickHoldMs: [60, 150],
-	scrollPauseFastMs: [100, 200],
-	scrollPauseSlowMs: [250, 600],
-	scrollSettleDelayMs: [400, 800]
-};
-function resolveHumanConfig(preset = "default") {
-	return preset === "careful" ? { ...CAREFUL_CONFIG } : { ...DEFAULT_CONFIG };
-}
-function randRange(min, max) {
-	return min + Math.random() * (max - min);
-}
-function randInt(min, max) {
-	return Math.floor(randRange(min, max + 1));
-}
-function easeInOut(t) {
-	return (1 - Math.cos(Math.PI * t)) / 2;
-}
-function bezier(p0, p1, p2, p3, t) {
-	const u = 1 - t;
-	const tt = t * t;
-	const uu = u * u;
-	const uuu = uu * u;
-	const ttt = tt * t;
-	return {
-		x: uuu * p0.x + 3 * uu * t * p1.x + 3 * u * tt * p2.x + ttt * p3.x,
-		y: uuu * p0.y + 3 * uu * t * p1.y + 3 * u * tt * p2.y + ttt * p3.y
-	};
-}
-/** Generate a human-like mouse path from start to end using cubic Bezier with wobble. */
-function generateMousePath(start, end, cfg) {
-	const dx = end.x - start.x;
-	const dy = end.y - start.y;
-	const distance = Math.sqrt(dx * dx + dy * dy);
-	const steps = Math.min(cfg.mouseMaxSteps, Math.max(cfg.mouseMinSteps, Math.round(distance / cfg.mouseStepsDivisor)));
-	const cp1 = {
-		x: start.x + dx * randRange(.2, .4) + randRange(-30, 30),
-		y: start.y + dy * randRange(0, .3) + randRange(-30, 30)
-	};
-	const cp2 = {
-		x: start.x + dx * randRange(.6, .8) + randRange(-30, 30),
-		y: start.y + dy * randRange(.7, 1) + randRange(-30, 30)
-	};
-	const path = [];
-	for (let i = 0; i <= steps; i++) {
-		const raw = i / steps;
-		const pt = bezier(start, cp1, cp2, end, easeInOut(raw));
-		const wobble = cfg.mouseWobbleMax * (1 - raw);
-		pt.x += randRange(-wobble, wobble);
-		pt.y += randRange(-wobble, wobble);
-		path.push(pt);
-	}
-	if (Math.random() < cfg.mouseOvershootChance) {
-		const overshootPx = randRange(cfg.mouseOvershootPx[0], cfg.mouseOvershootPx[1]);
-		const angle = Math.atan2(dy, dx);
-		path.push({
-			x: end.x + Math.cos(angle) * overshootPx,
-			y: end.y + Math.sin(angle) * overshootPx
-		});
-		path.push({
-			x: end.x + randRange(-1, 1),
-			y: end.y + randRange(-1, 1)
-		});
-	}
-	return path;
-}
-/** Generate a plan of typing actions for a given text. */
-function generateTypingPlan(text, cfg) {
-	const actions = [];
-	const chars = [...text];
-	for (let i = 0; i < chars.length; i++) {
-		const hold = randRange(cfg.keyHoldMs[0], cfg.keyHoldMs[1]);
-		actions.push({
-			kind: "char",
-			ch: chars[i],
-			holdMs: hold
-		});
-		if (i < chars.length - 1) if (Math.random() < cfg.typingPauseChance) {
-			const pause = randRange(cfg.typingPauseRangeMs[0], cfg.typingPauseRangeMs[1]);
-			actions.push({
-				kind: "pause",
-				ms: pause
-			});
-		} else {
-			const delay = cfg.typingDelayMs + (Math.random() - .5) * 2 * cfg.typingDelaySpreadMs;
-			actions.push({
-				kind: "delay",
-				ms: Math.max(10, delay)
-			});
-		}
-	}
-	return actions;
-}
-/** Generate a scroll plan to move totalDelta pixels vertically. */
-function generateScrollPlan(totalDelta, cfg) {
-	const direction = totalDelta > 0 ? 1 : -1;
-	const absDistance = Math.abs(totalDelta);
-	const avgDelta = (cfg.scrollDeltaBase[0] + cfg.scrollDeltaBase[1]) / 2;
-	const totalClicks = Math.max(3, Math.ceil(absDistance / avgDelta));
-	const accelSteps = randInt(cfg.scrollAccelSteps[0], cfg.scrollAccelSteps[1]);
-	const decelSteps = randInt(cfg.scrollDecelSteps[0], cfg.scrollDecelSteps[1]);
-	const actions = [];
-	let scrolled = 0;
-	for (let i = 0; i < totalClicks; i++) {
-		if (scrolled >= absDistance) break;
-		let delta;
-		let pause;
-		if (i < accelSteps) {
-			delta = randRange(60, 100);
-			pause = randRange(cfg.scrollPauseSlowMs[0], cfg.scrollPauseSlowMs[1]);
-		} else if (i >= totalClicks - decelSteps) {
-			delta = randRange(50, 90);
-			pause = randRange(cfg.scrollPauseSlowMs[0], cfg.scrollPauseSlowMs[1]);
-		} else {
-			delta = randRange(cfg.scrollDeltaBase[0], cfg.scrollDeltaBase[1]);
-			pause = randRange(cfg.scrollPauseFastMs[0], cfg.scrollPauseFastMs[1]);
-		}
-		const variance = 1 + (Math.random() - .5) * 2 * cfg.scrollDeltaVariance;
-		const finalDelta = Math.round(delta * variance * direction);
-		actions.push({
-			kind: "wheel",
-			deltaY: finalDelta
-		});
-		actions.push({
-			kind: "pause",
-			ms: pause
-		});
-		scrolled += delta * variance;
-	}
-	if (Math.random() < cfg.scrollOvershootChance) {
-		const overshoot = Math.round(randRange(cfg.scrollOvershootPx[0], cfg.scrollOvershootPx[1]) * direction);
-		actions.push({
-			kind: "wheel",
-			deltaY: overshoot
-		});
-		const settle = randRange(cfg.scrollSettleDelayMs[0], cfg.scrollSettleDelayMs[1]);
-		actions.push({
-			kind: "pause",
-			ms: settle
-		});
-		const correction = Math.round(randRange(40, 80) * -direction);
-		actions.push({
-			kind: "wheel",
-			deltaY: correction
-		});
-	}
-	return actions;
-}
-function clickTarget(bbox, isInput, cfg) {
-	return {
-		x: isInput ? bbox.x + bbox.width * randRange(cfg.clickInputXRange[0], cfg.clickInputXRange[1]) : bbox.x + randRange(bbox.width * .15, bbox.width * .85),
-		y: bbox.y + randRange(bbox.height * .2, bbox.height * .8)
-	};
-}
-function sleepMs(ms) {
-	if (ms <= 0) return Promise.resolve();
-	return new Promise((resolve) => setTimeout(resolve, Math.round(ms)));
-}
-async function ensureCdpSession(page) {
-	return page.context().newCDPSession(page);
-}
-async function dispatchMouseMove(cdp, x, y) {
-	await cdp.send("Input.dispatchMouseEvent", {
-		type: "mouseMoved",
-		x,
-		y
-	});
-}
-async function dispatchMouseEvent(cdp, eventType, x, y, clickCount) {
-	await cdp.send("Input.dispatchMouseEvent", {
-		type: eventType,
-		x,
-		y,
-		button: "left",
-		clickCount
-	});
-}
-async function dispatchWheel(cdp, x, y, deltaY) {
-	await cdp.send("Input.dispatchMouseEvent", {
-		type: "mouseWheel",
-		x,
-		y,
-		deltaX: 0,
-		deltaY
-	});
-}
-async function dispatchChar(cdp, ch, holdMs) {
-	await cdp.send("Input.dispatchKeyEvent", {
-		type: "keyDown",
-		key: ch,
-		text: ch
-	});
-	await sleepMs(holdMs);
-	await cdp.send("Input.dispatchKeyEvent", {
-		type: "keyUp",
-		key: ch
-	});
-}
-async function dispatchKey(cdp, key, modifiers) {
-	await cdp.send("Input.dispatchKeyEvent", {
-		type: "keyDown",
-		key,
-		...modifiers !== void 0 ? { modifiers } : {}
-	});
-	await cdp.send("Input.dispatchKeyEvent", {
-		type: "keyUp",
-		key,
-		...modifiers !== void 0 ? { modifiers } : {}
-	});
-}
-async function executeMousePath(cdp, path, cfg) {
-	const burstSize = randInt(cfg.mouseBurstSize[0], cfg.mouseBurstSize[1]);
-	let burstCounter = 0;
-	for (const pt of path) {
-		await dispatchMouseMove(cdp, pt.x, pt.y);
-		burstCounter++;
-		if (burstCounter >= burstSize) {
-			await sleepMs(randRange(cfg.mouseBurstPauseMs[0], cfg.mouseBurstPauseMs[1]));
-			burstCounter = 0;
-		}
-	}
-}
-async function getElementBBox(page, selector) {
-	const bbox = await page.locator(selector).boundingBox();
-	if (!bbox) throw new Error(`selector not found: ${selector}`);
-	return bbox;
-}
-/** Humanized click on a CSS selector. */
-async function humanizedClick(page, selector, preset = "default") {
-	const cfg = resolveHumanConfig(preset);
-	const cdp = await ensureCdpSession(page);
-	try {
-		let cx = randRange(cfg.initialCursorX[0], cfg.initialCursorX[1]);
-		let cy = randRange(cfg.initialCursorY[0], cfg.initialCursorY[1]);
-		await dispatchMouseMove(cdp, cx, cy);
-		const target = clickTarget(await getElementBBox(page, selector), false, cfg);
-		const path = generateMousePath({
-			x: cx,
-			y: cy
-		}, target, cfg);
-		await executeMousePath(cdp, path, cfg);
-		const last = path[path.length - 1];
-		if (last) {
-			cx = last.x;
-			cy = last.y;
-		}
-		await sleepMs(randRange(cfg.clickAimDelayMs[0], cfg.clickAimDelayMs[1]));
-		await dispatchMouseEvent(cdp, "mousePressed", cx, cy, 1);
-		await sleepMs(randRange(cfg.clickHoldMs[0], cfg.clickHoldMs[1]));
-		await dispatchMouseEvent(cdp, "mouseReleased", cx, cy, 1);
-	} finally {
-		await cdp.detach().catch(() => {});
-	}
-}
-/** Humanized fill: click the field, clear, type character by character. */
-async function humanizedFill(page, selector, value, preset = "default") {
-	const cfg = resolveHumanConfig(preset);
-	const cdp = await ensureCdpSession(page);
-	try {
-		let cx = randRange(cfg.initialCursorX[0], cfg.initialCursorX[1]);
-		let cy = randRange(cfg.initialCursorY[0], cfg.initialCursorY[1]);
-		await dispatchMouseMove(cdp, cx, cy);
-		const target = clickTarget(await getElementBBox(page, selector), true, cfg);
-		const path = generateMousePath({
-			x: cx,
-			y: cy
-		}, target, cfg);
-		await executeMousePath(cdp, path, cfg);
-		const last = path[path.length - 1];
-		if (last) {
-			cx = last.x;
-			cy = last.y;
-		}
-		await sleepMs(randRange(cfg.clickAimDelayMs[0], cfg.clickAimDelayMs[1]));
-		await dispatchMouseEvent(cdp, "mousePressed", cx, cy, 1);
-		await sleepMs(randRange(cfg.clickHoldMs[0], cfg.clickHoldMs[1]));
-		await dispatchMouseEvent(cdp, "mouseReleased", cx, cy, 1);
-		await sleepMs(100);
-		await dispatchKey(cdp, "a", 8);
-		await sleepMs(50);
-		await dispatchKey(cdp, "Backspace");
-		await sleepMs(80);
-		const plan = generateTypingPlan(value, cfg);
-		for (const action of plan) if (action.kind === "char") await dispatchChar(cdp, action.ch, action.holdMs);
-		else await sleepMs(action.ms);
-	} finally {
-		await cdp.detach().catch(() => {});
-	}
-}
-/** Humanized key press with hold delay. */
-async function humanizedPress(page, key, preset = "default") {
-	const cfg = resolveHumanConfig(preset);
-	const cdp = await ensureCdpSession(page);
-	try {
-		const hold = randRange(cfg.keyHoldMs[0], cfg.keyHoldMs[1]);
-		await cdp.send("Input.dispatchKeyEvent", {
-			type: "keyDown",
-			key
-		});
-		await sleepMs(hold);
-		await cdp.send("Input.dispatchKeyEvent", {
-			type: "keyUp",
-			key
-		});
-	} finally {
-		await cdp.detach().catch(() => {});
-	}
-}
-/** Humanized scroll by deltaY pixels using wheel events. */
-async function humanizedScroll(page, deltaY, preset = "default") {
-	const cfg = resolveHumanConfig(preset);
-	const cdp = await ensureCdpSession(page);
-	try {
-		const cx = randRange(cfg.initialCursorX[0], cfg.initialCursorX[1]);
-		const cy = randRange(cfg.initialCursorY[0], cfg.initialCursorY[1]);
-		await dispatchMouseMove(cdp, cx, cy);
-		const plan = generateScrollPlan(deltaY, cfg);
-		for (const action of plan) if (action.kind === "wheel") await dispatchWheel(cdp, cx, cy, action.deltaY);
-		else await sleepMs(action.ms);
-	} finally {
-		await cdp.detach().catch(() => {});
-	}
-}
-//#endregion
-export { generateMousePath, generateScrollPlan, generateTypingPlan, humanizedClick, humanizedFill, humanizedPress, humanizedScroll, resolveHumanConfig };

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

@@ -1,50 +0,0 @@
-import type { Page } from 'playwright-core';
-import type { BrowserBackend } from './providers/types.js';
-import type { ExtensionBrowserProvider } from './providers/extension.js';
-export interface BrowserManagerOptions {
-    getHeadless: () => boolean;
-    /** Backend connection mode. Default: local Playwright. */
-    getBackend?: () => BrowserBackend;
-}
-/**
- * Multi-backend browser manager — supports local Playwright, direct CDP, and cloud providers.
- *
- * One browser context shared by all sessions; one {@link Page} per task/session key (max {@link MAX_PAGES}).
- * Backend is selected at first connection based on {@link BrowserManagerOptions.getBackend}.
- */
-export declare class BrowserManager {
-    private browser;
-    private context;
-    private cloudProvider;
-    private extensionProvider;
-    private extensionRelease;
-    private cloakChildProcess;
-    private cloakTempProfileDir;
-    private pages;
-    private readonly options;
-    private activeBackendMode;
-    constructor(options: BrowserManagerOptions);
-    /** Current backend mode (null if not yet connected). */
-    get backendMode(): string | null;
-    private evictIdlePages;
-    private _isPlaywrightConnectionAlive;
-    private _wireBrowserLifecycle;
-    /** Drop Playwright handles without tearing down extension bridge. */
-    private _clearPlaywrightSessionRefs;
-    private _resetStalePlaywrightSession;
-    /**
-     * Ensure Playwright context or Chrome Extension provider is ready.
-     * Extension mode does not create a Playwright {@link BrowserContext}.
-     */
-    ensureConnected(): Promise<void>;
-    private _launchLocal;
-    private _connectViaCdp;
-    private _connectViaCloud;
-    private _connectViaExtension;
-    private _connectViaCloakBrowser;
-    getPage(taskId: string): Promise<Page>;
-    closePage(taskId: string): Promise<void>;
-    /** Get the extension provider (only available in extension mode). */
-    getExtensionProvider(): ExtensionBrowserProvider | null;
-    shutdown(): Promise<void>;
-}

package/dist/src/browser/manager.js

@@ -1,251 +0,0 @@
-import { createLogger } from "../utils/logger/index.js";
-import { init_logger } from "../utils/logger.js";
-import { loadPlaywrightCoreModule } from "./providers/playwright-doctor.js";
-//#region src/browser/manager.ts
-init_logger();
-const log = createLogger("browser-manager");
-const MAX_PAGES = 3;
-const PAGE_IDLE_TIMEOUT_MS = 300 * 1e3;
-/**
-* Multi-backend browser manager — supports local Playwright, direct CDP, and cloud providers.
-*
-* One browser context shared by all sessions; one {@link Page} per task/session key (max {@link MAX_PAGES}).
-* Backend is selected at first connection based on {@link BrowserManagerOptions.getBackend}.
-*/
-var BrowserManager = class {
-	browser = null;
-	context = null;
-	cloudProvider = null;
-	extensionProvider = null;
-	extensionRelease = null;
-	cloakChildProcess = null;
-	cloakTempProfileDir = null;
-	pages = /* @__PURE__ */ new Map();
-	options;
-	activeBackendMode = null;
-	constructor(options) {
-		this.options = options;
-	}
-	/** Current backend mode (null if not yet connected). */
-	get backendMode() {
-		return this.activeBackendMode;
-	}
-	evictIdlePages() {
-		const now = Date.now();
-		for (const [id, entry] of this.pages) if (entry.page.isClosed() || now - entry.lastUsed > PAGE_IDLE_TIMEOUT_MS) {
-			entry.page.close().catch(() => {});
-			this.pages.delete(id);
-			log.debug({ taskId: id }, "Evicted idle or closed browser page");
-		}
-	}
-	_isPlaywrightConnectionAlive() {
-		if (!this.browser || !this.context) return false;
-		try {
-			if (typeof this.browser.isConnected === "function" && !this.browser.isConnected()) return false;
-			return true;
-		} catch {
-			return false;
-		}
-	}
-	_wireBrowserLifecycle(browser) {
-		browser.on("disconnected", () => {
-			log.warn({ mode: this.activeBackendMode }, "Browser disconnected — clearing stale session");
-			this._clearPlaywrightSessionRefs();
-		});
-	}
-	/** Drop Playwright handles without tearing down extension bridge. */
-	_clearPlaywrightSessionRefs() {
-		this.pages.clear();
-		this.context = null;
-		this.browser = null;
-		this.cloakChildProcess = null;
-		this.cloakTempProfileDir = null;
-		if (this.cloudProvider) {
-			this.cloudProvider.disconnect().catch(() => {});
-			this.cloudProvider = null;
-		}
-	}
-	async _resetStalePlaywrightSession() {
-		for (const [, entry] of this.pages) await entry.page.close().catch(() => {});
-		this.pages.clear();
-		if (this.cloudProvider) {
-			await this.cloudProvider.disconnect().catch(() => {});
-			this.cloudProvider = null;
-		}
-		if (this.cloakChildProcess || this.cloakTempProfileDir) {
-			const { cleanupCloakBrowser } = await import("./providers/cloakbrowser.js");
-			await cleanupCloakBrowser(this.cloakChildProcess, this.cloakTempProfileDir).catch(() => {});
-			this.cloakChildProcess = null;
-			this.cloakTempProfileDir = null;
-		}
-		await this.context?.close().catch(() => {});
-		await this.browser?.close().catch(() => {});
-		this.context = null;
-		this.browser = null;
-	}
-	/**
-	* Ensure Playwright context or Chrome Extension provider is ready.
-	* Extension mode does not create a Playwright {@link BrowserContext}.
-	*/
-	async ensureConnected() {
-		if (this.extensionProvider) return;
-		if (this.context && this._isPlaywrightConnectionAlive()) return;
-		if (this.context || this.browser) {
-			log.warn({ mode: this.activeBackendMode }, "Browser session unavailable — reconnecting");
-			await this._resetStalePlaywrightSession();
-		}
-		const backend = this.options.getBackend?.() ?? {
-			mode: "local",
-			headless: false
-		};
-		switch (backend.mode) {
-			case "cdp":
-				await this._connectViaCdp(backend.config.wsEndpoint);
-				break;
-			case "cloud":
-				await this._connectViaCloud(backend.config);
-				break;
-			case "extension":
-				await this._connectViaExtension(backend.config);
-				break;
-			case "cloakbrowser":
-				await this._connectViaCloakBrowser(backend.config);
-				break;
-			default:
-				await this._launchLocal(backend.mode === "local" ? backend.headless : this.options.getHeadless() === true);
-				break;
-		}
-		this.activeBackendMode = backend.mode;
-		if (this.browser) this._wireBrowserLifecycle(this.browser);
-	}
-	async _launchLocal(headless) {
-		const pw = await loadPlaywrightCoreModule();
-		const chromium = pw.chromium ?? pw.default?.chromium;
-		if (!chromium?.launch) throw new Error("playwright-core did not expose chromium (try reinstall: pnpm install playwright-core; install browser: npx playwright install chromium)");
-		this.browser = await chromium.launch({
-			headless,
-			...headless ? { channel: "chromium" } : {},
-			args: ["--no-sandbox", "--disable-setuid-sandbox"]
-		});
-		this.context = await this.browser.newContext({
-			viewport: {
-				width: 1280,
-				height: 720
-			},
-			userAgent: "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36"
-		});
-		log.info({
-			headless,
-			mode: "local"
-		}, "Browser launched (local)");
-	}
-	async _connectViaCdp(wsEndpoint) {
-		const pw = await loadPlaywrightCoreModule();
-		const chromium = pw.chromium ?? pw.default?.chromium;
-		if (!chromium?.connectOverCDP) throw new Error("playwright-core does not support connectOverCDP");
-		this.browser = await chromium.connectOverCDP(wsEndpoint);
-		const contexts = this.browser.contexts();
-		this.context = contexts.length > 0 ? contexts[0] : await this.browser.newContext();
-		log.info({
-			mode: "cdp",
-			wsEndpoint
-		}, "Browser connected (CDP)");
-	}
-	async _connectViaCloud(config) {
-		const { BrowserbaseProvider } = await import("./providers/browserbase.js");
-		const { BrowserUseProvider } = await import("./providers/browser-use.js");
-		const provider = config.type === "browserbase" ? new BrowserbaseProvider(config) : new BrowserUseProvider(config);
-		const { browser, context } = await provider.connect();
-		this.browser = browser;
-		this.context = context;
-		this.cloudProvider = provider;
-		log.info({
-			mode: "cloud",
-			provider: config.type
-		}, `Browser connected (${config.type})`);
-	}
-	async _connectViaExtension(config) {
-		const { acquireExtensionBrowserServer } = await import("./providers/extension-ws-acquire.js");
-		const { provider, release } = await acquireExtensionBrowserServer(config);
-		this.extensionProvider = provider;
-		this.extensionRelease = release;
-		log.info({ port: config?.port ?? 19820 }, "Extension WS server ready, waiting for Chrome Extension...");
-		await provider.waitForConnection();
-		log.info({ mode: "extension" }, "Browser connected (Chrome Extension)");
-	}
-	async _connectViaCloakBrowser(config) {
-		const { launchCloakBrowser } = await import("./providers/cloakbrowser.js");
-		const result = await launchCloakBrowser(config);
-		if (!result.browser || !result.context) throw new Error("BrowserManager: CloakBrowser launch did not return a Playwright connection");
-		this.browser = result.browser;
-		this.context = result.context;
-		this.cloakChildProcess = result.childProcess;
-		this.cloakTempProfileDir = result.temporaryProfileDir;
-		log.info({ mode: "cloakbrowser" }, "Browser connected (CloakBrowser)");
-	}
-	async getPage(taskId) {
-		if (this.extensionProvider) throw new Error("BrowserManager.getPage is not used in Chrome Extension backend mode");
-		this.evictIdlePages();
-		await this.ensureConnected();
-		const existing = this.pages.get(taskId);
-		if (existing && !existing.page.isClosed()) {
-			existing.lastUsed = Date.now();
-			return existing.page;
-		}
-		if (existing) this.pages.delete(taskId);
-		if (this.pages.size >= MAX_PAGES) {
-			const oldest = [...this.pages.entries()].sort((a, b) => a[1].lastUsed - b[1].lastUsed)[0];
-			if (oldest) {
-				await oldest[1].page.close().catch(() => {});
-				this.pages.delete(oldest[0]);
-			}
-		}
-		const ctx = this.context;
-		if (!ctx) throw new Error("BrowserManager: Playwright context missing after ensureConnected");
-		const page = await ctx.newPage();
-		this.pages.set(taskId, {
-			page,
-			lastUsed: Date.now()
-		});
-		return page;
-	}
-	async closePage(taskId) {
-		if (this.extensionProvider) return;
-		const entry = this.pages.get(taskId);
-		if (entry) {
-			await entry.page.close().catch(() => {});
-			this.pages.delete(taskId);
-		}
-	}
-	/** Get the extension provider (only available in extension mode). */
-	getExtensionProvider() {
-		return this.extensionProvider;
-	}
-	async shutdown() {
-		for (const [, entry] of this.pages) await entry.page.close().catch(() => {});
-		this.pages.clear();
-		if (this.cloudProvider) {
-			await this.cloudProvider.disconnect().catch(() => {});
-			this.cloudProvider = null;
-		}
-		if (this.extensionRelease) {
-			await this.extensionRelease().catch(() => {});
-			this.extensionRelease = null;
-		}
-		this.extensionProvider = null;
-		if (this.cloakChildProcess || this.cloakTempProfileDir) {
-			const { cleanupCloakBrowser } = await import("./providers/cloakbrowser.js");
-			await cleanupCloakBrowser(this.cloakChildProcess, this.cloakTempProfileDir).catch(() => {});
-			this.cloakChildProcess = null;
-			this.cloakTempProfileDir = null;
-		}
-		await this.context?.close().catch(() => {});
-		await this.browser?.close().catch(() => {});
-		this.context = null;
-		this.browser = null;
-		this.activeBackendMode = null;
-		log.info("Browser shut down");
-	}
-};
-//#endregion
-export { BrowserManager };

package/dist/src/browser/pipeline/output.d.ts

@@ -1,35 +0,0 @@
-/**
- * Pipeline output formatting.
- */
-import type { BrowserActionResult, BrowserArtifact, BrowserDiagnostics } from '../actions/types.js';
-export interface PipelineStepTrace {
-    index: number;
-    scope: string;
-    action: string;
-    ok: boolean;
-    elapsedMs: number;
-    text?: string;
-    data?: unknown;
-    error?: {
-        code: string;
-        message: string;
-    };
-}
-export interface PipelineOutput {
-    ok: boolean;
-    name: string;
-    last: unknown;
-    outputs: unknown[];
-    artifacts: BrowserArtifact[];
-    diagnostics: BrowserDiagnostics;
-    trace: PipelineStepTrace[];
-    error?: {
-        step: number;
-        action: string;
-        code: string;
-        message: string;
-    };
-}
-export declare function createPipelineOutput(name: string): PipelineOutput;
-export declare function addStepTrace(output: PipelineOutput, trace: PipelineStepTrace, result: BrowserActionResult): void;
-export declare function formatPipelineResult(output: PipelineOutput): BrowserActionResult;