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

package/dist/ensemble/shapleyValue.js

@@ -0,0 +1,280 @@
+"use strict";
+/**
+ * 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)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HandicapCalculator = exports.LoyaltyMatrix = void 0;
+exports.calculateEnhancedShapley = calculateEnhancedShapley;
+exports.createAccuracyFn = createAccuracyFn;
+exports.applyCredit = applyCredit;
+exports.summarize = summarize;
+const DEFAULT_LOYALTY = { decayRate: 0.9, minInteractions: 3 };
+/**
+ * Loyalty Matrix L[i][j] = loyalty of model i toward model j (0-1)
+ * Models develop trust through successful collaborations
+ */
+class LoyaltyMatrix {
+    matrix = new Map();
+    counts = new Map();
+    config;
+    constructor(cfg = {}) {
+        this.config = { ...DEFAULT_LOYALTY, ...cfg };
+    }
+    /** Record successful collaboration between two models */
+    recordSuccess(i, j, weight = 1) {
+        if (!this.matrix.has(i)) {
+            this.matrix.set(i, new Map());
+            this.counts.set(i, new Map());
+        }
+        if (!this.matrix.get(i).has(j)) {
+            this.matrix.get(i).set(j, 0);
+            this.counts.get(i).set(j, 0);
+        }
+        const prev = this.matrix.get(i).get(j);
+        const cnt = this.counts.get(i).get(j);
+        const ema = this.config.decayRate * prev + (1 - this.config.decayRate) * weight;
+        this.matrix.get(i).set(j, ema);
+        this.counts.get(i).set(j, cnt + 1);
+    }
+    /** Get loyalty of model i toward model j */
+    getLoyalty(i, j) {
+        if (!this.matrix.has(i) || !this.matrix.get(i).has(j))
+            return 0;
+        if (this.counts.get(i).get(j) < this.config.minInteractions)
+            return 0;
+        return this.matrix.get(i).get(j);
+    }
+    /** Ethnocentrism = average loyalty toward all partners */
+    ethnoCentrism(model, allModels) {
+        const loyalties = allModels.map(m => this.getLoyalty(model, m));
+        const avg = loyalties.reduce((a, b) => a + b, 0) / Math.max(1, allModels.length);
+        return Math.min(1, avg);
+    }
+}
+exports.LoyaltyMatrix = LoyaltyMatrix;
+const DEFAULT_HANDICAP = { costSensitivity: 0.5, reliabilityWeight: 0.5, minCostThreshold: 0.0001 };
+/**
+ * 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)
+ */
+class HandicapCalculator {
+    costs = new Map();
+    correct = new Map();
+    totals = new Map();
+    config;
+    constructor(cfg = {}) {
+        this.config = { ...DEFAULT_HANDICAP, ...cfg };
+    }
+    /** Record performance: cost spent and whether answer was correct */
+    record(model, cost, isCorrect) {
+        this.costs.set(model, (this.costs.get(model) || 0) + cost);
+        this.totals.set(model, (this.totals.get(model) || 0) + 1);
+        if (isCorrect)
+            this.correct.set(model, (this.correct.get(model) || 0) + 1);
+    }
+    /** Reliability = correct / total (prior probability of being right) */
+    reliability(model) {
+        const total = this.totals.get(model) || 0;
+        if (total === 0)
+            return 0.5; // Unknown = neutral
+        return (this.correct.get(model) || 0) / total;
+    }
+    /** Average cost invested by model */
+    avgCost(model) {
+        const total = this.totals.get(model) || 0;
+        if (total === 0)
+            return 0;
+        return (this.costs.get(model) || 0) / total;
+    }
+    /**
+     * Handicap bonus = honest signal of quality
+     * H[i] = (cost_i - minCost) / maxCost * reliability_i
+     * Higher cost investment + higher reliability = higher handicap
+     */
+    handicap(model, maxCost = 0.01) {
+        const cost = this.avgCost(model);
+        if (cost < this.config.minCostThreshold)
+            return 0;
+        const rel = this.reliability(model);
+        const costNorm = Math.min(1, cost / maxCost);
+        // Honest signal: cost * reliability (costly and correct = reliable)
+        return this.config.costSensitivity * costNorm * rel +
+            this.config.reliabilityWeight * rel;
+    }
+}
+exports.HandicapCalculator = HandicapCalculator;
+// ============ CORE SHAPLEY VALUE ============
+function factorial(n) {
+    if (n <= 1)
+        return 1;
+    return n * factorial(n - 1);
+}
+/**
+ * Exact Shapley calculation (factorial enumeration)
+ * For n <= 6 models
+ */
+function exactShapley(modelIds, accuracyFn) {
+    const n = modelIds.length;
+    const shapley = new Map();
+    modelIds.forEach(m => shapley.set(m, 0));
+    // All permutations via Heap's algorithm
+    function permute(arr, callback) {
+        function generate(idx) {
+            if (idx === arr.length) {
+                callback([...arr]);
+                return;
+            }
+            for (let i = idx; i < arr.length; i++) {
+                [arr[idx], arr[i]] = [arr[i], arr[idx]];
+                generate(idx + 1);
+                [arr[idx], arr[i]] = [arr[i], arr[idx]];
+            }
+        }
+        generate(0);
+    }
+    const permutations = [];
+    const work = [...modelIds];
+    permute(work, p => permutations.push(p));
+    for (const perm of permutations) {
+        let acc = 0;
+        const subset = [];
+        for (let i = 0; i < perm.length; i++) {
+            const model = perm[i];
+            const newAcc = accuracyFn([...subset, model]);
+            const marginal = newAcc - acc;
+            const weight = factorial(subset.length) * factorial(n - subset.length - 1) / factorial(n);
+            shapley.set(model, shapley.get(model) + weight * marginal);
+            subset.push(model);
+            acc = newAcc;
+        }
+    }
+    return shapley;
+}
+/**
+ * Monte Carlo approximation for n > 6 models
+ */
+function monteCarloShapley(modelIds, accuracyFn, nPerms) {
+    const n = modelIds.length;
+    const shapley = new Map();
+    modelIds.forEach(m => shapley.set(m, 0));
+    for (let iter = 0; iter < nPerms; iter++) {
+        const perm = [...modelIds].sort(() => Math.random() - 0.5);
+        let acc = 0;
+        const subset = [];
+        for (const model of perm) {
+            const newAcc = accuracyFn([...subset, model]);
+            const marginal = newAcc - acc;
+            shapley.set(model, shapley.get(model) + marginal);
+            subset.push(model);
+            acc = newAcc;
+        }
+    }
+    // Average
+    for (const [m, v] of shapley)
+        shapley.set(m, v / nPerms);
+    return shapley;
+}
+/**
+ * Combined enhanced Shapley value with ethnocentrism and handicap
+ * φ_i* = α*φ_i(Shapley) + β*ε_i(Ethnocentrism) + γ*H_i(Handicap)
+ */
+function calculateEnhancedShapley(modelIds, accuracyFn, loyalty, handicap, cfg = {}) {
+    const { alpha = 0.5, beta = 0.3, gamma = 0.2, nPermutations = 1000, useMonteCarlo = false } = cfg;
+    const results = new Map();
+    // 1. Core Shapley values
+    const shapleyValues = (modelIds.length <= 6 && !useMonteCarlo)
+        ? exactShapley(modelIds, accuracyFn)
+        : monteCarloShapley(modelIds, accuracyFn, nPermutations);
+    // 2. Normalize Shapley to [0,1]
+    const shapSum = [...shapleyValues.values()].reduce((a, b) => a + b, 0);
+    const maxShap = Math.max(...shapleyValues.values(), 0.001);
+    // 3. Compute ethnocentrism and handicap for each model
+    for (const model of modelIds) {
+        const shap = shapleyValues.get(model);
+        const ethn = loyalty.ethnoCentrism(model, modelIds);
+        const hand = handicap.handicap(model);
+        // Normalized values
+        const normShap = shap / maxShap;
+        const combined = alpha * normShap + beta * ethn + gamma * hand;
+        results.set(model, {
+            modelId: model,
+            shapleyValue: shap,
+            loyaltyValue: ethn,
+            handicapValue: hand,
+            combinedCredit: combined,
+            marginalContributions: [],
+            timesSelected: 0,
+            averageMarginal: shap / Math.max(1, modelIds.length),
+            reliabilityScore: handicap.reliability(model),
+            costInvested: handicap.avgCost(model),
+            ethnocentrismBias: ethn,
+        });
+    }
+    // 4. Normalize combined credits to sum to 1
+    const totalCredit = [...results.values()].reduce((s, r) => s + r.combinedCredit, 0);
+    if (totalCredit > 0) {
+        for (const [, r] of results)
+            r.combinedCredit /= totalCredit;
+    }
+    return results;
+}
+/** Create ensemble accuracy function for Shapley calculation */
+function createAccuracyFn(groundTruth, getAnswer) {
+    return (subset) => {
+        if (subset.length === 0)
+            return 0;
+        const votes = {};
+        for (const m of subset) {
+            const ans = getAnswer(m);
+            votes[ans] = (votes[ans] || 0) + 1;
+        }
+        const majority = Object.entries(votes).sort((a, b) => b[1] - a[1])[0]?.[0] || '';
+        return majority === groundTruth ? 1 : 0;
+    };
+}
+/** Apply Shapley credit to voting weights */
+function applyCredit(contributions, baseWeights, alpha = 0.5) {
+    const result = {};
+    for (const [model, contrib] of contributions) {
+        const base = baseWeights[model] || 1.0;
+        result[model] = (1 - alpha) * base + alpha * contrib.combinedCredit;
+    }
+    const sum = Object.values(result).reduce((a, b) => a + b, 0);
+    for (const k in result)
+        result[k] /= sum;
+    return result;
+}
+function summarize(contributions) {
+    const sorted = [...contributions.values()].sort((a, b) => b.combinedCredit - a.combinedCredit);
+    return {
+        totalCredit: sorted.reduce((s, c) => s + c.combinedCredit, 0),
+        perModel: sorted,
+        bestContributor: sorted[0]?.modelId || 'none',
+        worstContributor: sorted[sorted.length - 1]?.modelId || 'none',
+    };
+}
+// Default export
+exports.default = { calculateEnhancedShapley, LoyaltyMatrix, HandicapCalculator, createAccuracyFn, applyCredit, summarize };
+//# sourceMappingURL=shapleyValue.js.map

package/dist/ensemble/shapleyValue.js.map

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

package/dist/ensemble.d.ts

@@ -1,4 +1,6 @@
 import { createA3MRouter } from './index';
+import { ShapleySummary } from './ensemble/shapleyValue';
+import { dialogOptimizer } from './ensemble/multiRoundDialog';
 interface RouteDecision {
     primary_model: string;
     tier: 'free' | 'cheap' | 'mid' | 'premium';
@@ -9,7 +11,7 @@ interface RouteDecision {
 export type RouterDecision = RouteDecision;
 export declare const A3MRouter: any;
 export { createA3MRouter };
-export type EnsembleStrategy = 'majority' | 'weighted' | 'conservative';
+export type EnsembleStrategy = 'majority' | 'weighted' | 'conservative' | 'shapley';
 export interface EnsembleResponse {
     finalAnswer: string;
     confidence: number;
@@ -20,12 +22,25 @@ export interface EnsembleResponse {
         score: number;
     }>;
     reasoning: string;
+    shapleySummary?: ShapleySummary;
+    dialogState?: ReturnType<typeof dialogOptimizer.getSummary>;
 }
 export declare class EnsembleOrchestrator {
     private router;
+    private loyaltyMatrix;
+    private handicapCalc;
     constructor(router: InstanceType<typeof A3MRouter>);
     /**
-     * Executes a query across multiple providers in parallel and resolves the best answer.
+     * Execute ensemble with enhanced Shapley value credit assignment
+     * Incorporates ethnocentrism (loyalty) and handicap (costly signaling)
      */
-    executeEnsemble(query: string, providers: string[], strategy?: EnsembleStrategy, weights?: Record<string, number>): Promise<EnsembleResponse>;
+    executeEnsemble(query: string, providers: string[], strategy?: EnsembleStrategy, weights?: Record<string, number>, dialogId?: string): Promise<EnsembleResponse>;
+    /** Get best model for current dialog topic */
+    getBestModelForTopic(dialogId: string, availableModels: string[]): string | null;
+    /** Build optimized context for multi-turn conversation */
+    buildOptimizedContext(dialogId: string, newQuery: string): string;
+    /** Clear dialog state */
+    clearDialog(dialogId: string): void;
 }
+export { LoyaltyMatrix, HandicapCalculator, calculateEnhancedShapley } from './ensemble/shapleyValue';
+export { dialogOptimizer, MultiRoundDialogOptimizer } from './ensemble/multiRoundDialog';

package/dist/ensemble.js

@@ -1,20 +1,25 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.EnsembleOrchestrator = exports.createA3MRouter = exports.A3MRouter = void 0;
+exports.MultiRoundDialogOptimizer = exports.dialogOptimizer = exports.calculateEnhancedShapley = exports.HandicapCalculator = exports.LoyaltyMatrix = exports.EnsembleOrchestrator = exports.createA3MRouter = exports.A3MRouter = void 0;
 const index_1 = require("./index");
 Object.defineProperty(exports, "createA3MRouter", { enumerable: true, get: function () { return index_1.createA3MRouter; } });
+const shapleyValue_1 = require("./ensemble/shapleyValue");
+const multiRoundDialog_1 = require("./ensemble/multiRoundDialog");
 // Re-export A3MRouter as the factory for backward compatibility
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 exports.A3MRouter = index_1.createA3MRouter;
 class EnsembleOrchestrator {
     router;
+    loyaltyMatrix = new shapleyValue_1.LoyaltyMatrix();
+    handicapCalc = new shapleyValue_1.HandicapCalculator();
     constructor(router) {
         this.router = router;
     }
     /**
-     * Executes a query across multiple providers in parallel and resolves the best answer.
+     * Execute ensemble with enhanced Shapley value credit assignment
+     * Incorporates ethnocentrism (loyalty) and handicap (costly signaling)
      */
-    async executeEnsemble(query, providers, strategy = 'majority', weights = {}) {
+    async executeEnsemble(query, providers, strategy = 'majority', weights = {}, dialogId) {
         // 1. Parallel Execution
         const results = await Promise.all(providers.map(async (p) => {
             try {
@@ -26,31 +31,34 @@ class EnsembleOrchestrator {
             }
         }));
         const successful = results.filter(r => r.success);
-        const answers = successful.map(r => r.answer.trim());
-        if (answers.length === 0) {
+        if (successful.length === 0) {
             throw new Error('All ensemble providers failed.');
         }
         // 2. Voting Logic
         let winnerAnswer = '';
         let winnerProvider = '';
         let confidence = 0;
+        let shapleySummary;
+        // Multi-round: add user turn
+        if (dialogId)
+            multiRoundDialog_1.dialogOptimizer.addTurn(dialogId, 'user', query);
         if (strategy === 'majority') {
             const counts = {};
             successful.forEach(r => { counts[r.answer] = (counts[r.answer] || 0) + 1; });
             const sorted = Object.entries(counts).sort((a, b) => b[1] - a[1]);
             winnerAnswer = sorted[0][0];
-            confidence = sorted[0][1] / (successful.length || 1);
+            confidence = sorted[0][1] / successful.length;
             winnerProvider = successful.find(r => r.answer === winnerAnswer)?.provider || 'unknown';
         }
         else if (strategy === 'weighted') {
             const weightedCounts = {};
             successful.forEach(r => {
-                const weight = weights[r.provider] || 1.0;
-                weightedCounts[r.answer] = (weightedCounts[r.answer] || 0) + weight;
+                const w = weights[r.provider] || 1.0;
+                weightedCounts[r.answer] = (weightedCounts[r.answer] || 0) + w;
             });
             const sorted = Object.entries(weightedCounts).sort((a, b) => b[1] - a[1]);
             winnerAnswer = sorted[0][0];
-            confidence = sorted[0][1] / (successful.length || 1);
+            confidence = sorted[0][1] / successful.length;
             winnerProvider = successful.find(r => r.answer === winnerAnswer)?.provider || 'unknown';
         }
         else if (strategy === 'conservative') {
@@ -59,7 +67,7 @@ class EnsembleOrchestrator {
             const best = Object.entries(counts).sort((a, b) => b[1] - a[1])[0];
             if (best && best[1] >= 2) {
                 winnerAnswer = best[0];
-                confidence = best[1] / (successful.length || 1);
+                confidence = best[1] / successful.length;
                 winnerProvider = successful.find(r => r.answer === winnerAnswer)?.provider || 'unknown';
             }
             else {
@@ -68,23 +76,89 @@ class EnsembleOrchestrator {
                 winnerProvider = 'none';
             }
         }
+        else if (strategy === 'shapley') {
+            // === ENHANCED SHAPLEY WITH ETHNOCENTRISM + HANDICAP ===
+            const providerIds = successful.map(r => r.provider);
+            // Accuracy function based on majority vote as ground truth proxy
+            const accFn = (0, shapleyValue_1.createAccuracyFn)(winnerAnswer || successful[0].answer, // Will be updated after first pass
+            // Will be updated after first pass
+            m => successful.find(r => r.provider === m)?.answer || '');
+            // Calculate enhanced Shapley with loyalty and handicap
+            const contributions = (0, shapleyValue_1.calculateEnhancedShapley)(providerIds, accFn, this.loyaltyMatrix, this.handicapCalc);
+            // Get majority vote using Shapley-weighted voting
+            const shapleyWeights = (0, shapleyValue_1.applyCredit)(contributions, weights, 0.5);
+            const weightedCounts = {};
+            successful.forEach(r => {
+                weightedCounts[r.answer] = (weightedCounts[r.answer] || 0) + shapleyWeights[r.provider];
+            });
+            const sorted = Object.entries(weightedCounts).sort((a, b) => b[1] - a[1]);
+            winnerAnswer = sorted[0][0];
+            confidence = sorted[0][1];
+            winnerProvider = successful.find(r => r.answer === winnerAnswer)?.provider || 'unknown';
+            // Update Shapley summary
+            shapleySummary = (0, shapleyValue_1.summarize)(contributions);
+            // Record performance for handicap tracking
+            const isCorrect = (ans) => ans === winnerAnswer;
+            successful.forEach(r => {
+                const cost = weights[r.provider] || 0.001;
+                this.handicapCalc.record(r.provider, cost, isCorrect(r.answer));
+            });
+        }
+        // Record loyalty: successful collaborations build trust
+        if (strategy === 'shapley') {
+            for (const r of successful) {
+                if (r.answer === winnerAnswer) {
+                    for (const other of successful) {
+                        if (other.provider !== r.provider && other.answer === winnerAnswer) {
+                            this.loyaltyMatrix.recordSuccess(r.provider, other.provider, 1.0);
+                        }
+                    }
+                }
+            }
+        }
+        // Multi-round: add assistant turn
+        if (dialogId && winnerAnswer !== 'UNCERTAIN') {
+            multiRoundDialog_1.dialogOptimizer.addTurn(dialogId, 'assistant', winnerAnswer, winnerProvider);
+        }
         // 3. Final Assembly
         const allResults = {};
         successful.forEach(r => {
-            allResults[r.provider] = {
-                answer: r.answer,
-                score: r.answer === winnerAnswer ? 1.0 : 0.0
-            };
+            allResults[r.provider] = { answer: r.answer, score: r.answer === winnerAnswer ? 1.0 : 0.0 };
         });
+        let dialogState;
+        if (dialogId)
+            dialogState = multiRoundDialog_1.dialogOptimizer.getSummary(dialogId);
         return {
             finalAnswer: winnerAnswer,
-            confidence: confidence,
+            confidence,
             isUncertain: confidence < 0.6 || winnerAnswer === 'UNCERTAIN',
             winner: winnerProvider,
             allResults,
-            reasoning: `Ensemble of ${successful.length} models. ${Math.round(confidence * 100)}% agreement.`
+            reasoning: `Ensemble of ${successful.length} models. ${Math.round(confidence * 100)}% agreement.`,
+            shapleySummary,
+            dialogState,
         };
     }
+    /** Get best model for current dialog topic */
+    getBestModelForTopic(dialogId, availableModels) {
+        return multiRoundDialog_1.dialogOptimizer.getBestModelForTopic(dialogId, availableModels);
+    }
+    /** Build optimized context for multi-turn conversation */
+    buildOptimizedContext(dialogId, newQuery) {
+        return multiRoundDialog_1.dialogOptimizer.buildOptimizedContext(dialogId, newQuery);
+    }
+    /** Clear dialog state */
+    clearDialog(dialogId) {
+        multiRoundDialog_1.dialogOptimizer.clearState(dialogId);
+    }
 }
 exports.EnsembleOrchestrator = EnsembleOrchestrator;
+// Re-export enhanced utilities
+var shapleyValue_2 = require("./ensemble/shapleyValue");
+Object.defineProperty(exports, "LoyaltyMatrix", { enumerable: true, get: function () { return shapleyValue_2.LoyaltyMatrix; } });
+Object.defineProperty(exports, "HandicapCalculator", { enumerable: true, get: function () { return shapleyValue_2.HandicapCalculator; } });
+Object.defineProperty(exports, "calculateEnhancedShapley", { enumerable: true, get: function () { return shapleyValue_2.calculateEnhancedShapley; } });
+var multiRoundDialog_2 = require("./ensemble/multiRoundDialog");
+Object.defineProperty(exports, "dialogOptimizer", { enumerable: true, get: function () { return multiRoundDialog_2.dialogOptimizer; } });
+Object.defineProperty(exports, "MultiRoundDialogOptimizer", { enumerable: true, get: function () { return multiRoundDialog_2.MultiRoundDialogOptimizer; } });
 //# sourceMappingURL=ensemble.js.map

package/dist/index.d.ts

@@ -16,6 +16,9 @@ export { createProxyServer } from './server/proxyServer';
 export { Tracer, getTracer, createTracer, MetricsCollector, getMetrics, createMetricsCollector, observabilityMiddleware, observabilityPlugin, budgetAlertMiddleware, } from './observability';
 export type { Span, Metric, RouteTrace, ObservabilityEvent } from './observability';
 export { EnsembleOrchestrator, EnsembleStrategy, EnsembleResponse } from './ensemble';
+export { LoyaltyMatrix, HandicapCalculator, calculateEnhancedShapley, createAccuracyFn, applyCredit, summarize, type ShapleyConfig, type ShapleySummary, } from './ensemble/shapleyValue';
+export { MultiRoundDialogOptimizer, dialogOptimizer, type DialogTurn, type DialogState, } from './ensemble/multiRoundDialog';
+export { executeScienceQuery, routeScienceQuery, isScienceQuery, detectScienceDomain, scienceTools, RESEARCH_TEMPLATES, type ScienceQuery, type ScienceResult, } from './integrations/scienceAdapter';
 import { routeQuery, routeBatch, recommendForTask } from './routing/advancedRouter';
 import { getAvailableProviders, healthCheck } from './providers/providerConfig';
 import { CostTracker } from './cost/costTracker';

package/dist/index.js

@@ -2,7 +2,8 @@
 // A3M Router - Main Entry Point
 // Version: 2.0.0
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.EnsembleOrchestrator = exports.budgetAlertMiddleware = exports.observabilityPlugin = exports.observabilityMiddleware = exports.createMetricsCollector = exports.getMetrics = exports.MetricsCollector = exports.createTracer = exports.getTracer = exports.Tracer = exports.createProxyServer = exports.CostAnalytics = exports.GuardrailEngine = exports.SemanticCache = exports.estimateTokens = exports.countTokens = exports.MemoryTree = exports.createBudgetEnforcer = exports.BudgetExceededError = exports.BudgetEnforcer = exports.CostTracker = exports.saveConfig = exports.loadConfig = exports.findFastestAvailableProvider = exports.findCheapestAvailableProvider = exports.checkAllProviders = exports.healthCheck = exports.updateProvider = exports.deregisterProvider = exports.registerProvider = exports.getAvailableProviders = exports.DEFAULT_PROVIDERS = exports.PROVIDER_CONTEXT_LIMITS = exports.DEFAULT_PROVIDER_CONFIG = exports.DEFAULT_RETRY_CONFIG = exports.getDefaultRetryHandler = exports.createRetryHandler = exports.ProviderRetryHandler = exports.getProviderHealth = exports.updateModelProfile = exports.MODEL_PROFILES = exports.extractQueryFeatures = exports.recommendForTask = exports.routeBatch = exports.routeQuery = void 0;
+exports.applyCredit = exports.createAccuracyFn = exports.calculateEnhancedShapley = exports.HandicapCalculator = exports.LoyaltyMatrix = exports.EnsembleOrchestrator = exports.budgetAlertMiddleware = exports.observabilityPlugin = exports.observabilityMiddleware = exports.createMetricsCollector = exports.getMetrics = exports.MetricsCollector = exports.createTracer = exports.getTracer = exports.Tracer = exports.createProxyServer = exports.CostAnalytics = exports.GuardrailEngine = exports.SemanticCache = exports.estimateTokens = exports.countTokens = exports.MemoryTree = exports.createBudgetEnforcer = exports.BudgetExceededError = exports.BudgetEnforcer = exports.CostTracker = exports.saveConfig = exports.loadConfig = exports.findFastestAvailableProvider = exports.findCheapestAvailableProvider = exports.checkAllProviders = exports.healthCheck = exports.updateProvider = exports.deregisterProvider = exports.registerProvider = exports.getAvailableProviders = exports.DEFAULT_PROVIDERS = exports.PROVIDER_CONTEXT_LIMITS = exports.DEFAULT_PROVIDER_CONFIG = exports.DEFAULT_RETRY_CONFIG = exports.getDefaultRetryHandler = exports.createRetryHandler = exports.ProviderRetryHandler = exports.getProviderHealth = exports.updateModelProfile = exports.MODEL_PROFILES = exports.extractQueryFeatures = exports.recommendForTask = exports.routeBatch = exports.routeQuery = void 0;
+exports.RESEARCH_TEMPLATES = exports.scienceTools = exports.detectScienceDomain = exports.isScienceQuery = exports.routeScienceQuery = exports.executeScienceQuery = exports.dialogOptimizer = exports.MultiRoundDialogOptimizer = exports.summarize = void 0;
 exports.createA3MRouter = createA3MRouter;
 // ============================================================
 // ROUTING ENGINE
@@ -90,6 +91,32 @@ Object.defineProperty(exports, "budgetAlertMiddleware", { enumerable: true, get:
 var ensemble_1 = require("./ensemble");
 Object.defineProperty(exports, "EnsembleOrchestrator", { enumerable: true, get: function () { return ensemble_1.EnsembleOrchestrator; } });
 // ============================================================
+// ENHANCED SHAPLEY VALUE (Game Theory: Ethnocentrism + Handicap)
+// ============================================================
+var shapleyValue_1 = require("./ensemble/shapleyValue");
+Object.defineProperty(exports, "LoyaltyMatrix", { enumerable: true, get: function () { return shapleyValue_1.LoyaltyMatrix; } });
+Object.defineProperty(exports, "HandicapCalculator", { enumerable: true, get: function () { return shapleyValue_1.HandicapCalculator; } });
+Object.defineProperty(exports, "calculateEnhancedShapley", { enumerable: true, get: function () { return shapleyValue_1.calculateEnhancedShapley; } });
+Object.defineProperty(exports, "createAccuracyFn", { enumerable: true, get: function () { return shapleyValue_1.createAccuracyFn; } });
+Object.defineProperty(exports, "applyCredit", { enumerable: true, get: function () { return shapleyValue_1.applyCredit; } });
+Object.defineProperty(exports, "summarize", { enumerable: true, get: function () { return shapleyValue_1.summarize; } });
+// ============================================================
+// MULTI-ROUND DIALOG OPTIMIZATION
+// ============================================================
+var multiRoundDialog_1 = require("./ensemble/multiRoundDialog");
+Object.defineProperty(exports, "MultiRoundDialogOptimizer", { enumerable: true, get: function () { return multiRoundDialog_1.MultiRoundDialogOptimizer; } });
+Object.defineProperty(exports, "dialogOptimizer", { enumerable: true, get: function () { return multiRoundDialog_1.dialogOptimizer; } });
+// ============================================================
+// SCIENCE ADAPTER (Google DeepMind Skills)
+// ============================================================
+var scienceAdapter_1 = require("./integrations/scienceAdapter");
+Object.defineProperty(exports, "executeScienceQuery", { enumerable: true, get: function () { return scienceAdapter_1.executeScienceQuery; } });
+Object.defineProperty(exports, "routeScienceQuery", { enumerable: true, get: function () { return scienceAdapter_1.routeScienceQuery; } });
+Object.defineProperty(exports, "isScienceQuery", { enumerable: true, get: function () { return scienceAdapter_1.isScienceQuery; } });
+Object.defineProperty(exports, "detectScienceDomain", { enumerable: true, get: function () { return scienceAdapter_1.detectScienceDomain; } });
+Object.defineProperty(exports, "scienceTools", { enumerable: true, get: function () { return scienceAdapter_1.scienceTools; } });
+Object.defineProperty(exports, "RESEARCH_TEMPLATES", { enumerable: true, get: function () { return scienceAdapter_1.RESEARCH_TEMPLATES; } });
+// ============================================================
 // CONVENIENCE: Create a router instance
 // ============================================================
 const advancedRouter_2 = require("./routing/advancedRouter");

package/dist/integrations/scienceAdapter.d.ts

@@ -0,0 +1,77 @@
+/**
+ * A3M Router — Science Adapter
+ *
+ * Wraps Google DeepMind science skills as A3M tools for research queries.
+ *
+ * Available skills (39+):
+ *   Genomics: alphagenome_single_variant_analysis, ensembl, gnomad, dbsnp
+ *   Proteins: alphafold, uniprot, pdb, string
+ *   Chemistry: chembl, pubchem, openfda
+ *   Literature: arxiv, biorxiv, openalex, pubmed
+ *   Clinical: clinical_trials, clinvar
+ *   Expression: gtex, human_protein_atlas
+ */
+export interface ScienceQuery {
+    domain: 'genomics' | 'proteins' | 'chemistry' | 'literature' | 'clinical' | 'expression';
+    query: string;
+    species?: string;
+    protein?: string;
+    gene?: string;
+    disease?: string;
+}
+export interface ScienceResult {
+    success: boolean;
+    tool: string;
+    answer: string;
+    citations?: string[];
+    metadata?: Record<string, any>;
+}
+export declare const RESEARCH_TEMPLATES: Record<string, string>;
+/**
+ * Route a science query to the appropriate skill
+ */
+export declare function routeScienceQuery(query: ScienceQuery): string;
+/**
+ * Execute a science query using A3M routing
+ */
+export declare function executeScienceQuery(query: ScienceQuery): Promise<ScienceResult>;
+/**
+ * Check if a query is a science/research query
+ */
+export declare function isScienceQuery(prompt: string): boolean;
+/**
+ * Detect science domain from query
+ */
+export declare function detectScienceDomain(prompt: string): ScienceQuery['domain'] | null;
+export declare const scienceTools: {
+    alphafold: string;
+    uniprot: string;
+    pdb: string;
+    ensembl: string;
+    pubmed: string;
+    arxiv: string;
+    chembl: string;
+    pubchem: string;
+    clinicalTrials: string;
+    gtex: string;
+};
+declare const _default: {
+    executeScienceQuery: typeof executeScienceQuery;
+    routeScienceQuery: typeof routeScienceQuery;
+    isScienceQuery: typeof isScienceQuery;
+    detectScienceDomain: typeof detectScienceDomain;
+    scienceTools: {
+        alphafold: string;
+        uniprot: string;
+        pdb: string;
+        ensembl: string;
+        pubmed: string;
+        arxiv: string;
+        chembl: string;
+        pubchem: string;
+        clinicalTrials: string;
+        gtex: string;
+    };
+    RESEARCH_TEMPLATES: Record<string, string>;
+};
+export default _default;