pi-extensions-tool-display 0.2.0 → 0.2.2

package/README.md

@@ -8,7 +8,7 @@ It provides:
 - a pending registration queue for when the Pi display host loads later;
 - safe component detection and a helper for appending an audit panel to the original tool result.
 
-It is also a standalone Pi extension. Install or include this package in Pi's package list to load the actual tool-display host. Feature packages such as `pi-distill` and `pi-tool-supervisor` initialize the same host through this runtime dependency, so installing either feature package is sufficient and does not require a second host package.
+It is also a standalone Pi extension. Install or include this package in Pi's package list to load the actual tool-display host. Feature package manifests include this dependency's extension entry, so installing either feature package loads one shared host without requiring a second host package.
 
 ## Boundary
 
@@ -28,7 +28,7 @@ Install this package directly when you want only the tool-display host:
 pi install npm:pi-extensions-tool-display
 ```
 
-`pi-distill` and `pi-tool-supervisor` also initialize the host automatically when they are loaded.
+`pi-distill` and `pi-tool-supervisor` declare this host entry in their package manifests when they are installed.
 
 ## Development
 

package/README.zh-CN.md

@@ -8,7 +8,7 @@
 - Pi 展示宿主尚未加载时的 pending 注册队列；
 - 安全识别组件，以及把审计面板追加到原始工具结果后的通用组件组合。
 
-它同时是一个独立的 Pi 扩展。可以把这个包直接加入 Pi 的 package 列表加载工具展示宿主；`pi-distill`、`pi-tool-supervisor` 等功能包加载时也会通过这个运行时依赖自动初始化同一个宿主，不需要额外安装第二份宿主包。
+它同时是一个独立的 Pi 扩展。可以把这个包直接加入 Pi 的 package 列表加载工具展示宿主；`pi-distill`、`pi-tool-supervisor` 的包清单也会声明这个依赖的扩展入口，因此安装功能包时只会加载一个公共宿主，不需要额外安装第二份宿主包。
 
 ## 设计边界
 
@@ -28,7 +28,7 @@
 pi install npm:pi-extensions-tool-display
 ```
 
-安装 `pi-distill` 或 `pi-tool-supervisor` 时，宿主也会由共享运行时自动初始化。
+安装 `pi-distill` 或 `pi-tool-supervisor` 时，它们的包清单会同时加载这个宿主扩展入口。
 
 ## 开发
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-extensions-tool-display",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "Pi tool display host and shared result-rendering protocol for extensions",
   "type": "module",
   "main": "./index.ts",

package/src/index.ts

@@ -44,6 +44,14 @@ export function toolDisplayReloadRequired(
 
 const initializedHosts = new WeakSet<ExtensionAPI>();
 
+function hasRegisteredToolDisplayCommand(pi: ExtensionAPI): boolean {
+  try {
+    return pi.getCommands().some((command) => command.name === "tool-display");
+  } catch {
+    return false;
+  }
+}
+
 /**
  * Load the display host when a feature extension uses this package as a
  * dependency. Pi only auto-loads top-level packages, so relying on the
@@ -109,13 +117,18 @@ export function ensureToolDisplayHost(
     registerThinkingLabeling(pi);
   }
 
-  pi.registerCommand("tool-display", {
-    description: "Configure tool output rendering (OpenCode-style)",
-    handler: async (args, ctx) => {
-      const { runToolDisplayCommandHandler } = await import("./config-modal.js");
-      await runToolDisplayCommandHandler(args, ctx, { getConfig, setConfig, getCapabilities });
-    },
-  });
+  // Each Pi extension has its own registration map, while getCommands() sees
+  // the shared runtime. Check the latter so feature extensions do not expose
+  // duplicate /tool-display entries when they initialize this host separately.
+  if (!hasRegisteredToolDisplayCommand(pi)) {
+    pi.registerCommand("tool-display", {
+      description: "Configure tool output rendering (OpenCode-style)",
+      handler: async (args, ctx) => {
+        const { runToolDisplayCommandHandler } = await import("./config-modal.js");
+        await runToolDisplayCommandHandler(args, ctx, { getConfig, setConfig, getCapabilities });
+      },
+    });
+  }
 
   pi.on("session_start", async (_event, ctx) => {
     refreshCapabilities();