@narumitw/pi-chrome-devtools 0.53.3 → 0.54.0

package/README.md

@@ -12,7 +12,7 @@ The design is inspired by [`chrome-devtools-mcp`](https://github.com/ChromeDevTo
 - Reuses an existing CDP endpoint or launches an isolated Chromium-family browser on first use.
 - Recovers from stale page selections and explains browser startup or endpoint failures.
 - Loads explicitly approved unpacked extensions only in an extension-owned Chrome for Testing or Chromium process.
-- Uses native deferred browser tools when supported and exposes allowed tools eagerly otherwise.
+- Defaults to codemode-discoverable browser capabilities, with optional lazy and direct exposure.
 - Provides availability controls, setup guidance, status, and help through `/chrome-devtools`.
 - Shows compact expandable results and activity only while browser tools are running.
 - Persists reviewed tool availability while keeping browser connection settings machine-owned.
@@ -46,7 +46,15 @@ Review third-party extension source before installing it.
 
 ## 🚀 Quick start
 
-Start Pi and ask the agent to load the browser capability needed for the task.
+If `codemode` is already in your active tool list, no additional Pi setting is needed. Startup warns when enabled capabilities require codemode but the host tool is inactive; empty catalogs and fully explicit host selections do not produce this warning.
+Otherwise, enable Pi's built-in codemode in Pi's `settings.json`:
+
+```json
+{ "defaultTools": ["+codemode"] }
+```
+
+Start Pi and ask the agent to inspect a browser page. Codemode can discover `chrome_devtools_*` with `searchTools`, inspect schemas with `describeTool`, and call them through `tools`.
+A CLI `--tools` list is an allowlist for extension tools too; prefer the additive `defaultTools` setting above.
 By default, the extension tries `http://127.0.0.1:9222` and launches an isolated local Chromium-family browser if that endpoint is unavailable.
 Run `/chrome-devtools` to review status, settings, help, and available tools.
 WebMCP remains disabled until you explicitly enable it.
@@ -77,7 +85,7 @@ See [WebMCP setup and troubleshooting](./docs/browser-setup.md#experimental-webm
 
 ## 🛠️ Tools
 
-- `chrome_devtools_load` — find and load browser capabilities relevant to a task.
+- `chrome_devtools_load` — find and load browser capabilities relevant to a task (lazy mode only).
 - `chrome_devtools_list_pages` — list inspectable Chrome tabs/pages.
 - `chrome_devtools_select_page` — select the active page for later tool calls.
 - `chrome_devtools_navigate` — navigate a page to a URL; if no page exists, create one first.
@@ -88,8 +96,12 @@ See [WebMCP setup and troubleshooting](./docs/browser-setup.md#experimental-webm
 
 ### Tool exposure
 
-The extension registers eight tools: one loader, five stable DevTools capabilities, and two fixed experimental WebMCP gateways.
-With native deferred-tool support, only `chrome_devtools_load` starts active.
+The default `codemode` mode registers five stable capabilities and two fixed experimental WebMCP gateways without a loader. Enabled capabilities are callable through codemode discovery without adding their definitions to the ordinary model request. Explicit host activation of an enabled capability is preserved.
+Disabled capabilities are hidden from discovery and calls in every mode, including the WebMCP gateways while their gate is off.
+
+Choose `lazy` or `direct` under **Browser settings → Tool mode** to use another exposure policy; changes require `/reload` or session replacement. Direct mode declares all enabled capabilities without a loader.
+
+In lazy mode, with native deferred-tool support, only `chrome_devtools_load` starts active.
 The loader accepts a task-oriented `query`, matches it against the five stable capabilities plus enabled WebMCP gateways, and adds matching available tools without removing any active Pi tool.
 Loaded capability tools remain active for the rest of the session unless the user makes them unavailable through `/chrome-devtools`.
 
@@ -105,7 +117,7 @@ The capability tools omit active-only prompt snippets so native deferred loading
 The saved `tools` array controls which capabilities the extension may expose.
 The `webmcp.enabled` gate takes precedence, so persisted WebMCP names cannot bypass a disabled gate.
 Page-provided tool definitions appear only in list results and never alter Pi's provider-visible tool definitions.
-An empty array leaves the loader active but makes every browser capability unavailable.
+An empty array makes every browser capability unavailable; only lazy mode retains the loader.
 
 ### Screenshot files
 
@@ -141,14 +153,14 @@ If the model cannot inspect the inline image, ask it to read the saved path, for
 | `/chrome-devtools help` | Show command usage. |
 | `/chrome-devtools quickstart` | Show the CDP endpoint, launch candidates, and setup hints. |
 | `/chrome-devtools status` | Inspect tools, settings sources, and the last browser launch without probing or starting Chrome. |
-| `/chrome-devtools settings` | Change browser settings; successful edits save immediately. |
+| `/chrome-devtools settings` | Change browser settings and tool mode; successful edits save immediately. |
 | `/chrome-devtools tools` (aliases: `toggle`, `select`) | Stage tool availability, review the result, and apply it. |
 | `/chrome-devtools enable` (alias: `on`) | Immediately make all currently gated capabilities available and save the selection. |
 | `/chrome-devtools disable` (alias: `off`) | Immediately make all capabilities unavailable and save the empty selection. |
 
 All routes support TUI and RPC and reject unknown or trailing arguments.
 Only `enable` and `disable` also support print and JSON modes.
-Disabling capabilities leaves the slash command and `chrome_devtools_load` available; see [Tool exposure](#tool-exposure).
+Disabling capabilities leaves the slash command available and retains `chrome_devtools_load` only in lazy mode; see [Tool exposure](#tool-exposure).
 
 Menu tool changes require **Apply tool changes**; cancellation discards the unconfirmed draft.
 Failed apply leaves previous tool availability and settings intact and retains the draft for retry.
@@ -180,11 +192,16 @@ Browser connection fields and `webmcp.enabled` are machine-owned user settings;
 Confirmed menu changes apply before the next browser connection and close only an extension-owned managed browser.
 Manual JSON edits and unpacked-extension changes apply after `/reload` or session replacement.
 
-When the file is missing or invalid, the extension preserves Pi's current Chrome DevTools availability policy instead of replacing it.
-A valid saved catalog is restored on Pi startup and `/reload`, with capability definitions exposed natively deferred or eagerly according to model/provider support.
+`toolMode` accepts `codemode` (default), `lazy`, or `direct` and is user-only. It applies at session start, including `/reload`; availability edits apply immediately without overwriting a pending mode change.
+Missing settings and valid older files without `toolMode` now use codemode. To restore the previous loader behavior, save `"toolMode": "lazy"` and reload. Without an explicit catalog, all modes make the stable capabilities available; the active declaration list does not determine configured availability.
+A first `/reload` from the previous loader implementation clears carried-over Chrome declarations when applying codemode; enabled capabilities remain callable through codemode. Pi exposes no activation-origin API, so an active loader plus Chrome capabilities without known session provenance is treated as the predecessor's cohort. Capability-only host selections and known explicit activations are preserved. This is an intentional reload-time model-visible prefix transition, not an ordinary-turn change.
+Activation provenance is stored as versioned, non-model session metadata and restored from the current branch on session start; a branch without valid provenance drops abandoned-branch caches, so transcript-restoring resume/fork paths can apply codemode without carrying extension-owned declarations forward. Recordless sessions retain the legacy loader-cohort migration policy; unknown capability-only selections remain conservative host selections. Observed host deactivation clears an explicit selection, while extension-caused hiding is not treated as host withdrawal. Re-enabling availability restores retained explicit declarations only when the capability and its WebMCP gate allow it.
+A successful lazy activation remains additive if its ownership metadata cannot be saved: the loader reports the loaded tools with a warning rather than removing them or reporting a failed load. Startup and model-switch exposure also remain applied when only metadata persistence fails; lifecycle handlers warn and continue instead of reporting a failed setup. A later loader call or lifecycle update retries pending metadata, including when matching tools are already loaded or the same policy is restored on reload; durable ownership may be incomplete until persistence succeeds. Availability and WebMCP settings saves retain their transactional failure recovery.
+A valid saved catalog is restored on Pi startup and `/reload`. An invalid user settings file retains the known effective availability and running mode with a warning, even when valid trusted-project browser settings make the combined load succeed; without a recoverable catalog, only already active capabilities are retained and no new capability is enabled. A fresh invalid configuration therefore leaves browser capabilities disabled until the file is repaired. Invalid settings cannot be overwritten by a save.
 A missing file is created by the first confirmed browser or tool setting.
 Within one Pi process, all browser and tool saves run in invocation order, reread the latest valid document, publish by temporary-file rename, and preserve unknown fields.
-Malformed JSON or invalid recognized fields make menu mutation unavailable and block direct saves without replacement; a failed save restores the prior displayed and effective state.
+Malformed JSON or invalid recognized fields make menu mutation unavailable and block direct saves without replacement.
+Availability saves precede runtime publication. A failed disk write leaves runtime tools unchanged, including host edits made during the save. If runtime publication fails after saving, recovery restores the previous runtime policy and saved catalog before releasing dependent reads or session replacement. Recovery changes only the tool catalog fields, preserves unrelated settings, and refuses to overwrite invalid or newer catalog data; any recovery failure is reported explicitly.
 
 Compatibility: older versions used `pi-chrome-devtools-settings.json`.
 A legacy-only file remains readable with a warning and is never modified automatically; rename it to `pi-chrome-devtools.json`.

package/dist/chunks/{browser-settings-menu-SR7KLZT6.js → browser-settings-menu-GQAXLWZ7.ts}

@@ -5,20 +5,22 @@ import {
   configuredChromeDevtoolsTools,
   sanitizeChromeDevtoolsDisplay,
   setChromeDevtoolsSessionOwner
-} from "./chunk-MZCGM6D3.js";
+} from "./chunk-WOFI2A72.ts";
 import {
   applyRuntimeBrowserSettings,
   applyRuntimeWebMcpSetting,
   invalidateWebMcpOperations,
+  isChromeDevtoolsToolMode,
   loadSettings,
   parseBrowserEndpoint,
   saveBrowserSettings,
+  saveToolMode,
   saveWebMcpSettings,
   shutdownManagedBrowser,
   state,
   syncManagedBrowserSettings,
   webMcpEnabled
-} from "./chunk-F5VG35UI.js";
+} from "./chunk-TVVYQ5KM.ts";
 
 // src/browser-settings-menu.ts
 import { isAbsolute } from "node:path";
@@ -75,6 +77,14 @@ async function showChromeDevtoolsBrowserSettings(pi, ctx, generation) {
               description: "Inspect trusted extension paths configured in user or project JSON.",
               currentValue: `${browser.extensionPaths.length} configured`,
               action: "show-extensions"
+            },
+            {
+              id: "tool-mode",
+              label: "Tool mode",
+              description: "codemode discovery, lazy loading, or direct declarations. Saved changes require /reload.",
+              currentValue: current.load.kind === "loaded" ? current.load.settings.toolMode : "codemode",
+              values: ["codemode", "lazy", "direct"],
+              action: "set-tool-mode"
             }
           ]
         };
@@ -111,6 +121,18 @@ async function showChromeDevtoolsBrowserSettings(pi, ctx, generation) {
       })
     },
     actions: {
+      "set-tool-mode": async ({ value }) => {
+        if (!isChromeDevtoolsToolMode(value) || !isCurrent2()) return { kind: "rejected" };
+        try {
+          await saveToolMode(value);
+          if (!isCurrent2()) return { kind: "rejected" };
+          ctx.ui.notify("Chrome DevTools tool mode saved; /reload required. Running exposure is unchanged.", "info");
+          return { kind: "stay" };
+        } catch (error) {
+          if (isCurrent2()) notifySaveFailure(ctx, error);
+          return { kind: "rejected" };
+        }
+      },
       "open-endpoint": () => ({ kind: "to", screen: "endpoint" }),
       "save-endpoint": async ({ value, signal }) => {
         if (value === void 0) return { kind: "rejected" };
@@ -313,4 +335,4 @@ function formatError(error) {
 export {
   showChromeDevtoolsBrowserSettings
 };
-//# sourceMappingURL=browser-settings-menu-SR7KLZT6.js.map
+//# sourceMappingURL=browser-settings-menu-GQAXLWZ7.ts.map

package/dist/chunks/browser-settings-menu-GQAXLWZ7.ts.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/browser-settings-menu.ts"],
+  "sourcesContent": ["import { isAbsolute } from \"node:path\";\nimport type { ExtensionAPI, ExtensionCommandContext } from \"@earendil-works/pi-coding-agent\";\nimport { defineMenu, runMenu } from \"@narumitw/pi-tui-kit\";\nimport { shutdownManagedBrowser, syncManagedBrowserSettings } from \"./browser-manager.js\";\nimport {\n  applyAvailableChromeDevtoolsTools,\n  configuredChromeDevtoolsTools,\n  setChromeDevtoolsSessionOwner,\n} from \"./lazy-tools.js\";\nimport {\n  applyRuntimeBrowserSettings,\n  applyRuntimeWebMcpSetting,\n  invalidateWebMcpOperations,\n  state,\n  webMcpEnabled,\n} from \"./runtime.js\";\nimport {\n  type BrowserSettingsPatch,\n  type BrowserSettingsSource,\n  isChromeDevtoolsToolMode,\n  loadSettings,\n  parseBrowserEndpoint,\n  type SettingsLoadResult,\n  saveBrowserSettings,\n  saveToolMode,\n  saveWebMcpSettings,\n} from \"./settings.js\";\nimport { sanitizeChromeDevtoolsDisplay } from \"./tool-selector.js\";\n\ntype BrowserSettingsScreen = \"settings\" | \"endpoint\" | \"executable\" | \"extensions\";\ntype BrowserSettingsAction =\n  | \"set-tool-mode\"\n  | \"open-endpoint\"\n  | \"save-endpoint\"\n  | \"set-auto-launch\"\n  | \"set-webmcp\"\n  | \"open-executable\"\n  | \"save-executable\"\n  | \"show-extensions\";\n\ninterface BrowserSettingsMenuState {\n  load: SettingsLoadResult;\n}\n\ntype CommandContext = ExtensionCommandContext;\n\nexport async function showChromeDevtoolsBrowserSettings(\n  pi: ExtensionAPI,\n  ctx: CommandContext,\n  generation: number,\n): Promise<{ closeParent: boolean }> {\n  setChromeDevtoolsSessionOwner(pi, ctx.sessionManager);\n  const ownerSignal = state.sessionController.signal;\n  const isCurrent = () => generation === state.sessionGeneration && !ownerSignal.aborted;\n  const projectTrusted = ctx.isProjectTrusted();\n  const menu = defineMenu<BrowserSettingsMenuState, BrowserSettingsScreen, BrowserSettingsAction>({\n    start: \"settings\",\n    screens: {\n      settings: ({ state: current }) => {\n        if (current.load.userFile.kind === \"invalid\") return invalidSettingsScreen(current.load);\n        const browser = current.load.effectiveBrowser;\n        return {\n          kind: \"settings\",\n          title: \"Chrome DevTools Browser settings\",\n          lines: settingsContextLines(current.load),\n          items: [\n            {\n              id: \"endpoint\",\n              label: \"DevTools endpoint\",\n              description: 'HTTP origin with an explicit port; enter \"default\" to restore 127.0.0.1:9222.',\n              currentValue: sanitizeChromeDevtoolsDisplay(browser.endpoint),\n              action: \"open-endpoint\",\n            },\n            {\n              id: \"auto-launch\",\n              label: \"Auto-launch\",\n              description: \"Launch an isolated managed browser when a local endpoint is unavailable.\",\n              currentValue: browser.autoLaunchEnabled ? \"On\" : \"Off\",\n              values: [\"On\", \"Off\"],\n              action: \"set-auto-launch\",\n            },\n            {\n              id: \"executable\",\n              label: \"Browser executable\",\n              description: 'Absolute executable path; enter \"automatic\" to restore browser discovery.',\n              currentValue: sanitizeChromeDevtoolsDisplay(browser.executablePath ?? \"Automatic\"),\n              action: \"open-executable\",\n            },\n            {\n              id: \"webmcp\",\n              label: \"WebMCP \u00B7 Experimental\",\n              description: \"Allow user-confirmed calls to page-provided WebMCP tools in this browser session.\",\n              currentValue: current.load.effectiveWebMcpEnabled ? \"On\" : \"Off\",\n              values: [\"On\", \"Off\"],\n              action: \"set-webmcp\",\n            },\n            {\n              id: \"extensions\",\n              label: \"Unpacked extensions\",\n              description: \"Inspect trusted extension paths configured in user or project JSON.\",\n              currentValue: `${browser.extensionPaths.length} configured`,\n              action: \"show-extensions\",\n            },\n            {\n              id: \"tool-mode\",\n              label: \"Tool mode\",\n              description: \"codemode discovery, lazy loading, or direct declarations. Saved changes require /reload.\",\n              currentValue: current.load.kind === \"loaded\" ? current.load.settings.toolMode : \"codemode\",\n              values: [\"codemode\", \"lazy\", \"direct\"],\n              action: \"set-tool-mode\",\n            },\n          ],\n        };\n      },\n      endpoint: ({ state: current }) => ({\n        kind: \"input\",\n        title: \"DevTools endpoint\",\n        lines: [\n          sanitizeChromeDevtoolsDisplay(`Current effective endpoint: ${current.load.effectiveBrowser.endpoint}`),\n          'Enter an HTTP origin with an explicit port, or \"default\".',\n        ],\n        placeholder: \"http://127.0.0.1:9222\",\n        action: \"save-endpoint\",\n        hint: \"back\",\n      }),\n      executable: ({ state: current }) => ({\n        kind: \"input\",\n        title: \"Browser executable\",\n        lines: [\n          sanitizeChromeDevtoolsDisplay(\n            `Current effective executable: ${current.load.effectiveBrowser.executablePath ?? \"automatic discovery\"}`,\n          ),\n          'Enter an absolute path, or \"automatic\".',\n        ],\n        placeholder: \"absolute browser executable path\",\n        action: \"save-executable\",\n        hint: \"back\",\n      }),\n      extensions: ({ state: current }) => ({\n        kind: \"detail\",\n        title: \"Unpacked extensions\",\n        lines: extensionDetailLines(current.load),\n        hint: \"back\",\n      }),\n    },\n    actions: {\n      \"set-tool-mode\": async ({ value }) => {\n        if (!isChromeDevtoolsToolMode(value) || !isCurrent()) return { kind: \"rejected\" };\n        try {\n          await saveToolMode(value);\n          if (!isCurrent()) return { kind: \"rejected\" };\n          ctx.ui.notify(\"Chrome DevTools tool mode saved; /reload required. Running exposure is unchanged.\", \"info\");\n          return { kind: \"stay\" };\n        } catch (error) {\n          if (isCurrent()) notifySaveFailure(ctx, error);\n          return { kind: \"rejected\" };\n        }\n      },\n      \"open-endpoint\": () => ({ kind: \"to\", screen: \"endpoint\" }),\n      \"save-endpoint\": async ({ value, signal }) => {\n        if (value === undefined) return { kind: \"rejected\" };\n        let endpoint: string | null;\n        try {\n          const trimmed = value.trim();\n          endpoint = trimmed.toLowerCase() === \"default\" ? null : parseBrowserEndpoint(trimmed).endpoint;\n        } catch (error) {\n          notifySaveFailure(ctx, error);\n          return { kind: \"rejected\" };\n        }\n        const saved = await saveAndApplyBrowserPatch(ctx, generation, ownerSignal, signal, projectTrusted, {\n          endpoint,\n        });\n        if (!saved) return { kind: \"rejected\" };\n        notifyEffectiveSave(ctx, \"endpoint\", saved.effectiveBrowser.endpoint, saved.effectiveBrowser.endpointSource);\n        return { kind: \"back\" };\n      },\n      \"set-auto-launch\": async ({ value, signal }) => {\n        if (value !== \"On\" && value !== \"Off\") return { kind: \"rejected\" };\n        const saved = await saveAndApplyBrowserPatch(ctx, generation, ownerSignal, signal, projectTrusted, {\n          autoLaunch: value === \"On\",\n        });\n        if (!saved) return { kind: \"rejected\" };\n        notifyEffectiveSave(\n          ctx,\n          \"auto-launch\",\n          saved.effectiveBrowser.autoLaunchEnabled ? \"On\" : \"Off\",\n          saved.effectiveBrowser.autoLaunchSource,\n        );\n        return { kind: \"stay\" };\n      },\n      \"set-webmcp\": async ({ value, signal }) => {\n        if (value !== \"On\" && value !== \"Off\") return { kind: \"rejected\" };\n        const saved = await saveAndApplyWebMcpSetting(\n          pi,\n          ctx,\n          generation,\n          ownerSignal,\n          signal,\n          projectTrusted,\n          value === \"On\",\n        );\n        if (!saved) return { kind: \"rejected\" };\n        ctx.ui.notify(\n          saved.effectiveWebMcpEnabled\n            ? \"Experimental WebMCP enabled. Every page-provided tool call requires confirmation. Choose gateway availability under Browser tools.\"\n            : \"Experimental WebMCP disabled. Active WebMCP work was aborted and both gateway tools are unavailable.\",\n          \"warning\",\n        );\n        return { kind: \"stay\" };\n      },\n      \"open-executable\": () => ({ kind: \"to\", screen: \"executable\" }),\n      \"save-executable\": async ({ value, signal }) => {\n        if (value === undefined) return { kind: \"rejected\" };\n        const trimmed = value.trim();\n        const reset = [\"automatic\", \"default\", \"none\"].includes(trimmed.toLowerCase());\n        if (!reset && (!trimmed || !isAbsolute(trimmed))) {\n          notifySaveFailure(ctx, new Error('Enter an absolute path or \"automatic\".'));\n          return { kind: \"rejected\" };\n        }\n        const executablePath = reset ? null : trimmed;\n        const saved = await saveAndApplyBrowserPatch(ctx, generation, ownerSignal, signal, projectTrusted, {\n          executablePath,\n        });\n        if (!saved) return { kind: \"rejected\" };\n        notifyEffectiveSave(\n          ctx,\n          \"browser executable\",\n          saved.effectiveBrowser.executablePath ?? \"automatic discovery\",\n          saved.effectiveBrowser.executablePathSource,\n        );\n        return { kind: \"back\" };\n      },\n      \"show-extensions\": () => ({ kind: \"to\", screen: \"extensions\" }),\n    },\n  });\n  const result = await runMenu(ctx, menu, {\n    getState: async ({ signal }) => {\n      signal.throwIfAborted();\n      const load = await loadSettings({ cwd: ctx.cwd, projectTrusted });\n      signal.throwIfAborted();\n      return { load };\n    },\n    signal: ownerSignal,\n    isCurrent,\n    onError: (currentCtx, error) =>\n      currentCtx.ui.notify(\n        sanitizeChromeDevtoolsDisplay(`Chrome DevTools browser settings failed: ${formatError(error)}`),\n        \"error\",\n      ),\n  });\n  return { closeParent: result.kind === \"closed\" && result.reason === \"close\" };\n}\n\nasync function saveAndApplyBrowserPatch(\n  ctx: CommandContext,\n  generation: number,\n  ownerSignal: AbortSignal,\n  actionSignal: AbortSignal,\n  projectTrusted: boolean,\n  patch: BrowserSettingsPatch,\n) {\n  try {\n    await ctx.waitForIdle();\n    if (!isCurrent(generation, ownerSignal, actionSignal)) return false;\n    await saveBrowserSettings(patch);\n    if (!isCurrent(generation, ownerSignal, actionSignal)) return false;\n    invalidateWebMcpOperations(ctx.sessionManager, \"Chrome DevTools browser configuration changed\");\n    await shutdownManagedBrowser(undefined, { owner: ctx.sessionManager });\n    if (!isCurrent(generation, ownerSignal, actionSignal)) return false;\n    const loaded = await loadSettings({ cwd: ctx.cwd, projectTrusted });\n    if (!isCurrent(generation, ownerSignal, actionSignal)) return false;\n    applyRuntimeBrowserSettings(loaded.effectiveBrowser, loaded.paths, projectTrusted);\n    syncManagedBrowserSettings(ctx.sessionManager, loaded.effectiveBrowser);\n    state.settingsNotice = loaded.notice;\n    return loaded;\n  } catch (error) {\n    if (isCurrent(generation, ownerSignal, actionSignal)) notifySaveFailure(ctx, error);\n    return false;\n  }\n}\n\nasync function saveAndApplyWebMcpSetting(\n  pi: ExtensionAPI,\n  ctx: CommandContext,\n  generation: number,\n  ownerSignal: AbortSignal,\n  actionSignal: AbortSignal,\n  projectTrusted: boolean,\n  enabled: boolean,\n) {\n  const previousEnabled = webMcpEnabled(ctx.sessionManager);\n  const previousTools = configuredChromeDevtoolsTools(pi);\n  try {\n    await ctx.waitForIdle();\n    if (!isCurrent(generation, ownerSignal, actionSignal)) return false;\n    applyRuntimeWebMcpSetting(enabled, ctx.sessionManager);\n    applyAvailableChromeDevtoolsTools(pi, previousTools);\n    await saveWebMcpSettings(enabled);\n    if (!isOwnerCurrent(generation, ownerSignal)) return false;\n    const loaded = await loadSettings({ cwd: ctx.cwd, projectTrusted });\n    if (!isOwnerCurrent(generation, ownerSignal)) return false;\n    state.settingsNotice = loaded.notice;\n    return loaded;\n  } catch (error) {\n    if (!isOwnerCurrent(generation, ownerSignal)) return false;\n    let rollbackError: unknown;\n    try {\n      applyRuntimeWebMcpSetting(previousEnabled, ctx.sessionManager);\n      applyAvailableChromeDevtoolsTools(pi, previousTools);\n    } catch (caught) {\n      rollbackError = caught;\n    }\n    if (isCurrent(generation, ownerSignal, actionSignal)) {\n      notifySaveFailure(\n        ctx,\n        rollbackError\n          ? new Error(`${formatError(error)}; WebMCP rollback failed: ${formatError(rollbackError)}`)\n          : error,\n      );\n    }\n    return false;\n  }\n}\n\nfunction isOwnerCurrent(generation: number, ownerSignal: AbortSignal) {\n  return generation === state.sessionGeneration && !ownerSignal.aborted;\n}\n\nfunction isCurrent(generation: number, ownerSignal: AbortSignal, actionSignal: AbortSignal) {\n  return isOwnerCurrent(generation, ownerSignal) && !actionSignal.aborted;\n}\n\nfunction invalidSettingsScreen(load: SettingsLoadResult) {\n  const reason = load.userFile.kind === \"invalid\" ? load.userFile.reason : \"The user settings file is unavailable.\";\n  return {\n    kind: \"detail\" as const,\n    title: \"Chrome DevTools Browser settings \u00B7 Read only\",\n    lines: [\n      sanitizeChromeDevtoolsDisplay(\n        `Fix the active user settings before saving; the file will not be overwritten. ${reason}`,\n      ),\n    ],\n    hint: \"back\" as const,\n  };\n}\n\nfunction settingsContextLines(load: SettingsLoadResult) {\n  const browser = load.effectiveBrowser;\n  return [\n    `User settings \u00B7 ${load.paths.user}`,\n    `Effective sources: endpoint ${browser.endpointSource} \u00B7 auto-launch ${browser.autoLaunchSource} \u00B7 executable ${browser.executablePathSource}`,\n    ...(load.notice ? [`Warning: ${load.notice}`] : []),\n  ].map((line) => sanitizeChromeDevtoolsDisplay(line));\n}\n\nfunction extensionDetailLines(load: SettingsLoadResult) {\n  const browser = load.effectiveBrowser;\n  return [\n    `Effective source: ${browser.extensionPathsSource}`,\n    ...(browser.extensionPaths.length > 0\n      ? browser.extensionPaths.map((extensionPath) => `- ${extensionPath}`)\n      : [\"No unpacked extensions are configured.\"]),\n    \"Edit browser.extensionPaths in the user JSON or a trusted project JSON, then run /reload.\",\n    \"Unpacked extensions execute privileged browser code; load only paths you trust.\",\n  ].map((line) => sanitizeChromeDevtoolsDisplay(line));\n}\n\nfunction notifyEffectiveSave(\n  ctx: CommandContext,\n  setting: string,\n  effectiveValue: string,\n  source: BrowserSettingsSource,\n) {\n  const overrideNotice = source === \"environment\" ? \" The deprecated environment override remains effective.\" : \"\";\n  ctx.ui.notify(\n    sanitizeChromeDevtoolsDisplay(\n      `Chrome DevTools ${setting} saved. Effective ${setting}: ${effectiveValue} (${source}).${overrideNotice}`,\n    ),\n    \"info\",\n  );\n}\n\nfunction notifySaveFailure(ctx: CommandContext, error: unknown) {\n  ctx.ui.notify(\n    sanitizeChromeDevtoolsDisplay(\n      `Chrome DevTools browser settings save failed; previous settings remain active: ${formatError(error)}`,\n    ),\n    \"warning\",\n  );\n}\n\nfunction formatError(error: unknown) {\n  return error instanceof Error ? error.message : String(error);\n}\n"],
+  "mappings": "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",
+  "names": ["isCurrent"]
+}

package/dist/chunks/{chunk-4KMN4SFF.js → chunk-5T2WEIYN.ts}

@@ -10,7 +10,7 @@ import {
   launchHint,
   state,
   withEndpointRetry
-} from "./chunk-F5VG35UI.js";
+} from "./chunk-TVVYQ5KM.ts";
 
 // src/cdp-client.ts
 var MAX_BUFFERED_EVENTS_PER_METHOD = 32;
@@ -381,4 +381,4 @@ export {
   withCdp,
   CdpClient
 };
-//# sourceMappingURL=chunk-4KMN4SFF.js.map
+//# sourceMappingURL=chunk-5T2WEIYN.ts.map

package/dist/chunks/{chunk-F5VG35UI.js → chunk-TVVYQ5KM.ts}

@@ -23,6 +23,9 @@ import { dirname, isAbsolute, join, resolve } from "node:path";
 import { CONFIG_DIR_NAME, getAgentDir } from "@earendil-works/pi-coding-agent";
 var NEW_SETTINGS_FILE_NAME = "pi-chrome-devtools.json";
 var LEGACY_SETTINGS_FILE_NAME = "pi-chrome-devtools-settings.json";
+function isChromeDevtoolsToolMode(value) {
+  return value === "codemode" || value === "lazy" || value === "direct";
+}
 var DEFAULT_BROWSER_HOST = "127.0.0.1";
 var DEFAULT_BROWSER_PORT = 9222;
 var DEFAULT_BROWSER_ENDPOINT = `http://${DEFAULT_BROWSER_HOST}:${DEFAULT_BROWSER_PORT}`;
@@ -77,7 +80,7 @@ async function loadSettings(options = {}) {
   const userBrowser = user.normalized?.browser ?? {};
   const effectiveBrowser = resolveEffectiveBrowser(userBrowser, project.normalized?.browser);
   const settings = resolveSettings(user.normalized, project.normalized, effectiveBrowser);
-  const recognized = settings.tools !== void 0 || user.normalized?.browser !== void 0 || project.normalized?.browser !== void 0 || user.normalized?.webmcp !== void 0;
+  const recognized = user.normalized?.toolMode !== void 0 || settings.tools !== void 0 || user.normalized?.browser !== void 0 || project.normalized?.browser !== void 0 || user.normalized?.webmcp !== void 0;
   const invalidReasons = [user, project].filter((result) => result.kind === "invalid").map((result) => result.reason).filter((reason) => Boolean(reason));
   const userFile = user.kind === "invalid" ? {
     kind: "invalid",
@@ -99,6 +102,7 @@ async function loadSettings(options = {}) {
 }
 function resolveSettings(user, _project, browser) {
   return {
+    toolMode: user?.toolMode ?? "codemode",
     ...user?.tools ? { tools: user.tools, updatedAt: user.updatedAt } : {},
     browser,
     webmcp: { enabled: user?.webmcp?.enabled ?? false }
@@ -190,6 +194,11 @@ function projectOwnedSettingsWarnings(document, scope, filePath) {
 }
 async function normalizeSettingsDocument(document, scope, filePath, cwd) {
   const normalized = {};
+  if (scope === "user" && document.toolMode !== void 0) {
+    if (!isChromeDevtoolsToolMode(document.toolMode))
+      throw new Error("expected toolMode to be codemode, lazy, or direct");
+    normalized.toolMode = document.toolMode;
+  }
   if (scope === "user" && (document.tools !== void 0 || document.updatedAt !== void 0)) {
     const toolSettings = normalizeChromeDevtoolsSettings(document);
     if (!toolSettings) {
@@ -332,16 +341,31 @@ function orderedUniqueChromeDevtoolsTools(tools) {
 function orderedUnique(values) {
   return [...new Set(values)];
 }
-function saveSettings(settings, operations = {}) {
+var ToolCatalogApplicationError = class extends Error {
+  constructor(error, rollbackError) {
+    super(
+      rollbackError ? `${formatError(error)}; saved catalog rollback failed: ${formatError(rollbackError)}` : `${formatError(error)}; previous catalog restored`,
+      { cause: error }
+    );
+    this.rollbackError = rollbackError;
+  }
+  rollbackError;
+};
+function saveSettings(settings, operations = {}, applyAfterSave) {
   return queueSettingsMutation(
     (current) => ({
       ...current,
       tools: [...settings.tools],
       updatedAt: settings.updatedAt
     }),
-    operations
+    operations,
+    applyAfterSave
   );
 }
+function saveToolMode(mode, operations = {}) {
+  if (!isChromeDevtoolsToolMode(mode)) return Promise.reject(new Error("Invalid tool mode"));
+  return queueSettingsMutation((current) => ({ ...current, toolMode: mode }), operations);
+}
 function saveWebMcpSettings(enabled, operations = {}) {
   return queueSettingsMutation(
     (current) => ({
@@ -367,12 +391,12 @@ function saveBrowserSettings(patch, operations = {}) {
     return { ...current, browser };
   }, operations);
 }
-function queueSettingsMutation(mutate, operations) {
-  const operation = settingsSaveQueue.then(() => saveSettingsMutationNow(mutate, operations));
+function queueSettingsMutation(mutate, operations, applyToolCatalog) {
+  const operation = settingsSaveQueue.then(() => saveSettingsMutationNow(mutate, operations, applyToolCatalog));
   settingsSaveQueue = operation.catch(() => void 0);
   return operation;
 }
-async function saveSettingsMutationNow(mutate, operations) {
+async function saveSettingsMutationNow(mutate, operations, applyToolCatalog) {
   const filePath = settingsFilePath();
   let current = await readSettingsDocument(filePath, "user");
   const replaceCanonical = current.kind !== "missing";
@@ -394,6 +418,27 @@ async function saveSettingsMutationNow(mutate, operations) {
     await rm(tempFile, { force: true }).catch(() => void 0);
     throw error;
   }
+  if (!applyToolCatalog) return;
+  try {
+    applyToolCatalog();
+  } catch (error) {
+    let rollbackError;
+    try {
+      await saveSettingsMutationNow((latest) => {
+        const restored = { ...latest };
+        for (const field of ["tools", "updatedAt"]) {
+          if (JSON.stringify(latest[field]) !== JSON.stringify(nextDocument[field]))
+            throw new Error("Tool catalog changed after save; refusing to overwrite newer settings");
+          delete restored[field];
+          if (current.document?.[field] !== void 0) restored[field] = current.document[field];
+        }
+        return restored;
+      }, operations);
+    } catch (caught) {
+      rollbackError = caught;
+    }
+    throw new ToolCatalogApplicationError(error, rollbackError);
+  }
 }
 function settingsFilePath() {
   return join(getAgentDir(), NEW_SETTINGS_FILE_NAME);
@@ -1468,10 +1513,13 @@ export {
   WEBMCP_TOOL_NAMES,
   CHROME_DEVTOOLS_TOOL_NAMES,
   isWebMcpToolName,
+  isChromeDevtoolsToolMode,
   waitForSettingsWrites,
   loadSettings,
   parseBrowserEndpoint,
+  ToolCatalogApplicationError,
   saveSettings,
+  saveToolMode,
   saveWebMcpSettings,
   saveBrowserSettings,
   settingsFilePath,
@@ -1505,4 +1553,4 @@ export {
   endpointConfigHint,
   formatPageListItem
 };
-//# sourceMappingURL=chunk-F5VG35UI.js.map
+//# sourceMappingURL=chunk-TVVYQ5KM.ts.map