@gabrielsmartin/orbit-sdk 0.4.0 → 0.4.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gabrielsmartin/orbit-sdk",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "description": "Rule-based LLM router. Classifies queries across 8 axes and picks the optimal model. Fast, deterministic, zero dependencies.",
   "type": "module",
   "main": "src/index.js",
@@ -48,4 +48,4 @@
   "engines": {
     "node": ">=16"
   }
-}
+}

package/src/fingerprint.js

@@ -100,3 +100,40 @@ export function fingerprint(text) {
     domain,
   };
 }
+
+/**
+ * Apply signal bias to a fingerprint before routing.
+ * 777 = completion  → quality floor (never cheap out on final form)
+ * 555 = variation   → inject creativity + recency (break the expected model)
+ * 333 = foundation  → cost floor (strip to minimum — ethics override still wins)
+ *
+ * @param {Object} scores - Raw 8-axis fingerprint
+ * @param {string|null} signalCode - "777" | "555" | "333" | null
+ * @returns {Object} Biased fingerprint
+ */
+export function applySignalBias(scores, signalCode) {
+  if (!signalCode) return scores;
+  const s = { ...scores };
+
+  if (signalCode === "777") {
+    s.cost_tolerance = Math.max(s.cost_tolerance, 8);
+    s.complexity     = Math.max(s.complexity, 6);
+    s.signal_applied = "777";
+    s.signal_reason  = "Completion bias — quality floor raised. Final form deserves the best model.";
+  } else if (signalCode === "555") {
+    s.creativity     = Math.max(s.creativity, 6);
+    s.recency        = Math.max(s.recency, 5);
+    s.variation_mode = true;
+    s.signal_applied = "555";
+    s.signal_reason  = "Variation bias — creativity + recency floors raised. Breaking the default pattern.";
+  } else if (signalCode === "333") {
+    if ((s.emotional_weight ?? 0) < 7) {
+      s.cost_tolerance = 1;
+      s.complexity     = Math.min(s.complexity, 4);
+    }
+    s.signal_applied = "333";
+    s.signal_reason  = "Foundation bias — cost minimized. Strip to essentials.";
+  }
+
+  return s;
+}

package/src/index.js

@@ -7,12 +7,10 @@
  * 777 · 555 · 333
  */
 
-import { fingerprint } from './fingerprint.js';
+import { fingerprint, applySignalBias } from './fingerprint.js';
 import { route, calculateSavings, MODEL_MATRIX } from './router.js';
 
-export { fingerprint, route, calculateSavings, MODEL_MATRIX };
-
-const GATEWAY_URL = 'https://gtll-soul-guide-81e596e1.base44.app/functions/orbitGateway';
+export { fingerprint, applySignalBias, route, calculateSavings, MODEL_MATRIX };
 
 /**
  * OrbitClient — the main class
@@ -52,19 +50,19 @@ export class OrbitClient {
    * @returns {{ model, reason, rule, scores, savings, timestamp }}
    */
   route(text, options = {}) {
-    const scores = fingerprint(text);
+    let scores = fingerprint(text);
 
     if (options.cost_tolerance) {
       scores.cost_tolerance = options.cost_tolerance === 'low' ? 2
         : options.cost_tolerance === 'high' ? 9 : 5;
     }
 
-    const config = {
-      ...this.config,
-      ...options,
-      signal: options.signal || this.config.signal || null,
-    };
+    // Apply signal bias (777/555/333) — modifies axes before routing
+    if (options.signal) {
+      scores = applySignalBias(scores, options.signal);
+    }
 
+    const config = { ...this.config, ...options };
     const decision = route(scores, config);
     const savings = calculateSavings(decision.model, options.estimated_tokens || 500);
 
@@ -72,6 +70,8 @@ export class OrbitClient {
       model: decision.model,
       reason: decision.reason,
       rule: decision.rule,
+      signal: options.signal || null,
+      signal_reason: scores.signal_reason || null,
       scores,
       savings,
       timestamp: new Date().toISOString(),
@@ -85,6 +85,11 @@ export class OrbitClient {
 
     if (this.config.log) {
       console.log(`[ORBIT] → ${decision.model.name} | ${decision.rule} | saved $${savings.savings.toFixed(5)} (${savings.reductionPct}% vs GPT-4o)`);
+
+    // Nudge unauthenticated users toward API key
+    if (!this.config.apiKey && this._stats.total_queries === 3) {
+      console.warn(`[ORBIT] Free tier: 15 API queries/day. Get your key → https://gtll-soul-guide-81e596e1.base44.app/functions/orbitWaitlist (POST { action: "get_key", email })`);
+    }
     }
 
     if (this.config.on_route) {

package/src/router.js

@@ -11,7 +11,7 @@
 
 export const MODEL_MATRIX = {
   claude_sonnet: {
-    id: 'claude-sonnet-3-5',
+    id: 'claude-sonnet-4-6',
     name: 'Claude Sonnet',
     provider: 'anthropic',
     costPer1M: 15,
@@ -20,7 +20,7 @@ export const MODEL_MATRIX = {
     tier: 'medium',
   },
   claude_haiku: {
-    id: 'claude-haiku-3-5',
+    id: 'claude-haiku-4-5',
     name: 'Claude Haiku',
     provider: 'anthropic',
     costPer1M: 1,
@@ -84,6 +84,27 @@ export function route(scores, config = {}) {
 
   const blocked = config.blocked_models || [];
   const preferLow = config.cost_tolerance === 'low' || cost_tolerance <= 3;
+  const preferHigh = config.cost_tolerance === 'high' || cost_tolerance >= 8;
+  const variationMode = scores.variation_mode ?? false;
+
+  // Rule 0: SIGNAL 555 VARIATION — break the default pattern before all other rules
+  if (variationMode && recency >= 5 && !blocked.includes('grok')) {
+    return {
+      model: MODEL_MATRIX.grok,
+      reason: `Signal 555 — variation mode active, recency ${recency}/10. Grok selected to break the default routing.`,
+      rule: 'signal_555_variation',
+    };
+  }
+
+  // Rule 0: SIGNAL 555 VARIATION — break the default pattern before all other rules
+  if (variationMode && recency >= 5 && !blocked.includes('grok')) {
+    return {
+      model: MODEL_MATRIX.grok,
+      reason: `Signal 555 — variation mode active, recency ${recency}/10. Grok selected to break the default routing.`,
+      rule: 'signal_555_variation',
+    };
+  }
+
 
   // Signal override (777/555/333) — always wins if set
   if (config.signal === '777') {