@mragentix/cli 4.2.37

package/dist/tools/operations.js

@@ -0,0 +1,27 @@
+import fs from "node:fs/promises";
+import { spawn } from "node:child_process";
+import { createReadStream } from "node:fs";
+/**
+ * Default local filesystem + process operations.
+ * This is what tools use when running on the local machine.
+ */
+export const localOperations = {
+    readFile: (path) => fs.readFile(path, "utf-8"),
+    writeFile: async (path, content) => {
+        const { dirname } = await import("node:path");
+        await fs.mkdir(dirname(path), { recursive: true });
+        await fs.writeFile(path, content, "utf-8");
+    },
+    stat: (path) => fs.stat(path),
+    lstat: (path) => fs.lstat(path),
+    readdir: (path, options) => fs.readdir(path, options),
+    mkdir: (path) => fs.mkdir(path, { recursive: true }).then(() => { }),
+    createReadStream: (path, encoding) => createReadStream(path, { encoding }),
+    spawn: (command, args, options) => spawn(command, args, {
+        cwd: options.cwd,
+        env: options.env,
+        detached: options.detached,
+        stdio: options.stdio,
+    }),
+};
+//# sourceMappingURL=operations.js.map

package/dist/tools/operations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.js","sourceRoot":"","sources":["../../src/tools/operations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,EAAE,KAAK,EAAqB,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAmB,MAAM,SAAS,CAAC;AA2C5D;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAmB;IAC7C,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAE9C,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE;QACjC,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;QAC9C,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACnD,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;IAED,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;IAE7B,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;IAE/B,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAsB;IAE1E,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC;IAEnE,gBAAgB,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC,gBAAgB,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC;IAE1E,KAAK,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,CAChC,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE;QACnB,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,KAAK,EAAE,OAAO,CAAC,KAA2E;KAC3F,CAAC;CACL,CAAC"}

package/dist/tools/path-utils.d.ts

@@ -0,0 +1,7 @@
+export declare function resolvePath(cwd: string, filePath: string): string;
+/**
+ * Check if a path is a symlink. Used by file tools to prevent symlink-based
+ * attacks that could read/write sensitive files outside the working directory.
+ */
+export declare function rejectSymlink(resolved: string): Promise<void>;
+//# sourceMappingURL=path-utils.d.ts.map

package/dist/tools/path-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-utils.d.ts","sourceRoot":"","sources":["../../src/tools/path-utils.ts"],"names":[],"mappings":"AAIA,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAKjE;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAUnE"}

package/dist/tools/path-utils.js

@@ -0,0 +1,27 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import os from "node:os";
+export function resolvePath(cwd, filePath) {
+    if (filePath.startsWith("~")) {
+        filePath = path.join(os.homedir(), filePath.slice(1));
+    }
+    return path.resolve(cwd, filePath);
+}
+/**
+ * Check if a path is a symlink. Used by file tools to prevent symlink-based
+ * attacks that could read/write sensitive files outside the working directory.
+ */
+export async function rejectSymlink(resolved) {
+    try {
+        const stat = await fs.lstat(resolved);
+        if (stat.isSymbolicLink()) {
+            throw new Error(`Refusing to follow symlink: ${resolved}`);
+        }
+    }
+    catch (err) {
+        // Re-throw our own error; swallow ENOENT (file doesn't exist yet, e.g. write/new file)
+        if (err instanceof Error && err.message.startsWith("Refusing to follow"))
+            throw err;
+    }
+}
+//# sourceMappingURL=path-utils.js.map

package/dist/tools/path-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-utils.js","sourceRoot":"","sources":["../../src/tools/path-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AAEzB,MAAM,UAAU,WAAW,CAAC,GAAW,EAAE,QAAgB;IACvD,IAAI,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC7B,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACxD,CAAC;IACD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;AACrC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,QAAgB;IAClD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACtC,IAAI,IAAI,CAAC,cAAc,EAAE,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,+BAA+B,QAAQ,EAAE,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,uFAAuF;QACvF,IAAI,GAAG,YAAY,KAAK,IAAI,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,oBAAoB,CAAC;YAAE,MAAM,GAAG,CAAC;IACtF,CAAC;AACH,CAAC"}

package/dist/tools/read.d.ts

@@ -0,0 +1,12 @@
+import { z } from "zod";
+import type { AgentTool } from "@mragentix/agent";
+import { type ToolOperations } from "./operations.js";
+export declare const BINARY_EXTENSIONS: Set<string>;
+declare const ReadParams: z.ZodObject<{
+    file_path: z.ZodString;
+    offset: z.ZodOptional<z.ZodNumber>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare function createReadTool(cwd: string, readFiles?: Set<string>, ops?: ToolOperations): AgentTool<typeof ReadParams>;
+export {};
+//# sourceMappingURL=read.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../src/tools/read.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAGlD,OAAO,EAAmB,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEvE,eAAO,MAAM,iBAAiB,aAqD5B,CAAC;AAEH,QAAA,MAAM,UAAU;;;;iBASd,CAAC;AAEH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,EACX,SAAS,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,EACvB,GAAG,GAAE,cAAgC,GACpC,SAAS,CAAC,OAAO,UAAU,CAAC,CAmD9B"}

package/dist/tools/read.js

@@ -0,0 +1,113 @@
+import path from "node:path";
+import { z } from "zod";
+import { resolvePath, rejectSymlink } from "./path-utils.js";
+import { truncateHead } from "./truncate.js";
+import { localOperations } from "./operations.js";
+export const BINARY_EXTENSIONS = new Set([
+    ".png",
+    ".jpg",
+    ".jpeg",
+    ".gif",
+    ".bmp",
+    ".ico",
+    ".webp",
+    ".svg",
+    ".mp3",
+    ".mp4",
+    ".wav",
+    ".avi",
+    ".mov",
+    ".mkv",
+    ".flac",
+    ".zip",
+    ".tar",
+    ".gz",
+    ".bz2",
+    ".7z",
+    ".rar",
+    ".pdf",
+    ".doc",
+    ".docx",
+    ".xls",
+    ".xlsx",
+    ".ppt",
+    ".pptx",
+    ".exe",
+    ".dll",
+    ".so",
+    ".dylib",
+    ".bin",
+    ".dat",
+    ".woff",
+    ".woff2",
+    ".ttf",
+    ".eot",
+    ".otf",
+    ".pyc",
+    ".class",
+    ".o",
+    ".obj",
+    ".asar",
+    ".node",
+    ".wasm",
+    ".db",
+    ".sqlite",
+    ".sqlite3",
+    ".snap",
+    ".pack",
+    ".idx",
+]);
+const ReadParams = z.object({
+    file_path: z.string().describe("The file path to read"),
+    offset: z
+        .number()
+        .int()
+        .min(1)
+        .optional()
+        .describe("Line number to start reading from (1-based)"),
+    limit: z.number().int().min(1).optional().describe("Maximum number of lines to read"),
+});
+export function createReadTool(cwd, readFiles, ops = localOperations) {
+    return {
+        name: "read",
+        description: "Read a file's contents. Returns numbered lines (cat -n style). " +
+            "Output is capped at ~25,000 tokens. If truncated, use offset/limit to read remaining sections. " +
+            "Binary files return a notice instead of content.",
+        parameters: ReadParams,
+        async execute({ file_path, offset, limit }) {
+            const resolved = resolvePath(cwd, file_path);
+            await rejectSymlink(resolved);
+            readFiles?.add(resolved);
+            const ext = path.extname(resolved).toLowerCase();
+            if (BINARY_EXTENSIONS.has(ext)) {
+                const stat = await ops.stat(resolved);
+                return `Binary file: ${resolved} (${ext}, ${stat.size} bytes)`;
+            }
+            const raw = await ops.readFile(resolved);
+            let lines = raw.split("\n");
+            // Apply offset/limit
+            const startLine = offset ? offset - 1 : 0;
+            const endLine = limit ? startLine + limit : lines.length;
+            lines = lines.slice(startLine, endLine);
+            const content = lines.join("\n");
+            const result = truncateHead(content);
+            // Prepend line numbers (cat -n style)
+            const actualStart = startLine + 1;
+            const numbered = result.content
+                .split("\n")
+                .map((line, i) => {
+                const lineNum = String(actualStart + i).padStart(6, " ");
+                return `${lineNum}\t${line}`;
+            })
+                .join("\n");
+            if (result.truncated) {
+                const nextOffset = (offset ?? 1) + result.keptLines;
+                return (`${numbered}\n` +
+                    `[Truncated: showing lines ${offset ?? 1}-${(offset ?? 1) + result.keptLines - 1} of ${result.totalLines}. ` +
+                    `Use offset=${nextOffset} to read more.]`);
+            }
+            return numbered;
+        },
+    };
+}
+//# sourceMappingURL=read.js.map

package/dist/tools/read.js.map

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

package/dist/tools/subagent.d.ts

@@ -0,0 +1,26 @@
+import { z } from "zod";
+import type { AgentTool } from "@mragentix/agent";
+import type { AgentDefinition } from "../core/agents.js";
+declare const SubAgentParams: z.ZodObject<{
+    task: z.ZodString;
+    agent: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export interface SubAgentUpdate {
+    toolUseCount: number;
+    tokenUsage: {
+        input: number;
+        output: number;
+    };
+    currentActivity?: string;
+}
+export interface SubAgentDetails {
+    toolUseCount: number;
+    tokenUsage: {
+        input: number;
+        output: number;
+    };
+    durationMs: number;
+}
+export declare function createSubAgentTool(cwd: string, agents: AgentDefinition[], parentProvider: string, parentModel: string): AgentTool<typeof SubAgentParams>;
+export {};
+//# sourceMappingURL=subagent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"subagent.d.ts","sourceRoot":"","sources":["../../src/tools/subagent.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAQzD,QAAA,MAAM,cAAc;;;iBAMlB,CAAC;AAEH,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9C,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9C,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,eAAe,EAAE,EACzB,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,MAAM,GAClB,SAAS,CAAC,OAAO,cAAc,CAAC,CAwKlC"}

package/dist/tools/subagent.js

@@ -0,0 +1,210 @@
+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 ~/.mragentix/agents/ or .mragentix/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 useProvider = parentProvider;
+            // Build CLI args — limit turns to prevent runaway context growth
+            const cliArgs = [
+                "--json",
+                "--provider",
+                useProvider,
+                "--model",
+                parentModel,
+                "--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 = formatToolActivity(event.name, event.args);
+                                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}`,
+                    });
+                });
+            });
+        },
+    };
+}
+/** Build a short, human-readable activity string for a sub-agent tool call. */
+function formatToolActivity(name, args) {
+    // Extract the most meaningful short value for common tools
+    switch (name) {
+        case "read":
+            return `Reading ${shortenPath(String(args.file_path ?? ""))}`;
+        case "write":
+            return `Writing ${shortenPath(String(args.file_path ?? ""))}`;
+        case "edit":
+            return `Editing ${shortenPath(String(args.file_path ?? ""))}`;
+        case "grep": {
+            const pat = String(args.pattern ?? "");
+            return `Searching for "${truncateStr(pat, 30)}"`;
+        }
+        case "find": {
+            const pat = String(args.pattern ?? "");
+            return `Finding "${truncateStr(pat, 30)}"`;
+        }
+        case "ls":
+            return `Listing ${shortenPath(String(args.path ?? "."))}`;
+        case "bash": {
+            const cmd = String(args.command ?? "").split("\n")[0];
+            return `Running ${truncateStr(cmd, 35)}`;
+        }
+        case "web_fetch":
+            return `Fetching ${truncateStr(String(args.url ?? ""), 35)}`;
+        default: {
+            // MCP or unknown tools — show name + first short arg value
+            const firstVal = Object.values(args).find((v) => typeof v === "string" && v.length > 0);
+            const detail = firstVal ? truncateStr(String(firstVal), 30) : "";
+            return detail ? `${name}: ${detail}` : name;
+        }
+    }
+}
+function shortenPath(filePath) {
+    const parts = filePath.split("/");
+    if (parts.length <= 3)
+        return filePath;
+    return "…/" + parts.slice(-2).join("/");
+}
+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 "@mragentix/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,kBAAkB,CAAC;AAClD,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 "@mragentix/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,kBAAkB,CAAC;AAClD,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 "@mragentix/agent";
+declare const TasksParams: z.ZodObject<{
+    action: z.ZodEnum<{
+        list: "list";
+        done: "done";
+        add: "add";
+        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,kBAAkB,CAAC;AAiDlD,QAAA,MAAM,WAAW;;;;;;;;;;iBAgBf,CAAC;AAEH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,WAAW,CAAC,CAgF1E"}