@narumitw/pi-chrome-devtools 0.53.1 → 0.53.3

package/src/menu.ts

@@ -1,24 +1,19 @@
 import type { ExtensionAPI, ExtensionCommandContext } from "@earendil-works/pi-coding-agent";
 import { defineMenu, runMenu, runTask } from "@narumitw/pi-tui-kit";
-import {
-	browserLifecycleState,
-	devToolsEndpoint,
-	launchAttemptLines,
-	launchModeLabel,
-} from "./browser-manager.js";
+import { browserLifecycleState, devToolsEndpoint, launchAttemptLines, launchModeLabel } from "./browser-manager.js";
 import { availableChromeDevtoolsTools } from "./lazy-tools.js";
 import { state, webMcpEnabled } from "./runtime.js";
 import { loadSettings, type SettingsLoadResult } from "./settings.js";
 import {
-	CHROME_DEVTOOLS_TOOL_NAMES,
-	type ChromeDevToolsToolName,
-	CORE_CHROME_DEVTOOLS_TOOL_NAMES,
+  CHROME_DEVTOOLS_TOOL_NAMES,
+  type ChromeDevToolsToolName,
+  CORE_CHROME_DEVTOOLS_TOOL_NAMES,
 } from "./tool-names.js";
 import {
-	buildBrowserStatusMessage,
-	buildCommandGuide,
-	sanitizeChromeDevtoolsDisplay,
-	setSelectedChromeDevtoolsTools,
+  buildBrowserStatusMessage,
+  buildCommandGuide,
+  sanitizeChromeDevtoolsDisplay,
+  setSelectedChromeDevtoolsTools,
 } from "./tool-selector.js";
 
 type CommandContext = ExtensionCommandContext;
@@ -28,497 +23,465 @@ type ToolScreen = "tools" | "review";
 type ToolAction = "toggle" | "selectAll" | "selectNone" | "review" | "apply" | "cancel";
 
 interface MenuSnapshot {
-	activeTools: ChromeDevToolsToolName[];
-	persistenceLabel: string;
-	mutationBlockedReason?: string;
-	settingsWarning?: string;
+  activeTools: ChromeDevToolsToolName[];
+  persistenceLabel: string;
+  mutationBlockedReason?: string;
+  settingsWarning?: string;
 }
 
 interface ToolWorkflowState {
-	accepted: Set<ChromeDevToolsToolName>;
-	draft: Set<ChromeDevToolsToolName>;
-	mutationBlockedReason?: string;
-	generation: number;
-	applied: boolean;
+  accepted: Set<ChromeDevToolsToolName>;
+  draft: Set<ChromeDevToolsToolName>;
+  mutationBlockedReason?: string;
+  generation: number;
+  applied: boolean;
 }
 
 const TOOL_PRESENTATION: Record<ChromeDevToolsToolName, { label: string; description: string }> = {
-	chrome_devtools_list_pages: {
-		label: "List open pages",
-		description: "List inspectable Chrome tabs and pages (chrome_devtools_list_pages).",
-	},
-	chrome_devtools_select_page: {
-		label: "Select the active page",
-		description: "Choose the page later browser actions use (chrome_devtools_select_page).",
-	},
-	chrome_devtools_navigate: {
-		label: "Navigate a page",
-		description: "Open a URL, creating a page when needed (chrome_devtools_navigate).",
-	},
-	chrome_devtools_evaluate: {
-		label: "Run JavaScript",
-		description: "Evaluate JavaScript in the selected page (chrome_devtools_evaluate).",
-	},
-	chrome_devtools_screenshot: {
-		label: "Capture a screenshot",
-		description: "Save a PNG of the selected page (chrome_devtools_screenshot).",
-	},
-	chrome_devtools_webmcp_list_tools: {
-		label: "List page WebMCP tools · Experimental",
-		description: "Discover page-provided WebMCP capabilities (chrome_devtools_webmcp_list_tools).",
-	},
-	chrome_devtools_webmcp_call_tool: {
-		label: "Call a page WebMCP tool · Experimental",
-		description: "Invoke a listed page tool after confirmation (chrome_devtools_webmcp_call_tool).",
-	},
+  chrome_devtools_list_pages: {
+    label: "List open pages",
+    description: "List inspectable Chrome tabs and pages (chrome_devtools_list_pages).",
+  },
+  chrome_devtools_select_page: {
+    label: "Select the active page",
+    description: "Choose the page later browser actions use (chrome_devtools_select_page).",
+  },
+  chrome_devtools_navigate: {
+    label: "Navigate a page",
+    description: "Open a URL, creating a page when needed (chrome_devtools_navigate).",
+  },
+  chrome_devtools_evaluate: {
+    label: "Run JavaScript",
+    description: "Evaluate JavaScript in the selected page (chrome_devtools_evaluate).",
+  },
+  chrome_devtools_screenshot: {
+    label: "Capture a screenshot",
+    description: "Save a PNG of the selected page (chrome_devtools_screenshot).",
+  },
+  chrome_devtools_webmcp_list_tools: {
+    label: "List page WebMCP tools · Experimental",
+    description: "Discover page-provided WebMCP capabilities (chrome_devtools_webmcp_list_tools).",
+  },
+  chrome_devtools_webmcp_call_tool: {
+    label: "Call a page WebMCP tool · Experimental",
+    description: "Invoke a listed page tool after confirmation (chrome_devtools_webmcp_call_tool).",
+  },
 };
 
-export async function showChromeDevtoolsMenu(
-	pi: ExtensionAPI,
-	ctx: CommandContext,
-	generation: number,
-) {
-	const snapshot = await loadSnapshotWithFeedback(pi, ctx, generation);
-	if (!snapshot) return;
-	const menuSignal = state.sessionController.signal;
-	const isCurrent = () => generation === state.sessionGeneration && !menuSignal.aborted;
-	const menu = defineMenu<MenuSnapshot, MainScreen, MainAction>({
-		start: "main",
-		screens: {
-			main: ({ state: current }) => ({
-				kind: "actions",
-				title: "Chrome DevTools",
-				lines: mainStateLines(current, ctx.sessionManager),
-				items: [
-					{
-						id: "tools",
-						label: "Choose available browser tools…",
-						description: "Choose which capabilities the loader may expose.",
-						disabled: Boolean(current.mutationBlockedReason),
-						disabledReason: current.mutationBlockedReason,
-						action: "tools",
-					},
-					{
-						id: "bulk",
-						label:
-							current.activeTools.length === availableCatalogNames(ctx.sessionManager).length
-								? "Make all browser tools unavailable…"
-								: "Make all browser tools available…",
-						description:
-							current.activeTools.length === availableCatalogNames(ctx.sessionManager).length
-								? `Preview 0 of ${availableCatalogNames(ctx.sessionManager).length}; other active tools stay enabled.`
-								: `Preview ${availableCatalogNames(ctx.sessionManager).length} of ${availableCatalogNames(ctx.sessionManager).length}; other active tools stay enabled.`,
-						disabled: Boolean(current.mutationBlockedReason),
-						disabledReason: current.mutationBlockedReason,
-						action: "bulk",
-					},
-					{
-						id: "browser-status",
-						label: "Browser status",
-						description: "Runtime, endpoint, and last launch attempt.",
-						to: "browserStatus",
-					},
-					{
-						id: "settings",
-						label: "Browser settings",
-						description: "Edit endpoint, auto-launch, and browser executable settings.",
-						action: "settings",
-					},
-					{
-						id: "help",
-						label: "Help",
-						description: "Commands and usage.",
-						to: "help",
-					},
-				],
-				hint: "close",
-			}),
-			browserStatus: () => ({
-				kind: "review",
-				title: "Browser status",
-				content: buildBrowserStatusMessage(ctx.sessionManager),
-				format: { kind: "text" },
-				viewportSize: "adaptive",
-				hint: "back",
-			}),
-			help: () => ({
-				kind: "review",
-				title: "Chrome DevTools help",
-				content: buildCommandGuide(ctx.sessionManager),
-				format: { kind: "text" },
-				viewportSize: "adaptive",
-				hint: "back",
-			}),
-		},
-		actions: {
-			tools: async ({ state: current }) => {
-				const result = await showChromeDevtoolsToolWorkflow(pi, ctx, generation, {
-					snapshot: current,
-				});
-				if (result?.applied && isCurrent()) updateSnapshotAfterApply(current, result.selectedTools);
-				return result?.closeParent ? { kind: "close" } : { kind: "stay" };
-			},
-			bulk: async ({ state: current }) => {
-				const selectedTools =
-					current.activeTools.length === availableCatalogNames(ctx.sessionManager).length
-						? []
-						: availableCatalogNames(ctx.sessionManager);
-				const result = await showChromeDevtoolsToolWorkflow(pi, ctx, generation, {
-					snapshot: current,
-					initialDraft: selectedTools,
-					startAtReview: true,
-				});
-				if (result?.applied && isCurrent()) updateSnapshotAfterApply(current, result.selectedTools);
-				return result?.closeParent ? { kind: "close" } : { kind: "stay" };
-			},
-			settings: async ({ state: current }) => {
-				const { showChromeDevtoolsBrowserSettings } = await import("./browser-settings-menu.js");
-				if (!isCurrent()) return { kind: "stay" };
-				const result = await showChromeDevtoolsBrowserSettings(pi, ctx, generation);
-				if (!isCurrent()) return { kind: "stay" };
-				const refreshed = await loadChromeDevtoolsMenuSnapshot(pi, ctx);
-				if (!isCurrent()) return { kind: "stay" };
-				Object.assign(current, refreshed);
-				return result.closeParent ? { kind: "close" } : { kind: "stay" };
-			},
-		},
-	});
-	await runMenu(ctx, menu, {
-		getState: () => snapshot,
-		signal: menuSignal,
-		isCurrent,
-		onError: (currentCtx, error) =>
-			currentCtx.ui.notify(
-				sanitizeChromeDevtoolsDisplay(`Chrome DevTools menu failed: ${formatError(error)}`),
-				"error",
-			),
-	});
+export async function showChromeDevtoolsMenu(pi: ExtensionAPI, ctx: CommandContext, generation: number) {
+  const snapshot = await loadSnapshotWithFeedback(pi, ctx, generation);
+  if (!snapshot) return;
+  const menuSignal = state.sessionController.signal;
+  const isCurrent = () => generation === state.sessionGeneration && !menuSignal.aborted;
+  const menu = defineMenu<MenuSnapshot, MainScreen, MainAction>({
+    start: "main",
+    screens: {
+      main: ({ state: current }) => ({
+        kind: "actions",
+        title: "Chrome DevTools",
+        lines: mainStateLines(current, ctx.sessionManager),
+        items: [
+          {
+            id: "tools",
+            label: "Choose available browser tools…",
+            description: "Choose which capabilities the loader may expose.",
+            disabled: Boolean(current.mutationBlockedReason),
+            disabledReason: current.mutationBlockedReason,
+            action: "tools",
+          },
+          {
+            id: "bulk",
+            label:
+              current.activeTools.length === availableCatalogNames(ctx.sessionManager).length
+                ? "Make all browser tools unavailable…"
+                : "Make all browser tools available…",
+            description:
+              current.activeTools.length === availableCatalogNames(ctx.sessionManager).length
+                ? `Preview 0 of ${availableCatalogNames(ctx.sessionManager).length}; other active tools stay enabled.`
+                : `Preview ${availableCatalogNames(ctx.sessionManager).length} of ${availableCatalogNames(ctx.sessionManager).length}; other active tools stay enabled.`,
+            disabled: Boolean(current.mutationBlockedReason),
+            disabledReason: current.mutationBlockedReason,
+            action: "bulk",
+          },
+          {
+            id: "browser-status",
+            label: "Browser status",
+            description: "Runtime, endpoint, and last launch attempt.",
+            to: "browserStatus",
+          },
+          {
+            id: "settings",
+            label: "Browser settings",
+            description: "Edit endpoint, auto-launch, and browser executable settings.",
+            action: "settings",
+          },
+          {
+            id: "help",
+            label: "Help",
+            description: "Commands and usage.",
+            to: "help",
+          },
+        ],
+        hint: "close",
+      }),
+      browserStatus: () => ({
+        kind: "review",
+        title: "Browser status",
+        content: buildBrowserStatusMessage(ctx.sessionManager),
+        format: { kind: "text" },
+        viewportSize: "adaptive",
+        hint: "back",
+      }),
+      help: () => ({
+        kind: "review",
+        title: "Chrome DevTools help",
+        content: buildCommandGuide(ctx.sessionManager),
+        format: { kind: "text" },
+        viewportSize: "adaptive",
+        hint: "back",
+      }),
+    },
+    actions: {
+      tools: async ({ state: current }) => {
+        const result = await showChromeDevtoolsToolWorkflow(pi, ctx, generation, {
+          snapshot: current,
+        });
+        if (result?.applied && isCurrent()) updateSnapshotAfterApply(current, result.selectedTools);
+        return result?.closeParent ? { kind: "close" } : { kind: "stay" };
+      },
+      bulk: async ({ state: current }) => {
+        const selectedTools =
+          current.activeTools.length === availableCatalogNames(ctx.sessionManager).length
+            ? []
+            : availableCatalogNames(ctx.sessionManager);
+        const result = await showChromeDevtoolsToolWorkflow(pi, ctx, generation, {
+          snapshot: current,
+          initialDraft: selectedTools,
+          startAtReview: true,
+        });
+        if (result?.applied && isCurrent()) updateSnapshotAfterApply(current, result.selectedTools);
+        return result?.closeParent ? { kind: "close" } : { kind: "stay" };
+      },
+      settings: async ({ state: current }) => {
+        const { showChromeDevtoolsBrowserSettings } = await import("./browser-settings-menu.js");
+        if (!isCurrent()) return { kind: "stay" };
+        const result = await showChromeDevtoolsBrowserSettings(pi, ctx, generation);
+        if (!isCurrent()) return { kind: "stay" };
+        const refreshed = await loadChromeDevtoolsMenuSnapshot(pi, ctx);
+        if (!isCurrent()) return { kind: "stay" };
+        Object.assign(current, refreshed);
+        return result.closeParent ? { kind: "close" } : { kind: "stay" };
+      },
+    },
+  });
+  await runMenu(ctx, menu, {
+    getState: () => snapshot,
+    signal: menuSignal,
+    isCurrent,
+    onError: (currentCtx, error) =>
+      currentCtx.ui.notify(
+        sanitizeChromeDevtoolsDisplay(`Chrome DevTools menu failed: ${formatError(error)}`),
+        "error",
+      ),
+  });
 }
 
 export async function showChromeDevtoolsToolWorkflow(
-	pi: ExtensionAPI,
-	ctx: CommandContext,
-	generation: number,
-	options: {
-		snapshot?: MenuSnapshot;
-		initialDraft?: readonly ChromeDevToolsToolName[];
-		startAtReview?: boolean;
-	} = {},
-): Promise<
-	{ applied: boolean; closeParent: boolean; selectedTools: ChromeDevToolsToolName[] } | undefined
-> {
-	const snapshot = options.snapshot ?? (await loadSnapshotWithFeedback(pi, ctx, generation));
-	if (!snapshot) return undefined;
-	const menuSignal = state.sessionController.signal;
-	const isCurrent = () => generation === state.sessionGeneration && !menuSignal.aborted;
-	const accepted = new Set(snapshot.activeTools);
-	const workflow: ToolWorkflowState = {
-		accepted,
-		draft: new Set(options.initialDraft ?? snapshot.activeTools),
-		mutationBlockedReason: snapshot.mutationBlockedReason,
-		generation,
-		applied: false,
-	};
-	const menu = defineMenu<ToolWorkflowState, ToolScreen, ToolAction>({
-		start: options.startAtReview ? "review" : "tools",
-		screens: {
-			tools: ({ state: current }) => ({
-				kind: "multiSelect",
-				title: `Browser tools (${current.draft.size}/${availableCatalogNames(ctx.sessionManager).length})`,
-				lines: toolDraftLines(current, ctx.sessionManager),
-				items: availableCatalogNames(ctx.sessionManager).map((toolName) => ({
-					id: toolName,
-					label: TOOL_PRESENTATION[toolName].label,
-					description: TOOL_PRESENTATION[toolName].description,
-					searchText: `${toolName} ${TOOL_PRESENTATION[toolName].description}`,
-					selected: current.draft.has(toolName),
-					disabled: Boolean(current.mutationBlockedReason),
-					disabledReason: current.mutationBlockedReason,
-				})),
-				action: "toggle",
-				actions: [
-					{
-						id: "select-all",
-						label: "Select all",
-						disabled: Boolean(current.mutationBlockedReason),
-						disabledReason: current.mutationBlockedReason,
-						action: "selectAll",
-					},
-					{
-						id: "select-none",
-						label: "Select none",
-						disabled: Boolean(current.mutationBlockedReason),
-						disabledReason: current.mutationBlockedReason,
-						action: "selectNone",
-					},
-					{
-						id: "review",
-						label: "Review changes…",
-						disabled:
-							Boolean(current.mutationBlockedReason) || setsEqual(current.accepted, current.draft),
-						disabledReason:
-							current.mutationBlockedReason ??
-							(setsEqual(current.accepted, current.draft) ? "No unapplied changes" : undefined),
-						to: "review",
-					},
-					{ id: "cancel", label: "Cancel", action: "cancel" },
-				],
-				hint: "back",
-			}),
-			review: ({ state: current }) => ({
-				kind: "review",
-				title: "Review tool changes",
-				lines: [
-					`Currently available: ${current.accepted.size}/${availableCatalogNames(ctx.sessionManager).length}`,
-					`Proposed availability: ${current.draft.size}/${availableCatalogNames(ctx.sessionManager).length}`,
-				],
-				content: buildToolReview(current, ctx.sessionManager),
-				format: { kind: "text" },
-				viewportSize: "adaptive",
-				...(current.mutationBlockedReason || setsEqual(current.accepted, current.draft)
-					? {}
-					: {
-							confirm: {
-								id: "apply",
-								label: "Apply tool changes",
-								action: "apply" as const,
-							},
-						}),
-				hint: "back",
-			}),
-		},
-		actions: {
-			toggle: ({ state: current, itemId, selected }) => {
-				if (!isChromeDevtoolsToolName(itemId) || selected === undefined)
-					return { kind: "rejected" };
-				if (selected) current.draft.add(itemId);
-				else current.draft.delete(itemId);
-				return { kind: "stay" };
-			},
-			selectAll: ({ state: current }) => {
-				current.draft = new Set(availableCatalogNames(ctx.sessionManager));
-				return { kind: "stay" };
-			},
-			selectNone: ({ state: current }) => {
-				current.draft = new Set();
-				return { kind: "stay" };
-			},
-			review: () => ({ kind: "to", screen: "review" }),
-			cancel: () => ({ kind: "back" }),
-			apply: async ({ state: current, signal }) => {
-				await ctx.waitForIdle();
-				if (signal.aborted || !isCurrent() || current.generation !== state.sessionGeneration) {
-					return { kind: "rejected" };
-				}
-				const selectedTools = orderedTools(current.draft);
-				const saveResult = await setSelectedChromeDevtoolsTools(
-					pi,
-					ctx,
-					selectedTools,
-					orderedTools(current.accepted),
-				);
-				if (!isCurrent()) return { kind: "rejected" };
-				if (saveResult === "active-tools-changed") {
-					current.accepted = new Set(activeChromeTools(pi));
-				}
-				if (saveResult !== "saved") return { kind: "rejected" };
-				current.accepted = new Set(selectedTools);
-				current.draft = new Set(selectedTools);
-				current.applied = true;
-				ctx.ui.notify(
-					`Saved: ${selectedTools.length} of ${availableCatalogNames(ctx.sessionManager).length} browser tools available.`,
-					"info",
-				);
-				return { kind: "close" };
-			},
-		},
-	});
-	const result = await runMenu(ctx, menu, {
-		getState: () => workflow,
-		signal: menuSignal,
-		isCurrent,
-		onError: (currentCtx, error) =>
-			currentCtx.ui.notify(
-				sanitizeChromeDevtoolsDisplay(
-					`Chrome DevTools tool selection failed: ${formatError(error)}`,
-				),
-				"error",
-			),
-	});
-	return {
-		applied: workflow.applied,
-		closeParent: !workflow.applied && result.kind === "closed" && result.reason === "close",
-		selectedTools: orderedTools(workflow.accepted),
-	};
+  pi: ExtensionAPI,
+  ctx: CommandContext,
+  generation: number,
+  options: {
+    snapshot?: MenuSnapshot;
+    initialDraft?: readonly ChromeDevToolsToolName[];
+    startAtReview?: boolean;
+  } = {},
+): Promise<{ applied: boolean; closeParent: boolean; selectedTools: ChromeDevToolsToolName[] } | undefined> {
+  const snapshot = options.snapshot ?? (await loadSnapshotWithFeedback(pi, ctx, generation));
+  if (!snapshot) return undefined;
+  const menuSignal = state.sessionController.signal;
+  const isCurrent = () => generation === state.sessionGeneration && !menuSignal.aborted;
+  const accepted = new Set(snapshot.activeTools);
+  const workflow: ToolWorkflowState = {
+    accepted,
+    draft: new Set(options.initialDraft ?? snapshot.activeTools),
+    mutationBlockedReason: snapshot.mutationBlockedReason,
+    generation,
+    applied: false,
+  };
+  const menu = defineMenu<ToolWorkflowState, ToolScreen, ToolAction>({
+    start: options.startAtReview ? "review" : "tools",
+    screens: {
+      tools: ({ state: current }) => ({
+        kind: "multiSelect",
+        title: `Browser tools (${current.draft.size}/${availableCatalogNames(ctx.sessionManager).length})`,
+        lines: toolDraftLines(current, ctx.sessionManager),
+        items: availableCatalogNames(ctx.sessionManager).map((toolName) => ({
+          id: toolName,
+          label: TOOL_PRESENTATION[toolName].label,
+          description: TOOL_PRESENTATION[toolName].description,
+          searchText: `${toolName} ${TOOL_PRESENTATION[toolName].description}`,
+          selected: current.draft.has(toolName),
+          disabled: Boolean(current.mutationBlockedReason),
+          disabledReason: current.mutationBlockedReason,
+        })),
+        action: "toggle",
+        actions: [
+          {
+            id: "select-all",
+            label: "Select all",
+            disabled: Boolean(current.mutationBlockedReason),
+            disabledReason: current.mutationBlockedReason,
+            action: "selectAll",
+          },
+          {
+            id: "select-none",
+            label: "Select none",
+            disabled: Boolean(current.mutationBlockedReason),
+            disabledReason: current.mutationBlockedReason,
+            action: "selectNone",
+          },
+          {
+            id: "review",
+            label: "Review changes…",
+            disabled: Boolean(current.mutationBlockedReason) || setsEqual(current.accepted, current.draft),
+            disabledReason:
+              current.mutationBlockedReason ??
+              (setsEqual(current.accepted, current.draft) ? "No unapplied changes" : undefined),
+            to: "review",
+          },
+          { id: "cancel", label: "Cancel", action: "cancel" },
+        ],
+        hint: "back",
+      }),
+      review: ({ state: current }) => ({
+        kind: "review",
+        title: "Review tool changes",
+        lines: [
+          `Currently available: ${current.accepted.size}/${availableCatalogNames(ctx.sessionManager).length}`,
+          `Proposed availability: ${current.draft.size}/${availableCatalogNames(ctx.sessionManager).length}`,
+        ],
+        content: buildToolReview(current, ctx.sessionManager),
+        format: { kind: "text" },
+        viewportSize: "adaptive",
+        ...(current.mutationBlockedReason || setsEqual(current.accepted, current.draft)
+          ? {}
+          : {
+              confirm: {
+                id: "apply",
+                label: "Apply tool changes",
+                action: "apply" as const,
+              },
+            }),
+        hint: "back",
+      }),
+    },
+    actions: {
+      toggle: ({ state: current, itemId, selected }) => {
+        if (!isChromeDevtoolsToolName(itemId) || selected === undefined) return { kind: "rejected" };
+        if (selected) current.draft.add(itemId);
+        else current.draft.delete(itemId);
+        return { kind: "stay" };
+      },
+      selectAll: ({ state: current }) => {
+        current.draft = new Set(availableCatalogNames(ctx.sessionManager));
+        return { kind: "stay" };
+      },
+      selectNone: ({ state: current }) => {
+        current.draft = new Set();
+        return { kind: "stay" };
+      },
+      review: () => ({ kind: "to", screen: "review" }),
+      cancel: () => ({ kind: "back" }),
+      apply: async ({ state: current, signal }) => {
+        await ctx.waitForIdle();
+        if (signal.aborted || !isCurrent() || current.generation !== state.sessionGeneration) {
+          return { kind: "rejected" };
+        }
+        const selectedTools = orderedTools(current.draft);
+        const saveResult = await setSelectedChromeDevtoolsTools(pi, ctx, selectedTools, orderedTools(current.accepted));
+        if (!isCurrent()) return { kind: "rejected" };
+        if (saveResult === "active-tools-changed") {
+          current.accepted = new Set(activeChromeTools(pi));
+        }
+        if (saveResult !== "saved") return { kind: "rejected" };
+        current.accepted = new Set(selectedTools);
+        current.draft = new Set(selectedTools);
+        current.applied = true;
+        ctx.ui.notify(
+          `Saved: ${selectedTools.length} of ${availableCatalogNames(ctx.sessionManager).length} browser tools available.`,
+          "info",
+        );
+        return { kind: "close" };
+      },
+    },
+  });
+  const result = await runMenu(ctx, menu, {
+    getState: () => workflow,
+    signal: menuSignal,
+    isCurrent,
+    onError: (currentCtx, error) =>
+      currentCtx.ui.notify(
+        sanitizeChromeDevtoolsDisplay(`Chrome DevTools tool selection failed: ${formatError(error)}`),
+        "error",
+      ),
+  });
+  return {
+    applied: workflow.applied,
+    closeParent: !workflow.applied && result.kind === "closed" && result.reason === "close",
+    selectedTools: orderedTools(workflow.accepted),
+  };
 }
 
 async function loadSnapshotWithFeedback(pi: ExtensionAPI, ctx: CommandContext, generation: number) {
-	const menuSignal = state.sessionController.signal;
-	const isCurrent = () => generation === state.sessionGeneration && !menuSignal.aborted;
-	const result = await runTask(ctx, {
-		label: "Loading Chrome DevTools settings…",
-		signal: menuSignal,
-		isCurrent,
-		task: async ({ signal }) => {
-			signal.throwIfAborted();
-			const settings = await loadSettings();
-			signal.throwIfAborted();
-			return buildMenuSnapshot(pi, settings);
-		},
-	});
-	return result.kind === "completed" ? result.value : undefined;
+  const menuSignal = state.sessionController.signal;
+  const isCurrent = () => generation === state.sessionGeneration && !menuSignal.aborted;
+  const result = await runTask(ctx, {
+    label: "Loading Chrome DevTools settings…",
+    signal: menuSignal,
+    isCurrent,
+    task: async ({ signal }) => {
+      signal.throwIfAborted();
+      const settings = await loadSettings();
+      signal.throwIfAborted();
+      return buildMenuSnapshot(pi, settings);
+    },
+  });
+  return result.kind === "completed" ? result.value : undefined;
 }
 
-export async function loadChromeDevtoolsMenuSnapshot(
-	pi: ExtensionAPI,
-	ctx: ExtensionCommandContext,
-) {
-	const settings = await loadSettings({
-		cwd: ctx.cwd,
-		projectTrusted: ctx.isProjectTrusted(),
-	});
-	return buildMenuSnapshot(pi, settings);
+export async function loadChromeDevtoolsMenuSnapshot(pi: ExtensionAPI, ctx: ExtensionCommandContext) {
+  const settings = await loadSettings({
+    cwd: ctx.cwd,
+    projectTrusted: ctx.isProjectTrusted(),
+  });
+  return buildMenuSnapshot(pi, settings);
 }
 
 function buildMenuSnapshot(pi: ExtensionAPI, settings: SettingsLoadResult): MenuSnapshot {
-	const activeTools = activeChromeTools(pi);
-	const persistedTools =
-		settings.kind === "loaded" && settings.settings.tools
-			? orderedTools(new Set(settings.settings.tools))
-			: undefined;
-	const persistenceLabel =
-		settings.kind === "invalid"
-			? "settings need repair"
-			: persistedTools === undefined
-				? "not saved"
-				: arraysEqual(activeTools, persistedTools)
-					? "saved"
-					: "runtime catalog differs from saved catalog";
-	const settingsWarning = [
-		...new Set([settings.notice, state.settingsNotice].filter(Boolean)),
-	].join("\n");
-	return {
-		activeTools,
-		persistenceLabel,
-		...(settings.kind === "invalid"
-			? { mutationBlockedReason: `Repair ${settings.reason} before saving` }
-			: {}),
-		...(settingsWarning ? { settingsWarning } : {}),
-	};
+  const activeTools = activeChromeTools(pi);
+  const persistedTools =
+    settings.kind === "loaded" && settings.settings.tools ? orderedTools(new Set(settings.settings.tools)) : undefined;
+  const persistenceLabel =
+    settings.kind === "invalid"
+      ? "settings need repair"
+      : persistedTools === undefined
+        ? "not saved"
+        : arraysEqual(activeTools, persistedTools)
+          ? "saved"
+          : "runtime catalog differs from saved catalog";
+  const settingsWarning = [...new Set([settings.notice, state.settingsNotice].filter(Boolean))].join("\n");
+  return {
+    activeTools,
+    persistenceLabel,
+    ...(settings.kind === "invalid" ? { mutationBlockedReason: `Repair ${settings.reason} before saving` } : {}),
+    ...(settingsWarning ? { settingsWarning } : {}),
+  };
 }
 
 function mainStateLines(snapshot: MenuSnapshot, owner: object) {
-	const launchError = launchAttemptLines(owner).find((line) =>
-		line.startsWith("Last launch error:"),
-	);
-	return sanitizeLines([
-		`Tool catalog: ${snapshot.activeTools.length} of ${availableCatalogNames(owner).length} available · ${snapshot.persistenceLabel}`,
-		`WebMCP: ${webMcpEnabled(owner) ? "enabled · experimental · confirmation required for every call" : "disabled · experimental"}`,
-		`Browser: ${browserLifecycleSummary(owner)}`,
-		`Endpoint: ${devToolsEndpoint(owner)}`,
-		...(snapshot.settingsWarning ? [`Settings warning: ${snapshot.settingsWarning}`] : []),
-		...(launchError ? [`Launch warning: ${launchError.slice("Last launch error: ".length)}`] : []),
-	]);
+  const launchError = launchAttemptLines(owner).find((line) => line.startsWith("Last launch error:"));
+  return sanitizeLines([
+    `Tool catalog: ${snapshot.activeTools.length} of ${availableCatalogNames(owner).length} available · ${snapshot.persistenceLabel}`,
+    `WebMCP: ${webMcpEnabled(owner) ? "enabled · experimental · confirmation required for every call" : "disabled · experimental"}`,
+    `Browser: ${browserLifecycleSummary(owner)}`,
+    `Endpoint: ${devToolsEndpoint(owner)}`,
+    ...(snapshot.settingsWarning ? [`Settings warning: ${snapshot.settingsWarning}`] : []),
+    ...(launchError ? [`Launch warning: ${launchError.slice("Last launch error: ".length)}`] : []),
+  ]);
 }
 
 function browserLifecycleSummary(owner: object) {
-	const lifecycle = browserLifecycleState(owner);
-	if (lifecycle === "starting") return "starting managed browser";
-	if (lifecycle === "running") return "managed browser running";
-	if (lifecycle === "exited") return "managed browser exited · open Browser status to recover";
-	if (lifecycle === "failed") return "last launch failed · open Browser status to recover";
-	const launchMode = launchModeLabel(owner);
-	return launchMode.startsWith("attach first")
-		? "not started · attaches or launches on first use"
-		: `not started · ${launchMode}`;
+  const lifecycle = browserLifecycleState(owner);
+  if (lifecycle === "starting") return "starting managed browser";
+  if (lifecycle === "running") return "managed browser running";
+  if (lifecycle === "exited") return "managed browser exited · open Browser status to recover";
+  if (lifecycle === "failed") return "last launch failed · open Browser status to recover";
+  const launchMode = launchModeLabel(owner);
+  return launchMode.startsWith("attach first")
+    ? "not started · attaches or launches on first use"
+    : `not started · ${launchMode}`;
 }
 
 function toolDraftLines(current: ToolWorkflowState, owner: object) {
-	if (current.mutationBlockedReason)
-		return sanitizeLines([`Unavailable: ${current.mutationBlockedReason}`]);
-	const changes = symmetricDifferenceSize(current.accepted, current.draft);
-	return [
-		`Currently available: ${current.accepted.size}/${availableCatalogNames(owner).length}`,
-		changes === 0
-			? "No unapplied changes · Escape cancels"
-			: `${changes} unapplied ${changes === 1 ? "change" : "changes"} · Escape cancels`,
-		`WebMCP gateways: ${webMcpEnabled(owner) ? "available for selection · experimental" : "hidden while experimental WebMCP is disabled"}`,
-		"Changes are not applied until Review changes and Apply tool changes.",
-	];
+  if (current.mutationBlockedReason) return sanitizeLines([`Unavailable: ${current.mutationBlockedReason}`]);
+  const changes = symmetricDifferenceSize(current.accepted, current.draft);
+  return [
+    `Currently available: ${current.accepted.size}/${availableCatalogNames(owner).length}`,
+    changes === 0
+      ? "No unapplied changes · Escape cancels"
+      : `${changes} unapplied ${changes === 1 ? "change" : "changes"} · Escape cancels`,
+    `WebMCP gateways: ${webMcpEnabled(owner) ? "available for selection · experimental" : "hidden while experimental WebMCP is disabled"}`,
+    "Changes are not applied until Review changes and Apply tool changes.",
+  ];
 }
 
 function buildToolReview(current: ToolWorkflowState, owner: object) {
-	const catalog = availableCatalogNames(owner);
-	const available = catalog.filter((name) => current.draft.has(name));
-	const unavailable = catalog.filter((name) => !current.draft.has(name));
-	return sanitizeChromeDevtoolsDisplay(
-		[
-			`Current available browser tools: ${current.accepted.size}/${catalog.length}`,
-			`Proposed available browser tools: ${current.draft.size}/${catalog.length}`,
-			"",
-			"Available after apply:",
-			...(available.length > 0
-				? available.map((name) => `  - ${TOOL_PRESENTATION[name].label} (${name})`)
-				: ["  - none"]),
-			"",
-			"Unavailable after apply:",
-			...(unavailable.length > 0
-				? unavailable.map((name) => `  - ${TOOL_PRESENTATION[name].label} (${name})`)
-				: ["  - none"]),
-			"",
-			"Other active Pi tools remain unchanged.",
-			"Native-capable models defer these tools until chrome_devtools_load selects them.",
-			"Other models expose available tools eagerly before the next model request.",
-			"The accepted availability policy is saved for future sessions.",
-		].join("\n"),
-	);
+  const catalog = availableCatalogNames(owner);
+  const available = catalog.filter((name) => current.draft.has(name));
+  const unavailable = catalog.filter((name) => !current.draft.has(name));
+  return sanitizeChromeDevtoolsDisplay(
+    [
+      `Current available browser tools: ${current.accepted.size}/${catalog.length}`,
+      `Proposed available browser tools: ${current.draft.size}/${catalog.length}`,
+      "",
+      "Available after apply:",
+      ...(available.length > 0
+        ? available.map((name) => `  - ${TOOL_PRESENTATION[name].label} (${name})`)
+        : ["  - none"]),
+      "",
+      "Unavailable after apply:",
+      ...(unavailable.length > 0
+        ? unavailable.map((name) => `  - ${TOOL_PRESENTATION[name].label} (${name})`)
+        : ["  - none"]),
+      "",
+      "Other active Pi tools remain unchanged.",
+      "Native-capable models defer these tools until chrome_devtools_load selects them.",
+      "Other models expose available tools eagerly before the next model request.",
+      "The accepted availability policy is saved for future sessions.",
+    ].join("\n"),
+  );
 }
 
-function updateSnapshotAfterApply(
-	snapshot: MenuSnapshot,
-	selectedTools: readonly ChromeDevToolsToolName[],
-) {
-	snapshot.activeTools = [...selectedTools];
-	snapshot.persistenceLabel = "saved";
+function updateSnapshotAfterApply(snapshot: MenuSnapshot, selectedTools: readonly ChromeDevToolsToolName[]) {
+  snapshot.activeTools = [...selectedTools];
+  snapshot.persistenceLabel = "saved";
 }
 
 function activeChromeTools(pi: ExtensionAPI) {
-	return availableChromeDevtoolsTools(pi);
+  return availableChromeDevtoolsTools(pi);
 }
 
 function orderedTools(tools: ReadonlySet<ChromeDevToolsToolName>) {
-	return CHROME_DEVTOOLS_TOOL_NAMES.filter((toolName) => tools.has(toolName));
+  return CHROME_DEVTOOLS_TOOL_NAMES.filter((toolName) => tools.has(toolName));
 }
 
 function isChromeDevtoolsToolName(value: string): value is ChromeDevToolsToolName {
-	return CHROME_DEVTOOLS_TOOL_NAMES.includes(value as ChromeDevToolsToolName);
+  return CHROME_DEVTOOLS_TOOL_NAMES.includes(value as ChromeDevToolsToolName);
 }
 
 function setsEqual<T>(left: ReadonlySet<T>, right: ReadonlySet<T>) {
-	return left.size === right.size && [...left].every((value) => right.has(value));
+  return left.size === right.size && [...left].every((value) => right.has(value));
 }
 
 function symmetricDifferenceSize<T>(left: ReadonlySet<T>, right: ReadonlySet<T>) {
-	let changes = 0;
-	for (const value of left) if (!right.has(value)) changes += 1;
-	for (const value of right) if (!left.has(value)) changes += 1;
-	return changes;
+  let changes = 0;
+  for (const value of left) if (!right.has(value)) changes += 1;
+  for (const value of right) if (!left.has(value)) changes += 1;
+  return changes;
 }
 
 function arraysEqual<T>(left: readonly T[], right: readonly T[]) {
-	return left.length === right.length && left.every((value, index) => value === right[index]);
+  return left.length === right.length && left.every((value, index) => value === right[index]);
 }
 
 function sanitizeLines(lines: readonly string[]) {
-	return sanitizeChromeDevtoolsDisplay(lines.join("\n")).split("\n");
+  return sanitizeChromeDevtoolsDisplay(lines.join("\n")).split("\n");
 }
 
 function availableCatalogNames(owner: object): ChromeDevToolsToolName[] {
-	return webMcpEnabled(owner)
-		? [...CHROME_DEVTOOLS_TOOL_NAMES]
-		: [...CORE_CHROME_DEVTOOLS_TOOL_NAMES];
+  return webMcpEnabled(owner) ? [...CHROME_DEVTOOLS_TOOL_NAMES] : [...CORE_CHROME_DEVTOOLS_TOOL_NAMES];
 }
 
 function formatError(error: unknown) {
-	return error instanceof Error ? error.message : String(error);
+  return error instanceof Error ? error.message : String(error);
 }