@trim21/personal-pi-extensions 0.0.329 → 0.0.331

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trim21/personal-pi-extensions",
-  "version": "0.0.329",
+  "version": "0.0.331",
   "type": "module",
   "description": "Custom pi coding-agent extensions: bwrap sandbox, workspace guard, opencode edit, and more",
   "keywords": [

package/src/gh-readonly.ts

@@ -38,6 +38,7 @@ import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import { Type } from "typebox";
 import { Value } from "typebox/value";
 
+import { type ToolPendant } from "./lib/pendant.js";
 import { createSeqState } from "./lib/seq-state.js";
 
 interface GhResult {
@@ -304,6 +305,25 @@ function toToolResult(
   };
 }
 
+/**
+ * Pendant subtitle for a tool result: `repo=x/y` (when provided) plus the
+ * tool's id parameter, e.g. `repo=x/y number=123`. Returns undefined when
+ * neither is available, so the pendant is omitted rather than shown empty.
+ */
+function subtitlePendant(
+  params: { repo?: string } & Record<string, unknown>,
+  idKey?: string,
+): ToolPendant | undefined {
+  const parts: string[] = [];
+  if (params.repo) parts.push(`repo=${params.repo}`);
+  if (idKey) {
+    const id = params[idKey];
+    if (typeof id === "string" || typeof id === "number") parts.push(`${idKey}=${id}`);
+  }
+  if (parts.length === 0) return undefined;
+  return { subtitle: parts.join(" ") };
+}
+
 interface ListFilters {
   repo?: string;
   keywords?: string;
@@ -1120,7 +1140,7 @@ export default function ghReadonlyTools(pi: ExtensionAPI) {
     }),
     async execute(_id, params, signal, _onUpdate, ctx) {
       const { number, repo } = params;
-      return toToolResult(
+      const result = toToolResult(
         await ghExec(
           [
             "issue",
@@ -1134,6 +1154,8 @@ export default function ghReadonlyTools(pi: ExtensionAPI) {
         ),
         params,
       );
+      result.details.pendant = subtitlePendant(params, "number");
+      return result;
     },
   });
 
@@ -1155,10 +1177,12 @@ export default function ghReadonlyTools(pi: ExtensionAPI) {
       limit: Type.Optional(Type.Number({ description: "Max results (default 30)" })),
     }),
     async execute(_id, params, signal, _onUpdate, ctx) {
-      return toToolResult(
+      const result = toToolResult(
         await listGithub("issue", params, { cwd: ctx.cwd, signal, input: params }),
         params,
       );
+      result.details.pendant = subtitlePendant(params);
+      return result;
     },
   });
 
@@ -1174,7 +1198,7 @@ export default function ghReadonlyTools(pi: ExtensionAPI) {
     }),
     async execute(_id, params, signal, _onUpdate, ctx) {
       const { number, repo } = params;
-      return toToolResult(
+      const result = toToolResult(
         await ghExec(
           [
             "pr",
@@ -1188,6 +1212,8 @@ export default function ghReadonlyTools(pi: ExtensionAPI) {
         ),
         params,
       );
+      result.details.pendant = subtitlePendant(params, "number");
+      return result;
     },
   });
 
@@ -1211,10 +1237,12 @@ export default function ghReadonlyTools(pi: ExtensionAPI) {
       limit: Type.Optional(Type.Number({ description: "Max results (default 30)" })),
     }),
     async execute(_id, params, signal, _onUpdate, ctx) {
-      return toToolResult(
+      const result = toToolResult(
         await listGithub("pr", params, { cwd: ctx.cwd, signal, input: params }),
         params,
       );
+      result.details.pendant = subtitlePendant(params);
+      return result;
     },
   });
 
@@ -1231,7 +1259,12 @@ export default function ghReadonlyTools(pi: ExtensionAPI) {
     async execute(_id, params, signal, _onUpdate, ctx) {
       const { number, repo } = params;
       const args = ["pr", "diff", String(number), ...repoArgs(repo)];
-      return toToolResult(await ghExec(args, { cwd: ctx.cwd, signal, input: params }), params);
+      const result = toToolResult(
+        await ghExec(args, { cwd: ctx.cwd, signal, input: params }),
+        params,
+      );
+      result.details.pendant = subtitlePendant(params, "number");
+      return result;
     },
   });
 
@@ -1259,7 +1292,9 @@ export default function ghReadonlyTools(pi: ExtensionAPI) {
         // Anything else is a real error (cancelled, auth, network, ...)
         throw new GhError(args, result, params);
       }
-      return toToolResult(result.stdout, params);
+      const toolResult = toToolResult(result.stdout, params);
+      toolResult.details.pendant = subtitlePendant(params, "number");
+      return toolResult;
     },
   });
 
@@ -1321,9 +1356,10 @@ export default function ghReadonlyTools(pi: ExtensionAPI) {
         );
       }
       const { text, truncated } = truncate(out);
+      const pendant = subtitlePendant(params, "number");
       return {
         content: [{ type: "text", text }],
-        details: { input: params, truncated },
+        details: { input: params, truncated, ...(pendant && { pendant }) },
       };
     },
   });
@@ -1340,7 +1376,7 @@ export default function ghReadonlyTools(pi: ExtensionAPI) {
     }),
     async execute(_id, params, signal, _onUpdate, ctx) {
       const { number, repo } = params;
-      return toToolResult(
+      const result = toToolResult(
         await ghExec(["issue", "view", String(number), ...repoArgs(repo), "--json", "comments"], {
           cwd: ctx.cwd,
           signal,
@@ -1348,6 +1384,8 @@ export default function ghReadonlyTools(pi: ExtensionAPI) {
         }),
         params,
       );
+      result.details.pendant = subtitlePendant(params, "number");
+      return result;
     },
   });
 
@@ -1371,7 +1409,12 @@ export default function ghReadonlyTools(pi: ExtensionAPI) {
       if (limit) args.push("--limit", String(limit));
       if (status) args.push("--status", status);
       if (workflow) args.push("--workflow", workflow);
-      return toToolResult(await ghExec(args, { cwd: ctx.cwd, signal, input: params }), params);
+      const result = toToolResult(
+        await ghExec(args, { cwd: ctx.cwd, signal, input: params }),
+        params,
+      );
+      result.details.pendant = subtitlePendant(params);
+      return result;
     },
   });
 
@@ -1424,6 +1467,7 @@ export default function ghReadonlyTools(pi: ExtensionAPI) {
     async execute(_id, params, signal, onUpdate, ctx) {
       const { run_id, repo, job, step, offset, limit, full, output_file } = params;
 
+      const pendant = subtitlePendant(params, "run_id");
       const effectiveRepo = await resolveRepo(repo, signal, ctx.cwd, params);
       const jobsOut = await ghExec(["api", `/repos/${effectiveRepo}/actions/runs/${run_id}/jobs`], {
         cwd: ctx.cwd,
@@ -1437,13 +1481,14 @@ export default function ghReadonlyTools(pi: ExtensionAPI) {
 
       // ── Write the complete log to a file ───────────────────────────────
       if (output_file !== undefined && output_file !== null && output_file !== "") {
-        return writeLogFile(
+        const result = await writeLogFile(
           { runId: String(run_id), job, step, outputFile: output_file },
           jobs,
           fetchJobLog,
           ctx.cwd,
           params,
         );
+        return { ...result, details: { ...result.details, ...(pendant && { pendant }) } };
       }
 
       // ── Fetch a specific step's logs (requires `job`) ─────────────────
@@ -1458,7 +1503,10 @@ export default function ghReadonlyTools(pi: ExtensionAPI) {
           fetchJobLog,
           onUpdate,
         );
-        return { ...stepResult, details: { ...stepResult.details, input: params } };
+        return {
+          ...stepResult,
+          details: { ...stepResult.details, input: params, ...(pendant && { pendant }) },
+        };
       }
 
       // ── List jobs/steps, with failed step logs expanded ────────────────
@@ -1471,7 +1519,10 @@ export default function ghReadonlyTools(pi: ExtensionAPI) {
         jobs,
         fetchJobLog,
       );
-      return { ...jobsResult, details: { ...jobsResult.details, input: params } };
+      return {
+        ...jobsResult,
+        details: { ...jobsResult.details, input: params, ...(pendant && { pendant }) },
+      };
     },
   });
 
@@ -1489,7 +1540,7 @@ export default function ghReadonlyTools(pi: ExtensionAPI) {
     async execute(_id, params, signal, _onUpdate, ctx) {
       const { run_id, repo } = params;
       const effectiveRepo = await resolveRepo(repo, signal, ctx.cwd, params);
-      return toToolResult(
+      const result = toToolResult(
         await ghExec(["api", `/repos/${effectiveRepo}/actions/runs/${run_id}/jobs`], {
           cwd: ctx.cwd,
           signal,
@@ -1497,6 +1548,8 @@ export default function ghReadonlyTools(pi: ExtensionAPI) {
         }),
         params,
       );
+      result.details.pendant = subtitlePendant(params, "run_id");
+      return result;
     },
   });
 
@@ -1513,7 +1566,12 @@ export default function ghReadonlyTools(pi: ExtensionAPI) {
       const { repo } = params;
       const args = ["repo", "view"];
       if (repo) args.push(repo);
-      return toToolResult(await ghExec(args, { cwd: ctx.cwd, signal, input: params }), params);
+      const result = toToolResult(
+        await ghExec(args, { cwd: ctx.cwd, signal, input: params }),
+        params,
+      );
+      result.details.pendant = subtitlePendant(params);
+      return result;
     },
   });
 
@@ -1531,7 +1589,12 @@ export default function ghReadonlyTools(pi: ExtensionAPI) {
       const { repo, limit } = params;
       const args = ["release", "list", ...repoArgs(repo)];
       if (limit) args.push("--limit", String(limit));
-      return toToolResult(await ghExec(args, { cwd: ctx.cwd, signal, input: params }), params);
+      const result = toToolResult(
+        await ghExec(args, { cwd: ctx.cwd, signal, input: params }),
+        params,
+      );
+      result.details.pendant = subtitlePendant(params);
+      return result;
     },
   });
 
@@ -1547,7 +1610,7 @@ export default function ghReadonlyTools(pi: ExtensionAPI) {
     }),
     async execute(_id, params, signal, _onUpdate, ctx) {
       const { tag, repo } = params;
-      return toToolResult(
+      const result = toToolResult(
         await ghExec(["release", "view", tag, ...repoArgs(repo)], {
           cwd: ctx.cwd,
           signal,
@@ -1555,6 +1618,8 @@ export default function ghReadonlyTools(pi: ExtensionAPI) {
         }),
         params,
       );
+      result.details.pendant = subtitlePendant(params, "tag");
+      return result;
     },
   });
 
@@ -1576,6 +1641,7 @@ export default function ghReadonlyTools(pi: ExtensionAPI) {
     async execute(_id, params, signal, onUpdate, ctx) {
       const { number, repo, fail_fast } = params;
 
+      const pendant = subtitlePendant(params, "number");
       onUpdate?.({
         content: [{ type: "text", text: `Watching CI checks for PR #${number}...` }],
         details: {},
@@ -1657,7 +1723,12 @@ export default function ghReadonlyTools(pi: ExtensionAPI) {
               text: `## PR #${number} CI Checks\n\nNo workflow runs found for head commit ${headRefOid.slice(0, 7)}.`,
             },
           ],
-          details: { status: "no-jobs", totalJobs: 0, input: params },
+          details: {
+            status: "no-jobs",
+            totalJobs: 0,
+            input: params,
+            ...(pendant && { pendant }),
+          },
         };
       }
 
@@ -1681,6 +1752,7 @@ export default function ghReadonlyTools(pi: ExtensionAPI) {
             totalJobs,
             failedJobs,
             input: params,
+            ...(pendant && { pendant }),
           },
         };
       }
@@ -1692,7 +1764,7 @@ export default function ghReadonlyTools(pi: ExtensionAPI) {
             text: `## PR #${number} CI Checks - PASSED\n\nAll ${totalJobs} job(s) succeeded.`,
           },
         ],
-        details: { status: "success", totalJobs, input: params },
+        details: { status: "success", totalJobs, input: params, ...(pendant && { pendant }) },
       };
     },
   });
@@ -1712,6 +1784,7 @@ export default function ghReadonlyTools(pi: ExtensionAPI) {
     async execute(_id, params, signal, onUpdate, ctx) {
       const { run_id, repo } = params;
 
+      const pendant = subtitlePendant(params, "run_id");
       onUpdate?.({
         content: [{ type: "text", text: `Watching workflow run ${run_id}...` }],
         details: {},
@@ -1731,7 +1804,7 @@ export default function ghReadonlyTools(pi: ExtensionAPI) {
         content: [
           { type: "text", text: `## Workflow Run ${run_id} Completed\n\n${result.stdout}` },
         ],
-        details: { exitCode: 0, input: params },
+        details: { exitCode: 0, input: params, ...(pendant && { pendant }) },
       };
     },
   });

package/src/lib/pendant.ts

@@ -16,7 +16,10 @@ export interface ToolPendant {
    * 面板副标题
    */
   subtitle?: string;
-  markdown: string;
+  /**
+   * 面板正文（完整 markdown），建议以 `## ` 标题开头、末尾 trim
+   */
+  markdown?: string;
   /**
    * @default false
    */