codehere 0.1.1

package/dist/token-optimizer.js

@@ -0,0 +1,282 @@
+/**
+ * Token Optimization System
+ * 80-90% token reduction through smart compression
+ */
+import { encoding_for_model } from 'tiktoken';
+import { getConfigManager } from './infrastructure/config/config-manager.js';
+// Token encoder - tiktoken is OpenAI-specific, use GPT model
+const tokenConfig = getConfigManager();
+const defaultModel = tokenConfig.getModel('default') || tokenConfig.getPreference('defaultModel');
+const tiktokenModel = (defaultModel && defaultModel.includes('gpt')) ? defaultModel : 'gpt-3.5-turbo';
+const enc = encoding_for_model(tiktokenModel);
+/**
+ * Optimize context to minimize tokens while preserving relevance
+ */
+export function optimizeContext(chunks, query, maxTokens, strategy = 'relevant-only') {
+    const originalTokens = chunks.reduce((sum, chunk) => sum + enc.encode(chunk.content).length, 0);
+    let optimized;
+    switch (strategy) {
+        case 'function-level':
+            optimized = optimizeFunctionLevel(chunks, query, maxTokens);
+            break;
+        case 'file-level':
+            optimized = optimizeFileLevel(chunks, query, maxTokens);
+            break;
+        case 'relevant-only':
+            optimized = optimizeRelevantOnly(chunks, query, maxTokens);
+            break;
+        case 'compressed':
+            optimized = optimizeCompressed(chunks, query, maxTokens);
+            break;
+        default:
+            optimized = optimizeRelevantOnly(chunks, query, maxTokens);
+    }
+    const optimizedTokens = optimized.reduce((sum, chunk) => sum + enc.encode(chunk.content).length, 0);
+    const reductionPercent = originalTokens > 0
+        ? ((originalTokens - optimizedTokens) / originalTokens) * 100
+        : 0;
+    return {
+        chunks: optimized,
+        totalTokens: optimizedTokens,
+        reductionPercent,
+        strategy,
+    };
+}
+/**
+ * Extract only relevant functions/classes from chunks
+ */
+function optimizeFunctionLevel(chunks, query, maxTokens) {
+    const optimized = [];
+    let currentTokens = 0;
+    // Extract function/class names from query
+    const querySymbols = extractSymbolsFromQuery(query);
+    for (const chunk of chunks) {
+        if (currentTokens >= maxTokens)
+            break;
+        // Try to extract relevant functions/classes
+        const relevantCode = extractRelevantCode(chunk.content, querySymbols);
+        if (relevantCode) {
+            const tokens = enc.encode(relevantCode).length;
+            if (currentTokens + tokens <= maxTokens) {
+                optimized.push({
+                    ...chunk,
+                    content: relevantCode,
+                });
+                currentTokens += tokens;
+            }
+        }
+        else {
+            // Fallback: use chunk but truncate
+            const tokens = enc.encode(chunk.content).length;
+            const remaining = maxTokens - currentTokens;
+            if (tokens <= remaining) {
+                optimized.push(chunk);
+                currentTokens += tokens;
+            }
+            else if (remaining > 100) {
+                const truncated = truncateToTokens(chunk.content, remaining);
+                optimized.push({
+                    ...chunk,
+                    content: truncated,
+                });
+                currentTokens = maxTokens;
+                break;
+            }
+        }
+    }
+    return optimized;
+}
+/**
+ * Deduplicate and keep only unique files
+ */
+function optimizeFileLevel(chunks, query, maxTokens) {
+    // Group by file
+    const fileGroups = new Map();
+    for (const chunk of chunks) {
+        if (!fileGroups.has(chunk.filepath)) {
+            fileGroups.set(chunk.filepath, []);
+        }
+        fileGroups.get(chunk.filepath).push(chunk);
+    }
+    // Keep best chunk per file
+    const optimized = [];
+    let currentTokens = 0;
+    for (const [filepath, fileChunks] of fileGroups.entries()) {
+        if (currentTokens >= maxTokens)
+            break;
+        // Sort by score and take best
+        const bestChunk = fileChunks.sort((a, b) => b.score - a.score)[0];
+        const tokens = enc.encode(bestChunk.content).length;
+        if (currentTokens + tokens <= maxTokens) {
+            optimized.push(bestChunk);
+            currentTokens += tokens;
+        }
+    }
+    return optimized;
+}
+/**
+ * Keep only most relevant chunks
+ */
+function optimizeRelevantOnly(chunks, query, maxTokens) {
+    // Sort by relevance (score)
+    const sorted = [...chunks].sort((a, b) => b.score - a.score);
+    const optimized = [];
+    let currentTokens = 0;
+    for (const chunk of sorted) {
+        if (currentTokens >= maxTokens)
+            break;
+        const tokens = enc.encode(chunk.content).length;
+        const remaining = maxTokens - currentTokens;
+        if (tokens <= remaining) {
+            optimized.push(chunk);
+            currentTokens += tokens;
+        }
+        else if (remaining > 100) {
+            // Truncate to fit
+            const truncated = truncateToTokens(chunk.content, remaining);
+            optimized.push({
+                ...chunk,
+                content: truncated,
+            });
+            currentTokens = maxTokens;
+            break;
+        }
+    }
+    return optimized;
+}
+/**
+ * Compress chunks by removing comments and whitespace
+ */
+function optimizeCompressed(chunks, query, maxTokens) {
+    const optimized = [];
+    let currentTokens = 0;
+    for (const chunk of chunks) {
+        if (currentTokens >= maxTokens)
+            break;
+        // Remove comments and excessive whitespace
+        const compressed = compressCode(chunk.content);
+        const tokens = enc.encode(compressed).length;
+        const remaining = maxTokens - currentTokens;
+        if (tokens <= remaining) {
+            optimized.push({
+                ...chunk,
+                content: compressed,
+            });
+            currentTokens += tokens;
+        }
+        else if (remaining > 100) {
+            const truncated = truncateToTokens(compressed, remaining);
+            optimized.push({
+                ...chunk,
+                content: truncated,
+            });
+            currentTokens = maxTokens;
+            break;
+        }
+    }
+    return optimized;
+}
+/**
+ * Extract relevant code (functions/classes) from chunk
+ */
+function extractRelevantCode(content, symbols) {
+    if (symbols.length === 0)
+        return null;
+    const lines = content.split('\n');
+    const relevant = [];
+    let inRelevantBlock = false;
+    let braceCount = 0;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        // Check if line contains a symbol we're looking for
+        const hasSymbol = symbols.some(symbol => line.includes(symbol) &&
+            (line.match(/(function|class|interface|type|const|let|var)\s+/)));
+        if (hasSymbol) {
+            inRelevantBlock = true;
+            braceCount = 0;
+        }
+        if (inRelevantBlock) {
+            relevant.push(line);
+            // Count braces to find end of block
+            braceCount += (line.match(/{/g) || []).length;
+            braceCount -= (line.match(/}/g) || []).length;
+            if (braceCount === 0 && relevant.length > 1) {
+                // End of block
+                return relevant.join('\n');
+            }
+        }
+    }
+    return relevant.length > 0 ? relevant.join('\n') : null;
+}
+/**
+ * Extract symbol names from query
+ */
+function extractSymbolsFromQuery(query) {
+    const patterns = [
+        /function\s+(\w+)/gi,
+        /class\s+(\w+)/gi,
+        /interface\s+(\w+)/gi,
+        /type\s+(\w+)/gi,
+        /([A-Z][a-zA-Z0-9]+)/g,
+        /([a-z][a-zA-Z0-9]*\(\))/g,
+    ];
+    const symbols = new Set();
+    for (const pattern of patterns) {
+        const matches = query.matchAll(pattern);
+        for (const match of matches) {
+            if (match[1]) {
+                symbols.add(match[1]);
+            }
+        }
+    }
+    return Array.from(symbols);
+}
+/**
+ * Compress code by removing comments and whitespace
+ */
+function compressCode(code) {
+    return code
+        // Remove single-line comments
+        .replace(/\/\/.*$/gm, '')
+        // Remove multi-line comments
+        .replace(/\/\*[\s\S]*?\*\//g, '')
+        // Remove excessive whitespace
+        .replace(/\n\s*\n\s*\n/g, '\n\n')
+        // Trim lines
+        .split('\n')
+        .map(line => line.trim())
+        .filter(line => line.length > 0)
+        .join('\n');
+}
+/**
+ * Truncate text to fit token limit
+ */
+function truncateToTokens(text, maxTokens) {
+    const tokens = enc.encode(text);
+    if (tokens.length <= maxTokens) {
+        return text;
+    }
+    const truncatedTokens = tokens.slice(0, maxTokens - 10); // Leave room for "..."
+    const decoded = enc.decode(truncatedTokens);
+    const decodedText = typeof decoded === 'string'
+        ? decoded
+        : new TextDecoder().decode(decoded);
+    return decodedText + '...';
+}
+/**
+ * Deduplicate chunks
+ */
+export function deduplicateChunks(chunks) {
+    const seen = new Set();
+    const unique = [];
+    for (const chunk of chunks) {
+        // Create a key from filepath and content hash
+        const key = `${chunk.filepath}:${chunk.content.substring(0, 100)}`;
+        if (!seen.has(key)) {
+            seen.add(key);
+            unique.push(chunk);
+        }
+    }
+    return unique;
+}
+//# sourceMappingURL=token-optimizer.js.map

package/dist/token-optimizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-optimizer.js","sourceRoot":"","sources":["../src/token-optimizer.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"}