@cdoing/core 0.1.0

package/dist/tools/shell-exec.js

@@ -0,0 +1,261 @@
+"use strict";
+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.ShellExecTool = void 0;
+const child_process_1 = require("child_process");
+const os = __importStar(require("os"));
+const shell_paths_1 = require("../utils/shell-paths");
+const IS_WINDOWS = os.platform() === "win32";
+/**
+ * Get the shell command and args for the current platform.
+ * - Windows: PowerShell (more capable than cmd.exe)
+ * - macOS: user's shell with login flag (loads .zshrc/.bashrc for PATH, nvm, pyenv, etc.)
+ * - Linux: user's shell with login flag
+ */
+function getShellCommand(command) {
+    if (IS_WINDOWS) {
+        return {
+            shell: "powershell.exe",
+            args: ["-NoLogo", "-ExecutionPolicy", "Bypass", "-Command", command],
+        };
+    }
+    const userShell = process.env.SHELL || (os.platform() === "darwin" ? "/bin/zsh" : "/bin/bash");
+    return { shell: userShell, args: ["-l", "-c", command] };
+}
+/** For exec() — the shell to use */
+const SHELL = IS_WINDOWS ? "powershell.exe" : process.env.SHELL || "/bin/sh";
+/** Color-supporting environment variables */
+const COLOR_ENV = {
+    FORCE_COLOR: "1",
+    COLORTERM: "truecolor",
+    TERM: "xterm-256color",
+    CLICOLOR: "1",
+    CLICOLOR_FORCE: "1",
+};
+/** Absolute danger — always blocked regardless of permissions */
+const ALWAYS_BLOCKED = [
+    // Unix — catastrophic filesystem destruction
+    "rm -rf /",
+    "rm -rf ~",
+    "rm -rf /*",
+    "rm -rf ~/*",
+    "rm -rf $HOME",
+    "mkfs",
+    "dd if=",
+    ":(){", // fork bomb
+    // Windows — catastrophic filesystem destruction
+    "rd /s /q C:\\",
+    "del /f /s /q C:\\",
+    "format C:",
+    "rd /s /q %systemroot%",
+];
+/** Destructive patterns for elevated permission message */
+const DESTRUCTIVE_PATTERNS = [
+    // File deletion (Unix)
+    /\brm\s/, /\brm$/, /\brmdir\s/, /\bunlink\s/, /\bshred\s/,
+    // File deletion (Windows)
+    /\bdel\s/, /\brd\s/, /\berase\s/,
+    // Git destructive operations
+    /\bgit\s+clean\b/,
+    /\bgit\s+reset\s+--hard\b/,
+    /\bgit\s+push\s+.*--force\b/, /\bgit\s+push\s+-f\b/,
+    /\bgit\s+checkout\s+--\s/, /\bgit\s+restore\s/,
+    /\bgit\s+branch\s+-[dD]\b/,
+    /\bgit\s+rebase\b/,
+    /\bgit\s+stash\s+drop\b/,
+    // Process killing
+    /\bkill\s+-9\b/, /\bkillall\b/, /\bpkill\b/,
+    // Permission changes
+    /\bchmod\s+777\b/, /\bchmod\s+-R\b/, /\bchown\s+-R\b/,
+    // Database destructive (SQL injection risk via shell)
+    /\bDROP\s+(TABLE|DATABASE)\b/i, /\bTRUNCATE\s+TABLE\b/i, /\bDELETE\s+FROM\b/i,
+    // Disk/system
+    /\bdd\s/, /\bmv\s+\//, /\bsudo\s/,
+    // Docker destructive
+    /\bdocker\s+(rm|rmi|system\s+prune)\b/,
+    // npm/package destructive
+    /\bnpm\s+unpublish\b/,
+];
+class ShellExecTool {
+    definition = {
+        name: "shell_exec",
+        description: `Execute a shell command and return its output. Use for builds, tests, git commands, etc. Requires user permission before execution.
+
+All file paths in commands are checked against permission rules:
+- Read paths (cat, less, grep, etc.) are checked against Read deny rules.
+- Write paths (cp, mv, redirect >, tee, etc.) are checked against Edit deny rules.
+- Delete paths (rm, rmdir, unlink, etc.) are checked against Delete deny rules.
+- Destructive commands are flagged as high-risk in the permission prompt.
+
+Commands are also subject to sandbox restrictions.`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                command: { type: "string", description: "The shell command to execute" },
+                timeout: { type: "number", description: "Timeout in ms. Default: 120000" },
+                background: {
+                    type: "boolean",
+                    description: "Run in background. Returns immediately with PID. Use for servers/watchers. Default: false.",
+                },
+                env_vars: {
+                    type: "object",
+                    description: "Environment variables to set (e.g., {\"PORT\": \"3001\", \"DEBUG\": \"app:*\"})",
+                    additionalProperties: { type: "string" },
+                },
+                debug: {
+                    type: "boolean",
+                    description: "Enable debug/verbose mode. Sets DEBUG=*, NODE_DEBUG=*, RUST_BACKTRACE=1, PYTHONTRACEBACK=1. Default: false",
+                },
+                dangerouslyDisableSandbox: {
+                    type: "boolean",
+                    description: "Set to true to run this command outside the sandbox. Requires permission approval.",
+                },
+            },
+            required: ["command"],
+        },
+        requiresPermission: true,
+        permissionMessage: (input) => {
+            const cmd = String(input.command || "");
+            if (DESTRUCTIVE_PATTERNS.some((p) => p.test(cmd))) {
+                return `⚠ DESTRUCTIVE command: ${cmd}`;
+            }
+            return `Run command: ${cmd}`;
+        },
+    };
+    workingDir;
+    sandboxManager;
+    permissionManager;
+    constructor(workingDir, sandboxManager, permissionManager) {
+        this.workingDir = workingDir;
+        this.sandboxManager = sandboxManager;
+        this.permissionManager = permissionManager;
+    }
+    async execute(input) {
+        const command = input.command;
+        const timeout = input.timeout || 120000;
+        const dangerouslyDisableSandbox = input.dangerouslyDisableSandbox || false;
+        // Always-blocked patterns (catastrophic destruction)
+        for (const pat of ALWAYS_BLOCKED) {
+            if (command.includes(pat))
+                return { success: false, output: "", error: `Blocked dangerous pattern: ${pat}` };
+        }
+        // ── Permission-based path checks ────────────────────────────────────────
+        if (this.permissionManager) {
+            const paths = (0, shell_paths_1.extractShellPaths)(command, this.workingDir);
+            // Check read paths against Read deny rules
+            for (const p of paths.read) {
+                const result = this.permissionManager.checkPathPermission(p, "Read");
+                if (result === "deny") {
+                    return { success: false, output: "", error: `Permission denied: read access to "${p}" is blocked by settings rules` };
+                }
+            }
+            // Check write paths against Edit deny rules
+            for (const p of paths.write) {
+                const result = this.permissionManager.checkPathPermission(p, "Edit");
+                if (result === "deny") {
+                    return { success: false, output: "", error: `Permission denied: write access to "${p}" is blocked by settings rules` };
+                }
+            }
+            // Check delete paths against Delete deny rules
+            for (const p of paths.delete) {
+                const result = this.permissionManager.checkPathPermission(p, "Delete");
+                if (result === "deny") {
+                    return { success: false, output: "", error: `Permission denied: delete access to "${p}" is blocked by settings rules` };
+                }
+            }
+        }
+        // ── Sandbox checks ──────────────────────────────────────────────────────
+        if (this.sandboxManager) {
+            const check = this.sandboxManager.checkShellCommand(command, dangerouslyDisableSandbox);
+            if (!check.allowed) {
+                return { success: false, output: "", error: check.reason || "Sandbox: command blocked" };
+            }
+        }
+        // Build environment
+        const env = this.sandboxManager ? this.sandboxManager.getShellEnv() : { ...process.env };
+        // Merge user-provided env vars
+        const envVars = input.env_vars;
+        if (envVars && typeof envVars === "object") {
+            for (const [key, val] of Object.entries(envVars)) {
+                env[key] = String(val);
+            }
+        }
+        // Debug mode
+        if (input.debug) {
+            env.DEBUG = env.DEBUG || "*";
+            env.NODE_DEBUG = env.NODE_DEBUG || "*";
+            env.RUST_BACKTRACE = env.RUST_BACKTRACE || "1";
+            env.PYTHONTRACEBACK = env.PYTHONTRACEBACK || "1";
+            env.PYTHONFAULTHANDLER = env.PYTHONFAULTHANDLER || "1";
+        }
+        const background = input.background || false;
+        // Merge color env for better terminal output
+        Object.assign(env, COLOR_ENV);
+        // Background mode: spawn detached, return immediately with PID
+        if (background) {
+            const { spawn } = require("child_process");
+            const { shell, args } = getShellCommand(command);
+            const child = spawn(shell, args, {
+                cwd: this.workingDir,
+                env,
+                detached: !IS_WINDOWS,
+                stdio: "ignore",
+            });
+            child.unref();
+            return { success: true, output: `Started in background (PID: ${child.pid})` };
+        }
+        return new Promise((resolve) => {
+            (0, child_process_1.exec)(command, { cwd: this.workingDir, timeout, maxBuffer: 10 * 1024 * 1024, env, shell: SHELL }, (error, stdout, stderr) => {
+                const outputParts = [];
+                if (stdout)
+                    outputParts.push(stdout.trimEnd());
+                if (stderr)
+                    outputParts.push(`STDERR:\n${stderr.trimEnd()}`);
+                const output = outputParts.join("\n\n") || "(no output)";
+                if (error?.killed) {
+                    return resolve({ success: false, output, error: `Timed out after ${timeout}ms` });
+                }
+                if (error) {
+                    resolve({ success: false, output, error: `Exit code: ${error.code}` });
+                }
+                else {
+                    resolve({ success: true, output });
+                }
+            });
+        });
+    }
+}
+exports.ShellExecTool = ShellExecTool;
+//# sourceMappingURL=shell-exec.js.map

package/dist/tools/shell-exec.js.map

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

package/dist/tools/sub-agent-manager.d.ts

@@ -0,0 +1,57 @@
+/**
+ * SubAgentManager — Tracks all spawned sub-agents.
+ *
+ * Provides lifecycle management: spawn with custom timeout,
+ * check status/output, and terminate running agents.
+ */
+export type SubAgentStatus = "running" | "completed" | "failed" | "terminated" | "timed_out";
+export interface SubAgentEntry {
+    id: string;
+    task: string;
+    status: SubAgentStatus;
+    output: string;
+    error?: string;
+    startedAt: number;
+    finishedAt?: number;
+    /** AbortController to cancel a running agent */
+    abort?: AbortController;
+}
+export declare class SubAgentManager {
+    private agents;
+    private idCounter;
+    /** Generate a unique agent ID */
+    private nextId;
+    /**
+     * Spawn a sub-agent. Runs in background — returns the ID immediately.
+     * The caller provides runnerFn which actually executes the agent.
+     */
+    spawn(task: string, runnerFn: (signal: AbortSignal) => Promise<string>, timeoutMs?: number): string;
+    /**
+     * Spawn and wait — runs synchronously (blocks until done or timeout).
+     * Used when the LLM does NOT request background mode.
+     */
+    spawnAndWait(task: string, runnerFn: (signal: AbortSignal) => Promise<string>, timeoutMs?: number): Promise<SubAgentEntry>;
+    /** Get a specific agent's info */
+    get(id: string): SubAgentEntry | undefined;
+    /** Get status of a specific agent */
+    getStatus(id: string): {
+        id: string;
+        status: SubAgentStatus;
+        task: string;
+        output: string;
+        error?: string;
+        durationMs?: number;
+    } | null;
+    /** List all agents with their statuses */
+    listAll(): Array<{
+        id: string;
+        task: string;
+        status: SubAgentStatus;
+        durationMs: number;
+    }>;
+    /** Terminate a running agent */
+    terminate(id: string): boolean;
+    /** Check if any agents are still running */
+    hasRunning(): boolean;
+}
+//# sourceMappingURL=sub-agent-manager.d.ts.map

package/dist/tools/sub-agent-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sub-agent-manager.d.ts","sourceRoot":"","sources":["../../src/tools/sub-agent-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,YAAY,GAAG,WAAW,CAAC;AAE7F,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,KAAK,CAAC,EAAE,eAAe,CAAC;CACzB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAyC;IACvD,OAAO,CAAC,SAAS,CAAK;IAEtB,iCAAiC;IACjC,OAAO,CAAC,MAAM;IAKd;;;OAGG;IACH,KAAK,CACH,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,MAAM,CAAC,EAClD,SAAS,CAAC,EAAE,MAAM,GACjB,MAAM;IA6DT;;;OAGG;IACG,YAAY,CAChB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,MAAM,CAAC,EAClD,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,aAAa,CAAC;IAmBzB,kCAAkC;IAClC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAI1C,qCAAqC;IACrC,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,cAAc,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAkBvI,0CAA0C;IAC1C,OAAO,IAAI,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,cAAc,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAW1F,gCAAgC;IAChC,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAc9B,4CAA4C;IAC5C,UAAU,IAAI,OAAO;CAGtB"}

package/dist/tools/sub-agent-manager.js

@@ -0,0 +1,153 @@
+"use strict";
+/**
+ * SubAgentManager — Tracks all spawned sub-agents.
+ *
+ * Provides lifecycle management: spawn with custom timeout,
+ * check status/output, and terminate running agents.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SubAgentManager = void 0;
+class SubAgentManager {
+    agents = new Map();
+    idCounter = 0;
+    /** Generate a unique agent ID */
+    nextId() {
+        this.idCounter++;
+        return `agent_${this.idCounter}_${Date.now().toString(36)}`;
+    }
+    /**
+     * Spawn a sub-agent. Runs in background — returns the ID immediately.
+     * The caller provides runnerFn which actually executes the agent.
+     */
+    spawn(task, runnerFn, timeoutMs) {
+        const id = this.nextId();
+        const abort = new AbortController();
+        const entry = {
+            id,
+            task,
+            status: "running",
+            output: "",
+            startedAt: Date.now(),
+            abort,
+        };
+        this.agents.set(id, entry);
+        // Set up timeout if requested
+        let timeoutHandle;
+        if (timeoutMs && timeoutMs > 0) {
+            timeoutHandle = setTimeout(() => {
+                if (entry.status === "running") {
+                    entry.status = "timed_out";
+                    entry.error = `Timed out after ${timeoutMs}ms`;
+                    entry.finishedAt = Date.now();
+                    abort.abort();
+                }
+            }, timeoutMs);
+        }
+        // Run the agent in background
+        runnerFn(abort.signal)
+            .then((result) => {
+            if (entry.status === "running") {
+                entry.status = "completed";
+                entry.output = result;
+                entry.finishedAt = Date.now();
+            }
+        })
+            .catch((err) => {
+            if (entry.status === "running") {
+                const msg = err instanceof Error ? err.message : String(err);
+                if (msg === "__cancelled__" || abort.signal.aborted) {
+                    // Only set terminated if not already timed_out
+                    if (entry.status === "running") {
+                        entry.status = "terminated";
+                        entry.error = "Terminated by user";
+                        entry.finishedAt = Date.now();
+                    }
+                }
+                else {
+                    entry.status = "failed";
+                    entry.error = msg;
+                    entry.finishedAt = Date.now();
+                }
+            }
+        })
+            .finally(() => {
+            if (timeoutHandle)
+                clearTimeout(timeoutHandle);
+            delete entry.abort; // clean up reference
+        });
+        return id;
+    }
+    /**
+     * Spawn and wait — runs synchronously (blocks until done or timeout).
+     * Used when the LLM does NOT request background mode.
+     */
+    async spawnAndWait(task, runnerFn, timeoutMs) {
+        const id = this.spawn(task, runnerFn, timeoutMs);
+        const entry = this.agents.get(id);
+        // Poll until done (the promise is already running)
+        await new Promise((resolve) => {
+            const check = () => {
+                if (entry.status !== "running") {
+                    resolve();
+                }
+                else {
+                    setTimeout(check, 50);
+                }
+            };
+            check();
+        });
+        return entry;
+    }
+    /** Get a specific agent's info */
+    get(id) {
+        return this.agents.get(id);
+    }
+    /** Get status of a specific agent */
+    getStatus(id) {
+        const entry = this.agents.get(id);
+        if (!entry)
+            return null;
+        const durationMs = entry.finishedAt
+            ? entry.finishedAt - entry.startedAt
+            : Date.now() - entry.startedAt;
+        return {
+            id: entry.id,
+            status: entry.status,
+            task: entry.task,
+            output: entry.output,
+            error: entry.error,
+            durationMs,
+        };
+    }
+    /** List all agents with their statuses */
+    listAll() {
+        return Array.from(this.agents.values()).map((entry) => ({
+            id: entry.id,
+            task: entry.task,
+            status: entry.status,
+            durationMs: entry.finishedAt
+                ? entry.finishedAt - entry.startedAt
+                : Date.now() - entry.startedAt,
+        }));
+    }
+    /** Terminate a running agent */
+    terminate(id) {
+        const entry = this.agents.get(id);
+        if (!entry || entry.status !== "running")
+            return false;
+        entry.status = "terminated";
+        entry.error = "Terminated by user";
+        entry.finishedAt = Date.now();
+        if (entry.abort) {
+            entry.abort.abort();
+            delete entry.abort;
+        }
+        return true;
+    }
+    /** Check if any agents are still running */
+    hasRunning() {
+        return Array.from(this.agents.values()).some((e) => e.status === "running");
+    }
+}
+exports.SubAgentManager = SubAgentManager;
+//# sourceMappingURL=sub-agent-manager.js.map

package/dist/tools/sub-agent-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sub-agent-manager.js","sourceRoot":"","sources":["../../src/tools/sub-agent-manager.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAgBH,MAAa,eAAe;IAClB,MAAM,GAA+B,IAAI,GAAG,EAAE,CAAC;IAC/C,SAAS,GAAG,CAAC,CAAC;IAEtB,iCAAiC;IACzB,MAAM;QACZ,IAAI,CAAC,SAAS,EAAE,CAAC;QACjB,OAAO,SAAS,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;IAC9D,CAAC;IAED;;;OAGG;IACH,KAAK,CACH,IAAY,EACZ,QAAkD,EAClD,SAAkB;QAElB,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,IAAI,eAAe,EAAE,CAAC;QAEpC,MAAM,KAAK,GAAkB;YAC3B,EAAE;YACF,IAAI;YACJ,MAAM,EAAE,SAAS;YACjB,MAAM,EAAE,EAAE;YACV,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,KAAK;SACN,CAAC;QACF,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QAE3B,8BAA8B;QAC9B,IAAI,aAAwD,CAAC;QAC7D,IAAI,SAAS,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;YAC/B,aAAa,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC9B,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;oBAC/B,KAAK,CAAC,MAAM,GAAG,WAAW,CAAC;oBAC3B,KAAK,CAAC,KAAK,GAAG,mBAAmB,SAAS,IAAI,CAAC;oBAC/C,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;oBAC9B,KAAK,CAAC,KAAK,EAAE,CAAC;gBAChB,CAAC;YACH,CAAC,EAAE,SAAS,CAAC,CAAC;QAChB,CAAC;QAED,8BAA8B;QAC9B,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC;aACnB,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;YACf,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBAC/B,KAAK,CAAC,MAAM,GAAG,WAAW,CAAC;gBAC3B,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC;gBACtB,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAChC,CAAC;QACH,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;YACb,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBAC/B,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAC7D,IAAI,GAAG,KAAK,eAAe,IAAI,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;oBACpD,+CAA+C;oBAC/C,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;wBAC/B,KAAK,CAAC,MAAM,GAAG,YAAY,CAAC;wBAC5B,KAAK,CAAC,KAAK,GAAG,oBAAoB,CAAC;wBACnC,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;oBAChC,CAAC;gBACH,CAAC;qBAAM,CAAC;oBACN,KAAK,CAAC,MAAM,GAAG,QAAQ,CAAC;oBACxB,KAAK,CAAC,KAAK,GAAG,GAAG,CAAC;oBAClB,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;gBAChC,CAAC;YACH,CAAC;QACH,CAAC,CAAC;aACD,OAAO,CAAC,GAAG,EAAE;YACZ,IAAI,aAAa;gBAAE,YAAY,CAAC,aAAa,CAAC,CAAC;YAC/C,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,qBAAqB;QAC3C,CAAC,CAAC,CAAC;QAEL,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,YAAY,CAChB,IAAY,EACZ,QAAkD,EAClD,SAAkB;QAElB,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;QACjD,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAE,CAAC;QAEnC,mDAAmD;QACnD,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAClC,MAAM,KAAK,GAAG,GAAG,EAAE;gBACjB,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;oBAC/B,OAAO,EAAE,CAAC;gBACZ,CAAC;qBAAM,CAAC;oBACN,UAAU,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;gBACxB,CAAC;YACH,CAAC,CAAC;YACF,KAAK,EAAE,CAAC;QACV,CAAC,CAAC,CAAC;QAEH,OAAO,KAAK,CAAC;IACf,CAAC;IAED,kCAAkC;IAClC,GAAG,CAAC,EAAU;QACZ,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC7B,CAAC;IAED,qCAAqC;IACrC,SAAS,CAAC,EAAU;QAClB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAClC,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QAExB,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU;YACjC,CAAC,CAAC,KAAK,CAAC,UAAU,GAAG,KAAK,CAAC,SAAS;YACpC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,SAAS,CAAC;QAEjC,OAAO;YACL,EAAE,EAAE,KAAK,CAAC,EAAE;YACZ,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,UAAU;SACX,CAAC;IACJ,CAAC;IAED,0CAA0C;IAC1C,OAAO;QACL,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACtD,EAAE,EAAE,KAAK,CAAC,EAAE;YACZ,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC1B,CAAC,CAAC,KAAK,CAAC,UAAU,GAAG,KAAK,CAAC,SAAS;gBACpC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,SAAS;SACjC,CAAC,CAAC,CAAC;IACN,CAAC;IAED,gCAAgC;IAChC,SAAS,CAAC,EAAU;QAClB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAClC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;QAEvD,KAAK,CAAC,MAAM,GAAG,YAAY,CAAC;QAC5B,KAAK,CAAC,KAAK,GAAG,oBAAoB,CAAC;QACnC,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC9B,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YAChB,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YACpB,OAAO,KAAK,CAAC,KAAK,CAAC;QACrB,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,4CAA4C;IAC5C,UAAU;QACR,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC;IAC9E,CAAC;CACF;AAjKD,0CAiKC"}

package/dist/tools/sub-agent-status.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Sub-Agent Status Tool — check status and output of spawned sub-agents.
+ */
+import type { BaseTool, ToolDefinition, ToolResult } from "./types";
+import type { SubAgentManager } from "./sub-agent-manager";
+export declare class SubAgentStatusTool implements BaseTool {
+    definition: ToolDefinition;
+    private manager;
+    constructor(manager: SubAgentManager);
+    execute(input: Record<string, unknown>): Promise<ToolResult>;
+}
+//# sourceMappingURL=sub-agent-status.d.ts.map

package/dist/tools/sub-agent-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sub-agent-status.d.ts","sourceRoot":"","sources":["../../src/tools/sub-agent-status.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,qBAAa,kBAAmB,YAAW,QAAQ;IACjD,UAAU,EAAE,cAAc,CAgBxB;IAEF,OAAO,CAAC,OAAO,CAAkB;gBAErB,OAAO,EAAE,eAAe;IAI9B,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;CAkCnE"}

package/dist/tools/sub-agent-status.js

@@ -0,0 +1,59 @@
+"use strict";
+/**
+ * Sub-Agent Status Tool — check status and output of spawned sub-agents.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SubAgentStatusTool = void 0;
+class SubAgentStatusTool {
+    definition = {
+        name: "sub_agent_status",
+        description: "Check the status and output of a background sub-agent by its ID, or list all sub-agents. Use this to poll for completion of background sub-agents.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                agent_id: {
+                    type: "string",
+                    description: "The ID of the sub-agent to check. Omit to list all sub-agents.",
+                },
+            },
+            required: [],
+        },
+        requiresPermission: false,
+    };
+    manager;
+    constructor(manager) {
+        this.manager = manager;
+    }
+    async execute(input) {
+        const agentId = input.agent_id;
+        if (agentId) {
+            // Get specific agent status
+            const status = this.manager.getStatus(agentId);
+            if (!status) {
+                return {
+                    success: false,
+                    output: "",
+                    error: `No sub-agent found with ID "${agentId}". Use sub_agent_status without an agent_id to list all agents.`,
+                };
+            }
+            return {
+                success: true,
+                output: JSON.stringify(status, null, 2),
+            };
+        }
+        // List all agents
+        const all = this.manager.listAll();
+        if (all.length === 0) {
+            return {
+                success: true,
+                output: "No sub-agents have been spawned yet.",
+            };
+        }
+        return {
+            success: true,
+            output: JSON.stringify(all, null, 2),
+        };
+    }
+}
+exports.SubAgentStatusTool = SubAgentStatusTool;
+//# sourceMappingURL=sub-agent-status.js.map

package/dist/tools/sub-agent-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sub-agent-status.js","sourceRoot":"","sources":["../../src/tools/sub-agent-status.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAKH,MAAa,kBAAkB;IAC7B,UAAU,GAAmB;QAC3B,IAAI,EAAE,kBAAkB;QACxB,WAAW,EACT,oJAAoJ;QACtJ,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,gEAAgE;iBACnE;aACF;YACD,QAAQ,EAAE,EAAE;SACb;QACD,kBAAkB,EAAE,KAAK;KAC1B,CAAC;IAEM,OAAO,CAAkB;IAEjC,YAAY,OAAwB;QAClC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,KAA8B;QAC1C,MAAM,OAAO,GAAG,KAAK,CAAC,QAA8B,CAAC;QAErD,IAAI,OAAO,EAAE,CAAC;YACZ,4BAA4B;YAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;YAC/C,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,MAAM,EAAE,EAAE;oBACV,KAAK,EAAE,+BAA+B,OAAO,iEAAiE;iBAC/G,CAAC;YACJ,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;aACxC,CAAC;QACJ,CAAC;QAED,kBAAkB;QAClB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QACnC,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrB,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,sCAAsC;aAC/C,CAAC;QACJ,CAAC;QAED,OAAO;YACL,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;SACrC,CAAC;IACJ,CAAC;CACF;AA3DD,gDA2DC"}

package/dist/tools/sub-agent-terminate.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Sub-Agent Terminate Tool — stop a running sub-agent.
+ */
+import type { BaseTool, ToolDefinition, ToolResult } from "./types";
+import type { SubAgentManager } from "./sub-agent-manager";
+export declare class SubAgentTerminateTool implements BaseTool {
+    definition: ToolDefinition;
+    private manager;
+    constructor(manager: SubAgentManager);
+    execute(input: Record<string, unknown>): Promise<ToolResult>;
+}
+//# sourceMappingURL=sub-agent-terminate.d.ts.map

package/dist/tools/sub-agent-terminate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sub-agent-terminate.d.ts","sourceRoot":"","sources":["../../src/tools/sub-agent-terminate.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,qBAAa,qBAAsB,YAAW,QAAQ;IACpD,UAAU,EAAE,cAAc,CAexB;IAEF,OAAO,CAAC,OAAO,CAAkB;gBAErB,OAAO,EAAE,eAAe;IAI9B,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;CA8BnE"}

package/dist/tools/sub-agent-terminate.js

@@ -0,0 +1,55 @@
+"use strict";
+/**
+ * Sub-Agent Terminate Tool — stop a running sub-agent.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SubAgentTerminateTool = void 0;
+class SubAgentTerminateTool {
+    definition = {
+        name: "sub_agent_terminate",
+        description: "Terminate a running sub-agent by its ID. Use this to stop a long-running or stuck background sub-agent.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                agent_id: {
+                    type: "string",
+                    description: "The ID of the sub-agent to terminate",
+                },
+            },
+            required: ["agent_id"],
+        },
+        requiresPermission: false,
+    };
+    manager;
+    constructor(manager) {
+        this.manager = manager;
+    }
+    async execute(input) {
+        const agentId = input.agent_id;
+        if (!agentId) {
+            return { success: false, output: "", error: "agent_id is required" };
+        }
+        const terminated = this.manager.terminate(agentId);
+        if (!terminated) {
+            const status = this.manager.getStatus(agentId);
+            if (!status) {
+                return {
+                    success: false,
+                    output: "",
+                    error: `No sub-agent found with ID "${agentId}".`,
+                };
+            }
+            return {
+                success: false,
+                output: "",
+                error: `Sub-agent "${agentId}" is not running (status: ${status.status}). Only running agents can be terminated.`,
+            };
+        }
+        return {
+            success: true,
+            output: `Sub-agent "${agentId}" has been terminated.`,
+        };
+    }
+}
+exports.SubAgentTerminateTool = SubAgentTerminateTool;
+//# sourceMappingURL=sub-agent-terminate.js.map

package/dist/tools/sub-agent-terminate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sub-agent-terminate.js","sourceRoot":"","sources":["../../src/tools/sub-agent-terminate.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAKH,MAAa,qBAAqB;IAChC,UAAU,GAAmB;QAC3B,IAAI,EAAE,qBAAqB;QAC3B,WAAW,EACT,yGAAyG;QAC3G,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,sCAAsC;iBACpD;aACF;YACD,QAAQ,EAAE,CAAC,UAAU,CAAC;SACvB;QACD,kBAAkB,EAAE,KAAK;KAC1B,CAAC;IAEM,OAAO,CAAkB;IAEjC,YAAY,OAAwB;QAClC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,KAA8B;QAC1C,MAAM,OAAO,GAAG,KAAK,CAAC,QAAkB,CAAC;QAEzC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,sBAAsB,EAAE,CAAC;QACvE,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAEnD,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;YAC/C,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,MAAM,EAAE,EAAE;oBACV,KAAK,EAAE,+BAA+B,OAAO,IAAI;iBAClD,CAAC;YACJ,CAAC;YACD,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,EAAE;gBACV,KAAK,EAAE,cAAc,OAAO,6BAA6B,MAAM,CAAC,MAAM,2CAA2C;aAClH,CAAC;QACJ,CAAC;QAED,OAAO;YACL,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,cAAc,OAAO,wBAAwB;SACtD,CAAC;IACJ,CAAC;CACF;AAtDD,sDAsDC"}