@gaodefa/daocore 2026.5.51 → 2026.5.53

package/dist/chrome-YaZdp6CU.js

@@ -1,1503 +0,0 @@
-import { c as normalizeOptionalString } from "./string-coerce-DyL154ka.js";
-import { l as redactToolPayloadText, s as redactSensitiveText } from "./redact-BjrmHGQ6.js";
-import { t as CONFIG_DIR } from "./utils-CNnMhEDp.js";
-import { n as resolvePreferredDaoCoreTmpDir } from "./tmp-daocore-dir-kDRsiZXM.js";
-import { t as createSubsystemLogger } from "./subsystem-CppbuBPw.js";
-import { i as isLoopbackHost } from "./net-DCUMtgJy.js";
-import { r as ensurePortAvailable } from "./ports-B1fB1lIN.js";
-import { r as saveJsonFile, t as loadJsonFile } from "./json-store-GaAZLixM.js";
-import { t as prepareOomScoreAdjustedSpawn } from "./linux-oom-score-CaKivPe9.js";
-import { t as normalizeHostname } from "./hostname-DX6nIUV7.js";
-import { _ as resolvePinnedHostnameWithPolicy, d as isPrivateNetworkAllowedByPolicy, p as matchesHostnameAllowlist } from "./ssrf-BNF8aODC.js";
-import "./string-coerce-runtime-DcopKqDR.js";
-import "./process-runtime-DTv7Y5Wr.js";
-import { t as ensureAbsoluteDirectory } from "./sdk-security-runtime-D1Z-V8Bd.js";
-import { A as CHROME_LAUNCH_READY_WINDOW_MS, M as CHROME_STDERR_HINT_MAX_CHARS, N as CHROME_STOP_TIMEOUT_MS, O as CHROME_BOOTSTRAP_EXIT_TIMEOUT_MS, b as BrowserProfileUnavailableError, c as isWebSocketUrl, f as redactCdpUrl, g as BrowserCdpEndpointBlockedError, i as fetchJson, k as CHROME_BOOTSTRAP_PREFS_TIMEOUT_MS, l as normalizeCdpHttpBaseForJsonEndpoints, n as assertCdpEndpointAllowed, p as withCdpSocket, q as DEFAULT_DAOCORE_BROWSER_PROFILE_NAME, r as fetchCdpChecked, s as isDirectCdpWebSocketEndpoint, t as appendCdpPath, u as openCdpWebSocket } from "./cdp.helpers-Dc4Aa7R9.js";
-import { a as DEFAULT_DOWNLOAD_DIR, r as resolveManagedBrowserHeadlessMode, t as getManagedBrowserMissingDisplayError } from "./config-FCIVG4Db.js";
-import "./tmp-daocore-dir-0uyqO_dp.js";
-import { r as resolveBrowserExecutableForPlatform } from "./chrome.executables-CeF4Du_1.js";
-import "./subsystem-CsJPum4H.js";
-import fs from "node:fs";
-import path from "node:path";
-import fs$1 from "node:fs/promises";
-import os from "node:os";
-import { spawn } from "node:child_process";
-import { isIP } from "node:net";
-//#region extensions/browser/src/browser/navigation-guard.ts
-const NETWORK_NAVIGATION_PROTOCOLS = new Set(["http:", "https:"]);
-const SAFE_NON_NETWORK_URLS = new Set(["about:blank"]);
-function isAllowedNonNetworkNavigationUrl(parsed) {
-	return SAFE_NON_NETWORK_URLS.has(parsed.href);
-}
-function normalizeNavigationUrl(url) {
-	return url.trim();
-}
-var InvalidBrowserNavigationUrlError = class extends Error {
-	constructor(message) {
-		super(message);
-		this.name = "InvalidBrowserNavigationUrlError";
-	}
-};
-function withBrowserNavigationPolicy(ssrfPolicy, opts) {
-	return {
-		...ssrfPolicy ? { ssrfPolicy } : {},
-		...opts?.browserProxyMode && opts.browserProxyMode !== "direct" ? { browserProxyMode: opts.browserProxyMode } : {}
-	};
-}
-function requiresInspectableBrowserNavigationRedirects(ssrfPolicy) {
-	return ssrfPolicy?.dangerouslyAllowPrivateNetwork === false;
-}
-function requiresInspectableBrowserNavigationRedirectsForUrl(url, ssrfPolicy) {
-	if (!requiresInspectableBrowserNavigationRedirects(ssrfPolicy)) return false;
-	try {
-		const parsed = new URL(url);
-		return NETWORK_NAVIGATION_PROTOCOLS.has(parsed.protocol);
-	} catch {
-		return false;
-	}
-}
-function isIpLiteralHostname(hostname) {
-	return isIP(normalizeHostname(hostname)) !== 0;
-}
-function isExplicitlyAllowedBrowserHostname(hostname, ssrfPolicy) {
-	const normalizedHostname = normalizeHostname(hostname);
-	if ((ssrfPolicy?.allowedHostnames ?? []).some((value) => normalizeHostname(value) === normalizedHostname)) return true;
-	const hostnameAllowlist = (ssrfPolicy?.hostnameAllowlist ?? []).map((pattern) => normalizeHostname(pattern)).filter(Boolean);
-	return hostnameAllowlist.length > 0 ? matchesHostnameAllowlist(normalizedHostname, hostnameAllowlist) : false;
-}
-async function assertBrowserNavigationAllowed(opts) {
-	const rawUrl = normalizeNavigationUrl(opts.url);
-	if (!rawUrl) throw new InvalidBrowserNavigationUrlError("url is required");
-	let parsed;
-	try {
-		parsed = new URL(rawUrl);
-	} catch {
-		throw new InvalidBrowserNavigationUrlError(`Invalid URL: ${rawUrl}`);
-	}
-	if (!NETWORK_NAVIGATION_PROTOCOLS.has(parsed.protocol)) {
-		if (isAllowedNonNetworkNavigationUrl(parsed)) return;
-		throw new InvalidBrowserNavigationUrlError(`Navigation blocked: unsupported protocol "${parsed.protocol}"`);
-	}
-	if (opts.browserProxyMode === "explicit-browser-proxy" && !isPrivateNetworkAllowedByPolicy(opts.ssrfPolicy)) throw new InvalidBrowserNavigationUrlError("Navigation blocked: strict browser SSRF policy cannot be enforced while this browser profile is proxy-routed");
-	if (opts.ssrfPolicy && opts.ssrfPolicy.dangerouslyAllowPrivateNetwork === false && !isPrivateNetworkAllowedByPolicy(opts.ssrfPolicy) && !isIpLiteralHostname(parsed.hostname) && !isExplicitlyAllowedBrowserHostname(parsed.hostname, opts.ssrfPolicy)) throw new InvalidBrowserNavigationUrlError("Navigation blocked: strict browser SSRF policy requires an IP-literal URL because browser DNS rebinding protections are unavailable for hostname-based navigation");
-	await resolvePinnedHostnameWithPolicy(parsed.hostname, {
-		lookupFn: opts.lookupFn,
-		policy: opts.ssrfPolicy
-	});
-}
-/**
-* Best-effort post-navigation guard for final page URLs.
-* Only validates network URLs (http/https) and about:blank to avoid false
-* positives on browser-internal error pages (e.g. chrome-error://). In strict
-* mode this intentionally re-applies the hostname gate after redirects.
-*/
-async function assertBrowserNavigationResultAllowed(opts) {
-	const rawUrl = normalizeNavigationUrl(opts.url);
-	if (!rawUrl) return;
-	let parsed;
-	try {
-		parsed = new URL(rawUrl);
-	} catch {
-		return;
-	}
-	if (NETWORK_NAVIGATION_PROTOCOLS.has(parsed.protocol) || isAllowedNonNetworkNavigationUrl(parsed)) await assertBrowserNavigationAllowed(opts);
-}
-async function assertBrowserNavigationRedirectChainAllowed(opts) {
-	const chain = [];
-	let current = opts.request ?? null;
-	while (current) {
-		chain.push(current.url());
-		current = current.redirectedFrom();
-	}
-	for (const url of chain.toReversed()) await assertBrowserNavigationAllowed({
-		url,
-		lookupFn: opts.lookupFn,
-		ssrfPolicy: opts.ssrfPolicy,
-		browserProxyMode: opts.browserProxyMode
-	});
-}
-//#endregion
-//#region extensions/browser/src/browser/browser-proxy-mode.ts
-const PROXY_ROUTING_CHROME_ARGS = new Set([
-	"--proxy-auto-detect",
-	"--proxy-pac-url",
-	"--proxy-server"
-]);
-const PROXY_CONTROL_CHROME_ARGS = new Set(["--no-proxy-server", ...PROXY_ROUTING_CHROME_ARGS]);
-const CHROME_PROXY_ENV_KEYS = [
-	"HTTP_PROXY",
-	"HTTPS_PROXY",
-	"ALL_PROXY",
-	"NO_PROXY",
-	"http_proxy",
-	"https_proxy",
-	"all_proxy",
-	"no_proxy"
-];
-function chromeArgName(arg) {
-	return arg.trim().split("=", 1)[0]?.toLowerCase() ?? "";
-}
-function hasChromeProxyControlArg(args) {
-	return args.some((arg) => PROXY_CONTROL_CHROME_ARGS.has(chromeArgName(arg)));
-}
-function hasExplicitChromeProxyRoutingArg(args) {
-	return args.some((arg) => PROXY_ROUTING_CHROME_ARGS.has(chromeArgName(arg)));
-}
-function omitChromeProxyEnv(env) {
-	const next = { ...env };
-	for (const key of CHROME_PROXY_ENV_KEYS) delete next[key];
-	return next;
-}
-function resolveBrowserNavigationProxyMode(params) {
-	if (params.profile.driver === "daocore" && params.profile.cdpIsLoopback && hasExplicitChromeProxyRoutingArg(params.resolved.extraArgs)) return "explicit-browser-proxy";
-	return "direct";
-}
-//#endregion
-//#region extensions/browser/src/browser/output-directories.ts
-async function resolveSystemDirectoryAlias(dirPath) {
-	for (const aliasRoot of ["/tmp", "/var"]) {
-		if (dirPath !== aliasRoot && !dirPath.startsWith(`${aliasRoot}${path.sep}`)) continue;
-		try {
-			if (!(await fs$1.lstat(aliasRoot)).isSymbolicLink()) return dirPath;
-			return path.join(await fs$1.realpath(aliasRoot), path.relative(aliasRoot, dirPath));
-		} catch {
-			return dirPath;
-		}
-	}
-	return dirPath;
-}
-async function ensureOutputDirectory(dirPath) {
-	const result = await ensureAbsoluteDirectory(await resolveSystemDirectoryAlias(path.resolve(dirPath)), { scopeLabel: "output directory" });
-	if (!result.ok) throw result.error;
-}
-//#endregion
-//#region extensions/browser/src/browser/snapshot-roles.ts
-/**
-* Shared ARIA role classification sets used by both the Playwright and Chrome MCP
-* snapshot paths. Keep these in sync — divergence causes the two drivers to produce
-* different snapshot output for the same page.
-*/
-/** Roles that represent user-interactive elements and always get a ref. */
-const INTERACTIVE_ROLES = new Set([
-	"button",
-	"checkbox",
-	"combobox",
-	"link",
-	"listbox",
-	"menuitem",
-	"menuitemcheckbox",
-	"menuitemradio",
-	"option",
-	"radio",
-	"searchbox",
-	"slider",
-	"spinbutton",
-	"switch",
-	"tab",
-	"textbox",
-	"treeitem"
-]);
-/** Roles that carry meaningful content and get a ref when named. */
-const CONTENT_ROLES = new Set([
-	"article",
-	"cell",
-	"columnheader",
-	"gridcell",
-	"heading",
-	"listitem",
-	"main",
-	"navigation",
-	"region",
-	"rowheader"
-]);
-/** Structural/container roles — typically skipped in compact mode. */
-const STRUCTURAL_ROLES = new Set([
-	"application",
-	"directory",
-	"document",
-	"generic",
-	"grid",
-	"group",
-	"ignored",
-	"list",
-	"menu",
-	"menubar",
-	"none",
-	"presentation",
-	"row",
-	"rowgroup",
-	"table",
-	"tablist",
-	"toolbar",
-	"tree",
-	"treegrid"
-]);
-//#endregion
-//#region extensions/browser/src/browser/cdp.ts
-function normalizeCdpWsUrl(wsUrl, cdpUrl) {
-	const ws = new URL(wsUrl);
-	const cdp = new URL(cdpUrl);
-	const isWildcardBind = ws.hostname === "0.0.0.0" || ws.hostname === "[::]";
-	if ((isLoopbackHost(ws.hostname) || isWildcardBind) && !isLoopbackHost(cdp.hostname)) {
-		ws.hostname = cdp.hostname;
-		const cdpPort = cdp.port || (cdp.protocol === "https:" ? "443" : "80");
-		/* c8 ignore next 3 */
-		if (cdpPort) ws.port = cdpPort;
-		ws.protocol = cdp.protocol === "https:" ? "wss:" : "ws:";
-	} else if (isLoopbackHost(ws.hostname) && isLoopbackHost(cdp.hostname)) ws.hostname = cdp.hostname;
-	if (cdp.protocol === "https:" && ws.protocol === "ws:") ws.protocol = "wss:";
-	if (!ws.username && !ws.password && (cdp.username || cdp.password)) {
-		ws.username = cdp.username;
-		ws.password = cdp.password;
-	}
-	for (const [key, value] of cdp.searchParams.entries()) if (!ws.searchParams.has(key)) ws.searchParams.append(key, value);
-	return ws.toString();
-}
-async function captureScreenshot(opts) {
-	return await withCdpSocket(opts.wsUrl, async (send) => {
-		await send("Page.enable");
-		let savedVp;
-		if (opts.fullPage) {
-			const metrics = await send("Page.getLayoutMetrics");
-			const size = metrics?.cssContentSize ?? metrics?.contentSize;
-			const contentWidth = size?.width ?? 0;
-			const contentHeight = size?.height ?? 0;
-			if (contentWidth > 0 && contentHeight > 0) {
-				const v = (await send("Runtime.evaluate", {
-					expression: "({ w: window.innerWidth, h: window.innerHeight, dpr: window.devicePixelRatio, sw: screen.width, sh: screen.height })",
-					returnByValue: true
-				}))?.result?.value;
-				const currentW = v?.w ?? 0;
-				const currentH = v?.h ?? 0;
-				savedVp = {
-					w: currentW,
-					h: currentH,
-					dpr: v?.dpr ?? 1,
-					sw: v?.sw ?? currentW,
-					sh: v?.sh ?? currentH
-				};
-				await send("Emulation.setDeviceMetricsOverride", {
-					width: Math.ceil(Math.max(currentW, contentWidth)),
-					height: Math.ceil(Math.max(currentH, contentHeight)),
-					deviceScaleFactor: savedVp.dpr,
-					mobile: false,
-					screenWidth: savedVp.sw,
-					screenHeight: savedVp.sh
-				});
-			}
-		}
-		const format = opts.format ?? "png";
-		const quality = format === "jpeg" ? Math.max(0, Math.min(100, Math.round(opts.quality ?? 85))) : void 0;
-		try {
-			const base64 = (await send("Page.captureScreenshot", {
-				format,
-				...quality !== void 0 ? { quality } : {},
-				...opts.fullPage ? { captureBeyondViewport: true } : {}
-			}))?.data;
-			if (!base64) throw new Error("Screenshot failed: missing data");
-			return Buffer.from(base64, "base64");
-		} finally {
-			if (savedVp) {
-				await send("Emulation.clearDeviceMetricsOverride").catch(() => {});
-				try {
-					const p = (await send("Runtime.evaluate", {
-						expression: "({ w: window.innerWidth, h: window.innerHeight, dpr: window.devicePixelRatio })",
-						returnByValue: true
-					}))?.result?.value;
-					if (p?.w !== savedVp.w || p?.h !== savedVp.h || p?.dpr !== savedVp.dpr) await send("Emulation.setDeviceMetricsOverride", {
-						width: savedVp.w,
-						height: savedVp.h,
-						deviceScaleFactor: savedVp.dpr,
-						mobile: false,
-						screenWidth: savedVp.sw,
-						screenHeight: savedVp.sh
-					});
-				} catch {}
-			}
-		}
-	}, { commandTimeoutMs: opts.timeoutMs });
-}
-async function createTargetViaCdp(opts) {
-	await assertBrowserNavigationAllowed({
-		url: opts.url,
-		...withBrowserNavigationPolicy(opts.ssrfPolicy)
-	});
-	let wsUrl;
-	if (isDirectCdpWebSocketEndpoint(opts.cdpUrl)) {
-		await assertCdpEndpointAllowed(opts.cdpUrl, opts.ssrfPolicy);
-		wsUrl = opts.cdpUrl;
-	} else {
-		const discoveryUrl = isWebSocketUrl(opts.cdpUrl) ? normalizeCdpHttpBaseForJsonEndpoints(opts.cdpUrl) : opts.cdpUrl;
-		let version = null;
-		try {
-			version = await fetchJson(appendCdpPath(discoveryUrl, "/json/version"), opts.timeouts?.httpTimeoutMs, void 0, opts.ssrfPolicy);
-		} catch (err) {
-			if (!isWebSocketUrl(opts.cdpUrl)) throw err;
-		}
-		const wsUrlRaw = version?.webSocketDebuggerUrl?.trim() ?? "";
-		if (wsUrlRaw) wsUrl = normalizeCdpWsUrl(wsUrlRaw, discoveryUrl);
-		else if (isWebSocketUrl(opts.cdpUrl)) wsUrl = opts.cdpUrl;
-		else throw new Error("CDP /json/version missing webSocketDebuggerUrl");
-	}
-	const candidateWsUrls = isWebSocketUrl(opts.cdpUrl) && wsUrl !== opts.cdpUrl ? [wsUrl, opts.cdpUrl] : [wsUrl];
-	let lastError;
-	for (const candidateWsUrl of candidateWsUrls) try {
-		await assertCdpEndpointAllowed(candidateWsUrl, opts.ssrfPolicy);
-		return await withCdpSocket(candidateWsUrl, async (send) => {
-			const targetId = (await send("Target.createTarget", { url: opts.url }))?.targetId?.trim() ?? "";
-			if (!targetId) throw new Error("CDP Target.createTarget returned no targetId");
-			await prepareCdpTargetSession(send, targetId);
-			return { targetId };
-		}, {
-			commandTimeoutMs: opts.timeouts?.httpTimeoutMs ?? 5e3,
-			handshakeTimeoutMs: opts.timeouts?.handshakeTimeoutMs
-		});
-	} catch (err) {
-		lastError = err;
-	}
-	if (lastError instanceof Error) throw lastError;
-	throw new Error("CDP Target.createTarget failed");
-}
-async function prepareCdpTargetSession(send, targetId) {
-	const attached = await send("Target.attachToTarget", {
-		targetId,
-		flatten: true
-	}).catch(() => null);
-	const sessionId = typeof attached?.sessionId === "string" ? attached.sessionId : void 0;
-	if (!sessionId) return;
-	try {
-		await prepareCdpPageSession(send, sessionId);
-	} finally {
-		await send("Target.detachFromTarget", { sessionId }).catch(() => {});
-	}
-}
-async function prepareCdpPageSession(send, sessionId) {
-	await Promise.all([
-		send("Page.enable", void 0, sessionId).catch(() => {}),
-		send("Runtime.enable", void 0, sessionId).catch(() => {}),
-		send("Network.enable", void 0, sessionId).catch(() => {}),
-		send("DOM.enable", void 0, sessionId).catch(() => {}),
-		send("Accessibility.enable", void 0, sessionId).catch(() => {})
-	]);
-	await send("Runtime.runIfWaitingForDebugger", void 0, sessionId).catch(() => {});
-}
-const AX_REF_PATTERN = new RegExp(`^ax\\d+$`);
-function axValue(v) {
-	if (!v || typeof v !== "object") return "";
-	const value = v.value;
-	if (typeof value === "string") return value;
-	if (typeof value === "number" || typeof value === "boolean") return String(value);
-	return "";
-}
-function formatAriaSnapshot(nodes, limit) {
-	const byId = /* @__PURE__ */ new Map();
-	for (const n of nodes) if (n.nodeId) byId.set(n.nodeId, n);
-	const referenced = /* @__PURE__ */ new Set();
-	for (const n of nodes) for (const c of n.childIds ?? []) referenced.add(c);
-	const root = nodes.find((n) => n.nodeId && !referenced.has(n.nodeId)) ?? nodes[0];
-	if (!root?.nodeId) return [];
-	const out = [];
-	const stack = [{
-		id: root.nodeId,
-		depth: 0
-	}];
-	while (stack.length && out.length < limit) {
-		const popped = stack.pop();
-		/* c8 ignore next 3 */
-		if (!popped) break;
-		const { id, depth } = popped;
-		const n = byId.get(id);
-		/* c8 ignore next 3 */
-		if (!n) continue;
-		const role = axValue(n.role);
-		const name = axValue(n.name);
-		const value = axValue(n.value);
-		const description = axValue(n.description);
-		const ref = `ax${out.length + 1}`;
-		out.push({
-			ref,
-			role: role || "unknown",
-			name: name || "",
-			...value ? { value } : {},
-			...description ? { description } : {},
-			...typeof n.backendDOMNodeId === "number" ? { backendDOMNodeId: n.backendDOMNodeId } : {},
-			depth
-		});
-		const children = (n.childIds ?? []).filter((c) => byId.has(c));
-		for (let i = children.length - 1; i >= 0; i--) {
-			const child = children[i];
-			/* c8 ignore next 3 */
-			if (child) stack.push({
-				id: child,
-				depth: depth + 1
-			});
-		}
-	}
-	return out;
-}
-async function snapshotAria(opts) {
-	const limit = Math.max(1, Math.min(2e3, Math.floor(opts.limit ?? 500)));
-	return await withCdpSocket(opts.wsUrl, async (send) => {
-		await prepareCdpPageSession(send);
-		const res = await send("Accessibility.getFullAXTree");
-		return { nodes: formatAriaSnapshot(Array.isArray(res?.nodes) ? res.nodes : [], limit) };
-	}, { commandTimeoutMs: opts.timeoutMs ?? 5e3 });
-}
-function buildRoleTree(nodes) {
-	const byId = /* @__PURE__ */ new Map();
-	const tree = [];
-	for (const raw of nodes) {
-		const nodeId = raw.nodeId ?? "";
-		if (!nodeId) continue;
-		byId.set(nodeId, tree.length);
-		tree.push({
-			raw,
-			role: axValue(raw.role) || "unknown",
-			name: axValue(raw.name),
-			value: axValue(raw.value),
-			backendDOMNodeId: typeof raw.backendDOMNodeId === "number" && raw.backendDOMNodeId > 0 ? Math.floor(raw.backendDOMNodeId) : void 0,
-			children: [],
-			depth: 0
-		});
-	}
-	const childIndexes = /* @__PURE__ */ new Set();
-	for (let index = 0; index < tree.length; index += 1) for (const childId of tree[index]?.raw.childIds ?? []) {
-		const childIndex = byId.get(childId);
-		if (childIndex === void 0) continue;
-		tree[index]?.children.push(childIndex);
-		tree[childIndex].parent = index;
-		childIndexes.add(childIndex);
-	}
-	const roots = tree.map((_node, index) => index).filter((index) => !childIndexes.has(index));
-	const stack = roots.map((index) => ({
-		index,
-		depth: 0
-	}));
-	while (stack.length) {
-		const current = stack.pop();
-		if (!current) break;
-		tree[current.index].depth = current.depth;
-		for (const child of (tree[current.index]?.children ?? []).toReversed()) stack.push({
-			index: child,
-			depth: current.depth + 1
-		});
-	}
-	return {
-		tree,
-		roots: roots.length ? roots : tree.length ? [0] : []
-	};
-}
-function shouldIncludeRoleNode(node, options) {
-	const role = node.role.toLowerCase();
-	if (options.maxDepth !== void 0 && node.depth > options.maxDepth) return false;
-	if (options.interactive) return INTERACTIVE_ROLES.has(role) || role === "iframe" || Boolean(node.cursorInfo);
-	if (options.compact && STRUCTURAL_ROLES.has(role) && !node.name && !node.ref) return false;
-	return true;
-}
-function cursorSuffix(info) {
-	if (!info) return "";
-	const parts = [
-		info.hasCursorPointer ? "cursor:pointer" : void 0,
-		info.hasOnClick ? "onclick" : void 0,
-		info.hasTabIndex ? "tabindex" : void 0,
-		info.isEditable ? "contenteditable" : void 0,
-		info.hiddenInputType ? `hidden-${info.hiddenInputType}` : void 0
-	].filter(Boolean);
-	return parts.length ? ` [${parts.join(", ")}]` : "";
-}
-function renderRoleTree(tree, index, output, options, indentOffset = 0) {
-	const node = tree[index];
-	if (!node) return;
-	if (shouldIncludeRoleNode(node, options)) {
-		const indent = "  ".repeat(Math.max(0, node.depth + indentOffset));
-		const name = node.name ? ` "${node.name.replaceAll("\"", "\\\"")}"` : "";
-		const ref = node.ref ? ` [ref=${node.ref}]` : "";
-		const nth = node.nth !== void 0 && node.nth > 0 ? ` [nth=${node.nth}]` : "";
-		const value = node.value ? ` value="${node.value.replaceAll("\"", "\\\"")}"` : "";
-		const url = node.url ? ` [url=${node.url}]` : "";
-		output.push(`${indent}- ${node.role}${name}${ref}${nth}${value}${url}${cursorSuffix(node.cursorInfo)}`);
-	}
-	for (const child of node.children) renderRoleTree(tree, child, output, options, indentOffset);
-}
-async function findCursorInteractiveElements(send, sessionId) {
-	const attr = "data-daocore-cdp-ci";
-	const evaluated = await send("Runtime.evaluate", {
-		expression: `(() => {
-        const out = [];
-        const roles = new Set(["button","link","textbox","checkbox","radio","combobox","listbox","menuitem","menuitemcheckbox","menuitemradio","option","searchbox","slider","spinbutton","switch","tab","treeitem"]);
-        const tags = new Set(["a","button","input","select","textarea","details","summary"]);
-        document.querySelectorAll("[${attr}]").forEach((el) => el.removeAttribute("${attr}"));
-        for (const el of Array.from(document.body ? document.body.querySelectorAll("*") : [])) {
-          if (!(el instanceof HTMLElement) || el.closest("[hidden],[aria-hidden='true']")) continue;
-          const tagName = el.tagName.toLowerCase();
-          if (tags.has(tagName)) continue;
-          const role = String(el.getAttribute("role") || "").toLowerCase();
-          if (roles.has(role)) continue;
-          const style = getComputedStyle(el);
-          const hasCursorPointer = style.cursor === "pointer";
-          const hasOnClick = el.hasAttribute("onclick") || el.onclick !== null;
-          const tabIndex = el.getAttribute("tabindex");
-          const hasTabIndex = tabIndex !== null && tabIndex !== "-1";
-          const ce = el.getAttribute("contenteditable");
-          const isEditable = ce === "" || ce === "true";
-          if (!hasCursorPointer && !hasOnClick && !hasTabIndex && !isEditable) continue;
-          if (hasCursorPointer && !hasOnClick && !hasTabIndex && !isEditable) {
-            const parent = el.parentElement;
-            if (parent && getComputedStyle(parent).cursor === "pointer") continue;
-          }
-          const rect = el.getBoundingClientRect();
-          if (rect.width <= 0 || rect.height <= 0) continue;
-          let hiddenInputType = "";
-          const hiddenInput = el.querySelector("input[type='radio'],input[type='checkbox']");
-          if (hiddenInput instanceof HTMLInputElement) {
-            const hiddenStyle = getComputedStyle(hiddenInput);
-            if (hiddenInput.hidden || hiddenStyle.display === "none" || hiddenStyle.visibility === "hidden") {
-              hiddenInputType = hiddenInput.type;
-            }
-          }
-          el.setAttribute("${attr}", String(out.length));
-          out.push({
-            text: String(el.textContent || "").replace(/\\s+/g, " ").trim().slice(0, 100),
-            tagName,
-            hasCursorPointer,
-            hasOnClick,
-            hasTabIndex,
-            isEditable,
-            hiddenInputType,
-          });
-        }
-        return out;
-      })()`,
-		returnByValue: true,
-		awaitPromise: false
-	}, sessionId).catch(() => null);
-	const entries = Array.isArray(evaluated?.result?.value) ? evaluated.result.value : [];
-	if (!entries.length) return /* @__PURE__ */ new Map();
-	const rootNodeId = (await send("DOM.getDocument", { depth: 0 }, sessionId).catch(() => null))?.root?.nodeId;
-	if (typeof rootNodeId !== "number") return /* @__PURE__ */ new Map();
-	const queried = await send("DOM.querySelectorAll", {
-		nodeId: rootNodeId,
-		selector: `[${attr}]`
-	}, sessionId).catch(() => null);
-	const out = /* @__PURE__ */ new Map();
-	await Promise.all((queried?.nodeIds ?? []).map(async (nodeId) => {
-		const described = await send("DOM.describeNode", { nodeId }, sessionId).catch(() => null);
-		const attrs = described?.node?.attributes ?? [];
-		const attrIndex = attrs.indexOf(attr);
-		const rawIndex = attrIndex >= 0 ? attrs[attrIndex + 1] : void 0;
-		const index = typeof rawIndex === "string" ? Number(rawIndex) : NaN;
-		const backendNodeId = described?.node?.backendNodeId;
-		if (typeof backendNodeId === "number" && Number.isInteger(index) && entries[index]) out.set(backendNodeId, entries[index]);
-	}));
-	await send("Runtime.evaluate", {
-		expression: `document.querySelectorAll("[${attr}]").forEach((el) => el.removeAttribute("${attr}"))`,
-		returnByValue: true
-	}, sessionId).catch(() => {});
-	return out;
-}
-async function resolveLinkUrls(send, refs, sessionId) {
-	const out = /* @__PURE__ */ new Map();
-	await Promise.all(Object.values(refs).map(async (ref) => {
-		if (ref.role !== "link" || !ref.backendDOMNodeId) return;
-		const objectId = (await send("DOM.resolveNode", { backendNodeId: ref.backendDOMNodeId }, sessionId).catch(() => null))?.object?.objectId;
-		if (!objectId) return;
-		const hrefResult = await send("Runtime.callFunctionOn", {
-			objectId,
-			functionDeclaration: "function() { return this.href || ''; }",
-			returnByValue: true
-		}, sessionId).catch(() => null);
-		const href = typeof hrefResult?.result?.value === "string" ? hrefResult.result.value : "";
-		if (href) out.set(ref.backendDOMNodeId, href);
-	}));
-	return out;
-}
-async function resolveIframeFrameIds(send, tree, sessionId) {
-	const out = /* @__PURE__ */ new Map();
-	await Promise.all(tree.map(async (node) => {
-		if (node.role.toLowerCase() !== "iframe" || !node.backendDOMNodeId) return;
-		const described = await send("DOM.describeNode", {
-			backendNodeId: node.backendDOMNodeId,
-			depth: 1
-		}, sessionId).catch(() => null);
-		const frameId = described?.node?.contentDocument?.frameId ?? described?.node?.frameId ?? "";
-		if (frameId) out.set(node.backendDOMNodeId, frameId);
-	}));
-	return out;
-}
-async function buildCdpRoleSnapshot(params) {
-	const res = await params.send("Accessibility.getFullAXTree", params.frameId ? { frameId: params.frameId } : void 0, params.sessionId);
-	const { tree, roots } = buildRoleTree(Array.isArray(res.nodes) ? res.nodes : []);
-	const cursorElements = await findCursorInteractiveElements(params.send, params.sessionId);
-	for (const node of tree) if (node.backendDOMNodeId && cursorElements.has(node.backendDOMNodeId)) {
-		const cursorInfo = cursorElements.get(node.backendDOMNodeId);
-		node.cursorInfo = cursorInfo;
-		if (!node.name && cursorInfo?.text) node.name = cursorInfo.text;
-	}
-	const counts = /* @__PURE__ */ new Map();
-	const refsByKey = /* @__PURE__ */ new Map();
-	const refs = {};
-	for (const node of tree) {
-		const role = node.role.toLowerCase();
-		if (!(INTERACTIVE_ROLES.has(role) || CONTENT_ROLES.has(role) && Boolean(node.name) || role === "iframe" || Boolean(node.cursorInfo))) continue;
-		const key = `${role}:${node.name}`;
-		const nth = counts.get(key) ?? 0;
-		counts.set(key, nth + 1);
-		const ref = `e${params.nextRef.value}`;
-		params.nextRef.value += 1;
-		node.ref = ref;
-		node.nth = nth;
-		refsByKey.set(key, [...refsByKey.get(key) ?? [], ref]);
-		refs[ref] = {
-			role,
-			...node.name ? { name: node.name } : {},
-			...nth > 0 ? { nth } : {},
-			...node.backendDOMNodeId ? { backendDOMNodeId: node.backendDOMNodeId } : {},
-			...params.frameId ? { frameId: params.frameId } : {}
-		};
-	}
-	for (const refList of refsByKey.values()) {
-		if (refList.length > 1) continue;
-		const ref = refList[0];
-		if (ref) {
-			delete refs[ref]?.nth;
-			const node = tree.find((entry) => entry.ref === ref);
-			if (node) delete node.nth;
-		}
-	}
-	const iframeFrameIds = await resolveIframeFrameIds(params.send, tree, params.sessionId);
-	for (const node of tree) if (node.backendDOMNodeId && iframeFrameIds.has(node.backendDOMNodeId)) {
-		node.frameId = iframeFrameIds.get(node.backendDOMNodeId);
-		if (node.ref && refs[node.ref]) refs[node.ref].frameId = node.frameId;
-	}
-	if (params.urls) {
-		const urls = await resolveLinkUrls(params.send, refs, params.sessionId);
-		for (const node of tree) if (node.backendDOMNodeId && urls.has(node.backendDOMNodeId)) node.url = urls.get(node.backendDOMNodeId);
-	}
-	const lines = [];
-	for (const root of roots) renderRoleTree(tree, root, lines, params.options);
-	if (params.recurseIframes) {
-		const iframeNodes = tree.filter((node) => node.ref && node.frameId);
-		for (const iframe of iframeNodes) {
-			const marker = `[ref=${iframe.ref}]`;
-			const lineIndex = lines.findIndex((line) => line.includes(marker));
-			if (lineIndex < 0 || !iframe.frameId) continue;
-			const child = await buildCdpRoleSnapshot({
-				...params,
-				frameId: iframe.frameId,
-				recurseIframes: false
-			}).catch(() => null);
-			if (!child?.lines.length) continue;
-			Object.assign(refs, child.refs);
-			lines.splice(lineIndex + 1, 0, ...child.lines.map((line) => `  ${line}`));
-		}
-	}
-	const refValues = Object.values(refs);
-	return {
-		lines,
-		refs,
-		stats: {
-			refs: refValues.length,
-			interactive: refValues.filter((ref) => INTERACTIVE_ROLES.has(ref.role)).length
-		}
-	};
-}
-async function snapshotRoleViaCdp(opts) {
-	return await withCdpSocket(opts.wsUrl, async (send) => {
-		await prepareCdpPageSession(send);
-		const built = await buildCdpRoleSnapshot({
-			send,
-			options: opts.options ?? {},
-			urls: opts.urls,
-			recurseIframes: true,
-			nextRef: { value: 1 }
-		});
-		const snapshot = built.lines.join("\n").trim() || (opts.options?.interactive ? "(no interactive elements)" : "(empty page)");
-		return {
-			snapshot,
-			refs: built.refs,
-			stats: {
-				lines: snapshot.split("\n").length,
-				chars: snapshot.length,
-				refs: built.stats.refs,
-				interactive: built.stats.interactive
-			}
-		};
-	}, { commandTimeoutMs: opts.timeoutMs ?? 5e3 });
-}
-//#endregion
-//#region extensions/browser/src/infra/ws.ts
-function rawDataToString(data) {
-	if (typeof data === "string") return data;
-	if (Buffer.isBuffer(data)) return data.toString("utf8");
-	if (Array.isArray(data)) return Buffer.concat(data).toString("utf8");
-	if (ArrayBuffer.isView(data)) return Buffer.from(data.buffer, data.byteOffset, data.byteLength).toString("utf8");
-	if (data instanceof ArrayBuffer) return Buffer.from(data).toString("utf8");
-	return String(data);
-}
-//#endregion
-//#region extensions/browser/src/browser/chrome.diagnostics.ts
-function elapsedSince(startedAt) {
-	return Math.max(0, Date.now() - startedAt);
-}
-function safeChromeCdpErrorMessage(error) {
-	const message = error instanceof Error ? error.message : String(error);
-	const cause = error instanceof Error ? error.cause : void 0;
-	const causeMessage = cause instanceof Error ? cause.message : typeof cause === "string" ? cause : void 0;
-	if (message && causeMessage && !message.includes(causeMessage)) return redactSensitiveText(`${message}: ${causeMessage}`);
-	return redactSensitiveText(message || "unknown error");
-}
-function failureDiagnostic(params) {
-	return {
-		ok: false,
-		cdpUrl: params.cdpUrl,
-		wsUrl: params.wsUrl,
-		code: params.code,
-		message: redactSensitiveText(params.message),
-		elapsedMs: elapsedSince(params.startedAt)
-	};
-}
-async function readChromeVersion(cdpUrl, timeoutMs = 500, ssrfPolicy) {
-	const ctrl = new AbortController();
-	const t = setTimeout(ctrl.abort.bind(ctrl), timeoutMs);
-	try {
-		const { response, release } = await fetchCdpChecked(appendCdpPath(cdpUrl, "/json/version"), timeoutMs, { signal: ctrl.signal }, ssrfPolicy);
-		try {
-			const data = await response.json();
-			if (!data || typeof data !== "object") throw new Error("CDP /json/version returned non-object JSON");
-			return data;
-		} finally {
-			await release();
-		}
-	} finally {
-		clearTimeout(t);
-	}
-}
-async function diagnoseCdpHealthCommand(wsUrl, timeoutMs = 800) {
-	return await new Promise((resolve) => {
-		const ws = openCdpWebSocket(wsUrl, { handshakeTimeoutMs: timeoutMs });
-		let settled = false;
-		let opened = false;
-		const onMessage = (raw) => {
-			if (settled) return;
-			let parsed = null;
-			try {
-				parsed = JSON.parse(rawDataToString(raw));
-			} catch {
-				return;
-			}
-			if (parsed?.id !== 1) return;
-			if (parsed.result && typeof parsed.result === "object") {
-				finish({ ok: true });
-				return;
-			}
-			finish({
-				ok: false,
-				code: "websocket_health_command_failed",
-				message: "Browser.getVersion returned no result object"
-			});
-		};
-		const finish = (value) => {
-			if (settled) return;
-			settled = true;
-			clearTimeout(timer);
-			ws.off("message", onMessage);
-			try {
-				ws.close();
-			} catch {}
-			resolve(value);
-		};
-		const timer = setTimeout(() => {
-			try {
-				ws.terminate();
-			} catch {}
-			finish({
-				ok: false,
-				code: opened ? "websocket_health_command_timeout" : "websocket_handshake_failed",
-				message: opened ? `Browser.getVersion did not respond within ${timeoutMs}ms` : `WebSocket handshake did not complete within ${timeoutMs}ms`
-			});
-		}, Math.max(1, timeoutMs + Math.min(25, timeoutMs)));
-		ws.once("open", () => {
-			opened = true;
-			try {
-				ws.send(JSON.stringify({
-					id: 1,
-					method: "Browser.getVersion"
-				}));
-			} catch (err) {
-				finish({
-					ok: false,
-					code: "websocket_health_command_failed",
-					message: safeChromeCdpErrorMessage(err)
-				});
-			}
-		});
-		ws.on("message", onMessage);
-		ws.once("error", (err) => {
-			finish({
-				ok: false,
-				code: opened ? "websocket_health_command_failed" : "websocket_handshake_failed",
-				message: safeChromeCdpErrorMessage(err)
-			});
-		});
-		ws.once("close", () => {
-			finish({
-				ok: false,
-				code: opened ? "websocket_health_command_failed" : "websocket_handshake_failed",
-				message: opened ? "WebSocket closed before Browser.getVersion completed" : "WebSocket closed before handshake completed"
-			});
-		});
-	});
-}
-function classifyChromeVersionError(error) {
-	const message = safeChromeCdpErrorMessage(error);
-	if (error instanceof BrowserCdpEndpointBlockedError) return {
-		code: "ssrf_blocked",
-		message
-	};
-	if (/^HTTP \d+/.test(message)) return {
-		code: "http_status_failed",
-		message
-	};
-	if (error instanceof SyntaxError || message.includes("non-object JSON")) return {
-		code: "invalid_json",
-		message
-	};
-	return {
-		code: "http_unreachable",
-		message
-	};
-}
-function formatChromeCdpDiagnostic(diagnostic) {
-	const redactedCdpUrl = redactCdpUrl(diagnostic.cdpUrl) ?? diagnostic.cdpUrl;
-	const redactedWsUrl = redactCdpUrl(diagnostic.wsUrl) ?? diagnostic.wsUrl;
-	if (diagnostic.ok) {
-		const browser = diagnostic.browser ? ` browser=${diagnostic.browser}` : "";
-		return `CDP diagnostic: ready after ${diagnostic.elapsedMs}ms; cdp=${redactedCdpUrl}; websocket=${redactedWsUrl}.${browser}`;
-	}
-	const websocket = redactedWsUrl ? `; websocket=${redactedWsUrl}` : "";
-	const wslPortproxyHint = diagnostic.code === "http_unreachable" && isLikelyEmptyHttpReply(diagnostic.message) ? " In WSL2-to-Windows Chrome setups, this can be a stale netsh portproxy self-loop where svchost/iphlpsvc owns the CDP port instead of chrome.exe; verify with tasklist /svc and curl /json/version, then remove any 127.0.0.1:9222 -> 127.0.0.1:9222 portproxy rule." : "";
-	return `CDP diagnostic: ${diagnostic.code} after ${diagnostic.elapsedMs}ms; cdp=${redactedCdpUrl}${websocket}; ${diagnostic.message}.${wslPortproxyHint}`;
-}
-function isLikelyEmptyHttpReply(message) {
-	return /empty reply|other side closed|socket closed|terminated before response/i.test(message);
-}
-async function diagnoseChromeCdp(cdpUrl, timeoutMs = 500, handshakeTimeoutMs = 800, ssrfPolicy) {
-	const startedAt = Date.now();
-	try {
-		await assertCdpEndpointAllowed(cdpUrl, ssrfPolicy);
-	} catch (err) {
-		return failureDiagnostic({
-			cdpUrl,
-			code: "ssrf_blocked",
-			message: safeChromeCdpErrorMessage(err),
-			startedAt
-		});
-	}
-	if (isDirectCdpWebSocketEndpoint(cdpUrl)) {
-		const health = await diagnoseCdpHealthCommand(cdpUrl, handshakeTimeoutMs);
-		if (!health.ok) return failureDiagnostic({
-			cdpUrl,
-			wsUrl: cdpUrl,
-			code: health.code,
-			message: health.message,
-			startedAt
-		});
-		return {
-			ok: true,
-			cdpUrl,
-			wsUrl: cdpUrl,
-			elapsedMs: elapsedSince(startedAt)
-		};
-	}
-	const discoveryUrl = isWebSocketUrl(cdpUrl) ? normalizeCdpHttpBaseForJsonEndpoints(cdpUrl) : cdpUrl;
-	let version;
-	try {
-		version = await readChromeVersion(discoveryUrl, timeoutMs, ssrfPolicy);
-	} catch (err) {
-		if (isWebSocketUrl(cdpUrl)) {
-			const health = await diagnoseCdpHealthCommand(cdpUrl, handshakeTimeoutMs);
-			if (!health.ok) return failureDiagnostic({
-				cdpUrl,
-				wsUrl: cdpUrl,
-				code: health.code,
-				message: health.message,
-				startedAt
-			});
-			return {
-				ok: true,
-				cdpUrl,
-				wsUrl: cdpUrl,
-				elapsedMs: elapsedSince(startedAt)
-			};
-		}
-		const classified = classifyChromeVersionError(err);
-		return failureDiagnostic({
-			cdpUrl,
-			code: classified.code,
-			message: classified.message,
-			startedAt
-		});
-	}
-	const wsUrlRaw = normalizeOptionalString(version.webSocketDebuggerUrl) ?? "";
-	if (!wsUrlRaw) {
-		if (isWebSocketUrl(cdpUrl)) {
-			const health = await diagnoseCdpHealthCommand(cdpUrl, handshakeTimeoutMs);
-			if (!health.ok) return failureDiagnostic({
-				cdpUrl,
-				wsUrl: cdpUrl,
-				code: health.code,
-				message: health.message,
-				startedAt
-			});
-			return {
-				ok: true,
-				cdpUrl,
-				wsUrl: cdpUrl,
-				browser: version.Browser,
-				userAgent: version["User-Agent"],
-				elapsedMs: elapsedSince(startedAt)
-			};
-		}
-		return failureDiagnostic({
-			cdpUrl,
-			code: "missing_websocket_debugger_url",
-			message: "CDP /json/version did not include webSocketDebuggerUrl",
-			startedAt
-		});
-	}
-	const wsUrl = normalizeCdpWsUrl(wsUrlRaw, discoveryUrl);
-	try {
-		await assertCdpEndpointAllowed(wsUrl, ssrfPolicy);
-	} catch (err) {
-		return failureDiagnostic({
-			cdpUrl,
-			wsUrl,
-			code: "websocket_ssrf_blocked",
-			message: safeChromeCdpErrorMessage(err),
-			startedAt
-		});
-	}
-	const health = await diagnoseCdpHealthCommand(wsUrl, handshakeTimeoutMs);
-	if (!health.ok) {
-		if (isWebSocketUrl(cdpUrl) && wsUrl !== cdpUrl) {
-			if ((await diagnoseCdpHealthCommand(cdpUrl, handshakeTimeoutMs)).ok) return {
-				ok: true,
-				cdpUrl,
-				wsUrl: cdpUrl,
-				browser: version.Browser,
-				userAgent: version["User-Agent"],
-				elapsedMs: elapsedSince(startedAt)
-			};
-		}
-		return failureDiagnostic({
-			cdpUrl,
-			wsUrl,
-			code: health.code,
-			message: health.message,
-			startedAt
-		});
-	}
-	return {
-		ok: true,
-		cdpUrl,
-		wsUrl,
-		browser: version.Browser,
-		userAgent: version["User-Agent"],
-		elapsedMs: elapsedSince(startedAt)
-	};
-}
-//#endregion
-//#region extensions/browser/src/browser/chrome.profile-decoration.ts
-function decoratedMarkerPath(userDataDir) {
-	return path.join(userDataDir, ".daocore-profile-decorated");
-}
-function safeReadJson(filePath) {
-	const parsed = loadJsonFile(filePath);
-	return typeof parsed === "object" && parsed !== null && !Array.isArray(parsed) ? parsed : null;
-}
-function safeWriteJson(filePath, data) {
-	saveJsonFile(filePath, data);
-}
-function asRecord(value) {
-	return typeof value === "object" && value !== null && !Array.isArray(value) ? value : null;
-}
-function readNestedRecord(root, key) {
-	return asRecord(asRecord(root)?.[key]);
-}
-function setDeep(obj, keys, value) {
-	let node = obj;
-	for (const key of keys.slice(0, -1)) {
-		const next = node[key];
-		if (typeof next !== "object" || next === null || Array.isArray(next)) node[key] = {};
-		node = node[key];
-	}
-	node[keys[keys.length - 1] ?? ""] = value;
-}
-function parseHexRgbToSignedArgbInt(hex) {
-	const cleaned = hex.trim().replace(/^#/, "");
-	if (!/^[0-9a-fA-F]{6}$/.test(cleaned)) return null;
-	const argbUnsigned = 255 << 24 | Number.parseInt(cleaned, 16);
-	return argbUnsigned > 2147483647 ? argbUnsigned - 4294967296 : argbUnsigned;
-}
-function isProfileDecorated(userDataDir, desiredName, desiredColorHex, desiredDownloadDir) {
-	const desiredColorInt = parseHexRgbToSignedArgbInt(desiredColorHex);
-	const localStatePath = path.join(userDataDir, "Local State");
-	const preferencesPath = path.join(userDataDir, "Default", "Preferences");
-	const profile = safeReadJson(localStatePath)?.profile;
-	const info = readNestedRecord(readNestedRecord(profile, "info_cache"), "Default");
-	const prefs = safeReadJson(preferencesPath);
-	const browserTheme = readNestedRecord(prefs?.browser, "theme");
-	const autogeneratedTheme = readNestedRecord(prefs?.autogenerated, "theme");
-	const download = readNestedRecord(prefs, "download");
-	const savefile = readNestedRecord(prefs, "savefile");
-	const nameOk = typeof info?.name === "string" ? info.name === desiredName : true;
-	const downloadOk = desiredDownloadDir ? download?.default_directory === desiredDownloadDir && download.prompt_for_download === false && download.directory_upgrade === true && savefile?.default_directory === desiredDownloadDir : true;
-	if (desiredColorInt == null) return nameOk && downloadOk;
-	const localSeedOk = typeof info?.profile_color_seed === "number" ? info.profile_color_seed === desiredColorInt : false;
-	const prefOk = typeof browserTheme?.user_color2 === "number" && browserTheme.user_color2 === desiredColorInt || typeof autogeneratedTheme?.color === "number" && autogeneratedTheme.color === desiredColorInt;
-	return nameOk && localSeedOk && prefOk && downloadOk;
-}
-/**
-* Best-effort profile decoration (name + lobster-orange). Chrome preference keys
-* vary by version; we keep this conservative and idempotent.
-*/
-function decorateDaoCoreProfile(userDataDir, opts) {
-	const desiredName = opts?.name ?? "daocore";
-	const desiredColor = (opts?.color ?? "#FF4500").toUpperCase();
-	const desiredColorInt = parseHexRgbToSignedArgbInt(desiredColor);
-	const localStatePath = path.join(userDataDir, "Local State");
-	const preferencesPath = path.join(userDataDir, "Default", "Preferences");
-	const localState = safeReadJson(localStatePath) ?? {};
-	setDeep(localState, [
-		"profile",
-		"info_cache",
-		"Default",
-		"name"
-	], desiredName);
-	setDeep(localState, [
-		"profile",
-		"info_cache",
-		"Default",
-		"shortcut_name"
-	], desiredName);
-	setDeep(localState, [
-		"profile",
-		"info_cache",
-		"Default",
-		"user_name"
-	], desiredName);
-	setDeep(localState, [
-		"profile",
-		"info_cache",
-		"Default",
-		"profile_color"
-	], desiredColor);
-	setDeep(localState, [
-		"profile",
-		"info_cache",
-		"Default",
-		"user_color"
-	], desiredColor);
-	if (desiredColorInt != null) {
-		setDeep(localState, [
-			"profile",
-			"info_cache",
-			"Default",
-			"profile_color_seed"
-		], desiredColorInt);
-		setDeep(localState, [
-			"profile",
-			"info_cache",
-			"Default",
-			"profile_highlight_color"
-		], desiredColorInt);
-		setDeep(localState, [
-			"profile",
-			"info_cache",
-			"Default",
-			"default_avatar_fill_color"
-		], desiredColorInt);
-		setDeep(localState, [
-			"profile",
-			"info_cache",
-			"Default",
-			"default_avatar_stroke_color"
-		], desiredColorInt);
-	}
-	safeWriteJson(localStatePath, localState);
-	const prefs = safeReadJson(preferencesPath) ?? {};
-	setDeep(prefs, ["profile", "name"], desiredName);
-	setDeep(prefs, ["profile", "profile_color"], desiredColor);
-	setDeep(prefs, ["profile", "user_color"], desiredColor);
-	if (desiredColorInt != null) {
-		setDeep(prefs, [
-			"autogenerated",
-			"theme",
-			"color"
-		], desiredColorInt);
-		setDeep(prefs, [
-			"browser",
-			"theme",
-			"user_color2"
-		], desiredColorInt);
-	}
-	if (opts?.downloadDir) {
-		setDeep(prefs, ["download", "default_directory"], opts.downloadDir);
-		setDeep(prefs, ["download", "prompt_for_download"], false);
-		setDeep(prefs, ["download", "directory_upgrade"], true);
-		setDeep(prefs, ["savefile", "default_directory"], opts.downloadDir);
-	}
-	safeWriteJson(preferencesPath, prefs);
-	try {
-		fs.writeFileSync(decoratedMarkerPath(userDataDir), `${Date.now()}\n`, "utf-8");
-	} catch {}
-}
-function ensureProfileCleanExit(userDataDir) {
-	const preferencesPath = path.join(userDataDir, "Default", "Preferences");
-	const prefs = safeReadJson(preferencesPath) ?? {};
-	setDeep(prefs, ["exit_type"], "Normal");
-	setDeep(prefs, ["exited_cleanly"], true);
-	safeWriteJson(preferencesPath, prefs);
-}
-//#endregion
-//#region extensions/browser/src/browser/chrome.ts
-const log = createSubsystemLogger("browser").child("chrome");
-const CHROME_SINGLETON_LOCK_PATHS = [
-	"SingletonLock",
-	"SingletonSocket",
-	"SingletonCookie"
-];
-const CHROME_SINGLETON_IN_USE_PATTERN = /profile appears to be in use by another chromium process/i;
-const CHROME_MISSING_DISPLAY_PATTERN = /missing x server|\$DISPLAY/i;
-const CHROME_HTTP_DISCOVERY_FAILURE_CODES = new Set([
-	"ssrf_blocked",
-	"http_unreachable",
-	"http_status_failed",
-	"invalid_json"
-]);
-function exists(filePath) {
-	try {
-		return fs.existsSync(filePath);
-	} catch {
-		return false;
-	}
-}
-function diagnosticShowsChromeHttpDiscovery(diagnostic) {
-	if (!diagnostic) return false;
-	if (diagnostic.ok) return true;
-	return !CHROME_HTTP_DISCOVERY_FAILURE_CODES.has(diagnostic.code);
-}
-function processExists(pid) {
-	if (!Number.isInteger(pid) || pid <= 0) return false;
-	try {
-		process.kill(pid, 0);
-		return true;
-	} catch (err) {
-		if (err.code === "EPERM") return true;
-		return false;
-	}
-}
-function clearChromeSingletonArtifacts(userDataDir) {
-	for (const basename of CHROME_SINGLETON_LOCK_PATHS) try {
-		fs.rmSync(path.join(userDataDir, basename), { force: true });
-	} catch {}
-}
-function clearStaleChromeSingletonLocks(userDataDir, hostname = os.hostname()) {
-	const lockPath = path.join(userDataDir, "SingletonLock");
-	let target;
-	try {
-		target = fs.readlinkSync(lockPath);
-	} catch {
-		return false;
-	}
-	const match = /^(?<lockHost>.+)-(?<pid>\d+)$/.exec(target);
-	if (!match?.groups) return false;
-	const lockHost = normalizeOptionalString(match.groups.lockHost) ?? "";
-	const pid = Number.parseInt(match.groups.pid ?? "", 10);
-	if (lockHost === hostname && processExists(pid)) return false;
-	clearChromeSingletonArtifacts(userDataDir);
-	return true;
-}
-async function waitForChromeProcessExit(proc, timeoutMs) {
-	if (proc.exitCode != null || proc.signalCode != null || proc.killed) return;
-	await new Promise((resolve) => {
-		const timer = setTimeout(() => {
-			proc.off("exit", onExit);
-			proc.off("close", onExit);
-			resolve();
-		}, timeoutMs);
-		const onExit = () => {
-			clearTimeout(timer);
-			resolve();
-		};
-		proc.once("exit", onExit);
-		proc.once("close", onExit);
-	});
-}
-async function terminateChromeForRetry(proc, userDataDir) {
-	try {
-		proc.kill("SIGKILL");
-	} catch {}
-	await waitForChromeProcessExit(proc, CHROME_BOOTSTRAP_EXIT_TIMEOUT_MS);
-	clearStaleChromeSingletonLocks(userDataDir);
-}
-function chromeLaunchHints(params) {
-	const hints = [];
-	if (process.platform === "linux" && !params.resolved.noSandbox) hints.push("If running in a container or as root, try setting browser.noSandbox: true.");
-	const headlessMode = resolveManagedBrowserHeadlessMode(params.resolved, params.profile, params.launchOptions);
-	if (CHROME_MISSING_DISPLAY_PATTERN.test(params.stderrOutput) && !headlessMode.headless) hints.push("No DISPLAY/X server was detected. Set DAOCORE_BROWSER_HEADLESS=1, remove the headed override, start Xvfb, or run the Gateway in a desktop session.");
-	if (CHROME_SINGLETON_IN_USE_PATTERN.test(params.stderrOutput)) hints.push(`The Chromium profile "${params.profile.name}" is locked. Stop the existing browser or remove stale Singleton* lock files under ~/.daocore/browser/${params.profile.name}/user-data.`);
-	return hints.length > 0 ? `\nHint: ${hints.join("\nHint: ")}` : "";
-}
-function resolveBrowserExecutable(resolved, profile) {
-	return resolveBrowserExecutableForPlatform({
-		...resolved,
-		executablePath: profile.executablePath ?? resolved.executablePath
-	}, process.platform);
-}
-function resolveDaoCoreUserDataDir(profileName = DEFAULT_DAOCORE_BROWSER_PROFILE_NAME) {
-	return path.join(CONFIG_DIR, "browser", profileName, "user-data");
-}
-function cdpUrlForPort(cdpPort) {
-	return `http://127.0.0.1:${cdpPort}`;
-}
-function buildDaoCoreChromeLaunchArgs(params) {
-	const { resolved, profile, userDataDir } = params;
-	const headlessMode = resolveManagedBrowserHeadlessMode(resolved, profile, params);
-	const args = [
-		`--remote-debugging-port=${profile.cdpPort}`,
-		`--user-data-dir=${userDataDir}`,
-		"--no-first-run",
-		"--no-default-browser-check",
-		"--disable-sync",
-		"--disable-background-networking",
-		"--disable-component-update",
-		"--disable-features=Translate,MediaRouter",
-		"--disable-session-crashed-bubble",
-		"--hide-crash-restore-bubble",
-		"--password-store=basic"
-	];
-	if (headlessMode.headless) {
-		args.push("--headless=new");
-		args.push("--disable-gpu");
-	}
-	if (resolved.noSandbox) args.push("--no-sandbox");
-	if (process.platform === "linux") args.push("--disable-dev-shm-usage");
-	if (!hasChromeProxyControlArg(resolved.extraArgs)) args.push("--no-proxy-server");
-	if (resolved.extraArgs.length > 0) args.push(...resolved.extraArgs);
-	return args;
-}
-async function canOpenWebSocket(url, timeoutMs) {
-	return new Promise((resolve) => {
-		const ws = openCdpWebSocket(url, { handshakeTimeoutMs: timeoutMs });
-		let settled = false;
-		const finish = (value) => {
-			if (settled) return;
-			settled = true;
-			resolve(value);
-		};
-		ws.once("open", () => {
-			try {
-				ws.close();
-			} catch {}
-			finish(true);
-		});
-		ws.once("error", () => finish(false));
-		ws.once("close", () => finish(false));
-	});
-}
-async function isChromeReachable(cdpUrl, timeoutMs = 500, ssrfPolicy) {
-	try {
-		await assertCdpEndpointAllowed(cdpUrl, ssrfPolicy);
-		if (isDirectCdpWebSocketEndpoint(cdpUrl)) return await canOpenWebSocket(cdpUrl, timeoutMs);
-		if (await fetchChromeVersion(isWebSocketUrl(cdpUrl) ? normalizeCdpHttpBaseForJsonEndpoints(cdpUrl) : cdpUrl, timeoutMs, ssrfPolicy)) return true;
-		if (isWebSocketUrl(cdpUrl)) return await canOpenWebSocket(cdpUrl, timeoutMs);
-		return false;
-	} catch {
-		return false;
-	}
-}
-async function fetchChromeVersion(cdpUrl, timeoutMs = 500, ssrfPolicy) {
-	try {
-		return await readChromeVersion(cdpUrl, timeoutMs, ssrfPolicy);
-	} catch {
-		return null;
-	}
-}
-async function getChromeWebSocketUrl(cdpUrl, timeoutMs = 500, ssrfPolicy) {
-	await assertCdpEndpointAllowed(cdpUrl, ssrfPolicy);
-	if (isDirectCdpWebSocketEndpoint(cdpUrl)) return cdpUrl;
-	const discoveryUrl = isWebSocketUrl(cdpUrl) ? normalizeCdpHttpBaseForJsonEndpoints(cdpUrl) : cdpUrl;
-	const wsUrl = normalizeOptionalString((await fetchChromeVersion(discoveryUrl, timeoutMs, ssrfPolicy))?.webSocketDebuggerUrl) ?? "";
-	if (!wsUrl) {
-		if (isWebSocketUrl(cdpUrl)) return cdpUrl;
-		return null;
-	}
-	const normalizedWsUrl = normalizeCdpWsUrl(wsUrl, discoveryUrl);
-	await assertCdpEndpointAllowed(normalizedWsUrl, ssrfPolicy);
-	return normalizedWsUrl;
-}
-async function isChromeCdpReady(cdpUrl, timeoutMs = 500, handshakeTimeoutMs = 800, ssrfPolicy) {
-	const diagnostic = await diagnoseChromeCdp(cdpUrl, timeoutMs, handshakeTimeoutMs, ssrfPolicy);
-	if (!diagnostic.ok) log.debug(formatChromeCdpDiagnostic(diagnostic));
-	return diagnostic.ok;
-}
-async function launchDaoCoreChrome(resolved, profile, launchOptions = {}) {
-	if (!profile.cdpIsLoopback) throw new Error(`Profile "${profile.name}" is remote; cannot launch local Chrome.`);
-	const headlessMode = resolveManagedBrowserHeadlessMode(resolved, profile, launchOptions);
-	const missingDisplayError = getManagedBrowserMissingDisplayError(resolved, profile, launchOptions);
-	if (missingDisplayError) throw new BrowserProfileUnavailableError(missingDisplayError);
-	await ensurePortAvailable(profile.cdpPort);
-	const exe = resolveBrowserExecutable(resolved, profile);
-	if (!exe) throw new Error("No supported browser found (Chrome/Brave/Edge/Chromium on macOS, Linux, or Windows).");
-	const userDataDir = resolveDaoCoreUserDataDir(profile.name);
-	fs.mkdirSync(userDataDir, { recursive: true });
-	await ensureOutputDirectory(DEFAULT_DOWNLOAD_DIR);
-	const needsDecorate = !isProfileDecorated(userDataDir, profile.name, (profile.color ?? "#FF4500").toUpperCase(), DEFAULT_DOWNLOAD_DIR);
-	const spawnOnce = () => {
-		const args = buildDaoCoreChromeLaunchArgs({
-			resolved,
-			profile,
-			userDataDir,
-			...launchOptions
-		});
-		const env = {
-			...omitChromeProxyEnv(process.env),
-			HOME: os.homedir()
-		};
-		if (process.platform === "linux") {
-			const chromiumStateDir = path.join(resolvePreferredDaoCoreTmpDir(), ".chromium");
-			env.XDG_CONFIG_HOME ??= chromiumStateDir;
-			env.XDG_CACHE_HOME ??= chromiumStateDir;
-		}
-		const preparedSpawn = prepareOomScoreAdjustedSpawn(exe.path, args, { env });
-		return spawn(preparedSpawn.command, preparedSpawn.args, {
-			stdio: [
-				"ignore",
-				"ignore",
-				"pipe"
-			],
-			env: preparedSpawn.env
-		});
-	};
-	const startedAt = Date.now();
-	const localStatePath = path.join(userDataDir, "Local State");
-	const preferencesPath = path.join(userDataDir, "Default", "Preferences");
-	if (!exists(localStatePath) || !exists(preferencesPath)) {
-		const bootstrap = spawnOnce();
-		const deadline = Date.now() + CHROME_BOOTSTRAP_PREFS_TIMEOUT_MS;
-		while (Date.now() < deadline) {
-			if (exists(localStatePath) && exists(preferencesPath)) break;
-			await new Promise((r) => setTimeout(r, 100));
-		}
-		try {
-			bootstrap.kill("SIGTERM");
-		} catch {}
-		const exitDeadline = Date.now() + CHROME_BOOTSTRAP_EXIT_TIMEOUT_MS;
-		while (Date.now() < exitDeadline) {
-			if (bootstrap.exitCode != null) break;
-			await new Promise((r) => setTimeout(r, 50));
-		}
-	}
-	if (needsDecorate) try {
-		decorateDaoCoreProfile(userDataDir, {
-			name: profile.name,
-			color: profile.color,
-			downloadDir: DEFAULT_DOWNLOAD_DIR
-		});
-		log.info(`🦞 daocore browser profile decorated (${profile.color})`);
-	} catch (err) {
-		log.warn(`daocore browser profile decoration failed: ${String(err)}`);
-	}
-	try {
-		ensureProfileCleanExit(userDataDir);
-	} catch (err) {
-		log.warn(`daocore browser clean-exit prefs failed: ${String(err)}`);
-	}
-	const launchOnceAndWait = async (allowSingletonRecovery) => {
-		const proc = spawnOnce();
-		const stderrChunks = [];
-		const onStderr = (chunk) => {
-			stderrChunks.push(chunk);
-		};
-		proc.stderr?.on("data", onStderr);
-		try {
-			const readyDeadline = Date.now() + (resolved.localLaunchTimeoutMs ?? CHROME_LAUNCH_READY_WINDOW_MS);
-			let launchHttpReachable = false;
-			while (Date.now() < readyDeadline) {
-				if (await isChromeReachable(profile.cdpUrl)) {
-					launchHttpReachable = true;
-					break;
-				}
-				await new Promise((r) => setTimeout(r, 200));
-			}
-			if (!launchHttpReachable) {
-				let finalDiagnostic = null;
-				let diagnosticErrorText = null;
-				try {
-					finalDiagnostic = await diagnoseChromeCdp(profile.cdpUrl, 500, 800);
-				} catch (err) {
-					diagnosticErrorText = `CDP diagnostic failed: ${safeChromeCdpErrorMessage(err)}.`;
-				}
-				if (diagnosticShowsChromeHttpDiscovery(finalDiagnostic)) launchHttpReachable = true;
-				const diagnosticText = finalDiagnostic ? formatChromeCdpDiagnostic(finalDiagnostic) : diagnosticErrorText ?? "CDP diagnostic failed.";
-				if (launchHttpReachable) log.debug(diagnosticText);
-				else {
-					const stderrOutput = normalizeOptionalString(Buffer.concat(stderrChunks).toString("utf8")) ?? "";
-					const redactedStderrOutput = redactToolPayloadText(stderrOutput);
-					if (allowSingletonRecovery && CHROME_SINGLETON_IN_USE_PATTERN.test(stderrOutput) && clearStaleChromeSingletonLocks(userDataDir)) {
-						log.warn(`Removed stale Chromium Singleton* locks for profile "${profile.name}" and retrying launch.`);
-						await terminateChromeForRetry(proc, userDataDir);
-						return await launchOnceAndWait(false);
-					}
-					const stderrHint = redactedStderrOutput ? `\nChrome stderr:\n${redactedStderrOutput.slice(0, CHROME_STDERR_HINT_MAX_CHARS)}` : "";
-					const launchHints = chromeLaunchHints({
-						stderrOutput,
-						resolved,
-						profile,
-						launchOptions
-					});
-					try {
-						proc.kill("SIGKILL");
-					} catch {}
-					throw new Error(`Failed to start Chrome CDP on port ${profile.cdpPort} for profile "${profile.name}". ${diagnosticText}${launchHints}${stderrHint}`);
-				}
-			}
-			const pid = proc.pid ?? -1;
-			log.info(`🦞 daocore browser started (${exe.kind}) profile "${profile.name}" on 127.0.0.1:${profile.cdpPort} (pid ${pid})`);
-			return {
-				pid,
-				exe,
-				userDataDir,
-				cdpPort: profile.cdpPort,
-				startedAt,
-				proc,
-				headless: headlessMode.headless,
-				headlessSource: headlessMode.source
-			};
-		} finally {
-			proc.stderr?.off("data", onStderr);
-			stderrChunks.length = 0;
-		}
-	};
-	return await launchOnceAndWait(true);
-}
-async function stopDaoCoreChrome(running, timeoutMs = CHROME_STOP_TIMEOUT_MS) {
-	const proc = running.proc;
-	if (proc.killed) return;
-	try {
-		proc.kill("SIGTERM");
-	} catch {}
-	const start = Date.now();
-	while (Date.now() - start < timeoutMs) {
-		if (!proc.exitCode && proc.killed) break;
-		if (!await isChromeReachable(cdpUrlForPort(running.cdpPort), 200)) return;
-		const remainingMs = timeoutMs - (Date.now() - start);
-		await new Promise((r) => setTimeout(r, Math.max(1, Math.min(100, remainingMs))));
-	}
-	try {
-		proc.kill("SIGKILL");
-	} catch {}
-}
-//#endregion
-export { assertBrowserNavigationRedirectChainAllowed as C, withBrowserNavigationPolicy as E, assertBrowserNavigationAllowed as S, requiresInspectableBrowserNavigationRedirectsForUrl as T, INTERACTIVE_ROLES as _, resolveDaoCoreUserDataDir as a, resolveBrowserNavigationProxyMode as b, formatChromeCdpDiagnostic as c, createTargetViaCdp as d, formatAriaSnapshot as f, CONTENT_ROLES as g, snapshotRoleViaCdp as h, launchDaoCoreChrome as i, AX_REF_PATTERN as l, snapshotAria as m, isChromeCdpReady as n, stopDaoCoreChrome as o, normalizeCdpWsUrl as p, isChromeReachable as r, diagnoseChromeCdp as s, getChromeWebSocketUrl as t, captureScreenshot as u, STRUCTURAL_ROLES as v, assertBrowserNavigationResultAllowed as w, InvalidBrowserNavigationUrlError as x, ensureOutputDirectory as y };