attocode 0.1.0

package/dist/src/integrations/hierarchical-config.js

@@ -0,0 +1,484 @@
+/**
+ * Hierarchical Configuration Integration
+ *
+ * Manages configuration that cascades from global to local levels:
+ * - Default (built-in defaults from defaults.ts)
+ * - Global (~/.agent/config.json)
+ * - Workspace (.agent/config.json)
+ * - Session (runtime overrides)
+ *
+ * Higher priority levels override lower ones.
+ * Inspired by VS Code settings hierarchy and adapted from 24-advanced-patterns/hierarchical-state.ts.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { homedir } from 'os';
+// =============================================================================
+// HIERARCHICAL CONFIG MANAGER
+// =============================================================================
+/**
+ * Manages hierarchical configuration for the agent.
+ */
+export class HierarchicalConfigManager {
+    levels = new Map();
+    eventListeners = new Set();
+    resolvedCache = null;
+    options;
+    watchers = [];
+    // Priority order (higher index = higher priority)
+    static PRIORITY = [
+        'default',
+        'global',
+        'workspace',
+        'session',
+        'override',
+    ];
+    constructor(defaults, options = {}) {
+        this.options = {
+            workspaceDir: options.workspaceDir ?? process.cwd(),
+            globalConfigPath: options.globalConfigPath ?? path.join(homedir(), '.agent', 'config.json'),
+            workspaceConfigFile: options.workspaceConfigFile ?? '.agent/config.json',
+            autoLoad: options.autoLoad ?? true,
+            watch: options.watch ?? false,
+        };
+        // Set up default level
+        if (defaults) {
+            this.setLevel('default', defaults, 'built-in');
+        }
+        // Auto-load if enabled
+        if (this.options.autoLoad) {
+            this.loadAll();
+        }
+    }
+    // ===========================================================================
+    // LEVEL MANAGEMENT
+    // ===========================================================================
+    /**
+     * Set configuration at a specific level.
+     */
+    setLevel(level, values, source) {
+        const config = {
+            level,
+            values,
+            source,
+            loadedAt: new Date(),
+        };
+        const oldConfig = this.levels.get(level);
+        this.levels.set(level, config);
+        this.resolvedCache = null;
+        this.emit({ type: 'config.loaded', level, source: source || 'unknown' });
+        // Emit change events for affected keys
+        if (oldConfig) {
+            for (const key of Object.keys(values)) {
+                if (values[key] !== oldConfig.values[key]) {
+                    this.emit({
+                        type: 'config.changed',
+                        key,
+                        oldValue: oldConfig.values[key],
+                        newValue: values[key],
+                        level,
+                    });
+                }
+            }
+        }
+    }
+    /**
+     * Get configuration at a specific level.
+     */
+    getLevel(level) {
+        return this.levels.get(level);
+    }
+    /**
+     * Update specific keys at a level.
+     */
+    updateLevel(level, updates) {
+        const existing = this.levels.get(level);
+        const values = existing ? { ...existing.values, ...updates } : updates;
+        this.setLevel(level, values, existing?.source);
+    }
+    // ===========================================================================
+    // SESSION OVERRIDES
+    // ===========================================================================
+    /**
+     * Set a session override (highest priority besides explicit override).
+     */
+    setSessionOverride(key, value) {
+        const session = this.levels.get('session') || {
+            level: 'session',
+            values: {},
+            loadedAt: new Date(),
+        };
+        const oldValue = session.values[key];
+        session.values[key] = value;
+        this.levels.set('session', session);
+        this.resolvedCache = null;
+        if (oldValue !== value) {
+            this.emit({
+                type: 'config.changed',
+                key: key,
+                oldValue,
+                newValue: value,
+                level: 'session',
+            });
+        }
+    }
+    /**
+     * Clear a session override.
+     */
+    clearSessionOverride(key) {
+        const session = this.levels.get('session');
+        if (session && key in session.values) {
+            const oldValue = session.values[key];
+            delete session.values[key];
+            this.resolvedCache = null;
+            this.emit({
+                type: 'config.changed',
+                key: key,
+                oldValue,
+                newValue: undefined,
+                level: 'session',
+            });
+        }
+    }
+    /**
+     * Clear all session overrides.
+     */
+    clearSessionOverrides() {
+        this.levels.delete('session');
+        this.resolvedCache = null;
+    }
+    // ===========================================================================
+    // RESOLUTION
+    // ===========================================================================
+    /**
+     * Resolve the complete configuration by merging all levels.
+     */
+    resolve() {
+        if (this.resolvedCache) {
+            return this.resolvedCache;
+        }
+        const config = {};
+        const sources = {};
+        const contributingLevels = new Set();
+        // Merge in priority order (lowest to highest)
+        for (const level of HierarchicalConfigManager.PRIORITY) {
+            const levelConfig = this.levels.get(level);
+            if (!levelConfig)
+                continue;
+            contributingLevels.add(level);
+            for (const [key, value] of Object.entries(levelConfig.values)) {
+                if (value !== undefined) {
+                    config[key] = value;
+                    sources[key] = level;
+                }
+            }
+        }
+        const resolved = {
+            config: config,
+            sources,
+            levels: Array.from(contributingLevels),
+            resolvedAt: new Date(),
+        };
+        this.resolvedCache = resolved;
+        this.emit({ type: 'config.resolved', config: resolved });
+        return resolved;
+    }
+    /**
+     * Get a specific configuration value.
+     */
+    get(key) {
+        const resolved = this.resolve();
+        return resolved.config[key];
+    }
+    /**
+     * Get a value with a default fallback.
+     */
+    getWithDefault(key, defaultValue) {
+        const value = this.get(key);
+        return value !== undefined ? value : defaultValue;
+    }
+    /**
+     * Get which level a value came from.
+     */
+    getSource(key) {
+        const resolved = this.resolve();
+        return resolved.sources[key];
+    }
+    /**
+     * Get the resolved config object.
+     */
+    getConfig() {
+        return this.resolve().config;
+    }
+    // ===========================================================================
+    // FILE LOADING
+    // ===========================================================================
+    /**
+     * Load global configuration from file.
+     */
+    loadGlobal() {
+        return this.loadFromFile(this.options.globalConfigPath, 'global');
+    }
+    /**
+     * Load workspace configuration from file.
+     */
+    loadWorkspace() {
+        const configPath = path.join(this.options.workspaceDir, this.options.workspaceConfigFile);
+        return this.loadFromFile(configPath, 'workspace');
+    }
+    /**
+     * Load configuration from a file.
+     */
+    loadFromFile(filePath, level) {
+        try {
+            if (!fs.existsSync(filePath)) {
+                return false;
+            }
+            const content = fs.readFileSync(filePath, 'utf-8');
+            const values = JSON.parse(content);
+            this.setLevel(level, values, filePath);
+            // Set up watching if enabled
+            if (this.options.watch) {
+                this.watchFile(filePath, level);
+            }
+            return true;
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            this.emit({ type: 'config.error', level, error: `Failed to load ${filePath}: ${message}` });
+            return false;
+        }
+    }
+    /**
+     * Watch a file for changes.
+     */
+    watchFile(filePath, level) {
+        try {
+            const watcher = fs.watch(filePath, (eventType) => {
+                if (eventType === 'change') {
+                    this.loadFromFile(filePath, level);
+                }
+            });
+            this.watchers.push(watcher);
+        }
+        catch {
+            // File might not exist or be unwatchable, ignore
+        }
+    }
+    /**
+     * Save configuration level to a file.
+     */
+    saveToFile(filePath, level) {
+        try {
+            const levelConfig = this.levels.get(level);
+            if (!levelConfig) {
+                return false;
+            }
+            const dir = path.dirname(filePath);
+            if (!fs.existsSync(dir)) {
+                fs.mkdirSync(dir, { recursive: true });
+            }
+            fs.writeFileSync(filePath, JSON.stringify(levelConfig.values, null, 2));
+            return true;
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            this.emit({ type: 'config.error', level, error: `Failed to save to ${filePath}: ${message}` });
+            return false;
+        }
+    }
+    /**
+     * Load all configuration levels from standard locations.
+     */
+    loadAll() {
+        this.loadGlobal();
+        this.loadWorkspace();
+    }
+    /**
+     * Reload all configuration levels.
+     */
+    reload() {
+        // Preserve session and override levels
+        const session = this.levels.get('session');
+        const override = this.levels.get('override');
+        // Clear all except defaults
+        const defaults = this.levels.get('default');
+        this.levels.clear();
+        if (defaults) {
+            this.levels.set('default', defaults);
+        }
+        // Reload from files
+        this.loadAll();
+        // Restore session and override
+        if (session) {
+            this.levels.set('session', session);
+        }
+        if (override) {
+            this.levels.set('override', override);
+        }
+        this.resolvedCache = null;
+    }
+    // ===========================================================================
+    // EVENTS
+    // ===========================================================================
+    /**
+     * Subscribe to configuration events.
+     */
+    subscribe(listener) {
+        this.eventListeners.add(listener);
+        return () => this.eventListeners.delete(listener);
+    }
+    /**
+     * Emit a configuration event.
+     */
+    emit(event) {
+        for (const listener of this.eventListeners) {
+            try {
+                listener(event);
+            }
+            catch {
+                // Ignore listener errors
+            }
+        }
+    }
+    // ===========================================================================
+    // UTILITIES
+    // ===========================================================================
+    /**
+     * Get a diff between two levels.
+     */
+    diff(level1, level2) {
+        const config1 = this.levels.get(level1)?.values || {};
+        const config2 = this.levels.get(level2)?.values || {};
+        const added = [];
+        const removed = [];
+        const changed = [];
+        const allKeys = new Set([...Object.keys(config1), ...Object.keys(config2)]);
+        for (const key of allKeys) {
+            const in1 = key in config1;
+            const in2 = key in config2;
+            if (!in1 && in2) {
+                added.push(key);
+            }
+            else if (in1 && !in2) {
+                removed.push(key);
+            }
+            else if (config1[key] !== config2[key]) {
+                changed.push(key);
+            }
+        }
+        return { added, removed, changed };
+    }
+    /**
+     * Export resolved configuration as JSON string.
+     */
+    exportResolved() {
+        return JSON.stringify(this.resolve().config, null, 2);
+    }
+    /**
+     * Get info about loaded levels.
+     */
+    getLoadedLevels() {
+        return Array.from(this.levels.values()).map((l) => ({
+            level: l.level,
+            source: l.source,
+            loadedAt: l.loadedAt,
+        }));
+    }
+    /**
+     * Reset to defaults only.
+     */
+    reset() {
+        const defaults = this.levels.get('default');
+        this.levels.clear();
+        if (defaults) {
+            this.levels.set('default', defaults);
+        }
+        this.resolvedCache = null;
+    }
+    /**
+     * Cleanup resources (watchers, etc.).
+     */
+    cleanup() {
+        for (const watcher of this.watchers) {
+            watcher.close();
+        }
+        this.watchers = [];
+        this.eventListeners.clear();
+    }
+}
+// =============================================================================
+// FACTORY FUNCTIONS
+// =============================================================================
+/**
+ * Create a hierarchical config manager.
+ */
+export function createHierarchicalConfig(defaults, options) {
+    return new HierarchicalConfigManager(defaults, options);
+}
+/**
+ * Create a config manager and load from standard locations.
+ */
+export function createAndLoadConfig(defaults, workspaceDir) {
+    return new HierarchicalConfigManager(defaults, {
+        workspaceDir,
+        autoLoad: true,
+    });
+}
+// =============================================================================
+// SAMPLE CONFIG
+// =============================================================================
+/**
+ * Get a sample global config for documentation.
+ */
+export function getSampleGlobalConfig() {
+    return {
+        // Model preferences
+        model: 'anthropic/claude-sonnet-4',
+        maxIterations: 50,
+        timeout: 300000,
+        // Feature toggles
+        memory: { enabled: true },
+        planning: { enabled: true, autoplan: true },
+        reflection: { enabled: true },
+        // Safety settings
+        sandbox: {
+            enabled: true,
+            allowedCommands: ['node', 'npm', 'npx', 'git', 'ls', 'cat'],
+        },
+        humanInLoop: { enabled: true, riskThreshold: 'high' },
+        // Resource limits
+        resources: {
+            maxMemoryMB: 512,
+            maxCpuTimeSec: 300,
+        },
+    };
+}
+/**
+ * Get a sample workspace config for documentation.
+ */
+export function getSampleWorkspaceConfig() {
+    return {
+        // Project-specific overrides
+        systemPrompt: 'You are a helpful assistant working on this specific project.',
+        // Project-specific tool allowlists
+        sandbox: {
+            allowedPaths: ['.', './src', './tests'],
+            allowedCommands: ['npm', 'npx', 'node', 'tsc', 'eslint', 'prettier'],
+        },
+        // Project context
+        rules: {
+            sources: [{ type: 'file', path: 'CLAUDE.md', priority: 1 }],
+        },
+    };
+}
+/**
+ * Ensure config directories exist.
+ */
+export function ensureConfigDirectories() {
+    const globalDir = path.join(homedir(), '.agent');
+    if (!fs.existsSync(globalDir)) {
+        fs.mkdirSync(globalDir, { recursive: true });
+    }
+}
+//# sourceMappingURL=hierarchical-config.js.map

package/dist/src/integrations/hierarchical-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hierarchical-config.js","sourceRoot":"","sources":["../../../src/integrations/hierarchical-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AA0D7B,gFAAgF;AAChF,8BAA8B;AAC9B,gFAAgF;AAEhF;;GAEG;AACH,MAAM,OAAO,yBAAyB;IAC5B,MAAM,GAAkC,IAAI,GAAG,EAAE,CAAC;IAClD,cAAc,GAA6B,IAAI,GAAG,EAAE,CAAC;IACrD,aAAa,GAA6B,IAAI,CAAC;IAC/C,OAAO,CAAsC;IAC7C,QAAQ,GAAmB,EAAE,CAAC;IAEtC,kDAAkD;IAC1C,MAAM,CAAU,QAAQ,GAAkB;QAChD,SAAS;QACT,QAAQ;QACR,WAAW;QACX,SAAS;QACT,UAAU;KACX,CAAC;IAEF,YAAY,QAAqB,EAAE,UAAqC,EAAE;QACxE,IAAI,CAAC,OAAO,GAAG;YACb,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,OAAO,CAAC,GAAG,EAAE;YACnD,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,aAAa,CAAC;YAC3F,mBAAmB,EAAE,OAAO,CAAC,mBAAmB,IAAI,oBAAoB;YACxE,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,IAAI;YAClC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,KAAK;SAC9B,CAAC;QAEF,uBAAuB;QACvB,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,QAAmC,EAAE,UAAU,CAAC,CAAC;QAC5E,CAAC;QAED,uBAAuB;QACvB,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;YAC1B,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,CAAC;IACH,CAAC;IAED,8EAA8E;IAC9E,mBAAmB;IACnB,8EAA8E;IAE9E;;OAEG;IACH,QAAQ,CAAC,KAAkB,EAAE,MAA+B,EAAE,MAAe;QAC3E,MAAM,MAAM,GAAgB;YAC1B,KAAK;YACL,MAAM;YACN,MAAM;YACN,QAAQ,EAAE,IAAI,IAAI,EAAE;SACrB,CAAC;QAEF,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACzC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAC/B,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;QAE1B,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,IAAI,SAAS,EAAE,CAAC,CAAC;QAEzE,uCAAuC;QACvC,IAAI,SAAS,EAAE,CAAC;YACd,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;gBACtC,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;oBAC1C,IAAI,CAAC,IAAI,CAAC;wBACR,IAAI,EAAE,gBAAgB;wBACtB,GAAG;wBACH,QAAQ,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC;wBAC/B,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC;wBACrB,KAAK;qBACN,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,KAAkB;QACzB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,KAAkB,EAAE,OAAyC;QACvE,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACxC,MAAM,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAG,QAAQ,CAAC,MAAM,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;QACvE,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IACjD,CAAC;IAED,8EAA8E;IAC9E,oBAAoB;IACpB,8EAA8E;IAE9E;;OAEG;IACH,kBAAkB,CAAoB,GAAM,EAAE,KAAW;QACvD,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI;YAC5C,KAAK,EAAE,SAAwB;YAC/B,MAAM,EAAE,EAAE;YACV,QAAQ,EAAE,IAAI,IAAI,EAAE;SACrB,CAAC;QAEF,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,GAAa,CAAC,CAAC;QAC/C,OAAO,CAAC,MAAM,CAAC,GAAa,CAAC,GAAG,KAAK,CAAC;QACtC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACpC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;QAE1B,IAAI,QAAQ,KAAK,KAAK,EAAE,CAAC;YACvB,IAAI,CAAC,IAAI,CAAC;gBACR,IAAI,EAAE,gBAAgB;gBACtB,GAAG,EAAE,GAAa;gBAClB,QAAQ;gBACR,QAAQ,EAAE,KAAK;gBACf,KAAK,EAAE,SAAS;aACjB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED;;OAEG;IACH,oBAAoB,CAAC,GAAY;QAC/B,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC3C,IAAI,OAAO,IAAI,GAAG,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACrC,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,GAAa,CAAC,CAAC;YAC/C,OAAO,OAAO,CAAC,MAAM,CAAC,GAAa,CAAC,CAAC;YACrC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;YAC1B,IAAI,CAAC,IAAI,CAAC;gBACR,IAAI,EAAE,gBAAgB;gBACtB,GAAG,EAAE,GAAa;gBAClB,QAAQ;gBACR,QAAQ,EAAE,SAAS;gBACnB,KAAK,EAAE,SAAS;aACjB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED;;OAEG;IACH,qBAAqB;QACnB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC9B,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;IAC5B,CAAC;IAED,8EAA8E;IAC9E,aAAa;IACb,8EAA8E;IAE9E;;OAEG;IACH,OAAO;QACL,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,OAAO,IAAI,CAAC,aAAa,CAAC;QAC5B,CAAC;QAED,MAAM,MAAM,GAA4B,EAAE,CAAC;QAC3C,MAAM,OAAO,GAAgC,EAAE,CAAC;QAChD,MAAM,kBAAkB,GAAqB,IAAI,GAAG,EAAE,CAAC;QAEvD,8CAA8C;QAC9C,KAAK,MAAM,KAAK,IAAI,yBAAyB,CAAC,QAAQ,EAAE,CAAC;YACvD,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YAC3C,IAAI,CAAC,WAAW;gBAAE,SAAS;YAE3B,kBAAkB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YAE9B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC9D,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;oBACxB,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;oBACpB,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;gBACvB,CAAC;YACH,CAAC;QACH,CAAC;QAED,MAAM,QAAQ,GAAsB;YAClC,MAAM,EAAE,MAAW;YACnB,OAAO;YACP,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC;YACtC,UAAU,EAAE,IAAI,IAAI,EAAE;SACvB,CAAC;QAEF,IAAI,CAAC,aAAa,GAAG,QAAQ,CAAC;QAC9B,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;QAEzD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;OAEG;IACH,GAAG,CAAoB,GAAM;QAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QAChC,OAAO,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,cAAc,CAAoB,GAAM,EAAE,YAAkB;QAC1D,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC5B,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC;IACpD,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,GAAY;QACpB,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QAChC,OAAO,QAAQ,CAAC,OAAO,CAAC,GAAa,CAAC,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,SAAS;QACP,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC;IAC/B,CAAC;IAED,8EAA8E;IAC9E,eAAe;IACf,8EAA8E;IAE9E;;OAEG;IACH,UAAU;QACR,OAAO,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,QAAQ,CAAC,CAAC;IACpE,CAAC;IAED;;OAEG;IACH,aAAa;QACX,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;QAC1F,OAAO,IAAI,CAAC,YAAY,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;IACpD,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,QAAgB,EAAE,KAAkB;QAC/C,IAAI,CAAC;YACH,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC7B,OAAO,KAAK,CAAC;YACf,CAAC;YAED,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACnD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAEnC,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;YAEvC,6BAA6B;YAC7B,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;gBACvB,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;YAClC,CAAC;YAED,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,KAAK,EAAE,kBAAkB,QAAQ,KAAK,OAAO,EAAE,EAAE,CAAC,CAAC;YAC5F,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED;;OAEG;IACK,SAAS,CAAC,QAAgB,EAAE,KAAkB;QACpD,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,EAAE;gBAC/C,IAAI,SAAS,KAAK,QAAQ,EAAE,CAAC;oBAC3B,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;gBACrC,CAAC;YACH,CAAC,CAAC,CAAC;YACH,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC9B,CAAC;QAAC,MAAM,CAAC;YACP,iDAAiD;QACnD,CAAC;IACH,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,QAAgB,EAAE,KAAkB;QAC7C,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YAC3C,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,OAAO,KAAK,CAAC;YACf,CAAC;YAED,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YACnC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACxB,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACzC,CAAC;YAED,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YACxE,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,KAAK,EAAE,qBAAqB,QAAQ,KAAK,OAAO,EAAE,EAAE,CAAC,CAAC;YAC/F,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED;;OAEG;IACH,OAAO;QACL,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,IAAI,CAAC,aAAa,EAAE,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,uCAAuC;QACvC,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAE7C,4BAA4B;QAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC5C,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACpB,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QACvC,CAAC;QAED,oBAAoB;QACpB,IAAI,CAAC,OAAO,EAAE,CAAC;QAEf,+BAA+B;QAC/B,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACtC,CAAC;QACD,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QACxC,CAAC;QAED,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;IAC5B,CAAC;IAED,8EAA8E;IAC9E,SAAS;IACT,8EAA8E;IAE9E;;OAEG;IACH,SAAS,CAAC,QAA6B;QACrC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAClC,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACpD,CAAC;IAED;;OAEG;IACK,IAAI,CAAC,KAAkB;QAC7B,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YAC3C,IAAI,CAAC;gBACH,QAAQ,CAAC,KAAK,CAAC,CAAC;YAClB,CAAC;YAAC,MAAM,CAAC;gBACP,yBAAyB;YAC3B,CAAC;QACH,CAAC;IACH,CAAC;IAED,8EAA8E;IAC9E,YAAY;IACZ,8EAA8E;IAE9E;;OAEG;IACH,IAAI,CAAC,MAAmB,EAAE,MAAmB;QAC3C,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,MAAM,IAAI,EAAE,CAAC;QACtD,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,MAAM,IAAI,EAAE,CAAC;QAEtD,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAa,EAAE,CAAC;QAE7B,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAE5E,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;YAC1B,MAAM,GAAG,GAAG,GAAG,IAAI,OAAO,CAAC;YAC3B,MAAM,GAAG,GAAG,GAAG,IAAI,OAAO,CAAC;YAE3B,IAAI,CAAC,GAAG,IAAI,GAAG,EAAE,CAAC;gBAChB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAClB,CAAC;iBAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;gBACvB,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACpB,CAAC;iBAAM,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;gBACzC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACpB,CAAC;QACH,CAAC;QAED,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,cAAc;QACZ,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACxD,CAAC;IAED;;OAEG;IACH,eAAe;QACb,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAClD,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,QAAQ,EAAE,CAAC,CAAC,QAAQ;SACrB,CAAC,CAAC,CAAC;IACN,CAAC;IAED;;OAEG;IACH,KAAK;QACH,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC5C,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACpB,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QACvC,CAAC;QACD,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,OAAO;QACL,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACpC,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,CAAC;QACD,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;QACnB,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;IAC9B,CAAC;;AAGH,gFAAgF;AAChF,oBAAoB;AACpB,gFAAgF;AAEhF;;GAEG;AACH,MAAM,UAAU,wBAAwB,CACtC,QAAqB,EACrB,OAAmC;IAEnC,OAAO,IAAI,yBAAyB,CAAI,QAAQ,EAAE,OAAO,CAAC,CAAC;AAC7D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAAqB,EACrB,YAAqB;IAErB,OAAO,IAAI,yBAAyB,CAAI,QAAQ,EAAE;QAChD,YAAY;QACZ,QAAQ,EAAE,IAAI;KACf,CAAC,CAAC;AACL,CAAC;AAED,gFAAgF;AAChF,gBAAgB;AAChB,gFAAgF;AAEhF;;GAEG;AACH,MAAM,UAAU,qBAAqB;IACnC,OAAO;QACL,oBAAoB;QACpB,KAAK,EAAE,2BAA2B;QAClC,aAAa,EAAE,EAAE;QACjB,OAAO,EAAE,MAAM;QAEf,kBAAkB;QAClB,MAAM,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE;QACzB,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC3C,UAAU,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE;QAE7B,kBAAkB;QAClB,OAAO,EAAE;YACP,OAAO,EAAE,IAAI;YACb,eAAe,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC;SAC5D;QACD,WAAW,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE;QAErD,kBAAkB;QAClB,SAAS,EAAE;YACT,WAAW,EAAE,GAAG;YAChB,aAAa,EAAE,GAAG;SACnB;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB;IACtC,OAAO;QACL,6BAA6B;QAC7B,YAAY,EAAE,+DAA+D;QAE7E,mCAAmC;QACnC,OAAO,EAAE;YACP,YAAY,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,SAAS,CAAC;YACvC,eAAe,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,CAAC;SACrE;QAED,kBAAkB;QAClB,KAAK,EAAE;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;SAC5D;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB;IACrC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC,CAAC;IACjD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9B,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/C,CAAC;AACH,CAAC"}

package/dist/src/integrations/hooks.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Lesson 23: Hooks Integration
+ *
+ * Integrates the hook system (Lesson 10-11) into the production agent.
+ * Provides event emission and interception capabilities.
+ */
+import type { HooksConfig, PluginsConfig, Hook, HookEvent, Plugin, ToolDefinition, AgentEvent, AgentEventListener } from '../types.js';
+/**
+ * Hook error record for observability.
+ */
+export interface HookError {
+    event: HookEvent;
+    error: Error;
+    timestamp: Date;
+    hookId?: string;
+}
+/**
+ * Hook error listener type.
+ */
+export type HookErrorListener = (error: HookError) => void;
+/**
+ * Manages hooks and plugins for the agent.
+ */
+export declare class HookManager {
+    private hooks;
+    private plugins;
+    private tools;
+    private listeners;
+    private config;
+    private pendingHooks;
+    private hookErrors;
+    private errorListeners;
+    private maxHookErrors;
+    constructor(hooksConfig: HooksConfig, pluginsConfig: PluginsConfig);
+    /**
+     * Initialize built-in hooks based on config.
+     */
+    private initializeBuiltInHooks;
+    /**
+     * Register a hook.
+     */
+    registerHook(hook: Hook): void;
+    /**
+     * Unregister a hook.
+     */
+    unregisterHook(event: HookEvent, handler: Hook['handler']): void;
+    /**
+     * Execute hooks for an event.
+     */
+    executeHooks(event: HookEvent, data: unknown): Promise<void>;
+    /**
+     * Load and initialize a plugin.
+     */
+    loadPlugin(plugin: Plugin): Promise<void>;
+    /**
+     * Unload a plugin.
+     */
+    unloadPlugin(name: string): Promise<void>;
+    /**
+     * Get tools registered by plugins.
+     */
+    getPluginTools(): ToolDefinition[];
+    /**
+     * Subscribe to agent events.
+     */
+    subscribe(listener: AgentEventListener): () => void;
+    /**
+     * Emit an agent event.
+     * Synchronous listeners are called immediately.
+     * Async hooks are fire-and-forget but errors are tracked.
+     */
+    emit(event: AgentEvent): void;
+    /**
+     * Emit an event and wait for all hooks to complete.
+     * Use this for critical events that MUST complete before continuing.
+     */
+    emitAsync(event: AgentEvent): Promise<void>;
+    /**
+     * Wait for all pending hooks to complete.
+     * Call this before shutdown or when you need to ensure all hooks have finished.
+     */
+    flush(): Promise<void>;
+    /**
+     * Record a hook error for observability.
+     */
+    private recordHookError;
+    /**
+     * Subscribe to hook errors for observability.
+     * Returns an unsubscribe function.
+     */
+    subscribeToErrors(listener: HookErrorListener): () => void;
+    /**
+     * Get recent hook errors.
+     */
+    getHookErrors(limit?: number): HookError[];
+    /**
+     * Get count of pending hooks (for diagnostics).
+     */
+    getPendingHookCount(): number;
+    /**
+     * Map agent event to hook event.
+     */
+    private mapToHookEvent;
+    /**
+     * Initialize all configured plugins.
+     */
+    initializePlugins(): Promise<void>;
+    /**
+     * Cleanup all plugins and flush pending hooks.
+     */
+    cleanup(): Promise<void>;
+}
+export declare function createHookManager(hooksConfig: HooksConfig, pluginsConfig: PluginsConfig): HookManager;
+//# sourceMappingURL=hooks.d.ts.map

package/dist/src/integrations/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/integrations/hooks.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,aAAa,EACb,IAAI,EACJ,SAAS,EACT,MAAM,EAEN,cAAc,EACd,UAAU,EACV,kBAAkB,EACnB,MAAM,aAAa,CAAC;AAMrB;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,SAAS,CAAC;IACjB,KAAK,EAAE,KAAK,CAAC;IACb,SAAS,EAAE,IAAI,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;AAE3D;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,KAAK,CAAqC;IAClD,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,KAAK,CAA0C;IACvD,OAAO,CAAC,SAAS,CAAsC;IACvD,OAAO,CAAC,MAAM,CAAiD;IAG/D,OAAO,CAAC,YAAY,CAAiC;IACrD,OAAO,CAAC,UAAU,CAAmB;IACrC,OAAO,CAAC,cAAc,CAAqC;IAC3D,OAAO,CAAC,aAAa,CAAO;gBAEhB,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa;IAKlE;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAqD9B;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAmB9B;;OAEG;IACH,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI;IAShE;;OAEG;IACG,YAAY,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAYlE;;OAEG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA4B/C;;OAEG;IACG,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAY/C;;OAEG;IACH,cAAc,IAAI,cAAc,EAAE;IAIlC;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,kBAAkB,GAAG,MAAM,IAAI;IAKnD;;;;OAIG;IACH,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAqB7B;;;OAGG;IACG,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBjD;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAS5B;;OAEG;IACH,OAAO,CAAC,eAAe;IA0BvB;;;OAGG;IACH,iBAAiB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,MAAM,IAAI;IAK1D;;OAEG;IACH,aAAa,CAAC,KAAK,SAAK,GAAG,SAAS,EAAE;IAItC;;OAEG;IACH,mBAAmB,IAAI,MAAM;IAI7B;;OAEG;IACH,OAAO,CAAC,cAAc;IAqBtB;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAMxC;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAY/B;AAMD,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,WAAW,EACxB,aAAa,EAAE,aAAa,GAC3B,WAAW,CAEb"}