attocode 0.2.3 → 0.2.5

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

@@ -0,0 +1,410 @@
+/**
+ * Lesson 23: Hooks Integration
+ *
+ * Integrates the hook system (Lesson 10-11) into the production agent.
+ * Provides event emission and interception capabilities.
+ */
+import { logger } from './logger.js';
+import { spawn } from 'node:child_process';
+/**
+ * Manages hooks and plugins for the agent.
+ */
+export class HookManager {
+    hooks = new Map();
+    plugins = new Map();
+    tools = new Map();
+    listeners = new Set();
+    config;
+    // Async hook tracking for error handling and cleanup
+    pendingHooks = new Set();
+    hookErrors = [];
+    errorListeners = new Set();
+    maxHookErrors = 100; // Bounded error history
+    constructor(hooksConfig, pluginsConfig) {
+        this.config = { hooks: hooksConfig, plugins: pluginsConfig };
+        this.initializeBuiltInHooks();
+    }
+    /**
+     * Initialize built-in hooks based on config.
+     */
+    initializeBuiltInHooks() {
+        const builtIn = this.config.hooks.builtIn || {};
+        if (builtIn.logging) {
+            this.registerHook({
+                event: 'llm.before',
+                handler: (data) => {
+                    const d = data;
+                    logger.debug('Hook: LLM call starting', { model: d.model || 'unknown' });
+                },
+                priority: 100,
+            });
+            this.registerHook({
+                event: 'tool.before',
+                handler: (data) => {
+                    const d = data;
+                    logger.debug('Hook: Tool call', { tool: d.tool || 'unknown' });
+                },
+                priority: 100,
+            });
+        }
+        if (builtIn.timing) {
+            const startTimes = new Map();
+            this.registerHook({
+                event: 'llm.before',
+                handler: () => {
+                    startTimes.set('llm', Date.now());
+                },
+                priority: 99,
+            });
+            this.registerHook({
+                event: 'llm.after',
+                handler: () => {
+                    const start = startTimes.get('llm');
+                    if (start) {
+                        logger.debug('Hook: LLM call completed', { durationMs: Date.now() - start });
+                        startTimes.delete('llm');
+                    }
+                },
+                priority: 99,
+            });
+        }
+        // Register custom hooks from config
+        for (const hook of this.config.hooks.custom || []) {
+            this.registerHook(hook);
+        }
+        this.registerShellHooks();
+    }
+    registerShellHooks() {
+        const shellCfg = this.config.hooks.shell;
+        if (!shellCfg?.enabled || !shellCfg.commands?.length) {
+            return;
+        }
+        for (const cmd of shellCfg.commands) {
+            this.registerHook({
+                id: cmd.id || `shell:${cmd.event}:${cmd.command}`,
+                event: cmd.event,
+                priority: cmd.priority ?? 60,
+                handler: (data) => this.executeShellHook(cmd, data),
+            });
+        }
+    }
+    executeShellHook(commandConfig, data) {
+        return new Promise((resolve, reject) => {
+            const shellCfg = this.config.hooks.shell || {};
+            const timeoutMs = commandConfig.timeoutMs ?? shellCfg.defaultTimeoutMs ?? 5000;
+            const baseEnvKeys = ['PATH', 'HOME', 'SHELL', 'TMPDIR', 'USER'];
+            const env = {};
+            for (const key of baseEnvKeys) {
+                const value = process.env[key];
+                if (typeof value === 'string') {
+                    env[key] = value;
+                }
+            }
+            for (const key of shellCfg.envAllowlist || []) {
+                const value = process.env[key];
+                if (typeof value === 'string') {
+                    env[key] = value;
+                }
+            }
+            const child = spawn(commandConfig.command, commandConfig.args || [], {
+                stdio: ['pipe', 'pipe', 'pipe'],
+                env,
+            });
+            const timer = setTimeout(() => {
+                child.kill('SIGTERM');
+                reject(new Error(`Shell hook timed out after ${timeoutMs}ms (${commandConfig.command})`));
+            }, timeoutMs);
+            let stderr = '';
+            child.stderr.on('data', chunk => {
+                stderr += String(chunk);
+            });
+            child.on('error', err => {
+                clearTimeout(timer);
+                reject(err);
+            });
+            child.on('exit', code => {
+                clearTimeout(timer);
+                if (code === 0) {
+                    resolve();
+                    return;
+                }
+                reject(new Error(`Shell hook failed (${commandConfig.command}) exit=${code}${stderr ? `: ${stderr.trim()}` : ''}`));
+            });
+            try {
+                child.stdin.write(JSON.stringify({ event: commandConfig.event, payload: data }));
+            }
+            catch {
+                // Non-serializable payloads are best-effort only.
+            }
+            child.stdin.end();
+        });
+    }
+    /**
+     * Register a hook.
+     */
+    registerHook(hook) {
+        const existing = this.hooks.get(hook.event) || [];
+        // Check for duplicate by ID or handler reference
+        if (hook.id && existing.some((h) => h.id === hook.id)) {
+            logger.warn('Hook already registered', { hookId: hook.id, event: hook.event });
+            return;
+        }
+        if (existing.some((h) => h.handler === hook.handler)) {
+            logger.warn('Duplicate handler already registered', { event: hook.event });
+            return;
+        }
+        existing.push(hook);
+        // Sort by priority (lower = higher priority)
+        existing.sort((a, b) => (a.priority || 50) - (b.priority || 50));
+        this.hooks.set(hook.event, existing);
+    }
+    /**
+     * Unregister a hook.
+     */
+    unregisterHook(event, handler) {
+        const existing = this.hooks.get(event) || [];
+        const index = existing.findIndex((h) => h.handler === handler);
+        if (index !== -1) {
+            existing.splice(index, 1);
+            this.hooks.set(event, existing);
+        }
+    }
+    /**
+     * Execute hooks for an event.
+     */
+    async executeHooks(event, data) {
+        const hooks = this.hooks.get(event) || [];
+        for (const hook of hooks) {
+            try {
+                await hook.handler(data);
+            }
+            catch (err) {
+                logger.error('Hook execution error', { event, error: String(err) });
+            }
+        }
+    }
+    /**
+     * Load and initialize a plugin.
+     */
+    async loadPlugin(plugin) {
+        if (this.plugins.has(plugin.name)) {
+            logger.warn('Plugin already loaded', { plugin: plugin.name });
+            return;
+        }
+        const context = {
+            registerHook: (hook) => this.registerHook(hook),
+            registerTool: (tool) => this.tools.set(tool.name, tool),
+            getConfig: (key) => {
+                // Simple config access
+                return undefined;
+            },
+            log: (level, message) => {
+                logger.info('Plugin log', { plugin: plugin.name, level, message });
+            },
+        };
+        try {
+            await plugin.initialize(context);
+            this.plugins.set(plugin.name, plugin);
+            logger.info('Plugin loaded', { plugin: plugin.name, version: plugin.version });
+        }
+        catch (err) {
+            logger.error('Failed to load plugin', { plugin: plugin.name, error: String(err) });
+            throw err;
+        }
+    }
+    /**
+     * Unload a plugin.
+     */
+    async unloadPlugin(name) {
+        const plugin = this.plugins.get(name);
+        if (!plugin)
+            return;
+        if (plugin.cleanup) {
+            await plugin.cleanup();
+        }
+        this.plugins.delete(name);
+        logger.info('Plugin unloaded', { plugin: name });
+    }
+    /**
+     * Get tools registered by plugins.
+     */
+    getPluginTools() {
+        return Array.from(this.tools.values());
+    }
+    /**
+     * Subscribe to agent events.
+     */
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    }
+    /**
+     * Emit an agent event.
+     * Synchronous listeners are called immediately.
+     * Async hooks are fire-and-forget but errors are tracked.
+     */
+    emit(event) {
+        // Sync listeners (unchanged)
+        for (const listener of this.listeners) {
+            try {
+                listener(event);
+            }
+            catch (err) {
+                logger.error('Event listener error', { error: String(err) });
+            }
+        }
+        // Map agent events to hook events
+        const hookEvent = this.mapToHookEvent(event);
+        if (hookEvent) {
+            // Fire-and-forget WITH error tracking
+            const hookPromise = this.executeHooks(hookEvent, event)
+                .catch((err) => this.recordHookError(hookEvent, err))
+                .finally(() => this.pendingHooks.delete(hookPromise));
+            this.pendingHooks.add(hookPromise);
+        }
+    }
+    /**
+     * Emit an event and wait for all hooks to complete.
+     * Use this for critical events that MUST complete before continuing.
+     */
+    async emitAsync(event) {
+        // Sync listeners
+        for (const listener of this.listeners) {
+            try {
+                listener(event);
+            }
+            catch (err) {
+                logger.error('Event listener error', { error: String(err) });
+            }
+        }
+        // Map agent events to hook events and await
+        const hookEvent = this.mapToHookEvent(event);
+        if (hookEvent) {
+            await this.executeHooks(hookEvent, event);
+        }
+    }
+    /**
+     * Wait for all pending hooks to complete.
+     * Call this before shutdown or when you need to ensure all hooks have finished.
+     */
+    async flush() {
+        if (this.pendingHooks.size === 0) {
+            return;
+        }
+        // Wait for all pending hooks (they already have error handling)
+        await Promise.all(Array.from(this.pendingHooks));
+    }
+    /**
+     * Record a hook error for observability.
+     */
+    recordHookError(event, error) {
+        const hookError = {
+            event,
+            error: error instanceof Error ? error : new Error(String(error)),
+            timestamp: new Date(),
+        };
+        // Add to bounded error history
+        this.hookErrors.push(hookError);
+        if (this.hookErrors.length > this.maxHookErrors) {
+            this.hookErrors.shift();
+        }
+        // Notify error listeners
+        for (const listener of this.errorListeners) {
+            try {
+                listener(hookError);
+            }
+            catch {
+                // Ignore errors in error listeners to prevent cascading failures
+            }
+        }
+        // Always log for visibility
+        logger.error('Hook error', { event, error: hookError.error.message });
+    }
+    /**
+     * Subscribe to hook errors for observability.
+     * Returns an unsubscribe function.
+     */
+    subscribeToErrors(listener) {
+        this.errorListeners.add(listener);
+        return () => this.errorListeners.delete(listener);
+    }
+    /**
+     * Get recent hook errors.
+     */
+    getHookErrors(limit = 10) {
+        return this.hookErrors.slice(-limit);
+    }
+    /**
+     * Get count of pending hooks (for diagnostics).
+     */
+    getPendingHookCount() {
+        return this.pendingHooks.size;
+    }
+    /**
+     * Map agent event to hook event.
+     */
+    mapToHookEvent(event) {
+        switch (event.type) {
+            case 'run.before':
+                return 'run.before';
+            case 'run.after':
+                return 'run.after';
+            case 'iteration.before':
+                return 'iteration.before';
+            case 'iteration.after':
+                return 'iteration.after';
+            case 'completion.before':
+                return 'completion.before';
+            case 'completion.after':
+                return 'completion.after';
+            case 'recovery.before':
+                return 'recovery.before';
+            case 'recovery.after':
+                return 'recovery.after';
+            case 'start':
+                return 'agent.start';
+            case 'complete':
+                return 'agent.end';
+            case 'llm.start':
+                return 'llm.before';
+            case 'llm.complete':
+                return 'llm.after';
+            case 'tool.start':
+                return 'tool.before';
+            case 'tool.complete':
+                return 'tool.after';
+            case 'error':
+                return 'error';
+            default:
+                return null;
+        }
+    }
+    /**
+     * Initialize all configured plugins.
+     */
+    async initializePlugins() {
+        for (const plugin of this.config.plugins.plugins || []) {
+            await this.loadPlugin(plugin);
+        }
+    }
+    /**
+     * Cleanup all plugins and flush pending hooks.
+     */
+    async cleanup() {
+        // Wait for pending hooks to complete
+        await this.flush();
+        // Unload all plugins
+        for (const name of this.plugins.keys()) {
+            await this.unloadPlugin(name);
+        }
+        // Clear error listeners
+        this.errorListeners.clear();
+    }
+}
+// =============================================================================
+// FACTORY
+// =============================================================================
+export function createHookManager(hooksConfig, pluginsConfig) {
+    return new HookManager(hooksConfig, pluginsConfig);
+}
+//# sourceMappingURL=hooks.js.map

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

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

package/dist/src/integrations/utilities/ignore.d.ts

@@ -0,0 +1,143 @@
+/**
+ * .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);
+ */
+/**
+ * Ignore pattern with metadata.
+ */
+export interface IgnorePattern {
+    /** The pattern string */
+    pattern: string;
+    /** Whether this is a negation pattern (starts with !) */
+    negated: boolean;
+    /** Whether pattern is directory-only (ends with /) */
+    directoryOnly: boolean;
+    /** Compiled regex for matching */
+    regex: RegExp;
+    /** Source file */
+    source: string;
+}
+/**
+ * Ignore manager configuration.
+ */
+export interface IgnoreConfig {
+    /** Enable/disable ignore functionality */
+    enabled?: boolean;
+    /** Whether to include .gitignore patterns */
+    includeGitignore?: boolean;
+    /** Whether to include global patterns */
+    includeGlobal?: boolean;
+    /** Additional patterns to include */
+    extraPatterns?: string[];
+}
+/**
+ * Ignore event types.
+ */
+export type IgnoreEvent = {
+    type: 'ignore.loaded';
+    source: string;
+    patternCount: number;
+} | {
+    type: 'ignore.matched';
+    path: string;
+    pattern: string;
+} | {
+    type: 'ignore.error';
+    source: string;
+    error: string;
+};
+export type IgnoreEventListener = (event: IgnoreEvent) => void;
+/**
+ * Manages ignore patterns for file filtering.
+ */
+export declare class IgnoreManager {
+    private config;
+    private patterns;
+    private workspaceRoot;
+    private eventListeners;
+    private loaded;
+    constructor(config?: IgnoreConfig);
+    /**
+     * Load ignore patterns from files.
+     */
+    load(workspaceRoot?: string): Promise<void>;
+    /**
+     * Load patterns from a file.
+     */
+    private loadFromFile;
+    /**
+     * Add patterns programmatically.
+     */
+    addPatterns(patterns: string[], source?: string): void;
+    /**
+     * Check if a path should be ignored.
+     */
+    shouldIgnore(path: string, isDirectory?: boolean): boolean;
+    /**
+     * Filter a list of paths, removing ignored ones.
+     */
+    filterPaths(paths: string[]): string[];
+    /**
+     * Filter paths with directory info.
+     */
+    filterPathsWithStats(paths: string[]): Promise<string[]>;
+    /**
+     * Get all patterns for debugging.
+     */
+    getPatterns(): IgnorePattern[];
+    /**
+     * Check if patterns have been loaded.
+     */
+    isLoaded(): boolean;
+    /**
+     * Clear all patterns.
+     */
+    clear(): void;
+    /**
+     * Reload patterns from files.
+     */
+    reload(): Promise<void>;
+    /**
+     * Subscribe to events.
+     */
+    subscribe(listener: IgnoreEventListener): () => void;
+    /**
+     * Cleanup resources.
+     */
+    cleanup(): void;
+    /**
+     * Normalize a path for matching.
+     */
+    private normalizePath;
+    private emit;
+}
+/**
+ * Create an ignore manager.
+ */
+export declare function createIgnoreManager(config?: IgnoreConfig): IgnoreManager;
+/**
+ * Quick check if a path should be ignored using default patterns.
+ */
+export declare function quickShouldIgnore(path: string): boolean;
+/**
+ * Get sample .agentignore content.
+ */
+export declare function getSampleAgentignore(): string;
+/**
+ * Get built-in patterns for reference.
+ */
+export declare function getBuiltinIgnorePatterns(): string[];
+//# sourceMappingURL=ignore.d.ts.map

package/dist/src/integrations/utilities/ignore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ignore.d.ts","sourceRoot":"","sources":["../../../../src/integrations/utilities/ignore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAUH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,yBAAyB;IACzB,OAAO,EAAE,MAAM,CAAC;IAEhB,yDAAyD;IACzD,OAAO,EAAE,OAAO,CAAC;IAEjB,sDAAsD;IACtD,aAAa,EAAE,OAAO,CAAC;IAEvB,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IAEd,kBAAkB;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,0CAA0C;IAC1C,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,6CAA6C;IAC7C,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B,yCAAyC;IACzC,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB,qCAAqC;IACrC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAC/D;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACzD;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5D,MAAM,MAAM,mBAAmB,GAAG,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;AA6I/D;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,aAAa,CAAyB;IAC9C,OAAO,CAAC,cAAc,CAAuC;IAC7D,OAAO,CAAC,MAAM,CAAkB;gBAEpB,MAAM,GAAE,YAAiB;IAiBrC;;OAEG;IACG,IAAI,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBjD;;OAEG;YACW,YAAY;IAoB1B;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,MAAM,GAAE,MAAiB,GAAG,IAAI;IAShE;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,GAAE,OAAe,GAAG,OAAO;IA6CjE;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE;IAItC;;OAEG;IACG,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAoB9D;;OAEG;IACH,WAAW,IAAI,aAAa,EAAE;IAI9B;;OAEG;IACH,QAAQ,IAAI,OAAO;IAInB;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAO7B;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,mBAAmB,GAAG,MAAM,IAAI;IAKpD;;OAEG;IACH,OAAO,IAAI,IAAI;IAQf;;OAEG;IACH,OAAO,CAAC,aAAa;IAmBrB,OAAO,CAAC,IAAI;CASb;AAMD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,aAAa,CAExE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGvD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAkC7C;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,EAAE,CAEnD"}