attocode 0.1.0

package/dist/src/tools/bash.js

@@ -0,0 +1,141 @@
+/**
+ * Lesson 3: Bash Tool
+ *
+ * Tool for executing shell commands with safety checks.
+ */
+import { z } from 'zod';
+import { spawn } from 'node:child_process';
+import { defineTool } from './registry.js';
+import { classifyCommand } from './permission.js';
+// =============================================================================
+// BASH COMMAND TOOL
+// =============================================================================
+const bashSchema = z.object({
+    command: z.string().describe('The bash command to execute'),
+    cwd: z.string().optional().describe('Working directory (default: current directory)'),
+    timeout: z.coerce.number().optional().default(30000).describe('Timeout in milliseconds'),
+});
+/**
+ * Execute a bash command.
+ *
+ * Key safety features:
+ * 1. Danger classification for permission checking
+ * 2. Timeout to prevent hanging
+ * 3. Output capture with size limits
+ * 4. Non-interactive execution
+ */
+export const bashTool = defineTool('bash', 'Execute a bash command and return the output', bashSchema, async (input) => {
+    // Classify the command's danger level
+    const { level, reasons } = classifyCommand(input.command);
+    // Add warning to output for dangerous commands
+    let warning = '';
+    if (reasons.length > 0) {
+        warning = `⚠️  Detected: ${reasons.join(', ')}\n\n`;
+    }
+    return new Promise((resolve) => {
+        const proc = spawn('bash', ['-c', input.command], {
+            cwd: input.cwd || process.cwd(),
+            env: { ...process.env, TERM: 'dumb' }, // Disable colors/formatting
+            stdio: ['ignore', 'pipe', 'pipe'], // No stdin, capture stdout/stderr
+        });
+        let stdout = '';
+        let stderr = '';
+        let killed = false;
+        const maxOutput = 100000; // 100KB limit
+        // Set timeout with proper cleanup
+        const timer = setTimeout(() => {
+            killed = true;
+            proc.kill('SIGTERM');
+            // Escalate to SIGKILL after 1 second
+            setTimeout(() => {
+                if (!proc.killed) {
+                    proc.kill('SIGKILL');
+                    // Verify termination after SIGKILL, attempt process group kill if needed
+                    setTimeout(() => {
+                        if (!proc.killed && proc.pid) {
+                            console.warn(`[Bash] Process ${proc.pid} may be zombie after SIGKILL, attempting process group kill`);
+                            try {
+                                // Try to kill the entire process group (negative PID)
+                                process.kill(-proc.pid, 'SIGKILL');
+                            }
+                            catch {
+                                // Ignore errors - process may already be dead or we lack permissions
+                            }
+                        }
+                    }, 2000);
+                }
+            }, 1000);
+        }, input.timeout);
+        // Capture stdout
+        proc.stdout?.on('data', (data) => {
+            if (stdout.length < maxOutput) {
+                stdout += data.toString();
+            }
+        });
+        // Capture stderr
+        proc.stderr?.on('data', (data) => {
+            if (stderr.length < maxOutput) {
+                stderr += data.toString();
+            }
+        });
+        // Handle completion
+        proc.on('close', (code) => {
+            clearTimeout(timer);
+            if (killed) {
+                resolve({
+                    success: false,
+                    output: `${warning}Command timed out after ${input.timeout}ms`,
+                    metadata: { timedOut: true, dangerLevel: level },
+                });
+                return;
+            }
+            const output = stdout + (stderr ? `\n--- stderr ---\n${stderr}` : '');
+            const truncated = output.length > maxOutput;
+            const finalOutput = truncated
+                ? output.slice(0, maxOutput) + '\n... (output truncated)'
+                : output;
+            resolve({
+                success: code === 0,
+                output: warning + (finalOutput || '(no output)'),
+                metadata: {
+                    exitCode: code,
+                    dangerLevel: level,
+                    truncated,
+                },
+            });
+        });
+        // Handle errors
+        proc.on('error', (error) => {
+            clearTimeout(timer);
+            resolve({
+                success: false,
+                output: `${warning}Failed to execute command: ${error.message}`,
+                metadata: { dangerLevel: level },
+            });
+        });
+    });
+}, 
+// Danger level is determined dynamically, but default to moderate
+'moderate');
+// =============================================================================
+// SPECIALIZED BASH COMMANDS
+// =============================================================================
+const grepSchema = z.object({
+    pattern: z.string().describe('Regex pattern to search for'),
+    path: z.string().describe('File or directory to search in'),
+    recursive: z.boolean().optional().default(false).describe('Search recursively'),
+});
+export const grepTool = defineTool('grep', 'Search for a pattern in files', grepSchema, async (input) => {
+    const flags = input.recursive ? '-rn' : '-n';
+    const command = `grep ${flags} "${input.pattern}" "${input.path}" || true`;
+    return bashTool.execute({ command, timeout: 10000 });
+}, 'safe');
+const globSchema = z.object({
+    pattern: z.string().describe('Glob pattern to match files'),
+    path: z.string().optional().default('.').describe('Directory to search in'),
+});
+export const globTool = defineTool('glob', 'Find files matching a glob pattern', globSchema, async (input) => {
+    const command = `find "${input.path}" -name "${input.pattern}" 2>/dev/null | head -100`;
+    return bashTool.execute({ command, timeout: 10000 });
+}, 'safe');
+//# sourceMappingURL=bash.js.map

package/dist/src/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/src/tools/file.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Lesson 3: File Tools
+ *
+ * Tools for file system operations.
+ */
+import { z } from 'zod';
+export declare const readFileTool: import("./types.js").ToolDefinition<z.ZodObject<{
+    path: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+}, {
+    path: string;
+}>>;
+export declare const writeFileTool: import("./types.js").ToolDefinition<z.ZodObject<{
+    path: z.ZodString;
+    content: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    content: string;
+}, {
+    path: string;
+    content: string;
+}>>;
+export declare const editFileTool: import("./types.js").ToolDefinition<z.ZodObject<{
+    path: z.ZodString;
+    old_string: z.ZodString;
+    new_string: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    old_string: string;
+    new_string: string;
+}, {
+    path: string;
+    old_string: string;
+    new_string: string;
+}>>;
+export declare const listFilesTool: import("./types.js").ToolDefinition<z.ZodObject<{
+    path: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    recursive: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    recursive: boolean;
+}, {
+    path?: string | undefined;
+    recursive?: boolean | undefined;
+}>>;
+//# sourceMappingURL=file.d.ts.map

package/dist/src/tools/file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../../src/tools/file.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAcxB,eAAO,MAAM,YAAY;;;;;;GAyBxB,CAAC;AA0CF,eAAO,MAAM,aAAa;;;;;;;;;GAqCzB,CAAC;AAYF,eAAO,MAAM,YAAY;;;;;;;;;;;;GAmDxB,CAAC;AAWF,eAAO,MAAM,aAAa;;;;;;;;;GAuCzB,CAAC"}

package/dist/src/tools/file.js

@@ -0,0 +1,263 @@
+/**
+ * Lesson 3: File Tools
+ *
+ * Tools for file system operations.
+ */
+import { z } from 'zod';
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { defineTool } from './registry.js';
+// =============================================================================
+// READ FILE
+// =============================================================================
+const readFileSchema = z.object({
+    path: z.string().describe('Path to the file to read'),
+});
+export const readFileTool = defineTool('read_file', 'Read the contents of a file at the given path', readFileSchema, async (input) => {
+    try {
+        const content = await fs.readFile(input.path, 'utf-8');
+        const lines = content.split('\n').length;
+        return {
+            success: true,
+            output: content,
+            metadata: { lines, bytes: content.length },
+        };
+    }
+    catch (error) {
+        const err = error;
+        if (err.code === 'ENOENT') {
+            return { success: false, output: `File not found: ${input.path}` };
+        }
+        if (err.code === 'EACCES') {
+            return { success: false, output: `Permission denied: ${input.path}` };
+        }
+        return { success: false, output: `Error reading file: ${err.message}` };
+    }
+}, 'safe');
+// =============================================================================
+// WRITE FILE
+// =============================================================================
+/**
+ * Atomic file write helper.
+ * Writes to a temp file first, then renames to target path.
+ * This prevents partial writes from corrupting files on disk full or crash.
+ */
+async function writeFileAtomic(filePath, content) {
+    const tempPath = `${filePath}.tmp.${Date.now()}.${Math.random().toString(36).slice(2, 8)}`;
+    try {
+        // Write to temp file
+        await fs.writeFile(tempPath, content, 'utf-8');
+        // Atomic rename (on same filesystem)
+        await fs.rename(tempPath, filePath);
+    }
+    catch (err) {
+        // Clean up temp file on failure
+        try {
+            await fs.unlink(tempPath);
+        }
+        catch {
+            // Ignore cleanup errors - temp file may not exist
+        }
+        // Re-throw with specific error for disk full
+        const nodeErr = err;
+        if (nodeErr.code === 'ENOSPC') {
+            throw new Error(`Disk full - cannot write file: ${filePath}`);
+        }
+        throw err;
+    }
+}
+const writeFileSchema = z.object({
+    path: z.string().describe('Path to the file to write'),
+    content: z.string().describe('Content to write to the file'),
+});
+export const writeFileTool = defineTool('write_file', 'Write content to a file (creates or overwrites)', writeFileSchema, async (input) => {
+    try {
+        // Ensure directory exists
+        const dir = path.dirname(input.path);
+        await fs.mkdir(dir, { recursive: true });
+        // Check if file exists
+        let action = 'created';
+        try {
+            await fs.access(input.path);
+            action = 'overwrote';
+        }
+        catch {
+            // File doesn't exist, that's fine
+        }
+        // Use atomic write to prevent corruption
+        await writeFileAtomic(input.path, input.content);
+        const lines = input.content.split('\n').length;
+        return {
+            success: true,
+            output: `Successfully ${action} ${input.path} (${lines} lines, ${input.content.length} bytes)`,
+            metadata: { action, lines, bytes: input.content.length },
+        };
+    }
+    catch (error) {
+        const err = error;
+        if (err.code === 'ENOSPC' || err.message.includes('Disk full')) {
+            return { success: false, output: `Disk full - cannot write file: ${input.path}` };
+        }
+        return { success: false, output: `Error writing file: ${err.message}` };
+    }
+}, 'moderate');
+// =============================================================================
+// EDIT FILE (str_replace style)
+// =============================================================================
+const editFileSchema = z.object({
+    path: z.string().describe('Path to the file to edit'),
+    old_string: z.string().describe('Exact string to find (must be unique in file)'),
+    new_string: z.string().describe('String to replace it with'),
+});
+export const editFileTool = defineTool('edit_file', 'Make a surgical edit by replacing a unique string in a file', editFileSchema, async (input) => {
+    try {
+        // Read file
+        const content = await fs.readFile(input.path, 'utf-8');
+        // Count occurrences
+        const regex = new RegExp(escapeRegExp(input.old_string), 'g');
+        const matches = content.match(regex);
+        const count = matches?.length ?? 0;
+        if (count === 0) {
+            return {
+                success: false,
+                output: `String not found in ${input.path}. Make sure old_string exactly matches the file content, including whitespace.`,
+            };
+        }
+        if (count > 1) {
+            return {
+                success: false,
+                output: `String found ${count} times in ${input.path}. The old_string must be unique. Include more surrounding context.`,
+            };
+        }
+        // Replace and write atomically
+        const newContent = content.replace(input.old_string, input.new_string);
+        await writeFileAtomic(input.path, newContent);
+        const linesDiff = input.new_string.split('\n').length - input.old_string.split('\n').length;
+        return {
+            success: true,
+            output: `Successfully edited ${input.path} (${linesDiff >= 0 ? '+' : ''}${linesDiff} lines)`,
+            metadata: { linesDiff },
+        };
+    }
+    catch (error) {
+        const err = error;
+        if (err.code === 'ENOENT') {
+            return { success: false, output: `File not found: ${input.path}` };
+        }
+        if (err.code === 'ENOSPC' || err.message.includes('Disk full')) {
+            return { success: false, output: `Disk full - cannot edit file: ${input.path}` };
+        }
+        return { success: false, output: `Error editing file: ${err.message}` };
+    }
+}, 'moderate');
+// =============================================================================
+// LIST FILES
+// =============================================================================
+const listFilesSchema = z.object({
+    path: z.string().optional().default('.').describe('Directory path to list'),
+    recursive: z.boolean().optional().default(false).describe('List recursively'),
+});
+export const listFilesTool = defineTool('list_files', 'List files and directories at the given path', listFilesSchema, async (input) => {
+    try {
+        if (input.recursive) {
+            const files = await listRecursive(input.path);
+            return {
+                success: true,
+                output: files.length > 0 ? files.join('\n') : '(empty directory)',
+                metadata: { count: files.length },
+            };
+        }
+        const entries = await fs.readdir(input.path, { withFileTypes: true });
+        const formatted = entries
+            .sort((a, b) => {
+            // Directories first, then files
+            if (a.isDirectory() && !b.isDirectory())
+                return -1;
+            if (!a.isDirectory() && b.isDirectory())
+                return 1;
+            return a.name.localeCompare(b.name);
+        })
+            .map(e => `${e.isDirectory() ? '📁' : '📄'} ${e.name}`);
+        return {
+            success: true,
+            output: formatted.length > 0 ? formatted.join('\n') : '(empty directory)',
+            metadata: { count: entries.length },
+        };
+    }
+    catch (error) {
+        const err = error;
+        if (err.code === 'ENOENT') {
+            return { success: false, output: `Directory not found: ${input.path}` };
+        }
+        return { success: false, output: `Error listing directory: ${err.message}` };
+    }
+}, 'safe');
+// =============================================================================
+// HELPERS
+// =============================================================================
+function escapeRegExp(string) {
+    return string.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+// Directories to always skip (huge/binary/irrelevant)
+const SKIP_DIRS = new Set([
+    'node_modules',
+    '.git',
+    '.next',
+    '.nuxt',
+    'dist',
+    'build',
+    '.cache',
+    '.parcel-cache',
+    '__pycache__',
+    '.pytest_cache',
+    'venv',
+    '.venv',
+    'env',
+    '.env',
+    'vendor',
+    'target',
+    '.idea',
+    '.vscode',
+    'coverage',
+    '.nyc_output',
+    '.turbo',
+    '.svelte-kit',
+    'out',
+    '.output',
+]);
+// Max files to return (prevents massive outputs)
+const MAX_RECURSIVE_FILES = 500;
+async function listRecursive(dir, prefix = '', count = { value: 0 }) {
+    const results = [];
+    // Stop if we've hit the limit
+    if (count.value >= MAX_RECURSIVE_FILES) {
+        return results;
+    }
+    const entries = await fs.readdir(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        // Skip hidden files and excluded directories
+        if (entry.name.startsWith('.') && entry.isDirectory())
+            continue;
+        if (entry.isDirectory() && SKIP_DIRS.has(entry.name))
+            continue;
+        const fullPath = path.join(prefix, entry.name);
+        if (entry.isDirectory()) {
+            results.push(`📁 ${fullPath}/`);
+            count.value++;
+            if (count.value < MAX_RECURSIVE_FILES) {
+                const subEntries = await listRecursive(path.join(dir, entry.name), fullPath, count);
+                results.push(...subEntries);
+            }
+        }
+        else {
+            results.push(`📄 ${fullPath}`);
+            count.value++;
+        }
+        if (count.value >= MAX_RECURSIVE_FILES) {
+            results.push(`\n... [Limit reached: ${MAX_RECURSIVE_FILES} files shown. Use specific paths to see more.]`);
+            break;
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=file.js.map

package/dist/src/tools/file.js.map

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

package/dist/src/tools/permission.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Lesson 3: Permission System
+ *
+ * Controls what operations the agent can perform.
+ */
+import type { PermissionChecker, PermissionRequest, PermissionResponse, PermissionMode, DangerLevel, DangerPattern } from './types.js';
+/**
+ * Create a permission checker for the given mode.
+ */
+export declare function createPermissionChecker(mode?: PermissionMode): PermissionChecker;
+/**
+ * Classify the danger level of a bash command.
+ */
+export declare function classifyCommand(command: string): {
+    level: DangerLevel;
+    reasons: string[];
+};
+/**
+ * Add a custom danger pattern.
+ */
+export declare function addDangerPattern(pattern: DangerPattern): void;
+/**
+ * Check if a command matches any danger patterns.
+ */
+export declare function isDangerous(command: string): boolean;
+import type { TUIApprovalBridge } from '../adapters.js';
+/**
+ * TUI Permission Checker
+ *
+ * Routes permission requests through the TUI approval dialog.
+ * This replaces the console-based InteractivePermissionChecker when in TUI mode.
+ *
+ * Key behaviors:
+ * - Safe operations: auto-approve
+ * - Moderate/dangerous/critical: route to TUI dialog
+ * - Safety fallback: block if bridge not connected
+ */
+export declare class TUIPermissionChecker implements PermissionChecker {
+    private bridge;
+    constructor(bridge: TUIApprovalBridge);
+    check(request: PermissionRequest): Promise<PermissionResponse>;
+}
+//# sourceMappingURL=permission.d.ts.map

package/dist/src/tools/permission.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permission.d.ts","sourceRoot":"","sources":["../../../src/tools/permission.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,EACd,WAAW,EACX,aAAa,EACd,MAAM,YAAY,CAAC;AA2HpB;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,CAAC,EAAE,cAAc,GAAG,iBAAiB,CAchF;AAMD;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAqB1F;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAE7D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAGpD;AAMD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD;;;;;;;;;;GAUG;AACH,qBAAa,oBAAqB,YAAW,iBAAiB;IAChD,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,iBAAiB;IAEvC,KAAK,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAqCrE"}