funolio-agent 0.1.0

package/dist/tools/installer.js

@@ -0,0 +1,227 @@
+"use strict";
+/**
+ * Tool installer — pulls user's tool selections from the server
+ * and auto-installs matching CLI tools / packages.
+ */
+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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TOOL_REGISTRY = void 0;
+exports.fetchToolSelections = fetchToolSelections;
+exports.installTools = installTools;
+exports.generateMcpConfig = generateMcpConfig;
+const child_process_1 = require("child_process");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const chalk_1 = __importDefault(require("chalk"));
+const config_1 = require("../config");
+exports.TOOL_REGISTRY = [
+    {
+        intent: 'web_browsing',
+        displayName: 'Web Browsing',
+        heavy: true,
+        tools: [
+            {
+                name: 'playwright',
+                checkCmd: 'npx playwright --version',
+                installCmd: 'npm install -g playwright && npx playwright install chromium',
+                mcpConfig: {
+                    command: 'npx',
+                    args: ['@playwright/mcp@latest'],
+                },
+            },
+        ],
+    },
+    {
+        intent: 'github',
+        displayName: 'GitHub',
+        tools: [
+            {
+                name: 'gh',
+                checkCmd: 'gh --version',
+                installCmd: process.platform === 'linux'
+                    ? 'type -p curl >/dev/null && (curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg | sudo dd of=/usr/share/keyrings/githubcli-archive-keyring.gpg && sudo chmod go+r /usr/share/keyrings/githubcli-archive-keyring.gpg && echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" | sudo tee /etc/apt/sources.list.d/github-cli.list > /dev/null && sudo apt update && sudo apt install gh -y) || echo "Please install gh CLI manually: https://cli.github.com"'
+                    : process.platform === 'darwin'
+                        ? 'brew install gh'
+                        : 'echo "Please install gh CLI manually: https://cli.github.com"',
+                mcpConfig: {
+                    command: 'gh',
+                    args: ['copilot', 'mcp'],
+                },
+            },
+        ],
+    },
+    {
+        intent: 'data_processing',
+        displayName: 'Data Processing',
+        tools: [
+            {
+                name: 'jq',
+                checkCmd: 'jq --version',
+                installCmd: process.platform === 'linux'
+                    ? 'sudo apt-get install -y jq'
+                    : process.platform === 'darwin'
+                        ? 'brew install jq'
+                        : 'echo "Please install jq manually: https://jqlang.github.io/jq/"',
+            },
+            {
+                name: 'python3',
+                checkCmd: 'python3 --version',
+                installCmd: 'echo "Python3 not found. Please install from https://python.org"',
+            },
+        ],
+    },
+    {
+        intent: 'file_management',
+        displayName: 'File Management',
+        tools: [
+            {
+                name: 'ripgrep',
+                checkCmd: 'rg --version',
+                installCmd: process.platform === 'linux'
+                    ? 'sudo apt-get install -y ripgrep'
+                    : process.platform === 'darwin'
+                        ? 'brew install ripgrep'
+                        : 'echo "Please install ripgrep manually"',
+            },
+        ],
+    },
+    {
+        intent: 'docker',
+        displayName: 'Docker / Containers',
+        heavy: true,
+        tools: [
+            {
+                name: 'docker',
+                checkCmd: 'docker --version',
+                installCmd: 'echo "Docker not found. Please install from https://docs.docker.com/get-docker/"',
+            },
+        ],
+    },
+];
+function isInstalled(checkCmd) {
+    try {
+        (0, child_process_1.execSync)(checkCmd, { stdio: 'pipe', timeout: 10_000 });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Fetch user's tool selections from the server.
+ */
+async function fetchToolSelections(token) {
+    try {
+        const res = await fetch(`${config_1.FUNOLIO_API_URL}/api/v1/agent/tools/selections`, {
+            headers: { Authorization: `Bearer ${token}` },
+        });
+        if (!res.ok) {
+            // Server might not have this endpoint yet — return empty
+            return [];
+        }
+        const data = await res.json();
+        return data.intents || [];
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Install tools for the given intents. Returns results per tool.
+ */
+function installTools(intents, lite) {
+    const results = [];
+    for (const intent of intents) {
+        const mapping = exports.TOOL_REGISTRY.find((t) => t.intent === intent);
+        if (!mapping)
+            continue;
+        if (lite && mapping.heavy) {
+            for (const tool of mapping.tools) {
+                results.push({ tool: tool.name, status: 'skipped_lite' });
+            }
+            console.log(chalk_1.default.gray(`  ⊘ ${mapping.displayName} — skipped (lite mode)`));
+            continue;
+        }
+        for (const tool of mapping.tools) {
+            if (isInstalled(tool.checkCmd)) {
+                results.push({ tool: tool.name, status: 'already_installed' });
+                console.log(chalk_1.default.gray(`  ✓ ${tool.name} — already installed`));
+                continue;
+            }
+            console.log(chalk_1.default.blue(`  ↓ Installing ${tool.name}...`));
+            try {
+                (0, child_process_1.execSync)(tool.installCmd, { stdio: 'pipe', timeout: 300_000 });
+                results.push({ tool: tool.name, status: 'installed' });
+                console.log(chalk_1.default.green(`  ✓ ${tool.name} — installed`));
+            }
+            catch (err) {
+                results.push({ tool: tool.name, status: 'failed', error: err.message });
+                console.log(chalk_1.default.yellow(`  ⚠ ${tool.name} — failed to install (non-critical)`));
+            }
+        }
+    }
+    return results;
+}
+/**
+ * Generate ~/.funolio/mcp.json based on installed tools.
+ */
+function generateMcpConfig(intents, lite) {
+    const mcpServers = {};
+    for (const intent of intents) {
+        const mapping = exports.TOOL_REGISTRY.find((t) => t.intent === intent);
+        if (!mapping)
+            continue;
+        if (lite && mapping.heavy)
+            continue;
+        for (const tool of mapping.tools) {
+            if (tool.mcpConfig && isInstalled(tool.checkCmd)) {
+                mcpServers[tool.name] = tool.mcpConfig;
+            }
+        }
+    }
+    const configDir = path.join(os.homedir(), '.funolio');
+    if (!fs.existsSync(configDir)) {
+        fs.mkdirSync(configDir, { recursive: true, mode: 0o700 });
+    }
+    const mcpPath = path.join(configDir, 'mcp.json');
+    const mcpConfig = { mcpServers };
+    fs.writeFileSync(mcpPath, JSON.stringify(mcpConfig, null, 2), { mode: 0o600 });
+    console.log(chalk_1.default.gray(`  MCP config written to ${mcpPath}`));
+}
+//# sourceMappingURL=installer.js.map

package/dist/tools/installer.js.map

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

package/dist/tools/list-directory.d.ts

@@ -0,0 +1,3 @@
+import { ToolDefinition } from '../types';
+export declare const listDirectoryTool: ToolDefinition;
+//# sourceMappingURL=list-directory.d.ts.map

package/dist/tools/list-directory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-directory.d.ts","sourceRoot":"","sources":["../../src/tools/list-directory.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAA2B,MAAM,UAAU,CAAC;AAGnE,eAAO,MAAM,iBAAiB,EAAE,cAyC/B,CAAC"}

package/dist/tools/list-directory.js

@@ -0,0 +1,107 @@
+"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.listDirectoryTool = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const sandbox_1 = require("./sandbox");
+exports.listDirectoryTool = {
+    name: 'list_directory',
+    description: 'List files and directories at a given path within the project.',
+    parameters: {
+        type: 'object',
+        properties: {
+            path: { type: 'string', description: 'Directory path relative to project root (default: ".")' },
+            recursive: { type: 'boolean', description: 'List recursively (default: false, max depth 3)' },
+        },
+        required: [],
+    },
+    async execute(args, ctx) {
+        const dirPath = args.path || '.';
+        const recursive = args.recursive || false;
+        try {
+            const resolved = (0, sandbox_1.resolveSandboxed)(ctx.projectDir, dirPath);
+            const entries = await listDir(resolved, ctx.projectDir, recursive ? 3 : 1, 0);
+            return {
+                tool_call_id: '',
+                name: 'list_directory',
+                success: true,
+                output: entries.join('\n'),
+                verified: true,
+                verification_details: `Listed ${entries.length} entries in ${dirPath}`,
+            };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return {
+                tool_call_id: '',
+                name: 'list_directory',
+                success: false,
+                output: '',
+                error: msg,
+                verified: true,
+                verification_details: `List failed: ${msg}`,
+            };
+        }
+    },
+};
+async function listDir(dir, projectDir, maxDepth, currentDepth) {
+    if (currentDepth >= maxDepth)
+        return [];
+    const entries = await fs.promises.readdir(dir, { withFileTypes: true });
+    const results = [];
+    const indent = '  '.repeat(currentDepth);
+    for (const entry of entries) {
+        // Skip common noise
+        if (entry.name === 'node_modules' || entry.name === '.git') {
+            results.push(`${indent}${entry.name}/ (skipped)`);
+            continue;
+        }
+        const fullPath = path.join(dir, entry.name);
+        const relPath = path.relative(projectDir, fullPath);
+        if (entry.isDirectory()) {
+            results.push(`${indent}${relPath}/`);
+            if (currentDepth < maxDepth - 1) {
+                const children = await listDir(fullPath, projectDir, maxDepth, currentDepth + 1);
+                results.push(...children);
+            }
+        }
+        else {
+            results.push(`${indent}${relPath}`);
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=list-directory.js.map

package/dist/tools/list-directory.js.map

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

package/dist/tools/read-file.d.ts

@@ -0,0 +1,3 @@
+import { ToolDefinition } from '../types';
+export declare const readFileTool: ToolDefinition;
+//# sourceMappingURL=read-file.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"read-file.d.ts","sourceRoot":"","sources":["../../src/tools/read-file.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAA2B,MAAM,UAAU,CAAC;AAGnE,eAAO,MAAM,YAAY,EAAE,cAqD1B,CAAC"}

package/dist/tools/read-file.js

@@ -0,0 +1,89 @@
+"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.readFileTool = void 0;
+const fs = __importStar(require("fs"));
+const sandbox_1 = require("./sandbox");
+exports.readFileTool = {
+    name: 'read_file',
+    description: 'Read the contents of a file within the project directory.',
+    parameters: {
+        type: 'object',
+        properties: {
+            path: { type: 'string', description: 'File path relative to project root' },
+            offset: { type: 'number', description: 'Line number to start reading from (1-indexed)' },
+            limit: { type: 'number', description: 'Maximum number of lines to read' },
+        },
+        required: ['path'],
+    },
+    async execute(args, ctx) {
+        const filePath = args.path;
+        const offset = args.offset || 1;
+        const limit = args.limit;
+        try {
+            const resolved = (0, sandbox_1.resolveSandboxed)(ctx.projectDir, filePath);
+            await (0, sandbox_1.checkFileSize)(resolved, ctx.maxFileSize);
+            const content = await fs.promises.readFile(resolved, 'utf-8');
+            const lines = content.split('\n');
+            const startIdx = Math.max(0, offset - 1);
+            const endIdx = limit ? startIdx + limit : lines.length;
+            const selected = lines.slice(startIdx, endIdx);
+            const output = selected.join('\n');
+            const totalLines = lines.length;
+            const info = `Lines ${startIdx + 1}-${Math.min(endIdx, totalLines)} of ${totalLines}`;
+            return {
+                tool_call_id: '',
+                name: 'read_file',
+                success: true,
+                output: `${info}\n${output}`,
+                verified: true,
+                verification_details: `File read successfully: ${filePath} (${totalLines} lines)`,
+            };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return {
+                tool_call_id: '',
+                name: 'read_file',
+                success: false,
+                output: '',
+                error: msg,
+                verified: true,
+                verification_details: `Read failed: ${msg}`,
+            };
+        }
+    },
+};
+//# sourceMappingURL=read-file.js.map

package/dist/tools/read-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-file.js","sourceRoot":"","sources":["../../src/tools/read-file.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,uCAAyB;AAEzB,uCAA4D;AAE/C,QAAA,YAAY,GAAmB;IAC1C,IAAI,EAAE,WAAW;IACjB,WAAW,EAAE,2DAA2D;IACxE,UAAU,EAAE;QACV,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oCAAoC,EAAE;YAC3E,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,+CAA+C,EAAE;YACxF,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,iCAAiC,EAAE;SAC1E;QACD,QAAQ,EAAE,CAAC,MAAM,CAAC;KACnB;IACD,KAAK,CAAC,OAAO,CAAC,IAA6B,EAAE,GAAgB;QAC3D,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAc,CAAC;QACrC,MAAM,MAAM,GAAI,IAAI,CAAC,MAAiB,IAAI,CAAC,CAAC;QAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,KAA2B,CAAC;QAE/C,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,IAAA,0BAAgB,EAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;YAC5D,MAAM,IAAA,uBAAa,EAAC,QAAQ,EAAE,GAAG,CAAC,WAAW,CAAC,CAAC;YAE/C,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAC9D,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAElC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,CAAC;YACzC,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC;YACvD,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YAE/C,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACnC,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC;YAChC,MAAM,IAAI,GAAG,SAAS,QAAQ,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,UAAU,EAAE,CAAC;YAEtF,OAAO;gBACL,YAAY,EAAE,EAAE;gBAChB,IAAI,EAAE,WAAW;gBACjB,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,GAAG,IAAI,KAAK,MAAM,EAAE;gBAC5B,QAAQ,EAAE,IAAI;gBACd,oBAAoB,EAAE,2BAA2B,QAAQ,KAAK,UAAU,SAAS;aAClF,CAAC;QACJ,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,OAAO;gBACL,YAAY,EAAE,EAAE;gBAChB,IAAI,EAAE,WAAW;gBACjB,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,EAAE;gBACV,KAAK,EAAE,GAAG;gBACV,QAAQ,EAAE,IAAI;gBACd,oBAAoB,EAAE,gBAAgB,GAAG,EAAE;aAC5C,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/run-command.d.ts

@@ -0,0 +1,3 @@
+import { ToolDefinition } from '../types';
+export declare const runCommandTool: ToolDefinition;
+//# sourceMappingURL=run-command.d.ts.map

package/dist/tools/run-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-command.d.ts","sourceRoot":"","sources":["../../src/tools/run-command.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAA2B,MAAM,UAAU,CAAC;AAGnE,eAAO,MAAM,cAAc,EAAE,cA0F5B,CAAC"}

package/dist/tools/run-command.js

@@ -0,0 +1,86 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runCommandTool = void 0;
+const child_process_1 = require("child_process");
+const sandbox_1 = require("./sandbox");
+exports.runCommandTool = {
+    name: 'run_command',
+    description: 'Execute a shell command within the project directory. Timeout enforced.',
+    parameters: {
+        type: 'object',
+        properties: {
+            command: { type: 'string', description: 'Shell command to execute' },
+            timeout: { type: 'number', description: 'Timeout in seconds (default: 60, max: 300)' },
+            cwd: { type: 'string', description: 'Working directory relative to project root (default: project root)' },
+        },
+        required: ['command'],
+    },
+    async execute(args, ctx) {
+        const command = args.command;
+        const requestedTimeout = args.timeout;
+        const cwd = args.cwd;
+        const timeout = Math.min(requestedTimeout || ctx.commandTimeout, ctx.maxCommandTimeout);
+        try {
+            const workDir = cwd ? (0, sandbox_1.resolveSandboxed)(ctx.projectDir, cwd) : ctx.projectDir;
+            const startTime = Date.now();
+            const result = await new Promise((resolve) => {
+                const proc = (0, child_process_1.execFile)('/bin/bash', ['-c', command], {
+                    cwd: workDir,
+                    timeout: timeout * 1000,
+                    maxBuffer: 1024 * 1024, // 1MB
+                    env: {
+                        ...process.env,
+                        // Prevent interactive prompts
+                        GIT_TERMINAL_PROMPT: '0',
+                        DEBIAN_FRONTEND: 'noninteractive',
+                    },
+                }, (error, stdout, stderr) => {
+                    const exitCode = error && 'code' in error ? error.code ?? 1 : 0;
+                    resolve({
+                        stdout: stdout || '',
+                        stderr: stderr || '',
+                        exitCode: error?.killed ? 124 : exitCode, // 124 = timeout (like GNU timeout)
+                    });
+                });
+                // Safety: ensure process is killed on timeout
+                proc.on('error', () => { });
+            });
+            const durationMs = Date.now() - startTime;
+            const wasTimeout = result.exitCode === 124;
+            let output = '';
+            if (result.stdout)
+                output += result.stdout;
+            if (result.stderr)
+                output += (output ? '\n--- stderr ---\n' : '') + result.stderr;
+            if (wasTimeout)
+                output += `\n[TIMEOUT: command killed after ${timeout}s]`;
+            output += `\n[exit code: ${result.exitCode}, duration: ${durationMs}ms]`;
+            return {
+                tool_call_id: '',
+                name: 'run_command',
+                success: result.exitCode === 0,
+                output: output.trim(),
+                exit_code: result.exitCode,
+                stderr: result.stderr,
+                error: result.exitCode !== 0 ? `Command exited with code ${result.exitCode}` : undefined,
+                verified: true,
+                verification_details: wasTimeout
+                    ? `Command timed out after ${timeout}s`
+                    : `Command completed with exit code ${result.exitCode} in ${durationMs}ms`,
+            };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return {
+                tool_call_id: '',
+                name: 'run_command',
+                success: false,
+                output: '',
+                error: msg,
+                verified: true,
+                verification_details: `Command execution failed: ${msg}`,
+            };
+        }
+    },
+};
+//# sourceMappingURL=run-command.js.map

package/dist/tools/run-command.js.map

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

package/dist/tools/sandbox.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Sandbox utilities: path validation, ensuring operations stay within project directory.
+ */
+/**
+ * Resolve a path relative to the project directory and ensure it doesn't escape.
+ * Throws if the resolved path is outside the sandbox.
+ */
+export declare function resolveSandboxed(projectDir: string, filePath: string): string;
+/**
+ * Check if a file exists within the sandbox.
+ */
+export declare function existsInSandbox(projectDir: string, filePath: string): Promise<boolean>;
+/**
+ * Validate file size is within limits.
+ */
+export declare function checkFileSize(absolutePath: string, maxSize: number): Promise<void>;
+//# sourceMappingURL=sandbox.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox.d.ts","sourceRoot":"","sources":["../../src/tools/sandbox.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAW7E;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQ5F;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAOxF"}