pi-smart-router 1.1.0 → 1.2.0

package/README.md

@@ -991,6 +991,28 @@ Set the encoder in operator config:
 
 MiniLM remains the default fallback when `encoder` is omitted. Both encoders produce 384-dim vectors compatible with the SP-115 learned projection head.
 
+**Opt-in per-prompt encoder cascade ([#173](https://github.com/beettlle/pi-smart-router/issues/173), v1.2.0 — default OFF).** Instead of a process-wide single encoder, an opt-in gate routes prompts whose estimated token count reaches a threshold to the long-context encoder, avoiding MiniLM's 512-token truncation on long turns:
+
+```json
+{
+  "hydra": {
+    "artifact_cache_path": ".pi-smart-router/models/",
+    "encoder": "minilm",
+    "encoder_cascade": {
+      "enabled": true,
+      "long_context_encoder": "granite",
+      "token_threshold": 512
+    }
+  }
+}
+```
+
+- **Default off** — existing single-encoder installs are unaffected and pay zero added cost (the gate is pre-embedding arithmetic, ~sub-microsecond p50 in replay).
+- **Lazy memory** — the Granite ONNX session loads only on the first over-threshold prompt; short prompts keep using the same MiniLM session, so their routing decisions are identical to the MiniLM-only baseline.
+- **Degrade, never mix** — encoders embed into different vector spaces. If Granite is unavailable at request time, routing continues on MiniLM with `granite_fallback` telemetry; the cascade never compares cross-encoder vectors. Per-encoder artifacts: bootstrap Granite centroids with `npm run routing:bootstrap-centroids -- --encoder granite` (namespaced `config/routing-centroids.granite.json`); `npm run routing:verify-calibration` rejects mixed-encoder bundles, and Granite-side projection ships honest-untrained.
+- **Telemetry** — cascade-enabled decisions carry `encoder_selected`, `token_estimate`, `cascade_threshold`, and `cascade_fallback_reason` on the feature sidecar.
+- **Evidence, not a default flip** — see the cascade replay report [`docs/qa/encoder-cascade-replay-v1.2.0.md`](docs/qa/encoder-cascade-replay-v1.2.0.md). Promoting the cascade (or Granite) to a default is a future ticket gated on the #173 eval table.
+
 **Latency budget:** the HyDRA embedding stage targets ~80–120 ms per turn. Compare MiniLM vs Granite on held-out agent turn samples:
 
 ```bash
@@ -1000,6 +1022,62 @@ npm run benchmark:encoder
 
 The script reports p50/p95 latency for each encoder and asserts Granite p50/p95 stay within the 120 ms budget ceiling. Requires `@huggingface/transformers` and a one-time ONNX artifact download.
 
+#### Granite opt-in dogfood runbook ([#167](https://github.com/beettlle/pi-smart-router/issues/167))
+
+Operator enablement for the Granite 97M long-context encoder on dogfood installs. **MiniLM remains the shipped default** — this runbook never flips `encoder` defaults; promotion is decided only through [#96](https://github.com/beettlle/pi-smart-router/issues/96) with dogfood evidence. The code path already shipped in [#80](https://github.com/beettlle/pi-smart-router/issues/80); do not reimplement it.
+
+**1. Fetch the model.** No manual download step is required — the ONNX artifact fetches on demand:
+
+| Item | Value |
+|------|-------|
+| Runtime HF ONNX id | `onnx-community/granite-embedding-97m-multilingual-r2-ONNX` (`GRANITE_ONNX_MODEL` in `src/domain/matching/embedding-provider.ts`) |
+| Upstream weights | `ibm-granite/granite-embedding-97m-multilingual-r2` (384-dim, long context) |
+| Cache dir | `hydra.artifact_cache_path` (default `.pi-smart-router/models/` — gitignored) |
+| Fetch trigger | First HyDRA embed with `encoder: granite`, **or** `npm run benchmark:encoder` (downloads on demand) |
+| Offline | One-time Hugging Face download; fully offline after cache warm (see Supply-chain below for pin modes) |
+
+Expected cache layout after fetch:
+
+```text
+.pi-smart-router/models/onnx-community/granite-embedding-97m-multilingual-r2-ONNX/
+```
+
+**2. Switch config (operator).** Edit `config/operator-config.json` on the dogfood host:
+
+```json
+{
+  "hydra": {
+    "artifact_cache_path": ".pi-smart-router/models/",
+    "encoder": "granite",
+    "hydra_heads": "learned_projection"
+  }
+}
+```
+
+Keep `hydra_heads: learned_projection` — Granite stays 384-dim compatible with the SP-115 projection (`config/hydra-projection-weights.json`). Do **not** enable `modernbert_k4` (still blocked on trained `config/modernbert-k4-heads.json`; tracked by #96).
+
+**3. Verify resident.** After a routed request, run `/smart-router plan` or `/smart-router doctor` to confirm the Granite encoder model and cache path are loaded. Smoke-check that routing still selects tiers and that there is **no silent MiniLM fallback** — if the encoder errors or exceeds budget, the neural stage fails open by design (#119 / #148) and telemetry/`reason_code` surfaces it; a crash or silent downgrade is a bug, not expected behavior.
+
+**4. Measure and archive.** Run the encoder benchmark and archive output for the issue trail:
+
+```bash
+mkdir -p .pi-smart-router/measurements/
+npm run benchmark:encoder | tee .pi-smart-router/measurements/benchmark-encoder-$(date +%Y%m%d).txt
+# optional: --fixtures path --cache .pi-smart-router/models/
+```
+
+Expectation: Granite p50/p95 within the ≤120 ms HyDRA embedding-stage budget (SP-204 go/no-go measured ~17 ms p50 for both encoders; [artifact](spine-tasks/_authoring/release-v0.11.0/encoder-gonogo-artifact.md)). `.pi-smart-router/measurements/` is gitignored — post a short summary comment on #167 with the numbers.
+
+**5. Post-switch follow-ups (feed #96 — evidence only, no default flip).** Track after Granite is live on the dogfood host:
+
+- **Latency regression watch** — HyDRA stage stays within ~80–120 ms on dogfood hardware vs SP-204 baselines; re-run `npm run benchmark:encoder` after fleet/catalog changes.
+- **Centroid / cluster space** — centroids were bootstrapped with MiniLM (`npm run routing:bootstrap-centroids`). Same 384-dim space, but embedding geometry differs; dry-run compare cluster match quality under Granite and document whether `config/routing-centroids.json` / the calibration bundle need refresh **before** any default flip.
+- **Projection / calibration** — SP-115 weights were trained on MiniLM embeddings. Run `npm run routing:calibration-dry-run` under Granite; if holdout ECE worsens, retrain the projection **or** keep MiniLM as the shipped default.
+- **Truncation / quality signal** — confirm long agent turns no longer hit MiniLM's 512-token wall (the primary motivation); note any residual encoder truncation surfaced in explain/telemetry.
+- **Degraded / fail-open path** — with Granite ONNX missing or slow, confirm neural failover still fails open (#119 / #148) rather than crashing the host agent.
+- **Feed #96** — after dogfood evidence, comment on #96 with *promote Granite as default?* yes/no + evidence. Only then open a separate issue/PR to flip defaults — never from dogfood alone (see `docs/qa/shadow-dogfood-protocol.md`).
+- **Do not conflate with ModernBERT** — K=4 stays blocked on trained `config/modernbert-k4-heads.json` (SP-218/219); out of scope here.
+
 #### Supply-chain: artifact pins, offline cache, and audit posture
 
 **Digest pinning (SP-259, [#147](https://github.com/beettlle/pi-smart-router/issues/147)).** The embedder verifies cached ONNX artifacts against SHA-256 pins before they are used. Pins live in [`config/onnx-artifact-pins.json`](config/onnx-artifact-pins.json) (`pins[modelId][cacheRelativePath] = sha256`; digests are the HuggingFace LFS oids for the default quantized artifacts). Pin mode is controlled by `SMART_ROUTER_ONNX_PIN_MODE`:

package/config/benchmark-profiles.json

@@ -7,8 +7,8 @@
       "livecodebench": "https://livecodebench.github.io/leaderboard.html",
       "bfcl": "https://gorilla.cs.berkeley.edu/leaderboard.html"
     },
-    "scrape_date": "2026-09-11",
-    "catalog_freeze_date": "2026-09-11"
+    "scrape_date": "2026-09-13",
+    "catalog_freeze_date": "2026-09-13"
   },
   "aliases": {
     "anthropic/claude-opus-4": "claude-opus-4-5",

package/config/operator-config.json.example

@@ -21,6 +21,13 @@
   "hydra": {
     "artifact_cache_path": ".pi-smart-router/models/",
     "encoder": "minilm",
+    "_encoder_documentation": "Encoder switch — minilm (shipped default) | granite (opt-in trial, #80/#167). Granite: ibm-granite/granite-embedding-97m-multilingual-r2 ONNX, 384-dim long-context drop-in; fetches on first use into artifact_cache_path. See README 'HyDRA model cache → Granite opt-in dogfood runbook (#167)' for fetch/switch/measure/follow-ups. Do NOT flip the shipped default here — promotion is decided only via #96.",
+    "encoder_cascade": {
+      "enabled": false,
+      "long_context_encoder": "granite",
+      "token_threshold": 512
+    },
+    "_encoder_cascade_documentation": "SP-291 (#173) — opt-in per-prompt encoder cascade. Default OFF: every prompt uses hydra.encoder (MiniLM) and existing installs are unaffected. When enabled, prompts whose estimated token count reaches token_threshold are embedded with long_context_encoder (Granite 97M, long-context) instead of MiniLM (512-token window), avoiding truncation on long prompts. The gate is pure pre-embedding arithmetic (~zero overhead) and reuses the turn-envelope token estimator (estimated_input_tokens ?? prompt_text.length). Hard constraint: encoders embed into different vector spaces — never mix per-encoder artifacts (routing centroids, learned projection); per-encoder artifact sets and the cascading embedder land with SP-292.",
     "hydra_heads": "learned_projection",
     "_onnx_artifact_pins_documentation": "SP-259 (#147) — ONNX artifact supply-chain pinning. Digests live in config/onnx-artifact-pins.json (SHA-256 per cached artifact). Enable with env SMART_ROUTER_ONNX_PIN_MODE=verify (verify configured pins; unpinned models still download) or =enforce (CI/prod: pins required for the loaded model — missing pin file, missing pins, missing cached artifact, or any digest mismatch fails closed). Default off preserves first-run unpinned dogfood downloads. Override pin file path with SMART_ROUTER_ONNX_PIN_FILE. See README 'HyDRA model cache → Supply-chain' for offline cache warm and audit posture.",
     "_hydra_heads_documentation": {

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,EAWL,KAAK,cAAc,EACpB,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EACL,iCAAiC,EACjC,yBAAyB,EACzB,gCAAgC,EAChC,mBAAmB,EACnB,kCAAkC,EAClC,4BAA4B,EAC5B,qCAAqC,EACrC,oCAAoC,EACpC,wBAAwB,GACzB,MAAM,4BAA4B,CAAC;AAEpC,4GAA4G;AAC5G,wBAAgB,4BAA4B,CAC1C,IAAI,GAAE,cAAwC,GAC7C,cAAc,CAOhB;AAED,eAAO,MAAM,uBAAuB,EAAE,QAAQ,CAAC,cAAc,CAuCnD,CAAC"}
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAYL,KAAK,cAAc,EACpB,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EACL,iCAAiC,EACjC,yBAAyB,EACzB,gCAAgC,EAChC,mBAAmB,EACnB,kCAAkC,EAClC,4BAA4B,EAC5B,qCAAqC,EACrC,oCAAoC,EACpC,wBAAwB,GACzB,MAAM,4BAA4B,CAAC;AAEpC,4GAA4G;AAC5G,wBAAgB,4BAA4B,CAC1C,IAAI,GAAE,cAAwC,GAC7C,cAAc,CAOhB;AAED,eAAO,MAAM,uBAAuB,EAAE,QAAQ,CAAC,cAAc,CAyCnD,CAAC"}

package/dist/config/defaults.js

@@ -2,7 +2,7 @@
  * Operator configuration defaults (FR-021).
  * Values sourced from specs/001-build-smart-router/data-model.md § Configuration (Operator).
  */
-import { DEFAULT_ADAPTIVE_REASONING_CONFIG, DEFAULT_DEGRADED_ROUTE_CONFIG, DEFAULT_LOCAL_ZERO_CONFIG, DEFAULT_PLANNING_DELEGATE_CONFIG, DEFAULT_SAAR_CONFIG, DEFAULT_SPECULATIVE_PREWARM_CONFIG, DEFAULT_WORKLOAD_HEAT_CONFIG, resolveAdaptiveReasoningConfigFromEnv, resolvePlanningDelegateConfigFromEnv, resolveSaarConfigFromEnv, } from '../domain/types/schemas.js';
+import { DEFAULT_ADAPTIVE_REASONING_CONFIG, DEFAULT_DEGRADED_ROUTE_CONFIG, DEFAULT_ENCODER_CASCADE_CONFIG, DEFAULT_LOCAL_ZERO_CONFIG, DEFAULT_PLANNING_DELEGATE_CONFIG, DEFAULT_SAAR_CONFIG, DEFAULT_SPECULATIVE_PREWARM_CONFIG, DEFAULT_WORKLOAD_HEAT_CONFIG, resolveAdaptiveReasoningConfigFromEnv, resolvePlanningDelegateConfigFromEnv, resolveSaarConfigFromEnv, } from '../domain/types/schemas.js';
 import { DEFAULT_LOW_INTENSITY_WEIGHTS } from '../domain/routing/tier-features.js';
 export { DEFAULT_ADAPTIVE_REASONING_CONFIG, DEFAULT_LOCAL_ZERO_CONFIG, DEFAULT_PLANNING_DELEGATE_CONFIG, DEFAULT_SAAR_CONFIG, DEFAULT_SPECULATIVE_PREWARM_CONFIG, DEFAULT_WORKLOAD_HEAT_CONFIG, resolveAdaptiveReasoningConfigFromEnv, resolvePlanningDelegateConfigFromEnv, resolveSaarConfigFromEnv, } from '../domain/types/schemas.js';
 /** Merge operator env overrides onto defaults (adaptive reasoning, SAAR and planning delegate sections). */
@@ -34,6 +34,8 @@ export const DEFAULT_OPERATOR_CONFIG = {
     hydra: {
         artifact_cache_path: '.pi-smart-router/models/',
         encoder: 'minilm',
+        /** Opt-in encoder cascade (SP-291, #173): default off. */
+        encoder_cascade: DEFAULT_ENCODER_CASCADE_CONFIG,
         hydra_heads: 'learned_projection',
     },
     low_intensity: {

package/dist/config/defaults.js.map

@@ -1 +1 @@
-{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,iCAAiC,EACjC,6BAA6B,EAC7B,yBAAyB,EACzB,gCAAgC,EAChC,mBAAmB,EACnB,kCAAkC,EAClC,4BAA4B,EAC5B,qCAAqC,EACrC,oCAAoC,EACpC,wBAAwB,GAEzB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC;AAEnF,OAAO,EACL,iCAAiC,EACjC,yBAAyB,EACzB,gCAAgC,EAChC,mBAAmB,EACnB,kCAAkC,EAClC,4BAA4B,EAC5B,qCAAqC,EACrC,oCAAoC,EACpC,wBAAwB,GACzB,MAAM,4BAA4B,CAAC;AAEpC,4GAA4G;AAC5G,MAAM,UAAU,4BAA4B,CAC1C,OAAuB,uBAAuB;IAE9C,OAAO;QACL,GAAG,IAAI;QACP,kBAAkB,EAAE,qCAAqC,CAAC,IAAI,CAAC,kBAAkB,CAAC;QAClF,IAAI,EAAE,wBAAwB,CAAC,IAAI,CAAC,IAAI,CAAC;QACzC,iBAAiB,EAAE,oCAAoC,CAAC,IAAI,CAAC,iBAAiB,CAAC;KAChF,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;QAC/C,OAAO,EAAE,QAAQ;QACjB,WAAW,EAAE,oBAAoB;KAClC;IACD,aAAa,EAAE;QACb,OAAO,EAAE,6BAA6B;QACtC,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,IAAI;QACnB,eAAe,EAAE,GAAG;KACrB;IACD,IAAI,EAAE,mBAAmB;IACzB,iBAAiB,EAAE,gCAAgC;IACnD,UAAU,EAAE,yBAAyB;IACrC,cAAc,EAAE,6BAA6B;IAC7C,8EAA8E;IAC9E,aAAa,EAAE,4BAA4B;IAC3C,mFAAmF;IACnF,mBAAmB,EAAE,kCAAkC;IACvD,8EAA8E;IAC9E,kBAAkB,EAAE,iCAAiC;IACrD,iBAAiB,EAAE,KAAK;CAChB,CAAC"}
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,iCAAiC,EACjC,6BAA6B,EAC7B,8BAA8B,EAC9B,yBAAyB,EACzB,gCAAgC,EAChC,mBAAmB,EACnB,kCAAkC,EAClC,4BAA4B,EAC5B,qCAAqC,EACrC,oCAAoC,EACpC,wBAAwB,GAEzB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC;AAEnF,OAAO,EACL,iCAAiC,EACjC,yBAAyB,EACzB,gCAAgC,EAChC,mBAAmB,EACnB,kCAAkC,EAClC,4BAA4B,EAC5B,qCAAqC,EACrC,oCAAoC,EACpC,wBAAwB,GACzB,MAAM,4BAA4B,CAAC;AAEpC,4GAA4G;AAC5G,MAAM,UAAU,4BAA4B,CAC1C,OAAuB,uBAAuB;IAE9C,OAAO;QACL,GAAG,IAAI;QACP,kBAAkB,EAAE,qCAAqC,CAAC,IAAI,CAAC,kBAAkB,CAAC;QAClF,IAAI,EAAE,wBAAwB,CAAC,IAAI,CAAC,IAAI,CAAC;QACzC,iBAAiB,EAAE,oCAAoC,CAAC,IAAI,CAAC,iBAAiB,CAAC;KAChF,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;QAC/C,OAAO,EAAE,QAAQ;QACjB,0DAA0D;QAC1D,eAAe,EAAE,8BAA8B;QAC/C,WAAW,EAAE,oBAAoB;KAClC;IACD,aAAa,EAAE;QACb,OAAO,EAAE,6BAA6B;QACtC,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,IAAI;QACnB,eAAe,EAAE,GAAG;KACrB;IACD,IAAI,EAAE,mBAAmB;IACzB,iBAAiB,EAAE,gCAAgC;IACnD,UAAU,EAAE,yBAAyB;IACrC,cAAc,EAAE,6BAA6B;IAC7C,8EAA8E;IAC9E,aAAa,EAAE,4BAA4B;IAC3C,mFAAmF;IACnF,mBAAmB,EAAE,kCAAkC;IACvD,8EAA8E;IAC9E,kBAAkB,EAAE,iCAAiC;IACrD,iBAAiB,EAAE,KAAK;CAChB,CAAC"}

package/dist/domain/matching/embedding-provider.d.ts

@@ -5,7 +5,8 @@
  * matching. One ONNX session per instance; share across matchers via a single
  * factory call and coordinated dispose().
  */
-import type { Encoder } from '../types/schemas.js';
+import type { Encoder, EncoderCascadeConfig } from '../types/schemas.js';
+import { type EncoderGateReasonCode } from './encoder-gate.js';
 export declare const EMBEDDING_DIM = 384;
 /** MiniLM ONNX model (384-dim, 512-token context). */
 export declare const MINILM_ONNX_MODEL = "Xenova/all-MiniLM-L6-v2";
@@ -70,4 +71,65 @@ export declare function createOnnxTextEmbedder(artifactCachePath: string, pinOpt
 export declare function createGraniteOnnxTextEmbedder(artifactCachePath: string, pinOptions?: OnnxPinOptions): Promise<TextEmbedder>;
 /** Select ONNX text embedder by operator encoder flag. */
 export declare function createTextEmbedder(encoder: Encoder | undefined, artifactCachePath: string, pinOptions?: OnnxPinOptions): Promise<TextEmbedder>;
+/**
+ * Decision telemetry for the most recent cascade embed. Mirrors the routing
+ * feature-sidecar fields from #173 so the pipeline can copy them onto live
+ * decisions without reshaping (SP-292).
+ */
+export interface CascadeEmbedderTelemetry {
+    /** Encoder that produced the embedding (never mixed across spaces). */
+    readonly encoder_selected: Encoder;
+    /** Gate token estimate for the embedded prompt. */
+    readonly token_estimate: number;
+    /** Configured cascade threshold in effect for the decision. */
+    readonly cascade_threshold: number;
+    /** SP-291 gate reason code (`under_threshold` / `over_threshold` / `granite_fallback`). */
+    readonly reason_code: EncoderGateReasonCode;
+    /**
+     * Present when an over-threshold prompt degraded to the primary encoder
+     * because the long-context session was unavailable (degrade, never mix).
+     */
+    readonly cascade_fallback_reason: EncoderGateReasonCode | null;
+}
+export interface CascadingTextEmbedder extends TextEmbedder {
+    /**
+     * Telemetry from the most recently completed embed(); null before the
+     * first embed. Concurrent embeds race on this snapshot — callers on the
+     * routing hot path embed sequentially per request.
+     */
+    lastTelemetry(): CascadeEmbedderTelemetry | null;
+}
+/** Type guard: does this embedder carry cascade decision telemetry? */
+export declare function isCascadingTextEmbedder(embedder: TextEmbedder): embedder is CascadingTextEmbedder;
+export interface CreateCascadingTextEmbedderOptions {
+    readonly pinOptions?: OnnxPinOptions;
+    /**
+     * Primary encoder for under-threshold / fallback embeds.
+     * Default: DEFAULT_ENCODER ('minilm'), matching `hydra.encoder` defaults.
+     */
+    readonly primaryEncoder?: Encoder;
+    /**
+     * Session factory override for tests. Default: createTextEmbedder bound to
+     * the cascade artifact cache path and pin options.
+     */
+    readonly sessionFactory?: (encoder: Encoder) => Promise<TextEmbedder>;
+}
+/**
+ * Lazy dual-session cascading embedder (SP-292, #173 part 2).
+ *
+ * Owns at most one ONNX session per encoder: the primary session loads on the
+ * first embed, the long-context (Granite) session loads only on the first
+ * over-threshold prompt — memory is paid only when the path fires. Selection
+ * is the SP-291 pure gate; token estimates default to prompt length (the
+ * turn-envelope-parity estimator).
+ *
+ * Failure behavior: degrade, never mix. If the long-context session fails to
+ * load or embed, the request is served by the primary encoder with reason
+ * code `granite_fallback` and the long-context encoder is marked unavailable
+ * for subsequent prompts. Never silently compares cross-encoder vectors.
+ *
+ * dispose() closes every session that was actually loaded (idempotent);
+ * embed() after dispose fails closed (SP-260 precedent).
+ */
+export declare function createCascadingTextEmbedder(config: EncoderCascadeConfig, artifactCachePath: string, options?: CreateCascadingTextEmbedderOptions): CascadingTextEmbedder;
 //# sourceMappingURL=embedding-provider.d.ts.map

package/dist/domain/matching/embedding-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"embedding-provider.d.ts","sourceRoot":"","sources":["../../../src/domain/matching/embedding-provider.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAGnD,eAAO,MAAM,aAAa,MAAM,CAAC;AAEjC,sDAAsD;AACtD,eAAO,MAAM,iBAAiB,4BAA4B,CAAC;AAE3D;;;GAGG;AACH,eAAO,MAAM,kBAAkB,8DAC8B,CAAC;AAE9D,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAC3C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAID;;;;;;;;;GASG;AACH,MAAM,MAAM,mBAAmB,GAAG,KAAK,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE/D,eAAO,MAAM,uBAAuB,EAAE,SAAS,mBAAmB,EAIjE,CAAC;AAEF,+EAA+E;AAC/E,eAAO,MAAM,qBAAqB,mCAAmC,CAAC;AAEtE,6EAA6E;AAC7E,eAAO,MAAM,iBAAiB,+BAA+B,CAAC;AAC9D,eAAO,MAAM,iBAAiB,+BAA+B,CAAC;AAE9D,+EAA+E;AAC/E,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACvD;AAED,MAAM,WAAW,cAAc;IAC7B,kEAAkE;IAClE,QAAQ,CAAC,OAAO,CAAC,EAAE,mBAAmB,CAAC;IACvC,uFAAuF;IACvF,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AA6FD;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,IAAI,CAAC,CAuCf;AA0GD;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CAC1C,iBAAiB,EAAE,MAAM,EACzB,UAAU,CAAC,EAAE,cAAc,GAC1B,OAAO,CAAC,YAAY,CAAC,CAEvB;AAED;;;GAGG;AACH,wBAAsB,6BAA6B,CACjD,iBAAiB,EAAE,MAAM,EACzB,UAAU,CAAC,EAAE,cAAc,GAC1B,OAAO,CAAC,YAAY,CAAC,CAEvB;AAED,0DAA0D;AAC1D,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,OAAO,YAAkB,EAClC,iBAAiB,EAAE,MAAM,EACzB,UAAU,CAAC,EAAE,cAAc,GAC1B,OAAO,CAAC,YAAY,CAAC,CAWvB"}
+{"version":3,"file":"embedding-provider.d.ts","sourceRoot":"","sources":["../../../src/domain/matching/embedding-provider.ts"],"names":[],"mappings":"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"}

package/dist/domain/matching/embedding-provider.js

@@ -9,6 +9,7 @@ import { createHash } from 'node:crypto';
 import { promises as fs } from 'node:fs';
 import path from 'node:path';
 import { DEFAULT_ENCODER } from '../types/schemas.js';
+import { selectEncoderForPrompt, } from './encoder-gate.js';
 export const EMBEDDING_DIM = 384;
 /** MiniLM ONNX model (384-dim, 512-token context). */
 export const MINILM_ONNX_MODEL = 'Xenova/all-MiniLM-L6-v2';
@@ -222,4 +223,120 @@ export async function createTextEmbedder(encoder = DEFAULT_ENCODER, artifactCach
         }
     }
 }
+/** Type guard: does this embedder carry cascade decision telemetry? */
+export function isCascadingTextEmbedder(embedder) {
+    return (typeof embedder.lastTelemetry ===
+        'function');
+}
+/**
+ * Lazy dual-session cascading embedder (SP-292, #173 part 2).
+ *
+ * Owns at most one ONNX session per encoder: the primary session loads on the
+ * first embed, the long-context (Granite) session loads only on the first
+ * over-threshold prompt — memory is paid only when the path fires. Selection
+ * is the SP-291 pure gate; token estimates default to prompt length (the
+ * turn-envelope-parity estimator).
+ *
+ * Failure behavior: degrade, never mix. If the long-context session fails to
+ * load or embed, the request is served by the primary encoder with reason
+ * code `granite_fallback` and the long-context encoder is marked unavailable
+ * for subsequent prompts. Never silently compares cross-encoder vectors.
+ *
+ * dispose() closes every session that was actually loaded (idempotent);
+ * embed() after dispose fails closed (SP-260 precedent).
+ */
+export function createCascadingTextEmbedder(config, artifactCachePath, options) {
+    const primaryEncoder = options?.primaryEncoder ?? DEFAULT_ENCODER;
+    const longContextEncoder = config.long_context_encoder;
+    const factory = options?.sessionFactory ??
+        ((encoder) => createTextEmbedder(encoder, artifactCachePath, options?.pinOptions));
+    const sessions = new Map();
+    let longContextAvailable = true;
+    let disposed = false;
+    let last = null;
+    function sessionFor(encoder) {
+        let pending = sessions.get(encoder);
+        if (pending === undefined) {
+            pending = factory(encoder);
+            sessions.set(encoder, pending);
+            // A rejected session promise must not be cached forever — drop it so a
+            // later retry observes a fresh load attempt.
+            pending.catch(() => sessions.delete(encoder));
+        }
+        return pending;
+    }
+    function telemetry(decision, fallbackReason) {
+        return {
+            encoder_selected: decision.encoder,
+            token_estimate: decision.token_estimate,
+            cascade_threshold: config.token_threshold,
+            reason_code: fallbackReason ?? decision.reason_code,
+            cascade_fallback_reason: fallbackReason,
+        };
+    }
+    return {
+        async embed(text) {
+            if (disposed) {
+                throw new Error('CascadingTextEmbedder has been disposed; embed() fails closed. ' +
+                    'Create a new embedder via createCascadingTextEmbedder to continue.');
+            }
+            const decision = selectEncoderForPrompt(text, config, {
+                primaryEncoder,
+                longContextAvailable,
+            });
+            if (decision.encoder === longContextEncoder && longContextAvailable) {
+                try {
+                    const session = await sessionFor(longContextEncoder);
+                    const vector = await session.embed(text);
+                    last = telemetry(decision, null);
+                    return vector;
+                }
+                catch (error) {
+                    // Degrade, never mix (#173): Granite session/artifacts unavailable →
+                    // serve with the primary encoder and make the fallback explicit.
+                    longContextAvailable = false;
+                    sessions.delete(longContextEncoder);
+                    console.warn('Encoder cascade: long-context encoder unavailable; degrading to primary encoder (granite_fallback)', {
+                        long_context_encoder: longContextEncoder,
+                        primary_encoder: primaryEncoder,
+                        token_estimate: decision.token_estimate,
+                        error: error instanceof Error ? error.message : String(error),
+                    });
+                    const session = await sessionFor(primaryEncoder);
+                    const vector = await session.embed(text);
+                    last = telemetry({ ...decision, encoder: primaryEncoder }, 'granite_fallback');
+                    return vector;
+                }
+            }
+            const session = await sessionFor(primaryEncoder);
+            const vector = await session.embed(text);
+            last = telemetry({ ...decision, encoder: primaryEncoder }, decision.reason_code === 'granite_fallback' ? 'granite_fallback' : null);
+            return vector;
+        },
+        lastTelemetry() {
+            return last;
+        },
+        async dispose() {
+            if (disposed)
+                return; // idempotent: safe for shared-factory callers
+            disposed = true;
+            const pending = [...sessions.values()];
+            sessions.clear();
+            const failures = [];
+            for (const sessionPromise of pending) {
+                try {
+                    const session = await sessionPromise;
+                    await session.dispose();
+                }
+                catch (error) {
+                    failures.push(error instanceof Error ? error.message : String(error));
+                }
+            }
+            // Fail loud: partially released cascade sessions must not pass silently.
+            if (failures.length > 0) {
+                throw new Error(`CascadingTextEmbedder dispose failed for ${failures.length} session(s): ${failures.join('; ')}`);
+            }
+        },
+    };
+}
 //# sourceMappingURL=embedding-provider.js.map

package/dist/domain/matching/embedding-provider.js.map

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

package/dist/domain/matching/encoder-gate.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Encoder cascade gate (SP-291, #173 part 1) — pure domain, unit-testable.
+ *
+ * Opt-in per-prompt encoder selection: when `hydra.encoder_cascade.enabled`
+ * is true, prompts whose estimated token count reaches `token_threshold` are
+ * routed to the long-context encoder (Granite 97M, SP-156) instead of the
+ * primary `hydra.encoder` (MiniLM, 512-token window). Default off: existing
+ * single-encoder installs are unaffected and pay zero added cost — the gate
+ * is pre-embedding arithmetic only.
+ *
+ * Token estimate parity: this module reuses the same estimator as the
+ * turn-envelope stage (`src/domain/pipeline/turn-envelope-stage.ts`):
+ * `estimated_input_tokens ?? prompt_text.length`. Callers pass
+ * `RoutingRequest.estimated_input_tokens` via options when present; the
+ * fallback is the prompt's character length.
+ *
+ * Hard constraint (#173): encoders embed into different vector spaces — the
+ * gate only SELECTS an encoder; per-encoder artifacts (centroids, learned
+ * projection) and the cascading embedder land in SP-292. Never mix spaces.
+ */
+import type { Encoder, EncoderCascadeConfig } from '../types/schemas.js';
+/** Gate outcomes per #173; attached to decision telemetry. */
+export type EncoderGateReasonCode = 
+/** Cascade disabled — every prompt uses the primary encoder. */
+'cascade_disabled'
+/** Estimate below the configured threshold — primary encoder. */
+ | 'under_threshold'
+/** Estimate at/over the threshold — long-context encoder selected. */
+ | 'over_threshold'
+/**
+ * Over threshold but the long-context encoder is unavailable — degrade to
+ * the primary encoder (continuity of routing wins; never mix vector spaces).
+ */
+ | 'granite_fallback';
+export interface EncoderGateDecision {
+    readonly encoder: Encoder;
+    readonly reason_code: EncoderGateReasonCode;
+    readonly token_estimate: number;
+}
+export interface EncoderGateOptions {
+    /**
+     * Precomputed token estimate — pass `RoutingRequest.estimated_input_tokens`
+     * when set. Falls back to `prompt.length`, exactly mirroring the
+     * turn-envelope stage estimator (`estimated_input_tokens ?? prompt_text.length`).
+     */
+    readonly estimatedTokens?: number | undefined;
+    /**
+     * Primary encoder used when the cascade is disabled or does not fire.
+     * Default: DEFAULT_ENCODER ('minilm'), matching `hydra.encoder` defaults.
+     */
+    readonly primaryEncoder?: Encoder | undefined;
+    /**
+     * Long-context encoder availability signal (SP-292 embedder layer owns
+     * session/artifact health). When explicitly false, an over-threshold prompt
+     * degrades to the primary encoder with reason `granite_fallback`.
+     * Default: assumed available.
+     */
+    readonly longContextAvailable?: boolean;
+}
+/**
+ * Turn-envelope-parity token estimator: a caller-supplied estimate wins;
+ * otherwise the prompt's character length is the proxy (same formula as
+ * `turn-envelope-stage.ts` step 2b breakeven arithmetic).
+ */
+export declare function estimatePromptTokens(prompt: string, estimatedTokens?: number): number;
+/**
+ * Select the encoder for a prompt. Pure: no I/O, no ONNX sessions.
+ *
+ * Boundary semantics (per #173 eval table): `token_estimate >= token_threshold`
+ * routes to the long-context encoder; strictly below stays on the primary.
+ */
+export declare function selectEncoderForPrompt(prompt: string, config: EncoderCascadeConfig, options?: EncoderGateOptions): EncoderGateDecision;
+//# sourceMappingURL=encoder-gate.d.ts.map

package/dist/domain/matching/encoder-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoder-gate.d.ts","sourceRoot":"","sources":["../../../src/domain/matching/encoder-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAGzE,8DAA8D;AAC9D,MAAM,MAAM,qBAAqB;AAC/B,gEAAgE;AAC9D,kBAAkB;AACpB,iEAAiE;GAC/D,iBAAiB;AACnB,sEAAsE;GACpE,gBAAgB;AAClB;;;GAGG;GACD,kBAAkB,CAAC;AAEvB,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,qBAAqB,CAAC;IAC5C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9C;;;OAGG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9C;;;;;OAKG;IACH,QAAQ,CAAC,oBAAoB,CAAC,EAAE,OAAO,CAAC;CACzC;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,eAAe,CAAC,EAAE,MAAM,GACvB,MAAM,CAER;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,oBAAoB,EAC5B,OAAO,CAAC,EAAE,kBAAkB,GAC3B,mBAAmB,CAiCrB"}

package/dist/domain/matching/encoder-gate.js

@@ -0,0 +1,66 @@
+/**
+ * Encoder cascade gate (SP-291, #173 part 1) — pure domain, unit-testable.
+ *
+ * Opt-in per-prompt encoder selection: when `hydra.encoder_cascade.enabled`
+ * is true, prompts whose estimated token count reaches `token_threshold` are
+ * routed to the long-context encoder (Granite 97M, SP-156) instead of the
+ * primary `hydra.encoder` (MiniLM, 512-token window). Default off: existing
+ * single-encoder installs are unaffected and pay zero added cost — the gate
+ * is pre-embedding arithmetic only.
+ *
+ * Token estimate parity: this module reuses the same estimator as the
+ * turn-envelope stage (`src/domain/pipeline/turn-envelope-stage.ts`):
+ * `estimated_input_tokens ?? prompt_text.length`. Callers pass
+ * `RoutingRequest.estimated_input_tokens` via options when present; the
+ * fallback is the prompt's character length.
+ *
+ * Hard constraint (#173): encoders embed into different vector spaces — the
+ * gate only SELECTS an encoder; per-encoder artifacts (centroids, learned
+ * projection) and the cascading embedder land in SP-292. Never mix spaces.
+ */
+import { DEFAULT_ENCODER } from '../types/schemas.js';
+/**
+ * Turn-envelope-parity token estimator: a caller-supplied estimate wins;
+ * otherwise the prompt's character length is the proxy (same formula as
+ * `turn-envelope-stage.ts` step 2b breakeven arithmetic).
+ */
+export function estimatePromptTokens(prompt, estimatedTokens) {
+    return estimatedTokens ?? prompt.length;
+}
+/**
+ * Select the encoder for a prompt. Pure: no I/O, no ONNX sessions.
+ *
+ * Boundary semantics (per #173 eval table): `token_estimate >= token_threshold`
+ * routes to the long-context encoder; strictly below stays on the primary.
+ */
+export function selectEncoderForPrompt(prompt, config, options) {
+    const primary = options?.primaryEncoder ?? DEFAULT_ENCODER;
+    const tokenEstimate = estimatePromptTokens(prompt, options?.estimatedTokens);
+    if (!config.enabled) {
+        return {
+            encoder: primary,
+            reason_code: 'cascade_disabled',
+            token_estimate: tokenEstimate,
+        };
+    }
+    if (tokenEstimate < config.token_threshold) {
+        return {
+            encoder: primary,
+            reason_code: 'under_threshold',
+            token_estimate: tokenEstimate,
+        };
+    }
+    if (options?.longContextAvailable === false) {
+        return {
+            encoder: primary,
+            reason_code: 'granite_fallback',
+            token_estimate: tokenEstimate,
+        };
+    }
+    return {
+        encoder: config.long_context_encoder,
+        reason_code: 'over_threshold',
+        token_estimate: tokenEstimate,
+    };
+}
+//# sourceMappingURL=encoder-gate.js.map

package/dist/domain/matching/encoder-gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoder-gate.js","sourceRoot":"","sources":["../../../src/domain/matching/encoder-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AA2CtD;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAClC,MAAc,EACd,eAAwB;IAExB,OAAO,eAAe,IAAI,MAAM,CAAC,MAAM,CAAC;AAC1C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CACpC,MAAc,EACd,MAA4B,EAC5B,OAA4B;IAE5B,MAAM,OAAO,GAAG,OAAO,EAAE,cAAc,IAAI,eAAe,CAAC;IAC3D,MAAM,aAAa,GAAG,oBAAoB,CAAC,MAAM,EAAE,OAAO,EAAE,eAAe,CAAC,CAAC;IAE7E,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO;YACL,OAAO,EAAE,OAAO;YAChB,WAAW,EAAE,kBAAkB;YAC/B,cAAc,EAAE,aAAa;SAC9B,CAAC;IACJ,CAAC;IAED,IAAI,aAAa,GAAG,MAAM,CAAC,eAAe,EAAE,CAAC;QAC3C,OAAO;YACL,OAAO,EAAE,OAAO;YAChB,WAAW,EAAE,iBAAiB;YAC9B,cAAc,EAAE,aAAa;SAC9B,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,EAAE,oBAAoB,KAAK,KAAK,EAAE,CAAC;QAC5C,OAAO;YACL,OAAO,EAAE,OAAO;YAChB,WAAW,EAAE,kBAAkB;YAC/B,cAAc,EAAE,aAAa;SAC9B,CAAC;IACJ,CAAC;IAED,OAAO;QACL,OAAO,EAAE,MAAM,CAAC,oBAAoB;QACpC,WAAW,EAAE,gBAAgB;QAC7B,cAAc,EAAE,aAAa;KAC9B,CAAC;AACJ,CAAC"}

package/dist/domain/matching/hydra-matcher.d.ts

@@ -11,9 +11,9 @@
  * Budget: 80–120 ms (configurable, default 100 ms).
  */
 import { z } from 'zod';
-import { EMBEDDING_DIM, type TextEmbedder } from './embedding-provider.js';
+import { EMBEDDING_DIM, type CascadeEmbedderTelemetry, type TextEmbedder } from './embedding-provider.js';
 import { type K4CapabilityVector, type ModernBertHeadsPredictor } from './modernbert-heads.js';
-import type { Encoder, HydraConfig, HydraHeads } from '../types/schemas.js';
+import type { Encoder, EncoderCascadeConfig, HydraConfig, HydraHeads } from '../types/schemas.js';
 import { type FrugalityWeights } from '../scoring/multi-objective.js';
 import type { CandidateScore, ModelProfile, RoutingRequest } from '../types/index.js';
 export interface RequirementVector {
@@ -39,6 +39,12 @@ export interface EmbeddingProvider {
      * Absent/empty when learned weights are active.
      */
     requirementReasonCodes?(): readonly string[];
+    /**
+     * Cascade decision telemetry from the most recent extraction (SP-292, #173).
+     * Present only on cascading-embedder-backed providers; null before the first
+     * embed. Absent on single-encoder and ModernBERT K=4 providers.
+     */
+    cascadeTelemetry?(): CascadeEmbedderTelemetry | null;
     dispose(): Promise<void>;
 }
 export interface MatchResult {
@@ -61,6 +67,13 @@ export interface MatchResult {
      * always populates it.
      */
     readonly requirement_reason_codes?: readonly string[];
+    /**
+     * Encoder cascade decision telemetry for this match (SP-292, #173):
+     * `encoder_selected`, `token_estimate`, `cascade_threshold`, and the
+     * fallback reason when an over-threshold prompt degraded to the primary
+     * encoder. Absent on legacy call paths and non-cascade providers.
+     */
+    readonly cascade_telemetry?: CascadeEmbedderTelemetry | null;
     readonly elapsedMs: number;
     readonly budgetExceeded: boolean;
 }
@@ -183,6 +196,14 @@ export declare class HydraMatcher {
 export interface CreateOnnxEmbeddingProviderOptions {
     readonly encoder?: Encoder;
     readonly projectionWeightsPath?: string;
+    /**
+     * Opt-in encoder cascade (SP-292, #173). When enabled, the provider is
+     * backed by a lazy dual-session cascading embedder that routes
+     * over-threshold prompts to the long-context encoder and degrades to the
+     * primary encoder with an explicit fallback reason when unavailable.
+     * Default: disabled (single-encoder path unchanged).
+     */
+    readonly encoderCascade?: EncoderCascadeConfig;
 }
 export interface CreateHydraEmbeddingProviderOptions extends CreateOnnxEmbeddingProviderOptions {
     readonly hydraHeads?: HydraHeads;
@@ -203,5 +224,5 @@ export declare function createHydraEmbeddingProvider(artifactCachePath: string,
 /**
  * Bootstrap HyDRA matcher from operator hydra config (encoder, heads, artifact path).
  */
-export declare function createHydraMatcherFromHydraConfig(hydraConfig: Pick<HydraConfig, 'artifact_cache_path'> & Partial<Pick<HydraConfig, 'encoder' | 'hydra_heads'>>, options?: Omit<HydraMatcherConfig, 'artifactCachePath' | 'encoder' | 'hydraHeads'>): Promise<HydraMatcher>;
+export declare function createHydraMatcherFromHydraConfig(hydraConfig: Pick<HydraConfig, 'artifact_cache_path'> & Partial<Pick<HydraConfig, 'encoder' | 'hydra_heads' | 'encoder_cascade'>>, options?: Omit<HydraMatcherConfig, 'artifactCachePath' | 'encoder' | 'hydraHeads'>): Promise<HydraMatcher>;
 //# sourceMappingURL=hydra-matcher.d.ts.map