attocode 0.1.0

package/dist/src/integrations/hooks.js

@@ -0,0 +1,326 @@
+/**
+ * Lesson 23: Hooks Integration
+ *
+ * Integrates the hook system (Lesson 10-11) into the production agent.
+ * Provides event emission and interception capabilities.
+ */
+/**
+ * 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;
+                    console.log(`[Hook] LLM call starting (model: ${d.model || 'unknown'})`);
+                },
+                priority: 100,
+            });
+            this.registerHook({
+                event: 'tool.before',
+                handler: (data) => {
+                    const d = data;
+                    console.log(`[Hook] Tool call: ${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) {
+                        console.log(`[Hook] LLM call took ${Date.now() - start}ms`);
+                        startTimes.delete('llm');
+                    }
+                },
+                priority: 99,
+            });
+        }
+        // Register custom hooks from config
+        for (const hook of this.config.hooks.custom || []) {
+            this.registerHook(hook);
+        }
+    }
+    /**
+     * 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)) {
+            console.warn(`[Hook] Hook "${hook.id}" already registered for ${hook.event}`);
+            return;
+        }
+        if (existing.some((h) => h.handler === hook.handler)) {
+            console.warn(`[Hook] Duplicate handler already registered for ${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) {
+                console.error(`[Hook] Error in ${event} hook:`, err);
+            }
+        }
+    }
+    /**
+     * Load and initialize a plugin.
+     */
+    async loadPlugin(plugin) {
+        if (this.plugins.has(plugin.name)) {
+            console.warn(`[Plugin] ${plugin.name} already loaded`);
+            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) => {
+                console.log(`[Plugin:${plugin.name}] [${level}] ${message}`);
+            },
+        };
+        try {
+            await plugin.initialize(context);
+            this.plugins.set(plugin.name, plugin);
+            console.log(`[Plugin] Loaded: ${plugin.name} v${plugin.version}`);
+        }
+        catch (err) {
+            console.error(`[Plugin] Failed to load ${plugin.name}:`, 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);
+        console.log(`[Plugin] Unloaded: ${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) {
+                console.error('[Hook] Event listener error:', 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) {
+                console.error('[Hook] Event listener error:', 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 to console for visibility
+        console.error(`[Hook] Error in ${event} hook:`, 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 '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/hooks.js.map

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

package/dist/src/integrations/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/ignore.d.ts.map

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