@prestyj/cli 4.2.15

package/dist/tools/subagent.js

@@ -0,0 +1,171 @@
+import { spawn } from "node:child_process";
+import { createInterface } from "node:readline";
+import { z } from "zod";
+import { truncateTail } from "./truncate.js";
+const SUB_AGENT_MAX_TURNS = 10;
+const SUB_AGENT_MAX_OUTPUT_CHARS = 100_000; // ~25k tokens, matches other tool limits
+const SUB_AGENT_MAX_OUTPUT_LINES = 500;
+const SUB_AGENT_MAX_STDERR_CHARS = 10_000; // Cap stderr to prevent unbounded growth
+const SubAgentParams = z.object({
+    task: z.string().describe("The task to delegate to the sub-agent"),
+    agent: z
+        .string()
+        .optional()
+        .describe("Named agent definition to use (from ~/.ezcoder/agents/ or .ezcoder/agents/)"),
+});
+export function createSubAgentTool(cwd, agents, parentProvider, parentModel) {
+    const agentList = agents.map((a) => `- ${a.name}: ${a.description}`).join("\n");
+    const agentDesc = agentList
+        ? `\n\nAvailable named agents:\n${agentList}`
+        : "\n\nNo named agents configured.";
+    return {
+        name: "subagent",
+        description: `Spawn an isolated sub-agent to handle a focused task. The sub-agent runs as a separate process with its own context window, tools, and system prompt. Use this for tasks that benefit from isolation or parallelism.` +
+            agentDesc,
+        parameters: SubAgentParams,
+        async execute(args, context) {
+            const startTime = Date.now();
+            // Resolve agent definition if specified
+            let agentDef;
+            if (args.agent) {
+                agentDef = agents.find((a) => a.name.toLowerCase() === args.agent.toLowerCase());
+                if (!agentDef) {
+                    return {
+                        content: `Unknown agent: "${args.agent}". Available agents: ${agents.map((a) => a.name).join(", ") || "none"}`,
+                    };
+                }
+            }
+            const useModel = agentDef?.model ?? parentModel;
+            const useProvider = parentProvider;
+            // Build CLI args — limit turns to prevent runaway context growth
+            const cliArgs = [
+                "--json",
+                "--provider",
+                useProvider,
+                "--model",
+                useModel,
+                "--max-turns",
+                String(SUB_AGENT_MAX_TURNS),
+            ];
+            if (agentDef?.systemPrompt) {
+                cliArgs.push("--system-prompt", agentDef.systemPrompt);
+            }
+            cliArgs.push(args.task);
+            // Spawn child process using same binary
+            const binPath = process.argv[1];
+            const child = spawn(process.execPath, [binPath, ...cliArgs], {
+                cwd,
+                stdio: ["ignore", "pipe", "pipe"],
+                env: { ...process.env },
+            });
+            // Track progress
+            let toolUseCount = 0;
+            const tokenUsage = { input: 0, output: 0 };
+            let currentActivity;
+            let textOutput = "";
+            // Handle abort signal
+            const abortHandler = () => {
+                child.kill("SIGTERM");
+                setTimeout(() => {
+                    if (!child.killed)
+                        child.kill("SIGKILL");
+                }, 3000);
+            };
+            context.signal.addEventListener("abort", abortHandler, { once: true });
+            return new Promise((resolve) => {
+                // Read NDJSON from stdout
+                const rl = createInterface({ input: child.stdout });
+                rl.on("line", (line) => {
+                    try {
+                        const event = JSON.parse(line);
+                        const type = event.type;
+                        switch (type) {
+                            case "text_delta":
+                                // Cap accumulation to ~2x the truncation limit (keeps tail for truncateTail)
+                                if (textOutput.length < SUB_AGENT_MAX_OUTPUT_CHARS * 2) {
+                                    textOutput += event.text;
+                                }
+                                else if (!textOutput.endsWith("[output capped]")) {
+                                    textOutput += "\n[output capped]";
+                                }
+                                break;
+                            case "tool_call_start":
+                                toolUseCount++;
+                                currentActivity = `${event.name}: ${truncateStr(JSON.stringify(event.args), 60)}`;
+                                context.onUpdate?.({
+                                    toolUseCount,
+                                    tokenUsage: { ...tokenUsage },
+                                    currentActivity,
+                                });
+                                break;
+                            case "tool_call_end":
+                                break;
+                            case "turn_end": {
+                                const usage = event.usage;
+                                if (usage) {
+                                    tokenUsage.input += usage.inputTokens;
+                                    tokenUsage.output += usage.outputTokens;
+                                }
+                                context.onUpdate?.({
+                                    toolUseCount,
+                                    tokenUsage: { ...tokenUsage },
+                                    currentActivity,
+                                });
+                                break;
+                            }
+                        }
+                    }
+                    catch {
+                        // Skip malformed lines
+                    }
+                });
+                // Collect stderr (capped to prevent unbounded memory growth)
+                let stderr = "";
+                child.stderr?.on("data", (chunk) => {
+                    if (stderr.length < SUB_AGENT_MAX_STDERR_CHARS) {
+                        stderr += chunk.toString();
+                        if (stderr.length > SUB_AGENT_MAX_STDERR_CHARS) {
+                            stderr = stderr.slice(0, SUB_AGENT_MAX_STDERR_CHARS);
+                        }
+                    }
+                });
+                child.on("close", (code) => {
+                    rl.close();
+                    context.signal.removeEventListener("abort", abortHandler);
+                    const durationMs = Date.now() - startTime;
+                    const details = {
+                        toolUseCount,
+                        tokenUsage: { ...tokenUsage },
+                        durationMs,
+                    };
+                    if (code !== 0 && !textOutput) {
+                        resolve({
+                            content: `Sub-agent failed (exit ${code}): ${stderr.trim() || "unknown error"}`,
+                            details,
+                        });
+                        return;
+                    }
+                    // Truncate output to prevent blowing up parent's context
+                    const raw = textOutput || "(no output)";
+                    const result = truncateTail(raw, SUB_AGENT_MAX_OUTPUT_LINES, SUB_AGENT_MAX_OUTPUT_CHARS);
+                    const content = result.truncated
+                        ? `[Sub-agent output truncated: ${result.totalLines} total lines, showing last ${result.keptLines}]\n\n` +
+                            result.content
+                        : result.content;
+                    resolve({ content, details });
+                });
+                child.on("error", (err) => {
+                    rl.close();
+                    context.signal.removeEventListener("abort", abortHandler);
+                    resolve({
+                        content: `Failed to spawn sub-agent: ${err.message}`,
+                    });
+                });
+            });
+        },
+    };
+}
+function truncateStr(s, max) {
+    return s.length > max ? s.slice(0, max - 1) + "…" : s;
+}
+//# sourceMappingURL=subagent.js.map

package/dist/tools/subagent.js.map

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

package/dist/tools/task-output.d.ts

@@ -0,0 +1,10 @@
+import { z } from "zod";
+import type { AgentTool } from "@prestyj/agent";
+import type { ProcessManager } from "../core/process-manager.js";
+declare const TaskOutputParams: z.ZodObject<{
+    id: z.ZodString;
+    from_start: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare function createTaskOutputTool(processManager: ProcessManager): AgentTool<typeof TaskOutputParams>;
+export {};
+//# sourceMappingURL=task-output.d.ts.map

package/dist/tools/task-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-output.d.ts","sourceRoot":"","sources":["../../src/tools/task-output.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAGjE,QAAA,MAAM,gBAAgB;;;iBAMpB,CAAC;AAEH,wBAAgB,oBAAoB,CAClC,cAAc,EAAE,cAAc,GAC7B,SAAS,CAAC,OAAO,gBAAgB,CAAC,CAyBpC"}

package/dist/tools/task-output.js

@@ -0,0 +1,33 @@
+import { z } from "zod";
+import { truncateTail } from "./truncate.js";
+const TaskOutputParams = z.object({
+    id: z.string().describe("The background process ID"),
+    from_start: z
+        .boolean()
+        .optional()
+        .describe("If true, read output from the beginning instead of incrementally"),
+});
+export function createTaskOutputTool(processManager) {
+    return {
+        name: "task_output",
+        description: "Read output from a background process. Returns new output since last read by default. " +
+            "Use from_start=true to read from the beginning.",
+        parameters: TaskOutputParams,
+        async execute({ id, from_start }) {
+            const result = await processManager.readOutput(id, from_start);
+            const status = result.isRunning ? "running" : `exited (code ${result.exitCode})`;
+            let output = result.output;
+            if (output) {
+                const truncated = truncateTail(output);
+                output = truncated.truncated
+                    ? `[Truncated: showing last ${truncated.keptLines} of ${truncated.totalLines} lines]\n${truncated.content}`
+                    : truncated.content;
+            }
+            else {
+                output = "(no new output)";
+            }
+            return `Process ${id}: ${status}\n${output}`;
+        },
+    };
+}
+//# sourceMappingURL=task-output.js.map

package/dist/tools/task-output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-output.js","sourceRoot":"","sources":["../../src/tools/task-output.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;IACpD,UAAU,EAAE,CAAC;SACV,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CAAC,kEAAkE,CAAC;CAChF,CAAC,CAAC;AAEH,MAAM,UAAU,oBAAoB,CAClC,cAA8B;IAE9B,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,WAAW,EACT,wFAAwF;YACxF,iDAAiD;QACnD,UAAU,EAAE,gBAAgB;QAC5B,KAAK,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,UAAU,EAAE;YAC9B,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,UAAU,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;YAE/D,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,gBAAgB,MAAM,CAAC,QAAQ,GAAG,CAAC;YAEjF,IAAI,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;YAC3B,IAAI,MAAM,EAAE,CAAC;gBACX,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;gBACvC,MAAM,GAAG,SAAS,CAAC,SAAS;oBAC1B,CAAC,CAAC,4BAA4B,SAAS,CAAC,SAAS,OAAO,SAAS,CAAC,UAAU,YAAY,SAAS,CAAC,OAAO,EAAE;oBAC3G,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC;YACxB,CAAC;iBAAM,CAAC;gBACN,MAAM,GAAG,iBAAiB,CAAC;YAC7B,CAAC;YAED,OAAO,WAAW,EAAE,KAAK,MAAM,KAAK,MAAM,EAAE,CAAC;QAC/C,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/task-stop.d.ts

@@ -0,0 +1,9 @@
+import { z } from "zod";
+import type { AgentTool } from "@prestyj/agent";
+import type { ProcessManager } from "../core/process-manager.js";
+declare const TaskStopParams: z.ZodObject<{
+    id: z.ZodString;
+}, z.core.$strip>;
+export declare function createTaskStopTool(processManager: ProcessManager): AgentTool<typeof TaskStopParams>;
+export {};
+//# sourceMappingURL=task-stop.d.ts.map

package/dist/tools/task-stop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-stop.d.ts","sourceRoot":"","sources":["../../src/tools/task-stop.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjE,QAAA,MAAM,cAAc;;iBAElB,CAAC;AAEH,wBAAgB,kBAAkB,CAChC,cAAc,EAAE,cAAc,GAC7B,SAAS,CAAC,OAAO,cAAc,CAAC,CASlC"}

package/dist/tools/task-stop.js

@@ -0,0 +1,15 @@
+import { z } from "zod";
+const TaskStopParams = z.object({
+    id: z.string().describe("The background process ID to stop"),
+});
+export function createTaskStopTool(processManager) {
+    return {
+        name: "task_stop",
+        description: "Stop a background process by ID. Sends SIGTERM, then SIGKILL after 5 seconds.",
+        parameters: TaskStopParams,
+        async execute({ id }) {
+            return processManager.stop(id);
+        },
+    };
+}
+//# sourceMappingURL=task-stop.js.map

package/dist/tools/task-stop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-stop.js","sourceRoot":"","sources":["../../src/tools/task-stop.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9B,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;CAC7D,CAAC,CAAC;AAEH,MAAM,UAAU,kBAAkB,CAChC,cAA8B;IAE9B,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE,+EAA+E;QAC5F,UAAU,EAAE,cAAc;QAC1B,KAAK,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE;YAClB,OAAO,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/tasks.d.ts

@@ -0,0 +1,16 @@
+import { z } from "zod";
+import type { AgentTool } from "@prestyj/agent";
+declare const TasksParams: z.ZodObject<{
+    action: z.ZodEnum<{
+        add: "add";
+        done: "done";
+        list: "list";
+        remove: "remove";
+    }>;
+    title: z.ZodOptional<z.ZodString>;
+    prompt: z.ZodOptional<z.ZodString>;
+    id: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare function createTasksTool(cwd: string): AgentTool<typeof TasksParams>;
+export {};
+//# sourceMappingURL=tasks.d.ts.map

package/dist/tools/tasks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../src/tools/tasks.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAiDhD,QAAA,MAAM,WAAW;;;;;;;;;;iBAgBf,CAAC;AAEH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,WAAW,CAAC,CAgF1E"}

package/dist/tools/tasks.js

@@ -0,0 +1,132 @@
+import { createHash, randomUUID } from "node:crypto";
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { basename, join } from "node:path";
+import { z } from "zod";
+import { log } from "../core/logger.js";
+const TASKS_BASE = join(homedir(), ".ezcoder-tasks", "projects");
+function hashPath(cwd) {
+    return createHash("sha256").update(cwd).digest("hex").slice(0, 16);
+}
+function projectDir(cwd) {
+    return join(TASKS_BASE, hashPath(cwd));
+}
+async function loadTasks(cwd) {
+    try {
+        const data = await readFile(join(projectDir(cwd), "tasks.json"), "utf-8");
+        const raw = JSON.parse(data);
+        // Migrate old tasks that only have `text` (no title/prompt split)
+        return raw.map((t) => {
+            if (!t.prompt && t.text) {
+                return { ...t, title: t.text, prompt: t.text, text: undefined };
+            }
+            return t;
+        });
+    }
+    catch {
+        return [];
+    }
+}
+async function saveTasks(cwd, tasks) {
+    const dir = projectDir(cwd);
+    await mkdir(dir, { recursive: true });
+    await writeFile(join(dir, "tasks.json"), JSON.stringify(tasks, null, 2) + "\n", "utf-8");
+    // Also write meta so the task pane can find this project
+    const meta = JSON.stringify({ path: cwd, name: basename(cwd) }, null, 2) + "\n";
+    await writeFile(join(dir, "meta.json"), meta, "utf-8");
+}
+const TasksParams = z.object({
+    action: z
+        .enum(["add", "list", "done", "remove"])
+        .describe("Action: add a task, list tasks, mark done, or remove"),
+    title: z
+        .string()
+        .optional()
+        .describe("Short task title for display (max ~10 words, required for add)"),
+    prompt: z
+        .string()
+        .optional()
+        .describe("The standalone prompt sent to an agent with no context (required for add). " +
+        "Concise, actionable instruction with file paths and what to change."),
+    id: z.string().optional().describe("Task ID (required for done/remove — use list to find IDs)"),
+});
+export function createTasksTool(cwd) {
+    // Mutex to serialize concurrent tool calls (agent loop runs tools in parallel)
+    let pending = Promise.resolve();
+    function enqueue(fn) {
+        const result = pending.then(fn);
+        // Update pending chain (swallow errors so the queue keeps moving)
+        pending = result.then(() => { }, () => { });
+        return result;
+    }
+    return {
+        name: "tasks",
+        description: "Manage the project task list. Each task has a short title (shown in " +
+            "the task pane) and a prompt (sent as a standalone instruction to an " +
+            "agent with no context). Write prompts as concise, actionable directives " +
+            "with specific file paths — the agent must complete it from the prompt alone. " +
+            "When adding multiple tasks, order them by dependency — foundational work " +
+            "first, then core logic, integration, UI, and tests.",
+        parameters: TasksParams,
+        execute({ action, title, prompt, id }) {
+            return enqueue(async () => {
+                switch (action) {
+                    case "add": {
+                        if (!title)
+                            return "Error: title is required for add action.";
+                        if (!prompt)
+                            return "Error: prompt is required for add action.";
+                        const tasks = await loadTasks(cwd);
+                        const newTask = {
+                            id: randomUUID(),
+                            title,
+                            prompt,
+                            status: "pending",
+                            createdAt: new Date().toISOString(),
+                        };
+                        tasks.push(newTask);
+                        await saveTasks(cwd, tasks);
+                        log("INFO", "tasks", `Task added: ${title}`, { id: newTask.id });
+                        return `Task added: "${title}" (id: ${newTask.id.slice(0, 8)})`;
+                    }
+                    case "list": {
+                        const tasks = await loadTasks(cwd);
+                        if (tasks.length === 0)
+                            return "No tasks.";
+                        const lines = tasks.map((t) => {
+                            const check = t.status === "done" ? "✓" : t.status === "in-progress" ? "~" : " ";
+                            return `[${check}] ${t.title}  (id: ${t.id.slice(0, 8)}, ${t.status})`;
+                        });
+                        log("INFO", "tasks", `Listed ${tasks.length} tasks`);
+                        return lines.join("\n");
+                    }
+                    case "done": {
+                        if (!id)
+                            return "Error: id is required for done action.";
+                        const tasks = await loadTasks(cwd);
+                        const task = tasks.find((t) => t.id === id || t.id.startsWith(id));
+                        if (!task)
+                            return `Error: no task found matching id "${id}".`;
+                        task.status = "done";
+                        await saveTasks(cwd, tasks);
+                        log("INFO", "tasks", `Task done: ${task.title}`, { id: task.id });
+                        return `Marked done: "${task.title}"`;
+                    }
+                    case "remove": {
+                        if (!id)
+                            return "Error: id is required for remove action.";
+                        const tasks = await loadTasks(cwd);
+                        const idx = tasks.findIndex((t) => t.id === id || t.id.startsWith(id));
+                        if (idx === -1)
+                            return `Error: no task found matching id "${id}".`;
+                        const removed = tasks.splice(idx, 1)[0];
+                        await saveTasks(cwd, tasks);
+                        log("INFO", "tasks", `Task removed: ${removed.title}`, { id: removed.id });
+                        return `Removed: "${removed.title}"`;
+                    }
+                }
+            });
+        },
+    };
+}
+//# sourceMappingURL=tasks.js.map

package/dist/tools/tasks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks.js","sourceRoot":"","sources":["../../src/tools/tasks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAExC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,gBAAgB,EAAE,UAAU,CAAC,CAAC;AAajE,SAAS,QAAQ,CAAC,GAAW;IAC3B,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACrE,CAAC;AAED,SAAS,UAAU,CAAC,GAAW;IAC7B,OAAO,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;AACzC,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,GAAW;IAClC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,YAAY,CAAC,EAAE,OAAO,CAAC,CAAC;QAC1E,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAW,CAAC;QACvC,kEAAkE;QAClE,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YACnB,IAAI,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;gBACxB,OAAO,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;YAClE,CAAC;YACD,OAAO,CAAC,CAAC;QACX,CAAC,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,GAAW,EAAE,KAAa;IACjD,MAAM,GAAG,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;IAC5B,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,MAAM,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;IACzF,yDAAyD;IACzD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;IAChF,MAAM,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3B,MAAM,EAAE,CAAC;SACN,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;SACvC,QAAQ,CAAC,sDAAsD,CAAC;IACnE,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,gEAAgE,CAAC;IAC7E,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,6EAA6E;QAC3E,qEAAqE,CACxE;IACH,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2DAA2D,CAAC;CAChG,CAAC,CAAC;AAEH,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,+EAA+E;IAC/E,IAAI,OAAO,GAAkB,OAAO,CAAC,OAAO,EAAE,CAAC;IAE/C,SAAS,OAAO,CAAI,EAAoB;QACtC,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAChC,kEAAkE;QAClE,OAAO,GAAG,MAAM,CAAC,IAAI,CACnB,GAAG,EAAE,GAAE,CAAC,EACR,GAAG,EAAE,GAAE,CAAC,CACT,CAAC;QACF,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,OAAO;QACL,IAAI,EAAE,OAAO;QACb,WAAW,EACT,sEAAsE;YACtE,sEAAsE;YACtE,0EAA0E;YAC1E,+EAA+E;YAC/E,2EAA2E;YAC3E,qDAAqD;QACvD,UAAU,EAAE,WAAW;QACvB,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE;YACnC,OAAO,OAAO,CAAC,KAAK,IAAI,EAAE;gBACxB,QAAQ,MAAM,EAAE,CAAC;oBACf,KAAK,KAAK,CAAC,CAAC,CAAC;wBACX,IAAI,CAAC,KAAK;4BAAE,OAAO,0CAA0C,CAAC;wBAC9D,IAAI,CAAC,MAAM;4BAAE,OAAO,2CAA2C,CAAC;wBAChE,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,GAAG,CAAC,CAAC;wBACnC,MAAM,OAAO,GAAS;4BACpB,EAAE,EAAE,UAAU,EAAE;4BAChB,KAAK;4BACL,MAAM;4BACN,MAAM,EAAE,SAAS;4BACjB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;yBACpC,CAAC;wBACF,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;wBACpB,MAAM,SAAS,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;wBAC5B,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,eAAe,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;wBACjE,OAAO,gBAAgB,KAAK,UAAU,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC;oBAClE,CAAC;oBAED,KAAK,MAAM,CAAC,CAAC,CAAC;wBACZ,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,GAAG,CAAC,CAAC;wBACnC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;4BAAE,OAAO,WAAW,CAAC;wBAC3C,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;4BAC5B,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;4BACjF,OAAO,IAAI,KAAK,KAAK,CAAC,CAAC,KAAK,UAAU,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC;wBACzE,CAAC,CAAC,CAAC;wBACH,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,UAAU,KAAK,CAAC,MAAM,QAAQ,CAAC,CAAC;wBACrD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBAC1B,CAAC;oBAED,KAAK,MAAM,CAAC,CAAC,CAAC;wBACZ,IAAI,CAAC,EAAE;4BAAE,OAAO,wCAAwC,CAAC;wBACzD,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,GAAG,CAAC,CAAC;wBACnC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC;wBACnE,IAAI,CAAC,IAAI;4BAAE,OAAO,qCAAqC,EAAE,IAAI,CAAC;wBAC9D,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;wBACrB,MAAM,SAAS,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;wBAC5B,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,cAAc,IAAI,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;wBAClE,OAAO,iBAAiB,IAAI,CAAC,KAAK,GAAG,CAAC;oBACxC,CAAC;oBAED,KAAK,QAAQ,CAAC,CAAC,CAAC;wBACd,IAAI,CAAC,EAAE;4BAAE,OAAO,0CAA0C,CAAC;wBAC3D,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,GAAG,CAAC,CAAC;wBACnC,MAAM,GAAG,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC;wBACvE,IAAI,GAAG,KAAK,CAAC,CAAC;4BAAE,OAAO,qCAAqC,EAAE,IAAI,CAAC;wBACnE,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;wBACxC,MAAM,SAAS,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;wBAC5B,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,iBAAiB,OAAO,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;wBAC3E,OAAO,aAAa,OAAO,CAAC,KAAK,GAAG,CAAC;oBACvC,CAAC;gBACH,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/truncate.d.ts

@@ -0,0 +1,19 @@
+export declare const MAX_LINES = 500;
+export declare const MAX_CHARS = 100000;
+export interface TruncateResult {
+    content: string;
+    truncated: boolean;
+    totalLines: number;
+    keptLines: number;
+}
+/**
+ * Truncate from the end — keep the first N lines.
+ * Used by the read tool.
+ */
+export declare function truncateHead(content: string, maxLines?: number, maxChars?: number): TruncateResult;
+/**
+ * Truncate from the beginning — keep the last N lines.
+ * Used by the bash tool.
+ */
+export declare function truncateTail(content: string, maxLines?: number, maxChars?: number): TruncateResult;
+//# sourceMappingURL=truncate.d.ts.map

package/dist/tools/truncate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"truncate.d.ts","sourceRoot":"","sources":["../../src/tools/truncate.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,SAAS,MAAM,CAAC;AAC7B,eAAO,MAAM,SAAS,SAAU,CAAC;AAEjC,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,QAAQ,SAAY,EACpB,QAAQ,SAAY,GACnB,cAAc,CA0BhB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,QAAQ,SAAY,EACpB,QAAQ,SAAY,GACnB,cAAc,CA0BhB"}

package/dist/tools/truncate.js

@@ -0,0 +1,59 @@
+export const MAX_LINES = 500;
+export const MAX_CHARS = 100_000; // ~25,000 tokens at ~4 chars/token
+/**
+ * Truncate from the end — keep the first N lines.
+ * Used by the read tool.
+ */
+export function truncateHead(content, maxLines = MAX_LINES, maxChars = MAX_CHARS) {
+    const lines = content.split("\n");
+    const totalLines = lines.length;
+    // Limit by line count
+    let kept = lines.slice(0, maxLines);
+    // Limit by character count
+    let size = 0;
+    let cutIndex = kept.length;
+    for (let i = 0; i < kept.length; i++) {
+        size += kept[i].length + 1; // +1 for newline
+        if (size > maxChars) {
+            cutIndex = i;
+            break;
+        }
+    }
+    kept = kept.slice(0, cutIndex);
+    const truncated = kept.length < totalLines;
+    return {
+        content: kept.join("\n"),
+        truncated,
+        totalLines,
+        keptLines: kept.length,
+    };
+}
+/**
+ * Truncate from the beginning — keep the last N lines.
+ * Used by the bash tool.
+ */
+export function truncateTail(content, maxLines = MAX_LINES, maxChars = MAX_CHARS) {
+    const lines = content.split("\n");
+    const totalLines = lines.length;
+    // Limit by line count — keep last N
+    let kept = lines.slice(-maxLines);
+    // Limit by character count — keep last N chars
+    let size = 0;
+    let cutIndex = 0;
+    for (let i = kept.length - 1; i >= 0; i--) {
+        size += kept[i].length + 1;
+        if (size > maxChars) {
+            cutIndex = i + 1;
+            break;
+        }
+    }
+    kept = kept.slice(cutIndex);
+    const truncated = kept.length < totalLines;
+    return {
+        content: kept.join("\n"),
+        truncated,
+        totalLines,
+        keptLines: kept.length,
+    };
+}
+//# sourceMappingURL=truncate.js.map

package/dist/tools/truncate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"truncate.js","sourceRoot":"","sources":["../../src/tools/truncate.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,SAAS,GAAG,GAAG,CAAC;AAC7B,MAAM,CAAC,MAAM,SAAS,GAAG,OAAO,CAAC,CAAC,mCAAmC;AASrE;;;GAGG;AACH,MAAM,UAAU,YAAY,CAC1B,OAAe,EACf,QAAQ,GAAG,SAAS,EACpB,QAAQ,GAAG,SAAS;IAEpB,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC;IAEhC,sBAAsB;IACtB,IAAI,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IAEpC,2BAA2B;IAC3B,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,IAAI,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC;IAC3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,iBAAiB;QAC7C,IAAI,IAAI,GAAG,QAAQ,EAAE,CAAC;YACpB,QAAQ,GAAG,CAAC,CAAC;YACb,MAAM;QACR,CAAC;IACH,CAAC;IACD,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IAE/B,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC;IAC3C,OAAO;QACL,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;QACxB,SAAS;QACT,UAAU;QACV,SAAS,EAAE,IAAI,CAAC,MAAM;KACvB,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAC1B,OAAe,EACf,QAAQ,GAAG,SAAS,EACpB,QAAQ,GAAG,SAAS;IAEpB,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC;IAEhC,oCAAoC;IACpC,IAAI,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC;IAElC,+CAA+C;IAC/C,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1C,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;QAC3B,IAAI,IAAI,GAAG,QAAQ,EAAE,CAAC;YACpB,QAAQ,GAAG,CAAC,GAAG,CAAC,CAAC;YACjB,MAAM;QACR,CAAC;IACH,CAAC;IACD,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAE5B,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC;IAC3C,OAAO;QACL,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;QACxB,SAAS;QACT,UAAU;QACV,SAAS,EAAE,IAAI,CAAC,MAAM;KACvB,CAAC;AACJ,CAAC"}

package/dist/tools/truncate.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=truncate.test.d.ts.map

package/dist/tools/truncate.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"truncate.test.d.ts","sourceRoot":"","sources":["../../src/tools/truncate.test.ts"],"names":[],"mappings":""}

package/dist/tools/truncate.test.js

@@ -0,0 +1,100 @@
+import { describe, it, expect } from "vitest";
+import { truncateHead, truncateTail } from "./truncate.js";
+// ── truncateHead ───────────────────────────────────────────
+describe("truncateHead", () => {
+    it("returns content unchanged when within limits", () => {
+        const content = "line1\nline2\nline3";
+        const result = truncateHead(content);
+        expect(result.truncated).toBe(false);
+        expect(result.content).toBe(content);
+        expect(result.totalLines).toBe(3);
+        expect(result.keptLines).toBe(3);
+    });
+    it("truncates by line count", () => {
+        const lines = Array.from({ length: 10 }, (_, i) => `line${i}`);
+        const content = lines.join("\n");
+        const result = truncateHead(content, 5);
+        expect(result.truncated).toBe(true);
+        expect(result.keptLines).toBe(5);
+        expect(result.totalLines).toBe(10);
+        expect(result.content).toBe(lines.slice(0, 5).join("\n"));
+    });
+    it("truncates by character count", () => {
+        // 5 lines of 10 chars each + 4 newlines = 54 chars
+        const lines = Array.from({ length: 5 }, () => "abcdefghij");
+        const content = lines.join("\n");
+        // maxChars = 25 → should keep ~2 lines (10+1+10+1 = 22 < 25, next would be 33 > 25)
+        const result = truncateHead(content, 500, 25);
+        expect(result.truncated).toBe(true);
+        expect(result.keptLines).toBe(2);
+    });
+    it("handles empty content", () => {
+        const result = truncateHead("");
+        expect(result.truncated).toBe(false);
+        expect(result.content).toBe("");
+        expect(result.totalLines).toBe(1); // split("") gives [""]
+        expect(result.keptLines).toBe(1);
+    });
+    it("handles single line", () => {
+        const result = truncateHead("hello world", 500, 100_000);
+        expect(result.truncated).toBe(false);
+        expect(result.content).toBe("hello world");
+    });
+    it("line limit takes precedence when hit first", () => {
+        const lines = Array.from({ length: 100 }, (_, i) => `${i}`);
+        const content = lines.join("\n");
+        // Short lines, many of them — line limit (3) hit before char limit
+        const result = truncateHead(content, 3, 100_000);
+        expect(result.keptLines).toBe(3);
+        expect(result.truncated).toBe(true);
+    });
+});
+// ── truncateTail ───────────────────────────────────────────
+describe("truncateTail", () => {
+    it("returns content unchanged when within limits", () => {
+        const content = "line1\nline2\nline3";
+        const result = truncateTail(content);
+        expect(result.truncated).toBe(false);
+        expect(result.content).toBe(content);
+        expect(result.totalLines).toBe(3);
+        expect(result.keptLines).toBe(3);
+    });
+    it("keeps last N lines", () => {
+        const lines = Array.from({ length: 10 }, (_, i) => `line${i}`);
+        const content = lines.join("\n");
+        const result = truncateTail(content, 3);
+        expect(result.truncated).toBe(true);
+        expect(result.keptLines).toBe(3);
+        expect(result.totalLines).toBe(10);
+        expect(result.content).toBe(lines.slice(7).join("\n"));
+    });
+    it("truncates by character count keeping tail", () => {
+        const lines = Array.from({ length: 5 }, () => "abcdefghij");
+        const content = lines.join("\n");
+        // maxChars = 25 → keep last ~2 lines
+        const result = truncateTail(content, 500, 25);
+        expect(result.truncated).toBe(true);
+        expect(result.keptLines).toBe(2);
+        // Should contain the last 2 lines
+        expect(result.content).toBe(lines.slice(3).join("\n"));
+    });
+    it("handles empty content", () => {
+        const result = truncateTail("");
+        expect(result.truncated).toBe(false);
+        expect(result.content).toBe("");
+    });
+    it("handles single line", () => {
+        const result = truncateTail("hello world", 500, 100_000);
+        expect(result.truncated).toBe(false);
+        expect(result.content).toBe("hello world");
+    });
+    it("line limit takes precedence when hit first", () => {
+        const lines = Array.from({ length: 100 }, (_, i) => `${i}`);
+        const content = lines.join("\n");
+        const result = truncateTail(content, 3, 100_000);
+        expect(result.keptLines).toBe(3);
+        expect(result.truncated).toBe(true);
+        expect(result.content).toBe(lines.slice(97).join("\n"));
+    });
+});
+//# sourceMappingURL=truncate.test.js.map