agentic-flow 2.0.7 → 3.0.0-alpha.2

package/dist/agentic-flow/src/services/hook-service.d.ts

@@ -0,0 +1,86 @@
+/**
+ * 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';
+import type { AgentDBService } from './agentdb-service.js';
+export type HookType = 'PreToolUse' | 'PostToolUse' | 'UserPromptSubmit' | 'SessionStart' | 'SessionEnd' | 'Stop' | 'PreCompact' | 'SubagentStart' | 'TeammateIdle' | 'TaskCompleted' | 'SwarmInit' | 'SwarmShutdown' | 'AgentSpawn' | 'AgentTerminate';
+export interface HookContext {
+    type: HookType;
+    timestamp: number;
+    data: any;
+    agentId?: string;
+    sessionId?: string;
+    toolName?: string;
+    success?: boolean;
+    error?: string;
+}
+interface HookStats {
+    triggered: number;
+    lastTrigger: number;
+    errors: number;
+}
+type HookHandler = (ctx: HookContext) => Promise<void>;
+export declare class HookService extends EventEmitter {
+    private handlers;
+    private agentDBService;
+    private stats;
+    private enabled;
+    constructor(agentDBService: AgentDBService);
+    /**
+     * Initialize built-in learning handlers that feed AgentDB
+     */
+    private initializeBuiltInHandlers;
+    /**
+     * Register a hook handler for a specific hook type
+     */
+    register(type: HookType, handler: HookHandler): this;
+    /**
+     * Unregister a specific handler
+     */
+    unregister(type: HookType, handler: HookHandler): this;
+    /**
+     * Trigger a hook - executes all registered handlers in parallel
+     */
+    trigger(type: HookType, data: any, metadata?: Partial<HookContext>): Promise<void>;
+    /**
+     * Enable or disable the hook system
+     */
+    setEnabled(enabled: boolean): void;
+    /**
+     * Check if hook system is enabled
+     */
+    isEnabled(): boolean;
+    /**
+     * Get hook statistics
+     */
+    getStats(): Record<string, HookStats>;
+    /**
+     * Get stats for a specific hook type
+     */
+    getStatsForType(type: HookType): HookStats;
+    /**
+     * Clear all statistics
+     */
+    clearStats(): void;
+    /**
+     * List registered handler counts by type
+     */
+    listHandlers(): Record<string, number>;
+    /**
+     * Get total number of registered handlers
+     */
+    get totalHandlers(): number;
+    /**
+     * Remove all handlers for a specific hook type
+     */
+    clearHandlers(type: HookType): void;
+    /**
+     * Remove all handlers
+     */
+    clearAllHandlers(): void;
+}
+export {};
+//# sourceMappingURL=hook-service.d.ts.map

package/dist/agentic-flow/src/services/hook-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-service.d.ts","sourceRoot":"","sources":["../../../../src/services/hook-service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,MAAM,MAAM,QAAQ,GAChB,YAAY,GAAG,aAAa,GAAG,kBAAkB,GACjD,cAAc,GAAG,YAAY,GAAG,MAAM,GACtC,YAAY,GAAG,eAAe,GAAG,cAAc,GAAG,eAAe,GACjE,WAAW,GAAG,eAAe,GAAG,YAAY,GAAG,gBAAgB,CAAC;AAEpE,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,QAAQ,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,GAAG,CAAC;IACV,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,SAAS;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,KAAK,WAAW,GAAG,CAAC,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAEvD,qBAAa,WAAY,SAAQ,YAAY;IAC3C,OAAO,CAAC,QAAQ,CAA+B;IAC/C,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,KAAK,CAA2B;IACxC,OAAO,CAAC,OAAO,CAAiB;gBAEpB,cAAc,EAAE,cAAc;IAQ1C;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAwFjC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI;IAOpD;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI;IAUtD;;OAEG;IACG,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAwCxF;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAIlC;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC;IAQrC;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,QAAQ,GAAG,SAAS;IAI1C;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;OAEG;IACH,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAQtC;;OAEG;IACH,IAAI,aAAa,IAAI,MAAM,CAM1B;IAED;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI;IAInC;;OAEG;IACH,gBAAgB,IAAI,IAAI;CAIzB"}

package/dist/agentic-flow/src/services/hook-service.js

@@ -0,0 +1,234 @@
+/**
+ * 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/agentic-flow/src/services/hook-service.js.map

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

@@ -0,0 +1,167 @@
+/**
+ * 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/agentic-flow/src/services/quantization-service.d.ts.map

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