agentic-flow 2.0.7 → 3.0.0-alpha.2

package/dist/agentic-flow/src/utils/modelCapabilities.js

@@ -0,0 +1,277 @@
+/**
+ * Model Capability Detection
+ * Determines if a model supports native tool calling or requires emulation
+ */
+/**
+ * Database of known model capabilities
+ * Updated periodically as new models are released
+ */
+const MODEL_CAPABILITIES = {
+    // OpenRouter - Native Tool Support
+    'deepseek/deepseek-chat': {
+        supportsNativeTools: true,
+        contextWindow: 128000,
+        requiresEmulation: false,
+        emulationStrategy: 'none',
+        costPerMillionTokens: 0.15
+    },
+    'deepseek/deepseek-chat-v3': {
+        supportsNativeTools: true,
+        contextWindow: 128000,
+        requiresEmulation: false,
+        emulationStrategy: 'none',
+        costPerMillionTokens: 0.15
+    },
+    'meta-llama/llama-3.3-70b-instruct': {
+        supportsNativeTools: true,
+        contextWindow: 128000,
+        requiresEmulation: false,
+        emulationStrategy: 'none',
+        costPerMillionTokens: 0.40
+    },
+    'qwen/qwen-2.5-coder-32b-instruct': {
+        supportsNativeTools: true,
+        contextWindow: 128000,
+        requiresEmulation: false,
+        emulationStrategy: 'none',
+        costPerMillionTokens: 0.23
+    },
+    'mistralai/mistral-small-3.1-24b-instruct': {
+        supportsNativeTools: true,
+        contextWindow: 128000,
+        requiresEmulation: false,
+        emulationStrategy: 'none',
+        costPerMillionTokens: 0.30
+    },
+    // OpenAI Models (via OpenRouter/Requesty)
+    'openai/gpt-4o': {
+        supportsNativeTools: true,
+        contextWindow: 128000,
+        requiresEmulation: false,
+        emulationStrategy: 'none',
+        costPerMillionTokens: 2.50
+    },
+    'openai/gpt-4o-mini': {
+        supportsNativeTools: true,
+        contextWindow: 128000,
+        requiresEmulation: false,
+        emulationStrategy: 'none',
+        costPerMillionTokens: 0.15
+    },
+    'openai/gpt-4-turbo': {
+        supportsNativeTools: true,
+        contextWindow: 128000,
+        requiresEmulation: false,
+        emulationStrategy: 'none',
+        costPerMillionTokens: 10.00
+    },
+    // OpenRouter - No Native Tool Support (Require Emulation)
+    'mistralai/mistral-7b-instruct': {
+        supportsNativeTools: false,
+        contextWindow: 32000,
+        requiresEmulation: true,
+        emulationStrategy: 'react', // Best for this model
+        costPerMillionTokens: 0.07
+    },
+    'meta-llama/llama-2-13b-chat': {
+        supportsNativeTools: false,
+        contextWindow: 4096,
+        requiresEmulation: true,
+        emulationStrategy: 'prompt', // Simple prompting works best
+        costPerMillionTokens: 0.05
+    },
+    'google/gemma-7b-it': {
+        supportsNativeTools: false,
+        contextWindow: 8192,
+        requiresEmulation: true,
+        emulationStrategy: 'prompt',
+        costPerMillionTokens: 0.07
+    },
+    'thudm/glm-4-9b:free': {
+        supportsNativeTools: false, // Free tier limited
+        contextWindow: 32000,
+        requiresEmulation: true,
+        emulationStrategy: 'react',
+        costPerMillionTokens: 0.0 // FREE
+    },
+    // Anthropic - Native Tool Support
+    'claude-3-5-sonnet-20241022': {
+        supportsNativeTools: true,
+        contextWindow: 200000,
+        requiresEmulation: false,
+        emulationStrategy: 'none',
+        costPerMillionTokens: 3.0
+    },
+    'claude-3-5-haiku-20241022': {
+        supportsNativeTools: true,
+        contextWindow: 200000,
+        requiresEmulation: false,
+        emulationStrategy: 'none',
+        costPerMillionTokens: 0.80
+    },
+    // Gemini - Native Tool Support
+    'gemini-2.0-flash-exp': {
+        supportsNativeTools: true,
+        contextWindow: 1000000,
+        requiresEmulation: false,
+        emulationStrategy: 'none',
+        costPerMillionTokens: 0.0 // FREE tier
+    },
+    // OpenAI - Native Tool Support
+    'gpt-4o': {
+        supportsNativeTools: true,
+        contextWindow: 128000,
+        requiresEmulation: false,
+        emulationStrategy: 'none',
+        costPerMillionTokens: 2.50
+    },
+    'gpt-4o-mini': {
+        supportsNativeTools: true,
+        contextWindow: 128000,
+        requiresEmulation: false,
+        emulationStrategy: 'none',
+        costPerMillionTokens: 0.15
+    },
+    'gpt-3.5-turbo': {
+        supportsNativeTools: true,
+        contextWindow: 16385,
+        requiresEmulation: false,
+        emulationStrategy: 'none',
+        costPerMillionTokens: 0.50
+    }
+};
+/**
+ * Pattern matching for model families
+ */
+const MODEL_PATTERNS = [
+    {
+        pattern: /^claude-3/,
+        capabilities: { supportsNativeTools: true, requiresEmulation: false }
+    },
+    {
+        pattern: /^gpt-(4|3\.5)/,
+        capabilities: { supportsNativeTools: true, requiresEmulation: false }
+    },
+    {
+        pattern: /^gemini-/,
+        capabilities: { supportsNativeTools: true, requiresEmulation: false }
+    },
+    {
+        pattern: /deepseek\/deepseek-(chat|coder)/,
+        capabilities: { supportsNativeTools: true, requiresEmulation: false }
+    },
+    {
+        pattern: /llama-3\.(3|2|1)-.*instruct/,
+        capabilities: { supportsNativeTools: true, requiresEmulation: false }
+    },
+    {
+        pattern: /qwen.*2\.5/,
+        capabilities: { supportsNativeTools: true, requiresEmulation: false }
+    },
+    {
+        pattern: /mistral.*large|mistral.*small/,
+        capabilities: { supportsNativeTools: true, requiresEmulation: false }
+    },
+    // Older models typically don't support tools
+    {
+        pattern: /llama-2|mistral-7b|gemma-.*7b/,
+        capabilities: { supportsNativeTools: false, requiresEmulation: true, emulationStrategy: 'react' }
+    }
+];
+/**
+ * Detect capabilities of a model
+ */
+export function detectModelCapabilities(modelId) {
+    // Direct lookup
+    if (MODEL_CAPABILITIES[modelId]) {
+        return {
+            supportsNativeTools: false,
+            supportsStreaming: true,
+            contextWindow: 4096,
+            requiresEmulation: true,
+            emulationStrategy: 'prompt',
+            costPerMillionTokens: 0.5,
+            provider: 'unknown',
+            ...MODEL_CAPABILITIES[modelId]
+        };
+    }
+    // Pattern matching
+    for (const { pattern, capabilities } of MODEL_PATTERNS) {
+        if (pattern.test(modelId)) {
+            return {
+                supportsNativeTools: false,
+                supportsStreaming: true,
+                contextWindow: 4096,
+                requiresEmulation: true,
+                emulationStrategy: 'prompt',
+                costPerMillionTokens: 0.5,
+                provider: 'unknown',
+                ...capabilities
+            };
+        }
+    }
+    // Unknown model - assume needs emulation (conservative)
+    console.warn(`⚠️  Unknown model: ${modelId}. Assuming no native tool support.`);
+    return {
+        supportsNativeTools: false,
+        supportsStreaming: true,
+        contextWindow: 4096,
+        requiresEmulation: true,
+        emulationStrategy: 'prompt',
+        costPerMillionTokens: 0.5,
+        provider: 'unknown'
+    };
+}
+/**
+ * Check if model can handle a specific number of tools
+ */
+export function canHandleToolCount(modelId, toolCount) {
+    const capabilities = detectModelCapabilities(modelId);
+    // Estimate: Each tool ~100 tokens of schema
+    const estimatedTokens = toolCount * 100;
+    // Need at least 20% of context window free for actual conversation
+    const maxToolTokens = capabilities.contextWindow * 0.8;
+    return estimatedTokens <= maxToolTokens;
+}
+/**
+ * Recommend optimal strategy for a model
+ */
+export function recommendStrategy(modelId, toolCount, taskComplexity) {
+    const capabilities = detectModelCapabilities(modelId);
+    if (capabilities.supportsNativeTools) {
+        return 'native';
+    }
+    // For emulation, choose based on context and complexity
+    if (toolCount > 10 || taskComplexity === 'complex') {
+        return 'react'; // More robust for complex scenarios
+    }
+    if (capabilities.contextWindow < 8000) {
+        return 'prompt'; // Simpler for small context windows
+    }
+    return 'react'; // Default to ReAct pattern
+}
+/**
+ * Get human-readable capability report
+ */
+export function getCapabilityReport(modelId) {
+    const cap = detectModelCapabilities(modelId);
+    let report = `\n📊 Model Capabilities: ${modelId}\n`;
+    report += `━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n`;
+    report += `Native Tool Support:  ${cap.supportsNativeTools ? '✅ Yes' : '❌ No'}\n`;
+    report += `Context Window:       ${cap.contextWindow.toLocaleString()} tokens\n`;
+    report += `Streaming:            ${cap.supportsStreaming ? '✅ Yes' : '❌ No'}\n`;
+    report += `Cost per 1M tokens:   $${cap.costPerMillionTokens}\n`;
+    if (cap.requiresEmulation) {
+        report += `\n⚙️  Emulation Required\n`;
+        report += `Recommended Strategy: ${cap.emulationStrategy.toUpperCase()}\n`;
+        report += `\nNote: This model will use prompt-based tool emulation.\n`;
+        report += `Expect 70-85% reliability vs 95%+ for native tool support.\n`;
+    }
+    else {
+        report += `\n✅ No Emulation Needed\n`;
+        report += `This model natively supports function calling.\n`;
+    }
+    report += `━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n`;
+    return report;
+}
+//# sourceMappingURL=modelCapabilities.js.map

package/dist/agentic-flow/src/utils/modelCapabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"modelCapabilities.js","sourceRoot":"","sources":["../../../../src/utils/modelCapabilities.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Model Capability Detection\n * Determines if a model supports native tool calling or requires emulation\n */\n\nexport interface ModelCapabilities {\n  supportsNativeTools: boolean;\n  supportsStreaming: boolean;\n  contextWindow: number;\n  requiresEmulation: boolean;\n  emulationStrategy: 'none' | 'react' | 'prompt' | 'hybrid';\n  costPerMillionTokens: number;\n  provider: string;\n}\n\n/**\n * Database of known model capabilities\n * Updated periodically as new models are released\n */\nconst MODEL_CAPABILITIES: Record<string, Partial<ModelCapabilities>> = {\n  // OpenRouter - Native Tool Support\n  'deepseek/deepseek-chat': {\n    supportsNativeTools: true,\n    contextWindow: 128000,\n    requiresEmulation: false,\n    emulationStrategy: 'none',\n    costPerMillionTokens: 0.15\n  },\n  'deepseek/deepseek-chat-v3': {\n    supportsNativeTools: true,\n    contextWindow: 128000,\n    requiresEmulation: false,\n    emulationStrategy: 'none',\n    costPerMillionTokens: 0.15\n  },\n  'meta-llama/llama-3.3-70b-instruct': {\n    supportsNativeTools: true,\n    contextWindow: 128000,\n    requiresEmulation: false,\n    emulationStrategy: 'none',\n    costPerMillionTokens: 0.40\n  },\n  'qwen/qwen-2.5-coder-32b-instruct': {\n    supportsNativeTools: true,\n    contextWindow: 128000,\n    requiresEmulation: false,\n    emulationStrategy: 'none',\n    costPerMillionTokens: 0.23\n  },\n  'mistralai/mistral-small-3.1-24b-instruct': {\n    supportsNativeTools: true,\n    contextWindow: 128000,\n    requiresEmulation: false,\n    emulationStrategy: 'none',\n    costPerMillionTokens: 0.30\n  },\n\n  // OpenAI Models (via OpenRouter/Requesty)\n  'openai/gpt-4o': {\n    supportsNativeTools: true,\n    contextWindow: 128000,\n    requiresEmulation: false,\n    emulationStrategy: 'none',\n    costPerMillionTokens: 2.50\n  },\n  'openai/gpt-4o-mini': {\n    supportsNativeTools: true,\n    contextWindow: 128000,\n    requiresEmulation: false,\n    emulationStrategy: 'none',\n    costPerMillionTokens: 0.15\n  },\n  'openai/gpt-4-turbo': {\n    supportsNativeTools: true,\n    contextWindow: 128000,\n    requiresEmulation: false,\n    emulationStrategy: 'none',\n    costPerMillionTokens: 10.00\n  },\n\n  // OpenRouter - No Native Tool Support (Require Emulation)\n  'mistralai/mistral-7b-instruct': {\n    supportsNativeTools: false,\n    contextWindow: 32000,\n    requiresEmulation: true,\n    emulationStrategy: 'react',  // Best for this model\n    costPerMillionTokens: 0.07\n  },\n  'meta-llama/llama-2-13b-chat': {\n    supportsNativeTools: false,\n    contextWindow: 4096,\n    requiresEmulation: true,\n    emulationStrategy: 'prompt',  // Simple prompting works best\n    costPerMillionTokens: 0.05\n  },\n  'google/gemma-7b-it': {\n    supportsNativeTools: false,\n    contextWindow: 8192,\n    requiresEmulation: true,\n    emulationStrategy: 'prompt',\n    costPerMillionTokens: 0.07\n  },\n  'thudm/glm-4-9b:free': {\n    supportsNativeTools: false,  // Free tier limited\n    contextWindow: 32000,\n    requiresEmulation: true,\n    emulationStrategy: 'react',\n    costPerMillionTokens: 0.0  // FREE\n  },\n\n  // Anthropic - Native Tool Support\n  'claude-3-5-sonnet-20241022': {\n    supportsNativeTools: true,\n    contextWindow: 200000,\n    requiresEmulation: false,\n    emulationStrategy: 'none',\n    costPerMillionTokens: 3.0\n  },\n  'claude-3-5-haiku-20241022': {\n    supportsNativeTools: true,\n    contextWindow: 200000,\n    requiresEmulation: false,\n    emulationStrategy: 'none',\n    costPerMillionTokens: 0.80\n  },\n\n  // Gemini - Native Tool Support\n  'gemini-2.0-flash-exp': {\n    supportsNativeTools: true,\n    contextWindow: 1000000,\n    requiresEmulation: false,\n    emulationStrategy: 'none',\n    costPerMillionTokens: 0.0  // FREE tier\n  },\n\n  // OpenAI - Native Tool Support\n  'gpt-4o': {\n    supportsNativeTools: true,\n    contextWindow: 128000,\n    requiresEmulation: false,\n    emulationStrategy: 'none',\n    costPerMillionTokens: 2.50\n  },\n  'gpt-4o-mini': {\n    supportsNativeTools: true,\n    contextWindow: 128000,\n    requiresEmulation: false,\n    emulationStrategy: 'none',\n    costPerMillionTokens: 0.15\n  },\n  'gpt-3.5-turbo': {\n    supportsNativeTools: true,\n    contextWindow: 16385,\n    requiresEmulation: false,\n    emulationStrategy: 'none',\n    costPerMillionTokens: 0.50\n  }\n};\n\n/**\n * Pattern matching for model families\n */\nconst MODEL_PATTERNS: Array<{\n  pattern: RegExp;\n  capabilities: Partial<ModelCapabilities>;\n}> = [\n  {\n    pattern: /^claude-3/,\n    capabilities: { supportsNativeTools: true, requiresEmulation: false }\n  },\n  {\n    pattern: /^gpt-(4|3\\.5)/,\n    capabilities: { supportsNativeTools: true, requiresEmulation: false }\n  },\n  {\n    pattern: /^gemini-/,\n    capabilities: { supportsNativeTools: true, requiresEmulation: false }\n  },\n  {\n    pattern: /deepseek\\/deepseek-(chat|coder)/,\n    capabilities: { supportsNativeTools: true, requiresEmulation: false }\n  },\n  {\n    pattern: /llama-3\\.(3|2|1)-.*instruct/,\n    capabilities: { supportsNativeTools: true, requiresEmulation: false }\n  },\n  {\n    pattern: /qwen.*2\\.5/,\n    capabilities: { supportsNativeTools: true, requiresEmulation: false }\n  },\n  {\n    pattern: /mistral.*large|mistral.*small/,\n    capabilities: { supportsNativeTools: true, requiresEmulation: false }\n  },\n  // Older models typically don't support tools\n  {\n    pattern: /llama-2|mistral-7b|gemma-.*7b/,\n    capabilities: { supportsNativeTools: false, requiresEmulation: true, emulationStrategy: 'react' }\n  }\n];\n\n/**\n * Detect capabilities of a model\n */\nexport function detectModelCapabilities(modelId: string): ModelCapabilities {\n  // Direct lookup\n  if (MODEL_CAPABILITIES[modelId]) {\n    return {\n      supportsNativeTools: false,\n      supportsStreaming: true,\n      contextWindow: 4096,\n      requiresEmulation: true,\n      emulationStrategy: 'prompt',\n      costPerMillionTokens: 0.5,\n      provider: 'unknown',\n      ...MODEL_CAPABILITIES[modelId]\n    };\n  }\n\n  // Pattern matching\n  for (const { pattern, capabilities } of MODEL_PATTERNS) {\n    if (pattern.test(modelId)) {\n      return {\n        supportsNativeTools: false,\n        supportsStreaming: true,\n        contextWindow: 4096,\n        requiresEmulation: true,\n        emulationStrategy: 'prompt',\n        costPerMillionTokens: 0.5,\n        provider: 'unknown',\n        ...capabilities\n      };\n    }\n  }\n\n  // Unknown model - assume needs emulation (conservative)\n  console.warn(`⚠️  Unknown model: ${modelId}. Assuming no native tool support.`);\n  return {\n    supportsNativeTools: false,\n    supportsStreaming: true,\n    contextWindow: 4096,\n    requiresEmulation: true,\n    emulationStrategy: 'prompt',\n    costPerMillionTokens: 0.5,\n    provider: 'unknown'\n  };\n}\n\n/**\n * Check if model can handle a specific number of tools\n */\nexport function canHandleToolCount(modelId: string, toolCount: number): boolean {\n  const capabilities = detectModelCapabilities(modelId);\n\n  // Estimate: Each tool ~100 tokens of schema\n  const estimatedTokens = toolCount * 100;\n\n  // Need at least 20% of context window free for actual conversation\n  const maxToolTokens = capabilities.contextWindow * 0.8;\n\n  return estimatedTokens <= maxToolTokens;\n}\n\n/**\n * Recommend optimal strategy for a model\n */\nexport function recommendStrategy(\n  modelId: string,\n  toolCount: number,\n  taskComplexity: 'simple' | 'medium' | 'complex'\n): 'native' | 'react' | 'prompt' | 'hybrid' {\n  const capabilities = detectModelCapabilities(modelId);\n\n  if (capabilities.supportsNativeTools) {\n    return 'native';\n  }\n\n  // For emulation, choose based on context and complexity\n  if (toolCount > 10 || taskComplexity === 'complex') {\n    return 'react';  // More robust for complex scenarios\n  }\n\n  if (capabilities.contextWindow < 8000) {\n    return 'prompt';  // Simpler for small context windows\n  }\n\n  return 'react';  // Default to ReAct pattern\n}\n\n/**\n * Get human-readable capability report\n */\nexport function getCapabilityReport(modelId: string): string {\n  const cap = detectModelCapabilities(modelId);\n\n  let report = `\\n📊 Model Capabilities: ${modelId}\\n`;\n  report += `━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\\n`;\n  report += `Native Tool Support:  ${cap.supportsNativeTools ? '✅ Yes' : '❌ No'}\\n`;\n  report += `Context Window:       ${cap.contextWindow.toLocaleString()} tokens\\n`;\n  report += `Streaming:            ${cap.supportsStreaming ? '✅ Yes' : '❌ No'}\\n`;\n  report += `Cost per 1M tokens:   $${cap.costPerMillionTokens}\\n`;\n\n  if (cap.requiresEmulation) {\n    report += `\\n⚙️  Emulation Required\\n`;\n    report += `Recommended Strategy: ${cap.emulationStrategy.toUpperCase()}\\n`;\n    report += `\\nNote: This model will use prompt-based tool emulation.\\n`;\n    report += `Expect 70-85% reliability vs 95%+ for native tool support.\\n`;\n  } else {\n    report += `\\n✅ No Emulation Needed\\n`;\n    report += `This model natively supports function calling.\\n`;\n  }\n\n  report += `━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\\n`;\n\n  return report;\n}\n"]}

package/dist/agentic-flow/src/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/agentic-flow/src/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"}