@cascadeflow/core

npm install @cascadeflow/core

import { CascadeAgent, ModelConfig } from '@cascadeflow/core';

const agent = new CascadeAgent({
  models: [
    { name: 'gpt-4o-mini', provider: 'openai', cost: 0.000375 },
    { name: 'gpt-4o', provider: 'openai', cost: 0.00625 },
  ],
});

const result = await agent.run('What is TypeScript?');
console.log(`Model: ${result.modelUsed}`);
console.log(`Cost: $${result.totalCost}`);
console.log(`Saved: ${result.savingsPercentage}%`);

interface ModelConfig {
  name: string;        // Model name (e.g. 'gpt-4o-mini')
  provider: string;    // Provider name (e.g. 'openai')
  cost: number;        // Cost per token (approximate)
}

interface CascadeAgentOptions {
  models: ModelConfig[];
  quality?: {
    threshold?: number;              // Confidence threshold (0-1)
    requireMinimumTokens?: number;   // Min response length
    useSemanticValidation?: boolean; // Enable ML validation
    semanticThreshold?: number;      // Semantic similarity threshold
  };
}

interface CascadeResult {
  content: string;
  modelUsed: string;
  totalCost: number;
  savingsPercentage: number;
  cascadeDecision: string;
}