agent-nuvira 1.14.0

package/dist/learning/model-compare.d.ts

@@ -0,0 +1,76 @@
+/**
+ * ModelCompare — A/B comparison engine that connects benchmark results
+ * to model routing recommendations.
+ *
+ * Provides:
+ * - Side-by-side benchmark comparison for two models
+ * - Automatic best-model recommendation per agent type
+ * - Integration with the ModelRouter and AgentStats
+ * - Human-readable comparison reports
+ */
+import type { BenchmarkRun, BenchmarkSummary } from './benchmark.js';
+/** A comparison result between two models */
+export interface ModelComparisonResult {
+    /** Model A details */
+    modelA: {
+        provider: string;
+        model: string;
+        summary: BenchmarkSummary;
+    };
+    /** Model B details */
+    modelB: {
+        provider: string;
+        model: string;
+        summary: BenchmarkSummary;
+    };
+    /** Per-metric winners */
+    winners: {
+        passRate: 'A' | 'B' | 'tie';
+        quality: 'A' | 'B' | 'tie';
+        latency: 'A' | 'B' | 'tie';
+        cost: 'A' | 'B' | 'tie';
+    };
+    /** Overall winner */
+    overallWinner: 'A' | 'B' | 'tie';
+    /** Recommendation string */
+    recommendation: string;
+}
+/** Recommendation for how to route agent types based on benchmark data */
+export interface BenchmarkDrivenRecommendation {
+    /** Agent type */
+    agentType: string;
+    /** Currently recommended model */
+    currentModel: string;
+    /** Better model found via benchmark */
+    betterModel: string | null;
+    /** Quality improvement expected (null if no improvement) */
+    qualityImprovement: number | null;
+    /** Confidence level */
+    confidence: 'high' | 'medium' | 'low';
+}
+/**
+ * Compare two benchmark runs and determine the winner.
+ */
+export declare function compareModelRuns(runA: BenchmarkRun, runB: BenchmarkRun): ModelComparisonResult;
+/**
+ * Compare two benchmark runs and auto-update the ModelRouter / AgentStats
+ * recommendations based on the results.
+ */
+export declare function compareAndRecommend(runA: BenchmarkRun, runB: BenchmarkRun, verbose?: boolean): Promise<{
+    comparison: ModelComparisonResult;
+    updatedRoutes: string[];
+}>;
+/**
+ * Find the best model for a specific agent type by comparing all
+ * available benchmark runs.
+ */
+export declare function findBestModelForAgent(agentType: string): BenchmarkDrivenRecommendation;
+/**
+ * Format a model comparison as a human-readable report.
+ */
+export declare function formatComparisonResult(result: ModelComparisonResult): string;
+/**
+ * Format benchmark-driven routing recommendations.
+ */
+export declare function formatBenchmarkRecommendations(recommendations: BenchmarkDrivenRecommendation[]): string;
+//# sourceMappingURL=model-compare.d.ts.map

package/dist/learning/model-compare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-compare.d.ts","sourceRoot":"","sources":["../../src/learning/model-compare.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAOrE,6CAA6C;AAC7C,MAAM,WAAW,qBAAqB;IACpC,sBAAsB;IACtB,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,gBAAgB,CAAA;KAAE,CAAC;IACvE,sBAAsB;IACtB,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,gBAAgB,CAAA;KAAE,CAAC;IACvE,yBAAyB;IACzB,OAAO,EAAE;QACP,QAAQ,EAAE,GAAG,GAAG,GAAG,GAAG,KAAK,CAAC;QAC5B,OAAO,EAAE,GAAG,GAAG,GAAG,GAAG,KAAK,CAAC;QAC3B,OAAO,EAAE,GAAG,GAAG,GAAG,GAAG,KAAK,CAAC;QAC3B,IAAI,EAAE,GAAG,GAAG,GAAG,GAAG,KAAK,CAAC;KACzB,CAAC;IACF,qBAAqB;IACrB,aAAa,EAAE,GAAG,GAAG,GAAG,GAAG,KAAK,CAAC;IACjC,4BAA4B;IAC5B,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,0EAA0E;AAC1E,MAAM,WAAW,6BAA6B;IAC5C,iBAAiB;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,uCAAuC;IACvC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,4DAA4D;IAC5D,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,uBAAuB;IACvB,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;CACvC;AAID;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,YAAY,EAClB,IAAI,EAAE,YAAY,GACjB,qBAAqB,CA4BvB;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,YAAY,EAClB,IAAI,EAAE,YAAY,EAClB,OAAO,GAAE,OAAe,GACvB,OAAO,CAAC;IACT,UAAU,EAAE,qBAAqB,CAAC;IAClC,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB,CAAC,CAqCD;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,GAChB,6BAA6B,CA6D/B;AAID;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,CAyB5E;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAC5C,eAAe,EAAE,6BAA6B,EAAE,GAC/C,MAAM,CAkCR"}

package/dist/learning/model-compare.js

@@ -0,0 +1,252 @@
+/**
+ * ModelCompare — A/B comparison engine that connects benchmark results
+ * to model routing recommendations.
+ *
+ * Provides:
+ * - Side-by-side benchmark comparison for two models
+ * - Automatic best-model recommendation per agent type
+ * - Integration with the ModelRouter and AgentStats
+ * - Human-readable comparison reports
+ */
+import { getBenchmarkRuns } from './benchmark.js';
+import { getAgentStats } from './agent-stats.js';
+// ─── Comparison Engine ──────────────────────────────────────────────────────
+/**
+ * Compare two benchmark runs and determine the winner.
+ */
+export function compareModelRuns(runA, runB) {
+    const a = runA.summary;
+    const b = runB.summary;
+    const passRateA = a.totalTasks > 0 ? a.tasksPassed / a.totalTasks : 0;
+    const passRateB = b.totalTasks > 0 ? b.tasksPassed / b.totalTasks : 0;
+    const winners = {
+        passRate: compareMetric(passRateA, passRateB, true),
+        quality: compareMetric(a.avgQualityScore, b.avgQualityScore, true),
+        latency: compareMetric(a.medianLatencyMs, b.medianLatencyMs, false),
+        cost: compareMetric(a.totalCostUsd, b.totalCostUsd, false),
+    };
+    // Overall winner: weighted scoring
+    const scoreA = calcOverallScore(runA);
+    const scoreB = calcOverallScore(runB);
+    const overallWinner = scoreA > scoreB ? 'A' : scoreB > scoreA ? 'B' : 'tie';
+    const recommendation = buildRecommendation(overallWinner, runA, runB, winners);
+    return {
+        modelA: { provider: runA.provider, model: runA.model, summary: runA.summary },
+        modelB: { provider: runB.provider, model: runB.model, summary: runB.summary },
+        winners,
+        overallWinner,
+        recommendation,
+    };
+}
+/**
+ * Compare two benchmark runs and auto-update the ModelRouter / AgentStats
+ * recommendations based on the results.
+ */
+export async function compareAndRecommend(runA, runB, verbose = false) {
+    const comparison = compareModelRuns(runA, runB);
+    const updatedRoutes = [];
+    // Update AgentStats with the comparison results
+    const stats = getAgentStats();
+    const winnerModel = comparison.overallWinner === 'A'
+        ? comparison.modelA.model
+        : comparison.modelB.model;
+    const winnerProvider = comparison.overallWinner === 'A'
+        ? comparison.modelA.provider
+        : comparison.modelB.provider;
+    const loserModel = comparison.overallWinner === 'A'
+        ? comparison.modelB.model
+        : comparison.modelA.model;
+    const loserProvider = comparison.overallWinner === 'A'
+        ? comparison.modelB.provider
+        : comparison.modelA.provider;
+    // Record a virtual run for each agent type with the winning model
+    const agentTypes = ['planner', 'writer', 'reviewer', 'tester', 'debugger', 'context-gatherer'];
+    for (const agentType of agentTypes) {
+        stats.recordRun(agentType, true, `${winnerProvider}/${winnerModel}`);
+        stats.recordRun(agentType, false, `${loserProvider}/${loserModel}`);
+    }
+    if (verbose) {
+        // Log updated recommendations
+        for (const agentType of agentTypes) {
+            const bestModel = stats.getBestModel(agentType);
+            if (bestModel) {
+                updatedRoutes.push(`${agentType} → ${bestModel}`);
+            }
+        }
+    }
+    return { comparison, updatedRoutes };
+}
+/**
+ * Find the best model for a specific agent type by comparing all
+ * available benchmark runs.
+ */
+export function findBestModelForAgent(agentType) {
+    const runs = getBenchmarkRuns();
+    if (runs.length < 2) {
+        return {
+            agentType,
+            currentModel: 'default',
+            betterModel: null,
+            qualityImprovement: null,
+            confidence: 'low',
+        };
+    }
+    // Group runs by provider/model
+    const modelGroups = new Map();
+    for (const run of runs) {
+        const key = `${run.provider}/${run.model}`;
+        if (!modelGroups.has(key))
+            modelGroups.set(key, []);
+        modelGroups.get(key).push(run);
+    }
+    // Find the best performing model group
+    let bestKey = '';
+    let bestScore = -1;
+    let secondBestScore = -1;
+    for (const [key, groupRuns] of modelGroups) {
+        const avgScore = groupRuns.reduce((sum, r) => {
+            return sum + calcOverallScore(r);
+        }, 0) / groupRuns.length;
+        if (avgScore > bestScore) {
+            secondBestScore = bestScore;
+            bestScore = avgScore;
+            bestKey = key;
+        }
+        else if (avgScore > secondBestScore) {
+            secondBestScore = avgScore;
+        }
+    }
+    const qualityImprovement = secondBestScore > 0
+        ? ((bestScore - secondBestScore) / secondBestScore) * 100
+        : null;
+    const confidence = modelGroups.size >= 3 && runs.length >= 6
+        ? 'high'
+        : modelGroups.size >= 2 && runs.length >= 3
+            ? 'medium'
+            : 'low';
+    // Get current recommendation from stats
+    const stats = getAgentStats();
+    const currentModel = stats.getBestModel(agentType) || 'default';
+    return {
+        agentType,
+        currentModel,
+        betterModel: bestKey !== `${currentModel}` ? bestKey : null,
+        qualityImprovement: qualityImprovement ? Math.round(qualityImprovement) : null,
+        confidence,
+    };
+}
+// ─── Formatting ─────────────────────────────────────────────────────────────
+/**
+ * Format a model comparison as a human-readable report.
+ */
+export function formatComparisonResult(result) {
+    const lines = [
+        '═'.repeat(60),
+        '  ⚔️  Model Comparison',
+        '═'.repeat(60),
+        '',
+        `  Model A: ${result.modelA.provider}/${result.modelA.model}`,
+        `  Model B: ${result.modelB.provider}/${result.modelB.model}`,
+        '',
+        '  ┌──────────────────┬──────────────────────┬──────────────────────┐',
+        '  │ Metric           │ Model A              │ Model B              │',
+        '  ├──────────────────┼──────────────────────┼──────────────────────┤',
+        `  │ Pass Rate        │ ${fmtPct(result.modelA.summary.tasksPassed, result.modelA.summary.totalTasks).padEnd(20)} │ ${fmtPct(result.modelB.summary.tasksPassed, result.modelB.summary.totalTasks).padEnd(20)} │ ${winnerBadge(result.winners.passRate)}`,
+        `  │ Quality          │ ${fmtScore(result.modelA.summary.avgQualityScore).padEnd(20)} │ ${fmtScore(result.modelB.summary.avgQualityScore).padEnd(20)} │ ${winnerBadge(result.winners.quality)}`,
+        `  │ Latency          │ ${fmtMs(result.modelA.summary.medianLatencyMs).padEnd(20)} │ ${fmtMs(result.modelB.summary.medianLatencyMs).padEnd(20)} │ ${winnerBadge(result.winners.latency)}`,
+        `  │ Cost             │ $${result.modelA.summary.totalCostUsd.toFixed(6).padEnd(17)} │ $${result.modelB.summary.totalCostUsd.toFixed(6).padEnd(17)} │ ${winnerBadge(result.winners.cost)}`,
+        '  └──────────────────┴──────────────────────┴──────────────────────┘',
+        '',
+        `  Overall winner: ${result.overallWinner === 'A' ? 'Model A' : result.overallWinner === 'B' ? 'Model B' : 'Tie'}`,
+        '',
+        `  Recommendation: ${result.recommendation}`,
+        '',
+    ];
+    return lines.join('\n');
+}
+/**
+ * Format benchmark-driven routing recommendations.
+ */
+export function formatBenchmarkRecommendations(recommendations) {
+    const lines = [
+        '═'.repeat(60),
+        '  📊  Benchmark-Driven Routing Recommendations',
+        '═'.repeat(60),
+        '',
+        '  Based on comparing benchmark runs, here are the recommended model',
+        '  updates for each agent type:',
+        '',
+        '  ┌─────────────────────┬──────────────────────┬──────────────────────┬──────────┐',
+        '  │ Agent               │ Current              │ Recommended          │ Change   │',
+        '  ├─────────────────────┼──────────────────────┼──────────────────────┼──────────┤',
+    ];
+    for (const rec of recommendations) {
+        const agent = rec.agentType.padEnd(18).slice(0, 18);
+        const current = rec.currentModel.padEnd(20).slice(0, 20);
+        if (rec.betterModel) {
+            const better = rec.betterModel.padEnd(20).slice(0, 20);
+            const change = rec.qualityImprovement !== null
+                ? `+${rec.qualityImprovement}%`.padStart(8)
+                : 'update'.padStart(8);
+            lines.push(`  │ ${agent} │ ${current} │ ${better} │ ${change} │`);
+        }
+        else {
+            const noChange = '─'.padStart(8);
+            lines.push(`  │ ${agent} │ ${current} │ ${'(best)'.padEnd(20)} │ ${noChange} │`);
+        }
+    }
+    lines.push('  └─────────────────────┴──────────────────────┴──────────────────────┴──────────┘');
+    lines.push('');
+    return lines.join('\n');
+}
+// ─── Helpers ────────────────────────────────────────────────────────────────
+function compareMetric(aVal, bVal, higherBetter) {
+    if (aVal === bVal)
+        return 'tie';
+    return higherBetter ? (aVal > bVal ? 'A' : 'B') : (aVal < bVal ? 'A' : 'B');
+}
+function calcOverallScore(run) {
+    const s = run.summary;
+    const passRate = s.totalTasks > 0 ? s.tasksPassed / s.totalTasks : 0;
+    const quality = s.avgQualityScore;
+    const latencyScore = Math.max(0, 1 - s.medianLatencyMs / 30000);
+    const costScore = Math.max(0, 1 - s.totalCostUsd / 1);
+    // Weighted score
+    return passRate * 0.4 + quality * 0.3 + latencyScore * 0.2 + costScore * 0.1;
+}
+function buildRecommendation(winner, runA, runB, winners) {
+    if (winner === 'tie') {
+        return 'Both models perform similarly. Consider cost or latency preferences.';
+    }
+    const winningModel = winner === 'A' ? runA.model : runB.model;
+    const losingModel = winner === 'A' ? runB.model : runA.model;
+    const advantages = [];
+    if ((winner === 'A' && winners.passRate === 'A') || (winner === 'B' && winners.passRate === 'B'))
+        advantages.push('higher pass rate');
+    if ((winner === 'A' && winners.quality === 'A') || (winner === 'B' && winners.quality === 'B'))
+        advantages.push('better quality');
+    if ((winner === 'A' && winners.latency === 'A') || (winner === 'B' && winners.latency === 'B'))
+        advantages.push('lower latency');
+    if ((winner === 'A' && winners.cost === 'A') || (winner === 'B' && winners.cost === 'B'))
+        advantages.push('lower cost');
+    return `${winningModel} is recommended over ${losingModel} due to ${advantages.join(', ')}.`;
+}
+function fmtPct(passed, total) {
+    if (total === 0)
+        return 'N/A';
+    return `${((passed / total) * 100).toFixed(0)}%`;
+}
+function fmtScore(score) {
+    return `${(score * 100).toFixed(1)}%`;
+}
+function fmtMs(ms) {
+    if (ms < 1000)
+        return `${Math.round(ms)}ms`;
+    return `${(ms / 1000).toFixed(1)}s`;
+}
+function winnerBadge(winner) {
+    if (winner === 'tie')
+        return '  ➖';
+    return winner === 'A' ? '  🔵' : '  🟠';
+}
+//# sourceMappingURL=model-compare.js.map

package/dist/learning/model-compare.js.map

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

package/dist/learning/model-router.d.ts

@@ -0,0 +1,68 @@
+/**
+ * ModelRouter — Recommends the optimal inference provider and model
+ * for different types of agent tasks.
+ *
+ * Task categories and their recommended providers:
+ *
+ * | Task Type              | Recommended Provider       | Rationale                     |
+ * |------------------------|---------------------------|-------------------------------|
+ * | code-format, lint      | local (small model)       | Fast, private, cheap          |
+ * | simple-edit, refactor  | groq / nim                | Low latency, good quality     |
+ * | architect, plan        | gemini / openrouter       | Large context, strong reasoning |
+ * | security-audit, review | openrouter (GPT-4/Claude) | Best at finding subtle issues |
+ * | test-generation        | any capable               | Depends on test framework     |
+ *
+ * The mapping is fully configurable — users can override via config file.
+ * The router integrates with Orchestrator's `agentModels` option.
+ */
+import type { ProviderType } from '../config/types.js';
+/** Categories of coding tasks that map to different model requirements */
+export type TaskType = 'code-format' | 'lint' | 'simple-edit' | 'refactor' | 'architect' | 'plan' | 'security-audit' | 'code-review' | 'test-generation' | 'context-gather' | 'debug' | 'default';
+/** A recommended provider + model pair */
+export interface ModelRecommendation {
+    provider: ProviderType;
+    model?: string;
+    /** Human-readable reason for this recommendation */
+    reason: string;
+}
+/**
+ * A mapping from agent type strings (as used in task plans) to
+ * the recommended model routing.
+ *
+ * Example:
+ * ```json
+ * {
+ *   "planner": "gemini-2.0-flash-exp",
+ *   "writer": "groq/llama-3.3-70b-versatile",
+ *   "reviewer": "openrouter/meta-llama/llama-3.1-8b-instruct"
+ * }
+ * ```
+ */
+export type AgentModelMap = Record<string, string>;
+/**
+ * Get the recommended model string for a given agent type.
+ * Format: "provider/model" or just "model" to use the default provider.
+ */
+export declare function recommendModel(agentType: string): ModelRecommendation;
+/**
+ * Build an `agentModels` map for the Orchestrator's `execute` options.
+ * This can be passed directly to automatically route each agent to
+ * its recommended model.
+ *
+ * @param overrides Optional overrides to customize specific agent models
+ */
+export declare function buildAgentModelMap(overrides?: AgentModelMap): AgentModelMap;
+/**
+ * Get the recommended provider type for a task type.
+ */
+export declare function recommendProvider(taskType: TaskType): ProviderType;
+/**
+ * Get the task type for an agent type.
+ */
+export declare function getTaskType(agentType: string): TaskType;
+/**
+ * Check whether a provider is well-suited for a given task type.
+ * Returns true if the provider matches or is a reasonable alternative.
+ */
+export declare function isProviderSuitable(provider: string, taskType: TaskType): boolean;
+//# sourceMappingURL=model-router.d.ts.map

package/dist/learning/model-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-router.d.ts","sourceRoot":"","sources":["../../src/learning/model-router.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAIvD,0EAA0E;AAC1E,MAAM,MAAM,QAAQ,GAChB,aAAa,GACb,MAAM,GACN,aAAa,GACb,UAAU,GACV,WAAW,GACX,MAAM,GACN,gBAAgB,GAChB,aAAa,GACb,iBAAiB,GACjB,gBAAgB,GAChB,OAAO,GACP,SAAS,CAAC;AAEd,0CAA0C;AAC1C,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,YAAY,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AA6CnD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,mBAAmB,CA8BrE;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,CAAC,EAAE,aAAa,GAAG,aAAa,CAY3E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,GAAG,YAAY,CAElE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,QAAQ,CAEvD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAehF"}

package/dist/learning/model-router.js

@@ -0,0 +1,140 @@
+/**
+ * ModelRouter — Recommends the optimal inference provider and model
+ * for different types of agent tasks.
+ *
+ * Task categories and their recommended providers:
+ *
+ * | Task Type              | Recommended Provider       | Rationale                     |
+ * |------------------------|---------------------------|-------------------------------|
+ * | code-format, lint      | local (small model)       | Fast, private, cheap          |
+ * | simple-edit, refactor  | groq / nim                | Low latency, good quality     |
+ * | architect, plan        | gemini / openrouter       | Large context, strong reasoning |
+ * | security-audit, review | openrouter (GPT-4/Claude) | Best at finding subtle issues |
+ * | test-generation        | any capable               | Depends on test framework     |
+ *
+ * The mapping is fully configurable — users can override via config file.
+ * The router integrates with Orchestrator's `agentModels` option.
+ */
+// ─── Default Mappings ───────────────────────────────────────────────────────
+/** Maps agent types to their recommended model strings */
+const DEFAULT_AGENT_MODELS = {
+    planner: 'gemini-2.0-flash-exp',
+    'context-gatherer': 'groq/llama-3.3-70b-versatile',
+    writer: 'groq/llama-3.3-70b-versatile',
+    reviewer: 'openrouter/meta-llama/llama-3.1-8b-instruct',
+    tester: 'groq/llama-3.3-70b-versatile',
+    debugger: 'openrouter/meta-llama/llama-3.1-8b-instruct',
+};
+/**
+ * Maps task types to their ideal provider (used for config-level routing).
+ * Agent-level routing is more specific and takes precedence.
+ */
+const TASK_TO_PROVIDER = {
+    'code-format': 'local',
+    lint: 'local',
+    'simple-edit': 'groq',
+    refactor: 'nim',
+    architect: 'gemini',
+    plan: 'gemini',
+    'security-audit': 'openrouter',
+    'code-review': 'openrouter',
+    'test-generation': 'groq',
+    'context-gather': 'groq',
+    debug: 'groq',
+    default: 'groq',
+};
+/** Maps agent types to their task type */
+const AGENT_TO_TASK = {
+    planner: 'plan',
+    'context-gatherer': 'context-gather',
+    writer: 'simple-edit',
+    reviewer: 'code-review',
+    tester: 'test-generation',
+    debugger: 'debug',
+};
+// ─── Router ────────────────────────────────────────────────────────────────
+/**
+ * Get the recommended model string for a given agent type.
+ * Format: "provider/model" or just "model" to use the default provider.
+ */
+export function recommendModel(agentType) {
+    const modelStr = DEFAULT_AGENT_MODELS[agentType];
+    if (!modelStr) {
+        // Fall back to default
+        return {
+            provider: TASK_TO_PROVIDER.default,
+            reason: `No specific recommendation for '${agentType}', using default`,
+        };
+    }
+    // Parse "provider/model" format
+    const slashIdx = modelStr.indexOf('/');
+    if (slashIdx > 0) {
+        const provider = modelStr.slice(0, slashIdx);
+        const model = modelStr.slice(slashIdx + 1);
+        return {
+            provider,
+            model,
+            reason: `Recommended for '${agentType}' tasks`,
+        };
+    }
+    // Just a model name — use its task type's preferred provider
+    const taskType = AGENT_TO_TASK[agentType] || 'default';
+    const provider = TASK_TO_PROVIDER[taskType];
+    return {
+        provider,
+        model: modelStr,
+        reason: `Recommended for '${agentType}' tasks`,
+    };
+}
+/**
+ * Build an `agentModels` map for the Orchestrator's `execute` options.
+ * This can be passed directly to automatically route each agent to
+ * its recommended model.
+ *
+ * @param overrides Optional overrides to customize specific agent models
+ */
+export function buildAgentModelMap(overrides) {
+    const map = {};
+    for (const agentType of Object.keys(DEFAULT_AGENT_MODELS)) {
+        if (overrides?.[agentType]) {
+            map[agentType] = overrides[agentType];
+        }
+        else {
+            map[agentType] = DEFAULT_AGENT_MODELS[agentType];
+        }
+    }
+    return map;
+}
+/**
+ * Get the recommended provider type for a task type.
+ */
+export function recommendProvider(taskType) {
+    return TASK_TO_PROVIDER[taskType] || TASK_TO_PROVIDER.default;
+}
+/**
+ * Get the task type for an agent type.
+ */
+export function getTaskType(agentType) {
+    return AGENT_TO_TASK[agentType] || 'default';
+}
+/**
+ * Check whether a provider is well-suited for a given task type.
+ * Returns true if the provider matches or is a reasonable alternative.
+ */
+export function isProviderSuitable(provider, taskType) {
+    const recommended = TASK_TO_PROVIDER[taskType] || TASK_TO_PROVIDER.default;
+    if (provider === recommended)
+        return true;
+    // Reasonable alternatives
+    const alternatives = {
+        'simple-edit': ['groq', 'nim', 'gemini'],
+        refactor: ['nim', 'groq', 'gemini'],
+        plan: ['gemini', 'openrouter'],
+        'code-review': ['openrouter', 'gemini'],
+    };
+    const alt = alternatives[taskType];
+    if (alt)
+        return alt.includes(provider);
+    return false;
+}
+//# sourceMappingURL=model-router.js.map

package/dist/learning/model-router.js.map

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