codehere 0.1.0 → 0.2.0

package/dist/testgen.js

@@ -2,7 +2,7 @@
  * Test Generation System
  * Generate comprehensive tests for code
  */
-import { readFileSync, existsSync, writeFileSync } from 'fs';
+import { readFileSync, existsSync, writeFileSync, mkdirSync } from 'fs';
 import { join, dirname, basename } from 'path';
 import { chatWithContext } from './chat.js';
 import { getEnhancedContext } from './context.js';
@@ -105,7 +105,6 @@ export function saveTests(filepath, testContent) {
     const fullPath = join(process.cwd(), filepath);
     const dir = dirname(fullPath);
     if (!existsSync(dir)) {
-        const { mkdirSync } = require('fs');
         mkdirSync(dir, { recursive: true });
     }
     writeFileSync(fullPath, testContent, 'utf-8');

package/dist/testgen.js.map

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

package/dist/tools/bash.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Bash Tool
+ * Execute shell commands safely with detailed descriptions for the model
+ * Following Claude Code approach: detailed tool descriptions, error-proofing
+ *
+ * SECURITY: Uses Docker sandbox when available for isolated execution
+ */
+export interface BashOptions {
+    /** Working directory (will be resolved to absolute path) */
+    cwd?: string;
+    /** Timeout in milliseconds (default: 30000 = 30s) */
+    timeout?: number;
+    /** Maximum output size in bytes (default: 1MB) */
+    maxOutputSize?: number;
+    /** Environment variables */
+    env?: Record<string, string>;
+}
+export interface BashResult {
+    /** Exit code (0 = success) */
+    exitCode: number;
+    /** Standard output */
+    stdout: string;
+    /** Standard error */
+    stderr: string;
+    /** Command that was executed */
+    command: string;
+    /** Execution time in milliseconds */
+    duration: number;
+    /** Whether command succeeded */
+    success: boolean;
+    /** Whether command was executed in sandbox */
+    sandboxed?: boolean;
+    /** Sandbox status message */
+    sandboxStatus?: string;
+}
+/**
+ * Execute a bash command safely
+ *
+ * SECURITY & ERROR-PROOFING:
+ * - All paths are resolved to absolute paths
+ * - Commands are executed in Docker sandbox when available (MANDATORY for production)
+ * - Falls back to direct execution with warning if sandbox unavailable
+ * - Timeout protection prevents hanging
+ * - Output size limits prevent memory issues
+ * - Command injection attempts are logged
+ */
+export declare function executeBash(command: string, options?: BashOptions): Promise<BashResult>;
+/**
+ * Tool description for the model
+ * This is critical - the model needs to understand how to use this tool
+ */
+export declare const BASH_TOOL_DESCRIPTION = "\nBash Tool - Execute shell commands\n\nDESCRIPTION:\nExecute bash/shell commands in a controlled environment. All paths are automatically resolved to absolute paths.\n\nAVAILABLE COMMANDS:\n- Any valid bash/shell command\n- Commands run in the project directory by default\n- Working directory can be specified\n\nIMPORTANT CONSTRAINTS:\n1. **Absolute Paths Required**: Always use absolute paths or paths relative to the working directory\n2. **No Internet Access**: Commands run in isolated environment (no network access)\n3. **Available Packages**: Standard Unix utilities (ls, cat, grep, find, etc.)\n4. **Timeout**: Commands timeout after 30 seconds (configurable)\n5. **Output Limit**: Maximum 1MB output (configurable)\n\nESCAPING:\n- Use single quotes for strings: 'string with spaces'\n- Escape special characters: Use backslash before $, backtick, or double quote\n- For complex commands, consider breaking into multiple steps\n\nBACKGROUND PROCESSES:\n- Background processes (&) are NOT supported\n- Use sequential commands instead\n\nPATH HANDLING:\n- All paths are resolved to absolute paths automatically\n- Use resolve() or absolute paths to avoid relative path issues\n- Example: /Users/username/project/file.txt (absolute)\n- Example: ./file.txt (relative to cwd)\n\nERROR HANDLING:\n- Exit code 0 = success\n- Exit code != 0 = failure\n- Check stderr for error messages\n- Timeout errors are reported in stderr\n\nEXAMPLES:\n- executeBash('ls -la', { cwd: '/path/to/dir' })\n- executeBash('grep -r \"pattern\" .', { cwd: '/path/to/project' })\n- executeBash('cat /absolute/path/to/file.txt')\n- executeBash('find . -name \"*.ts\" -type f', { cwd: '/path/to/project' })\n\nSECURITY NOTES:\n- Commands execute in Docker sandbox when available (MANDATORY for production)\n- Falls back to direct execution with warning if Docker unavailable\n- Potentially dangerous commands are logged but not blocked\n- Use with caution for destructive operations\n- Always verify paths before executing\n\nSANDBOX STATUS:\n- Check result.sandboxed to see if command ran in sandbox\n- Check result.sandboxStatus for sandbox availability information\n- Production deployments should always have Docker available\n";
+//# sourceMappingURL=bash.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bash.d.ts","sourceRoot":"","sources":["../../src/tools/bash.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAuBH,MAAM,WAAW,WAAW;IAC1B,4DAA4D;IAC5D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,4BAA4B;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,UAAU;IACzB,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,qBAAqB;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,gCAAgC;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,8CAA8C;IAC9C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,6BAA6B;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,UAAU,CAAC,CAiIrB;AAED;;;GAGG;AACH,eAAO,MAAM,qBAAqB,yqEAwDjC,CAAC"}

package/dist/tools/bash.js

@@ -0,0 +1,213 @@
+/**
+ * Bash Tool
+ * Execute shell commands safely with detailed descriptions for the model
+ * Following Claude Code approach: detailed tool descriptions, error-proofing
+ *
+ * SECURITY: Uses Docker sandbox when available for isolated execution
+ */
+import { exec } from 'child_process';
+import { promisify } from 'util';
+import { resolve } from 'path';
+import { existsSync } from 'fs';
+import { SandboxExecutor } from '../infrastructure/security/sandbox-executor.js';
+const execAsync = promisify(exec);
+// Singleton sandbox executor instance
+let sandboxExecutor = null;
+/**
+ * Get or create sandbox executor instance
+ */
+function getSandboxExecutor() {
+    if (!sandboxExecutor) {
+        sandboxExecutor = new SandboxExecutor();
+    }
+    return sandboxExecutor;
+}
+/**
+ * Execute a bash command safely
+ *
+ * SECURITY & ERROR-PROOFING:
+ * - All paths are resolved to absolute paths
+ * - Commands are executed in Docker sandbox when available (MANDATORY for production)
+ * - Falls back to direct execution with warning if sandbox unavailable
+ * - Timeout protection prevents hanging
+ * - Output size limits prevent memory issues
+ * - Command injection attempts are logged
+ */
+export async function executeBash(command, options = {}) {
+    const startTime = Date.now();
+    // Resolve working directory to absolute path
+    const cwd = options.cwd
+        ? resolve(options.cwd)
+        : process.cwd();
+    // Verify directory exists
+    if (!existsSync(cwd)) {
+        throw new Error(`Working directory does not exist: ${cwd}`);
+    }
+    // Security: Log suspicious patterns (but don't block - let model decide)
+    const suspiciousPatterns = [
+        /rm\s+-rf\s+\//, // Dangerous rm -rf /
+        /format\s+c:/i, // Windows format
+        /mkfs/, // Filesystem creation
+        /dd\s+if=/, // Disk operations
+    ];
+    for (const pattern of suspiciousPatterns) {
+        if (pattern.test(command)) {
+            console.warn(`⚠️  Warning: Potentially dangerous command detected: ${command}`);
+        }
+    }
+    // Try to use sandbox first (MANDATORY for production security)
+    const sandbox = getSandboxExecutor();
+    const sandboxAvailable = await sandbox.isAvailable();
+    if (sandboxAvailable) {
+        try {
+            // Execute in sandbox
+            const sandboxOptions = {
+                timeout: options.timeout || 30000,
+                memoryLimit: '512m',
+                cpuLimit: '0.5',
+                networkAccess: false, // No network access by default
+            };
+            const sandboxResult = await sandbox.executeBash(command, sandboxOptions);
+            const duration = Date.now() - startTime;
+            return {
+                exitCode: sandboxResult.exitCode || (sandboxResult.success ? 0 : 1),
+                stdout: sandboxResult.output || '',
+                stderr: sandboxResult.error || '',
+                command,
+                duration,
+                success: sandboxResult.success,
+                sandboxed: true,
+                sandboxStatus: 'Executed in Docker sandbox (secure)',
+            };
+        }
+        catch (sandboxError) {
+            // If sandbox execution fails, fall through to direct execution with warning
+            console.warn(`⚠️  Sandbox execution failed, falling back to direct execution: ${sandboxError.message}`);
+        }
+    }
+    else {
+        // Sandbox not available - use direct execution with warning
+        console.warn(`⚠️  WARNING: Docker sandbox not available. Executing command directly (less secure).`);
+        console.warn(`⚠️  For production use, please install Docker to enable secure sandbox execution.`);
+    }
+    // Fallback: Direct execution (with security warning)
+    const timeout = options.timeout || 30000; // 30 seconds
+    const maxOutputSize = options.maxOutputSize || 1024 * 1024; // 1MB
+    // Merge environment variables
+    const env = {
+        ...process.env,
+        ...options.env,
+    };
+    try {
+        // Execute command with timeout
+        const { stdout, stderr } = await Promise.race([
+            execAsync(command, {
+                cwd,
+                env,
+                maxBuffer: maxOutputSize,
+            }),
+            new Promise((_, reject) => {
+                setTimeout(() => {
+                    reject(new Error(`Command timed out after ${timeout}ms`));
+                }, timeout);
+            }),
+        ]);
+        const duration = Date.now() - startTime;
+        // Check output size
+        const totalSize = (stdout?.length || 0) + (stderr?.length || 0);
+        if (totalSize > maxOutputSize) {
+            console.warn(`⚠️  Warning: Command output exceeds ${maxOutputSize} bytes, truncated`);
+        }
+        return {
+            exitCode: 0,
+            stdout: stdout || '',
+            stderr: stderr || '',
+            command,
+            duration,
+            success: true,
+            sandboxed: false,
+            sandboxStatus: sandboxAvailable
+                ? 'Sandbox available but execution failed, used direct execution'
+                : 'Docker sandbox not available, used direct execution (less secure)',
+        };
+    }
+    catch (error) {
+        const duration = Date.now() - startTime;
+        // Extract exit code from error
+        const exitCode = error.code || (error.signal ? 128 : 1);
+        return {
+            exitCode,
+            stdout: error.stdout || '',
+            stderr: error.stderr || error.message || '',
+            command,
+            duration,
+            success: exitCode === 0,
+            sandboxed: false,
+            sandboxStatus: sandboxAvailable
+                ? 'Sandbox available but execution failed, used direct execution'
+                : 'Docker sandbox not available, used direct execution (less secure)',
+        };
+    }
+}
+/**
+ * Tool description for the model
+ * This is critical - the model needs to understand how to use this tool
+ */
+export const BASH_TOOL_DESCRIPTION = `
+Bash Tool - Execute shell commands
+
+DESCRIPTION:
+Execute bash/shell commands in a controlled environment. All paths are automatically resolved to absolute paths.
+
+AVAILABLE COMMANDS:
+- Any valid bash/shell command
+- Commands run in the project directory by default
+- Working directory can be specified
+
+IMPORTANT CONSTRAINTS:
+1. **Absolute Paths Required**: Always use absolute paths or paths relative to the working directory
+2. **No Internet Access**: Commands run in isolated environment (no network access)
+3. **Available Packages**: Standard Unix utilities (ls, cat, grep, find, etc.)
+4. **Timeout**: Commands timeout after 30 seconds (configurable)
+5. **Output Limit**: Maximum 1MB output (configurable)
+
+ESCAPING:
+- Use single quotes for strings: 'string with spaces'
+- Escape special characters: Use backslash before $, backtick, or double quote
+- For complex commands, consider breaking into multiple steps
+
+BACKGROUND PROCESSES:
+- Background processes (&) are NOT supported
+- Use sequential commands instead
+
+PATH HANDLING:
+- All paths are resolved to absolute paths automatically
+- Use resolve() or absolute paths to avoid relative path issues
+- Example: /Users/username/project/file.txt (absolute)
+- Example: ./file.txt (relative to cwd)
+
+ERROR HANDLING:
+- Exit code 0 = success
+- Exit code != 0 = failure
+- Check stderr for error messages
+- Timeout errors are reported in stderr
+
+EXAMPLES:
+- executeBash('ls -la', { cwd: '/path/to/dir' })
+- executeBash('grep -r "pattern" .', { cwd: '/path/to/project' })
+- executeBash('cat /absolute/path/to/file.txt')
+- executeBash('find . -name "*.ts" -type f', { cwd: '/path/to/project' })
+
+SECURITY NOTES:
+- Commands execute in Docker sandbox when available (MANDATORY for production)
+- Falls back to direct execution with warning if Docker unavailable
+- Potentially dangerous commands are logged but not blocked
+- Use with caution for destructive operations
+- Always verify paths before executing
+
+SANDBOX STATUS:
+- Check result.sandboxed to see if command ran in sandbox
+- Check result.sandboxStatus for sandbox availability information
+- Production deployments should always have Docker available
+`;
+//# sourceMappingURL=bash.js.map

package/dist/tools/bash.js.map

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

package/dist/tools/edit.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Edit Tool
+ * String replacement-based file editing (like Claude Code)
+ * Requires exact matches for safety
+ */
+export interface EditOptions {
+    /** Working directory (will be resolved to absolute path) */
+    cwd?: string;
+    /** Create file if it doesn't exist */
+    createIfNotExists?: boolean;
+}
+export interface EditResult {
+    /** Whether operation succeeded */
+    success: boolean;
+    /** File path (absolute) */
+    filepath: string;
+    /** Operation performed */
+    operation: 'view' | 'create' | 'str_replace' | 'undo';
+    /** Error message if failed */
+    error?: string;
+    /** File content (for view operations) */
+    content?: string;
+    /** Number of replacements made */
+    replacements?: number;
+}
+/**
+ * View file content
+ */
+export declare function viewFile(filepath: string, options?: EditOptions): EditResult;
+/**
+ * Create a new file
+ */
+export declare function createFile(filepath: string, content: string, options?: EditOptions): EditResult;
+/**
+ * String replacement (exact match required)
+ * CRITICAL: Must match exactly, or error if multiple matches
+ */
+export declare function strReplace(filepath: string, oldString: string, newString: string, options?: EditOptions): EditResult;
+/**
+ * Undo last edit
+ */
+export declare function undoEdit(filepath: string, options?: EditOptions): EditResult;
+/**
+ * Tool description for the model
+ * This is critical - the model needs to understand how to use this tool
+ */
+export declare const EDIT_TOOL_DESCRIPTION = "\nEdit Tool - String replacement-based file editing\n\nDESCRIPTION:\nEdit files using string replacement. Requires exact matches for safety.\n\nAVAILABLE OPERATIONS:\n1. **view(filepath)**: View file content\n2. **create(filepath, content)**: Create new file\n3. **str_replace(filepath, oldString, newString)**: Replace string in file\n4. **undo(filepath)**: Undo last edit\n\nCRITICAL RULES:\n1. **Exact Match Required**: oldString must match EXACTLY in the file\n2. **Unique Match Required**: If multiple matches found, provide more context\n3. **Absolute Paths**: All paths are resolved to absolute paths automatically\n4. **Context for Uniqueness**: Include surrounding lines if needed to make match unique\n\nSTRING REPLACEMENT:\n- oldString must appear EXACTLY ONCE in the file\n- If 0 matches: Error - string not found\n- If 2+ matches: Error - provide more context\n- Include surrounding code/whitespace to ensure uniqueness\n\nEXAMPLES:\n- str_replace('/path/to/file.ts', 'function old()', 'function new()')\n- str_replace('/path/to/file.ts', 'const x = 1;\\n', 'const x = 2;\\n')\n- Include context: str_replace('/path/to/file.ts', '  // Comment\\n  function old()', '  // Comment\\n  function new()')\n\nPATH HANDLING:\n- All paths are resolved to absolute paths\n- Use absolute paths or paths relative to cwd\n- Example: '/Users/username/project/file.ts' (absolute)\n- Example: './file.ts' (relative to cwd)\n\nUNDO:\n- undo() restores file to previous state\n- Only one level of undo (last edit)\n- Undo stack is in-memory (lost on restart)\n\nERROR HANDLING:\n- Check success field in result\n- Check error field for error message\n- Common errors:\n  - File not found\n  - String not found (0 matches)\n  - Multiple matches (need more context)\n\nSECURITY:\n- All paths are validated\n- No file system traversal beyond project directory\n- Exact match requirement prevents accidental replacements\n";
+//# sourceMappingURL=edit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"edit.d.ts","sourceRoot":"","sources":["../../src/tools/edit.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,MAAM,WAAW,WAAW;IAC1B,4DAA4D;IAC5D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,sCAAsC;IACtC,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,UAAU;IACzB,kCAAkC;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,0BAA0B;IAC1B,SAAS,EAAE,MAAM,GAAG,QAAQ,GAAG,aAAa,GAAG,MAAM,CAAC;IACtD,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAKD;;GAEG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,UAAU,CA4BhF;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,WAAgB,GACxB,UAAU,CA6CZ;AAED;;;GAGG;AACH,wBAAgB,UAAU,CACxB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,WAAgB,GACxB,UAAU,CA+DZ;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,UAAU,CA8BhF;AAED;;;GAGG;AACH,eAAO,MAAM,qBAAqB,83DAoDjC,CAAC"}

package/dist/tools/edit.js

@@ -0,0 +1,235 @@
+/**
+ * Edit Tool
+ * String replacement-based file editing (like Claude Code)
+ * Requires exact matches for safety
+ */
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'fs';
+import { resolve, dirname } from 'path';
+// Undo stack (simple in-memory, could be persisted later)
+const undoStack = new Map();
+/**
+ * View file content
+ */
+export function viewFile(filepath, options = {}) {
+    const absPath = resolve(options.cwd || process.cwd(), filepath);
+    if (!existsSync(absPath)) {
+        return {
+            success: false,
+            filepath: absPath,
+            operation: 'view',
+            error: `File not found: ${absPath}`,
+        };
+    }
+    try {
+        const content = readFileSync(absPath, 'utf-8');
+        return {
+            success: true,
+            filepath: absPath,
+            operation: 'view',
+            content,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            filepath: absPath,
+            operation: 'view',
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+/**
+ * Create a new file
+ */
+export function createFile(filepath, content, options = {}) {
+    const absPath = resolve(options.cwd || process.cwd(), filepath);
+    // Check if file exists
+    if (existsSync(absPath) && !options.createIfNotExists) {
+        return {
+            success: false,
+            filepath: absPath,
+            operation: 'create',
+            error: `File already exists: ${absPath}`,
+        };
+    }
+    try {
+        // Ensure directory exists
+        const dir = dirname(absPath);
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+        // Save to undo stack
+        if (existsSync(absPath)) {
+            const oldContent = readFileSync(absPath, 'utf-8');
+            if (!undoStack.has(absPath)) {
+                undoStack.set(absPath, []);
+            }
+            undoStack.get(absPath).push(oldContent);
+        }
+        // Write file
+        writeFileSync(absPath, content, 'utf-8');
+        return {
+            success: true,
+            filepath: absPath,
+            operation: 'create',
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            filepath: absPath,
+            operation: 'create',
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+/**
+ * String replacement (exact match required)
+ * CRITICAL: Must match exactly, or error if multiple matches
+ */
+export function strReplace(filepath, oldString, newString, options = {}) {
+    const absPath = resolve(options.cwd || process.cwd(), filepath);
+    if (!existsSync(absPath)) {
+        return {
+            success: false,
+            filepath: absPath,
+            operation: 'str_replace',
+            error: `File not found: ${absPath}`,
+        };
+    }
+    try {
+        // Read file
+        const content = readFileSync(absPath, 'utf-8');
+        // Save to undo stack
+        if (!undoStack.has(absPath)) {
+            undoStack.set(absPath, []);
+        }
+        undoStack.get(absPath).push(content);
+        // Count matches
+        const matches = content.split(oldString).length - 1;
+        if (matches === 0) {
+            return {
+                success: false,
+                filepath: absPath,
+                operation: 'str_replace',
+                error: `String not found in file. Exact match required.`,
+            };
+        }
+        if (matches > 1) {
+            return {
+                success: false,
+                filepath: absPath,
+                operation: 'str_replace',
+                error: `Multiple matches found (${matches}). Provide more context to make the match unique.`,
+            };
+        }
+        // Perform replacement
+        const newContent = content.replace(oldString, newString);
+        // Write file
+        writeFileSync(absPath, newContent, 'utf-8');
+        return {
+            success: true,
+            filepath: absPath,
+            operation: 'str_replace',
+            replacements: 1,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            filepath: absPath,
+            operation: 'str_replace',
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+/**
+ * Undo last edit
+ */
+export function undoEdit(filepath, options = {}) {
+    const absPath = resolve(options.cwd || process.cwd(), filepath);
+    const stack = undoStack.get(absPath);
+    if (!stack || stack.length === 0) {
+        return {
+            success: false,
+            filepath: absPath,
+            operation: 'undo',
+            error: 'No undo history available',
+        };
+    }
+    try {
+        const previousContent = stack.pop();
+        writeFileSync(absPath, previousContent, 'utf-8');
+        return {
+            success: true,
+            filepath: absPath,
+            operation: 'undo',
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            filepath: absPath,
+            operation: 'undo',
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+/**
+ * Tool description for the model
+ * This is critical - the model needs to understand how to use this tool
+ */
+export const EDIT_TOOL_DESCRIPTION = `
+Edit Tool - String replacement-based file editing
+
+DESCRIPTION:
+Edit files using string replacement. Requires exact matches for safety.
+
+AVAILABLE OPERATIONS:
+1. **view(filepath)**: View file content
+2. **create(filepath, content)**: Create new file
+3. **str_replace(filepath, oldString, newString)**: Replace string in file
+4. **undo(filepath)**: Undo last edit
+
+CRITICAL RULES:
+1. **Exact Match Required**: oldString must match EXACTLY in the file
+2. **Unique Match Required**: If multiple matches found, provide more context
+3. **Absolute Paths**: All paths are resolved to absolute paths automatically
+4. **Context for Uniqueness**: Include surrounding lines if needed to make match unique
+
+STRING REPLACEMENT:
+- oldString must appear EXACTLY ONCE in the file
+- If 0 matches: Error - string not found
+- If 2+ matches: Error - provide more context
+- Include surrounding code/whitespace to ensure uniqueness
+
+EXAMPLES:
+- str_replace('/path/to/file.ts', 'function old()', 'function new()')
+- str_replace('/path/to/file.ts', 'const x = 1;\\n', 'const x = 2;\\n')
+- Include context: str_replace('/path/to/file.ts', '  // Comment\\n  function old()', '  // Comment\\n  function new()')
+
+PATH HANDLING:
+- All paths are resolved to absolute paths
+- Use absolute paths or paths relative to cwd
+- Example: '/Users/username/project/file.ts' (absolute)
+- Example: './file.ts' (relative to cwd)
+
+UNDO:
+- undo() restores file to previous state
+- Only one level of undo (last edit)
+- Undo stack is in-memory (lost on restart)
+
+ERROR HANDLING:
+- Check success field in result
+- Check error field for error message
+- Common errors:
+  - File not found
+  - String not found (0 matches)
+  - Multiple matches (need more context)
+
+SECURITY:
+- All paths are validated
+- No file system traversal beyond project directory
+- Exact match requirement prevents accidental replacements
+`;
+//# sourceMappingURL=edit.js.map

package/dist/tools/edit.js.map

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

package/dist/tools/executor.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Tool Executor
+ * Execute tools with error handling and result formatting
+ */
+import type { ToolCall } from './parser.js';
+export interface ToolExecutionResult {
+    /** Whether execution succeeded */
+    success: boolean;
+    /** Tool name */
+    tool: string;
+    /** Execution result */
+    result?: any;
+    /** Error message if failed */
+    error?: string;
+    /** Execution time in milliseconds */
+    duration?: number;
+}
+export declare class ToolExecutor {
+    /**
+     * Execute a single tool call
+     */
+    execute(call: ToolCall): Promise<ToolExecutionResult>;
+    /**
+     * Execute multiple tool calls in sequence
+     * Stops on first error
+     */
+    executeAll(calls: ToolCall[]): Promise<ToolExecutionResult[]>;
+}
+//# sourceMappingURL=executor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../src/tools/executor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,WAAW,mBAAmB;IAClC,kCAAkC;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,uBAAuB;IACvB,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,YAAY;IACvB;;OAEG;IACG,OAAO,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAwG3D;;;OAGG;IACG,UAAU,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC;CAcpE"}