adaptive-memory-multi-model-router 2.14.40 → 2.14.41

package/dist/ensemble/multiRoundDialog.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Multi-Round Dialog Optimization
+ *
+ * Tracks conversation context over multiple turns and optimizes routing
+ * decisions based on accumulated dialogue history.
+ *
+ * Key features:
+ * - Conversation state management
+ * - Topic tracking across turns
+ * - Model performance history per topic
+ * - Adaptive routing based on dialog state
+ */
+import { RouteDecision } from '../routing/advancedRouter';
+export interface DialogTurn {
+    turn: number;
+    role: 'user' | 'assistant' | 'system';
+    content: string;
+    model?: string;
+    timestamp: number;
+    routingDecision?: RouteDecision;
+}
+export interface DialogState {
+    conversationId: string;
+    turns: DialogTurn[];
+    topics: Set<string>;
+    topicHistory: Map<string, number>;
+    modelPerformance: Map<string, Map<string, number>>;
+    currentTopic: string;
+    sentiment: 'positive' | 'negative' | 'neutral';
+    complexity: number;
+    startedAt: number;
+    lastTurnAt: number;
+}
+export interface MultiRoundConfig {
+    /** Max turns to keep in conversation context */
+    maxContextTurns: number;
+    /** Topic similarity threshold */
+    topicThreshold: number;
+    /** Performance window size */
+    performanceWindow: number;
+    /** Enable adaptive complexity tracking */
+    trackComplexity: boolean;
+}
+export declare class MultiRoundDialogOptimizer {
+    private config;
+    private dialogStates;
+    constructor(config?: Partial<MultiRoundConfig>);
+    /**
+     * Create or get existing dialog state
+     */
+    getDialogState(conversationId: string): DialogState;
+    /**
+     * Create a fresh dialog state
+     */
+    private createNewState;
+    /**
+     * Add a turn to the conversation
+     */
+    addTurn(conversationId: string, role: 'user' | 'assistant' | 'system', content: string, model?: string, routingDecision?: RouteDecision): DialogState;
+    /**
+     * Extract topics from content using keyword analysis
+     */
+    private extractTopics;
+    /**
+     * Get most frequently mentioned topic
+     */
+    private getMostFrequentTopic;
+    /**
+     * Calculate complexity based on content and history
+     */
+    private calculateComplexity;
+    /**
+     * Update model performance tracking for a topic
+     */
+    private updateModelPerformance;
+    /**
+     * Score response quality (simple heuristic)
+     */
+    private scoreResponseQuality;
+    /**
+     * Get best model for current topic based on history
+     */
+    getBestModelForTopic(conversationId: string, availableModels: string[]): string | null;
+    /**
+     * Build optimized context for next query
+     */
+    buildOptimizedContext(conversationId: string, newQuery: string): string;
+    /**
+     * Get routing hints based on dialog state
+     */
+    getRoutingHints(conversationId: string): Record<string, number>;
+    /**
+     * Calculate topic affinity for routing
+     */
+    private topicAffinityScore;
+    /**
+     * Clear dialog state
+     */
+    clearState(conversationId: string): void;
+    /**
+     * Get dialog summary
+     */
+    getSummary(conversationId: string): {
+        turns: number;
+        topics: string[];
+        currentTopic: string;
+        complexity: number;
+        duration: number;
+        modelsUsed: string[];
+    };
+}
+export declare const dialogOptimizer: MultiRoundDialogOptimizer;
+export default dialogOptimizer;

package/dist/ensemble/multiRoundDialog.js

@@ -0,0 +1,284 @@
+"use strict";
+/**
+ * Multi-Round Dialog Optimization
+ *
+ * Tracks conversation context over multiple turns and optimizes routing
+ * decisions based on accumulated dialogue history.
+ *
+ * Key features:
+ * - Conversation state management
+ * - Topic tracking across turns
+ * - Model performance history per topic
+ * - Adaptive routing based on dialog state
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dialogOptimizer = exports.MultiRoundDialogOptimizer = void 0;
+const DEFAULT_CONFIG = {
+    maxContextTurns: 20,
+    topicThreshold: 0.7,
+    performanceWindow: 10,
+    trackComplexity: true,
+};
+class MultiRoundDialogOptimizer {
+    config;
+    dialogStates = new Map();
+    constructor(config = {}) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * Create or get existing dialog state
+     */
+    getDialogState(conversationId) {
+        if (!this.dialogStates.has(conversationId)) {
+            this.dialogStates.set(conversationId, this.createNewState(conversationId));
+        }
+        return this.dialogStates.get(conversationId);
+    }
+    /**
+     * Create a fresh dialog state
+     */
+    createNewState(conversationId) {
+        return {
+            conversationId,
+            turns: [],
+            topics: new Set(),
+            topicHistory: new Map(),
+            modelPerformance: new Map(),
+            currentTopic: 'general',
+            sentiment: 'neutral',
+            complexity: 0,
+            startedAt: Date.now(),
+            lastTurnAt: Date.now(),
+        };
+    }
+    /**
+     * Add a turn to the conversation
+     */
+    addTurn(conversationId, role, content, model, routingDecision) {
+        const state = this.getDialogState(conversationId);
+        const turn = {
+            turn: state.turns.length,
+            role,
+            content,
+            model,
+            timestamp: Date.now(),
+            routingDecision,
+        };
+        state.turns.push(turn);
+        state.lastTurnAt = Date.now();
+        // Update topic tracking
+        const topics = this.extractTopics(content);
+        topics.forEach(topic => {
+            state.topics.add(topic);
+            const count = state.topicHistory.get(topic) || 0;
+            state.topicHistory.set(topic, count + 1);
+        });
+        // Update current topic to most mentioned
+        if (topics.length > 0) {
+            state.currentTopic = this.getMostFrequentTopic(state.topicHistory);
+        }
+        // Update complexity
+        if (this.config.trackComplexity) {
+            state.complexity = this.calculateComplexity(content, state.turns);
+        }
+        // Update model performance if assistant turn with routing decision
+        if (role === 'assistant' && model && routingDecision) {
+            this.updateModelPerformance(state, model, content);
+        }
+        // Trim old turns if exceeding max
+        if (state.turns.length > this.config.maxContextTurns) {
+            state.turns = state.turns.slice(-this.config.maxContextTurns);
+        }
+        return state;
+    }
+    /**
+     * Extract topics from content using keyword analysis
+     */
+    extractTopics(content) {
+        const topics = [];
+        const lower = content.toLowerCase();
+        // Topic keywords
+        const topicPatterns = {
+            'coding': ['code', 'programming', 'function', 'debug', 'syntax', 'api', 'software'],
+            'data-science': ['data', 'analysis', 'ml', 'machine learning', 'model', 'training', 'dataset'],
+            'math': ['equation', 'calculation', 'math', 'number', 'formula', 'algebra'],
+            'science': ['experiment', 'hypothesis', 'research', 'physics', 'chemistry', 'biology'],
+            'business': ['revenue', 'market', 'customer', 'sales', 'strategy', 'business'],
+            'creative': ['story', 'creative', 'writing', 'art', 'design', 'poem'],
+            'security': ['security', 'authentication', 'encryption', 'vulnerability', 'auth'],
+            'devops': ['deploy', 'docker', 'kubernetes', 'ci/cd', 'infrastructure', 'cloud'],
+        };
+        for (const [topic, keywords] of Object.entries(topicPatterns)) {
+            for (const keyword of keywords) {
+                if (lower.includes(keyword)) {
+                    topics.push(topic);
+                    break;
+                }
+            }
+        }
+        return topics.length > 0 ? topics : ['general'];
+    }
+    /**
+     * Get most frequently mentioned topic
+     */
+    getMostFrequentTopic(topicHistory) {
+        let maxCount = 0;
+        let mostFrequent = 'general';
+        for (const [topic, count] of topicHistory) {
+            if (count > maxCount) {
+                maxCount = count;
+                mostFrequent = topic;
+            }
+        }
+        return mostFrequent;
+    }
+    /**
+     * Calculate complexity based on content and history
+     */
+    calculateComplexity(content, turns) {
+        // Base complexity from content length
+        let complexity = Math.min(1, content.length / 1000);
+        // Increase for technical terms
+        const technicalTerms = ['algorithm', 'architecture', 'optimization', 'performance', 'concurrent', 'distributed'];
+        for (const term of technicalTerms) {
+            if (content.toLowerCase().includes(term)) {
+                complexity += 0.1;
+            }
+        }
+        // Increase with conversation depth
+        complexity += Math.min(0.3, turns.length * 0.02);
+        return Math.min(1, complexity);
+    }
+    /**
+     * Update model performance tracking for a topic
+     */
+    updateModelPerformance(state, model, response) {
+        if (!state.modelPerformance.has(model)) {
+            state.modelPerformance.set(model, new Map());
+        }
+        const modelScores = state.modelPerformance.get(model);
+        const currentTopic = state.currentTopic;
+        // Simple success scoring based on response length and quality indicators
+        const qualityScore = this.scoreResponseQuality(response);
+        const currentScore = modelScores.get(currentTopic) || 0;
+        // Rolling average
+        const newScore = (currentScore * (this.config.performanceWindow - 1) + qualityScore) / this.config.performanceWindow;
+        modelScores.set(currentTopic, newScore);
+    }
+    /**
+     * Score response quality (simple heuristic)
+     */
+    scoreResponseQuality(response) {
+        let score = 0.5; // Base score
+        // Longer responses often indicate more thorough answers
+        if (response.length > 200)
+            score += 0.1;
+        if (response.length > 500)
+            score += 0.1;
+        // Code blocks indicate technical content
+        if (response.includes('```'))
+            score += 0.1;
+        // Lists and structured content
+        if (response.includes('\n-'))
+            score += 0.05;
+        if (response.includes('\n1.'))
+            score += 0.05;
+        return Math.min(1, score);
+    }
+    /**
+     * Get best model for current topic based on history
+     */
+    getBestModelForTopic(conversationId, availableModels) {
+        const state = this.getDialogState(conversationId);
+        const currentTopic = state.currentTopic;
+        let bestModel = null;
+        let bestScore = -1;
+        for (const model of availableModels) {
+            const modelScores = state.modelPerformance.get(model);
+            if (modelScores) {
+                const topicScore = modelScores.get(currentTopic) || 0.5;
+                if (topicScore > bestScore) {
+                    bestScore = topicScore;
+                    bestModel = model;
+                }
+            }
+        }
+        return bestModel;
+    }
+    /**
+     * Build optimized context for next query
+     */
+    buildOptimizedContext(conversationId, newQuery) {
+        const state = this.getDialogState(conversationId);
+        const contextParts = [];
+        // Add conversation summary
+        contextParts.push(`Topic: ${state.currentTopic}`);
+        contextParts.push(`Complexity: ${(state.complexity * 100).toFixed(0)}%`);
+        contextParts.push(`Turns: ${state.turns.length}`);
+        // Add relevant recent turns (last 3-5)
+        const recentTurns = state.turns.slice(-5);
+        for (const turn of recentTurns) {
+            const prefix = turn.role === 'user' ? 'Q' : 'A';
+            const modelTag = turn.model ? `[${turn.model}]` : '';
+            contextParts.push(`${prefix}${modelTag}: ${turn.content.slice(0, 200)}`);
+        }
+        // Add new query
+        contextParts.push(`New query: ${newQuery}`);
+        return contextParts.join('\n');
+    }
+    /**
+     * Get routing hints based on dialog state
+     */
+    getRoutingHints(conversationId) {
+        const state = this.getDialogState(conversationId);
+        return {
+            complexity: state.complexity,
+            topicAffinity: this.topicAffinityScore(state.currentTopic),
+            depth: Math.min(1, state.turns.length / 20),
+            sentiment: state.sentiment === 'negative' ? 0.8 : 0.5,
+        };
+    }
+    /**
+     * Calculate topic affinity for routing
+     */
+    topicAffinityScore(topic) {
+        const topicScores = {
+            'coding': 0.9,
+            'security': 0.95,
+            'devops': 0.85,
+            'data-science': 0.8,
+            'math': 0.7,
+            'science': 0.75,
+            'business': 0.6,
+            'creative': 0.5,
+            'general': 0.5,
+        };
+        return topicScores[topic] || 0.5;
+    }
+    /**
+     * Clear dialog state
+     */
+    clearState(conversationId) {
+        this.dialogStates.delete(conversationId);
+    }
+    /**
+     * Get dialog summary
+     */
+    getSummary(conversationId) {
+        const state = this.getDialogState(conversationId);
+        return {
+            turns: state.turns.length,
+            topics: [...state.topics],
+            currentTopic: state.currentTopic,
+            complexity: state.complexity,
+            duration: Date.now() - state.startedAt,
+            modelsUsed: [...state.modelPerformance.keys()],
+        };
+    }
+}
+exports.MultiRoundDialogOptimizer = MultiRoundDialogOptimizer;
+// Export singleton instance
+exports.dialogOptimizer = new MultiRoundDialogOptimizer();
+// Default export
+exports.default = exports.dialogOptimizer;
+//# sourceMappingURL=multiRoundDialog.js.map

package/dist/ensemble/multiRoundDialog.js.map

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

package/dist/ensemble/shapleyValue.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Enhanced Shapley Value Calculator for Ensemble Credit Assignment
+ *
+ * Incorporates game theory concepts for efficient and fair credit distribution:
+ *
+ * 1. ETHNOCENTRISM (In-group Loyalty Adjustment):
+ *    - Players (models) have historical loyalty biases toward certain partners
+ *    - Models that collaborate successfully develop "trust bonds"
+ *    - Loyalty increases marginal contribution of trusted partners
+ *    - Math: L[i,j] = exponential moving avg of historical success(i with j)
+ *
+ * 2. HANDICAP PRINCIPLE (Zahavi, 1975 - Costly Signaling):
+ *    - Honest signals require costly investment
+ *    - Models providing correct answers despite cost signal reliability
+ *    - Math: H[i] = cost_i * reliability_i (handicap bonus)
+ *
+ * 3. CORE SHAPLEY VALUE:
+ *    - φ_i = Σ_{S⊆N\{i}} (|S|! * (n-|S|-1)! / n!) * (v(S∪{i}) - v(S))
+ *
+ * Combined: φ_i* = α*Shapley_i + β*Loyalty_i + γ*Handicap_i
+ * Where α + β + γ = 1 (normalized weights)
+ */
+export interface ShapleyConfig {
+    nPermutations?: number;
+    useMonteCarlo?: boolean;
+    alpha?: number;
+    beta?: number;
+    gamma?: number;
+}
+export interface ModelContribution {
+    modelId: string;
+    shapleyValue: number;
+    loyaltyValue: number;
+    handicapValue: number;
+    combinedCredit: number;
+    marginalContributions: number[];
+    timesSelected: number;
+    averageMarginal: number;
+    reliabilityScore: number;
+    costInvested: number;
+    ethnocentrismBias: number;
+}
+type AccuracyFunction = (modelIds: string[]) => number;
+export interface LoyaltyConfig {
+    decayRate?: number;
+    minInteractions?: number;
+}
+/**
+ * Loyalty Matrix L[i][j] = loyalty of model i toward model j (0-1)
+ * Models develop trust through successful collaborations
+ */
+export declare class LoyaltyMatrix {
+    private matrix;
+    private counts;
+    private config;
+    constructor(cfg?: LoyaltyConfig);
+    /** Record successful collaboration between two models */
+    recordSuccess(i: string, j: string, weight?: number): void;
+    /** Get loyalty of model i toward model j */
+    getLoyalty(i: string, j: string): number;
+    /** Ethnocentrism = average loyalty toward all partners */
+    ethnoCentrism(model: string, allModels: string[]): number;
+}
+export interface HandicapConfig {
+    costSensitivity?: number;
+    reliabilityWeight?: number;
+    minCostThreshold?: number;
+}
+/**
+ * Handicap Principle (Zahavi, 1975):
+ * "A handicapping signal is honest because it is costly to produce"
+ *
+ * Models spending more tokens on answers despite being correct signal reliability.
+ * H[i] = cost_i * reliability_i (higher = more reliable despite cost)
+ */
+export declare class HandicapCalculator {
+    private costs;
+    private correct;
+    private totals;
+    private config;
+    constructor(cfg?: HandicapConfig);
+    /** Record performance: cost spent and whether answer was correct */
+    record(model: string, cost: number, isCorrect: boolean): void;
+    /** Reliability = correct / total (prior probability of being right) */
+    reliability(model: string): number;
+    /** Average cost invested by model */
+    avgCost(model: string): number;
+    /**
+     * Handicap bonus = honest signal of quality
+     * H[i] = (cost_i - minCost) / maxCost * reliability_i
+     * Higher cost investment + higher reliability = higher handicap
+     */
+    handicap(model: string, maxCost?: number): number;
+}
+/**
+ * Combined enhanced Shapley value with ethnocentrism and handicap
+ * φ_i* = α*φ_i(Shapley) + β*ε_i(Ethnocentrism) + γ*H_i(Handicap)
+ */
+export declare function calculateEnhancedShapley(modelIds: string[], accuracyFn: AccuracyFunction, loyalty: LoyaltyMatrix, handicap: HandicapCalculator, cfg?: ShapleyConfig): Map<string, ModelContribution>;
+/** Create ensemble accuracy function for Shapley calculation */
+export declare function createAccuracyFn(groundTruth: string, getAnswer: (modelId: string) => string): AccuracyFunction;
+/** Apply Shapley credit to voting weights */
+export declare function applyCredit(contributions: Map<string, ModelContribution>, baseWeights: Record<string, number>, alpha?: number): Record<string, number>;
+export interface ShapleySummary {
+    totalCredit: number;
+    perModel: ModelContribution[];
+    bestContributor: string;
+    worstContributor: string;
+}
+export declare function summarize(contributions: Map<string, ModelContribution>): ShapleySummary;
+declare const _default: {
+    calculateEnhancedShapley: typeof calculateEnhancedShapley;
+    LoyaltyMatrix: typeof LoyaltyMatrix;
+    HandicapCalculator: typeof HandicapCalculator;
+    createAccuracyFn: typeof createAccuracyFn;
+    applyCredit: typeof applyCredit;
+    summarize: typeof summarize;
+};
+export default _default;