@trim21/personal-pi-extensions 0.0.245 → 0.0.247

package/package.json

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

package/src/claude-code/common.ts

@@ -12,19 +12,16 @@ import {
   sep,
 } from "node:path";
 
-import { Type } from "typebox";
+import { type Static, Type } from "typebox";
 import { Value } from "typebox/value";
 
-export interface FileSnapshot {
-  digest: string;
-  textEditable: boolean;
-}
-
 const fileSnapshotSchema = Type.Object({
   digest: Type.String(),
   textEditable: Type.Boolean(),
 });
 
+export type FileSnapshot = Static<typeof fileSnapshotSchema>;
+
 export interface ClaudeCodeState {
   readonly reads: Map<string, FileSnapshot>;
 }

package/src/claude-code/files.ts

@@ -187,6 +187,7 @@ export function registerFileTools(pi: ExtensionAPI, state: ClaudeCodeState): voi
     label: "Read",
     description: [
       "Reads a file from the local filesystem. You can access any file directly using this tool.",
+      "Assume this tool is able to read all files on the machine. If the User provides a path to a file assume that path is valid. It is okay to read a file that does not exist; an error will be returned.",
       "The file_path parameter must be an absolute path. By default, it reads the entire file; files over 256 KB or 25K tokens require offset and limit.",
       "Results use cat -n style line numbers starting at 1. Images are returned visually.",
       "This tool reads files, not directories.",
@@ -294,7 +295,9 @@ export function registerFileTools(pi: ExtensionAPI, state: ClaudeCodeState): voi
       {
         file_path: Type.String({ description: "The absolute path to the file to modify" }),
         old_string: Type.String({ description: "The text to replace" }),
-        new_string: Type.String({ description: "The text to replace it with" }),
+        new_string: Type.String({
+          description: "The text to replace it with (must be different from old_string)",
+        }),
         replace_all: Type.Optional(
           Type.Boolean({ description: "Replace all occurrences of old_string", default: false }),
         ),

package/src/claude-code/glob.ts

@@ -118,7 +118,7 @@ export function registerGlobTool(pi: ExtensionAPI): void {
         path: Type.Optional(
           Type.String({
             description:
-              "The directory to search in. If omitted, the current working directory is used.",
+              'The directory to search in. If not specified, the current working directory will be used. IMPORTANT: Omit this field to use the default directory. DO NOT enter "undefined" or "null" - simply omit it for the default behavior. Must be a valid directory path if provided.',
           }),
         ),
       },

package/src/claude-code/grep.ts

@@ -15,14 +15,12 @@ import { fileURLToPath } from "node:url";
 
 import { StringEnum } from "@earendil-works/pi-ai";
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
-import { Type } from "typebox";
+import { type Static, Type } from "typebox";
 
 import { searchRoot, suggestPathUnderCwd, throwIfAborted, toRelativePath } from "./common.js";
 
 const GREP_OUTPUT_MODES = ["content", "files_with_matches", "count"] as const;
 
-type GrepOutputMode = (typeof GREP_OUTPUT_MODES)[number];
-
 /** Tool guidance, kept in markdown so it reads like documentation. */
 const GREP_PROMPT = readFileSync(fileURLToPath(new URL("grep.md", import.meta.url)), "utf8").trim();
 
@@ -41,22 +39,49 @@ function truncateOutput(output: string, maxCharacters = 30_000): string {
   return `${output.slice(0, maxCharacters)}\n\n[Output truncated at ${maxCharacters} characters]`;
 }
 
-interface GrepParameters {
-  pattern: string;
-  path?: string;
-  glob?: string;
-  output_mode?: GrepOutputMode;
-  "-B"?: number;
-  "-A"?: number;
-  "-C"?: number;
-  context?: number;
-  "-n"?: boolean;
-  "-i"?: boolean;
-  type?: string;
-  head_limit?: number;
-  offset?: number;
-  multiline?: boolean;
-}
+const grepParametersSchema = Type.Object(
+  {
+    pattern: Type.String({ description: "The regular expression pattern to search for" }),
+    path: Type.Optional(
+      Type.String({
+        description: "File or directory to search. Defaults to the current directory.",
+      }),
+    ),
+    glob: Type.Optional(Type.String({ description: 'Glob filter such as "*.js" or "*.{ts,tsx}"' })),
+    output_mode: Type.Optional(
+      StringEnum(GREP_OUTPUT_MODES, {
+        description: "Output mode. Defaults to files_with_matches.",
+      }),
+    ),
+    "-B": Type.Optional(
+      Type.Number({ description: "Lines to show before each match in content mode" }),
+    ),
+    "-A": Type.Optional(
+      Type.Number({ description: "Lines to show after each match in content mode" }),
+    ),
+    "-C": Type.Optional(Type.Number({ description: "Lines to show before and after each match" })),
+    context: Type.Optional(
+      Type.Number({ description: "Lines to show before and after each match" }),
+    ),
+    "-n": Type.Optional(
+      Type.Boolean({ description: "Show line numbers in content mode; defaults true" }),
+    ),
+    "-i": Type.Optional(Type.Boolean({ description: "Case-insensitive search" })),
+    type: Type.Optional(
+      Type.String({ description: "ripgrep file type such as js, py, rust, or go" }),
+    ),
+    head_limit: Type.Optional(
+      Type.Number({ description: "Limit output to the first N entries after offset" }),
+    ),
+    offset: Type.Optional(Type.Number({ description: "Skip the first N output entries" })),
+    multiline: Type.Optional(
+      Type.Boolean({ description: "Allow patterns to span multiple lines" }),
+    ),
+  },
+  { additionalProperties: false },
+);
+
+type GrepParameters = Static<typeof grepParametersSchema>;
 
 export function buildGrepArguments(params: GrepParameters, cwd: string): string[] {
   const mode = params.output_mode ?? "files_with_matches";
@@ -217,51 +242,7 @@ export function registerGrepTool(pi: ExtensionAPI): void {
     ].join("\n"),
     promptSnippet: "Search file contents with regular expressions",
     promptGuidelines: [`- -\n${GREP_PROMPT}`],
-    parameters: Type.Object(
-      {
-        pattern: Type.String({ description: "The regular expression pattern to search for" }),
-        path: Type.Optional(
-          Type.String({
-            description: "File or directory to search. Defaults to the current directory.",
-          }),
-        ),
-        glob: Type.Optional(
-          Type.String({ description: 'Glob filter such as "*.js" or "*.{ts,tsx}"' }),
-        ),
-        output_mode: Type.Optional(
-          StringEnum(GREP_OUTPUT_MODES, {
-            description: "Output mode. Defaults to files_with_matches.",
-          }),
-        ),
-        "-B": Type.Optional(
-          Type.Number({ description: "Lines to show before each match in content mode" }),
-        ),
-        "-A": Type.Optional(
-          Type.Number({ description: "Lines to show after each match in content mode" }),
-        ),
-        "-C": Type.Optional(
-          Type.Number({ description: "Lines to show before and after each match" }),
-        ),
-        context: Type.Optional(
-          Type.Number({ description: "Lines to show before and after each match" }),
-        ),
-        "-n": Type.Optional(
-          Type.Boolean({ description: "Show line numbers in content mode; defaults true" }),
-        ),
-        "-i": Type.Optional(Type.Boolean({ description: "Case-insensitive search" })),
-        type: Type.Optional(
-          Type.String({ description: "ripgrep file type such as js, py, rust, or go" }),
-        ),
-        head_limit: Type.Optional(
-          Type.Number({ description: "Limit output to the first N entries after offset" }),
-        ),
-        offset: Type.Optional(Type.Number({ description: "Skip the first N output entries" })),
-        multiline: Type.Optional(
-          Type.Boolean({ description: "Allow patterns to span multiple lines" }),
-        ),
-      },
-      { additionalProperties: false },
-    ),
+    parameters: grepParametersSchema,
     async execute(_id, params, signal, _onUpdate, ctx) {
       if (
         params.offset !== undefined &&

package/src/claude-code/session-tools.ts

@@ -1,6 +1,6 @@
 import { StringEnum } from "@earendil-works/pi-ai";
 import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
-import { Type } from "typebox";
+import { type Static, Type } from "typebox";
 import { Value } from "typebox/value";
 
 import { selectWithOptionalInput } from "../lib/ui.js";
@@ -18,23 +18,48 @@ const ASK_PROMPT = [
 
 type TodoStatus = (typeof TODO_STATUSES)[number];
 
-export interface ClaudeCodeTodo {
-  content: string;
-  status: TodoStatus;
-  activeForm: string;
-}
+const todoItemSchema = Type.Object(
+  {
+    content: Type.String({ minLength: 1 }),
+    status: StringEnum(TODO_STATUSES),
+    activeForm: Type.String({ minLength: 1 }),
+  },
+  { additionalProperties: false },
+);
+const todoSchema = Type.Object(
+  {
+    todos: Type.Array(todoItemSchema, { description: "The updated todo list" }),
+  },
+  { additionalProperties: false },
+);
 
-interface QuestionOption {
-  label: string;
-  description: string;
-}
+export type ClaudeCodeTodo = Static<typeof todoItemSchema>;
 
-interface QuestionInput {
-  question: string;
-  header: string;
-  options: QuestionOption[];
-  multiSelect: boolean;
-}
+const optionSchema = Type.Object(
+  {
+    label: Type.String({ description: "Concise display text for the option" }),
+    description: Type.String({ description: "Explanation of the option" }),
+  },
+  { additionalProperties: false },
+);
+const questionSchema = Type.Object(
+  {
+    question: Type.String({ description: "The complete question to ask" }),
+    header: Type.String({ description: "Very short label displayed with the question" }),
+    options: Type.Array(optionSchema, {
+      minItems: 2,
+      maxItems: 4,
+      description: "The available choices; do not include an Other option",
+    }),
+    multiSelect: Type.Boolean({
+      default: false,
+      description: "Allow the user to select multiple options",
+    }),
+  },
+  { additionalProperties: false },
+);
+
+type QuestionInput = Static<typeof questionSchema>;
 
 function formatTodos(todos: readonly ClaudeCodeTodo[]): string[] | undefined {
   if (todos.length === 0) return undefined;
@@ -103,21 +128,6 @@ async function askMultiple(
 }
 
 export function registerSessionTools(pi: ExtensionAPI): void {
-  const todoItemSchema = Type.Object(
-    {
-      content: Type.String({ minLength: 1 }),
-      status: StringEnum(TODO_STATUSES),
-      activeForm: Type.String({ minLength: 1 }),
-    },
-    { additionalProperties: false },
-  );
-  const todoSchema = Type.Object(
-    {
-      todos: Type.Array(todoItemSchema, { description: "The updated todo list" }),
-    },
-    { additionalProperties: false },
-  );
-
   // TodoWrite 的列表随工具结果 details 持久化（跟随会话分支），但 widget 是
   // 纯 TUI 状态，进程重启后丢失。session 恢复时从当前分支取最后一个 TodoWrite
   // 的列表重新渲染（完整列表替换语义，后出现的覆盖前面的）。
@@ -167,30 +177,6 @@ export function registerSessionTools(pi: ExtensionAPI): void {
     },
   });
 
-  const optionSchema = Type.Object(
-    {
-      label: Type.String({ description: "Concise display text for the option" }),
-      description: Type.String({ description: "Explanation of the option" }),
-    },
-    { additionalProperties: false },
-  );
-  const questionSchema = Type.Object(
-    {
-      question: Type.String({ description: "The complete question to ask" }),
-      header: Type.String({ description: "Very short label displayed with the question" }),
-      options: Type.Array(optionSchema, {
-        minItems: 2,
-        maxItems: 4,
-        description: "The available choices; do not include an Other option",
-      }),
-      multiSelect: Type.Boolean({
-        default: false,
-        description: "Allow the user to select multiple options",
-      }),
-    },
-    { additionalProperties: false },
-  );
-
   pi.registerTool({
     name: "AskUserQuestion",
     label: "Ask User Question",

package/src/opencode/question.ts

@@ -21,7 +21,7 @@
  */
 
 import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
-import { Type } from "typebox";
+import { type Static, Type } from "typebox";
 
 import { selectWithOptionalInput } from "../lib/ui.js";
 
@@ -47,34 +47,6 @@ export const QUESTION_DESCRIPTION = [
   '- If you recommend a specific option, make that the first option in the list and add "(Recommended)" at the end of the label',
 ].join("\n");
 
-// ── types ────────────────────────────────────────────────────────────────────
-
-export interface QuestionOption {
-  label: string;
-  description: string;
-}
-
-/** 与 schema 对齐的输入形状（multiple 可选） */
-export interface QuestionInput {
-  question: string;
-  header: string;
-  options: QuestionOption[];
-  multiple?: boolean;
-}
-
-/** 规整后的问题（multiple 已默认化为 boolean） */
-export interface Question extends Omit<QuestionInput, "multiple"> {
-  multiple: boolean;
-}
-
-/** 每个问题的答案：选中的 label 数组（自定义输入就是单元素的 [text]） */
-export type Answer = string[];
-
-export interface QuestionDetails {
-  questions: Question[];
-  answers: Answer[];
-}
-
 // ── schema（与 opencode 的 Question.Prompt 一致）──────────────────────────────
 
 const optionSchema = Type.Object({
@@ -93,6 +65,26 @@ export const questionParamsSchema = Type.Object({
   questions: Type.Array(questionSchema, { description: "Questions to ask" }),
 });
 
+// ── types ────────────────────────────────────────────────────────────────────
+
+export type QuestionOption = Static<typeof optionSchema>;
+
+/** 与 schema 对齐的输入形状（multiple 可选） */
+export type QuestionInput = Static<typeof questionSchema>;
+
+/** 规整后的问题（multiple 已默认化为 boolean） */
+export interface Question extends Omit<QuestionInput, "multiple"> {
+  multiple: boolean;
+}
+
+/** 每个问题的答案：选中的 label 数组（自定义输入就是单元素的 [text]） */
+export type Answer = string[];
+
+export interface QuestionDetails {
+  questions: Question[];
+  answers: Answer[];
+}
+
 // ── 纯函数（可测试）──────────────────────────────────────────────────────────
 
 /** trim 各字段并把可选的 multiple 默认化为 false */

package/src/opencode/todo.ts

@@ -24,7 +24,7 @@
 
 import { StringEnum } from "@earendil-works/pi-ai";
 import { type ExtensionAPI, truncateToVisualLines } from "@earendil-works/pi-coding-agent";
-import { Type } from "typebox";
+import { type Static, Type } from "typebox";
 
 import { type ToolPendant } from "../lib/pendant.js";
 
@@ -74,19 +74,6 @@ export const TODOWRITE_DESCRIPTION = [
   "- Items should be specific and actionable; break large work into smaller steps",
 ].join("\n");
 
-// ── types ────────────────────────────────────────────────────────────────────
-
-export interface TodoInfo {
-  content: string;
-  status: TodoStatus;
-  priority: TodoPriority;
-}
-
-export interface TodoDetails {
-  todos: TodoInfo[];
-  pendant?: ToolPendant;
-}
-
 // ── schema（与 opencode 的 Parameters 一致）──────────────────────────────────
 
 const todoInfoSchema = Type.Object({
@@ -103,6 +90,15 @@ export const todowriteSchema = Type.Object({
   todos: Type.Array(todoInfoSchema, { description: "The updated todo list" }),
 });
 
+// ── types ────────────────────────────────────────────────────────────────────
+
+export type TodoInfo = Static<typeof todoInfoSchema>;
+
+export interface TodoDetails {
+  todos: TodoInfo[];
+  pendant?: ToolPendant;
+}
+
 // ── 纯函数（可测试）──────────────────────────────────────────────────────────
 
 /** trim content 并返回干净副本；字段类型已由 typebox schema 推断，无需运行时校验 */