@trim21/personal-pi-extensions 0.1.594 → 0.1.596

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trim21/personal-pi-extensions",
-  "version": "0.1.594",
+  "version": "0.1.596",
   "type": "module",
   "description": "Custom pi coding-agent extensions: bwrap sandbox, workspace guard, opencode edit, and more",
   "keywords": [
@@ -99,7 +99,7 @@
     "node": ">=24.14"
   },
   "dependencies": {
-    "@cortexkit/aft-bridge": "0.55.1",
+    "@cortexkit/aft-bridge": "0.57.1",
     "@mozilla/readability": "^0.6.0",
     "@parcel/watcher": "^2.6.0",
     "@vscode/tree-sitter-wasm": "^0.3.1",
@@ -115,6 +115,6 @@
     "web-tree-sitter": "^0.27.0"
   },
   "optionalDependencies": {
-    "@cortexkit/aft-linux-x64": "0.55.1"
+    "@cortexkit/aft-linux-x64": "0.57.1"
   }
 }

package/src/gh/base.ts

@@ -151,11 +151,11 @@ export function runGh(
       resolve({
         stdout,
         stderr,
-        // When killed by a signal the close event's code is null; report the
-        // process as failed instead of pretending it succeeded. -1 is a
-        // sentinel for "did not exit normally" — distinct from a real gh
-        // failure exit code (1), which is always in 0-255.
-        code: code ?? (killed ? -1 : 0),
+        // When killed by a signal the close event's code is null — including
+        // kills we did not initiate. Report failure instead of pretending it
+        // succeeded. -1 is a sentinel for "did not exit normally" — distinct
+        // from a real gh failure exit code (1), which is always in 0-255.
+        code: code ?? -1,
         killed,
         combined: combined.join(""),
         reason: killReason,
@@ -309,11 +309,19 @@ export function truncate(
     out.push(line);
     bytes += lineBytes;
   }
-  return { text: out.join("\n"), truncated: true };
+  if (out.length > 0) return { text: out.join("\n"), truncated: true };
+
+  // 首行自己就超过 maxBytes（如单行超长文本）：保底保留字节前缀，
+  // 不能把非空输出截成空字符串。
+  return {
+    text: Buffer.from(text, "utf8").subarray(0, maxBytes).toString("utf8"),
+    truncated: true,
+  };
 }
 
 /**
- * Format a successful gh invocation's stdout into a tool result.
+ * Format a successful gh invocation's text stdout into a tool result,
+ * line-truncated. JSON output must go through `toToolResultJson` instead.
  * Failures are thrown by `ghExec` as `GhError`, so only the success path lives here.
  */
 export function toToolResult(
@@ -330,6 +338,19 @@ export function toToolResult(
   };
 }
 
+/**
+ * Format a successful gh invocation's JSON stdout into a tool result, passed
+ * through whole. Line-based truncation must not touch JSON: it would cut the
+ * payload into invalid JSON, and since `gh --json` prints one line, any
+ * over-budget payload used to be blanked entirely.
+ */
+export function toToolResultJson(json: string, input?: unknown): ToolResult {
+  return {
+    content: [{ type: "text", text: json }],
+    details: { ...(input !== undefined && { input }), truncated: false },
+  };
+}
+
 /**
  * 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

package/src/gh/tools/get-workflow-jobs.ts

@@ -9,7 +9,7 @@ import {
   type ToolCall,
   type ToolResult,
   toPositiveId,
-  toToolResult,
+  toToolResultJson,
 } from "../base.js";
 
 interface RunIdParams {
@@ -25,7 +25,7 @@ async function workflowJobs(gh: GhClient, call: ToolCall<RunIdParams>): Promise<
   const { owner, repo: name } = splitRepo(effectiveRepo);
 
   const jobs = await gh.checks.runJobs(owner, name, runId, signal);
-  const result = toToolResult(JSON.stringify({ total_count: jobs.length, jobs }), params);
+  const result = toToolResultJson(JSON.stringify({ total_count: jobs.length, jobs }), params);
   result.details.pendant = subtitlePendant(params, "run_id");
   return result;
 }

package/src/gh/tools/read-issue-comments.ts

@@ -1,7 +1,7 @@
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import { Type } from "typebox";
 
-import { type GhClient, ghExec, repoArgs, subtitlePendant, toToolResult } from "../base.js";
+import { type GhClient, ghExec, repoArgs, subtitlePendant, toToolResultJson } from "../base.js";
 
 export function addReadIssueCommentsTool(_gh: GhClient, pi: ExtensionAPI) {
   pi.registerTool({
@@ -15,7 +15,7 @@ export function addReadIssueCommentsTool(_gh: GhClient, pi: ExtensionAPI) {
     }),
     async execute(_id, params, signal, _onUpdate, ctx) {
       const { number, repo } = params;
-      const result = toToolResult(
+      const result = toToolResultJson(
         await ghExec(["issue", "view", String(number), ...repoArgs(repo), "--json", "comments"], {
           cwd: ctx.cwd,
           signal,

package/src/gh/tools/read-issue.ts

@@ -1,7 +1,7 @@
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import { Type } from "typebox";
 
-import { type GhClient, ghExec, repoArgs, subtitlePendant, toToolResult } from "../base.js";
+import { type GhClient, ghExec, repoArgs, subtitlePendant, toToolResultJson } from "../base.js";
 
 export function addReadIssueTool(_gh: GhClient, pi: ExtensionAPI) {
   pi.registerTool({
@@ -15,7 +15,7 @@ export function addReadIssueTool(_gh: GhClient, pi: ExtensionAPI) {
     }),
     async execute(_id, params, signal, _onUpdate, ctx) {
       const { number, repo } = params;
-      const result = toToolResult(
+      const result = toToolResultJson(
         await ghExec(
           [
             "issue",

package/src/gh/tools/read-pr-comments.ts

@@ -8,7 +8,7 @@ import {
   repoArgs,
   resolveRepo,
   subtitlePendant,
-  truncate,
+  toToolResultJson,
 } from "../base.js";
 
 export function addReadPrCommentsTool(_gh: GhClient, pi: ExtensionAPI) {
@@ -65,12 +65,9 @@ export function addReadPrCommentsTool(_gh: GhClient, pi: ExtensionAPI) {
           },
         );
       }
-      const { text, truncated } = truncate(out);
-      const pendant = subtitlePendant(params, "number");
-      return {
-        content: [{ type: "text", text }],
-        details: { input: params, truncated, ...(pendant && { pendant }) },
-      };
+      const result = toToolResultJson(out, params);
+      result.details.pendant = subtitlePendant(params, "number");
+      return result;
     },
   });
 }

package/src/gh/tools/read-pr.ts

@@ -1,7 +1,7 @@
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import { Type } from "typebox";
 
-import { type GhClient, ghExec, repoArgs, subtitlePendant, toToolResult } from "../base.js";
+import { type GhClient, ghExec, repoArgs, subtitlePendant, toToolResultJson } from "../base.js";
 
 export function addReadPrTool(_gh: GhClient, pi: ExtensionAPI) {
   pi.registerTool({
@@ -15,7 +15,7 @@ export function addReadPrTool(_gh: GhClient, pi: ExtensionAPI) {
     }),
     async execute(_id, params, signal, _onUpdate, ctx) {
       const { number, repo } = params;
-      const result = toToolResult(
+      const result = toToolResultJson(
         await ghExec(
           [
             "pr",