openclaw-freerouter 1.3.0 → 2.0.0

package/src/router/config.ts

@@ -1,6 +1,6 @@
 /**
  * Default Routing Config — Customized for Direct API Keys
- * Forked from ClawRouter (MIT License). No payment dependencies.
+ * FreeRouter — Default Routing Config
  *
  * Tier models are mapped to providers YOU have API keys for.
  * Edit the `tiers` section to match your configured providers.
@@ -13,7 +13,6 @@
  */
 
 import type { RoutingConfig } from "./types.js";
-import { getConfig } from "../config.js";
 
 export const DEFAULT_ROUTING_CONFIG: RoutingConfig = {
   version: "2.0-direct",
@@ -210,33 +209,47 @@ export const DEFAULT_ROUTING_CONFIG: RoutingConfig = {
   },
 };
 
-
 /**
- * Get the effective routing config, merging external config overrides.
- * External config can override: tiers, agenticTiers, tierBoundaries.
- * Scoring weights and keywords remain as coded defaults (advanced users edit source).
+ * Get the default routing config.
  */
 export function getRoutingConfig(): RoutingConfig {
-  const extCfg = getConfig();
-  const config = { ...DEFAULT_ROUTING_CONFIG };
+  return DEFAULT_ROUTING_CONFIG;
+}
 
-  // Override tiers from external config
-  if (extCfg.tiers) {
-    config.tiers = extCfg.tiers as RoutingConfig["tiers"];
+/**
+ * Apply plugin config overrides to the routing config.
+ * Merges user-specified tiers, scoring, and defaultTier over defaults.
+ */
+export function applyConfigOverrides(base: RoutingConfig, pluginConfig: Record<string, unknown>): RoutingConfig {
+  const result = JSON.parse(JSON.stringify(base)) as RoutingConfig;
+
+  // Override tiers if provided
+  if (pluginConfig.tiers && typeof pluginConfig.tiers === "object") {
+    const userTiers = pluginConfig.tiers as Record<string, { primary: string; fallback?: string[] }>;
+    for (const [tier, cfg] of Object.entries(userTiers)) {
+      if (result.tiers[tier as keyof typeof result.tiers]) {
+        result.tiers[tier as keyof typeof result.tiers] = {
+          primary: cfg.primary,
+          fallback: cfg.fallback ?? [],
+        };
+      }
+    }
   }
 
-  // Override agentic tiers
-  if (extCfg.agenticTiers) {
-    config.agenticTiers = extCfg.agenticTiers as RoutingConfig["agenticTiers"];
+  // Override scoring config if provided
+  if (pluginConfig.scoring && typeof pluginConfig.scoring === "object") {
+    const userScoring = pluginConfig.scoring as Record<string, unknown>;
+    for (const [key, val] of Object.entries(userScoring)) {
+      if (key in result.scoring) {
+        (result.scoring as any)[key] = val;
+      }
+    }
   }
 
-  // Override tier boundaries
-  if (extCfg.tierBoundaries) {
-    config.scoring = {
-      ...config.scoring,
-      tierBoundaries: extCfg.tierBoundaries,
-    };
+  // Override default tier for ambiguous requests
+  if (pluginConfig.defaultTier && typeof pluginConfig.defaultTier === "string") {
+    result.overrides.ambiguousDefaultTier = pluginConfig.defaultTier as any;
   }
 
-  return config;
+  return result;
 }

package/src/router/index.ts

@@ -1,6 +1,6 @@
 /**
  * Smart Router Entry Point
- * Forked from ClawRouter (MIT License). No payment dependencies.
+ * FreeRouter — Smart Router Entry Point
  *
  * Classifies requests and routes to the best model from YOUR configured providers.
  * 100% local — rules-based scoring handles all requests in <1ms.
@@ -32,14 +32,12 @@ export function route(
 ): RoutingDecision {
   const { config, modelPricing } = options;
 
-  // Separate token counts: user prompt for complexity, total for context limits
-  // WHY: System prompts (AGENTS.md, SOUL.md) inflate token count — a "hello" with
-  // 10K system prompt shouldn't route to Opus. But total tokens still matter for context.
-  const estimatedUserTokens = Math.ceil(prompt.length / 4);
-  const estimatedTotalTokens = Math.ceil((`${systemPrompt ?? ""} ${prompt}`).length / 4);
+  // Estimate input tokens (~4 chars per token)
+  const fullText = `${systemPrompt ?? ""} ${prompt}`;
+  const estimatedTokens = Math.ceil(fullText.length / 4);
 
   // --- Rule-based classification ---
-  const ruleResult = classifyByRules(prompt, systemPrompt, estimatedUserTokens, config.scoring);
+  const ruleResult = classifyByRules(prompt, systemPrompt, estimatedTokens, config.scoring);
 
   // Determine if agentic tiers should be used
   const agenticScore = ruleResult.agenticScore ?? 0;
@@ -49,7 +47,7 @@ export function route(
   const tierConfigs = useAgenticTiers ? config.agenticTiers! : config.tiers;
 
   // --- Override: large context → force COMPLEX ---
-  if (estimatedTotalTokens > config.overrides.maxTokensForceComplex) {
+  if (estimatedTokens > config.overrides.maxTokensForceComplex) {
     return selectModel(
       "COMPLEX",
       0.95,
@@ -57,14 +55,13 @@ export function route(
       `Input exceeds ${config.overrides.maxTokensForceComplex} tokens${useAgenticTiers ? " | agentic" : ""}`,
       tierConfigs,
       modelPricing,
-      estimatedTotalTokens,
+      estimatedTokens,
       maxOutputTokens,
     );
   }
 
   // Structured output detection
-  // Only check user prompt for structured output request (system prompts often mention "json")
-  const hasStructuredOutput = /json|structured|schema/i.test(prompt);
+  const hasStructuredOutput = systemPrompt ? /json|structured|schema/i.test(systemPrompt) : false;
 
   let tier: Tier;
   let confidence: number;
@@ -103,7 +100,7 @@ export function route(
     reasoning,
     tierConfigs,
     modelPricing,
-    estimatedTotalTokens,
+    estimatedTokens,
     maxOutputTokens,
   );
 }

package/src/router/rules.ts

@@ -1,6 +1,6 @@
 /**
  * Rule-Based Classifier (v2 — Weighted Scoring)
- * Forked from ClawRouter (MIT License). No payment dependencies.
+ * FreeRouter — Rule-Based Classifier (Weighted Scoring)
  *
  * Scores a request across 14 weighted dimensions and maps the aggregate
  * score to a tier using configurable boundaries. Confidence is calibrated

package/src/router/selector.ts

@@ -1,6 +1,6 @@
 /**
  * Tier → Model Selection
- * Forked from ClawRouter (MIT License). No payment dependencies.
+ * FreeRouter — Tier to Model Selection
  *
  * Maps a classification tier to the best model from configured providers.
  * Builds RoutingDecision metadata with cost estimates and savings.

package/src/router/types.ts

@@ -1,6 +1,5 @@
 /**
- * Smart Router Types — Forked from ClawRouter (MIT License)
- * Stripped of x402/BlockRun payment layer.
+ * FreeRouter — Smart Router Types
  *
  * Four classification tiers — REASONING is distinct from COMPLEX because
  * reasoning tasks need different models (o3, deepseek-reasoner) than general