agentic-flow 3.0.0-alpha.1 → 3.0.0

package/dist/services/hook-service.js

@@ -1,234 +0,0 @@
-/**
- * HookService - EventEmitter-based hook system with AgentDB integration
- *
- * Provides lifecycle hooks for tool use, session events, task completion,
- * and agent coordination. Automatically feeds learning loops via AgentDB.
- */
-import { EventEmitter } from 'events';
-export class HookService extends EventEmitter {
-    handlers;
-    agentDBService;
-    stats;
-    enabled = true;
-    constructor(agentDBService) {
-        super();
-        this.agentDBService = agentDBService;
-        this.handlers = new Map();
-        this.stats = new Map();
-        this.initializeBuiltInHandlers();
-    }
-    /**
-     * Initialize built-in learning handlers that feed AgentDB
-     */
-    initializeBuiltInHandlers() {
-        // Pattern learning on successful tool use
-        this.register('PostToolUse', async (ctx) => {
-            if (ctx.success && ctx.toolName) {
-                try {
-                    await this.agentDBService.storePattern({
-                        taskType: 'tool_success',
-                        approach: ctx.toolName,
-                        successRate: 1.0,
-                        tags: ['auto-learned', 'tool-use'],
-                        metadata: {
-                            toolName: ctx.toolName,
-                            agentId: ctx.agentId,
-                            timestamp: ctx.timestamp,
-                        },
-                    });
-                }
-                catch {
-                    // Non-critical: pattern storage failure should not break tool execution
-                }
-            }
-        });
-        // Reflexion memory on task completion
-        this.register('TaskCompleted', async (ctx) => {
-            if (ctx.data?.taskId && ctx.data?.result) {
-                try {
-                    await this.agentDBService.storeEpisode({
-                        sessionId: ctx.sessionId || 'unknown',
-                        task: ctx.data.taskId,
-                        input: ctx.data.approach || '',
-                        output: ctx.data.result,
-                        reward: ctx.success ? 1.0 : 0.0,
-                        success: ctx.success ?? false,
-                        tags: ['auto-learned', 'task-completion'],
-                        metadata: {
-                            action: ctx.data.action,
-                            agentId: ctx.agentId,
-                        },
-                    });
-                }
-                catch {
-                    // Non-critical: episode storage failure should not break task flow
-                }
-            }
-        });
-        // Session summary on session end
-        this.register('SessionEnd', async (ctx) => {
-            if (ctx.sessionId) {
-                try {
-                    const hookStats = this.getStats();
-                    const metrics = await this.agentDBService.getMetrics();
-                    await this.agentDBService.storeEpisode({
-                        sessionId: ctx.sessionId,
-                        task: `session_summary:${ctx.sessionId}`,
-                        output: JSON.stringify({ hookStats, metrics }),
-                        reward: 0.5,
-                        success: true,
-                        tags: ['session-summary'],
-                    });
-                }
-                catch {
-                    // Non-critical
-                }
-            }
-        });
-        // Pattern learning on failed tool use for error analysis
-        this.register('PostToolUse', async (ctx) => {
-            if (!ctx.success && ctx.toolName && ctx.error) {
-                try {
-                    await this.agentDBService.storePattern({
-                        taskType: 'tool_failure',
-                        approach: `${ctx.toolName}: ${ctx.error}`,
-                        successRate: 0.0,
-                        tags: ['auto-learned', 'tool-failure'],
-                        metadata: {
-                            toolName: ctx.toolName,
-                            error: ctx.error,
-                            agentId: ctx.agentId,
-                            timestamp: ctx.timestamp,
-                        },
-                    });
-                }
-                catch {
-                    // Non-critical
-                }
-            }
-        });
-    }
-    /**
-     * Register a hook handler for a specific hook type
-     */
-    register(type, handler) {
-        const handlers = this.handlers.get(type) || [];
-        handlers.push(handler);
-        this.handlers.set(type, handlers);
-        return this;
-    }
-    /**
-     * Unregister a specific handler
-     */
-    unregister(type, handler) {
-        const handlers = this.handlers.get(type) || [];
-        const index = handlers.indexOf(handler);
-        if (index !== -1) {
-            handlers.splice(index, 1);
-            this.handlers.set(type, handlers);
-        }
-        return this;
-    }
-    /**
-     * Trigger a hook - executes all registered handlers in parallel
-     */
-    async trigger(type, data, metadata) {
-        if (!this.enabled)
-            return;
-        const ctx = {
-            type,
-            timestamp: Date.now(),
-            data,
-            ...metadata,
-        };
-        // Update stats
-        const stat = this.stats.get(type) || { triggered: 0, lastTrigger: 0, errors: 0 };
-        stat.triggered++;
-        stat.lastTrigger = ctx.timestamp;
-        this.stats.set(type, stat);
-        // Get handlers for this hook type
-        const handlers = this.handlers.get(type) || [];
-        if (handlers.length === 0) {
-            // Still emit even without handlers for EventEmitter subscribers
-            this.emit(type, ctx);
-            return;
-        }
-        // Execute all handlers in parallel with error isolation
-        const results = await Promise.allSettled(handlers.map(handler => handler(ctx)));
-        // Count errors
-        const errors = results.filter(r => r.status === 'rejected').length;
-        if (errors > 0) {
-            stat.errors += errors;
-        }
-        // Emit event for EventEmitter subscribers
-        this.emit(type, ctx);
-    }
-    /**
-     * Enable or disable the hook system
-     */
-    setEnabled(enabled) {
-        this.enabled = enabled;
-    }
-    /**
-     * Check if hook system is enabled
-     */
-    isEnabled() {
-        return this.enabled;
-    }
-    /**
-     * Get hook statistics
-     */
-    getStats() {
-        const stats = {};
-        for (const [type, stat] of this.stats.entries()) {
-            stats[type] = { ...stat };
-        }
-        return stats;
-    }
-    /**
-     * Get stats for a specific hook type
-     */
-    getStatsForType(type) {
-        return { ...(this.stats.get(type) || { triggered: 0, lastTrigger: 0, errors: 0 }) };
-    }
-    /**
-     * Clear all statistics
-     */
-    clearStats() {
-        this.stats.clear();
-    }
-    /**
-     * List registered handler counts by type
-     */
-    listHandlers() {
-        const counts = {};
-        for (const [type, handlers] of this.handlers.entries()) {
-            counts[type] = handlers.length;
-        }
-        return counts;
-    }
-    /**
-     * Get total number of registered handlers
-     */
-    get totalHandlers() {
-        let count = 0;
-        for (const handlers of this.handlers.values()) {
-            count += handlers.length;
-        }
-        return count;
-    }
-    /**
-     * Remove all handlers for a specific hook type
-     */
-    clearHandlers(type) {
-        this.handlers.set(type, []);
-    }
-    /**
-     * Remove all handlers
-     */
-    clearAllHandlers() {
-        this.handlers.clear();
-        this.initializeBuiltInHandlers();
-    }
-}
-//# sourceMappingURL=hook-service.js.map

package/dist/services/hook-service.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"hook-service.js","sourceRoot":"","sources":["../../src/services/hook-service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AA4BtC,MAAM,OAAO,WAAY,SAAQ,YAAY;IACnC,QAAQ,CAA+B;IACvC,cAAc,CAAiB;IAC/B,KAAK,CAA2B;IAChC,OAAO,GAAY,IAAI,CAAC;IAEhC,YAAY,cAA8B;QACxC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;QACrC,IAAI,CAAC,QAAQ,GAAG,IAAI,GAAG,EAAE,CAAC;QAC1B,IAAI,CAAC,KAAK,GAAG,IAAI,GAAG,EAAE,CAAC;QACvB,IAAI,CAAC,yBAAyB,EAAE,CAAC;IACnC,CAAC;IAED;;OAEG;IACK,yBAAyB;QAC/B,0CAA0C;QAC1C,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YACzC,IAAI,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;gBAChC,IAAI,CAAC;oBACH,MAAM,IAAI,CAAC,cAAc,CAAC,YAAY,CAAC;wBACrC,QAAQ,EAAE,cAAc;wBACxB,QAAQ,EAAE,GAAG,CAAC,QAAQ;wBACtB,WAAW,EAAE,GAAG;wBAChB,IAAI,EAAE,CAAC,cAAc,EAAE,UAAU,CAAC;wBAClC,QAAQ,EAAE;4BACR,QAAQ,EAAE,GAAG,CAAC,QAAQ;4BACtB,OAAO,EAAE,GAAG,CAAC,OAAO;4BACpB,SAAS,EAAE,GAAG,CAAC,SAAS;yBACzB;qBACF,CAAC,CAAC;gBACL,CAAC;gBAAC,MAAM,CAAC;oBACP,wEAAwE;gBAC1E,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,sCAAsC;QACtC,IAAI,CAAC,QAAQ,CAAC,eAAe,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YAC3C,IAAI,GAAG,CAAC,IAAI,EAAE,MAAM,IAAI,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;gBACzC,IAAI,CAAC;oBACH,MAAM,IAAI,CAAC,cAAc,CAAC,YAAY,CAAC;wBACrC,SAAS,EAAE,GAAG,CAAC,SAAS,IAAI,SAAS;wBACrC,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,MAAM;wBACrB,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE;wBAC9B,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,MAAM;wBACvB,MAAM,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG;wBAC/B,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,KAAK;wBAC7B,IAAI,EAAE,CAAC,cAAc,EAAE,iBAAiB,CAAC;wBACzC,QAAQ,EAAE;4BACR,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,MAAM;4BACvB,OAAO,EAAE,GAAG,CAAC,OAAO;yBACrB;qBACF,CAAC,CAAC;gBACL,CAAC;gBAAC,MAAM,CAAC;oBACP,mEAAmE;gBACrE,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,iCAAiC;QACjC,IAAI,CAAC,QAAQ,CAAC,YAAY,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YACxC,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC;gBAClB,IAAI,CAAC;oBACH,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;oBAClC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,UAAU,EAAE,CAAC;oBACvD,MAAM,IAAI,CAAC,cAAc,CAAC,YAAY,CAAC;wBACrC,SAAS,EAAE,GAAG,CAAC,SAAS;wBACxB,IAAI,EAAE,mBAAmB,GAAG,CAAC,SAAS,EAAE;wBACxC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;wBAC9C,MAAM,EAAE,GAAG;wBACX,OAAO,EAAE,IAAI;wBACb,IAAI,EAAE,CAAC,iBAAiB,CAAC;qBAC1B,CAAC,CAAC;gBACL,CAAC;gBAAC,MAAM,CAAC;oBACP,eAAe;gBACjB,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,yDAAyD;QACzD,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YACzC,IAAI,CAAC,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;gBAC9C,IAAI,CAAC;oBACH,MAAM,IAAI,CAAC,cAAc,CAAC,YAAY,CAAC;wBACrC,QAAQ,EAAE,cAAc;wBACxB,QAAQ,EAAE,GAAG,GAAG,CAAC,QAAQ,KAAK,GAAG,CAAC,KAAK,EAAE;wBACzC,WAAW,EAAE,GAAG;wBAChB,IAAI,EAAE,CAAC,cAAc,EAAE,cAAc,CAAC;wBACtC,QAAQ,EAAE;4BACR,QAAQ,EAAE,GAAG,CAAC,QAAQ;4BACtB,KAAK,EAAE,GAAG,CAAC,KAAK;4BAChB,OAAO,EAAE,GAAG,CAAC,OAAO;4BACpB,SAAS,EAAE,GAAG,CAAC,SAAS;yBACzB;qBACF,CAAC,CAAC;gBACL,CAAC;gBAAC,MAAM,CAAC;oBACP,eAAe;gBACjB,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,IAAc,EAAE,OAAoB;QAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAC/C,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACvB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,IAAc,EAAE,OAAoB;QAC7C,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAC/C,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACxC,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;YACjB,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YAC1B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QACpC,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,IAAc,EAAE,IAAS,EAAE,QAA+B;QACtE,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAE1B,MAAM,GAAG,GAAgB;YACvB,IAAI;YACJ,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,IAAI;YACJ,GAAG,QAAQ;SACZ,CAAC;QAEF,eAAe;QACf,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;QACjF,IAAI,CAAC,SAAS,EAAE,CAAC;QACjB,IAAI,CAAC,WAAW,GAAG,GAAG,CAAC,SAAS,CAAC;QACjC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAE3B,kCAAkC;QAClC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAE/C,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,gEAAgE;YAChE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QAED,wDAAwD;QACxD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CACtC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CACtC,CAAC;QAEF,eAAe;QACf,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,MAAM,CAAC;QACnE,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC;QACxB,CAAC;QAED,0CAA0C;QAC1C,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,OAAgB;QACzB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,SAAS;QACP,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,MAAM,KAAK,GAA8B,EAAE,CAAC;QAC5C,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;YAChD,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC;QAC5B,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,IAAc;QAC5B,OAAO,EAAE,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;IACtF,CAAC;IAED;;OAEG;IACH,UAAU;QACR,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,YAAY;QACV,MAAM,MAAM,GAA2B,EAAE,CAAC;QAC1C,KAAK,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;YACvD,MAAM,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC;QACjC,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,IAAI,aAAa;QACf,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;YAC9C,KAAK,IAAI,QAAQ,CAAC,MAAM,CAAC;QAC3B,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,IAAc;QAC1B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,gBAAgB;QACd,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,yBAAyB,EAAE,CAAC;IACnC,CAAC;CACF","sourcesContent":["/**\n * HookService - EventEmitter-based hook system with AgentDB integration\n *\n * Provides lifecycle hooks for tool use, session events, task completion,\n * and agent coordination. Automatically feeds learning loops via AgentDB.\n */\nimport { EventEmitter } from 'events';\nimport type { AgentDBService } from './agentdb-service.js';\n\nexport type HookType =\n  | 'PreToolUse' | 'PostToolUse' | 'UserPromptSubmit'\n  | 'SessionStart' | 'SessionEnd' | 'Stop'\n  | 'PreCompact' | 'SubagentStart' | 'TeammateIdle' | 'TaskCompleted'\n  | 'SwarmInit' | 'SwarmShutdown' | 'AgentSpawn' | 'AgentTerminate';\n\nexport interface HookContext {\n  type: HookType;\n  timestamp: number;\n  data: any;\n  agentId?: string;\n  sessionId?: string;\n  toolName?: string;\n  success?: boolean;\n  error?: string;\n}\n\ninterface HookStats {\n  triggered: number;\n  lastTrigger: number;\n  errors: number;\n}\n\ntype HookHandler = (ctx: HookContext) => Promise<void>;\n\nexport class HookService extends EventEmitter {\n  private handlers: Map<HookType, HookHandler[]>;\n  private agentDBService: AgentDBService;\n  private stats: Map<HookType, HookStats>;\n  private enabled: boolean = true;\n\n  constructor(agentDBService: AgentDBService) {\n    super();\n    this.agentDBService = agentDBService;\n    this.handlers = new Map();\n    this.stats = new Map();\n    this.initializeBuiltInHandlers();\n  }\n\n  /**\n   * Initialize built-in learning handlers that feed AgentDB\n   */\n  private initializeBuiltInHandlers(): void {\n    // Pattern learning on successful tool use\n    this.register('PostToolUse', async (ctx) => {\n      if (ctx.success && ctx.toolName) {\n        try {\n          await this.agentDBService.storePattern({\n            taskType: 'tool_success',\n            approach: ctx.toolName,\n            successRate: 1.0,\n            tags: ['auto-learned', 'tool-use'],\n            metadata: {\n              toolName: ctx.toolName,\n              agentId: ctx.agentId,\n              timestamp: ctx.timestamp,\n            },\n          });\n        } catch {\n          // Non-critical: pattern storage failure should not break tool execution\n        }\n      }\n    });\n\n    // Reflexion memory on task completion\n    this.register('TaskCompleted', async (ctx) => {\n      if (ctx.data?.taskId && ctx.data?.result) {\n        try {\n          await this.agentDBService.storeEpisode({\n            sessionId: ctx.sessionId || 'unknown',\n            task: ctx.data.taskId,\n            input: ctx.data.approach || '',\n            output: ctx.data.result,\n            reward: ctx.success ? 1.0 : 0.0,\n            success: ctx.success ?? false,\n            tags: ['auto-learned', 'task-completion'],\n            metadata: {\n              action: ctx.data.action,\n              agentId: ctx.agentId,\n            },\n          });\n        } catch {\n          // Non-critical: episode storage failure should not break task flow\n        }\n      }\n    });\n\n    // Session summary on session end\n    this.register('SessionEnd', async (ctx) => {\n      if (ctx.sessionId) {\n        try {\n          const hookStats = this.getStats();\n          const metrics = await this.agentDBService.getMetrics();\n          await this.agentDBService.storeEpisode({\n            sessionId: ctx.sessionId,\n            task: `session_summary:${ctx.sessionId}`,\n            output: JSON.stringify({ hookStats, metrics }),\n            reward: 0.5,\n            success: true,\n            tags: ['session-summary'],\n          });\n        } catch {\n          // Non-critical\n        }\n      }\n    });\n\n    // Pattern learning on failed tool use for error analysis\n    this.register('PostToolUse', async (ctx) => {\n      if (!ctx.success && ctx.toolName && ctx.error) {\n        try {\n          await this.agentDBService.storePattern({\n            taskType: 'tool_failure',\n            approach: `${ctx.toolName}: ${ctx.error}`,\n            successRate: 0.0,\n            tags: ['auto-learned', 'tool-failure'],\n            metadata: {\n              toolName: ctx.toolName,\n              error: ctx.error,\n              agentId: ctx.agentId,\n              timestamp: ctx.timestamp,\n            },\n          });\n        } catch {\n          // Non-critical\n        }\n      }\n    });\n  }\n\n  /**\n   * Register a hook handler for a specific hook type\n   */\n  register(type: HookType, handler: HookHandler): this {\n    const handlers = this.handlers.get(type) || [];\n    handlers.push(handler);\n    this.handlers.set(type, handlers);\n    return this;\n  }\n\n  /**\n   * Unregister a specific handler\n   */\n  unregister(type: HookType, handler: HookHandler): this {\n    const handlers = this.handlers.get(type) || [];\n    const index = handlers.indexOf(handler);\n    if (index !== -1) {\n      handlers.splice(index, 1);\n      this.handlers.set(type, handlers);\n    }\n    return this;\n  }\n\n  /**\n   * Trigger a hook - executes all registered handlers in parallel\n   */\n  async trigger(type: HookType, data: any, metadata?: Partial<HookContext>): Promise<void> {\n    if (!this.enabled) return;\n\n    const ctx: HookContext = {\n      type,\n      timestamp: Date.now(),\n      data,\n      ...metadata,\n    };\n\n    // Update stats\n    const stat = this.stats.get(type) || { triggered: 0, lastTrigger: 0, errors: 0 };\n    stat.triggered++;\n    stat.lastTrigger = ctx.timestamp;\n    this.stats.set(type, stat);\n\n    // Get handlers for this hook type\n    const handlers = this.handlers.get(type) || [];\n\n    if (handlers.length === 0) {\n      // Still emit even without handlers for EventEmitter subscribers\n      this.emit(type, ctx);\n      return;\n    }\n\n    // Execute all handlers in parallel with error isolation\n    const results = await Promise.allSettled(\n      handlers.map(handler => handler(ctx))\n    );\n\n    // Count errors\n    const errors = results.filter(r => r.status === 'rejected').length;\n    if (errors > 0) {\n      stat.errors += errors;\n    }\n\n    // Emit event for EventEmitter subscribers\n    this.emit(type, ctx);\n  }\n\n  /**\n   * Enable or disable the hook system\n   */\n  setEnabled(enabled: boolean): void {\n    this.enabled = enabled;\n  }\n\n  /**\n   * Check if hook system is enabled\n   */\n  isEnabled(): boolean {\n    return this.enabled;\n  }\n\n  /**\n   * Get hook statistics\n   */\n  getStats(): Record<string, HookStats> {\n    const stats: Record<string, HookStats> = {};\n    for (const [type, stat] of this.stats.entries()) {\n      stats[type] = { ...stat };\n    }\n    return stats;\n  }\n\n  /**\n   * Get stats for a specific hook type\n   */\n  getStatsForType(type: HookType): HookStats {\n    return { ...(this.stats.get(type) || { triggered: 0, lastTrigger: 0, errors: 0 }) };\n  }\n\n  /**\n   * Clear all statistics\n   */\n  clearStats(): void {\n    this.stats.clear();\n  }\n\n  /**\n   * List registered handler counts by type\n   */\n  listHandlers(): Record<string, number> {\n    const counts: Record<string, number> = {};\n    for (const [type, handlers] of this.handlers.entries()) {\n      counts[type] = handlers.length;\n    }\n    return counts;\n  }\n\n  /**\n   * Get total number of registered handlers\n   */\n  get totalHandlers(): number {\n    let count = 0;\n    for (const handlers of this.handlers.values()) {\n      count += handlers.length;\n    }\n    return count;\n  }\n\n  /**\n   * Remove all handlers for a specific hook type\n   */\n  clearHandlers(type: HookType): void {\n    this.handlers.set(type, []);\n  }\n\n  /**\n   * Remove all handlers\n   */\n  clearAllHandlers(): void {\n    this.handlers.clear();\n    this.initializeBuiltInHandlers();\n  }\n}\n"]}

package/dist/services/quantization-service.d.ts

@@ -1,167 +0,0 @@
-/**
- * Model Quantization Service
- *
- * Provides INT8/INT4 quantization, knowledge distillation, dynamic quantization,
- * and model pruning for faster local inference with reduced memory footprint.
- *
- * Target: 4x memory reduction (INT8), 8x reduction (INT4), 2-4x faster inference
- */
-export type QuantizationType = 'int8' | 'int4' | 'fp16' | 'dynamic';
-export type PrecisionLevel = 'high' | 'medium' | 'low';
-export interface QuantizationConfig {
-    /** Quantization type (int8, int4, fp16, dynamic) */
-    type: QuantizationType;
-    /** Calibration dataset size (for static quantization) */
-    calibrationSize?: number;
-    /** Accuracy threshold (fallback to higher precision if below) */
-    accuracyThreshold?: number;
-    /** Enable symmetric quantization (vs asymmetric) */
-    symmetric?: boolean;
-    /** Per-channel quantization (more accurate) */
-    perChannel?: boolean;
-}
-export interface QuantizationResult {
-    success: boolean;
-    originalSize: number;
-    quantizedSize: number;
-    memoryReduction: number;
-    accuracyLoss: number;
-    inferenceSpeedup: number;
-    type: QuantizationType;
-    metadata?: Record<string, any>;
-}
-export interface DistillationConfig {
-    /** Teacher model (large, accurate) */
-    teacherModel: string;
-    /** Student model (small, fast) */
-    studentModel: string;
-    /** Temperature for softmax (higher = softer probabilities) */
-    temperature?: number;
-    /** Alpha for loss weighting (teacher vs ground truth) */
-    alpha?: number;
-    /** Training epochs */
-    epochs?: number;
-    /** Learning rate */
-    learningRate?: number;
-}
-export interface DistillationResult {
-    success: boolean;
-    studentAccuracy: number;
-    teacherAccuracy: number;
-    accuracyRetention: number;
-    sizeReduction: number;
-    speedup: number;
-    epochs: number;
-}
-export interface PruningConfig {
-    /** Sparsity target (0-1, e.g., 0.5 = 50% weights removed) */
-    sparsity: number;
-    /** Pruning method */
-    method: 'magnitude' | 'structured' | 'unstructured' | 'l1';
-    /** Fine-tune after pruning */
-    fineTune?: boolean;
-    /** Fine-tuning epochs */
-    fineTuneEpochs?: number;
-}
-export interface PruningResult {
-    success: boolean;
-    originalParams: number;
-    prunedParams: number;
-    sparsity: number;
-    accuracyLoss: number;
-    speedup: number;
-    sizeReduction: number;
-}
-export interface CachedModel {
-    id: string;
-    name: string;
-    type: QuantizationType;
-    size: number;
-    lastAccessed: number;
-    hitCount: number;
-    path: string;
-}
-export interface ServiceMetrics {
-    totalModels: number;
-    cachedModels: number;
-    totalMemory: number;
-    avgInferenceTime: number;
-    quantizationJobs: number;
-    cacheHitRate: number;
-    uptime: number;
-}
-export declare class QuantizationService {
-    private static instance;
-    private modelCache;
-    private cacheDir;
-    private maxCacheSize;
-    private currentCacheSize;
-    private metrics;
-    private constructor();
-    static getInstance(): QuantizationService;
-    /**
-     * Quantize model to INT8 (4x memory reduction, 2-4x faster)
-     *
-     * Uses symmetric per-channel quantization with calibration dataset
-     */
-    quantizeINT8(modelPath: string, outputPath: string, config?: Partial<QuantizationConfig>): Promise<QuantizationResult>;
-    /**
-     * Quantize model to INT4 (8x memory reduction for embeddings)
-     *
-     * Primarily for embedding layers and non-critical computations
-     */
-    quantizeINT4(modelPath: string, outputPath: string, config?: Partial<QuantizationConfig>): Promise<QuantizationResult>;
-    /**
-     * Dynamic quantization - adapt precision based on task complexity
-     *
-     * High-priority tasks use higher precision, low-priority use INT4
-     */
-    quantizeDynamic(modelPath: string, outputPath: string, precisionLevel: PrecisionLevel): Promise<QuantizationResult>;
-    /**
-     * Transfer knowledge from large teacher model to small student model
-     *
-     * Student learns to mimic teacher's soft outputs (not just labels)
-     */
-    distill(config: DistillationConfig): Promise<DistillationResult>;
-    /**
-     * Remove unnecessary weights to reduce model size
-     *
-     * Magnitude pruning: remove smallest weights (by absolute value)
-     */
-    prune(modelPath: string, outputPath: string, config: PruningConfig): Promise<PruningResult>;
-    /**
-     * Get cached model or quantize on-demand
-     */
-    getCachedModel(modelName: string, type: QuantizationType): Promise<string | null>;
-    /**
-     * Evict least recently used models when cache is full
-     */
-    evictLRU(): Promise<void>;
-    /**
-     * Clear all cached models
-     */
-    clearCache(): Promise<void>;
-    getMetrics(): ServiceMetrics;
-    listCachedModels(): CachedModel[];
-    private ensureCacheDir;
-    private getModelSize;
-    private performINT8Quantization;
-    private performINT4Quantization;
-    private quantizeFP16;
-    private writeQuantizedModel;
-    private measureAccuracyLoss;
-    private benchmarkInference;
-    private loadModel;
-    private measureModelAccuracy;
-    private performDistillation;
-    private benchmarkModelSpeed;
-    private countParameters;
-    private performPruning;
-    private fineTuneModel;
-    private saveModel;
-    private cacheModel;
-    private evictModel;
-}
-declare const _default: QuantizationService;
-export default _default;
-//# sourceMappingURL=quantization-service.d.ts.map

package/dist/services/quantization-service.d.ts.map

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