@esso0428/pi-subagents 0.15.4 → 0.15.6

package/dist/settings.js

@@ -1,17 +1,9 @@
-"use strict";
 // Persistence for pi-subagents operational settings.
 // - Global:  ~/.pi/agent/subagents.json (via getAgentDir()) — manual defaults, never written here
 // - Project: <cwd>/.pi/subagents.json — written by /agents → Settings; overrides global on load
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.loadSettings = loadSettings;
-exports.saveSettings = saveSettings;
-exports.applySettings = applySettings;
-exports.persistToastFor = persistToastFor;
-exports.applyAndEmitLoaded = applyAndEmitLoaded;
-exports.saveAndEmitChanged = saveAndEmitChanged;
-const node_fs_1 = require("node:fs");
-const node_path_1 = require("node:path");
-const pi_coding_agent_1 = require("@earendil-works/pi-coding-agent");
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { getAgentDir } from "@earendil-works/pi-coding-agent";
 const VALID_JOIN_MODES = new Set(["async", "group", "smart"]);
 const VALID_TOOL_DESCRIPTION_MODES = new Set(["full", "compact", "custom"]);
 const VALID_WIDGET_MODES = new Set(["all", "background", "off"]);
@@ -69,10 +61,10 @@ function sanitize(raw) {
     return out;
 }
 function globalPath() {
-    return (0, node_path_1.join)((0, pi_coding_agent_1.getAgentDir)(), "subagents.json");
+    return join(getAgentDir(), "subagents.json");
 }
 function projectPath(cwd) {
-    return (0, node_path_1.join)(cwd, ".pi", "subagents.json");
+    return join(cwd, ".pi", "subagents.json");
 }
 /**
  * Read a settings file. Missing file is silent (returns `{}`). A file that
@@ -80,10 +72,10 @@ function projectPath(cwd) {
  * silently reverted to defaults — and still returns `{}` so startup proceeds.
  */
 function readSettingsFile(path) {
-    if (!(0, node_fs_1.existsSync)(path))
+    if (!existsSync(path))
         return {};
     try {
-        return sanitize(JSON.parse((0, node_fs_1.readFileSync)(path, "utf-8")));
+        return sanitize(JSON.parse(readFileSync(path, "utf-8")));
     }
     catch (err) {
         const reason = err instanceof Error ? err.message : String(err);
@@ -92,7 +84,7 @@ function readSettingsFile(path) {
     }
 }
 /** Load merged settings: global provides defaults, project overrides. */
-function loadSettings(cwd = process.cwd()) {
+export function loadSettings(cwd = process.cwd()) {
     return { ...readSettingsFile(globalPath()), ...readSettingsFile(projectPath(cwd)) };
 }
 /**
@@ -100,11 +92,11 @@ function loadSettings(cwd = process.cwd()) {
  * Returns `true` on success, `false` if the write (or mkdir) failed so the
  * caller can surface a warning — persistence isn't fatal but isn't silent.
  */
-function saveSettings(s, cwd = process.cwd()) {
+export function saveSettings(s, cwd = process.cwd()) {
     const path = projectPath(cwd);
     try {
-        (0, node_fs_1.mkdirSync)((0, node_path_1.dirname)(path), { recursive: true });
-        (0, node_fs_1.writeFileSync)(path, JSON.stringify(s, null, 2), "utf-8");
+        mkdirSync(dirname(path), { recursive: true });
+        writeFileSync(path, JSON.stringify(s, null, 2), "utf-8");
         return true;
     }
     catch {
@@ -112,7 +104,7 @@ function saveSettings(s, cwd = process.cwd()) {
     }
 }
 /** Apply persisted settings to the in-memory state via caller-supplied setters. */
-function applySettings(s, appliers) {
+export function applySettings(s, appliers) {
     if (typeof s.maxConcurrent === "number")
         appliers.setMaxConcurrent(s.maxConcurrent);
     if (typeof s.defaultMaxTurns === "number")
@@ -141,7 +133,7 @@ function applySettings(s, appliers) {
  * routes the success/failure of `saveSettings` into the right message + level
  * so the UI layer (index.ts) stays a thin wire between input and notification.
  */
-function persistToastFor(successMsg, persisted) {
+export function persistToastFor(successMsg, persisted) {
     return persisted
         ? { message: successMsg, level: "info" }
         : { message: `${successMsg} (session only; failed to persist)`, level: "warning" };
@@ -151,7 +143,7 @@ function persistToastFor(successMsg, persisted) {
  * `subagents:settings_loaded` lifecycle event. Returns the loaded settings so
  * callers can log/inspect. Extension init wires this once.
  */
-function applyAndEmitLoaded(appliers, emit, cwd = process.cwd()) {
+export function applyAndEmitLoaded(appliers, emit, cwd = process.cwd()) {
     const settings = loadSettings(cwd);
     applySettings(settings, appliers);
     emit("subagents:settings_loaded", { settings });
@@ -163,7 +155,7 @@ function applyAndEmitLoaded(appliers, emit, cwd = process.cwd()) {
  * return the toast the UI should display. Event payload carries the `persisted`
  * flag so listeners can react to write failures.
  */
-function saveAndEmitChanged(snapshot, successMsg, emit, cwd = process.cwd()) {
+export function saveAndEmitChanged(snapshot, successMsg, emit, cwd = process.cwd()) {
     const persisted = saveSettings(snapshot, cwd);
     emit("subagents:settings_changed", { settings: snapshot, persisted });
     return persistToastFor(successMsg, persisted);

package/dist/skill-loader.js

@@ -1,4 +1,3 @@
-"use strict";
 /**
  * skill-loader.ts — Preload named skills.
  *
@@ -18,26 +17,24 @@
  *
  * Symlinks are rejected for security (deviation from Pi, which follows them).
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.preloadSkills = preloadSkills;
-const node_fs_1 = require("node:fs");
-const node_os_1 = require("node:os");
-const node_path_1 = require("node:path");
-const pi_coding_agent_1 = require("@earendil-works/pi-coding-agent");
-const memory_js_1 = require("./memory.js");
-function preloadSkills(skillNames, cwd) {
+import { existsSync, readdirSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { getAgentDir } from "@earendil-works/pi-coding-agent";
+import { isSymlink, isUnsafeName, safeReadFile } from "./memory.js";
+export function preloadSkills(skillNames, cwd) {
     return skillNames.map((name) => ({ name, content: loadSkillContent(name, cwd) }));
 }
 function loadSkillContent(name, cwd) {
-    if ((0, memory_js_1.isUnsafeName)(name)) {
+    if (isUnsafeName(name)) {
         return `(Skill "${name}" skipped: name contains path traversal characters)`;
     }
     const roots = [
-        (0, node_path_1.join)(cwd, ".pi", "skills"), // project — Pi standard
-        (0, node_path_1.join)(cwd, ".agents", "skills"), // project — Agent Skills spec
-        (0, node_path_1.join)((0, pi_coding_agent_1.getAgentDir)(), "skills"), // user — Pi standard
-        (0, node_path_1.join)((0, node_os_1.homedir)(), ".agents", "skills"), // user — Agent Skills spec
-        (0, node_path_1.join)((0, node_os_1.homedir)(), ".pi", "skills"), // legacy global, pre-Pi
+        join(cwd, ".pi", "skills"), // project — Pi standard
+        join(cwd, ".agents", "skills"), // project — Agent Skills spec
+        join(getAgentDir(), "skills"), // user — Pi standard
+        join(homedir(), ".agents", "skills"), // user — Agent Skills spec
+        join(homedir(), ".pi", "skills"), // legacy global, pre-Pi
     ];
     for (const root of roots) {
         const content = findInRoot(root, name);
@@ -47,16 +44,16 @@ function loadSkillContent(name, cwd) {
     return `(Skill "${name}" not found in .pi/skills/, .agents/skills/, or global skill locations)`;
 }
 function findInRoot(root, name) {
-    if ((0, memory_js_1.isSymlink)(root))
+    if (isSymlink(root))
         return undefined; // reject symlinked roots entirely
-    const flat = (0, memory_js_1.safeReadFile)((0, node_path_1.join)(root, `${name}.md`))?.trim();
+    const flat = safeReadFile(join(root, `${name}.md`))?.trim();
     if (flat !== undefined)
         return flat;
     return findSkillDirectory(root, name);
 }
 /** BFS under `root` for a directory named `name` containing `SKILL.md`. Pi-conforming filters. */
 function findSkillDirectory(root, name) {
-    if (!(0, node_fs_1.existsSync)(root))
+    if (!existsSync(root))
         return undefined;
     const queue = [root];
     while (queue.length > 0) {
@@ -65,7 +62,7 @@ function findSkillDirectory(root, name) {
             continue;
         let entries;
         try {
-            entries = (0, node_fs_1.readdirSync)(current, { withFileTypes: true });
+            entries = readdirSync(current, { withFileTypes: true });
         }
         catch {
             continue;
@@ -78,12 +75,12 @@ function findSkillDirectory(root, name) {
             if (entry.name.startsWith(".") || entry.name === "node_modules")
                 continue;
             // Symlinked dirs already filtered by entry.isDirectory() — Dirent uses lstat semantics.
-            const path = (0, node_path_1.join)(current, entry.name);
-            const skillMd = (0, node_path_1.join)(path, "SKILL.md");
-            const isSkillDir = (0, node_fs_1.existsSync)(skillMd);
+            const path = join(current, entry.name);
+            const skillMd = join(path, "SKILL.md");
+            const isSkillDir = existsSync(skillMd);
             if (isSkillDir) {
                 if (entry.name === name) {
-                    const content = (0, memory_js_1.safeReadFile)(skillMd)?.trim();
+                    const content = safeReadFile(skillMd)?.trim();
                     if (content !== undefined)
                         return content;
                 }

package/dist/status-note.js

@@ -1,9 +1,6 @@
-"use strict";
 /**
  * status-note.ts — Parenthetical status note appended to agent result text.
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getStatusNote = getStatusNote;
 /**
  * Explicit parenthetical note for a non-normal terminal outcome, so the parent
  * agent can't mistake partial output for a completed result. Empty string for a
@@ -13,7 +10,7 @@ exports.getStatusNote = getStatusNote;
  * turn limit was hit) — the parent should treat human intervention differently
  * from a budget cutoff.
  */
-function getStatusNote(status) {
+export function getStatusNote(status) {
     switch (status) {
         case "stopped":
             return " (STOPPED BY THE USER before completion — output is partial; the task was NOT finished)";

package/dist/types.d.ts

@@ -154,7 +154,6 @@ export interface NotificationDetails {
     outputFile?: string;
     error?: string;
     resultPreview: string;
-    resultText?: string;
     /** Additional agents in a group notification. */
     others?: NotificationDetails[];
 }

package/dist/types.js

@@ -1,8 +1,5 @@
-"use strict";
 /**
  * types.ts — Type definitions for the subagent system.
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEFAULT_AGENT_NAMES = void 0;
 /** Names of the three embedded default agents. */
-exports.DEFAULT_AGENT_NAMES = ["general-purpose", "Explore", "Plan"];
+export const DEFAULT_AGENT_NAMES = ["general-purpose", "Explore", "Plan"];

package/dist/ui/agent-widget.d.ts

@@ -102,8 +102,6 @@ export declare class AgentWidget {
      * extension supplies one defaulting to `"background"`.
      */
     private mode;
-    /** Current project cwd used to validate reload-restored transcripts. */
-    private getCwd;
     private uiCtx;
     private widgetFrame;
     private widgetInterval;
@@ -123,9 +121,7 @@ export declare class AgentWidget {
      * `WidgetMode`. Defaults to `"all"` when a caller supplies no policy; the
      * extension supplies one defaulting to `"background"`.
      */
-    mode?: () => WidgetMode, 
-    /** Current project cwd used to validate reload-restored transcripts. */
-    getCwd?: () => string | undefined);
+    mode?: () => WidgetMode);
     /**
      * Agents eligible for the widget, per the current `WidgetMode`:
      *   - `off`: none (the widget's existing empty-state path hides it entirely).

package/dist/ui/agent-widget.js

@@ -1,33 +1,19 @@
-"use strict";
 /**
  * agent-widget.ts — Persistent widget showing running/completed agents above the editor.
  *
  * Displays a tree of agents with animated spinners, live stats, and activity descriptions.
  * Uses the callback form of setWidget for themed rendering.
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.AgentWidget = exports.ERROR_STATUSES = exports.SPINNER = void 0;
-exports.fgPreservingNestedStyles = fgPreservingNestedStyles;
-exports.formatTokens = formatTokens;
-exports.formatSessionTokens = formatSessionTokens;
-exports.formatTurns = formatTurns;
-exports.formatMs = formatMs;
-exports.formatDuration = formatDuration;
-exports.getDisplayName = getDisplayName;
-exports.getPromptModeLabel = getPromptModeLabel;
-exports.buildInvocationTags = buildInvocationTags;
-exports.describeActivity = describeActivity;
-const pi_tui_1 = require("@earendil-works/pi-tui");
-const agent_history_js_1 = require("../agent-history.js");
-const agent_types_js_1 = require("../agent-types.js");
-const usage_js_1 = require("../usage.js");
+import { truncateToWidth } from "@earendil-works/pi-tui";
+import { getConfig } from "../agent-types.js";
+import { getLifetimeTotal, getSessionContextPercent } from "../usage.js";
 // ---- Constants ----
 /** Maximum number of rendered lines before overflow collapse kicks in. */
 const MAX_WIDGET_LINES = 12;
 /** Braille spinner frames for animated running indicator. */
-exports.SPINNER = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
+export const SPINNER = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
 /** Statuses that indicate an error/non-success outcome (used for linger behavior and icon rendering). */
-exports.ERROR_STATUSES = new Set(["error", "aborted", "steered", "stopped"]);
+export const ERROR_STATUSES = new Set(["error", "aborted", "steered", "stopped"]);
 /** Tool name → human-readable action for activity descriptions. */
 const TOOL_DISPLAY = {
     read: "reading",
@@ -40,13 +26,13 @@ const TOOL_DISPLAY = {
 };
 // ---- Formatting helpers ----
 /** Apply foreground styling while restoring it after nested foreground/full ANSI resets. */
-function fgPreservingNestedStyles(theme, color, text) {
+export function fgPreservingNestedStyles(theme, color, text) {
     const styledEmpty = theme.fg(color, "");
     const styleStart = styledEmpty.replace(/\u001b\[(?:0|39)m/g, "");
     return theme.fg(color, text.replace(/\u001b\[(?:0|39)m/g, reset => `${reset}${styleStart}`));
 }
 /** Format a token count compactly: "33.8k token", "1.2M token". */
-function formatTokens(count) {
+export function formatTokens(count) {
     if (count >= 1_000_000)
         return `${(count / 1_000_000).toFixed(1)}M token`;
     if (count >= 1_000)
@@ -63,7 +49,7 @@ function formatTokens(count) {
  *   "12.3k token (⇊2)"          — compactions only (e.g. right after compact)
  *   "12.3k token (45% · ⇊2)"    — both
  */
-function formatSessionTokens(tokens, percent, theme, compactions = 0) {
+export function formatSessionTokens(tokens, percent, theme, compactions = 0) {
     const tokenStr = formatTokens(tokens);
     const annot = [];
     if (percent !== null) {
@@ -78,30 +64,30 @@ function formatSessionTokens(tokens, percent, theme, compactions = 0) {
     return `${tokenStr} (${annot.join(" · ")})`;
 }
 /** Format turn count with optional max limit: "↻5≤30" or "↻5". */
-function formatTurns(turnCount, maxTurns) {
+export function formatTurns(turnCount, maxTurns) {
     return maxTurns != null ? `↻${turnCount}≤${maxTurns}` : `↻${turnCount}`;
 }
 /** Format milliseconds as human-readable duration. */
-function formatMs(ms) {
+export function formatMs(ms) {
     return `${(ms / 1000).toFixed(1)}s`;
 }
 /** Format duration from start/completed timestamps. */
-function formatDuration(startedAt, completedAt) {
+export function formatDuration(startedAt, completedAt) {
     if (completedAt)
         return formatMs(completedAt - startedAt);
     return `${formatMs(Date.now() - startedAt)} (running)`;
 }
 /** Get display name for any agent type (built-in or custom). */
-function getDisplayName(type) {
-    return (0, agent_types_js_1.getConfig)(type).displayName;
+export function getDisplayName(type) {
+    return getConfig(type).displayName;
 }
 /** Short label for prompt mode: "twin" for append, nothing for replace (the default). */
-function getPromptModeLabel(type) {
-    const config = (0, agent_types_js_1.getConfig)(type);
+export function getPromptModeLabel(type) {
+    const config = getConfig(type);
     return config.promptMode === "append" ? "twin" : undefined;
 }
 /** Mode label is not included — callers add it where they want it. */
-function buildInvocationTags(invocation) {
+export function buildInvocationTags(invocation) {
     const tags = [];
     if (!invocation)
         return { tags };
@@ -127,7 +113,7 @@ function truncateLine(text, len = 60) {
     return line.slice(0, len) + "…";
 }
 /** Build a human-readable activity string from currently-running tools or response text. */
-function describeActivity(activeTools, responseText) {
+export function describeActivity(activeTools, responseText) {
     if (activeTools.size > 0) {
         const groups = new Map();
         for (const toolName of activeTools.values()) {
@@ -152,11 +138,10 @@ function describeActivity(activeTools, responseText) {
     return "thinking…";
 }
 // ---- Widget manager ----
-class AgentWidget {
+export class AgentWidget {
     manager;
     agentActivity;
     mode;
-    getCwd;
     uiCtx;
     widgetFrame = 0;
     widgetInterval;
@@ -176,13 +161,10 @@ class AgentWidget {
      * `WidgetMode`. Defaults to `"all"` when a caller supplies no policy; the
      * extension supplies one defaulting to `"background"`.
      */
-    mode = () => "all", 
-    /** Current project cwd used to validate reload-restored transcripts. */
-    getCwd = () => undefined) {
+    mode = () => "all") {
         this.manager = manager;
         this.agentActivity = agentActivity;
         this.mode = mode;
-        this.getCwd = getCwd;
     }
     /**
      * Agents eligible for the widget, per the current `WidgetMode`:
@@ -196,12 +178,7 @@ class AgentWidget {
      *   - `all`: every agent.
      */
     widgetAgents() {
-        const all = this.manager.listAgents().filter((record) => {
-            if (record.status === "running" || record.status === "queued")
-                return true;
-            const cwd = this.getCwd();
-            return cwd !== undefined && (0, agent_history_js_1.hasAgentHistory)(cwd, record.transcriptPath);
-        });
+        const all = this.manager.listAgents();
         switch (this.mode()) {
             case "off": return [];
             case "background": return all.filter(a => a.isBackground !== false);
@@ -240,7 +217,7 @@ class AgentWidget {
     /** Check if a finished agent should still be shown in the widget. */
     shouldShowFinished(agentId, status) {
         const age = this.finishedTurnAge.get(agentId) ?? 0;
-        const maxAge = exports.ERROR_STATUSES.has(status) ? AgentWidget.ERROR_LINGER_TURNS : 1;
+        const maxAge = ERROR_STATUSES.has(status) ? AgentWidget.ERROR_LINGER_TURNS : 1;
         return age < maxAge;
     }
     /** Record an agent as finished (call when agent completes). */
@@ -304,10 +281,10 @@ class AgentWidget {
         if (!hasActive && !hasFinished)
             return [];
         const w = tui.terminal.columns;
-        const truncate = (line) => (0, pi_tui_1.truncateToWidth)(line, w);
+        const truncate = (line) => truncateToWidth(line, w);
         const headingColor = hasActive ? "accent" : "dim";
         const headingIcon = hasActive ? "●" : "○";
-        const frame = exports.SPINNER[this.widgetFrame % exports.SPINNER.length];
+        const frame = SPINNER[this.widgetFrame % SPINNER.length];
         // Build sections separately for overflow-aware assembly.
         // Each running agent = 2 lines (header + activity), finished = 1 line, queued = 1 line.
         const finishedLines = [];
@@ -322,8 +299,8 @@ class AgentWidget {
             const elapsed = formatMs(Date.now() - a.startedAt);
             const bg = this.agentActivity.get(a.id);
             const toolUses = bg?.toolUses ?? a.toolUses;
-            const tokens = (0, usage_js_1.getLifetimeTotal)(bg?.lifetimeUsage);
-            const contextPercent = (0, usage_js_1.getSessionContextPercent)(bg?.session);
+            const tokens = getLifetimeTotal(bg?.lifetimeUsage);
+            const contextPercent = getSessionContextPercent(bg?.session);
             const tokenText = tokens > 0 ? formatSessionTokens(tokens, contextPercent, theme, a.compactionCount) : "";
             const parts = [];
             if (bg)
@@ -505,4 +482,3 @@ class AgentWidget {
         this.lastStatusText = undefined;
     }
 }
-exports.AgentWidget = AgentWidget;

package/dist/ui/conversation-blocks.d.ts

@@ -0,0 +1,18 @@
+import type { AgentSession } from "@earendil-works/pi-coding-agent";
+export type ConversationBlockKind = "text" | "tool" | "meta";
+export type ConversationBlockRole = "user" | "assistant" | "tool" | "custom" | "meta";
+export interface ConversationBlock {
+    id: string;
+    kind: ConversationBlockKind;
+    role: ConversationBlockRole;
+    header: string;
+    markdown: string;
+    copyText: string;
+    fullText: string;
+    toolLine?: string;
+}
+export interface ConversationFormatOptions {
+    maxEntryChars?: number;
+    maxToolResultChars?: number;
+}
+export declare function formatConversationMessages(messages: AgentSession["messages"], options?: ConversationFormatOptions): ConversationBlock[];