@stfade/pi-read-delegator 1.0.12 → 1.0.13

package/{index.js → dist/index.js}

@@ -1,4 +1,3 @@
-"use strict";
 /**
  * index.ts — pi-read-delegator entry point
  *
@@ -11,74 +10,13 @@
  *  - before_agent_start: inject orchestrator system prompt
  *  - tool_call: intercept bash read commands → redirect to reader
  */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = default_1;
-const fs = __importStar(require("node:fs"));
-const os = __importStar(require("node:os"));
-const path = __importStar(require("node:path"));
-const config_1 = require("./config");
-const reader_manager_1 = require("./reader-manager");
-const ui_1 = require("./ui");
-// ---------------------------------------------------------------------------
-// Bash read commands — these are intercepted and redirected to reader
-// ---------------------------------------------------------------------------
-const READ_BASH_COMMANDS = new Set([
-    "cat",
-    "grep",
-    "find",
-    "ls",
-    "head",
-    "tail",
-    "less",
-    "wc",
-    "nl",
-    "more",
-    "bat",
-    "rg",
-    "fd",
-    "awk",
-    "du",
-    "df",
-    "stat",
-    "file",
-    "which",
-    "where",
-    "type",
-    "dir",
-]);
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import { loadConfig, saveConfig } from "./config";
+import { checkDependencies, isSubagentsInstalled, sessionCache, } from "./reader-manager";
+import { getLanguage, msg } from "./ui";
+import { isReadCommand } from "./bash-filter";
 // ---------------------------------------------------------------------------
 // Reader template path
 // ---------------------------------------------------------------------------
@@ -93,14 +31,37 @@ function syncReaderTemplate(model) {
         const content = [
             "---",
             "name: reader",
-            "description: Token-efficient code reader that returns minimal results.",
+            "description: Compact code-reader — executes tasks, returns results with line numbers",
             "tools: read, grep, find, ls",
             `model: ${model}`,
             "---",
             "",
-            "You are a token-efficient analyst. Execute read/search/list tasks and return",
-            "ONLY the essential result. Maximum 10 lines. Use bullet summaries.",
-            "Never dump entire files. Focus only on what was asked.",
+            "Execute the task. Return only the result, nothing else.",
+            "Always include line numbers for grep and read results.",
+            "No explanations, summaries, or conversational text.",
+            "",
+            "### Structure masks (auto-apply to code output)",
+            "- Skip import statements unless task explicitly mentions them.",
+            "- Collapse long type annotations: `Record<string, string>[]` → `Record<...>[]`.",
+            "- Truncate paths: `C:/Users/samet/Documents/Projects/pi-read-delegator/src/` → `src/`.",
+            "",
+            "### Stats-first for grep / find",
+            "- grep: show total match count on line 1, then matches. Large result sets (>20): only count.",
+            "- find: show file count first, then list. >50 files: only count.",
+            "- ls: show file count first, then list.",
+            "",
+            "### Smart filtering",
+            "- Skip node_modules, .git, dist, .next, coverage, __pycache__ unless task specifies a path inside.",
+            "- Skip binary files (images, .exe, .dll, .zip, .db) — return '(binary)'.",
+            "- Deduplicate: if same file appears in multiple grep matches, show it once with all line numbers.",
+            "",
+            "### Output format (no markdown headers)",
+            "grep: src/file.ts:42  matched line",
+            "read: 42: line content",
+            "find: file list, one per line",
+            "ls:   name  size",
+            "No matches: (no matches)",
+            "Error: Error: <message>",
         ].join("\n");
         fs.writeFileSync(rp, content, "utf8");
     }
@@ -131,7 +92,7 @@ async function pickReaderModel(config, ctx) {
         const selected = await ctx.ui.select("Choose reader model (ESC to keep current)", options);
         if (selected && selected !== config.reader_model) {
             config.reader_model = selected;
-            (0, config_1.saveConfig)(config, { silent: true });
+            saveConfig(config, { silent: true });
             syncReaderTemplate(selected);
             ctx.ui.notify("✅ Reader model set to: " + selected, "info");
             return selected;
@@ -162,15 +123,15 @@ function createProgressCallback(ctx) {
     return (status) => {
         if (status === "installing") {
             ctx.ui.setStatus("read-delegator", "⏳ Installing pi-subagents…");
-            ctx.ui.notify((0, ui_1.msg)("deps_installing") +
+            ctx.ui.notify(msg("deps_installing") +
                 " This may take up to 60 seconds. Please wait…", "info");
         }
         else if (status === "done") {
-            ctx.ui.setStatus("read-delegator", (0, ui_1.msg)("status_active"));
+            ctx.ui.setStatus("read-delegator", msg("status_active"));
             ctx.ui.notify("✅ pi-subagents installed successfully.", "info");
         }
         else if (status === "failed") {
-            ctx.ui.setStatus("read-delegator", (0, ui_1.msg)("status_error"));
+            ctx.ui.setStatus("read-delegator", msg("status_error"));
         }
     };
 }
@@ -179,30 +140,30 @@ async function performDependencyCheck(ctx, config) {
         const ok = await ctx.ui.confirm("pi-subagents required", message);
         return ok ? "y" : "n";
     };
-    const ready = await (0, reader_manager_1.checkDependencies)(promptFn, createProgressCallback(ctx));
+    const ready = await checkDependencies(promptFn, createProgressCallback(ctx));
     if (!ready) {
         config.enabled = false;
-        (0, config_1.saveConfig)(config, { silent: true });
-        ctx.ui.setStatus("read-delegator", (0, ui_1.msg)("status_error"));
-        ctx.ui.notify((0, ui_1.msg)("deps_disabled"), "warning");
+        saveConfig(config, { silent: true });
+        ctx.ui.setStatus("read-delegator", msg("status_error"));
+        ctx.ui.notify(msg("deps_disabled"), "warning");
         return false;
     }
     if (!config.enabled) {
         config.enabled = true;
-        (0, config_1.saveConfig)(config, { silent: true });
+        saveConfig(config, { silent: true });
     }
     return true;
 }
 // ---------------------------------------------------------------------------
 // Extension factory — registration only; actions go inside events
 // ---------------------------------------------------------------------------
-async function default_1(pi) {
-    const config = (0, config_1.loadConfig)();
+export default async function (pi) {
+    const config = loadConfig();
     // Detect language
-    (0, ui_1.getLanguage)(config.language);
+    getLanguage(config.language);
     // Quick sync dependency check — interactive prompt is deferred to
     // session_start where we have access to ctx.ui.confirm().
-    let depsReady = (0, reader_manager_1.isSubagentsInstalled)();
+    let depsReady = isSubagentsInstalled();
     let depsChecked = depsReady; // if already ready, no need to check again
     // -----------------------------------------------------------------------
     // 1. session_start: dependency check → tool blocking → status bar
@@ -221,7 +182,7 @@ async function default_1(pi) {
         if (config.enabled) {
             pi.setActiveTools(computeActiveTools(pi, config.blocked_tools));
         }
-        ctx.ui.setStatus("read-delegator", config.enabled ? (0, ui_1.msg)("status_active") : (0, ui_1.msg)("status_off"));
+        ctx.ui.setStatus("read-delegator", config.enabled ? msg("status_active") : msg("status_off"));
     });
     // -----------------------------------------------------------------------
     // 2. before_agent_start: inject orchestrator system prompt
@@ -243,8 +204,7 @@ async function default_1(pi) {
             const command = String(event.input?.command ?? "");
             if (!command)
                 return;
-            const firstWord = command.trim().split(/\s+/)[0]?.toLowerCase() ?? "";
-            if (READ_BASH_COMMANDS.has(firstWord)) {
+            if (isReadCommand(command)) {
                 return {
                     block: true,
                     reason: [
@@ -260,71 +220,73 @@ async function default_1(pi) {
         }
     });
     // -----------------------------------------------------------------------
-    // 4. /read-delegator command
+    // 4. Commands
     // -----------------------------------------------------------------------
+    // Shared status helper
+    const showStatus = (ctx) => {
+        const s = sessionCache.stats();
+        const lines = [
+            "Read delegation: " + (config.enabled ? "🟢 enabled" : "🔴 disabled"),
+            "Reader subagent: " + config.reader_subagent_name,
+            "Reader model: " + config.reader_model,
+            "Dependencies: " + (depsReady ? "✅ ready" : "❌ missing"),
+            "Blocked tools: " + config.blocked_tools.join(", "),
+            "Cache: " + s.files + " files (" + s.sizeKB + " KB)",
+        ];
+        ctx.ui.notify(lines.join("\n"), "info");
+    };
+    // Shortcut: enable/disable toggle with subcommand syntax (kept for back compat)
     pi.registerCommand("read-delegator", {
-        description: "Manage read delegation (on|off|status|model)",
+        description: "Show read-delegator status",
+        handler: async (_args, ctx) => {
+            showStatus(ctx);
+        },
+    });
+    pi.registerCommand("read-delegator-status", {
+        description: "Show read-delegator status",
+        handler: async (_args, ctx) => {
+            showStatus(ctx);
+        },
+    });
+    pi.registerCommand("read-delegator-on", {
+        description: "Enable read delegation",
+        handler: async (_args, ctx) => {
+            if (!depsReady) {
+                ctx.ui.notify("pi-subagents not installed. Install it first to enable read delegation.", "warning");
+                return;
+            }
+            config.enabled = true;
+            saveConfig(config, { silent: true });
+            pi.setActiveTools(computeActiveTools(pi, config.blocked_tools));
+            ctx.ui.notify(msg("enabled"), "info");
+            ctx.ui.setStatus("read-delegator", msg("status_active"));
+        },
+    });
+    pi.registerCommand("read-delegator-off", {
+        description: "Disable read delegation",
+        handler: async (_args, ctx) => {
+            config.enabled = false;
+            saveConfig(config, { silent: true });
+            pi.setActiveTools(pi.getAllTools().map((t) => t.name));
+            ctx.ui.notify(msg("disabled"), "info");
+            ctx.ui.setStatus("read-delegator", msg("status_off"));
+        },
+    });
+    pi.registerCommand("read-delegator-model", {
+        description: "Set or view the reader model",
         handler: async (args, ctx) => {
-            const raw = args?.trim() ?? "";
-            const spaceIdx = raw.indexOf(" ");
-            const sub = spaceIdx >= 0
-                ? raw.slice(0, spaceIdx).toLowerCase()
-                : raw.toLowerCase() || "status";
-            switch (sub) {
-                case "on":
-                case "enable": {
-                    if (!depsReady) {
-                        ctx.ui.notify("pi-subagents not installed. Install it first to enable read delegation.", "warning");
-                        return;
-                    }
-                    config.enabled = true;
-                    (0, config_1.saveConfig)(config, { silent: true });
-                    pi.setActiveTools(computeActiveTools(pi, config.blocked_tools));
-                    ctx.ui.notify((0, ui_1.msg)("enabled"), "info");
-                    ctx.ui.setStatus("read-delegator", (0, ui_1.msg)("status_active"));
-                    return;
-                }
-                case "off":
-                case "disable": {
-                    config.enabled = false;
-                    (0, config_1.saveConfig)(config, { silent: true });
-                    pi.setActiveTools(pi.getAllTools().map((t) => t.name));
-                    ctx.ui.notify((0, ui_1.msg)("disabled"), "info");
-                    ctx.ui.setStatus("read-delegator", (0, ui_1.msg)("status_off"));
-                    return;
-                }
-                case "model": {
-                    const modelArg = spaceIdx >= 0 ? raw.slice(spaceIdx + 1).trim() : "";
-                    if (!modelArg) {
-                        // Interactive picker via available models
-                        const picked = await pickReaderModel(config, ctx);
-                        if (picked === undefined) {
-                            ctx.ui.notify("Current reader model: " +
-                                config.reader_model +
-                                "\n\nChange: /read-delegator model <provider/model>", "info");
-                        }
-                        return;
-                    }
-                    config.reader_model = modelArg;
-                    (0, config_1.saveConfig)(config, { silent: true });
-                    syncReaderTemplate(modelArg);
-                    ctx.ui.notify("✅ Reader model set to: " + modelArg, "info");
-                    return;
-                }
-                case "status":
-                default: {
-                    const lines = [
-                        "Read delegation: " +
-                            (config.enabled ? "🟢 enabled" : "🔴 disabled"),
-                        "Reader subagent: " + config.reader_subagent_name,
-                        "Reader model: " + config.reader_model,
-                        "Dependencies: " + (depsReady ? "✅ ready" : "❌ missing"),
-                        "Blocked tools: " + config.blocked_tools.join(", "),
-                    ];
-                    ctx.ui.notify(lines.join("\n"), "info");
-                    return;
+            const modelArg = args?.trim() ?? "";
+            if (!modelArg) {
+                // Interactive picker via available models
+                const picked = await pickReaderModel(config, ctx);
+                if (picked === undefined) {
                 }
+                return;
             }
+            config.reader_model = modelArg;
+            saveConfig(config, { silent: true });
+            syncReaderTemplate(modelArg);
+            ctx.ui.notify("✅ Reader model set to: " + modelArg, "info");
         },
     });
     // 5. Background: sync reader.md template from config

package/{reader-manager.d.ts → dist/reader-manager.d.ts}

@@ -9,7 +9,32 @@
  */
 import type { ReadDelegatorConfig } from "./config";
 import type { ExtensionAgent } from "./tool-blocker";
-/** Progress callback for dependency installation. */
+export declare class SessionFileCache {
+    private files;
+    private readRanges;
+    /** Cache a file's content with a hash for change detection. */
+    set(path: string, content: string): void;
+    get(path: string): string | undefined;
+    has(path: string): boolean;
+    getHash(path: string): string | undefined;
+    /** Record that a specific line range of a path has been read. */
+    markReadRange(path: string, from: number, to: number): void;
+    getReadRanges(path: string): Array<[number, number]>;
+    /** Compute gaps (unread line ranges) given total line count. */
+    getUnreadRanges(path: string, totalLines: number): Array<[number, number]>;
+    /** Return cache statistics for the status command. */
+    stats(): {
+        files: number;
+        sizeKB: number;
+        ranges: number;
+    };
+    clear(): void;
+}
+/** Singleton cache instance shared across the extension session. */
+export declare const sessionCache: SessionFileCache;
+/**
+ * Progress callback for dependency installation.
+ */
 export type InstallProgress = "installing" | "done" | "failed";
 export interface AgentWithSubagent extends ExtensionAgent {
     /** Call a subagent by name with a task string. Returns the subagent's response. */