pi-extensions-tool-display 1.1.2 → 1.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-extensions-tool-display",
-  "version": "1.1.2",
+  "version": "1.2.0",
   "description": "Pi tool display host and shared result-rendering protocol for extensions",
   "type": "module",
   "main": "./index.ts",
@@ -47,13 +47,17 @@
     "coding-agent",
     "tool-display"
   ],
+  "dependencies": {
+    "pi-extensions-i18n": "^0.5.0"
+  },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": ">=0.80.0",
     "@earendil-works/pi-tui": ">=0.80.0"
   },
   "pi": {
     "extensions": [
-      "./index.ts"
+      "./index.ts",
+      "../pi-extensions-i18n/index.ts"
     ],
     "skills": [
       "./SKILL.md"

package/src/config-modal.ts

@@ -11,6 +11,19 @@ import {
 import { shortenPath } from "./render-utils.js";
 import type { InspectorSettingItem } from "./settings-inspector-modal.js";
 import { type ToolDisplayConfig } from "./types.js";
+import {
+	notifyWithSource,
+	type NoticeColor,
+	type NoticeLevel,
+	type NoticeSource,
+} from "pi-extensions-i18n";
+
+/** 本扩展的提示标签；短且唯一，便于在会话里定位来源。 */
+const NOTICE_TAG = "display";
+/** 提示标签颜色；与其它扩展错开，避免看起来像同一条消息。 */
+const NOTICE_COLOR: NoticeColor = "muted";
+/** 本扩展的提示来源。 */
+const NOTICE_SOURCE: NoticeSource = { tag: NOTICE_TAG, color: NOTICE_COLOR };
 
 interface ToolDisplayConfigController {
 	getConfig(): ToolDisplayConfig;
@@ -18,6 +31,11 @@ interface ToolDisplayConfigController {
 	getCapabilities(): ToolDisplayCapabilities;
 }
 
+/** 带来源标签的用户提示；集中走统一出口，调用点不再直接碰 ctx.ui.notify。 */
+function notify(ctx: ExtensionCommandContext, message: string, level: NoticeLevel): void {
+	notifyWithSource({ ctx, source: NOTICE_SOURCE, level, message });
+}
+
 interface ModalOverlayOptions {
 	anchor: "center";
 	width: number;
@@ -483,7 +501,8 @@ export function handleToolDisplayArgs(args: string, ctx: ExtensionCommandContext
 	const normalized = raw.toLowerCase();
 
 	if (normalized === "show") {
-		ctx.ui.notify(
+		notify(
+			ctx,
 			`tool-display: ${summarizeConfig(controller.getConfig(), controller.getCapabilities())}`,
 			"info",
 		);
@@ -492,7 +511,7 @@ export function handleToolDisplayArgs(args: string, ctx: ExtensionCommandContext
 
 	if (normalized === "reset") {
 		controller.setConfig(applyPreset("opencode", controller.getConfig().enabled), ctx);
-		ctx.ui.notify("Tool display preset reset to opencode.", "info");
+		notify(ctx, "Tool display preset reset to opencode.", "info");
 		return true;
 	}
 
@@ -500,16 +519,16 @@ export function handleToolDisplayArgs(args: string, ctx: ExtensionCommandContext
 		const candidate = normalized.slice("preset ".length).trim();
 		const preset = parseToolDisplayPreset(candidate);
 		if (!preset) {
-			ctx.ui.notify(`Unknown preset. Use: /config:tool-display preset ${PRESET_COMMAND_HINT}`, "warning");
+			notify(ctx, `Unknown preset. Use: /config:tool-display preset ${PRESET_COMMAND_HINT}`, "warning");
 			return true;
 		}
 
 		controller.setConfig(applyPreset(preset, controller.getConfig().enabled), ctx);
-		ctx.ui.notify(`Tool display preset set to ${preset}.`, "info");
+		notify(ctx, `Tool display preset set to ${preset}.`, "info");
 		return true;
 	}
 
-	ctx.ui.notify(`Usage: /config:tool-display [show|reset|preset ${PRESET_COMMAND_HINT}]`, "warning");
+	notify(ctx, `Usage: /config:tool-display [show|reset|preset ${PRESET_COMMAND_HINT}]`, "warning");
 	return true;
 }
 
@@ -523,7 +542,7 @@ export async function runToolDisplayCommandHandler(
 	}
 
 	if (!ctx.hasUI) {
-		ctx.ui.notify("/config:tool-display requires interactive TUI mode.", "warning");
+		notify(ctx, "/config:tool-display requires interactive TUI mode.", "warning");
 		return;
 	}
 

package/src/index.ts

@@ -22,6 +22,18 @@ import {
   type ConfigLoadResult,
   type ToolDisplayConfig,
 } from "./types.js";
+import {
+  notifyWithSource,
+  type NoticeColor,
+  type NoticeSource,
+} from "pi-extensions-i18n";
+
+/** 本扩展的提示标签；短且唯一，便于在会话里定位来源。 */
+const NOTICE_TAG = "display";
+/** 提示标签颜色；与其它扩展错开，避免看起来像同一条消息。 */
+const NOTICE_COLOR: NoticeColor = "muted";
+/** 本扩展的提示来源。 */
+const NOTICE_SOURCE: NoticeSource = { tag: NOTICE_TAG, color: NOTICE_COLOR };
 
 export * from "./result-render-middleware.js";
 
@@ -118,14 +130,16 @@ export function ensureToolDisplayHost(
 
     const saved = saveToolDisplayConfig(normalized);
     if (!saved.success && saved.error) {
-      ctx.ui.notify(saved.error, "error");
+      notifyWithSource({ ctx, source: NOTICE_SOURCE, level: "error", message: saved.error });
     }
 
     if (requiresReload) {
-      ctx.ui.notify(
-        "Global switch or tool ownership updates apply after /reload.",
-        "warning",
-      );
+      notifyWithSource({
+        ctx,
+        source: NOTICE_SOURCE,
+        level: "warning",
+        message: "Global switch or tool ownership updates apply after /reload.",
+      });
     }
   };
 
@@ -152,7 +166,7 @@ export function ensureToolDisplayHost(
   pi.on("session_start", async (_event, ctx) => {
     refreshCapabilities();
     if (pendingLoadError) {
-      ctx.ui.notify(pendingLoadError, "warning");
+      notifyWithSource({ ctx, source: NOTICE_SOURCE, level: "warning", message: pendingLoadError });
       pendingLoadError = undefined;
     }
   });

package/src/thinking-label.ts

@@ -1,6 +1,18 @@
 import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
 import { isRecord } from "./tool-metadata.js";
 import { onReloadShutdown } from "./extension-lifecycle.js";
+import {
+  notifyWithSource,
+  type NoticeColor,
+  type NoticeSource,
+} from "pi-extensions-i18n";
+
+/** 本扩展的提示标签；短且唯一，便于在会话里定位来源。 */
+const NOTICE_TAG = "display";
+/** 提示标签颜色；与其它扩展错开，避免看起来像同一条消息。 */
+const NOTICE_COLOR: NoticeColor = "muted";
+/** 本扩展的提示来源。 */
+const NOTICE_SOURCE: NoticeSource = { tag: NOTICE_TAG, color: NOTICE_COLOR };
 
 interface ThemeLike {
   fg(color: string, text: string): string;
@@ -286,7 +298,7 @@ function processThinkingEvent(
     prefixThinkingBlocksForDisplay(message, ctx?.ui?.theme);
   } catch (error) {
     const errorMessage = error instanceof Error ? error.message : "Unknown error";
-    ctx?.ui?.notify(`${notifyPrefix}: ${errorMessage}`, "warning");
+    if (ctx) notifyWithSource({ ctx, source: NOTICE_SOURCE, level: "warning", message: `${notifyPrefix}: ${errorMessage}` });
   }
 }
 
@@ -315,7 +327,7 @@ function handleThinkingContextEvent(event: unknown, ctx: ExtensionContext | unde
     }
   } catch (error) {
     const message = error instanceof Error ? error.message : "Unknown error";
-    ctx?.ui?.notify(`Thinking context sanitization failed: ${message}`, "warning");
+    if (ctx) notifyWithSource({ ctx, source: NOTICE_SOURCE, level: "warning", message: `Thinking context sanitization failed: ${message}` });
   }
 }