helixmind 0.5.4

package/dist/cli/agent/tools/run-command.js

@@ -0,0 +1,112 @@
+import { spawn } from 'node:child_process';
+import { platform } from 'node:os';
+import { registerTool } from './registry.js';
+import { validatePath, isBlockedCommand } from '../sandbox.js';
+registerTool({
+    definition: {
+        name: 'run_command',
+        description: 'Execute a shell command. Uses cmd.exe on Windows, bash on Unix. Each call runs in the project root — cd does NOT persist. Prefer built-in tools (read_file, list_directory, search_files) over run_command when possible.',
+        input_schema: {
+            type: 'object',
+            properties: {
+                command: { type: 'string', description: 'The shell command to execute' },
+                working_dir: { type: 'string', description: 'Working directory (default: project root)' },
+                timeout: { type: 'number', description: 'Timeout in seconds (default: 60)' },
+            },
+            required: ['command'],
+        },
+    },
+    async execute(input, ctx) {
+        const command = input.command;
+        const timeoutSec = input.timeout ?? 60;
+        if (isBlockedCommand(command)) {
+            return 'Error: This command is blocked for safety reasons.';
+        }
+        const cwd = input.working_dir
+            ? validatePath(input.working_dir, ctx.projectRoot)
+            : ctx.projectRoot;
+        return new Promise((resolve) => {
+            let stdout = '';
+            let stderr = '';
+            const isWindows = platform() === 'win32';
+            const shell = isWindows ? 'cmd.exe' : '/bin/bash';
+            const shellArgs = isWindows ? ['/c', command] : ['-c', command];
+            // Filter sensitive environment variables — whitelist approach for maximum safety
+            const SAFE_ENV_KEYS = new Set([
+                'PATH', 'HOME', 'USERPROFILE', 'SHELL', 'TERM', 'LANG', 'LC_ALL',
+                'NODE_ENV', 'NODE_PATH', 'NPM_CONFIG_PREFIX',
+                'TMPDIR', 'TEMP', 'TMP', 'USER', 'USERNAME', 'LOGNAME',
+                'HOSTNAME', 'PWD', 'OLDPWD', 'SHLVL', 'EDITOR', 'VISUAL',
+                'COLORTERM', 'TERM_PROGRAM', 'COMSPEC', 'SystemRoot', 'SystemDrive',
+                'ProgramFiles', 'ProgramFiles(x86)', 'CommonProgramFiles',
+                'APPDATA', 'LOCALAPPDATA', 'WINDIR', 'OS',
+                'NVM_DIR', 'NVM_BIN', 'NVM_INC',
+                'GIT_EXEC_PATH', 'GIT_TEMPLATE_DIR',
+                'GOPATH', 'GOROOT', 'CARGO_HOME', 'RUSTUP_HOME',
+                'JAVA_HOME', 'PYTHON', 'PYTHONPATH',
+            ]);
+            const safeEnv = {};
+            for (const [key, val] of Object.entries(process.env)) {
+                if (val !== undefined && (SAFE_ENV_KEYS.has(key) || key.startsWith('npm_config_'))) {
+                    safeEnv[key] = val;
+                }
+            }
+            const proc = spawn(shell, shellArgs, {
+                cwd,
+                env: safeEnv,
+                stdio: ['ignore', 'pipe', 'pipe'],
+            });
+            const timer = setTimeout(() => {
+                proc.kill('SIGTERM');
+                // Fallback SIGKILL after 5s if SIGTERM is ignored (Unix only)
+                setTimeout(() => {
+                    try {
+                        proc.kill('SIGKILL');
+                    }
+                    catch { /* already dead */ }
+                }, 5000);
+                resolve(`Command timed out after ${timeoutSec}s.\n\nPartial stdout:\n${stdout}\n\nPartial stderr:\n${stderr}`);
+            }, timeoutSec * 1000);
+            // Cap buffer size to prevent OOM on commands with huge output
+            const MAX_BUFFER = 5 * 1024 * 1024; // 5MB
+            proc.stdout.on('data', (data) => {
+                const text = data.toString();
+                if (stdout.length < MAX_BUFFER) {
+                    stdout += text.slice(0, MAX_BUFFER - stdout.length);
+                }
+                // Stream to user's terminal
+                process.stdout.write(text);
+            });
+            proc.stderr.on('data', (data) => {
+                const text = data.toString();
+                if (stderr.length < MAX_BUFFER) {
+                    stderr += text.slice(0, MAX_BUFFER - stderr.length);
+                }
+                process.stderr.write(text);
+            });
+            proc.on('close', (code) => {
+                clearTimeout(timer);
+                const exitCode = code ?? 1;
+                // Truncate very long output
+                const maxLen = 10000;
+                const outTruncated = stdout.length > maxLen
+                    ? stdout.slice(0, maxLen) + `\n... (${stdout.length - maxLen} chars truncated)`
+                    : stdout;
+                const errTruncated = stderr.length > maxLen
+                    ? stderr.slice(0, maxLen) + `\n... (${stderr.length - maxLen} chars truncated)`
+                    : stderr;
+                let result = `Exit code: ${exitCode}\n`;
+                if (outTruncated)
+                    result += `\nstdout:\n${outTruncated}`;
+                if (errTruncated)
+                    result += `\nstderr:\n${errTruncated}`;
+                resolve(result);
+            });
+            proc.on('error', (err) => {
+                clearTimeout(timer);
+                resolve(`Error executing command: ${err.message}`);
+            });
+        });
+    },
+});
+//# sourceMappingURL=run-command.js.map

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

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

package/dist/cli/agent/tools/search.d.ts

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

package/dist/cli/agent/tools/search.d.ts.map

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

package/dist/cli/agent/tools/search.js

@@ -0,0 +1,104 @@
+import { readdirSync, readFileSync, statSync } from 'node:fs';
+import { join, relative, extname } from 'node:path';
+import { registerTool } from './registry.js';
+import { validatePathEx } from '../sandbox.js';
+const IGNORE_DIRS = new Set(['node_modules', '.git', 'dist', '.next', '__pycache__', '.venv', 'target', 'coverage']);
+const TEXT_EXTENSIONS = new Set([
+    '.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs',
+    '.py', '.rb', '.go', '.rs', '.java', '.c', '.cpp', '.h',
+    '.json', '.yaml', '.yml', '.toml', '.md', '.txt',
+    '.html', '.css', '.scss', '.vue', '.svelte',
+    '.sql', '.sh', '.bash', '.zsh', '.ps1',
+    '.env.example', '.gitignore', '.dockerignore',
+    '.xml', '.svg',
+]);
+registerTool({
+    definition: {
+        name: 'search_files',
+        description: 'Search for a text pattern across files using regex. Like grep/ripgrep. Returns matching lines with file, line number, and context.',
+        input_schema: {
+            type: 'object',
+            properties: {
+                pattern: { type: 'string', description: 'Regex pattern to search for' },
+                path: { type: 'string', description: 'Directory to search in (default: project root)' },
+                include: { type: 'string', description: 'File extension filter, e.g. "*.ts" or "*.py"' },
+                max_results: { type: 'number', description: 'Maximum results to return (default: 20)' },
+            },
+            required: ['pattern'],
+        },
+    },
+    async execute(input, ctx) {
+        const { resolved: searchDir } = validatePathEx(input.path || '.', ctx.projectRoot);
+        const maxResults = input.max_results ?? 20;
+        const includePattern = input.include;
+        let regex;
+        try {
+            regex = new RegExp(input.pattern, 'gi');
+        }
+        catch (e) {
+            return `Error: Invalid regex pattern: ${e}`;
+        }
+        const includeExt = includePattern ? includePattern.replace('*', '') : null;
+        const results = [];
+        function searchDir2(dir) {
+            if (results.length >= maxResults)
+                return;
+            let items;
+            try {
+                items = readdirSync(dir);
+            }
+            catch {
+                return;
+            }
+            for (const item of items) {
+                if (results.length >= maxResults)
+                    return;
+                if (IGNORE_DIRS.has(item))
+                    continue;
+                const fullPath = join(dir, item);
+                let stat;
+                try {
+                    stat = statSync(fullPath);
+                }
+                catch {
+                    continue;
+                }
+                if (stat.isDirectory()) {
+                    searchDir2(fullPath);
+                }
+                else if (stat.isFile()) {
+                    const ext = extname(item);
+                    if (includeExt && ext !== includeExt)
+                        continue;
+                    if (!includeExt && !TEXT_EXTENSIONS.has(ext))
+                        continue;
+                    if (stat.size > 512 * 1024)
+                        continue; // Skip large files
+                    try {
+                        const content = readFileSync(fullPath, 'utf-8');
+                        const lines = content.split('\n');
+                        for (let i = 0; i < lines.length; i++) {
+                            if (results.length >= maxResults)
+                                break;
+                            regex.lastIndex = 0;
+                            if (regex.test(lines[i])) {
+                                const relPath = relative(ctx.projectRoot, fullPath);
+                                const lineNum = i + 1;
+                                results.push(`${relPath}:${lineNum}  │ ${lines[i].trim()}`);
+                            }
+                        }
+                    }
+                    catch {
+                        // Skip binary or unreadable files
+                    }
+                }
+            }
+        }
+        searchDir2(searchDir);
+        if (results.length === 0) {
+            return `No matches found for pattern: ${input.pattern}`;
+        }
+        return `Found ${results.length} match(es) for "${input.pattern}":\n\n${results.join('\n')}`;
+    },
+});
+//# sourceMappingURL=search.js.map

package/dist/cli/agent/tools/search.js.map

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

package/dist/cli/agent/tools/spiral-query.d.ts

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

package/dist/cli/agent/tools/spiral-query.d.ts.map

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

package/dist/cli/agent/tools/spiral-query.js

@@ -0,0 +1,52 @@
+import { registerTool } from './registry.js';
+registerTool({
+    definition: {
+        name: 'spiral_query',
+        description: 'Query the spiral memory for relevant context about a topic. Returns knowledge from all 5 levels (Focus, Active, Reference, Archive, Deep Archive). Use this when you need background information about the project, past decisions, or related context.',
+        input_schema: {
+            type: 'object',
+            properties: {
+                query: { type: 'string', description: 'What to search for in the spiral memory' },
+                levels: {
+                    type: 'array',
+                    items: { type: 'number' },
+                    description: 'Which levels to query (default: all 5)',
+                },
+                max_results: { type: 'number', description: 'Maximum results per level (default: 10)' },
+            },
+            required: ['query'],
+        },
+    },
+    async execute(input, ctx) {
+        if (!ctx.spiralEngine) {
+            return 'Spiral engine is not available.';
+        }
+        try {
+            const query = input.query;
+            const levels = input.levels ?? [1, 2, 3, 4, 5];
+            const result = await ctx.spiralEngine.query(query, undefined, levels);
+            const parts = [];
+            const levelNames = ['', 'Focus', 'Active', 'Reference', 'Archive', 'Deep Archive'];
+            for (const level of [1, 2, 3, 4, 5]) {
+                const key = `level_${level}`;
+                const nodes = result[key];
+                if (nodes && nodes.length > 0) {
+                    parts.push(`\n=== L${level} ${levelNames[level]} (${nodes.length} nodes) ===`);
+                    for (const node of nodes) {
+                        const relevance = node.relevance.toFixed(2);
+                        const preview = node.content.slice(0, 120).replace(/\n/g, ' ');
+                        parts.push(`  [${node.type}] ${relevance}  ${preview}`);
+                    }
+                }
+            }
+            if (parts.length === 0) {
+                return `No spiral context found for: "${query}"`;
+            }
+            return `Spiral query results for "${query}":\n${parts.join('\n')}\n\nTotal: ${result.node_count} nodes, ${result.total_tokens} tokens`;
+        }
+        catch (err) {
+            return `Spiral query error: ${err}`;
+        }
+    },
+});
+//# sourceMappingURL=spiral-query.js.map

package/dist/cli/agent/tools/spiral-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spiral-query.js","sourceRoot":"","sources":["../../../../src/cli/agent/tools/spiral-query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,YAAY,CAAC;IACX,UAAU,EAAE;QACV,IAAI,EAAE,cAAc;QACpB,WAAW,EAAE,yPAAyP;QACtQ,YAAY,EAAE;YACZ,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yCAAyC,EAAE;gBACjF,MAAM,EAAE;oBACN,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACzB,WAAW,EAAE,wCAAwC;iBACtD;gBACD,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yCAAyC,EAAE;aACxF;YACD,QAAQ,EAAE,CAAC,OAAO,CAAC;SACpB;KACF;IAED,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG;QACtB,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC;YACtB,OAAO,iCAAiC,CAAC;QAC3C,CAAC;QAED,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,KAAK,CAAC,KAAe,CAAC;YACpC,MAAM,MAAM,GAAI,KAAK,CAAC,MAAmB,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;YAE7D,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,YAAY,CAAC,KAAK,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;YACtE,MAAM,KAAK,GAAa,EAAE,CAAC;YAE3B,MAAM,UAAU,GAAG,CAAC,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,cAAc,CAAC,CAAC;YAEnF,KAAK,MAAM,KAAK,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAU,EAAE,CAAC;gBAC7C,MAAM,GAAG,GAAG,SAAS,KAAK,EAAyB,CAAC;gBACpD,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;gBAC1B,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC9B,KAAK,CAAC,IAAI,CAAC,UAAU,KAAK,IAAI,UAAU,CAAC,KAAK,CAAC,KAAK,KAAK,CAAC,MAAM,aAAa,CAAC,CAAC;oBAC/E,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;wBACzB,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;wBAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;wBAC/D,KAAK,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,KAAK,SAAS,KAAK,OAAO,EAAE,CAAC,CAAC;oBAC1D,CAAC;gBACH,CAAC;YACH,CAAC;YAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACvB,OAAO,iCAAiC,KAAK,GAAG,CAAC;YACnD,CAAC;YAED,OAAO,6BAA6B,KAAK,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,MAAM,CAAC,UAAU,WAAW,MAAM,CAAC,YAAY,SAAS,CAAC;QACzI,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,uBAAuB,GAAG,EAAE,CAAC;QACtC,CAAC;IACH,CAAC;CACF,CAAC,CAAC"}

package/dist/cli/agent/tools/spiral-store.d.ts

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

package/dist/cli/agent/tools/spiral-store.d.ts.map

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

package/dist/cli/agent/tools/spiral-store.js

@@ -0,0 +1,37 @@
+import { registerTool } from './registry.js';
+registerTool({
+    definition: {
+        name: 'spiral_store',
+        description: 'Store an important insight, decision, or finding in the spiral memory. Use this when you discover something worth remembering across sessions — architectural decisions, bug patterns, important code relationships.',
+        input_schema: {
+            type: 'object',
+            properties: {
+                content: { type: 'string', description: 'The insight or information to store' },
+                type: {
+                    type: 'string',
+                    enum: ['code', 'decision', 'error', 'pattern', 'architecture'],
+                    description: 'Type of knowledge being stored',
+                },
+                relations: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'IDs of related spiral nodes to link to',
+                },
+            },
+            required: ['content', 'type'],
+        },
+    },
+    async execute(input, ctx) {
+        if (!ctx.spiralEngine) {
+            return 'Spiral engine is not available.';
+        }
+        try {
+            const result = await ctx.spiralEngine.store(input.content, input.type, {}, input.relations);
+            return `Stored in spiral:\n  Node ID: ${result.node_id}\n  Level: L${result.level}\n  Connections: ${result.connections}\n  Tokens: ${result.token_count}`;
+        }
+        catch (err) {
+            return `Error storing in spiral: ${err}`;
+        }
+    },
+});
+//# sourceMappingURL=spiral-store.js.map

package/dist/cli/agent/tools/spiral-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spiral-store.js","sourceRoot":"","sources":["../../../../src/cli/agent/tools/spiral-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,YAAY,CAAC;IACX,UAAU,EAAE;QACV,IAAI,EAAE,cAAc;QACpB,WAAW,EAAE,sNAAsN;QACnO,YAAY,EAAE;YACZ,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,qCAAqC,EAAE;gBAC/E,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,EAAE,cAAc,CAAC;oBAC9D,WAAW,EAAE,gCAAgC;iBAC9C;gBACD,SAAS,EAAE;oBACT,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACzB,WAAW,EAAE,wCAAwC;iBACtD;aACF;YACD,QAAQ,EAAE,CAAC,SAAS,EAAE,MAAM,CAAC;SAC9B;KACF;IAED,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG;QACtB,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC;YACtB,OAAO,iCAAiC,CAAC;QAC3C,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,YAAY,CAAC,KAAK,CACzC,KAAK,CAAC,OAAiB,EACvB,KAAK,CAAC,IAAc,EACpB,EAAE,EACF,KAAK,CAAC,SAAiC,CACxC,CAAC;YAEF,OAAO,iCAAiC,MAAM,CAAC,OAAO,eAAe,MAAM,CAAC,KAAK,oBAAoB,MAAM,CAAC,WAAW,eAAe,MAAM,CAAC,WAAW,EAAE,CAAC;QAC7J,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,4BAA4B,GAAG,EAAE,CAAC;QAC3C,CAAC;IACH,CAAC;CACF,CAAC,CAAC"}

package/dist/cli/agent/tools/web-research.d.ts

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

package/dist/cli/agent/tools/web-research.d.ts.map

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

package/dist/cli/agent/tools/web-research.js

@@ -0,0 +1,96 @@
+import { registerTool } from './registry.js';
+registerTool({
+    definition: {
+        name: 'web_research',
+        description: 'Search the internet for current information about a topic and store findings in the spiral brain. Use this when you need up-to-date documentation, best practices, API references, or solutions for specific technologies. The results are automatically stored in the brain for future reference.',
+        input_schema: {
+            type: 'object',
+            properties: {
+                query: {
+                    type: 'string',
+                    description: 'What to search for (e.g. "Next.js 14 server actions best practices", "PostgreSQL connection pooling")',
+                },
+                max_results: {
+                    type: 'number',
+                    description: 'Maximum number of web pages to fetch and process (default: 3, max: 5)',
+                },
+                fetch_content: {
+                    type: 'boolean',
+                    description: 'Whether to fetch and extract content from result pages (default: true). Set to false for quick search-only.',
+                },
+            },
+            required: ['query'],
+        },
+    },
+    async execute(input, ctx) {
+        const query = input.query;
+        const maxResults = Math.min(input.max_results ?? 3, 5);
+        const fetchContent = input.fetch_content ?? true;
+        try {
+            const { webSearch, fetchPageContent } = await import('../../../spiral/cloud/search-provider.js');
+            const { extractKnowledge, formatForSpiral } = await import('../../../spiral/cloud/content-extractor.js');
+            // Search the web
+            const searchResults = await webSearch(query, maxResults + 2);
+            if (searchResults.length === 0) {
+                return `No web results found for "${query}". The search may have failed due to network issues.`;
+            }
+            const parts = [];
+            parts.push(`Web search results for "${query}":\n`);
+            let storedCount = 0;
+            for (let i = 0; i < Math.min(searchResults.length, maxResults); i++) {
+                const result = searchResults[i];
+                parts.push(`${i + 1}. ${result.title}`);
+                parts.push(`   URL: ${result.url}`);
+                if (result.snippet) {
+                    parts.push(`   ${result.snippet}`);
+                }
+                // Fetch and extract content if enabled
+                if (fetchContent) {
+                    const content = await fetchPageContent(result.url, 8000);
+                    if (content) {
+                        const knowledge = extractKnowledge(content, result.url, query);
+                        if (knowledge.quality >= 0.3) {
+                            // Show extracted key points
+                            if (knowledge.keyPoints.length > 0) {
+                                parts.push(`   Key points:`);
+                                for (const point of knowledge.keyPoints.slice(0, 3)) {
+                                    parts.push(`     - ${point}`);
+                                }
+                            }
+                            // Show code examples
+                            if (knowledge.codeExamples.length > 0) {
+                                parts.push(`   Code example:`);
+                                parts.push(`   ${knowledge.codeExamples[0].slice(0, 500)}`);
+                            }
+                            // Store in spiral brain
+                            if (ctx.spiralEngine) {
+                                try {
+                                    const spiralContent = formatForSpiral(knowledge, query);
+                                    await ctx.spiralEngine.store(spiralContent, 'pattern', {
+                                        tags: ['web_knowledge', 'web_research', ...query.split(/\s+/).slice(0, 3)],
+                                        source: result.url,
+                                        web_topic: query,
+                                        quality: knowledge.quality,
+                                    });
+                                    storedCount++;
+                                }
+                                catch {
+                                    // Storage error, continue
+                                }
+                            }
+                        }
+                    }
+                }
+                parts.push('');
+            }
+            if (storedCount > 0) {
+                parts.push(`\n[${storedCount} knowledge items stored in spiral brain for future reference]`);
+            }
+            return parts.join('\n');
+        }
+        catch (err) {
+            return `Web research error: ${err instanceof Error ? err.message : String(err)}`;
+        }
+    },
+});
+//# sourceMappingURL=web-research.js.map

package/dist/cli/agent/tools/web-research.js.map

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

package/dist/cli/agent/tools/write-file.d.ts

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

package/dist/cli/agent/tools/write-file.d.ts.map

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

package/dist/cli/agent/tools/write-file.js

@@ -0,0 +1,86 @@
+import { writeFileSync, existsSync, mkdirSync, statSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { randomUUID } from 'node:crypto';
+import { registerTool } from './registry.js';
+import { validatePathEx, SecurityError } from '../sandbox.js';
+import { UndoStack } from '../undo.js';
+/** Maximum file size in bytes (10MB) */
+const MAX_FILE_SIZE = 10 * 1024 * 1024;
+/** Maximum content length in characters (5MB) */
+const MAX_CONTENT_LENGTH = 5 * 1024 * 1024;
+registerTool({
+    definition: {
+        name: 'write_file',
+        description: 'Create a new file or completely overwrite an existing file with the given content.',
+        input_schema: {
+            type: 'object',
+            properties: {
+                path: { type: 'string', description: 'Relative path for the file' },
+                content: { type: 'string', description: 'The full file content to write' },
+            },
+            required: ['path', 'content'],
+        },
+    },
+    async execute(input, ctx) {
+        const { resolved: filePath } = validatePathEx(input.path, ctx.projectRoot);
+        const content = input.content;
+        // Validate content length
+        if (content.length > MAX_CONTENT_LENGTH) {
+            throw new SecurityError(`Content too long: ${content.length} characters (max ${MAX_CONTENT_LENGTH})`);
+        }
+        // Validate file size before writing
+        if (content.length > MAX_FILE_SIZE) {
+            throw new SecurityError(`Content too large: ${content.length} characters (max ${MAX_FILE_SIZE})`);
+        }
+        // Check if file exists and validate it's not too large
+        let existed = false;
+        try {
+            const stats = statSync(filePath);
+            if (stats.size > MAX_FILE_SIZE) {
+                throw new SecurityError(`File too large: ${stats.size} bytes (max ${MAX_FILE_SIZE})`);
+            }
+            existed = true;
+        }
+        catch (err) {
+            if (err.code !== 'ENOENT') {
+                throw new SecurityError(`Cannot access file: ${err}`);
+            }
+        }
+        // Capture original state for undo
+        const original = existed ? UndoStack.captureState(filePath) : null;
+        // Ensure directory exists and is writable
+        const dir = dirname(filePath);
+        try {
+            if (!existsSync(dir)) {
+                mkdirSync(dir, { recursive: true });
+            }
+            const dirStats = statSync(dir);
+            if (!dirStats.isDirectory()) {
+                throw new SecurityError(`Parent path is not a directory: ${dir}`);
+            }
+        }
+        catch (err) {
+            if (err instanceof SecurityError)
+                throw err;
+            throw new SecurityError(`Parent directory not accessible: ${dir}`);
+        }
+        // Write file
+        writeFileSync(filePath, content, 'utf-8');
+        // Push to undo stack
+        ctx.undoStack.push({
+            id: randomUUID(),
+            timestamp: Date.now(),
+            tool: 'write_file',
+            path: filePath,
+            originalContent: original,
+            newContent: content,
+        });
+        const lines = content.split('\n').length;
+        const sizeKB = Buffer.byteLength(content, 'utf-8') / 1024;
+        if (existed) {
+            return `File overwritten: ${input.path} (${lines} lines, ${sizeKB.toFixed(1)} KB)`;
+        }
+        return `File created: ${input.path} (${lines} lines, ${sizeKB.toFixed(1)} KB)`;
+    },
+});
+//# sourceMappingURL=write-file.js.map

package/dist/cli/agent/tools/write-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-file.js","sourceRoot":"","sources":["../../../../src/cli/agent/tools/write-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAc,MAAM,SAAS,CAAC;AACrF,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC,wCAAwC;AACxC,MAAM,aAAa,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAEvC,iDAAiD;AACjD,MAAM,kBAAkB,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AAE3C,YAAY,CAAC;IACX,UAAU,EAAE;QACV,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,oFAAoF;QACjG,YAAY,EAAE;YACZ,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,4BAA4B,EAAE;gBACnE,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gCAAgC,EAAE;aAC3E;YACD,QAAQ,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC;SAC9B;KACF;IAED,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG;QACtB,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,cAAc,CAAC,KAAK,CAAC,IAAc,EAAE,GAAG,CAAC,WAAW,CAAC,CAAC;QACrF,MAAM,OAAO,GAAG,KAAK,CAAC,OAAiB,CAAC;QAExC,0BAA0B;QAC1B,IAAI,OAAO,CAAC,MAAM,GAAG,kBAAkB,EAAE,CAAC;YACxC,MAAM,IAAI,aAAa,CAAC,qBAAqB,OAAO,CAAC,MAAM,oBAAoB,kBAAkB,GAAG,CAAC,CAAC;QACxG,CAAC;QAED,oCAAoC;QACpC,IAAI,OAAO,CAAC,MAAM,GAAG,aAAa,EAAE,CAAC;YACnC,MAAM,IAAI,aAAa,CAAC,sBAAsB,OAAO,CAAC,MAAM,oBAAoB,aAAa,GAAG,CAAC,CAAC;QACpG,CAAC;QAED,uDAAuD;QACvD,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;YACjC,IAAI,KAAK,CAAC,IAAI,GAAG,aAAa,EAAE,CAAC;gBAC/B,MAAM,IAAI,aAAa,CAAC,mBAAmB,KAAK,CAAC,IAAI,eAAe,aAAa,GAAG,CAAC,CAAC;YACxF,CAAC;YACD,OAAO,GAAG,IAAI,CAAC;QACjB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACrD,MAAM,IAAI,aAAa,CAAC,uBAAuB,GAAG,EAAE,CAAC,CAAC;YACxD,CAAC;QACH,CAAC;QAED,kCAAkC;QAClC,MAAM,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAEnE,0CAA0C;QAC1C,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC9B,IAAI,CAAC;YACH,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACrB,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACtC,CAAC;YACD,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;YAC/B,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC;gBAC5B,MAAM,IAAI,aAAa,CAAC,mCAAmC,GAAG,EAAE,CAAC,CAAC;YACpE,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,aAAa;gBAAE,MAAM,GAAG,CAAC;YAC5C,MAAM,IAAI,aAAa,CAAC,oCAAoC,GAAG,EAAE,CAAC,CAAC;QACrE,CAAC;QAED,aAAa;QACb,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAE1C,qBAAqB;QACrB,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC;YACjB,EAAE,EAAE,UAAU,EAAE;YAChB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,IAAI,EAAE,YAAY;YAClB,IAAI,EAAE,QAAQ;YACd,eAAe,EAAE,QAAQ;YACzB,UAAU,EAAE,OAAO;SACpB,CAAC,CAAC;QAEH,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;QACzC,MAAM,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;QAE1D,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,qBAAqB,KAAK,CAAC,IAAI,KAAK,KAAK,WAAW,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;QACrF,CAAC;QACD,OAAO,iBAAiB,KAAK,CAAC,IAAI,KAAK,KAAK,WAAW,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;IACjF,CAAC;CACF,CAAC,CAAC"}

package/dist/cli/agent/undo.d.ts

@@ -0,0 +1,30 @@
+export interface UndoEntry {
+    id: string;
+    timestamp: number;
+    tool: string;
+    path: string;
+    originalContent: string | null;
+    newContent: string;
+}
+export declare class UndoStack {
+    private stack;
+    private maxSize;
+    push(entry: UndoEntry): void;
+    /**
+     * Undo the last n changes. Returns the number of changes undone.
+     */
+    undo(count?: number): {
+        undone: number;
+        entries: UndoEntry[];
+    };
+    /**
+     * Get all undo-able entries (most recent first).
+     */
+    list(): UndoEntry[];
+    /**
+     * Capture the current state of a file before modification.
+     */
+    static captureState(path: string): string | null;
+    get size(): number;
+}
+//# sourceMappingURL=undo.d.ts.map

package/dist/cli/agent/undo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"undo.d.ts","sourceRoot":"","sources":["../../../src/cli/agent/undo.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,KAAK,CAAmB;IAChC,OAAO,CAAC,OAAO,CAAM;IAErB,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAO5B;;OAEG;IACH,IAAI,CAAC,KAAK,GAAE,MAAU,GAAG;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,SAAS,EAAE,CAAA;KAAE;IAkBjE;;OAEG;IACH,IAAI,IAAI,SAAS,EAAE;IAInB;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAKhD,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}