@blockrun/clawrouter 0.12.95 → 0.12.97

package/dist/router/selector.js

@@ -0,0 +1,165 @@
+/**
+ * Tier → Model Selection
+ *
+ * Maps a classification tier to the cheapest capable model.
+ * Builds RoutingDecision metadata with cost estimates and savings.
+ */
+const BASELINE_MODEL_ID = "anthropic/claude-opus-4.6";
+// Hardcoded fallback: Claude Opus 4.6 pricing (per 1M tokens)
+// Used when baseline model not found in dynamic pricing map
+const BASELINE_INPUT_PRICE = 5.0;
+const BASELINE_OUTPUT_PRICE = 25.0;
+/**
+ * Select the primary model for a tier and build the RoutingDecision.
+ */
+export function selectModel(tier, confidence, method, reasoning, tierConfigs, modelPricing, estimatedInputTokens, maxOutputTokens, routingProfile, agenticScore) {
+    const tierConfig = tierConfigs[tier];
+    const model = tierConfig.primary;
+    const pricing = modelPricing.get(model);
+    let costEstimate;
+    if (pricing?.flatPrice !== undefined) {
+        costEstimate = pricing.flatPrice;
+    }
+    else {
+        const inputPrice = pricing?.inputPrice ?? 0;
+        const outputPrice = pricing?.outputPrice ?? 0;
+        costEstimate =
+            (estimatedInputTokens / 1_000_000) * inputPrice +
+                (maxOutputTokens / 1_000_000) * outputPrice;
+    }
+    // Baseline: what Claude Opus 4.5 would cost (the premium reference)
+    const opusPricing = modelPricing.get(BASELINE_MODEL_ID);
+    const opusInputPrice = opusPricing?.inputPrice ?? BASELINE_INPUT_PRICE;
+    const opusOutputPrice = opusPricing?.outputPrice ?? BASELINE_OUTPUT_PRICE;
+    const baselineInput = (estimatedInputTokens / 1_000_000) * opusInputPrice;
+    const baselineOutput = (maxOutputTokens / 1_000_000) * opusOutputPrice;
+    const baselineCost = baselineInput + baselineOutput;
+    // Premium profile doesn't calculate savings (it's about quality, not cost)
+    const savings = routingProfile === "premium"
+        ? 0
+        : baselineCost > 0
+            ? Math.max(0, (baselineCost - costEstimate) / baselineCost)
+            : 0;
+    return {
+        model,
+        tier,
+        confidence,
+        method,
+        reasoning,
+        costEstimate,
+        baselineCost,
+        savings,
+        ...(agenticScore !== undefined && { agenticScore }),
+    };
+}
+/**
+ * Get the ordered fallback chain for a tier: [primary, ...fallbacks].
+ */
+export function getFallbackChain(tier, tierConfigs) {
+    const config = tierConfigs[tier];
+    return [config.primary, ...config.fallback];
+}
+/**
+ * Calculate cost for a specific model (used when fallback model is used).
+ * Returns updated cost fields for RoutingDecision.
+ */
+// Server-side margin applied to all x402 payments (must match blockrun server's MARGIN_PERCENT)
+const SERVER_MARGIN_PERCENT = 5;
+// Minimum payment enforced by CDP Facilitator (must match blockrun server's MIN_PAYMENT_USD)
+const MIN_PAYMENT_USD = 0.001;
+export function calculateModelCost(model, modelPricing, estimatedInputTokens, maxOutputTokens, routingProfile) {
+    const pricing = modelPricing.get(model);
+    let costEstimate;
+    if (pricing?.flatPrice !== undefined) {
+        // Active promo: fixed cost per request
+        costEstimate = Math.max(pricing.flatPrice * (1 + SERVER_MARGIN_PERCENT / 100), MIN_PAYMENT_USD);
+    }
+    else {
+        // Defensive: guard against undefined price fields (not just undefined pricing)
+        const inputPrice = pricing?.inputPrice ?? 0;
+        const outputPrice = pricing?.outputPrice ?? 0;
+        const inputCost = (estimatedInputTokens / 1_000_000) * inputPrice;
+        const outputCost = (maxOutputTokens / 1_000_000) * outputPrice;
+        // Include server margin + minimum payment to match actual x402 charge
+        costEstimate = Math.max((inputCost + outputCost) * (1 + SERVER_MARGIN_PERCENT / 100), MIN_PAYMENT_USD);
+    }
+    // Baseline: what Claude Opus 4.5 would cost (the premium reference)
+    const opusPricing = modelPricing.get(BASELINE_MODEL_ID);
+    const opusInputPrice = opusPricing?.inputPrice ?? BASELINE_INPUT_PRICE;
+    const opusOutputPrice = opusPricing?.outputPrice ?? BASELINE_OUTPUT_PRICE;
+    const baselineInput = (estimatedInputTokens / 1_000_000) * opusInputPrice;
+    const baselineOutput = (maxOutputTokens / 1_000_000) * opusOutputPrice;
+    const baselineCost = baselineInput + baselineOutput;
+    // Premium profile doesn't calculate savings (it's about quality, not cost)
+    const savings = routingProfile === "premium"
+        ? 0
+        : baselineCost > 0
+            ? Math.max(0, (baselineCost - costEstimate) / baselineCost)
+            : 0;
+    return { costEstimate, baselineCost, savings };
+}
+/**
+ * Filter a model list to only those that support tool calling.
+ * When hasTools is false, returns the list unchanged.
+ * When all models lack tool calling support, returns the full list as a fallback
+ * (better to let the API error than produce an empty chain).
+ */
+export function filterByToolCalling(models, hasTools, supportsToolCalling) {
+    if (!hasTools)
+        return models;
+    const filtered = models.filter(supportsToolCalling);
+    return filtered.length > 0 ? filtered : models;
+}
+/**
+ * Filter a model list to only those that support vision (image inputs).
+ * When hasVision is false, returns the list unchanged.
+ * When all models lack vision support, returns the full list as a fallback
+ * (better to let the API error than produce an empty chain).
+ */
+export function filterByVision(models, hasVision, supportsVision) {
+    if (!hasVision)
+        return models;
+    const filtered = models.filter(supportsVision);
+    return filtered.length > 0 ? filtered : models;
+}
+/**
+ * Filter a model list to remove user-excluded models.
+ * When all models are excluded, returns the full list as a fallback
+ * (same safety pattern as filterByToolCalling/filterByVision).
+ */
+export function filterByExcludeList(models, excludeList) {
+    if (excludeList.size === 0)
+        return models;
+    const filtered = models.filter((m) => !excludeList.has(m));
+    return filtered.length > 0 ? filtered : models;
+}
+/**
+ * Get the fallback chain filtered by context length.
+ * Only returns models that can handle the estimated total context.
+ *
+ * @param tier - The tier to get fallback chain for
+ * @param tierConfigs - Tier configurations
+ * @param estimatedTotalTokens - Estimated total context (input + output)
+ * @param getContextWindow - Function to get context window for a model ID
+ * @returns Filtered list of models that can handle the context
+ */
+export function getFallbackChainFiltered(tier, tierConfigs, estimatedTotalTokens, getContextWindow) {
+    const fullChain = getFallbackChain(tier, tierConfigs);
+    // Filter to models that can handle the context
+    const filtered = fullChain.filter((modelId) => {
+        const contextWindow = getContextWindow(modelId);
+        if (contextWindow === undefined) {
+            // Unknown model - include it (let API reject if needed)
+            return true;
+        }
+        // Add 10% buffer for safety
+        return contextWindow >= estimatedTotalTokens * 1.1;
+    });
+    // If all models filtered out, return the original chain
+    // (let the API error out - better than no options)
+    if (filtered.length === 0) {
+        return fullChain;
+    }
+    return filtered;
+}
+//# sourceMappingURL=selector.js.map

package/dist/router/selector.js.map

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

package/dist/router/selector.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=selector.test.d.ts.map

package/dist/router/selector.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selector.test.d.ts","sourceRoot":"","sources":["../../src/router/selector.test.ts"],"names":[],"mappings":""}

package/dist/router/selector.test.js

@@ -0,0 +1,67 @@
+import { describe, expect, it } from "vitest";
+import { calculateModelCost, filterByExcludeList, filterByToolCalling, selectModel, } from "./selector.js";
+const TIER_CONFIGS = {
+    SIMPLE: { primary: "moonshot/kimi-k2.5", fallback: [] },
+    MEDIUM: { primary: "moonshot/kimi-k2.5", fallback: [] },
+    COMPLEX: { primary: "moonshot/kimi-k2.5", fallback: [] },
+    REASONING: { primary: "moonshot/kimi-k2.5", fallback: [] },
+};
+const MODEL_PRICING = new Map([
+    ["moonshot/kimi-k2.5", { inputPrice: 0.5, outputPrice: 2.4 }],
+    ["anthropic/claude-opus-4.6", { inputPrice: 5, outputPrice: 25 }],
+]);
+describe("selectModel", () => {
+    it("uses claude-opus-4.6 as baseline ID when computing savings", () => {
+        const decision = selectModel("SIMPLE", 0.95, "rules", "test", TIER_CONFIGS, MODEL_PRICING, 1000, 1000);
+        expect(decision.baselineCost).toBeGreaterThan(0);
+        expect(decision.savings).toBeGreaterThan(0);
+    });
+});
+describe("filterByToolCalling", () => {
+    const supportsToolCalling = (modelId) => !["minimax/minimax-m2.5", "nvidia/gpt-oss-120b"].includes(modelId);
+    it("removes models without tool calling support when request has tools", () => {
+        const models = ["moonshot/kimi-k2.5", "minimax/minimax-m2.5", "deepseek/deepseek-chat"];
+        const filtered = filterByToolCalling(models, true, supportsToolCalling);
+        expect(filtered).toEqual(["moonshot/kimi-k2.5", "deepseek/deepseek-chat"]);
+    });
+    it("keeps all models when request has no tools", () => {
+        const models = ["moonshot/kimi-k2.5", "minimax/minimax-m2.5", "nvidia/gpt-oss-120b"];
+        const filtered = filterByToolCalling(models, false, supportsToolCalling);
+        expect(filtered).toEqual(models);
+    });
+    it("returns original list unchanged when all models support tool calling", () => {
+        const models = ["moonshot/kimi-k2.5", "anthropic/claude-sonnet-4.6", "deepseek/deepseek-chat"];
+        const filtered = filterByToolCalling(models, true, supportsToolCalling);
+        expect(filtered).toEqual(models);
+    });
+    it("returns full list unchanged when no models support tool calling, to avoid empty chain", () => {
+        const models = ["minimax/minimax-m2.5", "nvidia/gpt-oss-120b"];
+        const filtered = filterByToolCalling(models, true, supportsToolCalling);
+        expect(filtered).toEqual(models);
+    });
+});
+describe("filterByExcludeList", () => {
+    const chain = ["moonshot/kimi-k2.5", "deepseek/deepseek-chat", "anthropic/claude-sonnet-4.6"];
+    it("removes excluded models from chain", () => {
+        const excludeList = new Set(["deepseek/deepseek-chat"]);
+        const filtered = filterByExcludeList(chain, excludeList);
+        expect(filtered).toEqual(["moonshot/kimi-k2.5", "anthropic/claude-sonnet-4.6"]);
+    });
+    it("returns original chain if ALL models excluded (safety net)", () => {
+        const excludeList = new Set(chain);
+        const filtered = filterByExcludeList(chain, excludeList);
+        expect(filtered).toEqual(chain);
+    });
+    it("returns original chain for empty exclude set", () => {
+        const filtered = filterByExcludeList(chain, new Set());
+        expect(filtered).toEqual(chain);
+    });
+});
+describe("calculateModelCost", () => {
+    it("uses claude-opus-4.6 as baseline ID when recomputing fallback costs", () => {
+        const costs = calculateModelCost("moonshot/kimi-k2.5", MODEL_PRICING, 1000, 1000);
+        expect(costs.baselineCost).toBeGreaterThan(0);
+        expect(costs.savings).toBeGreaterThan(0);
+    });
+});
+//# sourceMappingURL=selector.test.js.map

package/dist/router/selector.test.js.map

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

package/dist/router/strategy.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Router Strategy Registry
+ *
+ * Pluggable strategy system for request routing.
+ * Default: RulesStrategy — identical to the original inline route() logic, <1ms.
+ */
+import type { RoutingDecision, RouterStrategy, RouterOptions } from "./types.js";
+/**
+ * Rules-based routing strategy.
+ * Extracted from the original route() in index.ts — logic is identical.
+ * Attaches tierConfigs and profile to the decision for downstream use.
+ */
+export declare class RulesStrategy implements RouterStrategy {
+    readonly name = "rules";
+    route(prompt: string, systemPrompt: string | undefined, maxOutputTokens: number, options: RouterOptions): RoutingDecision;
+}
+export declare function getStrategy(name: string): RouterStrategy;
+export declare function registerStrategy(strategy: RouterStrategy): void;
+//# sourceMappingURL=strategy.d.ts.map

package/dist/router/strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategy.d.ts","sourceRoot":"","sources":["../../src/router/strategy.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAA+B,eAAe,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AA8C9G;;;;GAIG;AACH,qBAAa,aAAc,YAAW,cAAc;IAClD,QAAQ,CAAC,IAAI,WAAW;IAExB,KAAK,CACH,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,eAAe,EAAE,MAAM,EACvB,OAAO,EAAE,aAAa,GACrB,eAAe;CAwGnB;AAOD,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAMxD;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAE/D"}

package/dist/router/strategy.js

@@ -0,0 +1,138 @@
+/**
+ * Router Strategy Registry
+ *
+ * Pluggable strategy system for request routing.
+ * Default: RulesStrategy — identical to the original inline route() logic, <1ms.
+ */
+import { classifyByRules } from "./rules.js";
+import { selectModel } from "./selector.js";
+/**
+ * Apply active time-windowed promotions to tier configs.
+ * Returns a new tierConfigs object with promotion overrides merged in.
+ * Expired or not-yet-active promotions are ignored.
+ */
+function applyPromotions(tierConfigs, promotions, profile, now = new Date()) {
+    if (!promotions || promotions.length === 0)
+        return tierConfigs;
+    let result = tierConfigs;
+    for (const promo of promotions) {
+        // Check time window
+        const start = new Date(promo.startDate);
+        const end = new Date(promo.endDate);
+        if (now < start || now >= end)
+            continue;
+        // Check profile filter
+        if (promo.profiles && !promo.profiles.includes(profile))
+            continue;
+        // Shallow-clone on first mutation
+        if (result === tierConfigs) {
+            result = { ...tierConfigs };
+            for (const t of Object.keys(result)) {
+                result[t] = { ...result[t] };
+            }
+        }
+        // Merge overrides
+        for (const [tier, override] of Object.entries(promo.tierOverrides)) {
+            if (!result[tier])
+                continue;
+            if (override.primary)
+                result[tier].primary = override.primary;
+            if (override.fallback)
+                result[tier].fallback = override.fallback;
+        }
+    }
+    return result;
+}
+/**
+ * Rules-based routing strategy.
+ * Extracted from the original route() in index.ts — logic is identical.
+ * Attaches tierConfigs and profile to the decision for downstream use.
+ */
+export class RulesStrategy {
+    name = "rules";
+    route(prompt, systemPrompt, maxOutputTokens, options) {
+        const { config, modelPricing } = options;
+        // Estimate input tokens (~4 chars per token)
+        const fullText = `${systemPrompt ?? ""} ${prompt}`;
+        const estimatedTokens = Math.ceil(fullText.length / 4);
+        // --- Rule-based classification (runs first to get agenticScore) ---
+        const ruleResult = classifyByRules(prompt, systemPrompt, estimatedTokens, config.scoring);
+        // --- Select tier configs based on routing profile ---
+        const { routingProfile } = options;
+        let tierConfigs;
+        let profileSuffix;
+        let profile;
+        if (routingProfile === "eco" && config.ecoTiers) {
+            tierConfigs = config.ecoTiers;
+            profileSuffix = " | eco";
+            profile = "eco";
+        }
+        else if (routingProfile === "premium" && config.premiumTiers) {
+            tierConfigs = config.premiumTiers;
+            profileSuffix = " | premium";
+            profile = "premium";
+        }
+        else {
+            // Auto profile (or undefined): intelligent routing with agentic detection
+            const agenticScore = ruleResult.agenticScore ?? 0;
+            const isAutoAgentic = agenticScore >= 0.5;
+            const isExplicitAgentic = config.overrides.agenticMode ?? false;
+            const hasToolsInRequest = options.hasTools ?? false;
+            const useAgenticTiers = (hasToolsInRequest || isAutoAgentic || isExplicitAgentic) && config.agenticTiers != null;
+            tierConfigs = useAgenticTiers ? config.agenticTiers : config.tiers;
+            profileSuffix = useAgenticTiers ? ` | agentic${hasToolsInRequest ? " (tools)" : ""}` : "";
+            profile = useAgenticTiers ? "agentic" : "auto";
+        }
+        // Apply time-windowed promotions
+        tierConfigs = applyPromotions(tierConfigs, config.promotions, profile);
+        const agenticScoreValue = ruleResult.agenticScore;
+        // --- Override: large context → force COMPLEX ---
+        if (estimatedTokens > config.overrides.maxTokensForceComplex) {
+            const decision = selectModel("COMPLEX", 0.95, "rules", `Input exceeds ${config.overrides.maxTokensForceComplex} tokens${profileSuffix}`, tierConfigs, modelPricing, estimatedTokens, maxOutputTokens, routingProfile, agenticScoreValue);
+            return { ...decision, tierConfigs, profile };
+        }
+        // Structured output detection
+        const hasStructuredOutput = systemPrompt ? /json|structured|schema/i.test(systemPrompt) : false;
+        let tier;
+        let confidence;
+        const method = "rules";
+        let reasoning = `score=${ruleResult.score.toFixed(2)} | ${ruleResult.signals.join(", ")}`;
+        if (ruleResult.tier !== null) {
+            tier = ruleResult.tier;
+            confidence = ruleResult.confidence;
+        }
+        else {
+            // Ambiguous — default to configurable tier (no external API call)
+            tier = config.overrides.ambiguousDefaultTier;
+            confidence = 0.5;
+            reasoning += ` | ambiguous -> default: ${tier}`;
+        }
+        // Apply structured output minimum tier
+        if (hasStructuredOutput) {
+            const tierRank = { SIMPLE: 0, MEDIUM: 1, COMPLEX: 2, REASONING: 3 };
+            const minTier = config.overrides.structuredOutputMinTier;
+            if (tierRank[tier] < tierRank[minTier]) {
+                reasoning += ` | upgraded to ${minTier} (structured output)`;
+                tier = minTier;
+            }
+        }
+        // Add routing profile suffix to reasoning
+        reasoning += profileSuffix;
+        const decision = selectModel(tier, confidence, method, reasoning, tierConfigs, modelPricing, estimatedTokens, maxOutputTokens, routingProfile, agenticScoreValue);
+        return { ...decision, tierConfigs, profile };
+    }
+}
+// --- Strategy Registry ---
+const registry = new Map();
+registry.set("rules", new RulesStrategy());
+export function getStrategy(name) {
+    const strategy = registry.get(name);
+    if (!strategy) {
+        throw new Error(`Unknown routing strategy: ${name}`);
+    }
+    return strategy;
+}
+export function registerStrategy(strategy) {
+    registry.set(strategy.name, strategy);
+}
+//# sourceMappingURL=strategy.js.map

package/dist/router/strategy.js.map

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

package/dist/router/strategy.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=strategy.test.d.ts.map

package/dist/router/strategy.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategy.test.d.ts","sourceRoot":"","sources":["../../src/router/strategy.test.ts"],"names":[],"mappings":""}

package/dist/router/strategy.test.js

@@ -0,0 +1,131 @@
+import { describe, expect, it } from "vitest";
+import { RulesStrategy, getStrategy, registerStrategy } from "./strategy.js";
+import { DEFAULT_ROUTING_CONFIG } from "./config.js";
+import { route } from "./index.js";
+const MODEL_PRICING = new Map([
+    ["moonshot/kimi-k2.5", { inputPrice: 0.5, outputPrice: 2.4 }],
+    ["anthropic/claude-opus-4.6", { inputPrice: 5, outputPrice: 25 }],
+    ["google/gemini-2.5-flash", { inputPrice: 0.15, outputPrice: 0.6 }],
+    ["google/gemini-2.5-flash-lite", { inputPrice: 0.1, outputPrice: 0.4 }],
+    ["deepseek/deepseek-chat", { inputPrice: 0.14, outputPrice: 0.28 }],
+    ["anthropic/claude-sonnet-4.6", { inputPrice: 3, outputPrice: 15 }],
+    ["google/gemini-3.1-pro", { inputPrice: 1.25, outputPrice: 10 }],
+    ["xai/grok-4-1-fast-reasoning", { inputPrice: 0.2, outputPrice: 0.5 }],
+    ["nvidia/gpt-oss-120b", { inputPrice: 0, outputPrice: 0 }],
+    ["nvidia/gpt-oss-20b", { inputPrice: 0, outputPrice: 0 }],
+    ["nvidia/nemotron-ultra-253b", { inputPrice: 0, outputPrice: 0 }],
+    ["nvidia/nemotron-3-super-120b", { inputPrice: 0, outputPrice: 0 }],
+    ["nvidia/nemotron-super-49b", { inputPrice: 0, outputPrice: 0 }],
+    ["nvidia/deepseek-v3.2", { inputPrice: 0, outputPrice: 0 }],
+    ["nvidia/mistral-large-3-675b", { inputPrice: 0, outputPrice: 0 }],
+    ["nvidia/qwen3-coder-480b", { inputPrice: 0, outputPrice: 0 }],
+    ["nvidia/devstral-2-123b", { inputPrice: 0, outputPrice: 0 }],
+    ["nvidia/glm-4.7", { inputPrice: 0, outputPrice: 0 }],
+    ["nvidia/llama-4-maverick", { inputPrice: 0, outputPrice: 0 }],
+]);
+const baseOptions = {
+    config: DEFAULT_ROUTING_CONFIG,
+    modelPricing: MODEL_PRICING,
+};
+describe("RulesStrategy", () => {
+    it("returns tierConfigs in the decision", () => {
+        const strategy = new RulesStrategy();
+        const decision = strategy.route("hello", undefined, 100, baseOptions);
+        expect(decision.tierConfigs).toBeDefined();
+        expect(decision.tierConfigs.SIMPLE).toBeDefined();
+        expect(decision.tierConfigs.MEDIUM).toBeDefined();
+        expect(decision.tierConfigs.COMPLEX).toBeDefined();
+        expect(decision.tierConfigs.REASONING).toBeDefined();
+    });
+    it("returns profile in the decision", () => {
+        const strategy = new RulesStrategy();
+        const decision = strategy.route("hello", undefined, 100, baseOptions);
+        expect(decision.profile).toBeDefined();
+        expect(["auto", "eco", "premium", "agentic"]).toContain(decision.profile);
+    });
+    it("sets eco profile when routingProfile is eco", () => {
+        const strategy = new RulesStrategy();
+        const decision = strategy.route("hello", undefined, 100, {
+            ...baseOptions,
+            routingProfile: "eco",
+        });
+        expect(decision.profile).toBe("eco");
+        expect(decision.tierConfigs).toEqual(DEFAULT_ROUTING_CONFIG.ecoTiers);
+    });
+    it("sets premium profile when routingProfile is premium", () => {
+        const strategy = new RulesStrategy();
+        const decision = strategy.route("hello", undefined, 100, {
+            ...baseOptions,
+            routingProfile: "premium",
+        });
+        expect(decision.profile).toBe("premium");
+        expect(decision.tierConfigs).toEqual(DEFAULT_ROUTING_CONFIG.premiumTiers);
+    });
+    it("sets agentic profile when tools are present", () => {
+        const strategy = new RulesStrategy();
+        const decision = strategy.route("hello", undefined, 100, {
+            ...baseOptions,
+            hasTools: true,
+        });
+        expect(decision.profile).toBe("agentic");
+        expect(decision.tierConfigs).toEqual(DEFAULT_ROUTING_CONFIG.agenticTiers);
+    });
+    it("sets auto profile for default requests", () => {
+        const strategy = new RulesStrategy();
+        const decision = strategy.route("what is the capital of France", undefined, 100, baseOptions);
+        expect(decision.profile).toBe("auto");
+        expect(decision.tierConfigs).toEqual(DEFAULT_ROUTING_CONFIG.tiers);
+    });
+});
+describe("Strategy Registry", () => {
+    it("retrieves the default rules strategy", () => {
+        const strategy = getStrategy("rules");
+        expect(strategy).toBeInstanceOf(RulesStrategy);
+        expect(strategy.name).toBe("rules");
+    });
+    it("throws for unknown strategy", () => {
+        expect(() => getStrategy("nonexistent")).toThrow("Unknown routing strategy: nonexistent");
+    });
+    it("registers and retrieves a custom strategy", () => {
+        const custom = {
+            name: "custom-test",
+            route: (_prompt, _sys, _max, options) => ({
+                model: "test/model",
+                tier: "SIMPLE",
+                confidence: 1,
+                method: "rules",
+                reasoning: "custom strategy",
+                costEstimate: 0,
+                baselineCost: 0,
+                savings: 0,
+                tierConfigs: options.config.tiers,
+                profile: "auto",
+            }),
+        };
+        registerStrategy(custom);
+        const retrieved = getStrategy("custom-test");
+        expect(retrieved.name).toBe("custom-test");
+        const decision = retrieved.route("test", undefined, 100, baseOptions);
+        expect(decision.model).toBe("test/model");
+        expect(decision.reasoning).toBe("custom strategy");
+    });
+});
+describe("Backward compatibility", () => {
+    it("route() produces same model/tier/method as before", () => {
+        // Simple prompt → SIMPLE tier
+        const simple = route("hello", undefined, 100, baseOptions);
+        expect(simple.tier).toBe("SIMPLE");
+        expect(simple.method).toBe("rules");
+        expect(simple.model).toBeDefined();
+        // Reasoning prompt → REASONING tier
+        const reasoning = route("prove the theorem step by step using mathematical induction", undefined, 4096, baseOptions);
+        expect(reasoning.tier).toBe("REASONING");
+        expect(reasoning.method).toBe("rules");
+        // New fields are present
+        expect(simple.tierConfigs).toBeDefined();
+        expect(simple.profile).toBeDefined();
+        expect(reasoning.tierConfigs).toBeDefined();
+        expect(reasoning.profile).toBeDefined();
+    });
+});
+//# sourceMappingURL=strategy.test.js.map

package/dist/router/strategy.test.js.map

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