@phi-code-admin/phi-code 0.86.0 → 0.88.0

package/extensions/phi/chrome/index.ts

@@ -1,9 +1,9 @@
-import type { ExtensionAPI, ExtensionContext } from "phi-code";
-import { Type } from "typebox";
 import { existsSync, readFileSync, statSync } from "node:fs";
 import { mkdir, writeFile } from "node:fs/promises";
 import { createServer, type IncomingMessage, type Server, type ServerResponse } from "node:http";
 import { dirname, join, resolve } from "node:path";
+import type { ExtensionAPI, ExtensionContext } from "phi-code";
+import { Type } from "typebox";
 
 /**
  * Existing-profile Chrome bridge for pi.
@@ -77,7 +77,9 @@ function safeJson(value: unknown): string {
 const snapshotModeValues = ["auto", "interactive", "forms", "pageMap", "text", "changes", "full"] as const;
 
 function compactLine(value: unknown, max = 140): string {
-	const text = String(value ?? "").replace(/\s+/g, " ").trim();
+	const text = String(value ?? "")
+		.replace(/\s+/g, " ")
+		.trim();
 	return text.length > max ? `${text.slice(0, max - 1)}…` : text;
 }
 
@@ -93,18 +95,33 @@ function formatChromeSnapshot(snapshot: any): string {
 	lines.push(`# Chrome snapshot${snapshot.mode ? ` (${snapshot.mode})` : ""}`);
 	lines.push(`${snapshot.title || "(untitled)"}`);
 	if (snapshot.url) lines.push(`${snapshot.url}`);
-	if (snapshot.viewport) lines.push(`viewport=${snapshot.viewport.width}x${snapshot.viewport.height} scroll=${snapshot.viewport.scrollX || 0},${snapshot.viewport.scrollY || 0}`);
-	if (snapshot.summary?.modal) lines.push(`modal: ${snapshot.summary.modal.uid} ${compactLine(snapshot.summary.modal.label)}`);
-	if (snapshot.summary?.focused) lines.push(`focused: ${snapshot.summary.focused.uid} ${snapshot.summary.focused.role || ""} ${compactLine(snapshot.summary.focused.label)}`);
+	if (snapshot.viewport)
+		lines.push(
+			`viewport=${snapshot.viewport.width}x${snapshot.viewport.height} scroll=${snapshot.viewport.scrollX || 0},${snapshot.viewport.scrollY || 0}`,
+		);
+	if (snapshot.summary?.modal)
+		lines.push(`modal: ${snapshot.summary.modal.uid} ${compactLine(snapshot.summary.modal.label)}`);
+	if (snapshot.summary?.focused)
+		lines.push(
+			`focused: ${snapshot.summary.focused.uid} ${snapshot.summary.focused.role || ""} ${compactLine(snapshot.summary.focused.label)}`,
+		);
 	if (Array.isArray(snapshot.summary?.hints) && snapshot.summary.hints.length) {
 		lines.push("\n## Hints");
 		for (const hint of snapshot.summary.hints.slice(0, 6)) lines.push(`- ${hint}`);
 	}
 	if (snapshot.diff && !snapshot.diff.firstSnapshot) {
 		const changed = [
-			...(snapshot.diff.changes || []).map((c: any) => c.kind === "textChanged" ? "text changed" : `${c.kind}: ${compactLine(c.before, 50)} → ${compactLine(c.after, 50)}`),
-			...(snapshot.diff.added || []).slice(0, 4).map((e: any) => `added ${e.uid} ${e.role || ""} ${compactLine(e.label)}`),
-			...(snapshot.diff.updated || []).slice(0, 4).map((u: any) => `updated ${u.uid} ${compactLine(u.after?.label || u.before?.label)}`),
+			...(snapshot.diff.changes || []).map((c: any) =>
+				c.kind === "textChanged"
+					? "text changed"
+					: `${c.kind}: ${compactLine(c.before, 50)} → ${compactLine(c.after, 50)}`,
+			),
+			...(snapshot.diff.added || [])
+				.slice(0, 4)
+				.map((e: any) => `added ${e.uid} ${e.role || ""} ${compactLine(e.label)}`),
+			...(snapshot.diff.updated || [])
+				.slice(0, 4)
+				.map((u: any) => `updated ${u.uid} ${compactLine(u.after?.label || u.before?.label)}`),
 		];
 		if (changed.length) {
 			lines.push("\n## Changed since last snapshot");
@@ -114,29 +131,49 @@ function formatChromeSnapshot(snapshot: any): string {
 	if (Array.isArray(snapshot.matches) && snapshot.matches.length) {
 		lines.push(`\n## Matches for "${snapshot.query}"`);
 		for (const match of snapshot.matches.slice(0, 12)) {
-			if (match.kind === "text") lines.push(`- ${match.uid} text ${compactLine(match.text)} @ ${rectText(match.rect)}`);
-			else if (match.kind === "region") lines.push(`- ${match.uid} region ${compactLine(match.label)} headings=${(match.headings || []).map((h: string) => compactLine(h, 50)).join(" | ")}`);
-			else lines.push(`- ${match.uid} ${match.role || match.tag || "element"}${match.disabled ? " disabled" : ""} ${compactLine(match.label || match.selector)} @ ${rectText(match.rect)}`);
+			if (match.kind === "text")
+				lines.push(`- ${match.uid} text ${compactLine(match.text)} @ ${rectText(match.rect)}`);
+			else if (match.kind === "region")
+				lines.push(
+					`- ${match.uid} region ${compactLine(match.label)} headings=${(match.headings || []).map((h: string) => compactLine(h, 50)).join(" | ")}`,
+				);
+			else
+				lines.push(
+					`- ${match.uid} ${match.role || match.tag || "element"}${match.disabled ? " disabled" : ""} ${compactLine(match.label || match.selector)} @ ${rectText(match.rect)}`,
+				);
 		}
 	}
 	if (snapshot.mode === "pageMap" && snapshot.pageMap) {
 		lines.push("\n## Page map");
 		for (const region of (snapshot.pageMap.regions || []).slice(0, 18)) {
 			lines.push(`- ${region.uid} ${region.kind}: ${compactLine(region.label)}`);
-			for (const action of (region.actions || []).slice(0, 5)) lines.push(`  - ${action.uid} ${action.role || ""}${action.disabled ? " disabled" : ""} ${compactLine(action.label)}`);
+			for (const action of (region.actions || []).slice(0, 5))
+				lines.push(
+					`  - ${action.uid} ${action.role || ""}${action.disabled ? " disabled" : ""} ${compactLine(action.label)}`,
+				);
 		}
 		if (snapshot.pageMap.headings?.length) {
 			lines.push("\nHeadings:");
-			for (const h of snapshot.pageMap.headings.slice(0, 20)) lines.push(`- ${h.uid} h${h.level || ""} ${compactLine(h.text)}`);
+			for (const h of snapshot.pageMap.headings.slice(0, 20))
+				lines.push(`- ${h.uid} h${h.level || ""} ${compactLine(h.text)}`);
 		}
 	}
 	if (Array.isArray(snapshot.layout) && snapshot.layout.length && snapshot.mode !== "changes") {
 		lines.push("\n## Layout / context");
 		for (const section of snapshot.layout.slice(0, snapshot.mode === "pageMap" ? 18 : 8)) {
-			const bits = [`${section.uid}`, section.role || section.tag, compactLine(section.label || section.text || "(unnamed section)", 110), `@ ${rectText(section.rect)}`];
+			const bits = [
+				`${section.uid}`,
+				section.role || section.tag,
+				compactLine(section.label || section.text || "(unnamed section)", 110),
+				`@ ${rectText(section.rect)}`,
+			];
 			lines.push(`- ${bits.filter(Boolean).join(" ")}`);
-			const fieldLabels = (section.fields || []).slice(0, 4).map((f: any) => `${f.uid} ${compactLine(f.label || f.role, 40)}`);
-			const actionLabels = (section.actions || []).slice(0, 5).map((a: any) => `${a.uid}${a.disabled ? " disabled" : ""} ${compactLine(a.label || a.role, 40)}`);
+			const fieldLabels = (section.fields || [])
+				.slice(0, 4)
+				.map((f: any) => `${f.uid} ${compactLine(f.label || f.role, 40)}`);
+			const actionLabels = (section.actions || [])
+				.slice(0, 5)
+				.map((a: any) => `${a.uid}${a.disabled ? " disabled" : ""} ${compactLine(a.label || a.role, 40)}`);
 			if (fieldLabels.length) lines.push(`  fields: ${fieldLabels.join("; ")}`);
 			if (actionLabels.length) lines.push(`  actions: ${actionLabels.join("; ")}`);
 		}
@@ -146,28 +183,52 @@ function formatChromeSnapshot(snapshot: any): string {
 		const submits = snapshot.forms?.submits || [];
 		if (fields.length || submits.length) lines.push("\n## Forms");
 		for (const field of fields.slice(0, snapshot.mode === "forms" ? 40 : 12)) {
-			const bits = [field.uid, field.role || field.tag, field.required ? "required" : "", field.invalid ? "invalid" : "", field.disabled ? "disabled" : "", compactLine(field.label || field.selector, 90)];
+			const bits = [
+				field.uid,
+				field.role || field.tag,
+				field.required ? "required" : "",
+				field.invalid ? "invalid" : "",
+				field.disabled ? "disabled" : "",
+				compactLine(field.label || field.selector, 90),
+			];
 			if (field.value) bits.push(`value=${compactLine(field.value, 50)}`);
 			else if (field.valueRedacted) bits.push("value=[redacted]");
 			lines.push(`- ${bits.filter(Boolean).join(" ")} @ ${rectText(field.rect)}`);
 		}
-		for (const submit of submits.slice(0, 8)) lines.push(`- ${submit.uid} submit/action${submit.disabled ? " disabled" : ""} ${compactLine(submit.label || submit.selector)} @ ${rectText(submit.rect)}`);
+		for (const submit of submits.slice(0, 8))
+			lines.push(
+				`- ${submit.uid} submit/action${submit.disabled ? " disabled" : ""} ${compactLine(submit.label || submit.selector)} @ ${rectText(submit.rect)}`,
+			);
 	}
 	if (Array.isArray(snapshot.elements) && snapshot.mode !== "pageMap") {
 		lines.push("\n## Visible actions");
 		for (const el of snapshot.elements.slice(0, snapshot.mode === "interactive" ? 60 : 25)) {
-			const flags = [el.disabled ? "disabled" : "", el.occluded ? `occluded-by-${el.occluded.tag}` : ""].filter(Boolean).join(",");
+			const flags = [el.disabled ? "disabled" : "", el.occluded ? `occluded-by-${el.occluded.tag}` : ""]
+				.filter(Boolean)
+				.join(",");
 			const context = el.context?.label ? ` in ${el.context.uid} ${compactLine(el.context.label, 60)}` : "";
-			lines.push(`- ${el.uid} ${el.role || el.tag}${flags ? ` [${flags}]` : ""} ${compactLine(el.label || el.selector)}${context} @ ${rectText(el.rect)}`);
+			lines.push(
+				`- ${el.uid} ${el.role || el.tag}${flags ? ` [${flags}]` : ""} ${compactLine(el.label || el.selector)}${context} @ ${rectText(el.rect)}`,
+			);
 		}
-		if (snapshot.elements.length > (snapshot.mode === "interactive" ? 60 : 25)) lines.push(`- … ${snapshot.elements.length - (snapshot.mode === "interactive" ? 60 : 25)} more; retry with maxElements or mode=interactive`);
+		if (snapshot.elements.length > (snapshot.mode === "interactive" ? 60 : 25))
+			lines.push(
+				`- … ${snapshot.elements.length - (snapshot.mode === "interactive" ? 60 : 25)} more; retry with maxElements or mode=interactive`,
+			);
 	}
-	if ((snapshot.mode === "text" || snapshot.mode === "auto") && Array.isArray(snapshot.textSnippets) && snapshot.textSnippets.length) {
+	if (
+		(snapshot.mode === "text" || snapshot.mode === "auto") &&
+		Array.isArray(snapshot.textSnippets) &&
+		snapshot.textSnippets.length
+	) {
 		lines.push("\n## Text snippets");
-		for (const snip of snapshot.textSnippets.slice(0, snapshot.mode === "text" ? 40 : 14)) lines.push(`- ${snip.uid} ${compactLine(snip.text, snapshot.mode === "text" ? 240 : 160)}`);
+		for (const snip of snapshot.textSnippets.slice(0, snapshot.mode === "text" ? 40 : 14))
+			lines.push(`- ${snip.uid} ${compactLine(snip.text, snapshot.mode === "text" ? 240 : 160)}`);
 		if (snapshot.textTruncated) lines.push("- … page text truncated; retry with mode=text or maxTextChars for more");
 	}
-	lines.push("\nTip: use chrome_snapshot({query:'...', mode:'interactive|forms|pageMap|text|changes|full'}) or nearUid to zoom in.");
+	lines.push(
+		"\nTip: use chrome_snapshot({query:'...', mode:'interactive|forms|pageMap|text|changes|full'}) or nearUid to zoom in.",
+	);
 	return truncateText(lines.join("\n"));
 }
 
@@ -181,26 +242,41 @@ function formatChromeInspect(inspect: any): string {
 	const t = inspect.target || {};
 	const lines: string[] = [];
 	lines.push(`# Chrome inspect ${t.uid || ""}`.trim());
-	lines.push(`${t.role || t.tag || "element"}${t.disabled ? " disabled" : ""}${t.occluded ? ` occluded-by-${t.occluded.tag}` : ""} ${compactLine(t.label || t.selector)}`);
+	lines.push(
+		`${t.role || t.tag || "element"}${t.disabled ? " disabled" : ""}${t.occluded ? ` occluded-by-${t.occluded.tag}` : ""} ${compactLine(t.label || t.selector)}`,
+	);
 	if (t.selector) lines.push(`selector: ${t.selector}`);
 	if (t.rect) lines.push(`rect: ${rectText(t.rect)}`);
-	if (inspect.clickSuggestion) lines.push(`suggested click: chrome_click({ uid: "${inspect.clickSuggestion.uid}" }) or x=${inspect.clickSuggestion.x}, y=${inspect.clickSuggestion.y}`);
+	if (inspect.clickSuggestion)
+		lines.push(
+			`suggested click: chrome_click({ uid: "${inspect.clickSuggestion.uid}" }) or x=${inspect.clickSuggestion.x}, y=${inspect.clickSuggestion.y}`,
+		);
 	if (Array.isArray(inspect.nearbyText) && inspect.nearbyText.length) {
 		lines.push("\n## Nearby text");
 		for (const item of inspect.nearbyText.slice(0, 12)) lines.push(`- ${item.uid} ${compactLine(item.text, 180)}`);
 	}
 	if (inspect.formContext) {
 		lines.push("\n## Form context");
-		for (const field of (inspect.formContext.fields || []).slice(0, 20)) lines.push(`- ${field.uid} ${field.role || field.tag}${field.disabled ? " disabled" : ""} ${compactLine(field.label || field.selector)}${field.value ? ` value=${compactLine(field.value, 60)}` : field.valueRedacted ? " value=[redacted]" : ""}`);
-		for (const action of (inspect.formContext.actions || []).slice(0, 10)) lines.push(`- ${action.uid} action${action.disabled ? " disabled" : ""} ${compactLine(action.label || action.selector)}`);
+		for (const field of (inspect.formContext.fields || []).slice(0, 20))
+			lines.push(
+				`- ${field.uid} ${field.role || field.tag}${field.disabled ? " disabled" : ""} ${compactLine(field.label || field.selector)}${field.value ? ` value=${compactLine(field.value, 60)}` : field.valueRedacted ? " value=[redacted]" : ""}`,
+			);
+		for (const action of (inspect.formContext.actions || []).slice(0, 10))
+			lines.push(
+				`- ${action.uid} action${action.disabled ? " disabled" : ""} ${compactLine(action.label || action.selector)}`,
+			);
 	}
 	if (Array.isArray(inspect.nearbyActions) && inspect.nearbyActions.length) {
 		lines.push("\n## Nearby actions");
-		for (const action of inspect.nearbyActions.slice(0, 18)) lines.push(`- ${action.uid} ${action.role || action.tag}${action.disabled ? " disabled" : ""} ${compactLine(action.label || action.selector)} @ ${rectText(action.rect)}`);
+		for (const action of inspect.nearbyActions.slice(0, 18))
+			lines.push(
+				`- ${action.uid} ${action.role || action.tag}${action.disabled ? " disabled" : ""} ${compactLine(action.label || action.selector)} @ ${rectText(action.rect)}`,
+			);
 	}
 	if (Array.isArray(inspect.ancestors) && inspect.ancestors.length) {
 		lines.push("\n## Ancestors");
-		for (const a of inspect.ancestors.slice(0, 6)) lines.push(`- ${a.uid} ${a.role || a.tag} ${compactLine(a.label || a.selector, 120)}`);
+		for (const a of inspect.ancestors.slice(0, 6))
+			lines.push(`- ${a.uid} ${a.role || a.tag} ${compactLine(a.label || a.selector, 120)}`);
 	}
 	return truncateText(lines.join("\n"));
 }
@@ -230,7 +306,11 @@ function browserExtensionPath(): string {
 
 function hostnameOf(url: string | undefined): string {
 	if (!url) return "";
-	try { return new URL(url).hostname; } catch { return ""; }
+	try {
+		return new URL(url).hostname;
+	} catch {
+		return "";
+	}
 }
 
 // Description of a click/type/fill result's significant fields so the agent doesn't have to
@@ -243,12 +323,13 @@ function summarizeActionResult(result: unknown): string | undefined {
 	// Many real effects — class/aria/data-state toggles, JS-held state, canvas, async updates —
 	// don't move it, so a false value is NOT proof the action did nothing. Surface it only as a
 	// soft hint, and never present it as a failure on its own.
-	if (r.pageMutated === false) parts.push("no coarse DOM change detected (may still have taken effect — verify with includeSnapshot)");
+	if (r.pageMutated === false)
+		parts.push("no coarse DOM change detected (may still have taken effect — verify with includeSnapshot)");
 	if (r.defaultPrevented === true) parts.push("defaultPrevented=true");
 	if (r.elementVisible === false) parts.push("element NOT visible");
 	if (r.occludedBy) {
 		const o = r.occludedBy as { tag?: string; id?: string };
-		parts.push(`occluded by <${o.tag ?? "?"}${o.id ? "#" + o.id : ""}>`);
+		parts.push(`occluded by <${o.tag ?? "?"}${o.id ? `#${o.id}` : ""}>`);
 	}
 	if (r.valueMatches === false) parts.push("input value did not stick");
 	if (r.autoplayHint) parts.push("autoplay-gated affordance");
@@ -272,7 +353,7 @@ function corsHeadersFor(request: IncomingMessage): Record<string, string> {
 		"access-control-allow-methods": "GET,POST,OPTIONS",
 		"access-control-allow-headers": "content-type",
 		"access-control-expose-headers": "x-pi-chrome-version",
-		"vary": "origin",
+		vary: "origin",
 	};
 }
 
@@ -287,7 +368,12 @@ function isLocalProcessRequest(request: IncomingMessage): boolean {
 	return !request.headers.origin && !request.headers["sec-fetch-site"];
 }
 
-function sendJson(response: ServerResponse, status: number, body: unknown, extraHeaders?: Record<string, string>): void {
+function sendJson(
+	response: ServerResponse,
+	status: number,
+	body: unknown,
+	extraHeaders?: Record<string, string>,
+): void {
 	response.writeHead(status, {
 		"content-type": "application/json; charset=utf-8",
 		"cache-control": "no-store",
@@ -393,12 +479,22 @@ class ChromeProfileBridge {
 		this.mode = undefined;
 	}
 
-	send(action: string, params: Record<string, unknown>, timeoutMs = DEFAULT_TIMEOUT_MS, signal?: AbortSignal): Promise<unknown> {
+	send(
+		action: string,
+		params: Record<string, unknown>,
+		timeoutMs = DEFAULT_TIMEOUT_MS,
+		signal?: AbortSignal,
+	): Promise<unknown> {
 		if (this.mode === "client") return this.sendViaOwner(action, params, timeoutMs, signal);
 		return this.sendLocal(action, params, timeoutMs, signal);
 	}
 
-	private sendLocal(action: string, params: Record<string, unknown>, timeoutMs = DEFAULT_TIMEOUT_MS, signal?: AbortSignal): Promise<unknown> {
+	private sendLocal(
+		action: string,
+		params: Record<string, unknown>,
+		timeoutMs = DEFAULT_TIMEOUT_MS,
+		signal?: AbortSignal,
+	): Promise<unknown> {
 		const id = `${Date.now().toString(36)}-${Math.random().toString(36).slice(2)}`;
 		const command = { id, action, params };
 		return new Promise((resolveCommand, rejectCommand) => {
@@ -425,8 +521,14 @@ class ChromeProfileBridge {
 			}, timeoutMs);
 			this.pending.set(id, {
 				command,
-				resolve: (value) => { cleanupAbort(); resolveCommand(value); },
-				reject: (err) => { cleanupAbort(); rejectCommand(err); },
+				resolve: (value) => {
+					cleanupAbort();
+					resolveCommand(value);
+				},
+				reject: (err) => {
+					cleanupAbort();
+					rejectCommand(err);
+				},
 				timer,
 			});
 			if (signal) signal.addEventListener("abort", onAbort, { once: true });
@@ -444,12 +546,17 @@ class ChromeProfileBridge {
 			return `Timed out after ${timeoutMs}ms: the Chrome extension received the command but never returned a result. The action may be long-running, or the result post failed. Run /chrome doctor; if it persists, reload 'Pi Chrome Connector' at chrome://extensions.`;
 		}
 		if (pollAgeMs === undefined || pollAgeMs > 60_000) {
-			return `Timed out after ${timeoutMs}ms: the Chrome extension is not polling (last seen ${pollAgeMs === undefined ? "never" : Math.round(pollAgeMs / 1000) + "s ago"}). Run /chrome onboard, then load the bundled browser-extension folder in your normal Chrome profile and keep that Chrome window open.`;
+			return `Timed out after ${timeoutMs}ms: the Chrome extension is not polling (last seen ${pollAgeMs === undefined ? "never" : `${Math.round(pollAgeMs / 1000)}s ago`}). Run /chrome onboard, then load the bundled browser-extension folder in your normal Chrome profile and keep that Chrome window open.`;
 		}
 		return `Timed out after ${timeoutMs}ms: the Chrome extension is polling (last seen ${Math.round(pollAgeMs / 1000)}s ago) but did not pick up this command in time. Retry; if it persists, reload 'Pi Chrome Connector' at chrome://extensions.`;
 	}
 
-	private async sendViaOwner(action: string, params: Record<string, unknown>, timeoutMs: number, signal?: AbortSignal): Promise<unknown> {
+	private async sendViaOwner(
+		action: string,
+		params: Record<string, unknown>,
+		timeoutMs: number,
+		signal?: AbortSignal,
+	): Promise<unknown> {
 		const controller = new AbortController();
 		const timer = setTimeout(() => controller.abort(), timeoutMs + 2_000);
 		const forwardAbort = () => controller.abort();
@@ -464,13 +571,18 @@ class ChromeProfileBridge {
 				body: JSON.stringify({ action, params, timeoutMs }),
 				signal: controller.signal,
 			});
-			const payload = (await response.json().catch(() => ({}))) as { ok?: boolean; result?: unknown; error?: string };
+			const payload = (await response.json().catch(() => ({}))) as {
+				ok?: boolean;
+				result?: unknown;
+				error?: string;
+			};
 			if (response.status === 404) {
 				throw new Error(
 					"A running Pi session owns the Chrome bridge but is using an older pi-chrome without multi-session support. Restart that Pi session after `pi update`, then retry.",
 				);
 			}
-			if (!response.ok || !payload.ok) throw new Error(payload.error ?? `Chrome bridge owner HTTP ${response.status}`);
+			if (!response.ok || !payload.ok)
+				throw new Error(payload.error ?? `Chrome bridge owner HTTP ${response.status}`);
 			return payload.result;
 		} catch (error) {
 			if ((error as Error).name === "AbortError") {
@@ -662,7 +774,12 @@ const CHROME_TOOL_NAMES = [
 const CHROME_TOOL_NAME_SET = new Set<string>(CHROME_TOOL_NAMES);
 
 function StringEnum<T extends readonly [string, ...string[]]>(values: T) {
-	return Type.Union(values.map((value) => Type.Literal(value)) as [ReturnType<typeof Type.Literal>, ...ReturnType<typeof Type.Literal>[]]);
+	return Type.Union(
+		values.map((value) => Type.Literal(value)) as [
+			ReturnType<typeof Type.Literal>,
+			...ReturnType<typeof Type.Literal>[],
+		],
+	);
 }
 
 export default function (pi: ExtensionAPI): void {
@@ -711,7 +828,8 @@ export default function (pi: ExtensionAPI): void {
 		authExpiryTimer = undefined;
 	};
 
-	const activeToolNamesWithoutChrome = (): string[] => pi.getActiveTools().filter((name) => !CHROME_TOOL_NAME_SET.has(name));
+	const activeToolNamesWithoutChrome = (): string[] =>
+		pi.getActiveTools().filter((name) => !CHROME_TOOL_NAME_SET.has(name));
 
 	const activateChromeTools = (): void => {
 		registerChromeTools(pi);
@@ -761,7 +879,7 @@ export default function (pi: ExtensionAPI): void {
 
 	const updateChromeStatus = (ctx: ExtensionContext): void => {
 		if (chromeControlAuthorized()) {
-			ctx.ui.setStatus("chrome", ctx.ui.theme.fg("success", "●") + " Chrome Bridge");
+			ctx.ui.setStatus("chrome", `${ctx.ui.theme.fg("success", "●")} Chrome Bridge`);
 		} else {
 			ctx.ui.setStatus("chrome", undefined);
 		}
@@ -770,25 +888,37 @@ export default function (pi: ExtensionAPI): void {
 	const scheduleAuthExpiry = (ctx: ExtensionContext, until: number | "indefinite"): void => {
 		clearAuthExpiryTimer();
 		if (until === "indefinite") return;
-		authExpiryTimer = setTimeout(() => {
-			if (chromeAuthorizedUntil !== until) return;
-			try {
-				lockChromeControl();
-				ctx.ui.notify("Chrome control authorization expired. Run /chrome authorize to allow chrome_* tools again.", "info");
-				updateChromeStatus(ctx);
-			} catch (error) {
-				console.warn(`Failed to expire pi-chrome authorization cleanly: ${(error as Error).message}`);
-			}
-		}, Math.max(0, until - Date.now()));
+		authExpiryTimer = setTimeout(
+			() => {
+				if (chromeAuthorizedUntil !== until) return;
+				try {
+					lockChromeControl();
+					ctx.ui.notify(
+						"Chrome control authorization expired. Run /chrome authorize to allow chrome_* tools again.",
+						"info",
+					);
+					updateChromeStatus(ctx);
+				} catch (error) {
+					console.warn(`Failed to expire pi-chrome authorization cleanly: ${(error as Error).message}`);
+				}
+			},
+			Math.max(0, until - Date.now()),
+		);
 	};
 
-	const authorizedBridgeSend = (action: string, params: Record<string, unknown>, timeoutMs = DEFAULT_TIMEOUT_MS, signal?: AbortSignal): Promise<unknown> => {
+	const authorizedBridgeSend = (
+		action: string,
+		params: Record<string, unknown>,
+		timeoutMs = DEFAULT_TIMEOUT_MS,
+		signal?: AbortSignal,
+	): Promise<unknown> => {
 		requireChromeControlAuthorized();
 		// Any tab Pi *uses* (page.* interactions) should join this session's group, mirroring the
 		// auto-grouping that tab.new already does. Tagging the wire params lets getTabByParams pull
 		// the resolved (e.g. active) tab into the session group on the service-worker side. We skip
 		// tab.* actions: tab.new/group group explicitly, and activate/close/ungroup/list must not.
-		const shouldJoinGroup = action.startsWith("page.") && sessionCtx !== undefined && params.sessionGroupTitle === undefined;
+		const shouldJoinGroup =
+			action.startsWith("page.") && sessionCtx !== undefined && params.sessionGroupTitle === undefined;
 		const wireParams = shouldJoinGroup
 			? { ...params, sessionGroupTitle: sessionGroupTitle(sessionCtx as ExtensionContext), joinSessionGroup: true }
 			: params;
@@ -857,64 +987,86 @@ Usage rules:
 
 	// Shared handlers, dispatched by the unified /chrome command below.
 	const doctorHandler = async (ctx: ExtensionContext) => {
-			ctx.ui.notify("Checking pi-chrome…", "info");
-			const lines: string[] = [`pi-chrome v${PI_CHROME_VERSION}`];
-			const status = bridge.status();
-			const roleLabel = status.mode === "client" ? "sharing another pi session's connection" : "running the Chrome connection for this machine";
-			lines.push(`• This pi session is ${roleLabel}.`);
-			let extensionAlive = false;
-			let versionMismatch = false;
+		ctx.ui.notify("Checking pi-chrome…", "info");
+		const lines: string[] = [`pi-chrome v${PI_CHROME_VERSION}`];
+		const status = bridge.status();
+		const roleLabel =
+			status.mode === "client"
+				? "sharing another pi session's connection"
+				: "running the Chrome connection for this machine";
+		lines.push(`• This pi session is ${roleLabel}.`);
+		let extensionAlive = false;
+		let versionMismatch = false;
+		try {
+			const started = Date.now();
+			const version = (await bridge.send("tab.version", {}, 35_000)) as {
+				extensionId?: string;
+				extensionVersion?: string;
+				bridgeUrl?: string;
+			};
+			const latencyMs = Date.now() - started;
+			extensionAlive = true;
+			if (version.extensionVersion && version.extensionVersion !== PI_CHROME_VERSION) {
+				versionMismatch = true;
+				lines.push(
+					`✗ The Chrome companion extension is on an old version (${version.extensionVersion}); this pi-chrome is ${PI_CHROME_VERSION}.`,
+					`  Every Chrome action will run with the old code until you reload the extension.`,
+					`  Fix: open chrome://extensions and click the refresh icon on 'Pi Chrome Connector'.`,
+					`  (After this one-time fix, future updates reload automatically.)`,
+				);
+			} else {
+				lines.push(
+					`✓ Chrome is connected (companion extension v${version.extensionVersion ?? "?"}, responded in ${latencyMs}ms).`,
+				);
+			}
+		} catch (error) {
+			const message = (error as Error).message;
+			lines.push(`✗ Chrome isn't responding: ${message}`);
+			if (message.includes("older pi-chrome without multi-session")) {
+				lines.push(
+					"  Fix: quit and restart the pi session that first opened the Chrome connection (it was on an older pi-chrome).",
+				);
+			} else {
+				lines.push(
+					"  Fix: run /chrome onboard to install the Chrome companion extension, then keep that Chrome window open.",
+				);
+			}
+		}
+
+		if (extensionAlive && !versionMismatch) {
+			// Sanity-check that pi-chrome can actually run code in the active tab.
 			try {
-				const started = Date.now();
-				const version = (await bridge.send("tab.version", {}, 35_000)) as {
-					extensionId?: string;
-					extensionVersion?: string;
-					bridgeUrl?: string;
-				};
-				const latencyMs = Date.now() - started;
-				extensionAlive = true;
-				if (version.extensionVersion && version.extensionVersion !== PI_CHROME_VERSION) {
-					versionMismatch = true;
+				const value = await bridge.send(
+					"page.evaluate",
+					{ expression: "1+1", awaitPromise: true, foreground: false },
+					10_000,
+				);
+				if (value === 2) lines.push(`✓ pi-chrome can run code in the active Chrome tab.`);
+				else
 					lines.push(
-						`✗ The Chrome companion extension is on an old version (${version.extensionVersion}); this pi-chrome is ${PI_CHROME_VERSION}.`,
-						`  Every Chrome action will run with the old code until you reload the extension.`,
-						`  Fix: open chrome://extensions and click the refresh icon on 'Pi Chrome Connector'.`,
-						`  (After this one-time fix, future updates reload automatically.)`,
+						`⚠ pi-chrome ran code in the active tab but got an unexpected result (${JSON.stringify(value)}). The current tab may be locked-down (a Chrome internal page or a strict site).`,
 					);
-				} else {
-					lines.push(`✓ Chrome is connected (companion extension v${version.extensionVersion ?? "?"}, responded in ${latencyMs}ms).`);
-				}
 			} catch (error) {
-				const message = (error as Error).message;
-				lines.push(`✗ Chrome isn't responding: ${message}`);
-				if (message.includes("older pi-chrome without multi-session")) {
-					lines.push("  Fix: quit and restart the pi session that first opened the Chrome connection (it was on an older pi-chrome).");
-				} else {
-					lines.push("  Fix: run /chrome onboard to install the Chrome companion extension, then keep that Chrome window open.");
-				}
+				lines.push(`✗ pi-chrome can't run code in the active tab: ${(error as Error).message}`);
 			}
 
-			if (extensionAlive && !versionMismatch) {
-				// Sanity-check that pi-chrome can actually run code in the active tab.
-				try {
-					const value = await bridge.send("page.evaluate", { expression: "1+1", awaitPromise: true, foreground: false }, 10_000);
-					if (value === 2) lines.push(`✓ pi-chrome can run code in the active Chrome tab.`);
-					else lines.push(`⚠ pi-chrome ran code in the active tab but got an unexpected result (${JSON.stringify(value)}). The current tab may be locked-down (a Chrome internal page or a strict site).`);
-				} catch (error) {
-					lines.push(`✗ pi-chrome can't run code in the active tab: ${(error as Error).message}`);
-				}
-
-				// Surface obvious site-side automation flags so the user knows why a site might block pi.
-				try {
-					const probe = (await bridge.send("page.probe", { foreground: false }, 10_000)) as Record<string, unknown>;
-					if (probe && probe.arithmetic === 2) lines.push(`✓ The active tab is ${hostnameOf(String(probe.location))} and accepts pi-chrome's commands.`);
-					if (probe && probe.webdriver) lines.push(`⚠ Your Chrome is reporting itself as automated to websites. Some sites use this signal to block sign-ins or bot checks.`);
-				} catch (error) {
-					lines.push(`⚠ Couldn't inspect the active tab: ${(error as Error).message}`);
-				}
-			} else if (versionMismatch) {
-				lines.push(`… Skipped the remaining checks until you reload the Chrome extension.`);
+			// Surface obvious site-side automation flags so the user knows why a site might block pi.
+			try {
+				const probe = (await bridge.send("page.probe", { foreground: false }, 10_000)) as Record<string, unknown>;
+				if (probe && probe.arithmetic === 2)
+					lines.push(
+						`✓ The active tab is ${hostnameOf(String(probe.location))} and accepts pi-chrome's commands.`,
+					);
+				if (probe?.webdriver)
+					lines.push(
+						`⚠ Your Chrome is reporting itself as automated to websites. Some sites use this signal to block sign-ins or bot checks.`,
+					);
+			} catch (error) {
+				lines.push(`⚠ Couldn't inspect the active tab: ${(error as Error).message}`);
 			}
+		} else if (versionMismatch) {
+			lines.push(`… Skipped the remaining checks until you reload the Chrome extension.`);
+		}
 
 		ctx.ui.notify(lines.join("\n"), "info");
 	};
@@ -965,7 +1117,8 @@ Usage rules:
 
 	const parseAuthorizeArg = (arg: string): { label: string; until: number | "indefinite" } | undefined => {
 		const normalized = arg.trim().toLowerCase() || "15m";
-		if (normalized === "indefinite" || normalized === "forever") return { label: "indefinitely", until: "indefinite" };
+		if (normalized === "indefinite" || normalized === "forever")
+			return { label: "indefinitely", until: "indefinite" };
 		const minutes = normalized.endsWith("m") ? Number(normalized.slice(0, -1)) : Number(normalized);
 		if (!Number.isFinite(minutes) || minutes <= 0) return undefined;
 		return { label: `${minutes} minutes`, until: Date.now() + minutes * 60_000 };
@@ -997,9 +1150,18 @@ Usage rules:
 			return;
 		}
 		if (process.platform === "darwin") {
-			await pi.exec("open", ["-a", "Google Chrome", "chrome://extensions"], { cwd: workspaceCwd(ctx), timeout: 5_000 }).catch(() => undefined);
-			await pi.exec("open", ["-R", extensionPath], { cwd: workspaceCwd(ctx), timeout: 5_000 }).catch(() => undefined);
-			await pi.exec("sh", ["-lc", `printf %s ${JSON.stringify(extensionPath)} | pbcopy`], { cwd: workspaceCwd(ctx), timeout: 5_000 }).catch(() => undefined);
+			await pi
+				.exec("open", ["-a", "Google Chrome", "chrome://extensions"], { cwd: workspaceCwd(ctx), timeout: 5_000 })
+				.catch(() => undefined);
+			await pi
+				.exec("open", ["-R", extensionPath], { cwd: workspaceCwd(ctx), timeout: 5_000 })
+				.catch(() => undefined);
+			await pi
+				.exec("sh", ["-lc", `printf %s ${JSON.stringify(extensionPath)} | pbcopy`], {
+					cwd: workspaceCwd(ctx),
+					timeout: 5_000,
+				})
+				.catch(() => undefined);
 		}
 		ctx.ui.notify(
 			"Chrome and Finder should be open. The extension folder path is on your clipboard. After you click 'Load unpacked' and pick it, run /chrome doctor to confirm everything is connected.",
@@ -1014,7 +1176,9 @@ Usage rules:
 		try {
 			const version = (await bridge.send("tab.version", {}, 5_000)) as { extensionVersion?: string };
 			if (version.extensionVersion && version.extensionVersion !== PI_CHROME_VERSION) {
-				parts.push(`⚠ Chrome extension v${version.extensionVersion} (pi-chrome v${PI_CHROME_VERSION}, reload extension)`);
+				parts.push(
+					`⚠ Chrome extension v${version.extensionVersion} (pi-chrome v${PI_CHROME_VERSION}, reload extension)`,
+				);
 			} else {
 				parts.push(`✓ Chrome connected`);
 			}
@@ -1041,9 +1205,12 @@ Usage rules:
 			]);
 			if (!choice) return;
 			switch (choice) {
-				case "15 minutes": return authorizeHandler(ctx, "15m");
-				case "30 minutes": return authorizeHandler(ctx, "30m");
-				case "Indefinite": return authorizeHandler(ctx, "indefinite");
+				case "15 minutes":
+					return authorizeHandler(ctx, "15m");
+				case "30 minutes":
+					return authorizeHandler(ctx, "30m");
+				case "Indefinite":
+					return authorizeHandler(ctx, "indefinite");
 				case "Custom minutes": {
 					const value = await ctx.ui.input("Authorize for how many minutes?", "45");
 					if (!value) continue;
@@ -1060,8 +1227,10 @@ Usage rules:
 		]);
 		if (!choice) return;
 		switch (choice) {
-			case "Use Chrome in background": return backgroundHandler(ctx, "on");
-			case "Use Chrome in foreground": return backgroundHandler(ctx, "off");
+			case "Use Chrome in background":
+				return backgroundHandler(ctx, "on");
+			case "Use Chrome in foreground":
+				return backgroundHandler(ctx, "off");
 		}
 	};
 
@@ -1077,11 +1246,18 @@ Usage rules:
 			]);
 			if (!choice) return;
 			switch (choice) {
-				case "Authorize Chrome control…": await openAuthorizeMenu(ctx); continue;
-				case "Lock Chrome control": return revokeHandler(ctx);
-				case "Doctor / troubleshoot": return doctorHandler(ctx);
-				case "Background / watch mode…": await openBackgroundMenu(ctx); continue;
-				case "Install / onboard extension": return onboardHandler(ctx);
+				case "Authorize Chrome control…":
+					await openAuthorizeMenu(ctx);
+					continue;
+				case "Lock Chrome control":
+					return revokeHandler(ctx);
+				case "Doctor / troubleshoot":
+					return doctorHandler(ctx);
+				case "Background / watch mode…":
+					await openBackgroundMenu(ctx);
+					continue;
+				case "Install / onboard extension":
+					return onboardHandler(ctx);
 			}
 		}
 	};
@@ -1105,24 +1281,60 @@ Usage rules:
 			let candidates: Item[] = [];
 			if (path.length === 0) {
 				candidates = [
-					{ fullValue: "authorize", label: "authorize", description: "Allow this Pi session to use chrome_* tools." },
+					{
+						fullValue: "authorize",
+						label: "authorize",
+						description: "Allow this Pi session to use chrome_* tools.",
+					},
 					{ fullValue: "revoke", label: "revoke", description: "Lock Chrome control for this Pi session." },
-					{ fullValue: "status", label: "status", description: "One-line summary: connection, auth, and background setting." },
-					{ fullValue: "doctor", label: "doctor", description: "Full health check. Tells you if Chrome is connected and what's wrong if it isn't." },
-					{ fullValue: "onboard", label: "onboard", description: "Install the Chrome companion extension (first-time setup)." },
-					{ fullValue: "background", label: "background", description: "Run pi-chrome in the background without focusing Chrome?" },
+					{
+						fullValue: "status",
+						label: "status",
+						description: "One-line summary: connection, auth, and background setting.",
+					},
+					{
+						fullValue: "doctor",
+						label: "doctor",
+						description: "Full health check. Tells you if Chrome is connected and what's wrong if it isn't.",
+					},
+					{
+						fullValue: "onboard",
+						label: "onboard",
+						description: "Install the Chrome companion extension (first-time setup).",
+					},
+					{
+						fullValue: "background",
+						label: "background",
+						description: "Run pi-chrome in the background without focusing Chrome?",
+					},
 				];
 			} else if (path[0] === "authorize" && path.length === 1) {
 				candidates = [
 					{ fullValue: "authorize 15m", label: "15m", description: "Authorize Chrome control for 15 minutes." },
 					{ fullValue: "authorize 30m", label: "30m", description: "Authorize Chrome control for 30 minutes." },
-					{ fullValue: "authorize indefinite", label: "indefinite", description: "Authorize Chrome control until revoked or Pi exits." },
+					{
+						fullValue: "authorize indefinite",
+						label: "indefinite",
+						description: "Authorize Chrome control until revoked or Pi exits.",
+					},
 				];
 			} else if (path[0] === "background" && path.length === 1) {
 				candidates = [
-					{ fullValue: "background on", label: "on", description: "Run in background. Chrome stays in the background. Your editor keeps focus. (default)" },
-					{ fullValue: "background off", label: "off", description: "Bring Chrome to the front so you can watch." },
-					{ fullValue: "background toggle", label: "toggle", description: "Flip whichever way it's currently set." },
+					{
+						fullValue: "background on",
+						label: "on",
+						description: "Run in background. Chrome stays in the background. Your editor keeps focus. (default)",
+					},
+					{
+						fullValue: "background off",
+						label: "off",
+						description: "Bring Chrome to the front so you can watch.",
+					},
+					{
+						fullValue: "background toggle",
+						label: "toggle",
+						description: "Flip whichever way it's currently set.",
+					},
 					{ fullValue: "background status", label: "status", description: "Show the current setting." },
 				];
 			}
@@ -1140,11 +1352,16 @@ Usage rules:
 			const [head, ...rest] = tokens;
 			const subArgs = rest.join(" ");
 			switch (head) {
-				case "authorize": return authorizeHandler(ctx, subArgs);
-				case "revoke": return revokeHandler(ctx);
-				case "status": return statusHandler(ctx);
-				case "doctor": return doctorHandler(ctx);
-				case "onboard": return onboardHandler(ctx);
+				case "authorize":
+					return authorizeHandler(ctx, subArgs);
+				case "revoke":
+					return revokeHandler(ctx);
+				case "status":
+					return statusHandler(ctx);
+				case "doctor":
+					return doctorHandler(ctx);
+				case "onboard":
+					return onboardHandler(ctx);
 				case "background":
 					return backgroundHandler(ctx, subArgs);
 				case "settings": {
@@ -1155,7 +1372,10 @@ Usage rules:
 					return;
 				}
 				default:
-					ctx.ui.notify(`Unknown subcommand '${head}'. Try: /chrome authorize | revoke | status | doctor | onboard | background.`, "warning");
+					ctx.ui.notify(
+						`Unknown subcommand '${head}'. Try: /chrome authorize | revoke | status | doctor | onboard | background.`,
+						"warning",
+					);
 			}
 		},
 	});
@@ -1164,636 +1384,958 @@ Usage rules:
 		if (chromeToolsRegistered) return;
 		chromeToolsRegistered = true;
 
-	pi.registerTool({
-		name: "chrome_launch",
-		label: "Chrome Bridge Setup",
-		description:
-			"Start/check the local bridge used by the companion Chrome extension. This does not launch a separate Chrome profile; install the unpacked Chrome extension in your existing Chrome profile to connect.",
-		promptSnippet: "Show instructions for connecting Pi to the user's existing Chrome profile via the companion extension.",
-		parameters: Type.Object({
-			port: Type.Optional(Type.Number({ description: "Ignored. The bundled Chrome extension polls 127.0.0.1:17318." })),
-			url: Type.Optional(Type.String({ description: "Optional URL to open in the existing Chrome profile after the extension is connected." })),
-			userDataDir: Type.Optional(Type.String({ description: "Ignored. This bridge intentionally uses the user's existing Chrome profile through the companion extension." })),
-			useDefaultProfile: Type.Optional(Type.Boolean({ description: "Ignored; existing-profile access comes from the companion Chrome extension." })),
-			headless: Type.Optional(Type.Boolean({ description: "Ignored." })),
-		}),
-		async execute(_id, params, signal, _onUpdate, ctx): Promise<ToolTextResult> {
-			if (params.url && bridge.connected) {
-				const result = await authorizedBridgeSend("tab.new", { url: params.url }, DEFAULT_TIMEOUT_MS, signal);
-				return { content: [{ type: "text", text: `Chrome bridge connected; opened ${params.url}` }], details: { status: bridge.status(), result } };
-			}
-			return {
-				content: [
-					{
-						type: "text",
-						text:
-							`Chrome profile bridge is listening at ${bridge.url}.\n\n` +
-							`To connect your existing Chrome profile:\n` +
-							`1. Open chrome://extensions in the Chrome profile you normally use.\n` +
-							`2. Enable Developer mode.\n` +
-							`3. Click “Load unpacked”.\n` +
-							`4. Select: ${browserExtensionPath()}\n\n` +
-							`Status: ${bridge.connected ? "connected" : "waiting for extension"}.`,
-					},
-				],
-				details: { status: bridge.status(), extensionPath: browserExtensionPath() },
-			};
-		},
-	});
-
-	pi.registerTool({
-		name: "chrome_tab",
-		label: "Chrome Tab",
-		description: "List, create, activate, close, group, ungroup, or inspect tabs in the user's existing Chrome profile via the companion extension.",
-		promptSnippet: "List/open/activate/close/group existing Chrome tabs through the companion extension.",
-		parameters: Type.Object({
-			action: StringEnum(tabActionValues),
-			url: Type.Optional(Type.String({ description: "URL for action=new." })),
-			targetId: Type.Optional(Type.String({ description: "Chrome tab id for activate/close/group/ungroup." })),
-			urlIncludes: Type.Optional(Type.String({ description: "Match the target tab by URL substring for activate/close/group/ungroup." })),
-			titleIncludes: Type.Optional(Type.String({ description: "Match the target tab by title substring for activate/close/group/ungroup." })),
-			group: Type.Optional(Type.Boolean({ description: "action=new only: pass false to open an ungrouped tab. By default every Pi-opened tab joins this session's own tab group." })),
-			groupTitle: Type.Optional(Type.String({ description: "Tab group title for action=group/new. Defaults to this Pi session's group ('Pi Session: <name-or-id>'). Pass an empty string on action=new to opt out of grouping." })),
-			groupColor: Type.Optional(Type.String({ description: "Tab group color for action=group/new: grey, blue, red, yellow, green, pink, purple, cyan, or orange. Defaults to blue." })),
-			host: Type.Optional(Type.String()),
-			port: Type.Optional(Type.Number()),
-		}),
-		async execute(_id, params, signal, _onUpdate, ctx): Promise<ToolTextResult> {
-			const forwarded = { ...params } as typeof params & { groupTitle?: string };
-			// Default every Pi-opened/explicitly-grouped tab into this session's own group,
-			// named after the session display name (falling back to the session id), unless
-			// the caller specified a group title or opted out with group:false.
-			if ((params.action === "new" || params.action === "group") && params.groupTitle === undefined && params.group !== false) {
-				forwarded.groupTitle = sessionGroupTitle(ctx);
-			}
-			const result = await authorizedBridgeSend(`tab.${params.action}`, forwarded, DEFAULT_TIMEOUT_MS, signal);
-			if (params.action === "list") {
-				const tabs = result as Array<{ id: number; title: string; url: string; active: boolean; windowId: number; group?: { title?: string } | null }>;
-				const text = tabs.map((tab) => `${tab.id}\t${tab.active ? "*" : " "}\t${tab.group?.title ? `[${tab.group.title}] ` : ""}${tab.title || "(untitled)"}\t${tab.url}`).join("\n") || "No tabs.";
-				return { content: [{ type: "text", text }], details: { tabs } };
-			}
-			return { content: [{ type: "text", text: safeJson(result) }], details: { result: result as Json } };
-		},
-	});
+		pi.registerTool({
+			name: "chrome_launch",
+			label: "Chrome Bridge Setup",
+			description:
+				"Start/check the local bridge used by the companion Chrome extension. This does not launch a separate Chrome profile; install the unpacked Chrome extension in your existing Chrome profile to connect.",
+			promptSnippet:
+				"Show instructions for connecting Pi to the user's existing Chrome profile via the companion extension.",
+			parameters: Type.Object({
+				port: Type.Optional(
+					Type.Number({ description: "Ignored. The bundled Chrome extension polls 127.0.0.1:17318." }),
+				),
+				url: Type.Optional(
+					Type.String({
+						description: "Optional URL to open in the existing Chrome profile after the extension is connected.",
+					}),
+				),
+				userDataDir: Type.Optional(
+					Type.String({
+						description:
+							"Ignored. This bridge intentionally uses the user's existing Chrome profile through the companion extension.",
+					}),
+				),
+				useDefaultProfile: Type.Optional(
+					Type.Boolean({
+						description: "Ignored; existing-profile access comes from the companion Chrome extension.",
+					}),
+				),
+				headless: Type.Optional(Type.Boolean({ description: "Ignored." })),
+			}),
+			async execute(_id, params, signal, _onUpdate, _ctx): Promise<ToolTextResult> {
+				if (params.url && bridge.connected) {
+					const result = await authorizedBridgeSend("tab.new", { url: params.url }, DEFAULT_TIMEOUT_MS, signal);
+					return {
+						content: [{ type: "text", text: `Chrome bridge connected; opened ${params.url}` }],
+						details: { status: bridge.status(), result },
+					};
+				}
+				return {
+					content: [
+						{
+							type: "text",
+							text:
+								`Chrome profile bridge is listening at ${bridge.url}.\n\n` +
+								`To connect your existing Chrome profile:\n` +
+								`1. Open chrome://extensions in the Chrome profile you normally use.\n` +
+								`2. Enable Developer mode.\n` +
+								`3. Click “Load unpacked”.\n` +
+								`4. Select: ${browserExtensionPath()}\n\n` +
+								`Status: ${bridge.connected ? "connected" : "waiting for extension"}.`,
+						},
+					],
+					details: { status: bridge.status(), extensionPath: browserExtensionPath() },
+				};
+			},
+		});
 
-	pi.registerTool({
-		name: "chrome_snapshot",
-		label: "Chrome Snapshot",
-		description:
-			"Inspect a page in the user's existing Chrome profile. Default output is a concise, agent-friendly observation with structural layout/context, stable uids, visible actions, form fields, page hints, and changes since the previous snapshot. Use mode/query/nearUid to zoom instead of dumping the whole page. Runs in the background by default; pass background=false to bring Chrome to the foreground so the user can watch.",
-		promptSnippet: "Observe the current Chrome page: concise summary, structural layout, visible actions, forms, page map, query matches, and stable uids.",
-		parameters: Type.Object({
-			targetId: Type.Optional(Type.String()),
-			urlIncludes: Type.Optional(Type.String()),
-			titleIncludes: Type.Optional(Type.String()),
-			maxElements: Type.Optional(Type.Number({ default: MAX_ELEMENTS })),
-			mode: Type.Optional(StringEnum(snapshotModeValues)),
-			query: Type.Optional(Type.String({ description: "Find/rank elements, regions, and text matching this phrase, e.g. 'merge button', 'email error', 'approve PR'." })),
-			maxTextChars: Type.Optional(Type.Number({ description: "Max body text chars included in the underlying snapshot. Defaults are smaller for concise modes." })),
-			containingText: Type.Optional(Type.String({ description: "Only return elements whose label/text contains this string (case-insensitive). Useful when the page has many controls." })),
-			roleFilter: Type.Optional(Type.String({ description: "Only return elements matching this ARIA role or tag name (case-insensitive). e.g. 'button', 'link', 'textbox'." })),
-			nearUid: Type.Optional(Type.String({ description: "Sort elements by proximity to this snapshot uid. Useful for finding controls near a known anchor." })),
-			background: Type.Optional(
-				Type.Boolean({ description: "If true (the default), run silently in the background without focusing Chrome; pass false so Chrome focuses + the tab activates and the user can watch." }),
-			),
-			host: Type.Optional(Type.String()),
-			port: Type.Optional(Type.Number()),
-		}),
-		async execute(_id, params, signal): Promise<ToolTextResult> {
-			const snapshot = await authorizedBridgeSend(
-				"page.snapshot",
-				withBackground({ ...params, maxElements: params.maxElements ?? MAX_ELEMENTS }),
-				DEFAULT_TIMEOUT_MS,
-				signal,
-			);
-			return { content: [{ type: "text", text: formatChromeSnapshot(snapshot) }], details: { snapshot } };
-		},
-	});
+		pi.registerTool({
+			name: "chrome_tab",
+			label: "Chrome Tab",
+			description:
+				"List, create, activate, close, group, ungroup, or inspect tabs in the user's existing Chrome profile via the companion extension.",
+			promptSnippet: "List/open/activate/close/group existing Chrome tabs through the companion extension.",
+			parameters: Type.Object({
+				action: StringEnum(tabActionValues),
+				url: Type.Optional(Type.String({ description: "URL for action=new." })),
+				targetId: Type.Optional(Type.String({ description: "Chrome tab id for activate/close/group/ungroup." })),
+				urlIncludes: Type.Optional(
+					Type.String({ description: "Match the target tab by URL substring for activate/close/group/ungroup." }),
+				),
+				titleIncludes: Type.Optional(
+					Type.String({
+						description: "Match the target tab by title substring for activate/close/group/ungroup.",
+					}),
+				),
+				group: Type.Optional(
+					Type.Boolean({
+						description:
+							"action=new only: pass false to open an ungrouped tab. By default every Pi-opened tab joins this session's own tab group.",
+					}),
+				),
+				groupTitle: Type.Optional(
+					Type.String({
+						description:
+							"Tab group title for action=group/new. Defaults to this Pi session's group ('Pi Session: <name-or-id>'). Pass an empty string on action=new to opt out of grouping.",
+					}),
+				),
+				groupColor: Type.Optional(
+					Type.String({
+						description:
+							"Tab group color for action=group/new: grey, blue, red, yellow, green, pink, purple, cyan, or orange. Defaults to blue.",
+					}),
+				),
+				host: Type.Optional(Type.String()),
+				port: Type.Optional(Type.Number()),
+			}),
+			async execute(_id, params, signal, _onUpdate, ctx): Promise<ToolTextResult> {
+				const forwarded = { ...params } as typeof params & { groupTitle?: string };
+				// Default every Pi-opened/explicitly-grouped tab into this session's own group,
+				// named after the session display name (falling back to the session id), unless
+				// the caller specified a group title or opted out with group:false.
+				if (
+					(params.action === "new" || params.action === "group") &&
+					params.groupTitle === undefined &&
+					params.group !== false
+				) {
+					forwarded.groupTitle = sessionGroupTitle(ctx);
+				}
+				const result = await authorizedBridgeSend(`tab.${params.action}`, forwarded, DEFAULT_TIMEOUT_MS, signal);
+				if (params.action === "list") {
+					const tabs = result as Array<{
+						id: number;
+						title: string;
+						url: string;
+						active: boolean;
+						windowId: number;
+						group?: { title?: string } | null;
+					}>;
+					const text =
+						tabs
+							.map(
+								(tab) =>
+									`${tab.id}\t${tab.active ? "*" : " "}\t${tab.group?.title ? `[${tab.group.title}] ` : ""}${tab.title || "(untitled)"}\t${tab.url}`,
+							)
+							.join("\n") || "No tabs.";
+					return { content: [{ type: "text", text }], details: { tabs } };
+				}
+				return { content: [{ type: "text", text: safeJson(result) }], details: { result: result as Json } };
+			},
+		});
 
-	pi.registerTool({
-		name: "chrome_find",
-		label: "Chrome Find",
-		description:
-			"Find elements, page regions, or text on the current Chrome page by query. Returns ranked matches with stable uids and coordinates. This is a focused wrapper around chrome_snapshot({ query }).",
-		promptSnippet: "Find matching controls/text/regions in Chrome by natural-language query and return stable uids.",
-		parameters: Type.Object({
-			query: Type.String({ description: "What to find, e.g. 'merge button', 'email error', 'approve PR', 'search box'." }),
-			mode: Type.Optional(StringEnum(snapshotModeValues)),
-			maxElements: Type.Optional(Type.Number({ default: MAX_ELEMENTS })),
-			targetId: Type.Optional(Type.String()),
-			urlIncludes: Type.Optional(Type.String()),
-			titleIncludes: Type.Optional(Type.String()),
-			background: Type.Optional(
-				Type.Boolean({ description: "If true (the default), run silently in the background without focusing Chrome; pass false so Chrome focuses + the tab activates and the user can watch." }),
-			),
-			host: Type.Optional(Type.String()),
-			port: Type.Optional(Type.Number()),
-		}),
-		async execute(_id, params, signal): Promise<ToolTextResult> {
-			const snapshot = await authorizedBridgeSend(
-				"page.snapshot",
-				withBackground({ ...params, mode: params.mode || "auto", maxElements: params.maxElements ?? MAX_ELEMENTS }),
-				DEFAULT_TIMEOUT_MS,
-				signal,
-			);
-			return { content: [{ type: "text", text: formatChromeSnapshot(snapshot) }], details: { snapshot } };
-		},
-	});
+		pi.registerTool({
+			name: "chrome_snapshot",
+			label: "Chrome Snapshot",
+			description:
+				"Inspect a page in the user's existing Chrome profile. Default output is a concise, agent-friendly observation with structural layout/context, stable uids, visible actions, form fields, page hints, and changes since the previous snapshot. Use mode/query/nearUid to zoom instead of dumping the whole page. Runs in the background by default; pass background=false to bring Chrome to the foreground so the user can watch.",
+			promptSnippet:
+				"Observe the current Chrome page: concise summary, structural layout, visible actions, forms, page map, query matches, and stable uids.",
+			parameters: Type.Object({
+				targetId: Type.Optional(Type.String()),
+				urlIncludes: Type.Optional(Type.String()),
+				titleIncludes: Type.Optional(Type.String()),
+				maxElements: Type.Optional(Type.Number({ default: MAX_ELEMENTS })),
+				mode: Type.Optional(StringEnum(snapshotModeValues)),
+				query: Type.Optional(
+					Type.String({
+						description:
+							"Find/rank elements, regions, and text matching this phrase, e.g. 'merge button', 'email error', 'approve PR'.",
+					}),
+				),
+				maxTextChars: Type.Optional(
+					Type.Number({
+						description:
+							"Max body text chars included in the underlying snapshot. Defaults are smaller for concise modes.",
+					}),
+				),
+				containingText: Type.Optional(
+					Type.String({
+						description:
+							"Only return elements whose label/text contains this string (case-insensitive). Useful when the page has many controls.",
+					}),
+				),
+				roleFilter: Type.Optional(
+					Type.String({
+						description:
+							"Only return elements matching this ARIA role or tag name (case-insensitive). e.g. 'button', 'link', 'textbox'.",
+					}),
+				),
+				nearUid: Type.Optional(
+					Type.String({
+						description:
+							"Sort elements by proximity to this snapshot uid. Useful for finding controls near a known anchor.",
+					}),
+				),
+				background: Type.Optional(
+					Type.Boolean({
+						description:
+							"If true (the default), run silently in the background without focusing Chrome; pass false so Chrome focuses + the tab activates and the user can watch.",
+					}),
+				),
+				host: Type.Optional(Type.String()),
+				port: Type.Optional(Type.Number()),
+			}),
+			async execute(_id, params, signal): Promise<ToolTextResult> {
+				const snapshot = await authorizedBridgeSend(
+					"page.snapshot",
+					withBackground({ ...params, maxElements: params.maxElements ?? MAX_ELEMENTS }),
+					DEFAULT_TIMEOUT_MS,
+					signal,
+				);
+				return { content: [{ type: "text", text: formatChromeSnapshot(snapshot) }], details: { snapshot } };
+			},
+		});
 
-	pi.registerTool({
-		name: "chrome_inspect",
-		label: "Chrome Inspect Element",
-		description:
-			"Inspect one snapshot uid or selector deeply: nearby text, nearby actions, form context, ancestors, and suggested click target. Use after chrome_snapshot/chrome_find when you need context around one element.",
-		promptSnippet: "Inspect a Chrome snapshot uid deeply for nearby text, form context, and suggested actions.",
-		parameters: Type.Object({
-			uid: Type.Optional(Type.String({ description: "Stable element uid from chrome_snapshot/chrome_find." })),
-			selector: Type.Optional(Type.String({ description: "CSS selector if uid is unavailable." })),
-			scrollIntoView: Type.Optional(Type.Boolean({ description: "If true, scroll the target into view before inspecting. Default false to avoid changing page state." })),
-			targetId: Type.Optional(Type.String()),
-			urlIncludes: Type.Optional(Type.String()),
-			titleIncludes: Type.Optional(Type.String()),
-			background: Type.Optional(
-				Type.Boolean({ description: "If true (the default), run silently in the background without focusing Chrome; pass false so Chrome focuses + the tab activates and the user can watch." }),
-			),
-			host: Type.Optional(Type.String()),
-			port: Type.Optional(Type.Number()),
-		}),
-		async execute(_id, params, signal): Promise<ToolTextResult> {
-			try {
-				const inspect = await authorizedBridgeSend("page.inspect", withBackground(params), DEFAULT_TIMEOUT_MS, signal);
-				return { content: [{ type: "text", text: formatChromeInspect(inspect) }], details: { inspect } };
-			} catch (error) {
-				const message = error instanceof Error ? error.message : String(error);
-				if (!/Unknown action: page\.inspect/i.test(message)) throw error;
-				// Compatibility fallback for a loaded Chrome extension service worker that has not
-				// been reloaded since chrome_inspect was added. It is less rich than page.inspect,
-				// but still gives useful nearby candidates instead of failing the workflow.
+		pi.registerTool({
+			name: "chrome_find",
+			label: "Chrome Find",
+			description:
+				"Find elements, page regions, or text on the current Chrome page by query. Returns ranked matches with stable uids and coordinates. This is a focused wrapper around chrome_snapshot({ query }).",
+			promptSnippet:
+				"Find matching controls/text/regions in Chrome by natural-language query and return stable uids.",
+			parameters: Type.Object({
+				query: Type.String({
+					description: "What to find, e.g. 'merge button', 'email error', 'approve PR', 'search box'.",
+				}),
+				mode: Type.Optional(StringEnum(snapshotModeValues)),
+				maxElements: Type.Optional(Type.Number({ default: MAX_ELEMENTS })),
+				targetId: Type.Optional(Type.String()),
+				urlIncludes: Type.Optional(Type.String()),
+				titleIncludes: Type.Optional(Type.String()),
+				background: Type.Optional(
+					Type.Boolean({
+						description:
+							"If true (the default), run silently in the background without focusing Chrome; pass false so Chrome focuses + the tab activates and the user can watch.",
+					}),
+				),
+				host: Type.Optional(Type.String()),
+				port: Type.Optional(Type.Number()),
+			}),
+			async execute(_id, params, signal): Promise<ToolTextResult> {
 				const snapshot = await authorizedBridgeSend(
 					"page.snapshot",
 					withBackground({
 						...params,
-						mode: "interactive",
-						maxElements: MAX_ELEMENTS,
-						nearUid: params.uid,
-						query: params.selector,
+						mode: params.mode || "auto",
+						maxElements: params.maxElements ?? MAX_ELEMENTS,
 					}),
 					DEFAULT_TIMEOUT_MS,
 					signal,
 				);
-				const text = `chrome_inspect fallback: loaded Chrome extension does not yet support page.inspect; reload it at chrome://extensions for deep inspect.\n\n${formatChromeSnapshot(snapshot)}`;
-				return { content: [{ type: "text", text }], details: { snapshot, fallback: "page.snapshot" } };
-			}
-		},
-	});
+				return { content: [{ type: "text", text: formatChromeSnapshot(snapshot) }], details: { snapshot } };
+			},
+		});
 
-	pi.registerTool({
-		name: "chrome_navigate",
-		label: "Chrome Navigate",
-		description:
-			"Navigate an existing Chrome tab to a URL via the companion extension. Runs in the background by default; pass background=false to focus Chrome and activate the tab so the user can watch. Optionally waits for load completion.",
-		promptSnippet: "Navigate a Chrome tab in the user's existing profile.",
-		parameters: Type.Object({
-			url: Type.String(),
-			targetId: Type.Optional(Type.String()),
-			urlIncludes: Type.Optional(Type.String()),
-			titleIncludes: Type.Optional(Type.String()),
-			waitUntilLoad: Type.Optional(Type.Boolean({ default: true })),
-			timeoutMs: Type.Optional(Type.Number({ default: 15_000 })),
-			initScript: Type.Optional(Type.String({ description: "Optional JavaScript source to run in MAIN world at document_start of the next navigation. Useful for seeding localStorage, stubbing Date.now(), or defining navigator.webdriver=undefined. Requires the companion extension's webNavigation permission." })),
-			background: Type.Optional(
-				Type.Boolean({ description: "If true, navigate silently without focusing Chrome. Defaults to on (the session background setting); pass false to focus Chrome so the user can watch." }),
-			),
-			host: Type.Optional(Type.String()),
-			port: Type.Optional(Type.Number()),
-		}),
-		async execute(_id, params, signal): Promise<ToolTextResult> {
-			const result = await authorizedBridgeSend("page.navigate", withBackground(params), (params.timeoutMs ?? 15_000) + 2_000, signal);
-			return { content: [{ type: "text", text: `Navigated to ${params.url}${params.initScript ? " (with initScript)" : ""}` }], details: { result: result as Json } };
-		},
-	});
+		pi.registerTool({
+			name: "chrome_inspect",
+			label: "Chrome Inspect Element",
+			description:
+				"Inspect one snapshot uid or selector deeply: nearby text, nearby actions, form context, ancestors, and suggested click target. Use after chrome_snapshot/chrome_find when you need context around one element.",
+			promptSnippet: "Inspect a Chrome snapshot uid deeply for nearby text, form context, and suggested actions.",
+			parameters: Type.Object({
+				uid: Type.Optional(Type.String({ description: "Stable element uid from chrome_snapshot/chrome_find." })),
+				selector: Type.Optional(Type.String({ description: "CSS selector if uid is unavailable." })),
+				scrollIntoView: Type.Optional(
+					Type.Boolean({
+						description:
+							"If true, scroll the target into view before inspecting. Default false to avoid changing page state.",
+					}),
+				),
+				targetId: Type.Optional(Type.String()),
+				urlIncludes: Type.Optional(Type.String()),
+				titleIncludes: Type.Optional(Type.String()),
+				background: Type.Optional(
+					Type.Boolean({
+						description:
+							"If true (the default), run silently in the background without focusing Chrome; pass false so Chrome focuses + the tab activates and the user can watch.",
+					}),
+				),
+				host: Type.Optional(Type.String()),
+				port: Type.Optional(Type.Number()),
+			}),
+			async execute(_id, params, signal): Promise<ToolTextResult> {
+				try {
+					const inspect = await authorizedBridgeSend(
+						"page.inspect",
+						withBackground(params),
+						DEFAULT_TIMEOUT_MS,
+						signal,
+					);
+					return { content: [{ type: "text", text: formatChromeInspect(inspect) }], details: { inspect } };
+				} catch (error) {
+					const message = error instanceof Error ? error.message : String(error);
+					if (!/Unknown action: page\.inspect/i.test(message)) throw error;
+					// Compatibility fallback for a loaded Chrome extension service worker that has not
+					// been reloaded since chrome_inspect was added. It is less rich than page.inspect,
+					// but still gives useful nearby candidates instead of failing the workflow.
+					const snapshot = await authorizedBridgeSend(
+						"page.snapshot",
+						withBackground({
+							...params,
+							mode: "interactive",
+							maxElements: MAX_ELEMENTS,
+							nearUid: params.uid,
+							query: params.selector,
+						}),
+						DEFAULT_TIMEOUT_MS,
+						signal,
+					);
+					const text = `chrome_inspect fallback: loaded Chrome extension does not yet support page.inspect; reload it at chrome://extensions for deep inspect.\n\n${formatChromeSnapshot(snapshot)}`;
+					return { content: [{ type: "text", text }], details: { snapshot, fallback: "page.snapshot" } };
+				}
+			},
+		});
 
-	pi.registerTool({
-		name: "chrome_evaluate",
-		label: "Chrome Evaluate",
-		description:
-			"Evaluate JavaScript in an existing Chrome tab through the companion extension. Runs in the page context and returns JSON-serializable values when possible. Runs in the background by default; pass background=false to focus Chrome and activate the tab.",
-		promptSnippet: "Evaluate JavaScript in the active Chrome tab through the companion extension.",
-		parameters: Type.Object({
-			expression: Type.String(),
-			awaitPromise: Type.Optional(Type.Boolean({ default: true })),
-			targetId: Type.Optional(Type.String()),
-			urlIncludes: Type.Optional(Type.String()),
-			titleIncludes: Type.Optional(Type.String()),
-			background: Type.Optional(
-				Type.Boolean({ description: "If true, evaluate silently without focusing Chrome. Defaults to on (the session background setting); pass false to focus Chrome so the user can watch." }),
-			),
-			host: Type.Optional(Type.String()),
-			port: Type.Optional(Type.Number()),
-		}),
-		async execute(_id, params, signal): Promise<ToolTextResult> {
-			const value = await authorizedBridgeSend("page.evaluate", withBackground(params), DEFAULT_TIMEOUT_MS, signal);
-			const text = value === undefined
-				? "undefined"
-				: typeof value === "string"
-					? value
-					: safeJson(value) ?? "undefined";
-			return { content: [{ type: "text", text: truncateText(text) }], details: { value: value as Json } };
-		},
-	});
+		pi.registerTool({
+			name: "chrome_navigate",
+			label: "Chrome Navigate",
+			description:
+				"Navigate an existing Chrome tab to a URL via the companion extension. Runs in the background by default; pass background=false to focus Chrome and activate the tab so the user can watch. Optionally waits for load completion.",
+			promptSnippet: "Navigate a Chrome tab in the user's existing profile.",
+			parameters: Type.Object({
+				url: Type.String(),
+				targetId: Type.Optional(Type.String()),
+				urlIncludes: Type.Optional(Type.String()),
+				titleIncludes: Type.Optional(Type.String()),
+				waitUntilLoad: Type.Optional(Type.Boolean({ default: true })),
+				timeoutMs: Type.Optional(Type.Number({ default: 15_000 })),
+				initScript: Type.Optional(
+					Type.String({
+						description:
+							"Optional JavaScript source to run in MAIN world at document_start of the next navigation. Useful for seeding localStorage, stubbing Date.now(), or defining navigator.webdriver=undefined. Requires the companion extension's webNavigation permission.",
+					}),
+				),
+				background: Type.Optional(
+					Type.Boolean({
+						description:
+							"If true, navigate silently without focusing Chrome. Defaults to on (the session background setting); pass false to focus Chrome so the user can watch.",
+					}),
+				),
+				host: Type.Optional(Type.String()),
+				port: Type.Optional(Type.Number()),
+			}),
+			async execute(_id, params, signal): Promise<ToolTextResult> {
+				const result = await authorizedBridgeSend(
+					"page.navigate",
+					withBackground(params),
+					(params.timeoutMs ?? 15_000) + 2_000,
+					signal,
+				);
+				return {
+					content: [
+						{ type: "text", text: `Navigated to ${params.url}${params.initScript ? " (with initScript)" : ""}` },
+					],
+					details: { result: result as Json },
+				};
+			},
+		});
 
-	pi.registerTool({
-		name: "chrome_click",
-		label: "Chrome Click",
-		description:
-			"Click a snapshot uid, CSS selector, or viewport coordinate using Chrome's real input layer. Pass includeSnapshot=true to return a fresh snapshot after the click.",
-		promptSnippet: "Click page elements in Chrome by snapshot uid, selector, or viewport coordinate.",
-		parameters: Type.Object({
-			uid: Type.Optional(Type.String({ description: "Stable element uid from chrome_snapshot. Prefer uid over selector after taking a snapshot." })),
-			selector: Type.Optional(Type.String({ description: "CSS selector to click. Prefer uid from chrome_snapshot when available." })),
-			x: Type.Optional(Type.Number({ description: "Viewport x coordinate if uid/selector is omitted." })),
-			y: Type.Optional(Type.Number({ description: "Viewport y coordinate if uid/selector is omitted." })),
-			domFallback: Type.Optional(Type.Boolean({ description: "If true (default), fall back to DOM-dispatched click if Chrome's CDP input path is blocked by another extension overlay or debugger failure." })),
-			includeSnapshot: Type.Optional(Type.Boolean({ description: "If true, include a fresh chrome_snapshot result after the click." })),
-			maxElements: Type.Optional(Type.Number({ default: MAX_ELEMENTS, description: "Max elements in the included snapshot." })),
-			targetId: Type.Optional(Type.String()),
-			urlIncludes: Type.Optional(Type.String()),
-			titleIncludes: Type.Optional(Type.String()),
-			background: Type.Optional(
-				Type.Boolean({ description: "If true, click silently without focusing Chrome. Defaults to on (the session background setting); pass false to focus Chrome so the user can watch." }),
-			),
-			host: Type.Optional(Type.String()),
-			port: Type.Optional(Type.Number()),
-		}),
-		async execute(_id, params, signal): Promise<ToolTextResult> {
-			const raw = await authorizedBridgeSend("page.click", withBackground(params), DEFAULT_TIMEOUT_MS, signal);
-			const result = (params.includeSnapshot ? (raw as { result: unknown }).result : raw) as Json;
-			const summary = summarizeActionResult(result);
-			const target = params.uid ?? params.selector ?? `${params.x},${params.y}`;
-			const text = summary ? `Clicked ${target} — ${summary}` : `Clicked ${target}`;
-			return { content: [{ type: "text", text: formatIncludedSnapshotText(raw, text) }], details: { result: raw as Json } };
-		},
-	});
+		pi.registerTool({
+			name: "chrome_evaluate",
+			label: "Chrome Evaluate",
+			description:
+				"Evaluate JavaScript in an existing Chrome tab through the companion extension. Runs in the page context and returns JSON-serializable values when possible. Runs in the background by default; pass background=false to focus Chrome and activate the tab.",
+			promptSnippet: "Evaluate JavaScript in the active Chrome tab through the companion extension.",
+			parameters: Type.Object({
+				expression: Type.String(),
+				awaitPromise: Type.Optional(Type.Boolean({ default: true })),
+				targetId: Type.Optional(Type.String()),
+				urlIncludes: Type.Optional(Type.String()),
+				titleIncludes: Type.Optional(Type.String()),
+				background: Type.Optional(
+					Type.Boolean({
+						description:
+							"If true, evaluate silently without focusing Chrome. Defaults to on (the session background setting); pass false to focus Chrome so the user can watch.",
+					}),
+				),
+				host: Type.Optional(Type.String()),
+				port: Type.Optional(Type.Number()),
+			}),
+			async execute(_id, params, signal): Promise<ToolTextResult> {
+				const value = await authorizedBridgeSend(
+					"page.evaluate",
+					withBackground(params),
+					DEFAULT_TIMEOUT_MS,
+					signal,
+				);
+				const text =
+					value === undefined ? "undefined" : typeof value === "string" ? value : (safeJson(value) ?? "undefined");
+				return { content: [{ type: "text", text: truncateText(text) }], details: { value: value as Json } };
+			},
+		});
 
-	pi.registerTool({
-		name: "chrome_type",
-		label: "Chrome Type",
-		description:
-			"Focus an optional snapshot uid or CSS selector, then type text using Chrome's real keyboard input. Pass includeSnapshot=true to return a fresh snapshot after typing.",
-		promptSnippet: "Type text into Chrome, optionally focusing a snapshot uid or selector first.",
-		parameters: Type.Object({
-			text: Type.String(),
-			uid: Type.Optional(Type.String({ description: "Stable element uid from chrome_snapshot." })),
-			selector: Type.Optional(Type.String({ description: "CSS selector to focus before typing." })),
-			includeSnapshot: Type.Optional(Type.Boolean({ description: "If true, include a fresh chrome_snapshot result after typing." })),
-			maxElements: Type.Optional(Type.Number({ default: MAX_ELEMENTS, description: "Max elements in the included snapshot." })),
-			pressEnter: Type.Optional(Type.Boolean()),
-			targetId: Type.Optional(Type.String()),
-			urlIncludes: Type.Optional(Type.String()),
-			titleIncludes: Type.Optional(Type.String()),
-			background: Type.Optional(
-				Type.Boolean({ description: "If true, type silently without focusing Chrome. Defaults to on (the session background setting); pass false to focus Chrome so the user can watch." }),
-			),
-			host: Type.Optional(Type.String()),
-			port: Type.Optional(Type.Number()),
-		}),
-		async execute(_id, params, signal): Promise<ToolTextResult> {
-			const raw = await authorizedBridgeSend("page.type", withBackground(params), DEFAULT_TIMEOUT_MS, signal);
-			const result = (params.includeSnapshot ? (raw as { result: unknown }).result : raw) as Json;
-			const summary = summarizeActionResult(result);
-			const into = params.uid || params.selector ? ` into ${params.uid ?? params.selector}` : "";
-			const base = `Typed ${params.text.length} character(s)${into}.`;
-			const text = summary ? `${base} (${summary})` : base;
-			return { content: [{ type: "text", text: formatIncludedSnapshotText(raw, text) }], details: { result: raw as Json } };
-		},
-	});
+		pi.registerTool({
+			name: "chrome_click",
+			label: "Chrome Click",
+			description:
+				"Click a snapshot uid, CSS selector, or viewport coordinate using Chrome's real input layer. Pass includeSnapshot=true to return a fresh snapshot after the click.",
+			promptSnippet: "Click page elements in Chrome by snapshot uid, selector, or viewport coordinate.",
+			parameters: Type.Object({
+				uid: Type.Optional(
+					Type.String({
+						description:
+							"Stable element uid from chrome_snapshot. Prefer uid over selector after taking a snapshot.",
+					}),
+				),
+				selector: Type.Optional(
+					Type.String({ description: "CSS selector to click. Prefer uid from chrome_snapshot when available." }),
+				),
+				x: Type.Optional(Type.Number({ description: "Viewport x coordinate if uid/selector is omitted." })),
+				y: Type.Optional(Type.Number({ description: "Viewport y coordinate if uid/selector is omitted." })),
+				domFallback: Type.Optional(
+					Type.Boolean({
+						description:
+							"If true (default), fall back to DOM-dispatched click if Chrome's CDP input path is blocked by another extension overlay or debugger failure.",
+					}),
+				),
+				includeSnapshot: Type.Optional(
+					Type.Boolean({ description: "If true, include a fresh chrome_snapshot result after the click." }),
+				),
+				maxElements: Type.Optional(
+					Type.Number({ default: MAX_ELEMENTS, description: "Max elements in the included snapshot." }),
+				),
+				targetId: Type.Optional(Type.String()),
+				urlIncludes: Type.Optional(Type.String()),
+				titleIncludes: Type.Optional(Type.String()),
+				background: Type.Optional(
+					Type.Boolean({
+						description:
+							"If true, click silently without focusing Chrome. Defaults to on (the session background setting); pass false to focus Chrome so the user can watch.",
+					}),
+				),
+				host: Type.Optional(Type.String()),
+				port: Type.Optional(Type.Number()),
+			}),
+			async execute(_id, params, signal): Promise<ToolTextResult> {
+				const raw = await authorizedBridgeSend("page.click", withBackground(params), DEFAULT_TIMEOUT_MS, signal);
+				const result = (params.includeSnapshot ? (raw as { result: unknown }).result : raw) as Json;
+				const summary = summarizeActionResult(result);
+				const target = params.uid ?? params.selector ?? `${params.x},${params.y}`;
+				const text = summary ? `Clicked ${target} — ${summary}` : `Clicked ${target}`;
+				return {
+					content: [{ type: "text", text: formatIncludedSnapshotText(raw, text) }],
+					details: { result: raw as Json },
+				};
+			},
+		});
 
-	pi.registerTool({
-		name: "chrome_fill",
-		label: "Chrome Fill",
-		description:
-			"Set the full value of a text input, textarea, or contenteditable element using Chrome click/select/delete/type input. Accepts a snapshot uid or CSS selector. Pass includeSnapshot=true to verify after filling.",
-		promptSnippet: "Fill a Chrome form field by snapshot uid or selector, optionally returning a fresh snapshot.",
-		parameters: Type.Object({
-			text: Type.String(),
-			uid: Type.Optional(Type.String({ description: "Stable element uid from chrome_snapshot." })),
-			selector: Type.Optional(Type.String({ description: "CSS selector to fill if uid is omitted." })),
-			submit: Type.Optional(Type.Boolean({ description: "If true, press Enter after filling." })),
-			domFallback: Type.Optional(Type.Boolean({ description: "If true (default), fall back to DOM value-setting if Chrome's CDP input path is blocked by another extension overlay or debugger failure." })),
-			includeSnapshot: Type.Optional(Type.Boolean({ description: "If true, include a fresh chrome_snapshot result after filling." })),
-			maxElements: Type.Optional(Type.Number({ default: MAX_ELEMENTS, description: "Max elements in the included snapshot." })),
-			targetId: Type.Optional(Type.String()),
-			urlIncludes: Type.Optional(Type.String()),
-			titleIncludes: Type.Optional(Type.String()),
-			background: Type.Optional(
-				Type.Boolean({ description: "If true, fill silently without focusing Chrome. Defaults to on (the session background setting); pass false to focus Chrome so the user can watch." }),
-			),
-			host: Type.Optional(Type.String()),
-			port: Type.Optional(Type.Number()),
-		}),
-		async execute(_id, params, signal): Promise<ToolTextResult> {
-			const raw = await authorizedBridgeSend("page.fill", withBackground(params), DEFAULT_TIMEOUT_MS, signal);
-			const result = (params.includeSnapshot ? (raw as { result: unknown }).result : raw) as Json;
-			const summary = summarizeActionResult(result);
-			const into = params.uid || params.selector ? ` into ${params.uid ?? params.selector}` : "";
-			const base = `Filled ${params.text.length} character(s)${into}.`;
-			const text = summary ? `${base} (${summary})` : base;
-			return { content: [{ type: "text", text: formatIncludedSnapshotText(raw, text) }], details: { result: raw as Json } };
-		},
-	});
+		pi.registerTool({
+			name: "chrome_type",
+			label: "Chrome Type",
+			description:
+				"Focus an optional snapshot uid or CSS selector, then type text using Chrome's real keyboard input. Pass includeSnapshot=true to return a fresh snapshot after typing.",
+			promptSnippet: "Type text into Chrome, optionally focusing a snapshot uid or selector first.",
+			parameters: Type.Object({
+				text: Type.String(),
+				uid: Type.Optional(Type.String({ description: "Stable element uid from chrome_snapshot." })),
+				selector: Type.Optional(Type.String({ description: "CSS selector to focus before typing." })),
+				includeSnapshot: Type.Optional(
+					Type.Boolean({ description: "If true, include a fresh chrome_snapshot result after typing." }),
+				),
+				maxElements: Type.Optional(
+					Type.Number({ default: MAX_ELEMENTS, description: "Max elements in the included snapshot." }),
+				),
+				pressEnter: Type.Optional(Type.Boolean()),
+				targetId: Type.Optional(Type.String()),
+				urlIncludes: Type.Optional(Type.String()),
+				titleIncludes: Type.Optional(Type.String()),
+				background: Type.Optional(
+					Type.Boolean({
+						description:
+							"If true, type silently without focusing Chrome. Defaults to on (the session background setting); pass false to focus Chrome so the user can watch.",
+					}),
+				),
+				host: Type.Optional(Type.String()),
+				port: Type.Optional(Type.Number()),
+			}),
+			async execute(_id, params, signal): Promise<ToolTextResult> {
+				const raw = await authorizedBridgeSend("page.type", withBackground(params), DEFAULT_TIMEOUT_MS, signal);
+				const result = (params.includeSnapshot ? (raw as { result: unknown }).result : raw) as Json;
+				const summary = summarizeActionResult(result);
+				const into = params.uid || params.selector ? ` into ${params.uid ?? params.selector}` : "";
+				const base = `Typed ${params.text.length} character(s)${into}.`;
+				const text = summary ? `${base} (${summary})` : base;
+				return {
+					content: [{ type: "text", text: formatIncludedSnapshotText(raw, text) }],
+					details: { result: raw as Json },
+				};
+			},
+		});
 
-	pi.registerTool({
-		name: "chrome_key",
-		label: "Chrome Key",
-		description:
-			"Send a keyboard key to an existing Chrome tab (Enter, Escape, Tab, Backspace, Delete, ArrowUp/Down/Left/Right, or one character). Runs in the background by default; pass background=false to focus Chrome and activate the tab so the user can watch. Pass includeSnapshot=true to verify after the keypress.",
-		promptSnippet: "Press keys in Chrome through the companion extension.",
-		parameters: Type.Object({
-			key: Type.String(),
-			modifiers: Type.Optional(Type.Object({
-				shiftKey: Type.Optional(Type.Boolean()),
-				ctrlKey: Type.Optional(Type.Boolean()),
-				altKey: Type.Optional(Type.Boolean()),
-				metaKey: Type.Optional(Type.Boolean()),
-			}, { description: "Modifier keys to hold while pressing the key (chord)." })),
-			includeSnapshot: Type.Optional(Type.Boolean({ description: "If true, include a fresh chrome_snapshot result after the keypress." })),
-			maxElements: Type.Optional(Type.Number({ default: MAX_ELEMENTS, description: "Max elements in the included snapshot." })),
-			targetId: Type.Optional(Type.String()),
-			urlIncludes: Type.Optional(Type.String()),
-			titleIncludes: Type.Optional(Type.String()),
-			background: Type.Optional(
-				Type.Boolean({ description: "If true, send the key silently without focusing Chrome. Defaults to on (the session background setting); pass false to focus Chrome so the user can watch." }),
-			),
-			host: Type.Optional(Type.String()),
-			port: Type.Optional(Type.Number()),
-		}),
-		async execute(_id, params, signal): Promise<ToolTextResult> {
-			const raw = await authorizedBridgeSend("page.key", withBackground(params), DEFAULT_TIMEOUT_MS, signal);
-			const result = (params.includeSnapshot ? (raw as { result: unknown }).result : raw) as Json;
-			const summary = summarizeActionResult(result);
-			const base = `Pressed ${params.key}.`;
-			const text = summary ? `${base} (${summary})` : base;
-			return { content: [{ type: "text", text: formatIncludedSnapshotText(raw, text) }], details: { result: raw as Json } };
-		},
-	});
+		pi.registerTool({
+			name: "chrome_fill",
+			label: "Chrome Fill",
+			description:
+				"Set the full value of a text input, textarea, or contenteditable element using Chrome click/select/delete/type input. Accepts a snapshot uid or CSS selector. Pass includeSnapshot=true to verify after filling.",
+			promptSnippet: "Fill a Chrome form field by snapshot uid or selector, optionally returning a fresh snapshot.",
+			parameters: Type.Object({
+				text: Type.String(),
+				uid: Type.Optional(Type.String({ description: "Stable element uid from chrome_snapshot." })),
+				selector: Type.Optional(Type.String({ description: "CSS selector to fill if uid is omitted." })),
+				submit: Type.Optional(Type.Boolean({ description: "If true, press Enter after filling." })),
+				domFallback: Type.Optional(
+					Type.Boolean({
+						description:
+							"If true (default), fall back to DOM value-setting if Chrome's CDP input path is blocked by another extension overlay or debugger failure.",
+					}),
+				),
+				includeSnapshot: Type.Optional(
+					Type.Boolean({ description: "If true, include a fresh chrome_snapshot result after filling." }),
+				),
+				maxElements: Type.Optional(
+					Type.Number({ default: MAX_ELEMENTS, description: "Max elements in the included snapshot." }),
+				),
+				targetId: Type.Optional(Type.String()),
+				urlIncludes: Type.Optional(Type.String()),
+				titleIncludes: Type.Optional(Type.String()),
+				background: Type.Optional(
+					Type.Boolean({
+						description:
+							"If true, fill silently without focusing Chrome. Defaults to on (the session background setting); pass false to focus Chrome so the user can watch.",
+					}),
+				),
+				host: Type.Optional(Type.String()),
+				port: Type.Optional(Type.Number()),
+			}),
+			async execute(_id, params, signal): Promise<ToolTextResult> {
+				const raw = await authorizedBridgeSend("page.fill", withBackground(params), DEFAULT_TIMEOUT_MS, signal);
+				const result = (params.includeSnapshot ? (raw as { result: unknown }).result : raw) as Json;
+				const summary = summarizeActionResult(result);
+				const into = params.uid || params.selector ? ` into ${params.uid ?? params.selector}` : "";
+				const base = `Filled ${params.text.length} character(s)${into}.`;
+				const text = summary ? `${base} (${summary})` : base;
+				return {
+					content: [{ type: "text", text: formatIncludedSnapshotText(raw, text) }],
+					details: { result: raw as Json },
+				};
+			},
+		});
 
-	pi.registerTool({
-		name: "chrome_wait_for",
-		label: "Chrome Wait For",
-		description: "Poll an existing Chrome tab until a selector exists or a JavaScript expression returns truthy.",
-		promptSnippet: "Wait for page state in Chrome before further automation.",
-		parameters: Type.Object({
-			kind: StringEnum(waitForValues),
-			value: Type.String({ description: "CSS selector when kind=selector; JavaScript expression when kind=expression." }),
-			timeoutMs: Type.Optional(Type.Number({ default: 10_000 })),
-			intervalMs: Type.Optional(Type.Number({ default: 250 })),
-			targetId: Type.Optional(Type.String()),
-			urlIncludes: Type.Optional(Type.String()),
-			titleIncludes: Type.Optional(Type.String()),
-			host: Type.Optional(Type.String()),
-			port: Type.Optional(Type.Number()),
-		}),
-		async execute(_id, params, signal): Promise<ToolTextResult> {
-			const result = await authorizedBridgeSend("page.waitFor", params, (params.timeoutMs ?? 10_000) + 2_000, signal);
-			return { content: [{ type: "text", text: `Observed ${params.kind}: ${params.value}` }], details: { result: result as Json } };
-		},
-	});
+		pi.registerTool({
+			name: "chrome_key",
+			label: "Chrome Key",
+			description:
+				"Send a keyboard key to an existing Chrome tab (Enter, Escape, Tab, Backspace, Delete, ArrowUp/Down/Left/Right, or one character). Runs in the background by default; pass background=false to focus Chrome and activate the tab so the user can watch. Pass includeSnapshot=true to verify after the keypress.",
+			promptSnippet: "Press keys in Chrome through the companion extension.",
+			parameters: Type.Object({
+				key: Type.String(),
+				modifiers: Type.Optional(
+					Type.Object(
+						{
+							shiftKey: Type.Optional(Type.Boolean()),
+							ctrlKey: Type.Optional(Type.Boolean()),
+							altKey: Type.Optional(Type.Boolean()),
+							metaKey: Type.Optional(Type.Boolean()),
+						},
+						{ description: "Modifier keys to hold while pressing the key (chord)." },
+					),
+				),
+				includeSnapshot: Type.Optional(
+					Type.Boolean({ description: "If true, include a fresh chrome_snapshot result after the keypress." }),
+				),
+				maxElements: Type.Optional(
+					Type.Number({ default: MAX_ELEMENTS, description: "Max elements in the included snapshot." }),
+				),
+				targetId: Type.Optional(Type.String()),
+				urlIncludes: Type.Optional(Type.String()),
+				titleIncludes: Type.Optional(Type.String()),
+				background: Type.Optional(
+					Type.Boolean({
+						description:
+							"If true, send the key silently without focusing Chrome. Defaults to on (the session background setting); pass false to focus Chrome so the user can watch.",
+					}),
+				),
+				host: Type.Optional(Type.String()),
+				port: Type.Optional(Type.Number()),
+			}),
+			async execute(_id, params, signal): Promise<ToolTextResult> {
+				const raw = await authorizedBridgeSend("page.key", withBackground(params), DEFAULT_TIMEOUT_MS, signal);
+				const result = (params.includeSnapshot ? (raw as { result: unknown }).result : raw) as Json;
+				const summary = summarizeActionResult(result);
+				const base = `Pressed ${params.key}.`;
+				const text = summary ? `${base} (${summary})` : base;
+				return {
+					content: [{ type: "text", text: formatIncludedSnapshotText(raw, text) }],
+					details: { result: raw as Json },
+				};
+			},
+		});
 
-	pi.registerTool({
-		name: "chrome_list_console_messages",
-		label: "Chrome Console Messages",
-		description:
-			"List console messages captured in the page by the companion extension. Capture starts after any chrome_snapshot, chrome_evaluate, chrome_list_console_messages, or chrome_list_network_requests call installs page instrumentation.",
-		promptSnippet: "List captured console messages from the active Chrome page.",
-		parameters: Type.Object({
-			clear: Type.Optional(Type.Boolean({ description: "Clear the captured console log after reading." })),
-			targetId: Type.Optional(Type.String()),
-			urlIncludes: Type.Optional(Type.String()),
-			titleIncludes: Type.Optional(Type.String()),
-			background: Type.Optional(Type.Boolean({ description: "If true, run silently without focusing Chrome. Defaults to on (the session background setting); pass false to focus Chrome so the user can watch." })),
-			host: Type.Optional(Type.String()),
-			port: Type.Optional(Type.Number()),
-		}),
-		async execute(_id, params, signal): Promise<ToolTextResult> {
-			const result = await authorizedBridgeSend("page.console.list", withBackground(params), DEFAULT_TIMEOUT_MS, signal);
-			return { content: [{ type: "text", text: truncateText(safeJson(result)) }], details: { result: result as Json } };
-		},
-	});
+		pi.registerTool({
+			name: "chrome_wait_for",
+			label: "Chrome Wait For",
+			description: "Poll an existing Chrome tab until a selector exists or a JavaScript expression returns truthy.",
+			promptSnippet: "Wait for page state in Chrome before further automation.",
+			parameters: Type.Object({
+				kind: StringEnum(waitForValues),
+				value: Type.String({
+					description: "CSS selector when kind=selector; JavaScript expression when kind=expression.",
+				}),
+				timeoutMs: Type.Optional(Type.Number({ default: 10_000 })),
+				intervalMs: Type.Optional(Type.Number({ default: 250 })),
+				targetId: Type.Optional(Type.String()),
+				urlIncludes: Type.Optional(Type.String()),
+				titleIncludes: Type.Optional(Type.String()),
+				host: Type.Optional(Type.String()),
+				port: Type.Optional(Type.Number()),
+			}),
+			async execute(_id, params, signal): Promise<ToolTextResult> {
+				const result = await authorizedBridgeSend(
+					"page.waitFor",
+					params,
+					(params.timeoutMs ?? 10_000) + 2_000,
+					signal,
+				);
+				return {
+					content: [{ type: "text", text: `Observed ${params.kind}: ${params.value}` }],
+					details: { result: result as Json },
+				};
+			},
+		});
 
-	pi.registerTool({
-		name: "chrome_list_network_requests",
-		label: "Chrome Network Requests",
-		description:
-			"List fetch/XMLHttpRequest activity captured in the page by the companion extension. Capture starts after instrumentation is installed by snapshot/evaluate/network/console tools; browser document/static asset requests are not captured. Use includePreservedRequests=true to keep requests from earlier same-tab navigations that were captured before navigation.",
-		promptSnippet: "List captured XHR/fetch requests from the active Chrome page before doing DOM-heavy debugging.",
-		parameters: Type.Object({
-			includePreservedRequests: Type.Optional(Type.Boolean({ description: "Include captured requests from earlier locations in the same tab/session." })),
-			clear: Type.Optional(Type.Boolean({ description: "Clear the captured request log after reading." })),
-			targetId: Type.Optional(Type.String()),
-			urlIncludes: Type.Optional(Type.String()),
-			titleIncludes: Type.Optional(Type.String()),
-			background: Type.Optional(Type.Boolean({ description: "If true, run silently without focusing Chrome. Defaults to on (the session background setting); pass false to focus Chrome so the user can watch." })),
-			host: Type.Optional(Type.String()),
-			port: Type.Optional(Type.Number()),
-		}),
-		async execute(_id, params, signal): Promise<ToolTextResult> {
-			const result = await authorizedBridgeSend("page.network.list", withBackground(params), DEFAULT_TIMEOUT_MS, signal);
-			return { content: [{ type: "text", text: truncateText(safeJson(result)) }], details: { result: result as Json } };
-		},
-	});
+		pi.registerTool({
+			name: "chrome_list_console_messages",
+			label: "Chrome Console Messages",
+			description:
+				"List console messages captured in the page by the companion extension. Capture starts after any chrome_snapshot, chrome_evaluate, chrome_list_console_messages, or chrome_list_network_requests call installs page instrumentation.",
+			promptSnippet: "List captured console messages from the active Chrome page.",
+			parameters: Type.Object({
+				clear: Type.Optional(Type.Boolean({ description: "Clear the captured console log after reading." })),
+				targetId: Type.Optional(Type.String()),
+				urlIncludes: Type.Optional(Type.String()),
+				titleIncludes: Type.Optional(Type.String()),
+				background: Type.Optional(
+					Type.Boolean({
+						description:
+							"If true, run silently without focusing Chrome. Defaults to on (the session background setting); pass false to focus Chrome so the user can watch.",
+					}),
+				),
+				host: Type.Optional(Type.String()),
+				port: Type.Optional(Type.Number()),
+			}),
+			async execute(_id, params, signal): Promise<ToolTextResult> {
+				const result = await authorizedBridgeSend(
+					"page.console.list",
+					withBackground(params),
+					DEFAULT_TIMEOUT_MS,
+					signal,
+				);
+				return {
+					content: [{ type: "text", text: truncateText(safeJson(result)) }],
+					details: { result: result as Json },
+				};
+			},
+		});
 
-	pi.registerTool({
-		name: "chrome_get_network_request",
-		label: "Chrome Network Request",
-		description: "Retrieve one captured fetch/XMLHttpRequest entry, including response body when available, by requestId from chrome_list_network_requests.",
-		promptSnippet: "Fetch captured request details and response body by requestId.",
-		parameters: Type.Object({
-			requestId: Type.String({ description: "Request id returned by chrome_list_network_requests." }),
-			targetId: Type.Optional(Type.String()),
-			urlIncludes: Type.Optional(Type.String()),
-			titleIncludes: Type.Optional(Type.String()),
-			background: Type.Optional(Type.Boolean({ description: "If true, run silently without focusing Chrome. Defaults to on (the session background setting); pass false to focus Chrome so the user can watch." })),
-			host: Type.Optional(Type.String()),
-			port: Type.Optional(Type.Number()),
-		}),
-		async execute(_id, params, signal): Promise<ToolTextResult> {
-			const result = await authorizedBridgeSend("page.network.get", withBackground(params), DEFAULT_TIMEOUT_MS, signal);
-			return { content: [{ type: "text", text: truncateText(safeJson(result)) }], details: { result: result as Json } };
-		},
-	});
+		pi.registerTool({
+			name: "chrome_list_network_requests",
+			label: "Chrome Network Requests",
+			description:
+				"List fetch/XMLHttpRequest activity captured in the page by the companion extension. Capture starts after instrumentation is installed by snapshot/evaluate/network/console tools; browser document/static asset requests are not captured. Use includePreservedRequests=true to keep requests from earlier same-tab navigations that were captured before navigation.",
+			promptSnippet:
+				"List captured XHR/fetch requests from the active Chrome page before doing DOM-heavy debugging.",
+			parameters: Type.Object({
+				includePreservedRequests: Type.Optional(
+					Type.Boolean({
+						description: "Include captured requests from earlier locations in the same tab/session.",
+					}),
+				),
+				clear: Type.Optional(Type.Boolean({ description: "Clear the captured request log after reading." })),
+				targetId: Type.Optional(Type.String()),
+				urlIncludes: Type.Optional(Type.String()),
+				titleIncludes: Type.Optional(Type.String()),
+				background: Type.Optional(
+					Type.Boolean({
+						description:
+							"If true, run silently without focusing Chrome. Defaults to on (the session background setting); pass false to focus Chrome so the user can watch.",
+					}),
+				),
+				host: Type.Optional(Type.String()),
+				port: Type.Optional(Type.Number()),
+			}),
+			async execute(_id, params, signal): Promise<ToolTextResult> {
+				const result = await authorizedBridgeSend(
+					"page.network.list",
+					withBackground(params),
+					DEFAULT_TIMEOUT_MS,
+					signal,
+				);
+				return {
+					content: [{ type: "text", text: truncateText(safeJson(result)) }],
+					details: { result: result as Json },
+				};
+			},
+		});
 
-	pi.registerTool({
-		name: "chrome_screenshot",
-		label: "Chrome Screenshot",
-		description:
-			"Capture a screenshot of an existing Chrome tab via the companion extension and save it to disk. Chrome's extension screenshot API requires the target tab to be the active tab in its window. Runs in the background by default (the tab is briefly activated within its window for the capture, then the previous active tab is restored); pass background=false to focus Chrome so the user can watch.",
-		promptSnippet: "Capture Chrome screenshots and save them under .pi/chrome-screenshots by default.",
-		parameters: Type.Object({
-			path: Type.Optional(Type.String({ description: "Output path. Defaults to .pi/chrome-screenshots/<timestamp>.<format>." })),
-			format: Type.Optional(StringEnum(imageFormatValues)),
-			quality: Type.Optional(Type.Number({ description: "JPEG quality 0-100." })),
-			fullPage: Type.Optional(Type.Boolean({ description: "Not supported by the extension bridge yet; viewport screenshots are captured." })),
-			targetId: Type.Optional(Type.String()),
-			urlIncludes: Type.Optional(Type.String()),
-			titleIncludes: Type.Optional(Type.String()),
-			background: Type.Optional(
-				Type.Boolean({ description: "If true (the default), capture silently without focusing the Chrome window (the target tab is briefly activated within its window for the capture, then restored); pass false to focus Chrome." }),
-			),
-			host: Type.Optional(Type.String()),
-			port: Type.Optional(Type.Number()),
-		}),
-		async execute(_id, params, signal, _onUpdate, ctx: ExtensionContext): Promise<ToolTextResult> {
-			const format = params.format ?? "png";
-			const cwd = workspaceCwd(ctx);
-			const defaultPath = join(cwd, ".pi", "chrome-screenshots", `${new Date().toISOString().replace(/[:.]/g, "-")}.${format}`);
-			const outputPath = params.path ? resolve(cwd, params.path) : defaultPath;
-			const result = (await authorizedBridgeSend("page.screenshot", withBackground(params), params.fullPage ? 120_000 : DEFAULT_TIMEOUT_MS, signal)) as {
-				dataUrl?: string;
-				tab?: unknown;
-				fullPage?: boolean;
-				dimensions?: { width: number; height: number; viewportHeight: number; dpr: number };
-				tiles?: Array<{ y: number; dataUrl: string }>;
-			};
-			await mkdir(dirname(outputPath), { recursive: true });
-			if (result.fullPage && result.tiles && result.dimensions) {
-				// Stitch via PNG if format is png; otherwise we fall back to writing tile files and a
-				// manifest. We avoid pulling in an image library by writing each tile next to the main
-				// path with a -tileN suffix and a stitched.json manifest.
-				const { width, height, viewportHeight, dpr } = result.dimensions;
-				const manifest: Array<{ path: string; y: number }> = [];
-				for (let i = 0; i < result.tiles.length; i++) {
-					const tile = result.tiles[i];
-					const tilePath = outputPath.replace(/(\.[^.]+)$/, `-tile${i}$1`);
-					const base64 = tile.dataUrl.replace(/^data:image\/(?:png|jpeg);base64,/, "");
-					await writeFile(tilePath, Buffer.from(base64, "base64"));
-					manifest.push({ path: tilePath, y: tile.y });
+		pi.registerTool({
+			name: "chrome_get_network_request",
+			label: "Chrome Network Request",
+			description:
+				"Retrieve one captured fetch/XMLHttpRequest entry, including response body when available, by requestId from chrome_list_network_requests.",
+			promptSnippet: "Fetch captured request details and response body by requestId.",
+			parameters: Type.Object({
+				requestId: Type.String({ description: "Request id returned by chrome_list_network_requests." }),
+				targetId: Type.Optional(Type.String()),
+				urlIncludes: Type.Optional(Type.String()),
+				titleIncludes: Type.Optional(Type.String()),
+				background: Type.Optional(
+					Type.Boolean({
+						description:
+							"If true, run silently without focusing Chrome. Defaults to on (the session background setting); pass false to focus Chrome so the user can watch.",
+					}),
+				),
+				host: Type.Optional(Type.String()),
+				port: Type.Optional(Type.Number()),
+			}),
+			async execute(_id, params, signal): Promise<ToolTextResult> {
+				const result = await authorizedBridgeSend(
+					"page.network.get",
+					withBackground(params),
+					DEFAULT_TIMEOUT_MS,
+					signal,
+				);
+				return {
+					content: [{ type: "text", text: truncateText(safeJson(result)) }],
+					details: { result: result as Json },
+				};
+			},
+		});
+
+		pi.registerTool({
+			name: "chrome_screenshot",
+			label: "Chrome Screenshot",
+			description:
+				"Capture a screenshot of an existing Chrome tab via the companion extension and save it to disk. Chrome's extension screenshot API requires the target tab to be the active tab in its window. Runs in the background by default (the tab is briefly activated within its window for the capture, then the previous active tab is restored); pass background=false to focus Chrome so the user can watch.",
+			promptSnippet: "Capture Chrome screenshots and save them under .pi/chrome-screenshots by default.",
+			parameters: Type.Object({
+				path: Type.Optional(
+					Type.String({ description: "Output path. Defaults to .pi/chrome-screenshots/<timestamp>.<format>." }),
+				),
+				format: Type.Optional(StringEnum(imageFormatValues)),
+				quality: Type.Optional(Type.Number({ description: "JPEG quality 0-100." })),
+				fullPage: Type.Optional(
+					Type.Boolean({
+						description: "Not supported by the extension bridge yet; viewport screenshots are captured.",
+					}),
+				),
+				targetId: Type.Optional(Type.String()),
+				urlIncludes: Type.Optional(Type.String()),
+				titleIncludes: Type.Optional(Type.String()),
+				background: Type.Optional(
+					Type.Boolean({
+						description:
+							"If true (the default), capture silently without focusing the Chrome window (the target tab is briefly activated within its window for the capture, then restored); pass false to focus Chrome.",
+					}),
+				),
+				host: Type.Optional(Type.String()),
+				port: Type.Optional(Type.Number()),
+			}),
+			async execute(_id, params, signal, _onUpdate, ctx: ExtensionContext): Promise<ToolTextResult> {
+				const format = params.format ?? "png";
+				const cwd = workspaceCwd(ctx);
+				const defaultPath = join(
+					cwd,
+					".pi",
+					"chrome-screenshots",
+					`${new Date().toISOString().replace(/[:.]/g, "-")}.${format}`,
+				);
+				const outputPath = params.path ? resolve(cwd, params.path) : defaultPath;
+				const result = (await authorizedBridgeSend(
+					"page.screenshot",
+					withBackground(params),
+					params.fullPage ? 120_000 : DEFAULT_TIMEOUT_MS,
+					signal,
+				)) as {
+					dataUrl?: string;
+					tab?: unknown;
+					fullPage?: boolean;
+					dimensions?: { width: number; height: number; viewportHeight: number; dpr: number };
+					tiles?: Array<{ y: number; dataUrl: string }>;
+				};
+				await mkdir(dirname(outputPath), { recursive: true });
+				if (result.fullPage && result.tiles && result.dimensions) {
+					// Stitch via PNG if format is png; otherwise we fall back to writing tile files and a
+					// manifest. We avoid pulling in an image library by writing each tile next to the main
+					// path with a -tileN suffix and a stitched.json manifest.
+					const { width, height, viewportHeight, dpr } = result.dimensions;
+					const manifest: Array<{ path: string; y: number }> = [];
+					for (let i = 0; i < result.tiles.length; i++) {
+						const tile = result.tiles[i];
+						const tilePath = outputPath.replace(/(\.[^.]+)$/, `-tile${i}$1`);
+						const base64 = tile.dataUrl.replace(/^data:image\/(?:png|jpeg);base64,/, "");
+						await writeFile(tilePath, Buffer.from(base64, "base64"));
+						manifest.push({ path: tilePath, y: tile.y });
+					}
+					await writeFile(
+						`${outputPath}.json`,
+						JSON.stringify({ width, height, viewportHeight, dpr, tiles: manifest }, null, 2),
+					);
+					return {
+						content: [
+							{
+								type: "text",
+								text: `Saved ${result.tiles.length} full-page tile(s) for ${width}×${height}px page. Manifest: ${outputPath}.json`,
+							},
+						],
+						details: {
+							manifest: `${outputPath}.json`,
+							tiles: manifest,
+							dimensions: result.dimensions,
+							tab: result.tab,
+						} as unknown as Record<string, unknown>,
+					};
 				}
-				await writeFile(outputPath + ".json", JSON.stringify({ width, height, viewportHeight, dpr, tiles: manifest }, null, 2));
+				if (!result.dataUrl) throw new Error("Screenshot returned no dataUrl");
+				const base64 = result.dataUrl.replace(/^data:image\/(?:png|jpeg);base64,/, "");
+				await writeFile(outputPath, Buffer.from(base64, "base64"));
 				return {
-					content: [{ type: "text", text: `Saved ${result.tiles.length} full-page tile(s) for ${width}×${height}px page. Manifest: ${outputPath}.json` }],
-					details: { manifest: outputPath + ".json", tiles: manifest, dimensions: result.dimensions, tab: result.tab } as unknown as Record<string, unknown>,
+					content: [{ type: "text", text: `Saved Chrome screenshot to ${outputPath}` }],
+					details: { path: outputPath, format, tab: result.tab },
 				};
-			}
-			if (!result.dataUrl) throw new Error("Screenshot returned no dataUrl");
-			const base64 = result.dataUrl.replace(/^data:image\/(?:png|jpeg);base64,/, "");
-			await writeFile(outputPath, Buffer.from(base64, "base64"));
-			return { content: [{ type: "text", text: `Saved Chrome screenshot to ${outputPath}` }], details: { path: outputPath, format, tab: result.tab } };
-		},
-	});
+			},
+		});
 
-	pi.registerTool({
-		name: "chrome_hover",
-		label: "Chrome Hover",
-		description: "Hover over an element by uid, selector, or x/y using Chrome pointer movement.",
-		promptSnippet: "Hover a Chrome element to trigger :hover / mouseover handlers.",
-		parameters: Type.Object({
-			uid: Type.Optional(Type.String()),
-			selector: Type.Optional(Type.String()),
-			x: Type.Optional(Type.Number()),
-			y: Type.Optional(Type.Number()),
-			targetId: Type.Optional(Type.String()),
-			urlIncludes: Type.Optional(Type.String()),
-			titleIncludes: Type.Optional(Type.String()),
-			background: Type.Optional(Type.Boolean()),
-		}),
-		async execute(_id, params, signal): Promise<ToolTextResult> {
-			const result = await authorizedBridgeSend("page.hover", withBackground(params), DEFAULT_TIMEOUT_MS, signal);
-			return { content: [{ type: "text", text: `Hovered ${params.uid ?? params.selector ?? `${params.x},${params.y}`}` }], details: { result: result as Json } };
-		},
-	});
+		pi.registerTool({
+			name: "chrome_hover",
+			label: "Chrome Hover",
+			description: "Hover over an element by uid, selector, or x/y using Chrome pointer movement.",
+			promptSnippet: "Hover a Chrome element to trigger :hover / mouseover handlers.",
+			parameters: Type.Object({
+				uid: Type.Optional(Type.String()),
+				selector: Type.Optional(Type.String()),
+				x: Type.Optional(Type.Number()),
+				y: Type.Optional(Type.Number()),
+				targetId: Type.Optional(Type.String()),
+				urlIncludes: Type.Optional(Type.String()),
+				titleIncludes: Type.Optional(Type.String()),
+				background: Type.Optional(Type.Boolean()),
+			}),
+			async execute(_id, params, signal): Promise<ToolTextResult> {
+				const result = await authorizedBridgeSend("page.hover", withBackground(params), DEFAULT_TIMEOUT_MS, signal);
+				return {
+					content: [
+						{ type: "text", text: `Hovered ${params.uid ?? params.selector ?? `${params.x},${params.y}`}` },
+					],
+					details: { result: result as Json },
+				};
+			},
+		});
 
-	pi.registerTool({
-		name: "chrome_drag",
-		label: "Chrome Drag",
-		description: "Drag from one uid/selector/point to another using Chrome pointer input.",
-		promptSnippet: "Drag a Chrome element from one point to another.",
-		parameters: Type.Object({
-			fromUid: Type.Optional(Type.String()),
-			fromSelector: Type.Optional(Type.String()),
-			fromX: Type.Optional(Type.Number()),
-			fromY: Type.Optional(Type.Number()),
-			toUid: Type.Optional(Type.String()),
-			toSelector: Type.Optional(Type.String()),
-			toX: Type.Optional(Type.Number()),
-			toY: Type.Optional(Type.Number()),
-			steps: Type.Optional(Type.Number({ default: 12 })),
-			targetId: Type.Optional(Type.String()),
-			urlIncludes: Type.Optional(Type.String()),
-			titleIncludes: Type.Optional(Type.String()),
-			background: Type.Optional(Type.Boolean()),
-		}),
-		async execute(_id, params, signal): Promise<ToolTextResult> {
-			const result = await authorizedBridgeSend("page.drag", withBackground(params), DEFAULT_TIMEOUT_MS, signal);
-			return { content: [{ type: "text", text: `Dragged from ${params.fromUid ?? params.fromSelector} to ${params.toUid ?? params.toSelector}` }], details: { result: result as Json } };
-		},
-	});
+		pi.registerTool({
+			name: "chrome_drag",
+			label: "Chrome Drag",
+			description: "Drag from one uid/selector/point to another using Chrome pointer input.",
+			promptSnippet: "Drag a Chrome element from one point to another.",
+			parameters: Type.Object({
+				fromUid: Type.Optional(Type.String()),
+				fromSelector: Type.Optional(Type.String()),
+				fromX: Type.Optional(Type.Number()),
+				fromY: Type.Optional(Type.Number()),
+				toUid: Type.Optional(Type.String()),
+				toSelector: Type.Optional(Type.String()),
+				toX: Type.Optional(Type.Number()),
+				toY: Type.Optional(Type.Number()),
+				steps: Type.Optional(Type.Number({ default: 12 })),
+				targetId: Type.Optional(Type.String()),
+				urlIncludes: Type.Optional(Type.String()),
+				titleIncludes: Type.Optional(Type.String()),
+				background: Type.Optional(Type.Boolean()),
+			}),
+			async execute(_id, params, signal): Promise<ToolTextResult> {
+				const result = await authorizedBridgeSend("page.drag", withBackground(params), DEFAULT_TIMEOUT_MS, signal);
+				return {
+					content: [
+						{
+							type: "text",
+							text: `Dragged from ${params.fromUid ?? params.fromSelector} to ${params.toUid ?? params.toSelector}`,
+						},
+					],
+					details: { result: result as Json },
+				};
+			},
+		});
 
-	pi.registerTool({
-		name: "chrome_tap",
-		label: "Chrome Tap (Touch)",
-		description:
-			"Dispatch a real touchstart/touchend tap through Chrome's input layer. Use for sites that gate on TouchEvent rather than MouseEvent (mobile-first PWAs, swipe carousels). Chrome may show its debugging banner while attached.",
-		promptSnippet: "Tap (real touch) a Chrome element by snapshot uid, selector, or coordinate.",
-		parameters: Type.Object({
-			uid: Type.Optional(Type.String()),
-			selector: Type.Optional(Type.String()),
-			x: Type.Optional(Type.Number()),
-			y: Type.Optional(Type.Number()),
-			targetId: Type.Optional(Type.String()),
-			urlIncludes: Type.Optional(Type.String()),
-			titleIncludes: Type.Optional(Type.String()),
-			background: Type.Optional(Type.Boolean()),
-		}),
-		async execute(_id, params, signal): Promise<ToolTextResult> {
-			const result = await authorizedBridgeSend("page.tap", withBackground(params), DEFAULT_TIMEOUT_MS, signal);
-			const target = params.uid ?? params.selector ?? `${params.x},${params.y}`;
-			return { content: [{ type: "text", text: `Tapped ${target} (touch)` }], details: { result: result as Json } };
-		},
-	});
+		pi.registerTool({
+			name: "chrome_tap",
+			label: "Chrome Tap (Touch)",
+			description:
+				"Dispatch a real touchstart/touchend tap through Chrome's input layer. Use for sites that gate on TouchEvent rather than MouseEvent (mobile-first PWAs, swipe carousels). Chrome may show its debugging banner while attached.",
+			promptSnippet: "Tap (real touch) a Chrome element by snapshot uid, selector, or coordinate.",
+			parameters: Type.Object({
+				uid: Type.Optional(Type.String()),
+				selector: Type.Optional(Type.String()),
+				x: Type.Optional(Type.Number()),
+				y: Type.Optional(Type.Number()),
+				targetId: Type.Optional(Type.String()),
+				urlIncludes: Type.Optional(Type.String()),
+				titleIncludes: Type.Optional(Type.String()),
+				background: Type.Optional(Type.Boolean()),
+			}),
+			async execute(_id, params, signal): Promise<ToolTextResult> {
+				const result = await authorizedBridgeSend("page.tap", withBackground(params), DEFAULT_TIMEOUT_MS, signal);
+				const target = params.uid ?? params.selector ?? `${params.x},${params.y}`;
+				return {
+					content: [{ type: "text", text: `Tapped ${target} (touch)` }],
+					details: { result: result as Json },
+				};
+			},
+		});
 
-	pi.registerTool({
-		name: "chrome_scroll",
-		label: "Chrome Scroll",
-		description: "Scroll the page or a specific scrollable element by dispatching real wheel events with momentum-shaped deltas, then applying the scroll. Positive deltaY scrolls down. Pass uid/selector to scroll within a container, otherwise the document scrolls.",
-		promptSnippet: "Scroll a Chrome page or container via wheel events (not raw scrollTop).",
-		parameters: Type.Object({
-			uid: Type.Optional(Type.String()),
-			selector: Type.Optional(Type.String()),
-			deltaY: Type.Optional(Type.Number({ description: "Pixels to scroll vertically. Positive = down." })),
-			deltaX: Type.Optional(Type.Number({ description: "Pixels to scroll horizontally. Positive = right." })),
-			steps: Type.Optional(Type.Number({ description: "Number of wheel events to dispatch. Defaults to ceil(|deltaY|/100)." })),
-			targetId: Type.Optional(Type.String()),
-			urlIncludes: Type.Optional(Type.String()),
-			titleIncludes: Type.Optional(Type.String()),
-			background: Type.Optional(Type.Boolean()),
-		}),
-		async execute(_id, params, signal): Promise<ToolTextResult> {
-			const result = await authorizedBridgeSend("page.scroll", withBackground(params), DEFAULT_TIMEOUT_MS, signal);
-			return { content: [{ type: "text", text: `Scrolled dy=${params.deltaY ?? 0} dx=${params.deltaX ?? 0}` }], details: { result: result as Json } };
-		},
-	});
+		pi.registerTool({
+			name: "chrome_scroll",
+			label: "Chrome Scroll",
+			description:
+				"Scroll the page or a specific scrollable element by dispatching real wheel events with momentum-shaped deltas, then applying the scroll. Positive deltaY scrolls down. Pass uid/selector to scroll within a container, otherwise the document scrolls.",
+			promptSnippet: "Scroll a Chrome page or container via wheel events (not raw scrollTop).",
+			parameters: Type.Object({
+				uid: Type.Optional(Type.String()),
+				selector: Type.Optional(Type.String()),
+				deltaY: Type.Optional(Type.Number({ description: "Pixels to scroll vertically. Positive = down." })),
+				deltaX: Type.Optional(Type.Number({ description: "Pixels to scroll horizontally. Positive = right." })),
+				steps: Type.Optional(
+					Type.Number({ description: "Number of wheel events to dispatch. Defaults to ceil(|deltaY|/100)." }),
+				),
+				targetId: Type.Optional(Type.String()),
+				urlIncludes: Type.Optional(Type.String()),
+				titleIncludes: Type.Optional(Type.String()),
+				background: Type.Optional(Type.Boolean()),
+			}),
+			async execute(_id, params, signal): Promise<ToolTextResult> {
+				const result = await authorizedBridgeSend(
+					"page.scroll",
+					withBackground(params),
+					DEFAULT_TIMEOUT_MS,
+					signal,
+				);
+				return {
+					content: [{ type: "text", text: `Scrolled dy=${params.deltaY ?? 0} dx=${params.deltaX ?? 0}` }],
+					details: { result: result as Json },
+				};
+			},
+		});
 
-	pi.registerTool({
-		name: "chrome_upload_file",
-		label: "Chrome Upload File",
-		description: "Attach local files to an <input type=file> element using Chrome DevTools file-input control. Does NOT open the native file picker; works with React/Vue/Angular controlled inputs.",
-		promptSnippet: "Attach local files to a Chrome <input type=file> without opening the native file picker.",
-		parameters: Type.Object({
-			uid: Type.Optional(Type.String()),
-			selector: Type.Optional(Type.String()),
-			paths: Type.Array(Type.String(), { description: "Local absolute file paths to upload." }),
-			targetId: Type.Optional(Type.String()),
-			urlIncludes: Type.Optional(Type.String()),
-			titleIncludes: Type.Optional(Type.String()),
-			background: Type.Optional(Type.Boolean()),
-		}),
-		async execute(_id, params, signal, _onUpdate, ctx): Promise<ToolTextResult> {
-			const cwd = workspaceCwd(ctx);
-			const paths = params.paths.map((p) => resolve(cwd, p));
-			const result = await authorizedBridgeSend("page.upload", withBackground({ ...params, paths }), DEFAULT_TIMEOUT_MS, signal);
-			return { content: [{ type: "text", text: `Uploaded ${paths.length} file(s) to ${params.uid ?? params.selector}` }], details: { result: result as Json } };
-		},
-	});
+		pi.registerTool({
+			name: "chrome_upload_file",
+			label: "Chrome Upload File",
+			description:
+				"Attach local files to an <input type=file> element using Chrome DevTools file-input control. Does NOT open the native file picker; works with React/Vue/Angular controlled inputs.",
+			promptSnippet: "Attach local files to a Chrome <input type=file> without opening the native file picker.",
+			parameters: Type.Object({
+				uid: Type.Optional(Type.String()),
+				selector: Type.Optional(Type.String()),
+				paths: Type.Array(Type.String(), { description: "Local absolute file paths to upload." }),
+				targetId: Type.Optional(Type.String()),
+				urlIncludes: Type.Optional(Type.String()),
+				titleIncludes: Type.Optional(Type.String()),
+				background: Type.Optional(Type.Boolean()),
+			}),
+			async execute(_id, params, signal, _onUpdate, ctx): Promise<ToolTextResult> {
+				const cwd = workspaceCwd(ctx);
+				const paths = params.paths.map((p) => resolve(cwd, p));
+				const result = await authorizedBridgeSend(
+					"page.upload",
+					withBackground({ ...params, paths }),
+					DEFAULT_TIMEOUT_MS,
+					signal,
+				);
+				return {
+					content: [
+						{ type: "text", text: `Uploaded ${paths.length} file(s) to ${params.uid ?? params.selector}` },
+					],
+					details: { result: result as Json },
+				};
+			},
+		});
 	}
-
 }