@trim21/personal-pi-extensions 0.0.214 → 0.0.216

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trim21/personal-pi-extensions",
-  "version": "0.0.214",
+  "version": "0.0.216",
   "type": "module",
   "description": "Custom pi coding-agent extensions: bwrap sandbox, workspace guard, opencode edit, and more",
   "keywords": [
@@ -40,7 +40,6 @@
     "eslint-plugin-erasable-syntax-only": "0.4.2",
     "eslint-plugin-promise": "7.3.0",
     "eslint-plugin-simple-import-sort": "14.0.0",
-    "eslint-plugin-tsdoc": "0.5.2",
     "eslint-plugin-unicorn": "73.0.0",
     "eslint-plugin-unused-imports": "4.4.1",
     "husky": "^9.1.7",

package/src/lib/pendant.ts

@@ -0,0 +1,16 @@
+/**
+ * 工具结果 details.pendant —— pi TUI 的 UI 扩展字段（本仓库约定，非 pi 官方 schema）。
+ *
+ * 工具 execute 返回的 details 里可携带一个可折叠的 markdown 面板，TUI 会把它
+ * 与本次工具调用的消息一起渲染：
+ * - `markdown`: 面板正文（完整 markdown），建议以 `## ` 标题开头、末尾 trim
+ * - `expanded`: 面板是否默认展开；识别/结果这类需要立即看到的内容用 true，
+ *   列表等常驻信息用 false
+ */
+export interface ToolPendant {
+  markdown: string;
+  /**
+   * @default false
+   */
+  expanded?: boolean;
+}

package/src/opencode-todo.ts

@@ -26,6 +26,8 @@ import { StringEnum } from "@earendil-works/pi-ai";
 import { type ExtensionAPI, truncateToVisualLines } from "@earendil-works/pi-coding-agent";
 import { Type } from "typebox";
 
+import { type ToolPendant } from "./lib/pendant.js";
+
 // ── constants ────────────────────────────────────────────────────────────────
 
 export const TOOL_NAME = "todowrite";
@@ -82,7 +84,7 @@ export interface TodoInfo {
 
 export interface TodoDetails {
   todos: TodoInfo[];
-  pendant: { markdown: string; expanded: boolean };
+  pendant?: ToolPendant;
 }
 
 // ── schema（与 opencode 的 Parameters 一致）──────────────────────────────────

package/src/vision-agent.ts

@@ -34,6 +34,8 @@ import {
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import { Type } from "typebox";
 
+import { type ToolPendant } from "./lib/pendant.js";
+
 // ── constants ────────────────────────────────────────────────────────────────
 
 export const TOOL_NAME = "describe_image";
@@ -444,7 +446,7 @@ export default function visionAgent(pi: ExtensionAPI) {
             pendant: {
               markdown,
               expanded: true,
-            },
+            } satisfies ToolPendant,
           },
         };
       } catch (error) {
@@ -464,7 +466,7 @@ export default function visionAgent(pi: ExtensionAPI) {
             pendant: {
               markdown: `## 图片识别失败\n\n${message}`,
               expanded: true,
-            },
+            } satisfies ToolPendant,
           },
         };
       }