@gaodefa/daocore 2026.5.101 → 2026.5.102

package/dist/browser-cli-debug-Ba_ddwvw.js

@@ -0,0 +1,137 @@
+import { c as normalizeOptionalString } from "./string-coerce-DyL154ka.js";
+import { g as shortenHomePath } from "./utils-CNnMhEDp.js";
+import { n as defaultRuntime } from "./runtime-E_A14BX_.js";
+import { t as danger } from "./globals-Csu8e9gS.js";
+import "./string-coerce-runtime-DcopKqDR.js";
+import { n as runCommandWithRuntime } from "./cli-utils-5bbQO4sp.js";
+import "./core-api-C-jlSSBX.js";
+import "./core-api-BJoUc8W9.js";
+import { t as callBrowserRequest } from "./browser-cli-shared-DltASGwj.js";
+//#region extensions/browser/src/cli/browser-cli-debug.ts
+const BROWSER_DEBUG_TIMEOUT_MS = 2e4;
+function runBrowserDebug(action) {
+	return runCommandWithRuntime(defaultRuntime, action, (err) => {
+		defaultRuntime.error(danger(String(err)));
+		defaultRuntime.exit(1);
+	});
+}
+async function withDebugContext(cmd, parentOpts, action) {
+	const parent = parentOpts(cmd);
+	await runBrowserDebug(() => action({
+		parent,
+		profile: parent.browserProfile
+	}));
+}
+function printJsonResult(parent, result) {
+	if (!parent.json) return false;
+	defaultRuntime.writeJson(result);
+	return true;
+}
+async function callDebugRequest(parent, params) {
+	return callBrowserRequest(parent, params, { timeoutMs: BROWSER_DEBUG_TIMEOUT_MS });
+}
+function resolveProfileQuery(profile) {
+	return profile ? { profile } : void 0;
+}
+function resolveDebugQuery(params) {
+	return {
+		targetId: normalizeOptionalString(params.targetId),
+		filter: normalizeOptionalString(params.filter),
+		clear: Boolean(params.clear),
+		profile: params.profile
+	};
+}
+function registerBrowserDebugCommands(browser, parentOpts) {
+	browser.command("highlight").description("Highlight an element by ref").argument("<ref>", "Ref id from snapshot").option("--target-id <id>", "CDP target id (or unique prefix)").action(async (ref, opts, cmd) => {
+		await withDebugContext(cmd, parentOpts, async ({ parent, profile }) => {
+			if (printJsonResult(parent, await callDebugRequest(parent, {
+				method: "POST",
+				path: "/highlight",
+				query: resolveProfileQuery(profile),
+				body: {
+					ref: ref.trim(),
+					targetId: normalizeOptionalString(opts.targetId)
+				}
+			}))) return;
+			defaultRuntime.log(`highlighted ${ref.trim()}`);
+		});
+	});
+	browser.command("errors").description("Get recent page errors").option("--clear", "Clear stored errors after reading", false).option("--target-id <id>", "CDP target id (or unique prefix)").action(async (opts, cmd) => {
+		await withDebugContext(cmd, parentOpts, async ({ parent, profile }) => {
+			const result = await callDebugRequest(parent, {
+				method: "GET",
+				path: "/errors",
+				query: resolveDebugQuery({
+					targetId: opts.targetId,
+					clear: opts.clear,
+					profile
+				})
+			});
+			if (printJsonResult(parent, result)) return;
+			if (!result.errors.length) {
+				defaultRuntime.log("No page errors.");
+				return;
+			}
+			defaultRuntime.log(result.errors.map((e) => `${e.timestamp} ${e.name ? `${e.name}: ` : ""}${e.message}`).join("\n"));
+		});
+	});
+	browser.command("requests").description("Get recent network requests (best-effort)").option("--filter <text>", "Only show URLs that contain this substring").option("--clear", "Clear stored requests after reading", false).option("--target-id <id>", "CDP target id (or unique prefix)").action(async (opts, cmd) => {
+		await withDebugContext(cmd, parentOpts, async ({ parent, profile }) => {
+			const result = await callDebugRequest(parent, {
+				method: "GET",
+				path: "/requests",
+				query: resolveDebugQuery({
+					targetId: opts.targetId,
+					filter: opts.filter,
+					clear: opts.clear,
+					profile
+				})
+			});
+			if (printJsonResult(parent, result)) return;
+			if (!result.requests.length) {
+				defaultRuntime.log("No requests recorded.");
+				return;
+			}
+			defaultRuntime.log(result.requests.map((r) => {
+				const status = typeof r.status === "number" ? ` ${r.status}` : "";
+				const ok = r.ok === true ? " ok" : r.ok === false ? " fail" : "";
+				const fail = r.failureText ? ` (${r.failureText})` : "";
+				return `${r.timestamp} ${r.method}${status}${ok} ${r.url}${fail}`;
+			}).join("\n"));
+		});
+	});
+	const trace = browser.command("trace").description("Record a Playwright trace");
+	trace.command("start").description("Start trace recording").option("--target-id <id>", "CDP target id (or unique prefix)").option("--no-screenshots", "Disable screenshots").option("--no-snapshots", "Disable snapshots").option("--sources", "Include sources (bigger traces)", false).action(async (opts, cmd) => {
+		await withDebugContext(cmd, parentOpts, async ({ parent, profile }) => {
+			if (printJsonResult(parent, await callDebugRequest(parent, {
+				method: "POST",
+				path: "/trace/start",
+				query: resolveProfileQuery(profile),
+				body: {
+					targetId: normalizeOptionalString(opts.targetId),
+					screenshots: Boolean(opts.screenshots),
+					snapshots: Boolean(opts.snapshots),
+					sources: Boolean(opts.sources)
+				}
+			}))) return;
+			defaultRuntime.log("trace started");
+		});
+	});
+	trace.command("stop").description("Stop trace recording and write a .zip").option("--out <path>", "Output path within daocore temp dir (e.g. trace.zip or /tmp/daocore/trace.zip)").option("--target-id <id>", "CDP target id (or unique prefix)").action(async (opts, cmd) => {
+		await withDebugContext(cmd, parentOpts, async ({ parent, profile }) => {
+			const result = await callDebugRequest(parent, {
+				method: "POST",
+				path: "/trace/stop",
+				query: resolveProfileQuery(profile),
+				body: {
+					targetId: normalizeOptionalString(opts.targetId),
+					path: normalizeOptionalString(opts.out)
+				}
+			});
+			if (printJsonResult(parent, result)) return;
+			defaultRuntime.log(`TRACE:${shortenHomePath(result.path)}`);
+		});
+	});
+}
+//#endregion
+export { registerBrowserDebugCommands };

package/dist/browser-cli-inspect-De_6PQUT.js

@@ -0,0 +1,104 @@
+import { c as normalizeOptionalString } from "./string-coerce-DyL154ka.js";
+import { g as shortenHomePath } from "./utils-CNnMhEDp.js";
+import { n as defaultRuntime } from "./runtime-E_A14BX_.js";
+import { t as danger } from "./globals-Csu8e9gS.js";
+import { i as getRuntimeConfig } from "./io-DT0v1_Se.js";
+import "./string-coerce-runtime-DcopKqDR.js";
+import "./core-api-BJoUc8W9.js";
+import { t as callBrowserRequest } from "./browser-cli-shared-DltASGwj.js";
+import fs from "node:fs/promises";
+//#region extensions/browser/src/cli/browser-cli-inspect.ts
+function registerBrowserInspectCommands(browser, parentOpts) {
+	browser.command("screenshot").description("Capture a screenshot (MEDIA:<path>)").argument("[targetId]", "CDP target id (or unique prefix)").option("--full-page", "Capture full scrollable page", false).option("--ref <ref>", "ARIA ref from ai snapshot").option("--element <selector>", "CSS selector for element screenshot").option("--labels", "Overlay role refs on the screenshot", false).option("--type <png|jpeg>", "Output type (default: png)", "png").action(async (targetId, opts, cmd) => {
+		const parent = parentOpts(cmd);
+		const profile = parent?.browserProfile;
+		try {
+			const result = await callBrowserRequest(parent, {
+				method: "POST",
+				path: "/screenshot",
+				query: profile ? { profile } : void 0,
+				body: {
+					targetId: normalizeOptionalString(targetId),
+					fullPage: Boolean(opts.fullPage),
+					ref: normalizeOptionalString(opts.ref),
+					element: normalizeOptionalString(opts.element),
+					labels: Boolean(opts.labels),
+					type: opts.type === "jpeg" ? "jpeg" : "png"
+				}
+			}, { timeoutMs: 2e4 });
+			if (parent?.json) {
+				defaultRuntime.writeJson(result);
+				return;
+			}
+			defaultRuntime.log(`MEDIA:${shortenHomePath(result.path)}`);
+		} catch (err) {
+			defaultRuntime.error(danger(String(err)));
+			defaultRuntime.exit(1);
+		}
+	});
+	browser.command("snapshot").description("Capture a snapshot (default: ai; aria is the accessibility tree)").option("--format <aria|ai>", "Snapshot format (default: ai)", "ai").option("--target-id <id>", "CDP target id (or unique prefix)").option("--limit <n>", "Max nodes (default: 500/800)", (v) => Number(v)).option("--mode <efficient>", "Snapshot preset (efficient)").option("--efficient", "Use the efficient snapshot preset", false).option("--interactive", "Role snapshot: interactive elements only", false).option("--compact", "Role snapshot: compact output", false).option("--depth <n>", "Role snapshot: max depth", (v) => Number(v)).option("--selector <sel>", "Role snapshot: scope to CSS selector").option("--frame <sel>", "Role snapshot: scope to an iframe selector").option("--labels", "Include viewport label overlay screenshot", false).option("--urls", "Append discovered link URLs to AI snapshots", false).option("--out <path>", "Write snapshot to a file").action(async (opts, cmd) => {
+		const parent = parentOpts(cmd);
+		const profile = parent?.browserProfile;
+		const format = opts.format === "aria" ? "aria" : "ai";
+		const configMode = !(typeof cmd.getOptionValueSource === "function" && cmd.getOptionValueSource("format") === "cli") && format === "ai" && getRuntimeConfig().browser?.snapshotDefaults?.mode === "efficient" ? "efficient" : void 0;
+		const mode = opts.efficient === true || opts.mode === "efficient" ? "efficient" : configMode;
+		try {
+			const result = await callBrowserRequest(parent, {
+				method: "GET",
+				path: "/snapshot",
+				query: {
+					format,
+					targetId: normalizeOptionalString(opts.targetId),
+					limit: Number.isFinite(opts.limit) ? opts.limit : void 0,
+					interactive: opts.interactive ? true : void 0,
+					compact: opts.compact ? true : void 0,
+					depth: Number.isFinite(opts.depth) ? opts.depth : void 0,
+					selector: normalizeOptionalString(opts.selector),
+					frame: normalizeOptionalString(opts.frame),
+					labels: opts.labels ? true : void 0,
+					urls: opts.urls ? true : void 0,
+					mode,
+					profile
+				}
+			}, { timeoutMs: 2e4 });
+			if (opts.out) {
+				if (result.format === "ai") await fs.writeFile(opts.out, result.snapshot, "utf8");
+				else {
+					const payload = JSON.stringify(result, null, 2);
+					await fs.writeFile(opts.out, payload, "utf8");
+				}
+				if (parent?.json) defaultRuntime.writeJson({
+					ok: true,
+					out: opts.out,
+					...result.format === "ai" && result.imagePath ? { imagePath: result.imagePath } : {}
+				});
+				else {
+					defaultRuntime.log(shortenHomePath(opts.out));
+					if (result.format === "ai" && result.imagePath) defaultRuntime.log(`MEDIA:${shortenHomePath(result.imagePath)}`);
+				}
+				return;
+			}
+			if (parent?.json) {
+				defaultRuntime.writeJson(result);
+				return;
+			}
+			if (result.format === "ai") {
+				defaultRuntime.log(result.snapshot);
+				if (result.imagePath) defaultRuntime.log(`MEDIA:${shortenHomePath(result.imagePath)}`);
+				return;
+			}
+			const nodes = "nodes" in result ? result.nodes : [];
+			defaultRuntime.log(nodes.map((n) => {
+				const indent = "  ".repeat(Math.min(20, n.depth));
+				const name = n.name ? ` "${n.name}"` : "";
+				const value = n.value ? ` = "${n.value}"` : "";
+				return `${indent}- ${n.role}${name}${value}`;
+			}).join("\n"));
+		} catch (err) {
+			defaultRuntime.error(danger(String(err)));
+			defaultRuntime.exit(1);
+		}
+	});
+}
+//#endregion
+export { registerBrowserInspectCommands };

package/dist/browser-cli-manage-CxlFHkIc.js

@@ -0,0 +1,443 @@
+import { g as shortenHomePath } from "./utils-CNnMhEDp.js";
+import { n as defaultRuntime } from "./runtime-E_A14BX_.js";
+import { n as info, t as danger } from "./globals-Csu8e9gS.js";
+import { n as runCommandWithRuntime } from "./cli-utils-5bbQO4sp.js";
+import { f as redactCdpUrl } from "./cdp.helpers-BZtB_ONj.js";
+import "./core-api-C-jlSSBX.js";
+import "./core-api-BJoUc8W9.js";
+import { t as callBrowserRequest } from "./browser-cli-shared-DltASGwj.js";
+//#region extensions/browser/src/cli/browser-cli-manage.ts
+const BROWSER_MANAGE_REQUEST_TIMEOUT_MS = 45e3;
+function resolveProfileQuery(profile, extra) {
+	const query = {};
+	if (profile) query.profile = profile;
+	if (extra) Object.assign(query, extra);
+	return Object.keys(query).length > 0 ? query : void 0;
+}
+function printJsonResult(parent, payload) {
+	if (!parent?.json) return false;
+	defaultRuntime.writeJson(payload);
+	return true;
+}
+async function callTabAction(parent, profile, body) {
+	return callBrowserRequest(parent, {
+		method: "POST",
+		path: "/tabs/action",
+		query: resolveProfileQuery(profile),
+		body
+	}, { timeoutMs: BROWSER_MANAGE_REQUEST_TIMEOUT_MS });
+}
+async function fetchBrowserStatus(parent, profile) {
+	return await callBrowserRequest(parent, {
+		method: "GET",
+		path: "/",
+		query: resolveProfileQuery(profile)
+	}, { timeoutMs: BROWSER_MANAGE_REQUEST_TIMEOUT_MS });
+}
+async function runBrowserToggle(parent, params) {
+	await callBrowserRequest(parent, {
+		method: "POST",
+		path: params.path,
+		query: resolveProfileQuery(params.profile, params.query)
+	});
+	const status = await fetchBrowserStatus(parent, params.profile);
+	if (printJsonResult(parent, status)) return;
+	const name = status.profile ?? "daocore";
+	const headlessLabel = params.path === "/start" && status.headless ? " (headless)" : "";
+	defaultRuntime.log(info(`🦞 browser [${name}] running: ${status.running}${headlessLabel}`));
+}
+function runBrowserCommand(action) {
+	return runCommandWithRuntime(defaultRuntime, action, (err) => {
+		defaultRuntime.error(danger(String(err)));
+		defaultRuntime.exit(1);
+	});
+}
+function logBrowserTabs(tabs, json) {
+	if (json) {
+		defaultRuntime.writeJson({ tabs });
+		return;
+	}
+	if (tabs.length === 0) {
+		defaultRuntime.log("No tabs (browser closed or no targets).");
+		return;
+	}
+	defaultRuntime.log(tabs.map((t, i) => {
+		const alias = [t.tabId, t.label ? `label:${t.label}` : void 0].filter(Boolean).join(" ");
+		return `${i + 1}. ${t.title || "(untitled)"}${alias ? ` [${alias}]` : ""}\n   ${t.url}\n   id: ${t.targetId}`;
+	}).join("\n"));
+}
+function formatDoctorLine(check) {
+	return `${check.ok ? "OK" : "FAIL"} ${check.name}${check.detail ? `: ${check.detail}` : ""}`;
+}
+async function runBrowserDoctor(parent, profile, deep) {
+	const checks = [];
+	let status = null;
+	try {
+		status = await fetchBrowserStatus(parent, profile);
+		checks.push({
+			name: "gateway",
+			ok: true,
+			detail: "browser control endpoint reachable"
+		});
+	} catch (err) {
+		checks.push({
+			name: "gateway",
+			ok: false,
+			detail: String(err)
+		});
+		return {
+			ok: false,
+			checks
+		};
+	}
+	checks.push({
+		name: "plugin",
+		ok: status.enabled,
+		detail: status.enabled ? "enabled" : "disabled in config"
+	});
+	checks.push({
+		name: "profile",
+		ok: true,
+		detail: `${status.profile ?? "daocore"} (${usesChromeMcpTransport(status) ? "chrome-mcp" : status.transport ?? "cdp"})`
+	});
+	checks.push({
+		name: "browser",
+		ok: status.running,
+		detail: status.running ? `running${status.cdpReady === false ? ", CDP not ready" : ""}` : "not running; run `daocore browser start`"
+	});
+	try {
+		const profiles = await callBrowserRequest(parent, {
+			method: "GET",
+			path: "/profiles"
+		}, { timeoutMs: BROWSER_MANAGE_REQUEST_TIMEOUT_MS });
+		checks.push({
+			name: "profiles",
+			ok: true,
+			detail: `${profiles.profiles?.length ?? 0} configured`
+		});
+	} catch (err) {
+		checks.push({
+			name: "profiles",
+			ok: false,
+			detail: String(err)
+		});
+	}
+	if (status.running) try {
+		const tabs = (await callBrowserRequest(parent, {
+			method: "GET",
+			path: "/tabs",
+			query: resolveProfileQuery(profile)
+		}, { timeoutMs: BROWSER_MANAGE_REQUEST_TIMEOUT_MS })).tabs ?? [];
+		checks.push({
+			name: "tabs",
+			ok: true,
+			detail: `${tabs.length} visible${tabs.length > 0 && tabs[0]?.suggestedTargetId ? `, use target ${tabs[0].suggestedTargetId}` : ""}`
+		});
+	} catch (err) {
+		checks.push({
+			name: "tabs",
+			ok: false,
+			detail: String(err)
+		});
+	}
+	if (deep && status.running) try {
+		const result = await callBrowserRequest(parent, {
+			method: "GET",
+			path: "/snapshot",
+			query: resolveProfileQuery(profile, {
+				format: "aria",
+				limit: 25
+			})
+		}, { timeoutMs: 1e4 });
+		const count = result.format === "aria" ? Array.isArray(result.nodes) ? result.nodes.length : 0 : typeof result.snapshot === "string" ? result.snapshot.split("\n").length : 0;
+		checks.push({
+			name: "live-snapshot",
+			ok: count > 0,
+			detail: count > 0 ? `${count} nodes/lines` : "snapshot returned no content"
+		});
+	} catch (err) {
+		checks.push({
+			name: "live-snapshot",
+			ok: false,
+			detail: String(err)
+		});
+	}
+	return {
+		ok: checks.every((check) => check.ok),
+		checks,
+		status
+	};
+}
+function usesChromeMcpTransport(params) {
+	return params.transport === "chrome-mcp" || params.driver === "existing-session";
+}
+function formatBrowserConnectionSummary(params) {
+	if (usesChromeMcpTransport(params)) {
+		const userDataDir = params.userDataDir ? shortenHomePath(params.userDataDir) : null;
+		return userDataDir ? `transport: chrome-mcp, userDataDir: ${userDataDir}` : "transport: chrome-mcp";
+	}
+	if (params.isRemote) return `cdpUrl: ${params.cdpUrl ?? "(unset)"}`;
+	return `port: ${params.cdpPort ?? "(unset)"}`;
+}
+function registerBrowserManageCommands(browser, parentOpts) {
+	browser.command("status").description("Show browser status").action(async (_opts, cmd) => {
+		const parent = parentOpts(cmd);
+		await runBrowserCommand(async () => {
+			const status = await fetchBrowserStatus(parent, parent?.browserProfile);
+			if (printJsonResult(parent, status)) return;
+			const detectedPath = status.detectedExecutablePath ?? status.executablePath;
+			const detectedDisplay = detectedPath ? shortenHomePath(detectedPath) : "auto";
+			defaultRuntime.log([
+				`profile: ${status.profile ?? "daocore"}`,
+				`enabled: ${status.enabled}`,
+				`running: ${status.running}`,
+				`transport: ${usesChromeMcpTransport(status) ? "chrome-mcp" : status.transport ?? "cdp"}`,
+				...!usesChromeMcpTransport(status) ? [`cdpPort: ${status.cdpPort ?? "(unset)"}`, `cdpUrl: ${redactCdpUrl(status.cdpUrl ?? `http://127.0.0.1:${status.cdpPort}`)}`] : status.userDataDir ? [`userDataDir: ${shortenHomePath(status.userDataDir)}`] : [],
+				`browser: ${status.chosenBrowser ?? "unknown"}`,
+				`detectedBrowser: ${status.detectedBrowser ?? "unknown"}`,
+				`detectedPath: ${detectedDisplay}`,
+				`headless: ${status.headless}${status.headlessSource ? ` (${status.headlessSource})` : ""}`,
+				`profileColor: ${status.color}`,
+				...status.detectError ? [`detectError: ${status.detectError}`] : []
+			].join("\n"));
+		});
+	});
+	browser.command("doctor").description("Check browser plugin readiness").option("--deep", "Run a live snapshot probe").action(async (opts, cmd) => {
+		const parent = parentOpts(cmd);
+		const profile = parent?.browserProfile;
+		await runBrowserCommand(async () => {
+			const result = await runBrowserDoctor(parent, profile, opts.deep === true);
+			if (printJsonResult(parent, result)) return;
+			defaultRuntime.log(result.checks.map(formatDoctorLine).join("\n"));
+			if (!result.ok) defaultRuntime.exit(1);
+		});
+	});
+	browser.command("start").description("Start the browser (no-op if already running)").option("--headless", "Launch a local managed browser headless for this start").action(async (opts, cmd) => {
+		const parent = parentOpts(cmd);
+		const profile = parent?.browserProfile;
+		await runBrowserCommand(async () => {
+			await runBrowserToggle(parent, {
+				profile,
+				path: "/start",
+				query: opts.headless ? { headless: true } : void 0
+			});
+		});
+	});
+	browser.command("stop").description("Stop the browser (best-effort)").action(async (_opts, cmd) => {
+		const parent = parentOpts(cmd);
+		const profile = parent?.browserProfile;
+		await runBrowserCommand(async () => {
+			await runBrowserToggle(parent, {
+				profile,
+				path: "/stop"
+			});
+		});
+	});
+	browser.command("reset-profile").description("Reset browser profile (moves it to Trash)").action(async (_opts, cmd) => {
+		const parent = parentOpts(cmd);
+		const profile = parent?.browserProfile;
+		await runBrowserCommand(async () => {
+			const result = await callBrowserRequest(parent, {
+				method: "POST",
+				path: "/reset-profile",
+				query: resolveProfileQuery(profile)
+			}, { timeoutMs: 2e4 });
+			if (printJsonResult(parent, result)) return;
+			if (!result.moved) {
+				defaultRuntime.log(info(`🦞 browser profile already missing.`));
+				return;
+			}
+			const dest = result.to ?? result.from;
+			defaultRuntime.log(info(`🦞 browser profile moved to Trash (${dest})`));
+		});
+	});
+	browser.command("tabs").description("List open tabs").action(async (_opts, cmd) => {
+		const parent = parentOpts(cmd);
+		const profile = parent?.browserProfile;
+		await runBrowserCommand(async () => {
+			logBrowserTabs((await callBrowserRequest(parent, {
+				method: "GET",
+				path: "/tabs",
+				query: resolveProfileQuery(profile)
+			}, { timeoutMs: BROWSER_MANAGE_REQUEST_TIMEOUT_MS })).tabs ?? [], parent?.json);
+		});
+	});
+	const tab = browser.command("tab").description("Tab shortcuts (index-based)").action(async (_opts, cmd) => {
+		const parent = parentOpts(cmd);
+		const profile = parent?.browserProfile;
+		await runBrowserCommand(async () => {
+			logBrowserTabs((await callBrowserRequest(parent, {
+				method: "POST",
+				path: "/tabs/action",
+				query: resolveProfileQuery(profile),
+				body: { action: "list" }
+			}, { timeoutMs: BROWSER_MANAGE_REQUEST_TIMEOUT_MS })).tabs ?? [], parent?.json);
+		});
+	});
+	tab.command("new").description("Open a new tab (about:blank)").option("--label <label>", "Assign a friendly tab label").action(async (opts, cmd) => {
+		const parent = parentOpts(cmd);
+		const profile = parent?.browserProfile;
+		await runBrowserCommand(async () => {
+			const result = await callTabAction(parent, profile, {
+				action: "new",
+				label: opts.label
+			});
+			if (printJsonResult(parent, result)) return;
+			const opened = result.tab;
+			defaultRuntime.log(opened?.tabId ? `opened new tab ${opened.tabId}${opened.label ? ` (${opened.label})` : ""}` : "opened new tab");
+		});
+	});
+	tab.command("label").description("Assign a friendly label to a tab").argument("<targetId>", "Target id, tab id, label, or unique target id prefix").argument("<label>", "Friendly label").action(async (targetId, label, _opts, cmd) => {
+		const parent = parentOpts(cmd);
+		const profile = parent?.browserProfile;
+		await runBrowserCommand(async () => {
+			const result = await callTabAction(parent, profile, {
+				action: "label",
+				targetId,
+				label
+			});
+			if (printJsonResult(parent, result)) return;
+			const tab = result.tab;
+			defaultRuntime.log(`labeled tab ${tab?.tabId ?? targetId} as ${tab?.label ?? label}`);
+		});
+	});
+	tab.command("select").description("Focus tab by index (1-based)").argument("<index>", "Tab index (1-based)", (v) => Number(v)).action(async (index, _opts, cmd) => {
+		const parent = parentOpts(cmd);
+		const profile = parent?.browserProfile;
+		if (!Number.isFinite(index) || index < 1) {
+			defaultRuntime.error(danger("index must be a positive number"));
+			defaultRuntime.exit(1);
+			return;
+		}
+		await runBrowserCommand(async () => {
+			if (printJsonResult(parent, await callTabAction(parent, profile, {
+				action: "select",
+				index: Math.floor(index) - 1
+			}))) return;
+			defaultRuntime.log(`selected tab ${Math.floor(index)}`);
+		});
+	});
+	tab.command("close").description("Close tab by index (1-based); default: first tab").argument("[index]", "Tab index (1-based)", (v) => Number(v)).action(async (index, _opts, cmd) => {
+		const parent = parentOpts(cmd);
+		const profile = parent?.browserProfile;
+		const idx = typeof index === "number" && Number.isFinite(index) ? Math.floor(index) - 1 : void 0;
+		if (typeof idx === "number" && idx < 0) {
+			defaultRuntime.error(danger("index must be >= 1"));
+			defaultRuntime.exit(1);
+			return;
+		}
+		await runBrowserCommand(async () => {
+			if (printJsonResult(parent, await callTabAction(parent, profile, {
+				action: "close",
+				index: idx
+			}))) return;
+			defaultRuntime.log("closed tab");
+		});
+	});
+	browser.command("open").description("Open a URL in a new tab").argument("<url>", "URL to open").option("--label <label>", "Assign a friendly tab label").action(async (url, opts, cmd) => {
+		const parent = parentOpts(cmd);
+		const profile = parent?.browserProfile;
+		await runBrowserCommand(async () => {
+			const tab = await callBrowserRequest(parent, {
+				method: "POST",
+				path: "/tabs/open",
+				query: resolveProfileQuery(profile),
+				body: {
+					url,
+					...opts.label ? { label: opts.label } : {}
+				}
+			}, { timeoutMs: BROWSER_MANAGE_REQUEST_TIMEOUT_MS });
+			if (printJsonResult(parent, tab)) return;
+			defaultRuntime.log(`opened: ${tab.url}\n${tab.tabId ? `tab: ${tab.tabId}\n` : ""}${tab.label ? `label: ${tab.label}\n` : ""}id: ${tab.targetId}`);
+		});
+	});
+	browser.command("focus").description("Focus a tab by target id, tab id, label, or unique target id prefix").argument("<targetId>", "Target id, tab id, label, or unique target id prefix").action(async (targetId, _opts, cmd) => {
+		const parent = parentOpts(cmd);
+		const profile = parent?.browserProfile;
+		await runBrowserCommand(async () => {
+			await callBrowserRequest(parent, {
+				method: "POST",
+				path: "/tabs/focus",
+				query: resolveProfileQuery(profile),
+				body: { targetId }
+			}, { timeoutMs: BROWSER_MANAGE_REQUEST_TIMEOUT_MS });
+			if (printJsonResult(parent, { ok: true })) return;
+			defaultRuntime.log(`focused tab ${targetId}`);
+		});
+	});
+	browser.command("close").description("Close a tab (target id optional)").argument("[targetId]", "Target id, tab id, label, or unique target id prefix (optional)").action(async (targetId, _opts, cmd) => {
+		const parent = parentOpts(cmd);
+		const profile = parent?.browserProfile;
+		await runBrowserCommand(async () => {
+			if (targetId?.trim()) await callBrowserRequest(parent, {
+				method: "DELETE",
+				path: `/tabs/${encodeURIComponent(targetId.trim())}`,
+				query: resolveProfileQuery(profile)
+			}, { timeoutMs: BROWSER_MANAGE_REQUEST_TIMEOUT_MS });
+			else await callBrowserRequest(parent, {
+				method: "POST",
+				path: "/act",
+				query: resolveProfileQuery(profile),
+				body: { kind: "close" }
+			}, { timeoutMs: BROWSER_MANAGE_REQUEST_TIMEOUT_MS });
+			if (printJsonResult(parent, { ok: true })) return;
+			defaultRuntime.log("closed tab");
+		});
+	});
+	browser.command("profiles").description("List all browser profiles").action(async (_opts, cmd) => {
+		const parent = parentOpts(cmd);
+		await runBrowserCommand(async () => {
+			const profiles = (await callBrowserRequest(parent, {
+				method: "GET",
+				path: "/profiles"
+			}, { timeoutMs: BROWSER_MANAGE_REQUEST_TIMEOUT_MS })).profiles ?? [];
+			if (printJsonResult(parent, { profiles })) return;
+			if (profiles.length === 0) {
+				defaultRuntime.log("No profiles configured.");
+				return;
+			}
+			defaultRuntime.log(profiles.map((p) => {
+				const status = p.running ? "running" : "stopped";
+				const tabs = p.running ? ` (${p.tabCount} tabs)` : "";
+				const def = p.isDefault ? " [default]" : "";
+				const loc = formatBrowserConnectionSummary(p);
+				const remote = p.isRemote ? " [remote]" : "";
+				const driver = p.driver !== "daocore" ? ` [${p.driver}]` : "";
+				return `${p.name}: ${status}${tabs}${def}${remote}${driver}\n  ${loc}, color: ${p.color}`;
+			}).join("\n"));
+		});
+	});
+	browser.command("create-profile").description("Create a new browser profile").requiredOption("--name <name>", "Profile name (lowercase, numbers, hyphens)").option("--color <hex>", "Profile color (hex format, e.g. #0066CC)").option("--cdp-url <url>", "CDP URL for remote Chrome (http/https)").option("--user-data-dir <path>", "User data dir for existing-session Chromium attach").option("--driver <driver>", "Profile driver (daocore|existing-session). Default: daocore").action(async (opts, cmd) => {
+		const parent = parentOpts(cmd);
+		await runBrowserCommand(async () => {
+			const result = await callBrowserRequest(parent, {
+				method: "POST",
+				path: "/profiles/create",
+				body: {
+					name: opts.name,
+					color: opts.color,
+					cdpUrl: opts.cdpUrl,
+					userDataDir: opts.userDataDir,
+					driver: opts.driver === "existing-session" ? "existing-session" : void 0
+				}
+			}, { timeoutMs: 1e4 });
+			if (printJsonResult(parent, result)) return;
+			const loc = `  ${formatBrowserConnectionSummary(result)}`;
+			defaultRuntime.log(info(`🦞 Created profile "${result.profile}"\n${loc}\n  color: ${result.color}${result.userDataDir ? `\n  userDataDir: ${shortenHomePath(result.userDataDir)}` : ""}${opts.driver === "existing-session" ? "\n  driver: existing-session" : ""}`));
+		});
+	});
+	browser.command("delete-profile").description("Delete a browser profile").requiredOption("--name <name>", "Profile name to delete").action(async (opts, cmd) => {
+		const parent = parentOpts(cmd);
+		await runBrowserCommand(async () => {
+			const result = await callBrowserRequest(parent, {
+				method: "DELETE",
+				path: `/profiles/${encodeURIComponent(opts.name)}`
+			}, { timeoutMs: 2e4 });
+			if (printJsonResult(parent, result)) return;
+			const msg = result.deleted ? `🦞 Deleted profile "${result.profile}" (user data removed)` : `🦞 Deleted profile "${result.profile}" (no user data found)`;
+			defaultRuntime.log(info(msg));
+		});
+	});
+}
+//#endregion
+export { registerBrowserManageCommands };