@esso0428/pi-subagents 0.15.5 → 0.15.7

package/dist/usage.d.ts

@@ -48,3 +48,4 @@ export declare function getSessionTokens(session: SessionLike | undefined): numb
  * (no model contextWindow, or post-compaction before the next response).
  */
 export declare function getSessionContextPercent(session: SessionLike | undefined): number | null;
+//# sourceMappingURL=usage.d.ts.map

package/dist/usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../src/usage.ts"],"names":[],"mappings":"AAAA,oFAAoF;AAEpF;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC;AAElF,2DAA2D;AAC3D,wBAAgB,gBAAgB,CAAC,CAAC,CAAC,EAAE,aAAa,GAAG,MAAM,CAE1D;AAED,oEAAoE;AACpE,wBAAgB,QAAQ,CAAC,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,GAAG,IAAI,CAIxE;AAED,+DAA+D;AAC/D,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9D,YAAY,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;CAC3C,CAAC;AACF,MAAM,MAAM,WAAW,GAAG;IAAE,eAAe,IAAI,gBAAgB,CAAA;CAAE,CAAC;AAElE;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,WAAW,GAAG,SAAS,GAAG,MAAM,CAMzE;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,WAAW,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAIxF"}

package/dist/usage.js

@@ -1,16 +1,10 @@
-"use strict";
 /** usage.ts — Token usage: shapes, accumulator operators, session-stats readers. */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getLifetimeTotal = getLifetimeTotal;
-exports.addUsage = addUsage;
-exports.getSessionTokens = getSessionTokens;
-exports.getSessionContextPercent = getSessionContextPercent;
 /** Sum of lifetime usage components, or 0 if undefined. */
-function getLifetimeTotal(u) {
+export function getLifetimeTotal(u) {
     return u ? u.input + u.output + u.cacheWrite : 0;
 }
 /** Add a usage delta into a target accumulator (mutates target). */
-function addUsage(into, delta) {
+export function addUsage(into, delta) {
     into.input += delta.input;
     into.output += delta.output;
     into.cacheWrite += delta.cacheWrite;
@@ -28,7 +22,7 @@ function addUsage(into, delta) {
  * and so counts the cumulative cached prefix N times across N turns
  * (issue #38).
  */
-function getSessionTokens(session) {
+export function getSessionTokens(session) {
     if (!session)
         return 0;
     try {
@@ -43,7 +37,7 @@ function getSessionTokens(session) {
  * Context-window utilization (0–100), or null when unavailable
  * (no model contextWindow, or post-compaction before the next response).
  */
-function getSessionContextPercent(session) {
+export function getSessionContextPercent(session) {
     if (!session)
         return null;
     try {
@@ -53,3 +47,4 @@ function getSessionContextPercent(session) {
         return null;
     }
 }
+//# sourceMappingURL=usage.js.map

package/dist/usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.js","sourceRoot":"","sources":["../src/usage.ts"],"names":[],"mappings":"AAAA,oFAAoF;AAWpF,2DAA2D;AAC3D,MAAM,UAAU,gBAAgB,CAAC,CAAiB;IAChD,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;AACnD,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,QAAQ,CAAC,IAAmB,EAAE,KAAoB;IAChE,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC;IAC1B,IAAI,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC;IAC5B,IAAI,CAAC,UAAU,IAAI,KAAK,CAAC,UAAU,CAAC;AACtC,CAAC;AASD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAgC;IAC/D,IAAI,CAAC,OAAO;QAAE,OAAO,CAAC,CAAC;IACvB,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,MAAM,CAAC;QAC3C,OAAO,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,UAAU,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,CAAC,CAAC;IAAC,CAAC;AACvB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CAAC,OAAgC;IACvE,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B,IAAI,CAAC;QAAC,OAAO,OAAO,CAAC,eAAe,EAAE,CAAC,YAAY,EAAE,OAAO,IAAI,IAAI,CAAC;IAAC,CAAC;IACvE,MAAM,CAAC;QAAC,OAAO,IAAI,CAAC;IAAC,CAAC;AACxB,CAAC"}

package/dist/worktree.d.ts

@@ -43,3 +43,4 @@ export declare function cleanupWorktree(cwd: string, worktree: WorktreeInfo, age
  * Prune any orphaned worktrees (crash recovery).
  */
 export declare function pruneWorktrees(cwd: string): void;
+//# sourceMappingURL=worktree.d.ts.map

package/dist/worktree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree.d.ts","sourceRoot":"","sources":["../src/worktree.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,MAAM,WAAW,YAAY;IAC3B,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,MAAM,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC,kDAAkD;IAClD,UAAU,EAAE,OAAO,CAAC;IACpB,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAqCrF;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,YAAY,EACtB,gBAAgB,EAAE,MAAM,GACvB,qBAAqB,CAwEvB;AAoBD;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAIhD"}

package/dist/worktree.js

@@ -1,4 +1,3 @@
-"use strict";
 /**
  * worktree.ts — Git worktree isolation for agents.
  *
@@ -6,51 +5,47 @@
  * On completion, if no changes were made, the worktree is cleaned up.
  * If changes exist, a branch is created and returned in the result.
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createWorktree = createWorktree;
-exports.cleanupWorktree = cleanupWorktree;
-exports.pruneWorktrees = pruneWorktrees;
-const node_child_process_1 = require("node:child_process");
-const node_crypto_1 = require("node:crypto");
-const node_fs_1 = require("node:fs");
-const node_os_1 = require("node:os");
-const node_path_1 = require("node:path");
+import { execFileSync } from "node:child_process";
+import { randomUUID } from "node:crypto";
+import { existsSync, realpathSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join, relative } from "node:path";
 /**
  * Create a temporary git worktree for an agent.
  * Returns the worktree path, or undefined if not in a git repo.
  */
-function createWorktree(cwd, agentId) {
+export function createWorktree(cwd, agentId) {
     // Verify we're in a git repo with at least one commit (HEAD must exist)
     let baseSha;
     let subdir;
     try {
-        (0, node_child_process_1.execFileSync)("git", ["rev-parse", "--is-inside-work-tree"], { cwd, stdio: "pipe", timeout: 5000 });
-        baseSha = (0, node_child_process_1.execFileSync)("git", ["rev-parse", "HEAD"], { cwd, stdio: "pipe", timeout: 5000 })
+        execFileSync("git", ["rev-parse", "--is-inside-work-tree"], { cwd, stdio: "pipe", timeout: 5000 });
+        baseSha = execFileSync("git", ["rev-parse", "HEAD"], { cwd, stdio: "pipe", timeout: 5000 })
             .toString()
             .trim();
         // Where cwd sits inside the repo ("" at the root): the agent must work at
         // the same subdirectory inside the copy, or a monorepo-package cwd would
         // silently widen to the whole repo. realpath both sides — git emits
         // resolved paths while cwd may arrive through a symlink (macOS /tmp).
-        const topLevel = (0, node_child_process_1.execFileSync)("git", ["rev-parse", "--show-toplevel"], { cwd, stdio: "pipe", timeout: 5000 })
+        const topLevel = execFileSync("git", ["rev-parse", "--show-toplevel"], { cwd, stdio: "pipe", timeout: 5000 })
             .toString()
             .trim();
-        subdir = (0, node_path_1.relative)((0, node_fs_1.realpathSync)(topLevel), (0, node_fs_1.realpathSync)(cwd));
+        subdir = relative(realpathSync(topLevel), realpathSync(cwd));
     }
     catch {
         return undefined;
     }
     const branch = `pi-agent-${agentId}`;
-    const suffix = (0, node_crypto_1.randomUUID)().slice(0, 8);
-    const worktreePath = (0, node_path_1.join)((0, node_os_1.tmpdir)(), `pi-agent-${agentId}-${suffix}`);
+    const suffix = randomUUID().slice(0, 8);
+    const worktreePath = join(tmpdir(), `pi-agent-${agentId}-${suffix}`);
     try {
         // Create detached worktree at HEAD
-        (0, node_child_process_1.execFileSync)("git", ["worktree", "add", "--detach", worktreePath, "HEAD"], {
+        execFileSync("git", ["worktree", "add", "--detach", worktreePath, "HEAD"], {
             cwd,
             stdio: "pipe",
             timeout: 30000,
         });
-        return { path: worktreePath, branch, baseSha, workPath: subdir ? (0, node_path_1.join)(worktreePath, subdir) : worktreePath };
+        return { path: worktreePath, branch, baseSha, workPath: subdir ? join(worktreePath, subdir) : worktreePath };
     }
     catch {
         // If worktree creation fails, return undefined (agent runs in normal cwd)
@@ -62,31 +57,31 @@ function createWorktree(cwd, agentId) {
  * - If no changes: remove worktree entirely.
  * - If changes exist: create a branch, commit changes, return branch info.
  */
-function cleanupWorktree(cwd, worktree, agentDescription) {
-    if (!(0, node_fs_1.existsSync)(worktree.path)) {
+export function cleanupWorktree(cwd, worktree, agentDescription) {
+    if (!existsSync(worktree.path)) {
         return { hasChanges: false };
     }
     try {
         // Check for uncommitted changes in the worktree
-        const status = (0, node_child_process_1.execFileSync)("git", ["status", "--porcelain"], {
+        const status = execFileSync("git", ["status", "--porcelain"], {
             cwd: worktree.path,
             stdio: "pipe",
             timeout: 10000,
         }).toString().trim();
         if (status) {
             // Changes exist — stage, commit, and create a branch
-            (0, node_child_process_1.execFileSync)("git", ["add", "-A"], { cwd: worktree.path, stdio: "pipe", timeout: 10000 });
+            execFileSync("git", ["add", "-A"], { cwd: worktree.path, stdio: "pipe", timeout: 10000 });
             // Truncate description for commit message (no shell sanitization needed — execFileSync uses argv)
             const safeDesc = agentDescription.slice(0, 200);
             const commitMsg = `pi-agent: ${safeDesc}`;
-            (0, node_child_process_1.execFileSync)("git", ["commit", "--no-verify", "-m", commitMsg], {
+            execFileSync("git", ["commit", "--no-verify", "-m", commitMsg], {
                 cwd: worktree.path,
                 stdio: "pipe",
                 timeout: 10000,
             });
         }
         else {
-            const currentSha = (0, node_child_process_1.execFileSync)("git", ["rev-parse", "HEAD"], {
+            const currentSha = execFileSync("git", ["rev-parse", "HEAD"], {
                 cwd: worktree.path,
                 stdio: "pipe",
                 timeout: 5000,
@@ -101,7 +96,7 @@ function cleanupWorktree(cwd, worktree, agentDescription) {
         // If the branch already exists, append a suffix to avoid overwriting previous work.
         let branchName = worktree.branch;
         try {
-            (0, node_child_process_1.execFileSync)("git", ["branch", branchName], {
+            execFileSync("git", ["branch", branchName], {
                 cwd: worktree.path,
                 stdio: "pipe",
                 timeout: 5000,
@@ -110,7 +105,7 @@ function cleanupWorktree(cwd, worktree, agentDescription) {
         catch {
             // Branch already exists — use a unique suffix
             branchName = `${worktree.branch}-${Date.now()}`;
-            (0, node_child_process_1.execFileSync)("git", ["branch", branchName], {
+            execFileSync("git", ["branch", branchName], {
                 cwd: worktree.path,
                 stdio: "pipe",
                 timeout: 5000,
@@ -140,7 +135,7 @@ function cleanupWorktree(cwd, worktree, agentDescription) {
  */
 function removeWorktree(cwd, worktreePath) {
     try {
-        (0, node_child_process_1.execFileSync)("git", ["worktree", "remove", "--force", worktreePath], {
+        execFileSync("git", ["worktree", "remove", "--force", worktreePath], {
             cwd,
             stdio: "pipe",
             timeout: 10000,
@@ -149,7 +144,7 @@ function removeWorktree(cwd, worktreePath) {
     catch {
         // If git worktree remove fails, try pruning
         try {
-            (0, node_child_process_1.execFileSync)("git", ["worktree", "prune"], { cwd, stdio: "pipe", timeout: 5000 });
+            execFileSync("git", ["worktree", "prune"], { cwd, stdio: "pipe", timeout: 5000 });
         }
         catch { /* ignore */ }
     }
@@ -157,9 +152,10 @@ function removeWorktree(cwd, worktreePath) {
 /**
  * Prune any orphaned worktrees (crash recovery).
  */
-function pruneWorktrees(cwd) {
+export function pruneWorktrees(cwd) {
     try {
-        (0, node_child_process_1.execFileSync)("git", ["worktree", "prune"], { cwd, stdio: "pipe", timeout: 5000 });
+        execFileSync("git", ["worktree", "prune"], { cwd, stdio: "pipe", timeout: 5000 });
     }
     catch { /* ignore */ }
 }
+//# sourceMappingURL=worktree.js.map

package/dist/worktree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree.js","sourceRoot":"","sources":["../src/worktree.ts"],"names":[],"mappings":"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"}

package/dist/write-execution.d.ts

@@ -0,0 +1,42 @@
+import { type ToolDefinition } from "@earendil-works/pi-coding-agent";
+/** Maximum UTF-8 size of the durable display diff plus unified patch. */
+export declare const MAX_DURABLE_DIFF_BYTES: number;
+/** Avoid retaining arbitrarily large previous files in the live-only store. */
+export declare const MAX_COMPARABLE_WRITE_BYTES = 512000;
+export declare const MAX_WRITE_METADATA_ENTRIES = 100;
+export interface DurableWriteDetails {
+    diff?: string;
+    patch?: string;
+    firstChangedLine?: number;
+    diffUnavailableReason?: string;
+}
+/** Ephemeral execution metadata used by the live renderer. Never persisted as a before/after pair. */
+export interface WriteExecutionMeta extends DurableWriteDetails {
+    fileExistedBeforeWrite: boolean;
+    previousContent?: string;
+}
+export declare class WriteExecutionMetadataStore {
+    readonly entries: Map<string, WriteExecutionMeta>;
+    set(toolCallId: string, metadata: WriteExecutionMeta): void;
+    get(toolCallId: unknown): WriteExecutionMeta | undefined;
+    delete(toolCallId: string): void;
+    clear(): void;
+}
+type WriteParams = {
+    path: string;
+    content: string;
+};
+export declare function executeWriteWithMetadata(store: WriteExecutionMetadataStore, toolCallId: string, params: WriteParams, signal: AbortSignal | undefined, cwd: string): Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    details?: DurableWriteDetails;
+}>;
+/**
+ * A session-local write definition. It retains Pi's public schema/description
+ * and replaces only execution so the parent registry is never mutated.
+ */
+export declare function createTrackedWriteTool(cwd: string, store?: WriteExecutionMetadataStore): ToolDefinition<any, DurableWriteDetails>;
+export {};
+//# sourceMappingURL=write-execution.d.ts.map

package/dist/write-execution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-execution.d.ts","sourceRoot":"","sources":["../src/write-execution.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8F,KAAK,cAAc,EAAyB,MAAM,iCAAiC,CAAC;AAIzL,yEAAyE;AACzE,eAAO,MAAM,sBAAsB,QAAkB,CAAC;AACtD,+EAA+E;AAC/E,eAAO,MAAM,0BAA0B,SAAU,CAAC;AAClD,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAE9C,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,sGAAsG;AACtG,MAAM,WAAW,kBAAmB,SAAQ,mBAAmB;IAC7D,sBAAsB,EAAE,OAAO,CAAC;IAChC,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,qBAAa,2BAA2B;IACtC,QAAQ,CAAC,OAAO,kCAAyC;IAEzD,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,kBAAkB,GAAG,IAAI;IAU3D,GAAG,CAAC,UAAU,EAAE,OAAO,GAAG,kBAAkB,GAAG,SAAS;IAIxD,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAIhC,KAAK,IAAI,IAAI;CAGd;AAED,KAAK,WAAW,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AA2ErD,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,2BAA2B,EAClC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,WAAW,GAAG,SAAS,EAC/B,GAAG,EAAE,MAAM,GACV,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,mBAAmB,CAAA;CAAE,CAAC,CA0B5F;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,MAAM,EACX,KAAK,8BAAoC,GACxC,cAAc,CAAC,GAAG,EAAE,mBAAmB,CAAC,CAc1C"}

package/dist/write-execution.js

@@ -0,0 +1,138 @@
+import { createWriteToolDefinition, generateDiffString, generateUnifiedPatch, withFileMutationQueue } from "@earendil-works/pi-coding-agent";
+import { lstat, mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname, isAbsolute, resolve } from "node:path";
+/** Maximum UTF-8 size of the durable display diff plus unified patch. */
+export const MAX_DURABLE_DIFF_BYTES = 4 * 1024 * 1024;
+/** Avoid retaining arbitrarily large previous files in the live-only store. */
+export const MAX_COMPARABLE_WRITE_BYTES = 512_000;
+export const MAX_WRITE_METADATA_ENTRIES = 100;
+export class WriteExecutionMetadataStore {
+    entries = new Map();
+    set(toolCallId, metadata) {
+        this.entries.delete(toolCallId);
+        this.entries.set(toolCallId, metadata);
+        while (this.entries.size > MAX_WRITE_METADATA_ENTRIES) {
+            const oldest = this.entries.keys().next().value;
+            if (oldest === undefined)
+                break;
+            this.entries.delete(oldest);
+        }
+    }
+    get(toolCallId) {
+        return typeof toolCallId === "string" ? this.entries.get(toolCallId) : undefined;
+    }
+    delete(toolCallId) {
+        this.entries.delete(toolCallId);
+    }
+    clear() {
+        this.entries.clear();
+    }
+}
+function resolveWritePath(path, cwd) {
+    if (path === "~")
+        return process.env.HOME ?? cwd;
+    if (path.startsWith("~/") || path.startsWith("~\\")) {
+        return resolve(process.env.HOME ?? cwd, path.slice(2));
+    }
+    return isAbsolute(path) ? path : resolve(cwd, path);
+}
+async function capturePreviousContent(absolutePath) {
+    let info;
+    try {
+        info = await lstat(absolutePath);
+    }
+    catch (error) {
+        if (error?.code === "ENOENT")
+            return { fileExistedBeforeWrite: false, previousContent: "" };
+        return {
+            fileExistedBeforeWrite: true,
+            diffUnavailableReason: "unable to inspect the previous file",
+        };
+    }
+    if (!info.isFile()) {
+        return {
+            fileExistedBeforeWrite: true,
+            diffUnavailableReason: "previous path is not a regular file",
+        };
+    }
+    if (info.size > MAX_COMPARABLE_WRITE_BYTES) {
+        return {
+            fileExistedBeforeWrite: true,
+            diffUnavailableReason: `previous file exceeds ${MAX_COMPARABLE_WRITE_BYTES} bytes`,
+        };
+    }
+    try {
+        const bytes = await readFile(absolutePath);
+        if (bytes.byteLength > MAX_COMPARABLE_WRITE_BYTES) {
+            return {
+                fileExistedBeforeWrite: true,
+                diffUnavailableReason: `previous file exceeds ${MAX_COMPARABLE_WRITE_BYTES} bytes`,
+            };
+        }
+        const previousContent = new TextDecoder("utf-8", { fatal: true }).decode(bytes);
+        return { fileExistedBeforeWrite: true, previousContent };
+    }
+    catch {
+        return {
+            fileExistedBeforeWrite: true,
+            diffUnavailableReason: "previous file is not comparable UTF-8 text",
+        };
+    }
+}
+function durableDetails(metadata, path, content) {
+    if (metadata.diffUnavailableReason) {
+        return { diffUnavailableReason: metadata.diffUnavailableReason };
+    }
+    const previousContent = metadata.previousContent ?? "";
+    const diffResult = generateDiffString(previousContent, content);
+    const patch = generateUnifiedPatch(path, previousContent, content);
+    const totalBytes = Buffer.byteLength(diffResult.diff, "utf8") + Buffer.byteLength(patch, "utf8");
+    if (totalBytes > MAX_DURABLE_DIFF_BYTES) {
+        return { diffUnavailableReason: `durable diff exceeds ${MAX_DURABLE_DIFF_BYTES} bytes` };
+    }
+    return {
+        diff: diffResult.diff,
+        patch,
+        firstChangedLine: diffResult.firstChangedLine,
+    };
+}
+export async function executeWriteWithMetadata(store, toolCallId, params, signal, cwd) {
+    const absolutePath = resolveWritePath(params.path, cwd);
+    store.delete(toolCallId);
+    return withFileMutationQueue(absolutePath, async () => {
+        const throwIfAborted = () => {
+            if (signal?.aborted)
+                throw new Error("Operation aborted");
+        };
+        throwIfAborted();
+        const metadata = await capturePreviousContent(absolutePath);
+        throwIfAborted();
+        await mkdir(dirname(absolutePath), { recursive: true });
+        throwIfAborted();
+        await writeFile(absolutePath, params.content, "utf8");
+        throwIfAborted();
+        const details = durableDetails(metadata, params.path, params.content);
+        store.set(toolCallId, { ...metadata, ...details });
+        return {
+            content: [{ type: "text", text: `Successfully wrote to ${params.path}` }],
+            details,
+        };
+    }).catch((error) => {
+        store.delete(toolCallId);
+        throw error;
+    });
+}
+/**
+ * A session-local write definition. It retains Pi's public schema/description
+ * and replaces only execution so the parent registry is never mutated.
+ */
+export function createTrackedWriteTool(cwd, store = new WriteExecutionMetadataStore()) {
+    const nativeWrite = createWriteToolDefinition(cwd);
+    return {
+        ...nativeWrite,
+        async execute(toolCallId, params, signal, _onUpdate, ctx) {
+            return executeWriteWithMetadata(store, toolCallId, params, signal, ctx.cwd || cwd);
+        },
+    };
+}
+//# sourceMappingURL=write-execution.js.map

package/dist/write-execution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-execution.js","sourceRoot":"","sources":["../src/write-execution.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@esso0428/pi-subagents",
-  "version": "0.15.5",
+  "version": "0.15.7",
   "description": "A pi extension that brings smart Claude Code-style autonomous sub-agents to pi, with npm:pi-subagents-style JSON agent overrides.",
   "author": "ESSO0428",
   "repository": {

package/src/agent-history-list.ts

@@ -0,0 +1,91 @@
+/** Helpers for separating openable active agents from terminal history. */
+
+import { hasAgentHistory } from "./agent-history.js";
+import type { AgentRecord } from "./types.js";
+import { getAgentConfig } from "./agent-types.js";
+import { formatDuration, getDisplayName } from "./ui/agent-widget.js";
+
+export type AgentHistoryStatus =
+  | "completed"
+  | "steered"
+  | "stopped"
+  | "aborted"
+  | "error";
+
+const TERMINAL_STATUSES: ReadonlySet<string> = new Set<AgentHistoryStatus>([
+  "completed",
+  "steered",
+  "stopped",
+  "aborted",
+  "error",
+]);
+
+/** Return whether a record status represents a terminal agent run. */
+export function isTerminalAgentStatus(status: string): status is AgentHistoryStatus {
+  return TERMINAL_STATUSES.has(status);
+}
+
+/** Return whether an active record has a live session that can be opened. */
+export function canOpenActiveAgent(record: AgentRecord): boolean {
+  return (record.status === "running" || record.status === "queued")
+    && record.session !== undefined;
+}
+
+/** Return whether a terminal record has an in-memory or durable conversation. */
+export function canOpenAgentHistory(record: AgentRecord, cwd: string | undefined): boolean {
+  if (!isTerminalAgentStatus(record.status)) return false;
+  return record.session !== undefined
+    || (cwd !== undefined && hasAgentHistory(cwd, record.transcriptPath));
+}
+
+/** Split records into openable active and terminal-history buckets. */
+export function splitAgentRecords(
+  records: readonly AgentRecord[],
+  cwd: string | undefined,
+): { active: AgentRecord[]; history: AgentRecord[] } {
+  const active: AgentRecord[] = [];
+  const history: AgentRecord[] = [];
+
+  for (const record of records) {
+    if (canOpenActiveAgent(record)) {
+      active.push(record);
+    } else if (canOpenAgentHistory(record, cwd)) {
+      history.push(record);
+    }
+  }
+
+  return { active, history };
+}
+
+const DESCRIPTION_LIMIT = 72;
+const LABEL_LIMIT = 140;
+
+function boundedDescription(description: string): string {
+  const line = description.split("\n").find((part) => part.trim())?.trim() ?? "";
+  if (line.length <= DESCRIPTION_LIMIT) return line;
+  return `${line.slice(0, DESCRIPTION_LIMIT - 1)}…`;
+}
+
+/** Format a bounded, single-line history menu option. */
+export function formatAgentHistoryOption(record: AgentRecord, now: number): string {
+  const duration = formatDuration(record.startedAt, record.completedAt ?? now);
+  // Unit consumers may format persisted records before the registry has been
+  // initialized; preserve the persisted type instead of falling back to
+  // general-purpose's generic display name in that case.
+  const displayName = getAgentConfig(record.type)?.displayName
+    ?? (record.type === "general-purpose" ? getDisplayName(record.type) : record.type);
+  const option = `[${record.status}] ${displayName} · ${boundedDescription(record.description)} · ${duration}`;
+  return option.length <= LABEL_LIMIT ? option : `${option.slice(0, LABEL_LIMIT - 1)}…`;
+}
+
+/** Build the visible status-section labels for the agents menu. */
+export function buildAgentStatusMenuEntries(
+  records: readonly AgentRecord[],
+  cwd: string | undefined,
+): string[] {
+  const { active, history } = splitAgentRecords(records, cwd);
+  return [
+    ...(active.length > 0 ? [`Running agents (${active.length})`] : []),
+    ...(history.length > 0 ? [`Agent history (${history.length})`] : []),
+  ];
+}

package/src/agent-history.ts

@@ -19,14 +19,12 @@ export function ensureSubagentsGitignore(cwd: string): string {
   const directory = join(cwd, SUBAGENTS_DIR);
   mkdirSync(directory, { recursive: true });
   const path = join(directory, ".gitignore");
-
   let content = "";
   try {
     content = readFileSync(path, "utf8");
   } catch {
     // The append below also creates a missing file.
   }
-
   if (!content.split(/\r?\n/).some((line) => line.trim() === "*")) {
     const separator = content.length > 0 && !/[\r\n]$/.test(content) ? "\n" : "";
     appendFileSync(path, `${separator}*\n`, "utf8");
@@ -35,17 +33,12 @@ export function ensureSubagentsGitignore(cwd: string): string {
 }
 
 /** Return the durable transcript path for an agent. */
-export function createAgentHistoryPath(
-  cwd: string,
-  agentId: string,
-  agentType = "agent",
-): string {
+export function createAgentHistoryPath(cwd: string, agentId: string): string {
   ensureSubagentsGitignore(cwd);
   const directory = join(cwd, SUBAGENTS_DIR, TRANSCRIPTS_DIR);
   mkdirSync(directory, { recursive: true });
   const safeId = agentId.replace(/[^A-Za-z0-9._-]+/g, "-") || "agent";
-  const safeType = agentType.replace(/[^A-Za-z0-9._-]+/g, "-") || "agent";
-  return join(directory, `${safeId}_${safeType}_transcript.jsonl`);
+  return join(directory, `${safeId}.jsonl`);
 }
 
 /** Return the project-relative path stored in the parent session record. */
@@ -55,7 +48,12 @@ export function agentHistoryLocator(cwd: string, historyPath: string): string {
 
 /** Resolve only paths in this package's project-local transcript namespace. */
 export function resolveAgentHistoryPath(cwd: string, locator: string): string | undefined {
-  if (!locator || isAbsolute(locator)) return undefined;
+  // Locators are persisted data, not arbitrary paths. Reject traversal syntax
+  // before resolving so a path which normalizes back inside the namespace is
+  // still not accepted as an unsafe locator.
+  if (!locator || isAbsolute(locator) || locator.includes("\0") || locator.includes("\\")) return undefined;
+  const segments = locator.split("/");
+  if (segments.some((segment) => segment === ".." || segment === "")) return undefined;
   const root = resolve(cwd, SUBAGENTS_DIR, TRANSCRIPTS_DIR);
   const candidate = resolve(cwd, locator);
   if (candidate !== root && !candidate.startsWith(`${root}${sep}`)) return undefined;
@@ -74,12 +72,9 @@ export function hasAgentHistory(cwd: string, locator: string | undefined): boole
  * conversation viewer. Malformed lines and unknown records are skipped so one
  * damaged entry cannot hide the rest of a history.
  */
-export function readAgentHistory(
-  cwd: string,
-  locator: string,
-): AgentSession["messages"] | undefined {
+export function readAgentHistory(cwd: string, locator: string): AgentSession["messages"] | undefined {
   const path = resolveAgentHistoryPath(cwd, locator);
-  if (!path) return undefined;
+  if (!path || !existsSync(path)) return undefined;
 
   let raw: string;
   try {
@@ -93,8 +88,8 @@ export function readAgentHistory(
   for (const line of raw.split(/\r?\n/)) {
     if (!line.trim()) continue;
     try {
-      const entry = JSON.parse(line) as { message?: unknown };
-      const message = entry.message;
+      const entry: unknown = JSON.parse(line);
+      const message = (entry as { message?: unknown } | null)?.message;
       if (!message || typeof message !== "object") continue;
       const role = (message as { role?: unknown }).role;
       if (typeof role !== "string") continue;