@narumitw/pi-chrome-devtools 0.52.2 → 0.52.3

package/README.md

@@ -14,7 +14,7 @@ The design is inspired by [`chrome-devtools-mcp`](https://github.com/ChromeDevTo
 - Reuses an existing CDP endpoint or lazily launches an isolated Chromium-family browser.
 - Recovers from stale page selections and reports actionable browser startup or endpoint errors.
 - Loads explicitly approved unpacked extensions only in an extension-owned Chrome for Testing or Chromium process.
-- Keeps browser tools lazy and exposes availability, setup, status, and help through `/chrome-devtools`.
+- Uses native deferred browser tools when supported and eager exposure otherwise, with availability, setup, 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.
 
@@ -148,21 +148,29 @@ It never closes user-started browsers or remote endpoints.
 - `chrome_devtools_evaluate` — evaluate JavaScript in the selected page.
 - `chrome_devtools_screenshot` — capture a PNG screenshot and save it as a PNG file.
 
-### Lazy tool loading
+### Tool exposure
 
-All six tools are registered, but only `chrome_devtools_load` starts active for this extension.
+All six tools are registered.
+
+On a model/provider with native deferred-tool support, only `chrome_devtools_load` starts active for this extension.
 
 The loader accepts a task-oriented `query`, matches it against the five capability tools, 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`.
 
-Pi uses native deferred tool references on compatible Anthropic and OpenAI models.
+Pi uses native deferred tool references on compatible Anthropic models, native additional-tools or tool-search loading on compatible OpenAI and Codex Responses models, and native Kimi loading on compatible OpenAI Chat Completions models.
+
+Kimi-compatible models declare `compat.deferredToolsMode: "kimi"` in Pi's model metadata.
+
+`azure-openai-responses` remains eager because Pi's Azure adapter does not implement native deferred tool-search serialization.
+
+When the selected model/provider lacks native deferred support, the extension activates every capability allowed by settings before the next model request instead of using Pi's cache-invalidating lazy-loading fallback.
 
-Other models receive Pi's safe fallback: the newly active definitions appear in the normal tool list on the next model request.
+After a session enters eager exposure, it stays eager across later model switches to avoid removing tool definitions within that session.
 
-The capability tools omit active-only prompt snippets so a lazy load does not rebuild the system prompt prefix.
+The capability tools omit active-only prompt snippets so native deferred loading does not rebuild the system-prompt prefix.
 
-The saved `tools` array controls which capabilities the loader may expose.
+The saved `tools` array controls which capabilities the extension may expose.
 
 An empty array leaves the loader active but makes every browser capability unavailable.
 
@@ -198,7 +206,7 @@ If the model cannot inspect the inline image, ask it to read the saved path, for
 /chrome-devtools
 ```
 
-Opens a menu that shows the lazy catalog size, whether that catalog is saved, the configured endpoint, the observed managed-browser state, and any settings or launch warning before you choose an action.
+Opens a menu that shows the tool catalog size, whether that catalog is saved, the configured endpoint, the observed managed-browser state, and any settings or launch warning before you choose an action.
 The five actions stay on one level:
 
 - **Choose available browser tools…** — stage any combination of the five capabilities, then review the exact available/unavailable result before selecting **Apply tool changes**.
@@ -235,7 +243,7 @@ Compatibility aliases remain available: `toggle` and `select` mean `tools`, `on`
 - `settings` opens the same immediate-save browser settings flow used by the menu.
 - `tools` opens the same staged, width-safe availability and review flow used by the menu.
 - `toggle` and `select` are compatibility aliases for `tools`.
-- `enable` makes all five capability tools available to the loader and saves that catalog; `on` is a compatibility alias.
+- `enable` makes all five capability tools available and follows the current native-deferred or eager exposure mode; `on` is a compatibility alias.
 - `disable` makes all five capability tools unavailable and saves the empty catalog; `off` is a compatibility alias.
   The slash command and `chrome_devtools_load` remain available.
 
@@ -258,7 +266,7 @@ Confirmed menu changes apply before the next browser connection and close only a
 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`, while its capability definitions remain deferred.
+A valid saved catalog is restored on Pi startup and `/reload`, with capability definitions exposed natively deferred or eagerly according to model/provider support.
 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.

package/dist/chunks/{browser-settings-menu-VI2I3TXI.js → browser-settings-menu-VWCNG4HB.js}

@@ -8,7 +8,7 @@ import {
   saveBrowserSettings,
   shutdownManagedBrowser,
   state
-} from "./chunk-CC37WUUE.js";
+} from "./chunk-RH6KESL3.js";
 
 // src/browser-settings-menu.ts
 import { isAbsolute } from "node:path";
@@ -263,4 +263,4 @@ function formatError(error) {
 export {
   showChromeDevtoolsBrowserSettings
 };
-//# sourceMappingURL=browser-settings-menu-VI2I3TXI.js.map
+//# sourceMappingURL=browser-settings-menu-VWCNG4HB.js.map

package/dist/chunks/{chunk-CC37WUUE.js → chunk-RH6KESL3.js}

@@ -1250,7 +1250,9 @@ var DevToolsEndpointError = class extends Error {
 };
 
 // src/lazy-tools.ts
-import { defineTool } from "@earendil-works/pi-coding-agent";
+import {
+  defineTool
+} from "@earendil-works/pi-coding-agent";
 import { Type } from "typebox";
 var CHROME_DEVTOOLS_LOAD_TOOL_NAME = "chrome_devtools_load";
 var AVAILABLE_TOOLS_STORE = /* @__PURE__ */ Symbol.for("@narumitw/pi-chrome-devtools.available-tools-store");
@@ -1258,6 +1260,7 @@ var sharedGlobal = globalThis;
 var existingAvailableToolsStore = sharedGlobal[AVAILABLE_TOOLS_STORE];
 var availableToolsByApi = existingAvailableToolsStore ?? /* @__PURE__ */ new WeakMap();
 if (!existingAvailableToolsStore) sharedGlobal[AVAILABLE_TOOLS_STORE] = availableToolsByApi;
+var lazyExposureByApi = /* @__PURE__ */ new WeakMap();
 var SEARCH_TEXT = {
   chrome_devtools_list_pages: "list open inspectable chrome browser pages tabs targets",
   chrome_devtools_select_page: "select choose active chrome browser page tab target",
@@ -1273,17 +1276,53 @@ function initializeAvailableChromeDevtoolsTools(pi) {
     CHROME_DEVTOOLS_TOOL_NAMES.filter((name) => activeTools.has(name))
   );
 }
-function configureLazyChromeDevtoolsTools(pi, availableTools) {
-  setAvailableTools(pi, availableTools);
+function configureChromeDevtoolsToolExposure(pi, availableTools, model) {
+  const available = setAvailableTools(pi, availableTools);
+  const lazyExposure = supportsNativeDeferredToolLoading(model);
+  lazyExposureByApi.set(pi, lazyExposure);
+  const exposedTools = lazyExposure ? [] : CHROME_DEVTOOLS_TOOL_NAMES.filter((name) => available.has(name));
   const nonCapabilityTools = pi.getActiveTools().filter((name) => !CHROME_DEVTOOLS_TOOL_NAMES.includes(name));
-  pi.setActiveTools(unique([...nonCapabilityTools, CHROME_DEVTOOLS_LOAD_TOOL_NAME]));
+  pi.setActiveTools(
+    unique([...nonCapabilityTools, CHROME_DEVTOOLS_LOAD_TOOL_NAME, ...exposedTools])
+  );
+}
+function requireEagerChromeDevtoolsToolExposure(pi) {
+  lazyExposureByApi.set(pi, false);
+  const active = pi.getActiveTools();
+  const available = availableChromeDevtoolsTools(pi);
+  pi.setActiveTools(unique([...active, CHROME_DEVTOOLS_LOAD_TOOL_NAME, ...available]));
 }
 function applyAvailableChromeDevtoolsTools(pi, availableTools) {
   const available = setAvailableTools(pi, availableTools);
+  const lazyExposure = lazyExposureByApi.get(pi) === true;
   const active = pi.getActiveTools().filter(
-    (name) => !CHROME_DEVTOOLS_TOOL_NAMES.includes(name) || available.has(name)
+    (name) => !CHROME_DEVTOOLS_TOOL_NAMES.includes(name) || lazyExposure && available.has(name)
   );
-  pi.setActiveTools(unique([...active, CHROME_DEVTOOLS_LOAD_TOOL_NAME]));
+  const eagerTools = lazyExposure ? [] : CHROME_DEVTOOLS_TOOL_NAMES.filter((name) => available.has(name));
+  pi.setActiveTools(unique([...active, CHROME_DEVTOOLS_LOAD_TOOL_NAME, ...eagerTools]));
+}
+function chromeDevtoolsToolExposureMode(pi) {
+  return lazyExposureByApi.get(pi) === true ? "native deferred" : "eager";
+}
+function supportsNativeDeferredToolLoading(model) {
+  if (!model) return false;
+  if (model.api === "anthropic-messages") {
+    const configured = compatBoolean(model.compat, "supportsToolReferences");
+    if (configured !== void 0) return configured;
+    if (model.provider !== "anthropic" || model.id.includes("haiku")) return false;
+    const version = model.id.match(/^claude-(?:opus|sonnet|fable)-(\d+)(?:-(\d+))?(?:-|$)/);
+    if (!version) return false;
+    const major = Number(version[1]);
+    const minor = version[2] && version[2].length < 8 ? Number(version[2]) : 0;
+    return major > 4 || major === 4 && minor >= 5;
+  }
+  if (model.api === "openai-completions") {
+    return compatString(model.compat, "deferredToolsMode") === "kimi";
+  }
+  if (model.api === "openai-responses" || model.api === "openai-codex-responses") {
+    return compatBoolean(model.compat, "supportsAdditionalTools") === true || compatBoolean(model.compat, "supportsToolSearch") === true;
+  }
+  return false;
 }
 function availableChromeDevtoolsTools(pi) {
   const available = availableToolsByApi.get(pi) ?? /* @__PURE__ */ new Set();
@@ -1343,6 +1382,16 @@ function setAvailableTools(pi, availableTools) {
   availableToolsByApi.set(pi, available);
   return available;
 }
+function compatBoolean(value, key) {
+  if (typeof value !== "object" || value === null || Array.isArray(value)) return void 0;
+  const record = value;
+  return typeof record[key] === "boolean" ? record[key] : void 0;
+}
+function compatString(value, key) {
+  if (typeof value !== "object" || value === null || Array.isArray(value)) return void 0;
+  const record = value;
+  return typeof record[key] === "string" ? record[key] : void 0;
+}
 function unique(values) {
   return [...new Set(values)];
 }
@@ -1361,7 +1410,7 @@ async function updateChromeDevtoolsTools(pi, ctx, selectedTools, action) {
   if (result !== "saved" || generation !== state.sessionGeneration) return;
   const status = await buildToolStatusMessage(pi);
   if (generation !== state.sessionGeneration) return;
-  ctx.ui.notify(`Chrome DevTools lazy catalog ${action}.
+  ctx.ui.notify(`Chrome DevTools tool catalog ${action}.
 
 ${status}`, "info");
 }
@@ -1411,7 +1460,8 @@ async function transactSelectedToolsNow(pi, ctx, selectedTools, expectedGenerati
       const previousLoadedChromeTools = previousActiveTools.filter(
         (name) => CHROME_DEVTOOLS_TOOL_NAMES.includes(name)
       );
-      pi.setActiveTools(unique2([...currentNonChromeTools, ...previousLoadedChromeTools]));
+      const restoredChromeTools = chromeDevtoolsToolExposureMode(pi) === "eager" ? previousAvailableTools : previousLoadedChromeTools;
+      pi.setActiveTools(unique2([...currentNonChromeTools, ...restoredChromeTools]));
     } catch (caught) {
       rollbackError = caught;
     }
@@ -1454,10 +1504,11 @@ async function buildToolStatusMessage(pi) {
   const persistedSetting = await persistedSettingLabel();
   return sanitizeChromeDevtoolsDisplay(
     [
-      `Chrome DevTools tools available to lazy-load: ${formatRuntimeStatus(summary)}`,
+      `Chrome DevTools tools available: ${formatRuntimeStatus(summary)}`,
+      `Tool exposure: ${chromeDevtoolsToolExposureMode(pi)}`,
       `Loaded capability tools this session: ${summary.loadedChromeToolCount}/${CHROME_DEVTOOLS_TOOL_NAMES.length}`,
       `Loader: ${pi.getActiveTools().includes(CHROME_DEVTOOLS_LOAD_TOOL_NAME) ? "active" : "inactive"}`,
-      `Persisted lazy catalog: ${persistedSetting}`,
+      `Persisted tool catalog: ${persistedSetting}`,
       ...browserSettingsStatusLines(),
       ...state.settingsNotice ? [`Settings note: ${state.settingsNotice}`] : [],
       `Other active tools preserved: ${summary.activeNonChromeToolCount}`,
@@ -1537,9 +1588,9 @@ function buildCommandGuide() {
     "/chrome-devtools quickstart \u2014 show endpoint and launch help",
     "/chrome-devtools status \u2014 show tool and settings status",
     "/chrome-devtools settings \u2014 edit browser connection settings",
-    "/chrome-devtools tools \u2014 choose tools available to lazy-load",
+    "/chrome-devtools tools \u2014 choose available Chrome DevTools tools",
     "/chrome-devtools toggle|select \u2014 compatibility aliases for tools",
-    "/chrome-devtools enable|on \u2014 make all Chrome DevTools tools available to lazy-load",
+    "/chrome-devtools enable|on \u2014 make all Chrome DevTools tools available",
     "/chrome-devtools disable|off \u2014 make all Chrome DevTools capability tools unavailable"
   ].join("\n");
 }
@@ -1591,7 +1642,9 @@ export {
   launchHint,
   formatPageListItem,
   initializeAvailableChromeDevtoolsTools,
-  configureLazyChromeDevtoolsTools,
+  configureChromeDevtoolsToolExposure,
+  requireEagerChromeDevtoolsToolExposure,
+  supportsNativeDeferredToolLoading,
   availableChromeDevtoolsTools,
   createChromeDevtoolsLoadTool,
   updateChromeDevtoolsTools,
@@ -1604,4 +1657,4 @@ export {
   buildCommandGuide,
   allChromeDevtoolsTools
 };
-//# sourceMappingURL=chunk-CC37WUUE.js.map
+//# sourceMappingURL=chunk-RH6KESL3.js.map