agentic-flow 1.10.0 → 1.10.2

package/dist/utils/modelOptimizer.d.ts

@@ -0,0 +1,207 @@
+/**
+ * Smart Model Optimizer - Automatically selects the best model for each agent and task
+ * Balances performance vs cost based on agent requirements
+ */
+export interface ModelRecommendation {
+    provider: string;
+    model: string;
+    modelName: string;
+    reasoning: string;
+    cost_per_1m_input: number;
+    cost_per_1m_output: number;
+    quality_score: number;
+    speed_score: number;
+    cost_score: number;
+    overall_score: number;
+    tier: 'flagship' | 'cost-effective' | 'balanced' | 'budget' | 'local';
+}
+export interface OptimizationCriteria {
+    agent: string;
+    task: string;
+    priority?: 'quality' | 'balanced' | 'cost' | 'speed' | 'privacy';
+    maxCostPerTask?: number;
+    requiresReasoning?: boolean;
+    requiresMultimodal?: boolean;
+    requiresTools?: boolean;
+    taskComplexity?: 'simple' | 'moderate' | 'complex' | 'expert';
+}
+declare const MODEL_DATABASE: {
+    'claude-sonnet-4-5': {
+        provider: string;
+        model: string;
+        modelName: string;
+        cost_per_1m_input: number;
+        cost_per_1m_output: number;
+        quality_score: number;
+        speed_score: number;
+        cost_score: number;
+        tier: "flagship";
+        supports_tools: boolean;
+        strengths: string[];
+        weaknesses: string[];
+        bestFor: string[];
+    };
+    'gpt-4o': {
+        provider: string;
+        model: string;
+        modelName: string;
+        cost_per_1m_input: number;
+        cost_per_1m_output: number;
+        quality_score: number;
+        speed_score: number;
+        cost_score: number;
+        tier: "flagship";
+        supports_tools: boolean;
+        strengths: string[];
+        weaknesses: string[];
+        bestFor: string[];
+    };
+    'gemini-2-5-pro': {
+        provider: string;
+        model: string;
+        modelName: string;
+        cost_per_1m_input: number;
+        cost_per_1m_output: number;
+        quality_score: number;
+        speed_score: number;
+        cost_score: number;
+        tier: "flagship";
+        supports_tools: boolean;
+        strengths: string[];
+        weaknesses: string[];
+        bestFor: string[];
+    };
+    'deepseek-r1': {
+        provider: string;
+        model: string;
+        modelName: string;
+        cost_per_1m_input: number;
+        cost_per_1m_output: number;
+        quality_score: number;
+        speed_score: number;
+        cost_score: number;
+        tier: "cost-effective";
+        supports_tools: boolean;
+        strengths: string[];
+        weaknesses: string[];
+        bestFor: string[];
+    };
+    'deepseek-chat-v3': {
+        provider: string;
+        model: string;
+        modelName: string;
+        cost_per_1m_input: number;
+        cost_per_1m_output: number;
+        quality_score: number;
+        speed_score: number;
+        cost_score: number;
+        tier: "cost-effective";
+        supports_tools: boolean;
+        strengths: string[];
+        weaknesses: string[];
+        bestFor: string[];
+    };
+    'gemini-2-5-flash': {
+        provider: string;
+        model: string;
+        modelName: string;
+        cost_per_1m_input: number;
+        cost_per_1m_output: number;
+        quality_score: number;
+        speed_score: number;
+        cost_score: number;
+        tier: "balanced";
+        supports_tools: boolean;
+        strengths: string[];
+        weaknesses: string[];
+        bestFor: string[];
+    };
+    'llama-3-3-8b': {
+        provider: string;
+        model: string;
+        modelName: string;
+        cost_per_1m_input: number;
+        cost_per_1m_output: number;
+        quality_score: number;
+        speed_score: number;
+        cost_score: number;
+        tier: "balanced";
+        supports_tools: boolean;
+        strengths: string[];
+        weaknesses: string[];
+        bestFor: string[];
+    };
+    'qwen-2-5-72b': {
+        provider: string;
+        model: string;
+        modelName: string;
+        cost_per_1m_input: number;
+        cost_per_1m_output: number;
+        quality_score: number;
+        speed_score: number;
+        cost_score: number;
+        tier: "balanced";
+        supports_tools: boolean;
+        strengths: string[];
+        weaknesses: string[];
+        bestFor: string[];
+    };
+    'llama-3-1-8b': {
+        provider: string;
+        model: string;
+        modelName: string;
+        cost_per_1m_input: number;
+        cost_per_1m_output: number;
+        quality_score: number;
+        speed_score: number;
+        cost_score: number;
+        tier: "budget";
+        supports_tools: boolean;
+        strengths: string[];
+        weaknesses: string[];
+        bestFor: string[];
+    };
+    'onnx-phi-4': {
+        provider: string;
+        model: string;
+        modelName: string;
+        cost_per_1m_input: number;
+        cost_per_1m_output: number;
+        quality_score: number;
+        speed_score: number;
+        cost_score: number;
+        tier: "local";
+        supports_tools: boolean;
+        strengths: string[];
+        weaknesses: string[];
+        bestFor: string[];
+    };
+};
+export declare class ModelOptimizer {
+    /**
+     * Optimize model selection based on agent, task, and priorities
+     */
+    static optimize(criteria: OptimizationCriteria): ModelRecommendation;
+    /**
+     * Infer task complexity from task description
+     */
+    private static inferComplexity;
+    /**
+     * Estimate cost for a task (rough approximation)
+     */
+    private static estimateCost;
+    /**
+     * Generate human-readable reasoning for model selection
+     */
+    private static generateReasoning;
+    /**
+     * Get all available models with their characteristics
+     */
+    static getAvailableModels(): typeof MODEL_DATABASE;
+    /**
+     * Display optimization recommendations in console
+     */
+    static displayRecommendation(recommendation: ModelRecommendation): void;
+}
+export {};
+//# sourceMappingURL=modelOptimizer.d.ts.map

package/dist/utils/modelOptimizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modelOptimizer.d.ts","sourceRoot":"","sources":["../../src/utils/modelOptimizer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,UAAU,GAAG,gBAAgB,GAAG,UAAU,GAAG,QAAQ,GAAG,OAAO,CAAC;CACvE;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;IACjE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,cAAc,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC;CAC/D;AAGD,QAAA,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgKnB,CAAC;AA4CF,qBAAa,cAAc;IACzB;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,GAAG,mBAAmB;IA6GpE;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,eAAe;IA2C9B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,YAAY;IAW3B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAsDhC;;OAEG;IACH,MAAM,CAAC,kBAAkB,IAAI,OAAO,cAAc;IAIlD;;OAEG;IACH,MAAM,CAAC,qBAAqB,CAAC,cAAc,EAAE,mBAAmB,GAAG,IAAI;CAqBxE"}

package/dist/utils/modelOptimizer.js

@@ -412,3 +412,4 @@ export class ModelOptimizer {
         console.log('');
     }
 }
+//# sourceMappingURL=modelOptimizer.js.map

package/dist/utils/modelOptimizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"modelOptimizer.js","sourceRoot":"","sources":["../../src/utils/modelOptimizer.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Smart Model Optimizer - Automatically selects the best model for each agent and task\n * Balances performance vs cost based on agent requirements\n */\n\nimport { logger } from './logger.js';\n\nexport interface ModelRecommendation {\n  provider: string;\n  model: string;\n  modelName: string;\n  reasoning: string;\n  cost_per_1m_input: number;\n  cost_per_1m_output: number;\n  quality_score: number;\n  speed_score: number;\n  cost_score: number;\n  overall_score: number;\n  tier: 'flagship' | 'cost-effective' | 'balanced' | 'budget' | 'local';\n}\n\nexport interface OptimizationCriteria {\n  agent: string;\n  task: string;\n  priority?: 'quality' | 'balanced' | 'cost' | 'speed' | 'privacy';\n  maxCostPerTask?: number;\n  requiresReasoning?: boolean;\n  requiresMultimodal?: boolean;\n  requiresTools?: boolean; // NEW: Filter models that support tool/function calling\n  taskComplexity?: 'simple' | 'moderate' | 'complex' | 'expert';\n}\n\n// Model database with performance characteristics\nconst MODEL_DATABASE = {\n  // Tier 1: Flagship Models\n  'claude-sonnet-4-5': {\n    provider: 'anthropic',\n    model: 'claude-sonnet-4-5-20250929',\n    modelName: 'Claude Sonnet 4.5',\n    cost_per_1m_input: 3.00,\n    cost_per_1m_output: 15.00,\n    quality_score: 95,\n    speed_score: 85,\n    cost_score: 20,\n    tier: 'flagship' as const,\n    supports_tools: true,\n    strengths: ['reasoning', 'coding', 'analysis', 'production'],\n    weaknesses: ['cost'],\n    bestFor: ['coder', 'reviewer', 'architecture', 'planner', 'production-validator']\n  },\n  'gpt-4o': {\n    provider: 'openrouter',\n    model: 'openai/gpt-4o',\n    modelName: 'GPT-4o',\n    cost_per_1m_input: 2.50,\n    cost_per_1m_output: 10.00,\n    quality_score: 88,\n    speed_score: 90,\n    cost_score: 30,\n    tier: 'flagship' as const,\n    supports_tools: true,\n    strengths: ['multimodal', 'speed', 'general-purpose', 'vision'],\n    weaknesses: ['cost'],\n    bestFor: ['researcher', 'analyst', 'multimodal-tasks']\n  },\n  'gemini-2-5-pro': {\n    provider: 'openrouter',\n    model: 'google/gemini-2.5-pro',\n    modelName: 'Gemini 2.5 Pro',\n    cost_per_1m_input: 1.25,\n    cost_per_1m_output: 5.00,\n    quality_score: 90,\n    speed_score: 75,\n    cost_score: 50,\n    tier: 'flagship' as const,\n    supports_tools: true,\n    strengths: ['reasoning', 'large-context', 'math', 'analysis'],\n    weaknesses: ['speed'],\n    bestFor: ['planner', 'architecture', 'researcher', 'code-analyzer']\n  },\n\n  // Tier 2: Cost-Effective Champions\n  'deepseek-r1': {\n    provider: 'openrouter',\n    model: 'deepseek/deepseek-r1-0528:free',\n    modelName: 'DeepSeek R1',\n    cost_per_1m_input: 0.00,\n    cost_per_1m_output: 0.00,\n    quality_score: 90,\n    speed_score: 80,\n    cost_score: 100,\n    tier: 'cost-effective' as const,\n    supports_tools: false, // DeepSeek R1 does NOT support tool/function calling\n    strengths: ['reasoning', 'coding', 'math', 'value', 'free'],\n    weaknesses: ['newer-model', 'no-tool-use'],\n    bestFor: ['coder', 'pseudocode', 'specification', 'refinement', 'tester']\n  },\n  'deepseek-chat-v3': {\n    provider: 'openrouter',\n    model: 'deepseek/deepseek-chat-v3.1:free',\n    modelName: 'DeepSeek Chat V3.1',\n    cost_per_1m_input: 0.00,\n    cost_per_1m_output: 0.00,\n    quality_score: 82,\n    speed_score: 90,\n    cost_score: 100,\n    tier: 'cost-effective' as const,\n    supports_tools: true,\n    strengths: ['cost', 'speed', 'coding', 'development', 'free'],\n    weaknesses: ['complex-reasoning'],\n    bestFor: ['coder', 'reviewer', 'tester', 'backend-dev', 'cicd-engineer']\n  },\n\n  // Tier 3: Balanced Performance\n  'gemini-2-5-flash': {\n    provider: 'openrouter',\n    model: 'google/gemini-2.5-flash',\n    modelName: 'Gemini 2.5 Flash',\n    cost_per_1m_input: 0.075,\n    cost_per_1m_output: 0.30,\n    quality_score: 78,\n    speed_score: 98,\n    cost_score: 98,\n    tier: 'balanced' as const,\n    supports_tools: true,\n    strengths: ['speed', 'cost', 'interactive'],\n    weaknesses: ['quality'],\n    bestFor: ['researcher', 'planner', 'smart-agent']\n  },\n  'llama-3-3-8b': {\n    provider: 'openrouter',\n    model: 'meta-llama/llama-3.3-8b-instruct:free',\n    modelName: 'Llama 3.3 8B',\n    cost_per_1m_input: 0.00,\n    cost_per_1m_output: 0.00,\n    quality_score: 72,\n    speed_score: 95,\n    cost_score: 100,\n    tier: 'balanced' as const,\n    supports_tools: true,\n    strengths: ['open-source', 'versatile', 'coding', 'free', 'fast'],\n    weaknesses: ['smaller-model'],\n    bestFor: ['coder', 'reviewer', 'base-template-generator', 'tester']\n  },\n  'qwen-2-5-72b': {\n    provider: 'openrouter',\n    model: 'qwen/qwen-2.5-72b-instruct',\n    modelName: 'Qwen 2.5 72B',\n    cost_per_1m_input: 0.35,\n    cost_per_1m_output: 0.40,\n    quality_score: 81,\n    speed_score: 85,\n    cost_score: 90,\n    tier: 'balanced' as const,\n    supports_tools: true,\n    strengths: ['multilingual', 'coding', 'reasoning'],\n    weaknesses: ['english-optimized'],\n    bestFor: ['researcher', 'coder', 'multilingual-tasks']\n  },\n\n  // Tier 4: Budget Options\n  'llama-3-1-8b': {\n    provider: 'openrouter',\n    model: 'meta-llama/llama-3.1-8b-instruct',\n    modelName: 'Llama 3.1 8B',\n    cost_per_1m_input: 0.06,\n    cost_per_1m_output: 0.06,\n    quality_score: 65,\n    speed_score: 95,\n    cost_score: 99,\n    tier: 'budget' as const,\n    supports_tools: true,\n    strengths: ['ultra-low-cost', 'speed'],\n    weaknesses: ['quality', 'complex-tasks'],\n    bestFor: ['simple-tasks', 'testing']\n  },\n\n  // Tier 5: Local/Privacy\n  'onnx-phi-4': {\n    provider: 'onnx',\n    model: 'phi-4-mini',\n    modelName: 'ONNX Phi-4 Mini',\n    cost_per_1m_input: 0.00,\n    cost_per_1m_output: 0.00,\n    quality_score: 58,\n    speed_score: 30,\n    cost_score: 100,\n    tier: 'local' as const,\n    supports_tools: false,\n    strengths: ['privacy', 'offline', 'zero-cost'],\n    weaknesses: ['quality', 'speed'],\n    bestFor: ['privacy-tasks', 'offline-tasks']\n  }\n};\n\n// Agent complexity and quality requirements\nconst AGENT_REQUIREMENTS = {\n  // High-quality code generation\n  'coder': { minQuality: 85, complexity: 'complex', needsReasoning: true },\n  'sparc-coder': { minQuality: 85, complexity: 'complex', needsReasoning: true },\n  'backend-dev': { minQuality: 80, complexity: 'complex', needsReasoning: true },\n\n  // Architecture and design\n  'architecture': { minQuality: 90, complexity: 'expert', needsReasoning: true },\n  'system-architect': { minQuality: 90, complexity: 'expert', needsReasoning: true },\n  'planner': { minQuality: 85, complexity: 'complex', needsReasoning: true },\n\n  // Code review and analysis\n  'reviewer': { minQuality: 85, complexity: 'complex', needsReasoning: true },\n  'code-analyzer': { minQuality: 80, complexity: 'complex', needsReasoning: true },\n  'production-validator': { minQuality: 90, complexity: 'expert', needsReasoning: true },\n\n  // Testing\n  'tester': { minQuality: 75, complexity: 'moderate', needsReasoning: false },\n  'tdd-london-swarm': { minQuality: 80, complexity: 'complex', needsReasoning: true },\n\n  // Research and analysis\n  'researcher': { minQuality: 75, complexity: 'moderate', needsReasoning: true },\n  'analyst': { minQuality: 80, complexity: 'complex', needsReasoning: true },\n\n  // SPARC phases\n  'specification': { minQuality: 85, complexity: 'complex', needsReasoning: true },\n  'pseudocode': { minQuality: 80, complexity: 'complex', needsReasoning: true },\n  'refinement': { minQuality: 85, complexity: 'complex', needsReasoning: true },\n\n  // DevOps and automation\n  'cicd-engineer': { minQuality: 75, complexity: 'moderate', needsReasoning: false },\n  'smart-agent': { minQuality: 70, complexity: 'moderate', needsReasoning: false },\n\n  // Documentation\n  'api-docs': { minQuality: 70, complexity: 'moderate', needsReasoning: false },\n  'base-template-generator': { minQuality: 70, complexity: 'simple', needsReasoning: false },\n\n  // Default for unknown agents\n  'default': { minQuality: 75, complexity: 'moderate', needsReasoning: true }\n};\n\nexport class ModelOptimizer {\n  /**\n   * Optimize model selection based on agent, task, and priorities\n   */\n  static optimize(criteria: OptimizationCriteria): ModelRecommendation {\n    logger.info('Optimizing model selection', criteria);\n\n    // Get agent requirements\n    const agentKey = criteria.agent.toLowerCase() as keyof typeof AGENT_REQUIREMENTS;\n    const agentReqs = AGENT_REQUIREMENTS[agentKey] || AGENT_REQUIREMENTS['default'];\n\n    // Determine task complexity from task description if not provided\n    const taskComplexity = criteria.taskComplexity || this.inferComplexity(criteria.task);\n\n    // Set default priority to balanced if not specified\n    const priority = criteria.priority || 'balanced';\n\n    // Filter models that support tools if required\n    let availableModels = Object.entries(MODEL_DATABASE);\n\n    if (criteria.requiresTools) {\n      availableModels = availableModels.filter(([key, model]) => model.supports_tools !== false);\n      logger.info(`Filtered to ${availableModels.length} models with tool support`);\n    }\n\n    // Score all models\n    const scoredModels = availableModels.map(([key, model]) => {\n      // Calculate overall score based on priority\n      let overall_score: number;\n\n      switch (priority) {\n        case 'quality':\n          overall_score = model.quality_score * 0.7 + model.speed_score * 0.2 + model.cost_score * 0.1;\n          break;\n        case 'cost':\n          overall_score = model.cost_score * 0.7 + model.quality_score * 0.2 + model.speed_score * 0.1;\n          break;\n        case 'speed':\n          overall_score = model.speed_score * 0.7 + model.quality_score * 0.2 + model.cost_score * 0.1;\n          break;\n        case 'privacy':\n          // Heavily favor local models for privacy\n          overall_score = model.tier === 'local' ? 100 : model.cost_score * 0.5 + model.quality_score * 0.5;\n          break;\n        case 'balanced':\n        default:\n          overall_score = model.quality_score * 0.4 + model.cost_score * 0.4 + model.speed_score * 0.2;\n          break;\n      }\n\n      // Apply agent-specific bonuses\n      if (model.bestFor.includes(criteria.agent.toLowerCase())) {\n        overall_score += 10;\n      }\n\n      // Apply quality threshold\n      if (model.quality_score < agentReqs.minQuality) {\n        overall_score *= 0.5; // Penalize models below quality threshold\n      }\n\n      // Apply complexity matching\n      if (taskComplexity === 'expert' && model.tier !== 'flagship') {\n        overall_score *= 0.7;\n      } else if (taskComplexity === 'simple' && model.tier === 'flagship') {\n        overall_score *= 0.8; // Don't waste flagship models on simple tasks unless quality priority\n      }\n\n      // Apply cost cap if specified\n      if (criteria.maxCostPerTask) {\n        const estimatedCost = this.estimateCost(model, criteria.task);\n        if (estimatedCost > criteria.maxCostPerTask) {\n          overall_score *= 0.3; // Heavy penalty for exceeding budget\n        }\n      }\n\n      return {\n        key,\n        ...model,\n        overall_score\n      };\n    });\n\n    // Sort by overall score\n    scoredModels.sort((a, b) => b.overall_score - a.overall_score);\n\n    // Get top recommendation\n    const top = scoredModels[0];\n\n    // Generate reasoning\n    const reasoning = this.generateReasoning(top, criteria, agentReqs, taskComplexity, priority);\n\n    const recommendation: ModelRecommendation = {\n      provider: top.provider,\n      model: top.model,\n      modelName: top.modelName,\n      cost_per_1m_input: top.cost_per_1m_input,\n      cost_per_1m_output: top.cost_per_1m_output,\n      quality_score: top.quality_score,\n      speed_score: top.speed_score,\n      cost_score: top.cost_score,\n      overall_score: top.overall_score,\n      tier: top.tier,\n      reasoning\n    };\n\n    logger.info('Model optimization complete', {\n      selected: recommendation.modelName,\n      score: recommendation.overall_score\n    });\n\n    return recommendation;\n  }\n\n  /**\n   * Infer task complexity from task description\n   */\n  private static inferComplexity(task: string): 'simple' | 'moderate' | 'complex' | 'expert' {\n    const lowerTask = task.toLowerCase();\n\n    // Expert-level indicators\n    if (\n      lowerTask.includes('architecture') ||\n      lowerTask.includes('design system') ||\n      lowerTask.includes('production') ||\n      lowerTask.includes('enterprise') ||\n      lowerTask.includes('scale') ||\n      lowerTask.includes('distributed')\n    ) {\n      return 'expert';\n    }\n\n    // Complex indicators\n    if (\n      lowerTask.includes('implement') ||\n      lowerTask.includes('create') ||\n      lowerTask.includes('build') ||\n      lowerTask.includes('develop') ||\n      lowerTask.includes('integrate') ||\n      lowerTask.includes('api') ||\n      lowerTask.includes('database')\n    ) {\n      return 'complex';\n    }\n\n    // Simple indicators\n    if (\n      lowerTask.includes('simple') ||\n      lowerTask.includes('basic') ||\n      lowerTask.includes('hello world') ||\n      lowerTask.includes('example') ||\n      lowerTask.includes('template')\n    ) {\n      return 'simple';\n    }\n\n    // Default to moderate\n    return 'moderate';\n  }\n\n  /**\n   * Estimate cost for a task (rough approximation)\n   */\n  private static estimateCost(model: any, task: string): number {\n    // Rough estimate: task length + expected output\n    const inputTokens = Math.ceil(task.length / 4);\n    const outputTokens = 1000; // Assume 1K token output\n\n    const inputCost = (inputTokens / 1000000) * model.cost_per_1m_input;\n    const outputCost = (outputTokens / 1000000) * model.cost_per_1m_output;\n\n    return inputCost + outputCost;\n  }\n\n  /**\n   * Generate human-readable reasoning for model selection\n   */\n  private static generateReasoning(\n    model: any,\n    criteria: OptimizationCriteria,\n    agentReqs: any,\n    taskComplexity: string,\n    priority: string\n  ): string {\n    const reasons: string[] = [];\n\n    // Priority-based reasoning\n    switch (priority) {\n      case 'quality':\n        reasons.push(`Selected for highest quality (${model.quality_score}/100)`);\n        break;\n      case 'cost':\n        reasons.push(`Selected for best cost efficiency (${model.cost_score}/100)`);\n        break;\n      case 'speed':\n        reasons.push(`Selected for fastest response (${model.speed_score}/100)`);\n        break;\n      case 'privacy':\n        if (model.tier === 'local') {\n          reasons.push('Selected for 100% privacy (runs locally)');\n        } else {\n          reasons.push('Best available option for privacy concerns');\n        }\n        break;\n      case 'balanced':\n        reasons.push(`Balanced selection (overall: ${Math.round(model.overall_score)}/100)`);\n        break;\n    }\n\n    // Agent-specific reasoning\n    if (model.bestFor.includes(criteria.agent.toLowerCase())) {\n      reasons.push(`Optimized for ${criteria.agent} agent tasks`);\n    }\n\n    // Complexity matching\n    if (taskComplexity === 'expert' && model.tier === 'flagship') {\n      reasons.push('Flagship model for expert-level complexity');\n    } else if (taskComplexity === 'simple' && model.tier !== 'flagship') {\n      reasons.push('Cost-effective for simple tasks');\n    }\n\n    // Cost information\n    const estCost = this.estimateCost(model, criteria.task);\n    reasons.push(`Estimated cost: $${estCost.toFixed(6)} per task`);\n\n    // Tier information\n    reasons.push(`Tier: ${model.tier}`);\n\n    return reasons.join('. ');\n  }\n\n  /**\n   * Get all available models with their characteristics\n   */\n  static getAvailableModels(): typeof MODEL_DATABASE {\n    return MODEL_DATABASE;\n  }\n\n  /**\n   * Display optimization recommendations in console\n   */\n  static displayRecommendation(recommendation: ModelRecommendation): void {\n    console.log('\\n🎯 Optimized Model Selection');\n    console.log('═'.repeat(60));\n    console.log(`Model: ${recommendation.modelName}`);\n    console.log(`Provider: ${recommendation.provider}`);\n    console.log(`Tier: ${recommendation.tier}`);\n    console.log('');\n    console.log('Scores:');\n    console.log(`  Quality:  ${recommendation.quality_score}/100`);\n    console.log(`  Speed:    ${recommendation.speed_score}/100`);\n    console.log(`  Cost:     ${recommendation.cost_score}/100`);\n    console.log(`  Overall:  ${Math.round(recommendation.overall_score)}/100`);\n    console.log('');\n    console.log('Cost: $' + recommendation.cost_per_1m_input.toFixed(2) + '/1M input, ' +\n                '$' + recommendation.cost_per_1m_output.toFixed(2) + '/1M output');\n    console.log('');\n    console.log('Reasoning:');\n    console.log(`  ${recommendation.reasoning}`);\n    console.log('═'.repeat(60));\n    console.log('');\n  }\n}\n"]}

package/dist/utils/rate-limiter.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Simple in-memory rate limiter for proxy protection
+ */
+export interface RateLimiterConfig {
+    points: number;
+    duration: number;
+    blockDuration: number;
+}
+export declare class RateLimiter {
+    private config;
+    private clients;
+    private cleanupInterval;
+    constructor(config: RateLimiterConfig);
+    consume(key: string): Promise<void>;
+    destroy(): void;
+}
+//# sourceMappingURL=rate-limiter.d.ts.map

package/dist/utils/rate-limiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.d.ts","sourceRoot":"","sources":["../../src/utils/rate-limiter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;CACvB;AAQD,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,OAAO,CAAwC;IACvD,OAAO,CAAC,eAAe,CAAiB;gBAE5B,MAAM,EAAE,iBAAiB;IAc/B,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA6BzC,OAAO,IAAI,IAAI;CAIhB"}

package/dist/utils/rate-limiter.js

@@ -46,3 +46,4 @@ export class RateLimiter {
         this.clients.clear();
     }
 }
+//# sourceMappingURL=rate-limiter.js.map

package/dist/utils/rate-limiter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.js","sourceRoot":"","sources":["../../src/utils/rate-limiter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAcH,MAAM,OAAO,WAAW;IACd,MAAM,CAAoB;IAC1B,OAAO,GAA8B,IAAI,GAAG,EAAE,CAAC;IAC/C,eAAe,CAAiB;IAExC,YAAY,MAAyB;QACnC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QAErB,uCAAuC;QACvC,IAAI,CAAC,eAAe,GAAG,WAAW,CAAC,GAAG,EAAE;YACtC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACvB,KAAK,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;gBACnD,IAAI,MAAM,CAAC,SAAS,GAAG,GAAG,IAAI,CAAC,CAAC,MAAM,CAAC,YAAY,IAAI,MAAM,CAAC,YAAY,GAAG,GAAG,CAAC,EAAE,CAAC;oBAClF,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAC3B,CAAC;YACH,CAAC;QACH,CAAC,EAAE,KAAK,CAAC,CAAC;IACZ,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,GAAW;QACvB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAErC,6BAA6B;QAC7B,IAAI,MAAM,EAAE,YAAY,IAAI,MAAM,CAAC,YAAY,GAAG,GAAG,EAAE,CAAC;YACtD,MAAM,WAAW,GAAG,MAAM,CAAC,YAAY,GAAG,GAAG,CAAC;YAC9C,MAAM,IAAI,KAAK,CAAC,qCAAqC,IAAI,CAAC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC;QAChG,CAAC;QAED,6BAA6B;QAC7B,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,SAAS,GAAG,GAAG,EAAE,CAAC;YACtC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE;gBACpB,KAAK,EAAE,CAAC;gBACR,SAAS,EAAE,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,GAAG,IAAI;aAC7C,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QAED,kBAAkB;QAClB,MAAM,CAAC,KAAK,EAAE,CAAC;QAEf,0BAA0B;QAC1B,IAAI,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACtC,MAAM,CAAC,YAAY,GAAG,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,aAAa,GAAG,IAAI,CAAC;YAC7D,MAAM,IAAI,KAAK,CAAC,wBAAwB,IAAI,CAAC,MAAM,CAAC,MAAM,iBAAiB,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,CAAC,CAAC;QACvG,CAAC;IACH,CAAC;IAED,OAAO;QACL,aAAa,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QACpC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;CACF","sourcesContent":["/**\n * Simple in-memory rate limiter for proxy protection\n */\n\nexport interface RateLimiterConfig {\n  points: number; // Number of requests\n  duration: number; // Time window in seconds\n  blockDuration: number; // Block duration in seconds when exceeded\n}\n\ninterface ClientRecord {\n  count: number;\n  resetTime: number;\n  blockedUntil?: number;\n}\n\nexport class RateLimiter {\n  private config: RateLimiterConfig;\n  private clients: Map<string, ClientRecord> = new Map();\n  private cleanupInterval: NodeJS.Timeout;\n\n  constructor(config: RateLimiterConfig) {\n    this.config = config;\n\n    // Cleanup expired entries every minute\n    this.cleanupInterval = setInterval(() => {\n      const now = Date.now();\n      for (const [key, record] of this.clients.entries()) {\n        if (record.resetTime < now && (!record.blockedUntil || record.blockedUntil < now)) {\n          this.clients.delete(key);\n        }\n      }\n    }, 60000);\n  }\n\n  async consume(key: string): Promise<void> {\n    const now = Date.now();\n    const record = this.clients.get(key);\n\n    // Check if client is blocked\n    if (record?.blockedUntil && record.blockedUntil > now) {\n      const remainingMs = record.blockedUntil - now;\n      throw new Error(`Rate limit exceeded. Try again in ${Math.ceil(remainingMs / 1000)} seconds`);\n    }\n\n    // Initialize or reset record\n    if (!record || record.resetTime < now) {\n      this.clients.set(key, {\n        count: 1,\n        resetTime: now + this.config.duration * 1000\n      });\n      return;\n    }\n\n    // Increment count\n    record.count++;\n\n    // Check if limit exceeded\n    if (record.count > this.config.points) {\n      record.blockedUntil = now + this.config.blockDuration * 1000;\n      throw new Error(`Rate limit exceeded (${this.config.points} requests per ${this.config.duration}s)`);\n    }\n  }\n\n  destroy(): void {\n    clearInterval(this.cleanupInterval);\n    this.clients.clear();\n  }\n}\n"]}

package/dist/utils/reasoningbankCommands.d.ts

@@ -0,0 +1,6 @@
+/**
+ * ReasoningBank CLI Commands
+ * Handles demo, test, init, benchmark, status, consolidate, list
+ */
+export declare function handleReasoningBankCommand(subcommand: string): Promise<void>;
+//# sourceMappingURL=reasoningbankCommands.d.ts.map

package/dist/utils/reasoningbankCommands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reasoningbankCommands.d.ts","sourceRoot":"","sources":["../../src/utils/reasoningbankCommands.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH,wBAAsB,0BAA0B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA0ClF"}

package/dist/utils/reasoningbankCommands.js

@@ -202,3 +202,4 @@ EXAMPLES:
 For more information: https://github.com/ruvnet/agentic-flow
   `);
 }
+//# sourceMappingURL=reasoningbankCommands.js.map

package/dist/utils/reasoningbankCommands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reasoningbankCommands.js","sourceRoot":"","sources":["../../src/utils/reasoningbankCommands.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * ReasoningBank CLI Commands\n * Handles demo, test, init, benchmark, status, consolidate, list\n */\n\nimport { spawn } from 'child_process';\nimport { join } from 'path';\nimport { fileURLToPath } from 'url';\nimport { dirname } from 'path';\n\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = dirname(__filename);\n\nexport async function handleReasoningBankCommand(subcommand: string): Promise<void> {\n  const args = process.argv.slice(4); // Get args after 'reasoningbank <subcommand>'\n\n  try {\n    switch (subcommand) {\n      case 'demo':\n        await runExternalScript('../reasoningbank/demo-comparison.js');\n        break;\n\n      case 'test':\n        await runExternalScript('../reasoningbank/test-validation.js');\n        break;\n\n      case 'init':\n        await initDatabase();\n        break;\n\n      case 'benchmark':\n        await runExternalScript('../reasoningbank/benchmark.js');\n        break;\n\n      case 'status':\n        await showStatus();\n        break;\n\n      case 'consolidate':\n        await runConsolidation();\n        break;\n\n      case 'list':\n        await listMemories(args);\n        break;\n\n      case 'help':\n      default:\n        printHelp();\n        break;\n    }\n  } catch (error) {\n    console.error(`\\n❌ Error: ${error instanceof Error ? error.message : String(error)}\\n`);\n    process.exit(1);\n  }\n}\n\nasync function runExternalScript(relativePath: string): Promise<void> {\n  const scriptPath = join(__dirname, relativePath);\n\n  return new Promise((resolve, reject) => {\n    const child = spawn('node', [scriptPath], {\n      stdio: 'inherit',\n      cwd: process.cwd()\n    });\n\n    child.on('exit', (code) => {\n      if (code === 0) {\n        resolve();\n      } else {\n        reject(new Error(`Script exited with code ${code}`));\n      }\n    });\n\n    child.on('error', (error) => {\n      reject(error);\n    });\n  });\n}\n\nasync function initDatabase() {\n  console.log('\\n🔧 Initializing ReasoningBank Database');\n  console.log('═'.repeat(50));\n\n  const { initialize } = await import('../reasoningbank/index.js');\n\n  console.log('\\nInitializing database with migrations...\\n');\n\n  await initialize();\n\n  console.log('\\n✅ Database initialized successfully!');\n  console.log('\\nSchema created:');\n  console.log('  • patterns (reasoning memories)');\n  console.log('  • pattern_embeddings');\n  console.log('  • pattern_links');\n  console.log('  • task_trajectories');\n  console.log('  • matts_runs');\n  console.log('  • consolidation_runs');\n  console.log('  • metrics_log\\n');\n}\n\nasync function showStatus() {\n  console.log('\\n📊 ReasoningBank Status');\n  console.log('═'.repeat(50));\n\n  const { db } = await import('../reasoningbank/index.js');\n  const dbInstance = db.getDb();\n\n  const stats = {\n    totalMemories: dbInstance.prepare(\"SELECT COUNT(*) as count FROM patterns WHERE type = 'reasoning_memory'\").get() as { count: number },\n    avgConfidence: dbInstance.prepare(\"SELECT AVG(confidence) as avg FROM patterns WHERE type = 'reasoning_memory'\").get() as { avg: number },\n    totalEmbeddings: dbInstance.prepare('SELECT COUNT(*) as count FROM pattern_embeddings').get() as { count: number },\n    totalTrajectories: dbInstance.prepare('SELECT COUNT(*) as count FROM task_trajectories').get() as { count: number }\n  };\n\n  console.log(`\\n📈 Statistics:`);\n  console.log(`  • Total memories: ${stats.totalMemories.count}`);\n  console.log(`  • Average confidence: ${stats.avgConfidence.avg?.toFixed(2) || 'N/A'}`);\n  console.log(`  • Total embeddings: ${stats.totalEmbeddings.count}`);\n  console.log(`  • Total trajectories: ${stats.totalTrajectories.count}\\n`);\n}\n\nasync function runConsolidation() {\n  console.log('\\n🔄 Running Memory Consolidation');\n  console.log('═'.repeat(50));\n  console.log('\\nDeduplicating and pruning memories...\\n');\n\n  const { consolidate } = await import('../reasoningbank/index.js');\n\n  const startTime = Date.now();\n  const result = await consolidate();\n  const duration = Date.now() - startTime;\n\n  console.log('✅ Consolidation complete!\\n');\n  console.log(`📊 Results:`);\n  console.log(`  • Memories processed: ${result.itemsProcessed}`);\n  console.log(`  • Duplicates found: ${result.duplicatesFound}`);\n  console.log(`  • Contradictions found: ${result.contradictionsFound}`);\n  console.log(`  • Pruned: ${result.itemsPruned}`);\n  console.log(`  • Duration: ${result.durationMs}ms\\n`);\n}\n\nasync function listMemories(args: string[]) {\n  const { db } = await import('../reasoningbank/index.js');\n  const dbInstance = db.getDb();\n\n  // Parse arguments\n  const sortBy = args.includes('--sort') ? args[args.indexOf('--sort') + 1] : 'created_at';\n  const limit = args.includes('--limit') ? parseInt(args[args.indexOf('--limit') + 1], 10) : 10;\n\n  console.log('\\n📚 Memory Bank Contents');\n  console.log('═'.repeat(50));\n  console.log(`\\nShowing top ${limit} memories (sorted by ${sortBy})\\n`);\n\n  let orderBy = 'created_at DESC';\n  if (sortBy === 'confidence') {\n    orderBy = 'confidence DESC';\n  } else if (sortBy === 'usage') {\n    orderBy = 'usage_count DESC';\n  }\n\n  const memories = dbInstance.prepare(`\n    SELECT\n      id,\n      json_extract(pattern_data, '$.title') as title,\n      json_extract(pattern_data, '$.description') as description,\n      json_extract(pattern_data, '$.domain') as domain,\n      confidence,\n      usage_count,\n      created_at\n    FROM patterns\n    WHERE type = 'reasoning_memory'\n    ORDER BY ${orderBy}\n    LIMIT ?\n  `).all(limit) as any[];\n\n  if (memories.length === 0) {\n    console.log('No memories found. Run `npx agentic-flow reasoningbank demo` to create some!\\n');\n    return;\n  }\n\n  for (let i = 0; i < memories.length; i++) {\n    const mem = memories[i];\n    console.log(`${i + 1}. ${mem.title}`);\n    console.log(`   Confidence: ${parseFloat(mem.confidence).toFixed(2)} | Usage: ${mem.usage_count} | Created: ${mem.created_at}`);\n    console.log(`   Domain: ${mem.domain}`);\n    console.log(`   ${mem.description}`);\n    console.log('');\n  }\n}\n\nfunction printHelp() {\n  console.log(`\n🧠 ReasoningBank - Closed-loop memory system for AI agents\n\nUSAGE:\n  npx agentic-flow reasoningbank <COMMAND>\n\nCOMMANDS:\n  demo          Run interactive demo showing learning progression\n  test          Run validation test suite\n  init          Initialize database schema\n  benchmark     Run performance benchmarks\n  status        Show memory statistics\n  consolidate   Run memory consolidation now\n  list          List memories with options\n  help          Show this help message\n\nLIST OPTIONS:\n  --sort <field>    Sort by: confidence, usage, created_at (default)\n  --limit <n>       Show top N memories (default: 10)\n\nEXAMPLES:\n  # Run demo to see 0% → 100% success transformation\n  npx agentic-flow reasoningbank demo\n\n  # Initialize database\n  npx agentic-flow reasoningbank init\n\n  # Run validation tests\n  npx agentic-flow reasoningbank test\n\n  # Show current statistics\n  npx agentic-flow reasoningbank status\n\n  # Consolidate memories (dedupe + prune)\n  npx agentic-flow reasoningbank consolidate\n\n  # List top 10 memories by confidence\n  npx agentic-flow reasoningbank list --sort confidence --limit 10\n\n  # List top 5 most used memories\n  npx agentic-flow reasoningbank list --sort usage --limit 5\n\nFor more information: https://github.com/ruvnet/agentic-flow\n  `);\n}\n"]}

package/dist/utils/response-cache.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Response Cache with LRU Eviction
+ * Provides 50-80% latency reduction for repeated queries
+ */
+export interface CacheConfig {
+    maxSize: number;
+    ttl: number;
+    updateAgeOnGet: boolean;
+    enableStats: boolean;
+}
+export interface CachedResponse {
+    data: Buffer;
+    headers: Record<string, string>;
+    statusCode: number;
+    timestamp: number;
+    hits: number;
+}
+export interface CacheStats {
+    size: number;
+    maxSize: number;
+    hits: number;
+    misses: number;
+    hitRate: number;
+    evictions: number;
+    totalSavings: number;
+}
+export declare class ResponseCache {
+    private cache;
+    private accessOrder;
+    private config;
+    private stats;
+    constructor(config?: Partial<CacheConfig>);
+    /**
+     * Get cached response
+     */
+    get(key: string): CachedResponse | undefined;
+    /**
+     * Set cached response
+     */
+    set(key: string, value: CachedResponse): void;
+    /**
+     * Generate cache key from request
+     */
+    generateKey(req: {
+        model?: string;
+        messages?: unknown[];
+        max_tokens?: number;
+        temperature?: number;
+        stream?: boolean;
+    }): string;
+    /**
+     * Check if response should be cached
+     */
+    shouldCache(req: {
+        stream?: boolean;
+    }, statusCode: number): boolean;
+    /**
+     * Clear expired entries
+     */
+    private cleanup;
+    /**
+     * Evict least recently used entry
+     */
+    private evictLRU;
+    /**
+     * Check if entry is expired
+     */
+    private isExpired;
+    /**
+     * Remove key from access order
+     */
+    private removeFromAccessOrder;
+    /**
+     * Update hit rate statistic
+     */
+    private updateHitRate;
+    /**
+     * Simple hash function for cache keys
+     */
+    private hash;
+    /**
+     * Get cache statistics
+     */
+    getStats(): CacheStats;
+    /**
+     * Clear cache
+     */
+    clear(): void;
+    /**
+     * Destroy cache and cleanup
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=response-cache.d.ts.map

package/dist/utils/response-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-cache.d.ts","sourceRoot":"","sources":["../../src/utils/response-cache.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,EAAE,OAAO,CAAC;IACxB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,KAAK,CAA0C;IACvD,OAAO,CAAC,WAAW,CAAgB;IACnC,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,KAAK,CAAa;gBAEd,MAAM,GAAE,OAAO,CAAC,WAAW,CAAM;IAsB7C;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAwC5C;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,IAAI;IAyB7C;;OAEG;IACH,WAAW,CAAC,GAAG,EAAE;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;QACrB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,MAAM,CAAC,EAAE,OAAO,CAAC;KAClB,GAAG,MAAM;IAiBV;;OAEG;IACH,WAAW,CAAC,GAAG,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO;IAcnE;;OAEG;IACH,OAAO,CAAC,OAAO;IAmBf;;OAEG;IACH,OAAO,CAAC,QAAQ;IAehB;;OAEG;IACH,OAAO,CAAC,SAAS;IAIjB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAO7B;;OAEG;IACH,OAAO,CAAC,aAAa;IAKrB;;OAEG;IACH,OAAO,CAAC,IAAI;IAUZ;;OAEG;IACH,QAAQ,IAAI,UAAU;IAItB;;OAEG;IACH,KAAK,IAAI,IAAI;IAQb;;OAEG;IACH,OAAO,IAAI,IAAI;CAGhB"}

package/dist/utils/response-cache.js

@@ -209,3 +209,4 @@ export class ResponseCache {
         this.clear();
     }
 }
+//# sourceMappingURL=response-cache.js.map

package/dist/utils/response-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-cache.js","sourceRoot":"","sources":["../../src/utils/response-cache.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Response Cache with LRU Eviction\n * Provides 50-80% latency reduction for repeated queries\n */\n\nimport { logger } from './logger.js';\n\nexport interface CacheConfig {\n  maxSize: number;\n  ttl: number; // Time to live in milliseconds\n  updateAgeOnGet: boolean;\n  enableStats: boolean;\n}\n\nexport interface CachedResponse {\n  data: Buffer;\n  headers: Record<string, string>;\n  statusCode: number;\n  timestamp: number;\n  hits: number;\n}\n\nexport interface CacheStats {\n  size: number;\n  maxSize: number;\n  hits: number;\n  misses: number;\n  hitRate: number;\n  evictions: number;\n  totalSavings: number; // Estimated bandwidth saved\n}\n\nexport class ResponseCache {\n  private cache: Map<string, CachedResponse> = new Map();\n  private accessOrder: string[] = []; // LRU tracking\n  private config: Required<CacheConfig>;\n  private stats: CacheStats;\n\n  constructor(config: Partial<CacheConfig> = {}) {\n    this.config = {\n      maxSize: config.maxSize || 100,\n      ttl: config.ttl || 60000, // 60 seconds default\n      updateAgeOnGet: config.updateAgeOnGet ?? true,\n      enableStats: config.enableStats ?? true\n    };\n\n    this.stats = {\n      size: 0,\n      maxSize: this.config.maxSize,\n      hits: 0,\n      misses: 0,\n      hitRate: 0,\n      evictions: 0,\n      totalSavings: 0\n    };\n\n    // Cleanup expired entries every minute\n    setInterval(() => this.cleanup(), 60000);\n  }\n\n  /**\n   * Get cached response\n   */\n  get(key: string): CachedResponse | undefined {\n    const entry = this.cache.get(key);\n\n    if (!entry) {\n      this.stats.misses++;\n      this.updateHitRate();\n      return undefined;\n    }\n\n    // Check if expired\n    if (this.isExpired(entry)) {\n      this.cache.delete(key);\n      this.removeFromAccessOrder(key);\n      this.stats.misses++;\n      this.stats.size = this.cache.size;\n      this.updateHitRate();\n      return undefined;\n    }\n\n    // Update access order for LRU\n    if (this.config.updateAgeOnGet) {\n      this.removeFromAccessOrder(key);\n      this.accessOrder.push(key);\n      entry.timestamp = Date.now();\n    }\n\n    entry.hits++;\n    this.stats.hits++;\n    this.stats.totalSavings += entry.data.length;\n    this.updateHitRate();\n\n    logger.debug('Cache hit', {\n      key: key.substring(0, 50),\n      hits: entry.hits,\n      age: Date.now() - entry.timestamp\n    });\n\n    return entry;\n  }\n\n  /**\n   * Set cached response\n   */\n  set(key: string, value: CachedResponse): void {\n    // Evict if at capacity\n    if (this.cache.size >= this.config.maxSize && !this.cache.has(key)) {\n      this.evictLRU();\n    }\n\n    // Update access order\n    if (this.cache.has(key)) {\n      this.removeFromAccessOrder(key);\n    }\n    this.accessOrder.push(key);\n\n    // Store entry\n    value.timestamp = Date.now();\n    value.hits = 0;\n    this.cache.set(key, value);\n    this.stats.size = this.cache.size;\n\n    logger.debug('Cache set', {\n      key: key.substring(0, 50),\n      size: value.data.length,\n      cacheSize: this.cache.size\n    });\n  }\n\n  /**\n   * Generate cache key from request\n   */\n  generateKey(req: {\n    model?: string;\n    messages?: unknown[];\n    max_tokens?: number;\n    temperature?: number;\n    stream?: boolean;\n  }): string {\n    // Don't cache streaming requests\n    if (req.stream) {\n      return '';\n    }\n\n    const parts = [\n      req.model || 'default',\n      JSON.stringify(req.messages || []),\n      req.max_tokens?.toString() || '1000',\n      req.temperature?.toString() || '1.0'\n    ];\n\n    // Use hash to keep key short\n    return this.hash(parts.join(':'));\n  }\n\n  /**\n   * Check if response should be cached\n   */\n  shouldCache(req: { stream?: boolean }, statusCode: number): boolean {\n    // Don't cache streaming requests\n    if (req.stream) {\n      return false;\n    }\n\n    // Only cache successful responses\n    if (statusCode !== 200 && statusCode !== 201) {\n      return false;\n    }\n\n    return true;\n  }\n\n  /**\n   * Clear expired entries\n   */\n  private cleanup(): void {\n    const now = Date.now();\n    let removed = 0;\n\n    for (const [key, entry] of this.cache.entries()) {\n      if (this.isExpired(entry)) {\n        this.cache.delete(key);\n        this.removeFromAccessOrder(key);\n        removed++;\n      }\n    }\n\n    this.stats.size = this.cache.size;\n\n    if (removed > 0) {\n      logger.debug('Cache cleanup', { removed, remaining: this.cache.size });\n    }\n  }\n\n  /**\n   * Evict least recently used entry\n   */\n  private evictLRU(): void {\n    if (this.accessOrder.length === 0) return;\n\n    const lruKey = this.accessOrder.shift();\n    if (lruKey) {\n      this.cache.delete(lruKey);\n      this.stats.evictions++;\n\n      logger.debug('Cache eviction (LRU)', {\n        key: lruKey.substring(0, 50),\n        cacheSize: this.cache.size\n      });\n    }\n  }\n\n  /**\n   * Check if entry is expired\n   */\n  private isExpired(entry: CachedResponse): boolean {\n    return (Date.now() - entry.timestamp) > this.config.ttl;\n  }\n\n  /**\n   * Remove key from access order\n   */\n  private removeFromAccessOrder(key: string): void {\n    const index = this.accessOrder.indexOf(key);\n    if (index !== -1) {\n      this.accessOrder.splice(index, 1);\n    }\n  }\n\n  /**\n   * Update hit rate statistic\n   */\n  private updateHitRate(): void {\n    const total = this.stats.hits + this.stats.misses;\n    this.stats.hitRate = total > 0 ? this.stats.hits / total : 0;\n  }\n\n  /**\n   * Simple hash function for cache keys\n   */\n  private hash(str: string): string {\n    let hash = 0;\n    for (let i = 0; i < str.length; i++) {\n      const char = str.charCodeAt(i);\n      hash = ((hash << 5) - hash) + char;\n      hash = hash & hash; // Convert to 32-bit integer\n    }\n    return Math.abs(hash).toString(36);\n  }\n\n  /**\n   * Get cache statistics\n   */\n  getStats(): CacheStats {\n    return { ...this.stats };\n  }\n\n  /**\n   * Clear cache\n   */\n  clear(): void {\n    this.cache.clear();\n    this.accessOrder = [];\n    this.stats.size = 0;\n    this.stats.evictions = 0;\n    logger.info('Cache cleared');\n  }\n\n  /**\n   * Destroy cache and cleanup\n   */\n  destroy(): void {\n    this.clear();\n  }\n}\n"]}

package/dist/utils/retry.d.ts

@@ -0,0 +1,9 @@
+interface RetryOptions {
+    maxAttempts?: number;
+    baseDelay?: number;
+    maxDelay?: number;
+    shouldRetry?: (error: any) => boolean;
+}
+export declare function withRetry<T>(fn: () => Promise<T>, options?: RetryOptions): Promise<T>;
+export {};
+//# sourceMappingURL=retry.d.ts.map

package/dist/utils/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/utils/retry.ts"],"names":[],"mappings":"AAGA,UAAU,YAAY;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,OAAO,CAAC;CACvC;AAgBD,wBAAsB,SAAS,CAAC,CAAC,EAC/B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,CAAC,CAAC,CA2CZ"}

package/dist/utils/retry.js

@@ -52,3 +52,4 @@ export async function withRetry(fn, options = {}) {
     }
     throw lastError;
 }
+//# sourceMappingURL=retry.js.map

package/dist/utils/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../src/utils/retry.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AASrC,MAAM,cAAc,GAA2B;IAC7C,WAAW,EAAE,CAAC;IACd,SAAS,EAAE,IAAI;IACf,QAAQ,EAAE,KAAK;IACf,WAAW,EAAE,CAAC,KAAU,EAAE,EAAE;QAC1B,0DAA0D;QAC1D,IAAI,KAAK,EAAE,MAAM,IAAI,GAAG;YAAE,OAAO,IAAI,CAAC;QACtC,IAAI,KAAK,EAAE,MAAM,KAAK,GAAG;YAAE,OAAO,IAAI,CAAC;QACvC,IAAI,KAAK,EAAE,IAAI,KAAK,YAAY;YAAE,OAAO,IAAI,CAAC;QAC9C,IAAI,KAAK,EAAE,IAAI,KAAK,WAAW;YAAE,OAAO,IAAI,CAAC;QAC7C,OAAO,KAAK,CAAC;IACf,CAAC;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,EAAoB,EACpB,UAAwB,EAAE;IAE1B,MAAM,IAAI,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,OAAO,EAAE,CAAC;IAC/C,IAAI,SAAkB,CAAC;IAEvB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,IAAI,CAAC,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC;QAC7D,IAAI,CAAC;YACH,MAAM,CAAC,KAAK,CAAC,sBAAsB,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;YACjF,OAAO,MAAM,EAAE,EAAE,CAAC;QACpB,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,SAAS,GAAG,KAAK,CAAC;YAElB,IAAI,OAAO,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;gBAChC,MAAM,CAAC,KAAK,CAAC,4BAA4B,EAAE;oBACzC,OAAO;oBACP,WAAW,EAAE,IAAI,CAAC,WAAW;oBAC7B,KAAK;iBACN,CAAC,CAAC;gBACH,MAAM,KAAK,CAAC;YACd,CAAC;YAED,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC7B,MAAM,CAAC,IAAI,CAAC,qBAAqB,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;gBAC9C,MAAM,KAAK,CAAC;YACd,CAAC;YAED,sCAAsC;YACtC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CACpB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,EAChE,IAAI,CAAC,QAAQ,CACd,CAAC;YAEF,MAAM,CAAC,IAAI,CAAC,4BAA4B,EAAE;gBACxC,OAAO;gBACP,WAAW,EAAE,OAAO,GAAG,CAAC;gBACxB,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC;gBAC1B,KAAK;aACN,CAAC,CAAC;YAEH,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;IAED,MAAM,SAAS,CAAC;AAClB,CAAC","sourcesContent":["// Retry utility with exponential backoff\nimport { logger } from './logger.js';\n\ninterface RetryOptions {\n  maxAttempts?: number;\n  baseDelay?: number;\n  maxDelay?: number;\n  shouldRetry?: (error: any) => boolean;\n}\n\nconst defaultOptions: Required<RetryOptions> = {\n  maxAttempts: 3,\n  baseDelay: 1000,\n  maxDelay: 10000,\n  shouldRetry: (error: any) => {\n    // Retry on network errors, rate limits, and server errors\n    if (error?.status >= 500) return true;\n    if (error?.status === 429) return true;\n    if (error?.code === 'ECONNRESET') return true;\n    if (error?.code === 'ETIMEDOUT') return true;\n    return false;\n  }\n};\n\nexport async function withRetry<T>(\n  fn: () => Promise<T>,\n  options: RetryOptions = {}\n): Promise<T> {\n  const opts = { ...defaultOptions, ...options };\n  let lastError: unknown;\n\n  for (let attempt = 1; attempt <= opts.maxAttempts; attempt++) {\n    try {\n      logger.debug('Attempting operation', { attempt, maxAttempts: opts.maxAttempts });\n      return await fn();\n    } catch (error: unknown) {\n      lastError = error;\n\n      if (attempt >= opts.maxAttempts) {\n        logger.error('Max retry attempts reached', {\n          attempt,\n          maxAttempts: opts.maxAttempts,\n          error\n        });\n        throw error;\n      }\n\n      if (!opts.shouldRetry(error)) {\n        logger.warn('Error not retryable', { error });\n        throw error;\n      }\n\n      // Calculate backoff delay with jitter\n      const delay = Math.min(\n        opts.baseDelay * Math.pow(2, attempt - 1) + Math.random() * 1000,\n        opts.maxDelay\n      );\n\n      logger.warn('Operation failed, retrying', {\n        attempt,\n        nextAttempt: attempt + 1,\n        delayMs: Math.round(delay),\n        error\n      });\n\n      await new Promise(resolve => setTimeout(resolve, delay));\n    }\n  }\n\n  throw lastError;\n}\n"]}