attocode 0.2.4 → 0.2.5

package/dist/src/integrations/utilities/ignore.js

@@ -0,0 +1,417 @@
+/**
+ * .agentignore Support
+ *
+ * AI-specific file exclusion patterns, separate from .gitignore.
+ * Allows hiding files from the agent that shouldn't be modified or seen,
+ * without affecting git behavior.
+ *
+ * Priority order (highest first):
+ * 1. .agentignore in current directory
+ * 2. .gitignore in current directory
+ * 3. Global ~/.agent/ignore
+ *
+ * Usage:
+ *   const ignore = createIgnoreManager();
+ *   await ignore.load(process.cwd());
+ *   const filtered = ignore.filterPaths(paths);
+ */
+import { readFile, stat } from 'fs/promises';
+import { join, relative, isAbsolute, normalize, sep } from 'path';
+import { homedir } from 'os';
+// =============================================================================
+// GITIGNORE PATTERN COMPILER
+// =============================================================================
+/**
+ * Convert a gitignore-style pattern to a regex.
+ * Implements most of the gitignore specification.
+ */
+function compilePattern(pattern) {
+    // Check if anchored to root (starts with /)
+    const isAnchored = pattern.startsWith('/');
+    // Remove leading and trailing slashes for processing
+    let cleanPattern = pattern;
+    if (isAnchored) {
+        cleanPattern = cleanPattern.slice(1); // Remove leading /
+    }
+    if (cleanPattern.endsWith('/')) {
+        cleanPattern = cleanPattern.slice(0, -1); // Remove trailing /
+    }
+    // Convert gitignore pattern to regex, processing glob patterns before escaping
+    let regexStr = cleanPattern
+        // First, replace ** with a placeholder
+        .replace(/\*\*/g, '\x00GLOBSTAR\x00')
+        // Then replace single *
+        .replace(/\*/g, '\x00STAR\x00')
+        // Then replace ?
+        .replace(/\?/g, '\x00QUESTION\x00')
+        // Escape remaining regex special chars
+        .replace(/[.+^${}()|[\]\\]/g, '\\$&')
+        // Restore glob patterns as regex
+        .replace(/\x00GLOBSTAR\x00/g, '.*')
+        .replace(/\x00STAR\x00/g, '[^/]*')
+        .replace(/\x00QUESTION\x00/g, '[^/]');
+    // Handle the prefix: **/ at start matches any depth including root
+    if (cleanPattern.startsWith('**/')) {
+        // The pattern can match at root level or at any subdirectory
+        // (.*/)? matches optional path prefix, then the rest of the pattern
+        regexStr = '(.*/)?' + regexStr.slice(4); // slice(4) removes the '.*/' from regex
+    }
+    else if (cleanPattern.startsWith('**')) {
+        regexStr = `^${regexStr}`;
+    }
+    else if (!isAnchored) {
+        // Match anywhere in path (at start or after /)
+        regexStr = `(^|/)${regexStr}`;
+    }
+    else {
+        // Anchored to root
+        regexStr = `^${regexStr}`;
+    }
+    // Match at end of path or as a directory prefix
+    regexStr = `${regexStr}(/.*)?$`;
+    return new RegExp(regexStr);
+}
+/**
+ * Parse a pattern line from ignore file.
+ */
+function parsePatternLine(line, source) {
+    // Trim whitespace
+    let pattern = line.trim();
+    // Skip empty lines and comments
+    if (!pattern || pattern.startsWith('#')) {
+        return null;
+    }
+    // Check for negation
+    let negated = false;
+    if (pattern.startsWith('!')) {
+        negated = true;
+        pattern = pattern.slice(1);
+    }
+    // Check for directory-only
+    const directoryOnly = pattern.endsWith('/');
+    // Compile to regex
+    const regex = compilePattern(pattern);
+    return {
+        pattern,
+        negated,
+        directoryOnly,
+        regex,
+        source,
+    };
+}
+// =============================================================================
+// DEFAULT PATTERNS
+// =============================================================================
+/**
+ * Built-in patterns that are always ignored.
+ */
+const BUILTIN_PATTERNS = [
+    // Version control
+    '.git',
+    '.svn',
+    '.hg',
+    // Dependencies
+    'node_modules',
+    '__pycache__',
+    '.venv',
+    'venv',
+    // IDE/Editor
+    '.idea',
+    '.vscode',
+    '*.swp',
+    '*.swo',
+    '*~',
+    // OS files
+    '.DS_Store',
+    'Thumbs.db',
+    // Build outputs (common)
+    'dist',
+    'build',
+    'out',
+    // Sensitive files
+    '.env',
+    '.env.local',
+    '*.pem',
+    '*.key',
+    'credentials.json',
+    'secrets.json',
+];
+// =============================================================================
+// IGNORE MANAGER
+// =============================================================================
+/**
+ * Manages ignore patterns for file filtering.
+ */
+export class IgnoreManager {
+    config;
+    patterns = [];
+    workspaceRoot = process.cwd();
+    eventListeners = new Set();
+    loaded = false;
+    constructor(config = {}) {
+        this.config = {
+            enabled: config.enabled ?? true,
+            includeGitignore: config.includeGitignore ?? true,
+            includeGlobal: config.includeGlobal ?? true,
+            extraPatterns: config.extraPatterns ?? [],
+        };
+        // Add built-in patterns
+        this.addPatterns(BUILTIN_PATTERNS, 'built-in');
+        // Add extra patterns from config
+        if (this.config.extraPatterns.length > 0) {
+            this.addPatterns(this.config.extraPatterns, 'config');
+        }
+    }
+    /**
+     * Load ignore patterns from files.
+     */
+    async load(workspaceRoot) {
+        if (!this.config.enabled)
+            return;
+        this.workspaceRoot = workspaceRoot ?? process.cwd();
+        // Load global patterns first (lowest priority)
+        if (this.config.includeGlobal) {
+            await this.loadFromFile(join(homedir(), '.agent', 'ignore'));
+        }
+        // Load .gitignore (medium priority)
+        if (this.config.includeGitignore) {
+            await this.loadFromFile(join(this.workspaceRoot, '.gitignore'));
+        }
+        // Load .agentignore (highest priority)
+        await this.loadFromFile(join(this.workspaceRoot, '.agentignore'));
+        this.loaded = true;
+    }
+    /**
+     * Load patterns from a file.
+     */
+    async loadFromFile(filePath) {
+        try {
+            const content = await readFile(filePath, 'utf-8');
+            const lines = content.split('\n');
+            let count = 0;
+            for (const line of lines) {
+                const pattern = parsePatternLine(line, filePath);
+                if (pattern) {
+                    this.patterns.push(pattern);
+                    count++;
+                }
+            }
+            this.emit({ type: 'ignore.loaded', source: filePath, patternCount: count });
+        }
+        catch {
+            // File doesn't exist - that's ok
+        }
+    }
+    /**
+     * Add patterns programmatically.
+     */
+    addPatterns(patterns, source = 'manual') {
+        for (const line of patterns) {
+            const pattern = parsePatternLine(line, source);
+            if (pattern) {
+                this.patterns.push(pattern);
+            }
+        }
+    }
+    /**
+     * Check if a path should be ignored.
+     */
+    shouldIgnore(path, isDirectory = false) {
+        if (!this.config.enabled)
+            return false;
+        // Normalize the path
+        let normalizedPath = this.normalizePath(path);
+        // If path ends with /, treat it as a directory
+        if (normalizedPath.endsWith('/')) {
+            isDirectory = true;
+            normalizedPath = normalizedPath.slice(0, -1);
+        }
+        let ignored = false;
+        for (const pattern of this.patterns) {
+            // Skip directory-only patterns for files
+            if (pattern.directoryOnly && !isDirectory) {
+                // However, if the path is inside a directory that matches,
+                // we should still ignore it (e.g., temp/cache matches temp/)
+                const dirPath = normalizedPath.split('/').slice(0, -1).join('/');
+                if (dirPath && pattern.regex.test(dirPath)) {
+                    ignored = true;
+                    this.emit({ type: 'ignore.matched', path, pattern: pattern.pattern });
+                    continue;
+                }
+                continue;
+            }
+            const matches = pattern.regex.test(normalizedPath);
+            if (matches) {
+                if (pattern.negated) {
+                    // Negation pattern - unignore
+                    ignored = false;
+                }
+                else {
+                    // Regular pattern - ignore
+                    ignored = true;
+                    this.emit({ type: 'ignore.matched', path, pattern: pattern.pattern });
+                }
+            }
+        }
+        return ignored;
+    }
+    /**
+     * Filter a list of paths, removing ignored ones.
+     */
+    filterPaths(paths) {
+        return paths.filter(path => !this.shouldIgnore(path));
+    }
+    /**
+     * Filter paths with directory info.
+     */
+    async filterPathsWithStats(paths) {
+        const results = [];
+        for (const path of paths) {
+            try {
+                const stats = await stat(path);
+                if (!this.shouldIgnore(path, stats.isDirectory())) {
+                    results.push(path);
+                }
+            }
+            catch {
+                // File doesn't exist or can't be read - include it
+                if (!this.shouldIgnore(path)) {
+                    results.push(path);
+                }
+            }
+        }
+        return results;
+    }
+    /**
+     * Get all patterns for debugging.
+     */
+    getPatterns() {
+        return [...this.patterns];
+    }
+    /**
+     * Check if patterns have been loaded.
+     */
+    isLoaded() {
+        return this.loaded;
+    }
+    /**
+     * Clear all patterns.
+     */
+    clear() {
+        this.patterns = [];
+        this.loaded = false;
+    }
+    /**
+     * Reload patterns from files.
+     */
+    async reload() {
+        this.patterns = [];
+        this.addPatterns(BUILTIN_PATTERNS, 'built-in');
+        this.addPatterns(this.config.extraPatterns, 'config');
+        await this.load(this.workspaceRoot);
+    }
+    /**
+     * Subscribe to events.
+     */
+    subscribe(listener) {
+        this.eventListeners.add(listener);
+        return () => this.eventListeners.delete(listener);
+    }
+    /**
+     * Cleanup resources.
+     */
+    cleanup() {
+        this.patterns = [];
+        this.eventListeners.clear();
+        this.loaded = false;
+    }
+    // Internal methods
+    /**
+     * Normalize a path for matching.
+     */
+    normalizePath(path) {
+        // Make path relative to workspace root
+        let normalizedPath = path;
+        if (isAbsolute(path)) {
+            normalizedPath = relative(this.workspaceRoot, path);
+        }
+        // Normalize separators to /
+        normalizedPath = normalize(normalizedPath).replace(new RegExp(`\\${sep}`, 'g'), '/');
+        // Remove leading ./
+        if (normalizedPath.startsWith('./')) {
+            normalizedPath = normalizedPath.slice(2);
+        }
+        return normalizedPath;
+    }
+    emit(event) {
+        for (const listener of this.eventListeners) {
+            try {
+                listener(event);
+            }
+            catch {
+                // Ignore listener errors
+            }
+        }
+    }
+}
+// =============================================================================
+// FACTORY FUNCTIONS
+// =============================================================================
+/**
+ * Create an ignore manager.
+ */
+export function createIgnoreManager(config) {
+    return new IgnoreManager(config);
+}
+/**
+ * Quick check if a path should be ignored using default patterns.
+ */
+export function quickShouldIgnore(path) {
+    const manager = new IgnoreManager({ includeGitignore: false, includeGlobal: false });
+    return manager.shouldIgnore(path);
+}
+/**
+ * Get sample .agentignore content.
+ */
+export function getSampleAgentignore() {
+    return `# .agentignore - AI-specific file exclusion
+# Files listed here will be hidden from the AI agent
+# but remain visible to git and other tools
+
+# Large data files that don't need AI analysis
+data/
+*.csv
+*.json.bak
+
+# Generated documentation
+docs/api/
+docs/generated/
+
+# Test fixtures with large data
+tests/fixtures/large/
+
+# Temporary development files
+scratch/
+notes.md
+
+# Sensitive configuration not needed for code changes
+.env.production
+config/secrets/
+
+# Build artifacts already in .gitignore but ensure agent ignores
+coverage/
+.nyc_output/
+
+# IDE project files
+*.code-workspace
+.project
+.classpath
+`;
+}
+/**
+ * Get built-in patterns for reference.
+ */
+export function getBuiltinIgnorePatterns() {
+    return [...BUILTIN_PATTERNS];
+}
+//# sourceMappingURL=ignore.js.map

package/dist/src/integrations/utilities/ignore.js.map

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

package/dist/src/integrations/utilities/image-renderer.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Image Renderer
+ *
+ * Renders images inline in the terminal using the best available protocol.
+ * Supports Kitty, iTerm2/WezTerm, and falls back to block characters.
+ *
+ * @example
+ * ```typescript
+ * const renderer = createImageRenderer();
+ * await renderer.renderFile('/path/to/image.png');
+ * ```
+ */
+/**
+ * Supported terminal image protocols.
+ */
+export type ImageProtocol = 'kitty' | 'iterm' | 'sixel' | 'block' | 'none';
+/**
+ * Image renderer configuration.
+ */
+export interface ImageRendererConfig {
+    /** Force a specific protocol (default: auto-detect) */
+    protocol?: ImageProtocol | 'auto';
+    /** Maximum width in cells (default: 80) */
+    maxWidth?: number;
+    /** Maximum height in cells (default: 24) */
+    maxHeight?: number;
+    /** Preserve aspect ratio (default: true) */
+    preserveAspectRatio?: boolean;
+}
+/**
+ * Image rendering result.
+ */
+export interface ImageRenderResult {
+    /** The escape sequence or text to display */
+    output: string;
+    /** Protocol used for rendering */
+    protocol: ImageProtocol;
+    /** Whether rendering was successful */
+    success: boolean;
+    /** Error message if failed */
+    error?: string;
+}
+/**
+ * Detect the best available image protocol for the current terminal.
+ */
+export declare function detectProtocol(): ImageProtocol;
+/**
+ * Check if a protocol is available.
+ */
+export declare function isProtocolAvailable(protocol: ImageProtocol): boolean;
+/**
+ * Image renderer class.
+ */
+export declare class ImageRenderer {
+    private config;
+    private protocol;
+    constructor(config?: ImageRendererConfig);
+    /**
+     * Get the current protocol.
+     */
+    getProtocol(): ImageProtocol;
+    /**
+     * Check if image rendering is supported.
+     */
+    isSupported(): boolean;
+    /**
+     * Check if a file is a supported image format.
+     */
+    isSupportedFormat(filePath: string): boolean;
+    /**
+     * Render an image from a file path.
+     */
+    renderFile(filePath: string): Promise<ImageRenderResult>;
+    /**
+     * Render an image from a buffer.
+     */
+    renderBuffer(data: Buffer, filename?: string): Promise<ImageRenderResult>;
+    /**
+     * Render using Kitty graphics protocol.
+     * @see https://sw.kovidgoyal.net/kitty/graphics-protocol/
+     */
+    private renderKitty;
+    /**
+     * Render using iTerm2 inline images protocol.
+     * @see https://iterm2.com/documentation-images.html
+     */
+    private renderITerm;
+    /**
+     * Render using Sixel graphics (limited support).
+     * This is a stub - full sixel encoding is complex.
+     */
+    private renderSixel;
+    /**
+     * Render using block characters (fallback).
+     * Uses terminal-image if available.
+     */
+    private renderBlock;
+    /**
+     * Render an image with a caption.
+     */
+    renderWithCaption(filePath: string, caption?: string): Promise<string>;
+}
+/**
+ * Create an image renderer with auto-detected protocol.
+ */
+export declare function createImageRenderer(config?: ImageRendererConfig): ImageRenderer;
+/**
+ * Get protocol info for display.
+ */
+export declare function getProtocolInfo(): {
+    detected: ImageProtocol;
+    terminal: string | undefined;
+    supported: boolean;
+};
+/**
+ * Check if a file can be rendered as an image.
+ */
+export declare function canRenderImage(filePath: string): boolean;
+//# sourceMappingURL=image-renderer.d.ts.map

package/dist/src/integrations/utilities/image-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-renderer.d.ts","sourceRoot":"","sources":["../../../../src/integrations/utilities/image-renderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAUH;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,CAAC;AAE3E;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,uDAAuD;IACvD,QAAQ,CAAC,EAAE,aAAa,GAAG,MAAM,CAAC;IAClC,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,QAAQ,EAAE,aAAa,CAAC;IACxB,uCAAuC;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAWD;;GAEG;AACH,wBAAgB,cAAc,IAAI,aAAa,CA8B9C;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAiBpE;AAMD;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAgC;IAC9C,OAAO,CAAC,QAAQ,CAAgB;gBAEpB,MAAM,GAAE,mBAAwB;IAa5C;;OAEG;IACH,WAAW,IAAI,aAAa;IAI5B;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;OAEG;IACH,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAK5C;;OAEG;IACG,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAgC9D;;OAEG;IACG,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAoB/E;;;OAGG;IACH,OAAO,CAAC,WAAW;IA0BnB;;;OAGG;IACH,OAAO,CAAC,WAAW;IAwBnB;;;OAGG;IACH,OAAO,CAAC,WAAW;IAWnB;;;OAGG;YACW,WAAW;IA0BzB;;OAEG;IACG,iBAAiB,CACrB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC;CAiBnB;AAMD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,CAAC,EAAE,mBAAmB,GAAG,aAAa,CAE/E;AAMD;;GAEG;AACH,wBAAgB,eAAe,IAAI;IACjC,QAAQ,EAAE,aAAa,CAAC;IACxB,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,SAAS,EAAE,OAAO,CAAC;CACpB,CASA;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAGxD"}