@element47/ag 4.5.3 → 4.5.5

package/dist/tools/bash.js

@@ -3,6 +3,8 @@
  */
 import { spawn } from 'node:child_process';
 const MAX_BUFFER = 1024 * 1024; // 1 MB
+const BG_MAX_OUTPUT = 100 * 1024; // 100 KB rolling buffer for background processes
+const BG_INITIAL_WAIT = 2000; // ms to wait for initial output from background process
 const DANGEROUS_PATTERNS = [
     { pattern: /\bfind\s+[~\/](?![\w.])/, message: 'Blocked: `find` on home/root directory. Use the grep tool (action=find) to search for files, or scope to a specific subdirectory.' },
     { pattern: /\brm\s+(-[a-zA-Z]*r[a-zA-Z]*)?\s*-[a-zA-Z]*f[a-zA-Z]*\s+[~\/]/, message: 'Blocked: destructive `rm` targeting home or root directory.' },
@@ -23,66 +25,196 @@ function checkCommand(command) {
     }
     return null;
 }
+const backgrounds = new Map();
+function appendOutput(bg, data) {
+    bg.output += data;
+    if (bg.output.length > BG_MAX_OUTPUT) {
+        bg.output = bg.output.slice(-BG_MAX_OUTPUT);
+    }
+}
+function startBackground(command, cwd) {
+    return new Promise((resolve) => {
+        const child = spawn('sh', ['-c', command], {
+            cwd,
+            stdio: ['pipe', 'pipe', 'pipe'],
+            detached: true,
+        });
+        const pid = child.pid;
+        if (!pid) {
+            resolve('Error: failed to start background process');
+            return;
+        }
+        const bg = {
+            child,
+            command,
+            output: '',
+            startedAt: Date.now(),
+            exited: false,
+            exitCode: null,
+        };
+        backgrounds.set(pid, bg);
+        child.stdout?.on('data', (chunk) => appendOutput(bg, chunk.toString()));
+        child.stderr?.on('data', (chunk) => appendOutput(bg, chunk.toString()));
+        child.on('close', (code) => {
+            bg.exited = true;
+            bg.exitCode = code;
+        });
+        child.on('error', (err) => {
+            bg.exited = true;
+            bg.exitCode = 1;
+            appendOutput(bg, `Process error: ${err.message}\n`);
+        });
+        // Wait briefly for initial output, then return
+        setTimeout(() => {
+            const initial = bg.output;
+            bg.output = ''; // clear so next read gets new output
+            const status = bg.exited
+                ? `Process exited immediately with code ${bg.exitCode}`
+                : `Background process started (PID ${pid})`;
+            const lines = [
+                status,
+                `Command: ${command}`,
+            ];
+            if (initial)
+                lines.push(`Initial output:\n${initial.trim()}`);
+            if (!bg.exited) {
+                lines.push(`Use bash(action="output", pid=${pid}) to check output`);
+                lines.push(`Use bash(action="kill", pid=${pid}) to stop it`);
+            }
+            resolve(lines.join('\n'));
+        }, BG_INITIAL_WAIT);
+    });
+}
+function getOutput(pid) {
+    const bg = backgrounds.get(pid);
+    if (!bg)
+        return `Error: no background process with PID ${pid}`;
+    const output = bg.output || '(no new output)';
+    bg.output = ''; // clear buffer
+    const status = bg.exited ? `[exited with code ${bg.exitCode}]` : '[running]';
+    return `PID ${pid} ${status} — ${bg.command}\n${output.trim()}`;
+}
+function killProcess(pid) {
+    const bg = backgrounds.get(pid);
+    if (!bg)
+        return `Error: no background process with PID ${pid}`;
+    if (!bg.exited) {
+        try {
+            process.kill(-pid, 'SIGTERM');
+        }
+        catch { /* already dead */ }
+        try {
+            bg.child.kill('SIGTERM');
+        }
+        catch { /* already dead */ }
+    }
+    const output = bg.output || '(no output)';
+    backgrounds.delete(pid);
+    return `PID ${pid} killed — ${bg.command}\nFinal output:\n${output.trim()}`;
+}
+/** Kill all background processes. Called on REPL exit. */
+export function cleanupBackgroundProcesses() {
+    for (const [pid, bg] of backgrounds) {
+        if (!bg.exited) {
+            try {
+                process.kill(-pid, 'SIGTERM');
+            }
+            catch { /* ignore */ }
+            try {
+                bg.child.kill('SIGTERM');
+            }
+            catch { /* ignore */ }
+        }
+    }
+    backgrounds.clear();
+}
+function runForeground(command, cwd) {
+    return new Promise((resolve) => {
+        const child = spawn('sh', ['-c', command], {
+            cwd,
+            timeout: 60_000,
+            stdio: ['pipe', 'pipe', 'pipe']
+        });
+        let stdout = '';
+        let stderr = '';
+        let stdoutOverflow = false;
+        child.stdout.on('data', (chunk) => {
+            if (stdout.length < MAX_BUFFER) {
+                stdout += chunk.toString();
+            }
+            else {
+                stdoutOverflow = true;
+            }
+        });
+        child.stderr.on('data', (chunk) => {
+            if (stderr.length < MAX_BUFFER) {
+                stderr += chunk.toString();
+            }
+        });
+        child.on('close', (code) => {
+            let result = stdout.trim();
+            if (stdoutOverflow) {
+                result += '\n... (output truncated at 1MB)';
+            }
+            if (code === 0) {
+                resolve(result);
+            }
+            else {
+                const status = code ?? 1;
+                resolve(`EXIT ${status}\n${(stdout + stderr).trim()}`);
+            }
+        });
+        child.on('error', (err) => {
+            resolve(`EXIT 1\n${err.message}`);
+        });
+    });
+}
 export function bashToolFactory(cwd) {
     return {
         type: 'function',
         function: {
             name: 'bash',
-            description: 'Run a shell command in the project directory. Use ONLY for: running tests, builds, installs, servers, and system operations. Do NOT use bash for: reading files (use file tool), editing files (use file tool), searching code (use grep tool), finding files (use grep tool), listing directories (use file tool), or git operations (use git tool). Dangerous commands like rm -rf, sudo rm, and pipe-to-shell are blocked.',
+            description: 'Run a shell command in the project directory. Use ONLY for: running tests, builds, installs, servers, and system operations. Do NOT use bash for: reading files (use file tool), editing files (use file tool), searching code (use grep tool), finding files (use grep tool), listing directories (use file tool), or git operations (use git tool). Dangerous commands like rm -rf, sudo rm, and pipe-to-shell are blocked. For long-running processes (dev servers, watchers), set background=true — returns PID immediately. Check output with action="output" pid=PID. Stop with action="kill" pid=PID.',
             parameters: {
                 type: 'object',
                 properties: {
                     command: {
                         type: 'string',
                         description: 'The shell command to execute'
+                    },
+                    background: {
+                        type: 'boolean',
+                        description: 'Run in background. Returns PID immediately. Use for dev servers, watchers, long-running processes.'
+                    },
+                    action: {
+                        type: 'string',
+                        enum: ['output', 'kill'],
+                        description: 'Action on a background process: "output" reads recent output, "kill" stops it'
+                    },
+                    pid: {
+                        type: 'number',
+                        description: 'PID of background process (required with action)'
                     }
                 },
-                required: ['command']
+                required: []
             }
         },
-        execute: ({ command }) => {
+        execute: async ({ command, background, action, pid }) => {
+            // Background process management
+            if (action === 'output' && pid != null)
+                return getOutput(pid);
+            if (action === 'kill' && pid != null)
+                return killProcess(pid);
+            if (action && !pid)
+                return 'Error: action requires a pid';
+            if (!command)
+                return 'Error: command is required';
             const blocked = checkCommand(command);
             if (blocked)
-                return Promise.resolve(blocked);
-            return new Promise((resolve) => {
-                const child = spawn('sh', ['-c', command], {
-                    cwd,
-                    timeout: 60_000,
-                    stdio: ['pipe', 'pipe', 'pipe']
-                });
-                let stdout = '';
-                let stderr = '';
-                let stdoutOverflow = false;
-                child.stdout.on('data', (chunk) => {
-                    if (stdout.length < MAX_BUFFER) {
-                        stdout += chunk.toString();
-                    }
-                    else {
-                        stdoutOverflow = true;
-                    }
-                });
-                child.stderr.on('data', (chunk) => {
-                    if (stderr.length < MAX_BUFFER) {
-                        stderr += chunk.toString();
-                    }
-                });
-                child.on('close', (code) => {
-                    let result = stdout.trim();
-                    if (stdoutOverflow) {
-                        result += '\n... (output truncated at 1MB)';
-                    }
-                    if (code === 0) {
-                        resolve(result);
-                    }
-                    else {
-                        const status = code ?? 1;
-                        resolve(`EXIT ${status}\n${(stdout + stderr).trim()}`);
-                    }
-                });
-                child.on('error', (err) => {
-                    resolve(`EXIT 1\n${err.message}`);
-                });
-            });
+                return blocked;
+            if (background)
+                return startBackground(command, cwd);
+            return runForeground(command, cwd);
         }
     };
 }

package/dist/tools/bash.js.map

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

package/dist/tools/task.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Task tool — structured task tracking for plans and sub-agents
+ */
+import { Tool } from '../core/types.js';
+export declare function taskTool(cwd: string): Tool;
+//# sourceMappingURL=task.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../../src/tools/task.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAWxC,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CA+G1C"}

package/dist/tools/task.js

@@ -0,0 +1,128 @@
+/**
+ * Task tool — structured task tracking for plans and sub-agents
+ */
+import { loadTasks, saveTasks, getActivePlanName } from '../memory/memory.js';
+const VALID_STATUSES = ['pending', 'in_progress', 'done'];
+function formatTask(t) {
+    const plan = t.plan ? ` (plan: ${t.plan})` : '';
+    const desc = t.description ? `\n   ${t.description}` : '';
+    return `${t.id}. [${t.status}] ${t.title}${plan}  (created ${t.created.slice(0, 10)})${desc}`;
+}
+export function taskTool(cwd) {
+    return {
+        type: 'function',
+        function: {
+            name: 'task',
+            description: 'Manage tasks — the executable steps of a plan. Use to track progress on multi-step work. Tasks appear in context so you always know what\'s done and what remains.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    action: {
+                        type: 'string',
+                        enum: ['create', 'list', 'update', 'read', 'remove', 'clear'],
+                        description: 'create: new task. list: show all. update: change status. read: task details. remove: delete. clear: remove all done tasks.'
+                    },
+                    title: {
+                        type: 'string',
+                        description: 'Task title (for create)'
+                    },
+                    id: {
+                        type: 'number',
+                        description: 'Task ID (for update, read, remove)'
+                    },
+                    description: {
+                        type: 'string',
+                        description: 'Detailed description of what needs to be done (for create). Gives sub-agents enough context to work independently.'
+                    },
+                    status: {
+                        type: 'string',
+                        enum: ['pending', 'in_progress', 'done'],
+                        description: 'New status (for update)'
+                    }
+                },
+                required: ['action']
+            }
+        },
+        execute: ({ action, title, description: desc, id, status }) => {
+            const tasks = loadTasks(cwd);
+            switch (action) {
+                case 'create': {
+                    if (!title)
+                        return 'Error: title is required for create';
+                    const nextId = tasks.length > 0 ? Math.max(...tasks.map(t => t.id)) + 1 : 1;
+                    const task = {
+                        id: nextId,
+                        title,
+                        description: desc || undefined,
+                        status: 'pending',
+                        plan: getActivePlanName(cwd) || undefined,
+                        created: new Date().toISOString(),
+                    };
+                    tasks.push(task);
+                    saveTasks(tasks, cwd);
+                    return `Task #${nextId} created: ${title}`;
+                }
+                case 'list': {
+                    if (tasks.length === 0)
+                        return 'No tasks.';
+                    const pending = tasks.filter(t => t.status === 'pending');
+                    const inProgress = tasks.filter(t => t.status === 'in_progress');
+                    const done = tasks.filter(t => t.status === 'done');
+                    const sections = [];
+                    if (inProgress.length > 0)
+                        sections.push('In Progress:\n' + inProgress.map(formatTask).join('\n'));
+                    if (pending.length > 0)
+                        sections.push('Pending:\n' + pending.map(formatTask).join('\n'));
+                    if (done.length > 0)
+                        sections.push('Done:\n' + done.map(formatTask).join('\n'));
+                    return sections.join('\n\n');
+                }
+                case 'update': {
+                    if (id == null)
+                        return 'Error: id is required for update';
+                    if (!status)
+                        return 'Error: status is required for update';
+                    if (!VALID_STATUSES.includes(status)) {
+                        return `Error: invalid status "${status}". Use: ${VALID_STATUSES.join(', ')}`;
+                    }
+                    const task = tasks.find(t => t.id === id);
+                    if (!task)
+                        return `Error: task #${id} not found`;
+                    task.status = status;
+                    saveTasks(tasks, cwd);
+                    return `Task #${id} updated: [${status}] ${task.title}`;
+                }
+                case 'read': {
+                    if (id == null)
+                        return 'Error: id is required for read';
+                    const task = tasks.find(t => t.id === id);
+                    if (!task)
+                        return `Error: task #${id} not found`;
+                    return formatTask(task);
+                }
+                case 'remove': {
+                    if (id == null)
+                        return 'Error: id is required for remove';
+                    const idx = tasks.findIndex(t => t.id === id);
+                    if (idx === -1)
+                        return `Error: task #${id} not found`;
+                    const removed = tasks.splice(idx, 1)[0];
+                    saveTasks(tasks, cwd);
+                    return `Task #${removed.id} removed: ${removed.title}`;
+                }
+                case 'clear': {
+                    const before = tasks.length;
+                    const remaining = tasks.filter(t => t.status !== 'done');
+                    saveTasks(remaining, cwd);
+                    const cleared = before - remaining.length;
+                    return cleared > 0
+                        ? `Cleared ${cleared} done task(s). ${remaining.length} remaining.`
+                        : 'No done tasks to clear.';
+                }
+                default:
+                    return `Error: unknown action "${action}". Use: create, list, update, read, remove, clear`;
+            }
+        }
+    };
+}
+//# sourceMappingURL=task.js.map

package/dist/tools/task.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@element47/ag",
-  "version": "4.5.3",
+  "version": "4.5.5",
   "description": "Persistent AI coding agent with memory - any model via OpenRouter",
   "type": "module",
   "bin": {