pi-smart-router 0.1.1 → 0.3.0

package/.pi/extensions/smart-router/delegation-runtime.ts

@@ -13,7 +13,11 @@ import {
 } from '@earendil-works/pi-ai/compat';
 import type { ModelRegistry } from '@earendil-works/pi-coding-agent';
 
-import { normalizeDelegationContext } from '../../../src/domain/delegation/delegation-context.js';
+import {
+  isGoogleDelegationTarget,
+  normalizeDelegationContext,
+  repairGeminiReplayContext,
+} from '../../../src/domain/delegation/delegation-context.js';
 import {
   computeOutputHeadroom,
   type OutputHeadroomConfig,
@@ -147,9 +151,15 @@ export function buildDelegationContext(
     ? deps.executionLedger.getLastExecution(sessionId)
     : null;
 
-  return normalizeDelegationContext(context, targetModel, {
+  const normalized = normalizeDelegationContext(context, targetModel, {
     sessionExecution,
   });
+
+  if (isGoogleDelegationTarget(targetModel)) {
+    return repairGeminiReplayContext(normalized, targetModel, sessionExecution);
+  }
+
+  return normalized;
 }
 
 export function createErrorMessage(

package/README.md

@@ -45,7 +45,7 @@ pi-smart-router builds on ideas from several production and research routing sys
 - **Adopted:** [GitHub Copilot HyDRA](https://arxiv.org/abs/2409.08379) (shortfall matching decoupled from model identities), Zero-Tier local edge-cache pattern, [Weave Router](https://github.com/workweave/router) session pinning and multi-objective selection
 - **Rejected:** FrugalGPT sequential cascading (tail latency), RouteLLM matrix factorization (confounder vulnerability), turn-by-turn dynamic routing (cache destruction)
 
-See [docs/PRD.md](docs/PRD.md) for full architectural justification.
+See [docs/PRD.md](docs/PRD.md) for full architectural justification, [docs/deep-research.md](docs/deep-research.md) for the research survey, [docs/routing-roadmap.md](docs/routing-roadmap.md) for the prioritized quality backlog, [docs/gemini-research.md](docs/gemini-research.md) for the second-source agent-router report, and [docs/research/README.md](docs/research/README.md) for research provenance.
 
 ## Prerequisites
 
@@ -169,7 +169,7 @@ pi exposes two different **auto** models. They are easy to confuse but play diff
 | `smart-router/auto` | `smart-router` (this extension) | Runs the routing pipeline on every turn and **delegates** to whichever underlying model HyDRA selects |
 | `cursor/auto` | `cursor` (pi registry) | Cursor's opaque auto model — **direct** inference target when selected; Cursor picks the backend model |
 
-**Recommended dogfood setup:** use `/model smart-router/auto` so routing, pinning, and telemetry stay active. Enable `cursor/auto` (and other Cursor models such as `composer-latest`) in your scoped fleet so the router can select them when appropriate — for example on planning turns or when the [Gemini tool-history guard](#gemini-thought_signature-400-errors) excludes Google models.
+**Recommended dogfood setup:** use `/model smart-router/auto` so routing, pinning, and telemetry stay active. Enable `cursor/auto` (and other Cursor models such as `composer-latest`) in your scoped fleet so the router can select them when appropriate — for example on planning turns or when the [Gemini tool-history guard](#gemini-thought_signature-400-errors) excludes unrepairable Google replay state.
 
 **When to pin `/model cursor/auto` directly (bypass the router):**
 
@@ -181,7 +181,7 @@ pi exposes two different **auto** models. They are easy to confuse but play diff
 
 - You want cost/capability-aware model selection across your full authenticated fleet
 - You rely on session pinning, failover, or `/smart-router status` / `history` telemetry
-- Tool-heavy sessions should fall back to `cursor/auto` or other non-Gemini models automatically (see [pi-smart-router#38](https://github.com/beettlle/pi-smart-router/issues/38))
+- Tool-heavy sessions with Gemini economical models work via in-repo replay repair; add `cursor/auto` for unrepairable Google replay edge cases (see [pi-smart-router#85](https://github.com/beettlle/pi-smart-router/issues/85))
 
 Cursor models (`cursor/*`, `composer-*`, and the opaque fleet id `default`) map to **frontier-cloud** tier in `pi-model-mapper.ts` so HyDRA can score them against Gemini and Claude instead of treating them as unknown economical models ([pi-smart-router#40](https://github.com/beettlle/pi-smart-router/issues/40), [pi-smart-router#70](https://github.com/beettlle/pi-smart-router/issues/70)). Related: [pi-smart-router#23](https://github.com/beettlle/pi-smart-router/issues/23) (turn envelope / pin order), [pi-smart-router#37](https://github.com/beettlle/pi-smart-router/issues/37) (Gemini `thought_signature` errors).
 
@@ -343,9 +343,34 @@ Cluster IDs are stable reason-code prefixes (`cluster_low_stakes_general`, `clus
 | `SMART_ROUTER_DATASET` | (unset) | Set to `1` to opt in to privacy-safe routing dataset capture (metadata and feature fields only; 30-day / 10k-row retention). Prompt text, messages, and tool arguments are never stored. Required for outcome labels and P(success) training export. See [#8](https://github.com/beettlle/pi-smart-router/issues/8). |
 | `SMART_ROUTER_DATASET_FINGERPRINT` | (unset) | Set to `1` (requires `SMART_ROUTER_DATASET=1`) to store an install-local HMAC-SHA256 fingerprint of each normalized prompt for duplicate detection within this install. The install pepper lives in `.pi-smart-router/.dataset-key` (gitignored) and is never exported. **Warning:** short or common prompts are vulnerable to offline rainbow-table guessing; use only when you accept that tradeoff. See [#10](https://github.com/beettlle/pi-smart-router/issues/10). |
 | `MODELS_YAML_PATH` | `./config/models.yaml` | Fleet catalog path (library API only) |
+| `SMART_ROUTER_PLANNING_TURN_BUFFER` | `2` | SAAR planning buffer: frontier planning turns allowed before hard-lock ([v0.2.0 Continuity](https://github.com/beettlle/pi-smart-router/issues/72)) |
+| `SMART_ROUTER_PREFIX_CACHE_WEIGHT` | `0.20` | SAAR weight on warm prefix value in cache breakeven math (0–1; [#73](https://github.com/beettlle/pi-smart-router/issues/73)) |
+| `SMART_ROUTER_IDLE_TIMEOUT_SECONDS` | `300` | SAAR idle seconds before pin reopens for full re-route |
+| `SMART_ROUTER_SWITCH_THRESHOLD` | `0.5` | SAAR switch score gate (0–1) for tier upgrades during hard-lock |
 | `ROUTER_SAFE_DEFAULT_TIER` | `economical-cloud` | Fallback tier on any routing failure |
 | `LITELLM_PRICING_URL` | — | LiteLLM pricing JSON source |
 
+### SAAR session pin and cache breakeven (v0.2.0 Continuity)
+
+v0.2.0 adds **Session-Aware Agentic Routing (SAAR)** pin knobs ([#72](https://github.com/beettlle/pi-smart-router/issues/72)) and a **cache breakeven gate** ([#73](https://github.com/beettlle/pi-smart-router/issues/73)) that blocks tier switches when `marginal_savings + future_cache_value <= cache_reprime_cost` — preventing cheap-turn savings from invalidating a warm prefix cache.
+
+| Knob | Env var | Default | Effect |
+|------|---------|---------|--------|
+| Planning buffer | `SMART_ROUTER_PLANNING_TURN_BUFFER` | `2` | First N turns may route planning to frontier while pin metadata stays economical |
+| Prefix cache weight | `SMART_ROUTER_PREFIX_CACHE_WEIGHT` | `0.20` | Discounted future cache credit in breakeven |
+| Idle reopen | `SMART_ROUTER_IDLE_TIMEOUT_SECONDS` | `300` | Seconds of inactivity before SAAR resets and pin reopens |
+| Hard-lock upgrade gate | `SMART_ROUTER_SWITCH_THRESHOLD` | `0.5` | Score threshold for tier upgrades after buffer exhaust |
+
+**Dogfood verification (multi-turn planning session)**
+
+1. Start pi with routing logs: `SMART_ROUTER_LOG_ROUTING=1 pi` (optional: tune SAAR env vars above).
+2. Run `/model smart-router/auto` and begin a multi-turn planning session (planning turns mixed with tool results).
+3. Inspect stderr JSON lines — confirm `saar_summary.buffer_active` / `saar_reason_code: saar_buffer_active` on early planning turns, then `hard_lock: true` / `saar_hard_lock` after the buffer exhausts.
+4. On a warm pinned session, trigger a `tool_result` sub-route — when breakeven fails, expect `breakeven_summary.decision: "blocked"` and `breakeven_reason_code: breakeven_blocked` while the pin holds.
+5. Use `pi router explain` (or `POST /v1/route/explain`) on the same session — `features.breakeven` and `features.saar` mirror telemetry fields for operator audit.
+
+See [routing-roadmap.md](docs/routing-roadmap.md) §2 P0 for design context.
+
 ### P(success) training export (baseline classifier)
 
 When `SMART_ROUTER_DATASET=1`, the router records privacy-safe dataset rows and behavioral outcome labels (model override, compaction pin break, `/smart-router feedback good|bad`). Export labeled training data from pi:
@@ -458,18 +483,21 @@ The `GatewayDispatch` layer wraps the pipeline with:
 
 If Gemini returns **400 INVALID_ARGUMENT** mentioning `thought_signature`, the router treats this as a **protocol validation error** (incomplete tool-call replay), not provider unavailability — it will **not** failover to another model.
 
-This typically happens when a session with prior tool calls is routed to Gemini before [pi preserves thought signatures in replay](https://github.com/earendil-works/pi/issues/6342). See [Google's thought signatures documentation](https://ai.google.dev/gemini-api/docs/generate-content/thought-signatures).
+See [Google's thought signatures documentation](https://ai.google.dev/gemini-api/docs/generate-content/thought-signatures).
 
-**Automatic guard (SP-077):** sessions with prior tool-call history exclude Google/Gemini models from routing (telemetry `reason_code: gemini_tool_history_excluded`) unless the operator sets `force_model_id` via `/model`. Non-tool sessions are unchanged.
+**Primary fix — replay repair (SP-127/128):** before every Google-target delegation, smart-router repairs tool-call replay state: prior turns keep captured `thoughtSignature` values; tool calls missing a signature receive the Google-accepted skip sentinel so pi-ai can replay without a 400. Typical Gemini-first tool loops on `/model smart-router/auto` no longer require `/new` or switching away from Google models.
 
-**Empty fleet fail-safe (SP-084):** when the guard filters every model in the scoped fleet (e.g. Google/Gemini-only dogfood configs), the router throws an actionable error instead of delegating with `selected_model_id: unknown`. Add a non-Google model such as `openai/gpt-4o-mini` or `cursor/auto` to the fleet, start `/new`, or pin `/model` to force a specific model.
+**Narrowed guard fail-safe (SP-129):** sessions with **unrepairable** Google-origin replay state (e.g. redacted thinking blocks paired with tool calls) exclude Gemini from routing (`reason_code: gemini_tool_history_excluded`) unless the operator sets `force_model_id` via `/model`. Repairable Google tool history is delegated normally.
 
-**Workarounds:**
+**Empty fleet fail-safe (SP-084):** when the guard filters every model in the scoped fleet (e.g. Google/Gemini-only dogfood configs with unrepairable replay risk), the router throws an actionable error instead of delegating with `selected_model_id: unknown`. Add a non-Google model such as `openai/gpt-4o-mini` or `cursor/auto` to the fleet, start `/new`, or pin `/model` to force a specific model.
 
-1. Start a fresh session with `/new` in pi.
-2. Switch to a non-Google model (e.g. `/model openai/gpt-4o-mini`) for tool-heavy sessions until the upstream fix lands.
+**If you still see a `thought_signature` error:**
 
-Related: [pi-smart-router#37](https://github.com/beettlle/pi-smart-router/issues/37), [pi-smart-router#38](https://github.com/beettlle/pi-smart-router/issues/38), [pi-smart-router#40](https://github.com/beettlle/pi-smart-router/issues/40), [pi-smart-router#41](https://github.com/beettlle/pi-smart-router/issues/41), [pi#6342](https://github.com/earendil-works/pi/issues/6342).
+1. Start a fresh session with `/new` in pi (clears unrepairable history).
+2. Switch to a non-Google model (e.g. `/model openai/gpt-4o-mini`) for that session.
+3. Upstream: [pi#6342](https://github.com/earendil-works/pi/issues/6342) tracks pi preserving thought signatures in session replay; smart-router repair covers the common cross-model routing case without waiting on that fix.
+
+Related: [pi-smart-router#37](https://github.com/beettlle/pi-smart-router/issues/37), [pi-smart-router#38](https://github.com/beettlle/pi-smart-router/issues/38), [pi-smart-router#40](https://github.com/beettlle/pi-smart-router/issues/40), [pi-smart-router#41](https://github.com/beettlle/pi-smart-router/issues/41), [pi-smart-router#85](https://github.com/beettlle/pi-smart-router/issues/85).
 
 ### Explain endpoint (library API)
 
@@ -537,6 +565,25 @@ Contributors must run `npm run build` before publishing or consuming the library
 | `npm run routing:calibration-aggregate` | Aggregate community telemetry for calibration |
 | `npm run routing:train-calibration` | Train routing calibration artifact bundle |
 | `npm run routing:verify-calibration` | Verify calibration bundle against benchmark prompts |
+| `npm run routing:ingest-benchmarks` | Regenerate `config/benchmark-profiles.json` from leaderboard fixtures |
+| `npm run routing:verify-benchmark-profiles` | CI smoke: assert checked-in profiles match fixture ingest |
+
+### Benchmark profile refresh
+
+Capability scores in `config/benchmark-profiles.json` are grounded from public leaderboard snapshots under `tests/fixtures/benchmark-leaderboards/`. Each artifact records provenance (`source_urls`, `scrape_date`, `catalog_freeze_date`) in its header.
+
+**Operator policy:**
+
+1. **PR smoke** — `.github/workflows/benchmark-profile-refresh.yml` runs on PRs that touch fixtures, ingest, or the checked-in artifact. It executes `npm run routing:verify-benchmark-profiles` so fixture edits cannot drift from `config/benchmark-profiles.json`.
+2. **Monthly refresh** — the same workflow runs on the 1st of each month (06:00 UTC) and via `workflow_dispatch`. It re-ingests fixtures, updates `catalog_freeze_date` to the run date, and opens a PR when model scores change.
+3. **Manual updates** — after editing fixture snapshots, run `npm run routing:ingest-benchmarks` (optionally `--catalog-freeze-date YYYY-MM-DD`) and commit the regenerated `config/benchmark-profiles.json` with the PR.
+
+Regenerate locally:
+
+```bash
+npm run routing:ingest-benchmarks
+npm run routing:verify-benchmark-profiles
+```
 
 ### Releasing
 

package/config/benchmark-profiles.json

@@ -0,0 +1,145 @@
+{
+  "version": 1,
+  "provenance": {
+    "source_urls": {
+      "swebench_verified": "https://www.swebench.com/",
+      "terminal_bench": "https://www.tbench.ai/leaderboard",
+      "livecodebench": "https://livecodebench.github.io/leaderboard.html",
+      "bfcl": "https://gorilla.cs.berkeley.edu/leaderboard.html"
+    },
+    "scrape_date": "2026-07-09",
+    "catalog_freeze_date": "2026-07-09"
+  },
+  "models": [
+    {
+      "model_id": "claude-3.5-haiku",
+      "capabilities": {
+        "reasoning": 0.5685,
+        "code_gen": 0.587,
+        "tool_use": 0.6095
+      },
+      "benchmark_sources": {
+        "bfcl": {
+          "raw_score": 70.6,
+          "normalized": 0.706
+        },
+        "livecodebench": {
+          "raw_score": 55,
+          "normalized": 0.55
+        },
+        "swebench_verified": {
+          "raw_score": 62.4,
+          "normalized": 0.624
+        },
+        "terminal_bench": {
+          "raw_score": 51.3,
+          "normalized": 0.513
+        }
+      }
+    },
+    {
+      "model_id": "claude-opus-4-5",
+      "capabilities": {
+        "reasoning": 0.767,
+        "code_gen": 0.7915,
+        "tool_use": 0.8035
+      },
+      "benchmark_sources": {
+        "bfcl": {
+          "raw_score": 88.2,
+          "normalized": 0.882
+        },
+        "livecodebench": {
+          "raw_score": 77.4,
+          "normalized": 0.774
+        },
+        "swebench_verified": {
+          "raw_score": 80.9,
+          "normalized": 0.809
+        },
+        "terminal_bench": {
+          "raw_score": 72.5,
+          "normalized": 0.725
+        }
+      }
+    },
+    {
+      "model_id": "claude-sonnet-4-6",
+      "capabilities": {
+        "reasoning": 0.738,
+        "code_gen": 0.7635,
+        "tool_use": 0.7625
+      },
+      "benchmark_sources": {
+        "bfcl": {
+          "raw_score": 84.5,
+          "normalized": 0.845
+        },
+        "livecodebench": {
+          "raw_score": 73.1,
+          "normalized": 0.731
+        },
+        "swebench_verified": {
+          "raw_score": 79.6,
+          "normalized": 0.7959999999999999
+        },
+        "terminal_bench": {
+          "raw_score": 68,
+          "normalized": 0.68
+        }
+      }
+    },
+    {
+      "model_id": "gemini-2.5-flash",
+      "capabilities": {
+        "reasoning": 0.5295,
+        "code_gen": 0.5525,
+        "tool_use": 0.5735
+      },
+      "benchmark_sources": {
+        "bfcl": {
+          "raw_score": 66.9,
+          "normalized": 0.669
+        },
+        "livecodebench": {
+          "raw_score": 52.4,
+          "normalized": 0.524
+        },
+        "swebench_verified": {
+          "raw_score": 58.1,
+          "normalized": 0.581
+        },
+        "terminal_bench": {
+          "raw_score": 47.8,
+          "normalized": 0.478
+        }
+      }
+    },
+    {
+      "model_id": "gpt-5.3-codex",
+      "capabilities": {
+        "reasoning": 0.796,
+        "code_gen": 0.833,
+        "tool_use": 0.8215
+      },
+      "benchmark_sources": {
+        "bfcl": {
+          "raw_score": 90.1,
+          "normalized": 0.9009999999999999
+        },
+        "livecodebench": {
+          "raw_score": 81.6,
+          "normalized": 0.816
+        },
+        "swebench_verified": {
+          "raw_score": 85,
+          "normalized": 0.85
+        },
+        "terminal_bench": {
+          "raw_score": 74.2,
+          "normalized": 0.742
+        }
+      }
+    }
+  ]
+}

package/config/models.yaml.example

@@ -1,5 +1,10 @@
 # Example fleet catalog — copy to config/models.yaml and customize.
 # See specs/001-build-smart-router/data-model.md (ModelProfile) and docs/PRD.md §5.
+#
+# Capability scores in this file are static examples. At runtime, mapPiModelToProfile
+# prefers benchmark-grounded profiles from config/benchmark-profiles.json (SP-136)
+# when a model id has an ingest row; regex/pattern defaults apply otherwise.
+# Regenerate the artifact with: npm run routing:ingest-benchmarks
 
 models:
   - id: local-gemma-4-7b

package/config/routing-calibration.json.example

@@ -1,14 +1,17 @@
 {
-  "version": 1,
+  "version": 2,
   "minimum_training_samples": {
     "hydra_projection": 100,
     "triage_thresholds": 50,
     "p_success_weights": 30,
+    "isotonic_calibrator": 30,
     "routing_centroids": 10
   },
   "hydra_projection": {
-    "version": 1,
+    "version": 2,
     "embedding_dim": 384,
+    "prefix_schema_version": 2,
+    "prefix_flag_count": 7,
     "weights": [
       0,
       0,
@@ -1205,6 +1208,15 @@
     ],
     "trained_sample_count": 0
   },
+  "isotonic_calibrator": {
+    "version": 1,
+    "min_training_samples": 30,
+    "x_knots": [0, 1],
+    "y_knots": [0, 1],
+    "trained_sample_count": 0,
+    "holdout_ece_raw": null,
+    "holdout_ece_calibrated": null
+  },
   "routing_centroids": {
     "version": 1,
     "embedding_dim": 384,

package/dist/api/explain/router-explain.d.ts

@@ -12,9 +12,10 @@
  *   - MUST produce a decision identical to the live pipeline for the same input
  *   - MUST emit no RoutingTelemetry with upstream cost (routing_latency_ms only)
  */
-import type { ModelProfile, RoutingDecision } from '../../domain/types/index.js';
+import type { ModelProfile, RoutingDecision, SaarConfig } from '../../domain/types/index.js';
 import { RouterPipeline } from '../../domain/pipeline/router-pipeline.js';
 import type { ClusterMatcher } from '../../domain/matching/cluster-matcher.js';
+import type { SessionPinner } from '../../domain/pinning/session-pinner.js';
 export interface ExplainValidationError {
     readonly error: 'validation_failed';
     readonly details: readonly string[];
@@ -36,6 +37,8 @@ export interface ExplainHandlerDeps {
     readonly fleet: readonly ModelProfile[];
     readonly pipeline: RouterPipeline;
     readonly clusterMatcher?: ClusterMatcher;
+    readonly sessionPinner?: SessionPinner;
+    readonly saarConfig?: SaarConfig;
 }
 /**
  * Create an explain handler bound to a shared pipeline instance.

package/dist/api/explain/router-explain.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"router-explain.d.ts","sourceRoot":"","sources":["../../../src/api/explain/router-explain.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAA2B,MAAM,6BAA6B,CAAC;AAE1G,OAAO,EAAE,cAAc,EAAE,MAAM,0CAA0C,CAAC;AAE1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0CAA0C,CAAC;AAK/E,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;CAChC;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;CACvC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;CAChC;AAED,MAAM,MAAM,aAAa,GAAG,cAAc,GAAG,iBAAiB,GAAG,kBAAkB,CAAC;AAIpF,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAC;CAC1C;AAID;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,kBAAkB,IAG7B,SAAS,OAAO,KAAG,OAAO,CAAC,aAAa,CAAC,CA+CxE"}
+{"version":3,"file":"router-explain.d.ts","sourceRoot":"","sources":["../../../src/api/explain/router-explain.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAA2B,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAEtH,OAAO,EAAE,cAAc,EAAE,MAAM,0CAA0C,CAAC;AAE1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0CAA0C,CAAC;AAC/E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AAK5E,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;CAChC;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;CACvC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;CAChC;AAED,MAAM,MAAM,aAAa,GAAG,cAAc,GAAG,iBAAiB,GAAG,kBAAkB,CAAC;AAIpF,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAC;IACzC,QAAQ,CAAC,aAAa,CAAC,EAAE,aAAa,CAAC;IACvC,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC;CAClC;AAID;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,kBAAkB,IAU7B,SAAS,OAAO,KAAG,OAAO,CAAC,aAAa,CAAC,CAyCxE"}

package/dist/api/explain/router-explain.js

@@ -23,7 +23,13 @@ import { enrichRoutingDecisionForExplain } from '../../infrastructure/telemetry/
  * session pin state and stage ordering are identical.
  */
 export function createExplainHandler(deps) {
-    const { fleet, pipeline, clusterMatcher } = deps;
+    const { fleet, pipeline, clusterMatcher, sessionPinner, saarConfig } = deps;
+    const explainEnrichmentOptions = {
+        fleet,
+        ...(clusterMatcher !== undefined ? { clusterMatcher } : {}),
+        ...(sessionPinner !== undefined ? { sessionPinner } : {}),
+        ...(saarConfig !== undefined ? { saarConfig } : {}),
+    };
     return async function explain(rawBody) {
         const parsed = RoutingRequestSchema.safeParse(rawBody);
         if (!parsed.success) {
@@ -41,10 +47,7 @@ export function createExplainHandler(deps) {
             const decision = await pipeline.route(request);
             return {
                 status: 200,
-                body: await enrichRoutingDecisionForExplain(request, decision, {
-                    fleet,
-                    ...(clusterMatcher !== undefined ? { clusterMatcher } : {}),
-                }),
+                body: await enrichRoutingDecisionForExplain(request, decision, explainEnrichmentOptions),
             };
         }
         catch {
@@ -60,10 +63,7 @@ export function createExplainHandler(deps) {
             };
             return {
                 status: 503,
-                body: await enrichRoutingDecisionForExplain(request, decision, {
-                    fleet,
-                    ...(clusterMatcher !== undefined ? { clusterMatcher } : {}),
-                }),
+                body: await enrichRoutingDecisionForExplain(request, decision, explainEnrichmentOptions),
             };
         }
     };

package/dist/api/explain/router-explain.js.map

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

package/dist/config/defaults.d.ts

@@ -2,6 +2,9 @@
  * Operator configuration defaults (FR-021).
  * Values sourced from specs/001-build-smart-router/data-model.md § Configuration (Operator).
  */
-import type { OperatorConfig } from '../domain/types/schemas.js';
+import { type OperatorConfig } from '../domain/types/schemas.js';
+export { DEFAULT_SAAR_CONFIG, resolveSaarConfigFromEnv } from '../domain/types/schemas.js';
+/** Merge operator env overrides onto defaults (SAAR section only today). */
+export declare function resolveOperatorConfigFromEnv(base?: OperatorConfig): OperatorConfig;
 export declare const DEFAULT_OPERATOR_CONFIG: Readonly<OperatorConfig>;
 //# sourceMappingURL=defaults.d.ts.map

package/dist/config/defaults.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAGjE,eAAO,MAAM,uBAAuB,EAAE,QAAQ,CAAC,cAAc,CA0BnD,CAAC"}
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAE3F,4EAA4E;AAC5E,wBAAgB,4BAA4B,CAC1C,IAAI,GAAE,cAAwC,GAC7C,cAAc,CAKhB;AAED,eAAO,MAAM,uBAAuB,EAAE,QAAQ,CAAC,cAAc,CA2BnD,CAAC"}

package/dist/config/defaults.js

@@ -2,7 +2,16 @@
  * Operator configuration defaults (FR-021).
  * Values sourced from specs/001-build-smart-router/data-model.md § Configuration (Operator).
  */
+import { DEFAULT_SAAR_CONFIG, resolveSaarConfigFromEnv, } from '../domain/types/schemas.js';
 import { DEFAULT_LOW_INTENSITY_WEIGHTS } from '../domain/routing/tier-features.js';
+export { DEFAULT_SAAR_CONFIG, resolveSaarConfigFromEnv } from '../domain/types/schemas.js';
+/** Merge operator env overrides onto defaults (SAAR section only today). */
+export function resolveOperatorConfigFromEnv(base = DEFAULT_OPERATOR_CONFIG) {
+    return {
+        ...base,
+        saar: resolveSaarConfigFromEnv(base.saar),
+    };
+}
 export const DEFAULT_OPERATOR_CONFIG = {
     frugality: {
         lambda_cost: 0.5,
@@ -29,5 +38,6 @@ export const DEFAULT_OPERATOR_CONFIG = {
         low_threshold: 0.35,
         p_success_alpha: 0.5,
     },
+    saar: DEFAULT_SAAR_CONFIG,
 };
 //# sourceMappingURL=defaults.js.map

package/dist/config/defaults.js.map

@@ -1 +1 @@
-{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC;AAEnF,MAAM,CAAC,MAAM,uBAAuB,GAA6B;IAC/D,SAAS,EAAE;QACT,WAAW,EAAE,GAAG;QAChB,cAAc,EAAE,GAAG;QACnB,gBAAgB,EAAE,IAAI;KACvB;IACD,eAAe,EAAE;QACf,SAAS,EAAE,CAAC;KACb;IACD,OAAO,EAAE;QACP,cAAc,EAAE,EAAE;KACnB;IACD,KAAK,EAAE;QACL,kBAAkB,EAAE,EAAE;QACtB,4BAA4B,EAAE,CAAC;QAC/B,qBAAqB,EAAE,EAAE;KAC1B;IACD,KAAK,EAAE;QACL,mBAAmB,EAAE,0BAA0B;KAChD;IACD,aAAa,EAAE;QACb,OAAO,EAAE,6BAA6B;QACtC,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,IAAI;QACnB,eAAe,EAAE,GAAG;KACrB;CACO,CAAC"}
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,mBAAmB,EACnB,wBAAwB,GAEzB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC;AAEnF,OAAO,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAE3F,4EAA4E;AAC5E,MAAM,UAAU,4BAA4B,CAC1C,OAAuB,uBAAuB;IAE9C,OAAO;QACL,GAAG,IAAI;QACP,IAAI,EAAE,wBAAwB,CAAC,IAAI,CAAC,IAAI,CAAC;KAC1C,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,uBAAuB,GAA6B;IAC/D,SAAS,EAAE;QACT,WAAW,EAAE,GAAG;QAChB,cAAc,EAAE,GAAG;QACnB,gBAAgB,EAAE,IAAI;KACvB;IACD,eAAe,EAAE;QACf,SAAS,EAAE,CAAC;KACb;IACD,OAAO,EAAE;QACP,cAAc,EAAE,EAAE;KACnB;IACD,KAAK,EAAE;QACL,kBAAkB,EAAE,EAAE;QACtB,4BAA4B,EAAE,CAAC;QAC/B,qBAAqB,EAAE,EAAE;KAC1B;IACD,KAAK,EAAE;QACL,mBAAmB,EAAE,0BAA0B;KAChD;IACD,aAAa,EAAE;QACb,OAAO,EAAE,6BAA6B;QACtC,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,IAAI;QACnB,eAAe,EAAE,GAAG;KACrB;IACD,IAAI,EAAE,mBAAmB;CACjB,CAAC"}

package/dist/config/pi-model-mapper.d.ts

@@ -2,10 +2,20 @@
  * Pi model registry → ModelProfile mapper.
  *
  * Maps pi `Model` objects (provider + id) to router fleet entries using
- * pattern-based lookup for known families. Unknown models receive conservative
- * economical-cloud defaults.
+ * pattern-based lookup for known families. When `config/benchmark-profiles.json`
+ * contains a row for the model id (SP-134/136 ingest output), capability
+ * vectors are grounded in benchmark scores instead of regex defaults.
+ * Unknown models or missing benchmark rows receive conservative pattern defaults.
  */
 import type { ModelLimits, ModelProfile, Tier } from '../domain/types/entities.js';
+/** Checked-in ingest artifact from `npm run routing:ingest-benchmarks` (SP-134). */
+export declare const DEFAULT_BENCHMARK_PROFILES_PATH: string;
+/**
+ * Test hook — override benchmark artifact path (null disables benchmark grounding).
+ */
+export declare function setBenchmarkProfilesPathForTests(filePath: string | null): void;
+/** Test hook — clear cached benchmark artifact between cases. */
+export declare function resetBenchmarkProfilesCacheForTests(): void;
 /** Pi registry `Model.cost` shape — per-token USD rates. */
 export interface PiRegistryCost {
     readonly input: number;

package/dist/config/pi-model-mapper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pi-model-mapper.d.ts","sourceRoot":"","sources":["../../src/config/pi-model-mapper.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAEV,WAAW,EAGX,YAAY,EACZ,IAAI,EACL,MAAM,6BAA6B,CAAC;AAErC,4DAA4D;AAC5D,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,cAAc,CAAC;CAChC;AAiBD,yFAAyF;AACzF,eAAO,MAAM,oBAAoB,EAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,CAIpE,CAAC;AAEF,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,IAAI,GAAG,WAAW,CAE/D;AAwDD;;;;;GAKG;AACH,eAAO,MAAM,gCAAgC,IAAM,CAAC;AAqIpD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,YAAY,GAAG,YAAY,CAuBrE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,GAAG,YAAY,EAAE,CAEpF"}
+{"version":3,"file":"pi-model-mapper.d.ts","sourceRoot":"","sources":["../../src/config/pi-model-mapper.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,OAAO,KAAK,EAEV,WAAW,EAGX,YAAY,EACZ,IAAI,EACL,MAAM,6BAA6B,CAAC;AAErC,oFAAoF;AACpF,eAAO,MAAM,+BAA+B,QAA+C,CAAC;AAqB5F;;GAEG;AACH,wBAAgB,gCAAgC,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAG9E;AAED,iEAAiE;AACjE,wBAAgB,mCAAmC,IAAI,IAAI,CAG1D;AA+DD,4DAA4D;AAC5D,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,cAAc,CAAC;CAChC;AAiBD,yFAAyF;AACzF,eAAO,MAAM,oBAAoB,EAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,CAIpE,CAAC;AAEF,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,IAAI,GAAG,WAAW,CAE/D;AAwDD;;;;;GAKG;AACH,eAAO,MAAM,gCAAgC,IAAM,CAAC;AAqIpD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,YAAY,GAAG,YAAY,CAuBrE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,GAAG,YAAY,EAAE,CAEpF"}

package/dist/config/pi-model-mapper.js

@@ -2,9 +2,94 @@
  * Pi model registry → ModelProfile mapper.
  *
  * Maps pi `Model` objects (provider + id) to router fleet entries using
- * pattern-based lookup for known families. Unknown models receive conservative
- * economical-cloud defaults.
+ * pattern-based lookup for known families. When `config/benchmark-profiles.json`
+ * contains a row for the model id (SP-134/136 ingest output), capability
+ * vectors are grounded in benchmark scores instead of regex defaults.
+ * Unknown models or missing benchmark rows receive conservative pattern defaults.
  */
+import { existsSync, readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { z } from 'zod';
+/** Checked-in ingest artifact from `npm run routing:ingest-benchmarks` (SP-134). */
+export const DEFAULT_BENCHMARK_PROFILES_PATH = resolve('config', 'benchmark-profiles.json');
+const benchmarkCapabilitiesSchema = z.object({
+    reasoning: z.number().min(0).max(1),
+    code_gen: z.number().min(0).max(1),
+    tool_use: z.number().min(0).max(1),
+});
+const benchmarkModelRowSchema = z.object({
+    model_id: z.string().min(1),
+    capabilities: benchmarkCapabilitiesSchema,
+});
+const benchmarkProfilesArtifactSchema = z.object({
+    version: z.literal(1),
+    models: z.array(benchmarkModelRowSchema).min(1),
+});
+let benchmarkProfilesPathOverride;
+let benchmarkCapabilitiesByModelId;
+/**
+ * Test hook — override benchmark artifact path (null disables benchmark grounding).
+ */
+export function setBenchmarkProfilesPathForTests(filePath) {
+    benchmarkProfilesPathOverride = filePath;
+    benchmarkCapabilitiesByModelId = undefined;
+}
+/** Test hook — clear cached benchmark artifact between cases. */
+export function resetBenchmarkProfilesCacheForTests() {
+    benchmarkProfilesPathOverride = undefined;
+    benchmarkCapabilitiesByModelId = undefined;
+}
+function resolveBenchmarkProfilesPath() {
+    if (benchmarkProfilesPathOverride === null) {
+        return null;
+    }
+    return benchmarkProfilesPathOverride ?? DEFAULT_BENCHMARK_PROFILES_PATH;
+}
+function loadBenchmarkCapabilitiesMap() {
+    if (benchmarkCapabilitiesByModelId !== undefined) {
+        return benchmarkCapabilitiesByModelId;
+    }
+    const filePath = resolveBenchmarkProfilesPath();
+    if (filePath === null || !existsSync(filePath)) {
+        benchmarkCapabilitiesByModelId = null;
+        return null;
+    }
+    try {
+        const raw = readFileSync(filePath, 'utf8');
+        const parsed = JSON.parse(raw);
+        const result = benchmarkProfilesArtifactSchema.safeParse(parsed);
+        if (!result.success) {
+            throw new Error(result.error.message);
+        }
+        const map = new Map();
+        for (const row of result.data.models) {
+            map.set(row.model_id, { ...row.capabilities });
+        }
+        benchmarkCapabilitiesByModelId = map;
+        return map;
+    }
+    catch (err) {
+        console.warn('benchmark profiles artifact invalid; using regex capability defaults', {
+            path: filePath,
+            error: err instanceof Error ? err.message : String(err),
+        });
+        benchmarkCapabilitiesByModelId = null;
+        return null;
+    }
+}
+function lookupBenchmarkCapabilities(modelId) {
+    return loadBenchmarkCapabilitiesMap()?.get(modelId);
+}
+function withBenchmarkCapabilities(defaults, modelId) {
+    const grounded = lookupBenchmarkCapabilities(modelId);
+    if (grounded === undefined) {
+        return defaults;
+    }
+    return {
+        ...defaults,
+        capabilities: { ...grounded },
+    };
+}
 const LOCAL_PROVIDERS = new Set(['lmstudio', 'ollama']);
 /** Conservative context limits when YAML and LiteLLM registry have no entry (SP-092). */
 export const DEFAULT_MODEL_LIMITS = {
@@ -196,16 +281,16 @@ export function mapPiModelToProfile(input) {
             id: input.id,
             ...(input.name !== undefined ? { name: input.name } : {}),
         };
-        return buildProfile(localInput, LOCAL_DEFAULTS);
+        return buildProfile(localInput, withBenchmarkCapabilities(LOCAL_DEFAULTS, input.id));
     }
     if (input.id === OPAQUE_FLEET_DEFAULT_ID) {
-        return buildProfile(input, CURSOR_AUTO_DEFAULTS);
+        return buildProfile(input, withBenchmarkCapabilities(CURSOR_AUTO_DEFAULTS, input.id));
     }
     const matched = matchPatternRules(input.id);
     if (matched) {
-        return buildProfile(input, matched);
+        return buildProfile(input, withBenchmarkCapabilities(matched, input.id));
     }
-    return buildProfile(input, UNKNOWN_DEFAULTS);
+    return buildProfile(input, withBenchmarkCapabilities(UNKNOWN_DEFAULTS, input.id));
 }
 /**
  * Map an array of pi registry models to a router fleet catalog.