dsh-autotier 0.1.0 → 0.1.1

package/CHANGELOG.md

@@ -5,6 +5,32 @@ All notable changes to this project are documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.1.1] - 2026-09-09
+
+### Added
+
+- **Route pre-flight against the live registry.** Before a tier landing is
+  written into the request configuration, the plugin now checks the two facts
+  that would fail the request outright: the provider route must be registered,
+  and the target model must declare the configured reasoning effort. An
+  unregistered provider redirects to a registered fallback chain entry; an
+  unsupported effort is dropped so the adapter default applies; an adapter that
+  cannot answer is treated leniently. Both answers are cached per
+  `provider/model`, and each degradation is logged once.
+- Compat workflow now runs its profile job over a matrix of both published
+  harness lines (`0.1.2-rc.1` and `0.1.5-alpha.1`), so drift in either is caught
+  automatically.
+
+### Changed
+
+- Peer ranges name both published lines explicitly
+  (`>=0.1.2-rc.1 <0.2.0 || >=0.1.5-alpha.1 <0.2.0`): a semver range whose only
+  prerelease comparator sits on an earlier version tuple does not admit a later
+  alpha, so the previous range left `0.1.5-alpha.1` unsatisfied.
+- `dsh.compatibility.dshReleases` and the five READMEs now declare
+  `0.1.5-alpha.1` compatible after an end-to-end verification (real profile
+  install, `--dump-config` row, keyless headless smoke).
+
 ## [0.1.0] - 2026-09-09
 
 ### Added

package/README.es.md

@@ -19,10 +19,14 @@ strong con un TTL de retorno.
 
 | Harness | Estado |
 |---|---|
-| `@deepseek-ai/dsh` `0.1.2-rc.1` | compatible (es lo que CI verifica y lo que instala el flujo compat) |
-| `0.1.5-alpha.1` (la línea actual del checkout) | verificado por tipos contra sus caras publicadas; el smoke de extremo a extremo corre en `0.1.2-rc.1` |
+| `@deepseek-ai/dsh` `0.1.2-rc.1` | compatible; el flujo compat instala esta línea de extremo a extremo |
+| `@deepseek-ai/dsh` `0.1.5-alpha.1` | compatible; verificada de extremo a extremo (perfil real, fila en `--dump-config`, smoke keyless) y en la matriz compat |
 | `@deepseek-ai/cordis` `^4.0.2`, `@deepseek-ai/schemastery` `^3.18.2` | base de peers |
 
+Los rangos de peers nombran ambas líneas publicadas (`>=0.1.2-rc.1 <0.2.0 ||
+>=0.1.5-alpha.1 <0.2.0`), porque un rango cuyo único comparador de prerelease
+está en una tupla anterior no admite un alpha posterior. Se refrescan por ola.
+
 El plugin vive solo en el plano host y no necesita un preset propio: la fila host
 se aplica a todas las sesiones. Una sección de prompt en *tu* preset es opcional
 y solo hace visibles las decisiones al modelo (véase [Instalación y desinstalación](#instalación-y-desinstalación)).

package/README.hi.md

@@ -17,10 +17,15 @@ DeepSeek Harness के लिए स्वचालित मॉडल-स्
 
 | Harness | स्थिति |
 |---|---|
-| `@deepseek-ai/dsh` `0.1.2-rc.1` | संगत (CI इसी की जाँच करता है और compat वर्कफ़्लो इसे इंस्टॉल करता है) |
-| `0.1.5-alpha.1` (वर्तमान checkout लाइन) | इसके प्रकाशित type faces के विरुद्ध टाइप-जाँच; end-to-end smoke `0.1.2-rc.1` पर चलता है |
+| `@deepseek-ai/dsh` `0.1.2-rc.1` | संगत; compat वर्कफ़्लो इस लाइन को end-to-end इंस्टॉल करता है |
+| `@deepseek-ai/dsh` `0.1.5-alpha.1` | संगत; end-to-end सत्यापित (वास्तविक profile, `--dump-config` पंक्ति, keyless smoke) और compat मैट्रिक्स में |
 | `@deepseek-ai/cordis` `^4.0.2`, `@deepseek-ai/schemastery` `^3.18.2` | peer आधार |
 
+peer ranges दोनों प्रकाशित लाइनें स्पष्ट रूप से लिखती हैं (`>=0.1.2-rc.1 <0.2.0
+|| >=0.1.5-alpha.1 <0.2.0`), क्योंकि जिस range का एकमात्र prerelease comparator
+पुराने tuple पर हो वह बाद के alpha को स्वीकार नहीं करता। हर प्रकाशन-लहर पर
+रिफ़्रेश होता है।
+
 यह प्लगइन केवल host plane पर रहता है और अपना preset नहीं माँगता: host पंक्ति
 हर सत्र पर लागू होती है। *आपके* preset में एक प्रॉम्प्ट खंड वैकल्पिक है और
 केवल मॉडल को निर्णय दिखाता है ([इंस्टॉल और अनइंस्टॉल](#इंस्टॉल-और-अनइंस्टॉल) देखें)।

package/README.md

@@ -17,10 +17,15 @@ escalate to the strong tier with a TTL fallback.
 
 | Harness | Status |
 |---|---|
-| `@deepseek-ai/dsh` `0.1.2-rc.1` | compatible (this is what CI type-checks and the compat workflow installs) |
-| `0.1.5-alpha.1` (the current harness checkout line) | type-checked against its published type faces; the end-to-end smoke runs on `0.1.2-rc.1` |
+| `@deepseek-ai/dsh` `0.1.2-rc.1` | compatible; the compat workflow installs this line end-to-end |
+| `@deepseek-ai/dsh` `0.1.5-alpha.1` | compatible; verified end-to-end (real profile install, `--dump-config` row, keyless headless smoke) and in the compat matrix |
 | `@deepseek-ai/cordis` `^4.0.2`, `@deepseek-ai/schemastery` `^3.18.2` | peer baseline |
 
+Peer ranges name both published lines explicitly (`>=0.1.2-rc.1 <0.2.0 ||
+>=0.1.5-alpha.1 <0.2.0`), because a semver range whose only prerelease
+comparator sits on an earlier version tuple does not admit a later alpha.
+They are refreshed per published wave.
+
 The plugin is host-plane only. It needs no agent preset of its own: the host
 row applies to every session. A one-line prompt section in *your* preset is
 optional and only makes the router's decisions visible to the model (see

package/README.pt.md

@@ -18,10 +18,14 @@ retorno.
 
 | Harness | Estado |
 |---|---|
-| `@deepseek-ai/dsh` `0.1.2-rc.1` | compatível (é o que a CI verifica e o que o fluxo compat instala) |
-| `0.1.5-alpha.1` (a linha atual do checkout) | verificado por tipos contra suas faces publicadas; o smoke ponta a ponta roda em `0.1.2-rc.1` |
+| `@deepseek-ai/dsh` `0.1.2-rc.1` | compatível; o fluxo compat instala esta linha ponta a ponta |
+| `@deepseek-ai/dsh` `0.1.5-alpha.1` | compatível; verificada ponta a ponta (perfil real, linha no `--dump-config`, smoke keyless) e na matriz compat |
 | `@deepseek-ai/cordis` `^4.0.2`, `@deepseek-ai/schemastery` `^3.18.2` | base de peers |
 
+Os ranges de peers nomeiam as duas linhas publicadas (`>=0.1.2-rc.1 <0.2.0 ||
+>=0.1.5-alpha.1 <0.2.0`), porque um range cujo único comparador de prerelease
+está numa tupla anterior não admite um alpha posterior. São atualizados por onda.
+
 O plugin vive apenas no plano host e não precisa de preset próprio: a linha host
 vale para todas as sessões. Uma seção de prompt no *seu* preset é opcional e
 apenas torna as decisões visíveis ao modelo (veja [Instalação e desinstalação](#instalação-e-desinstalação)).

package/README.zh.md

@@ -14,10 +14,14 @@ DeepSeek Harness 的自动模型分档路由：一条用户指令进来，一个
 
 | Harness | 状态 |
 |---|---|
-| `@deepseek-ai/dsh` `0.1.2-rc.1` | 兼容（CI 的类型检查与 compat 工作流安装的就是它） |
-| `0.1.5-alpha.1`（当前宿主 checkout 线） | 对照其已发布类型面做类型检查；端到端冒烟跑在 `0.1.2-rc.1` 上 |
+| `@deepseek-ai/dsh` `0.1.2-rc.1` | 兼容；compat 工作流对该线做端到端安装验证 |
+| `@deepseek-ai/dsh` `0.1.5-alpha.1` | 兼容；已端到端实测（真实 profile 安装、`--dump-config` 行、keyless headless 冒烟）并纳入 compat 矩阵 |
 | `@deepseek-ai/cordis` `^4.0.2`、`@deepseek-ai/schemastery` `^3.18.2` | peer 基线 |
 
+peer 范围显式列出两条已发布线（`>=0.1.2-rc.1 <0.2.0 || >=0.1.5-alpha.1
+<0.2.0`）——因为仅含较早版本元组预发布比较符的 semver 范围无法接纳更晚的 alpha；
+每次发布波同步刷新。
+
 本插件只驻留 host 平面，不需要自带 agent preset：host 行对所有会话生效。
 在你的 preset 中加一段提示是可选项，仅用于让模型看见路由决策
 （见[安装与卸载](#安装与卸载)）。

package/lib/index.js

@@ -2078,6 +2078,82 @@ async function runJudge(ctx, config, text, signal) {
 	};
 }
 //#endregion
+//#region src/preflight.ts
+/**
+* Pre-flight cache and checker for one plugin instance. The cache is per
+* process and never invalidated: adapter registrations are composition-level
+* facts, and a reload rebuilds the plugin (and this cache) with them.
+*/
+var RoutePreflight = class {
+	ctx;
+	onDegrade;
+	capabilities = /* @__PURE__ */ new Map();
+	degraded = /* @__PURE__ */ new Set();
+	/** @param options - the plugin context and the degrade reporter. */
+	constructor(options) {
+		this.ctx = options.ctx;
+		this.onDegrade = options.onDegrade;
+	}
+	/** One cached capability lookup; a failing adapter is treated as lenient. */
+	capability(provider, model) {
+		const key = `${provider}/${model}`;
+		let pending = this.capabilities.get(key);
+		if (pending === void 0) {
+			pending = this.ctx.llm.listProviders().some((entry) => entry.id === provider) ? this.ctx.llm.resolveModelInfo(provider, model).then((info) => ({
+				registered: true,
+				efforts: info.reasoning === void 0 ? void 0 : new Set(info.reasoning.efforts.map((effort) => String(effort.id)))
+			}), () => ({
+				registered: true,
+				efforts: void 0
+			})) : Promise.resolve({
+				registered: false,
+				efforts: void 0
+			});
+			this.capabilities.set(key, pending);
+		}
+		return pending;
+	}
+	/** Report one degradation at most once per key. */
+	degrade(key, note) {
+		if (this.degraded.has(key)) return;
+		this.degraded.add(key);
+		this.onDegrade(key, note);
+	}
+	/**
+	* Make one tier landing safe to apply.
+	* @param route - the landing the policy produced.
+	* @param tier - the tier configuration, for its fallback chain.
+	* @returns a landing that will not fail the request on provider/effort facts.
+	*/
+	async sanitize(route, tier) {
+		const capability = await this.capability(route.provider, route.model);
+		let safe = route;
+		if (!capability.registered) {
+			const entry = tier.fallback.find((candidate) => this.ctx.llm.listProviders().some((p) => p.id === candidate.provider));
+			if (entry !== void 0) {
+				this.degrade(`provider:${route.provider}`, `provider "${route.provider}" is not registered; using fallback "${entry.provider}/${entry.model}"`);
+				safe = tier.followSession ? {
+					provider: entry.provider,
+					model: entry.model
+				} : {
+					provider: entry.provider,
+					model: entry.model,
+					effort: tier.effort
+				};
+			} else this.degrade(`provider:${route.provider}`, `provider "${route.provider}" is not registered and the tier has no usable fallback`);
+		}
+		const effort = safe.effort;
+		if (effort !== void 0 && capability.efforts !== void 0 && !capability.efforts.has(effort)) {
+			this.degrade(`effort:${route.provider}/${route.model}`, `model "${route.model}" does not accept reasoning effort "${effort}"; the adapter default applies`);
+			safe = {
+				provider: safe.provider,
+				model: safe.model
+			};
+		}
+		return safe;
+	}
+};
+//#endregion
 //#region src/routing.ts
 /** How long third parties have to veto a proposed tier before the turn proceeds. */
 const VETO_TIMEOUT_MS = 250;
@@ -2106,6 +2182,7 @@ var AutotierRouter = class {
 	counters = /* @__PURE__ */ new WeakMap();
 	/** Router-owned lifetime signal: aborts in-flight judge calls on unload. */
 	lifetime = new AbortController();
+	preflight;
 	disposed = false;
 	/**
 	* Register every listener on the plugin fiber.
@@ -2115,6 +2192,10 @@ var AutotierRouter = class {
 		this.ctx = options.ctx;
 		this.service = options.service;
 		this.states = options.states;
+		this.preflight = new RoutePreflight({
+			ctx: this.ctx,
+			onDegrade: (_key, note) => this.ctx.logger.warn("dsh-autotier: %s", note)
+		});
 		this.ctx.on("agent/inbox/inserted", (payload) => this.onInboxInserted(payload.agent, payload.message), { prepend: true });
 		this.ctx.on("agent/request", (payload, next) => this.onRequest(payload.agent, payload.turn, payload.step, next), { prepend: true });
 		this.ctx.on("agent/error", (payload) => this.onAgentError(payload.agent, payload.error));
@@ -2377,7 +2458,7 @@ var AutotierRouter = class {
 		const source = veto === void 0 || veto === null ? decision.source : "manual";
 		const reason = veto === void 0 || veto === null ? decision.reason : `veto: ${veto.reason}`;
 		const route = this.routeFor(tier, config, intent, state, now, base);
-		const applied = resolveRoute(base, route);
+		const applied = resolveRoute(base, await this.preflight.sanitize(route, tier === "strong" ? config.tiers.strong : config.tiers.cheap));
 		if (state.appliedTier !== tier) {
 			const from = state.appliedTier;
 			state.appliedTier = tier;

package/lib/types/preflight.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Request-time route pre-flight: before a tier landing is written into the
+ * request configuration, check the two facts that would make the request fail
+ * outright — is the provider route registered, and does the target model accept
+ * the configured reasoning effort?
+ *
+ * Both answers come from the live `ctx.llm` registry and are cached per
+ * `provider/model`, so the common case costs one Map lookup. A route that fails
+ * pre-flight degrades instead of failing the turn: an unregistered provider
+ * falls back to a registered chain entry, and an unsupported effort is omitted
+ * (the adapter default then applies). Each degradation is logged once per key.
+ *
+ * @module dsh-autotier/preflight
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import type { ResolvedTierConfig } from './config.js';
+import type { TierRoute } from './types.js';
+/** Options for {@link RoutePreflight}. */
+export interface RoutePreflightOptions {
+    readonly ctx: Context;
+    /** Called once per degraded route key; the caller owns the log level. */
+    readonly onDegrade: (key: string, note: string) => void;
+}
+/**
+ * Pre-flight cache and checker for one plugin instance. The cache is per
+ * process and never invalidated: adapter registrations are composition-level
+ * facts, and a reload rebuilds the plugin (and this cache) with them.
+ */
+export declare class RoutePreflight {
+    private readonly ctx;
+    private readonly onDegrade;
+    private readonly capabilities;
+    private readonly degraded;
+    /** @param options - the plugin context and the degrade reporter. */
+    constructor(options: RoutePreflightOptions);
+    /** One cached capability lookup; a failing adapter is treated as lenient. */
+    private capability;
+    /** Report one degradation at most once per key. */
+    private degrade;
+    /**
+     * Make one tier landing safe to apply.
+     * @param route - the landing the policy produced.
+     * @param tier - the tier configuration, for its fallback chain.
+     * @returns a landing that will not fail the request on provider/effort facts.
+     */
+    sanitize(route: TierRoute, tier: ResolvedTierConfig): Promise<TierRoute>;
+}
+//# sourceMappingURL=preflight.d.ts.map

package/lib/types/preflight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflight.d.ts","sourceRoot":"","sources":["../../src/preflight.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAK3C,0CAA0C;AAC1C,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAA;IACrB,yEAAyE;IACzE,QAAQ,CAAC,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CACxD;AAED;;;;GAIG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqC;IAC/D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAyC;IACtE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoB;IAE7C,oEAAoE;gBACxD,OAAO,EAAE,qBAAqB;IAK1C,6EAA6E;IAC7E,OAAO,CAAC,UAAU;IAiBlB,mDAAmD;IACnD,OAAO,CAAC,OAAO;IAMf;;;;;OAKG;IACG,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,SAAS,CAAC;CA2B/E"}

package/lib/types/routing.d.ts

@@ -71,6 +71,7 @@ export declare class AutotierRouter {
     private readonly counters;
     /** Router-owned lifetime signal: aborts in-flight judge calls on unload. */
     private readonly lifetime;
+    private readonly preflight;
     private disposed;
     /**
      * Register every listener on the plugin fiber.

package/lib/types/routing.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-autotier",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Automatic strong/cheap model-tier routing for DeepSeek Harness: intent-gated tier landing on the agent/request waterfall, plan-mode handoff (strong plans, cheap implements), deterministic high-risk guards on tools/pre-execute, failure escalation with TTL fallback, a /tier command, and tier status tools",
   "repository": {
     "type": "git",
@@ -44,7 +44,8 @@
     },
     "compatibility": {
       "dshReleases": {
-        "0.1.2-rc.1": "compatible"
+        "0.1.2-rc.1": "compatible",
+        "0.1.5-alpha.1": "compatible"
       }
     }
   },
@@ -104,14 +105,14 @@
   "packageManager": "pnpm@11.7.0",
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-agent": ">=0.1.2-rc.1 <0.2.0",
-    "@deepseek-ai/dsh-commands": ">=0.1.2-rc.1 <0.2.0",
-    "@deepseek-ai/dsh-llm": ">=0.1.2-rc.1 <0.2.0",
-    "@deepseek-ai/dsh-plan-mode": ">=0.1.2-rc.1 <0.2.0",
-    "@deepseek-ai/dsh-session": ">=0.1.2-rc.1 <0.2.0",
-    "@deepseek-ai/dsh-session-projection": ">=0.1.2-rc.1 <0.2.0",
-    "@deepseek-ai/dsh-settings": ">=0.1.2-rc.1 <0.2.0",
-    "@deepseek-ai/dsh-tools": ">=0.1.2-rc.1 <0.2.0",
+    "@deepseek-ai/dsh-agent": ">=0.1.2-rc.1 <0.2.0 || >=0.1.5-alpha.1 <0.2.0",
+    "@deepseek-ai/dsh-commands": ">=0.1.2-rc.1 <0.2.0 || >=0.1.5-alpha.1 <0.2.0",
+    "@deepseek-ai/dsh-llm": ">=0.1.2-rc.1 <0.2.0 || >=0.1.5-alpha.1 <0.2.0",
+    "@deepseek-ai/dsh-plan-mode": ">=0.1.2-rc.1 <0.2.0 || >=0.1.5-alpha.1 <0.2.0",
+    "@deepseek-ai/dsh-session": ">=0.1.2-rc.1 <0.2.0 || >=0.1.5-alpha.1 <0.2.0",
+    "@deepseek-ai/dsh-session-projection": ">=0.1.2-rc.1 <0.2.0 || >=0.1.5-alpha.1 <0.2.0",
+    "@deepseek-ai/dsh-settings": ">=0.1.2-rc.1 <0.2.0 || >=0.1.5-alpha.1 <0.2.0",
+    "@deepseek-ai/dsh-tools": ">=0.1.2-rc.1 <0.2.0 || >=0.1.5-alpha.1 <0.2.0",
     "@deepseek-ai/schemastery": "^3.18.2"
   },
   "peerDependenciesMeta": {

package/src/preflight.ts

@@ -0,0 +1,105 @@
+/**
+ * Request-time route pre-flight: before a tier landing is written into the
+ * request configuration, check the two facts that would make the request fail
+ * outright — is the provider route registered, and does the target model accept
+ * the configured reasoning effort?
+ *
+ * Both answers come from the live `ctx.llm` registry and are cached per
+ * `provider/model`, so the common case costs one Map lookup. A route that fails
+ * pre-flight degrades instead of failing the turn: an unregistered provider
+ * falls back to a registered chain entry, and an unsupported effort is omitted
+ * (the adapter default then applies). Each degradation is logged once per key.
+ *
+ * @module dsh-autotier/preflight
+ */
+
+import type { Context } from '@deepseek-ai/cordis'
+import type { ResolvedTierConfig } from './config.ts'
+import type { TierRoute } from './types.ts'
+
+/** One cached model capability answer. */
+type Capability = { readonly registered: boolean; readonly efforts: ReadonlySet<string> | undefined }
+
+/** Options for {@link RoutePreflight}. */
+export interface RoutePreflightOptions {
+  readonly ctx: Context
+  /** Called once per degraded route key; the caller owns the log level. */
+  readonly onDegrade: (key: string, note: string) => void
+}
+
+/**
+ * Pre-flight cache and checker for one plugin instance. The cache is per
+ * process and never invalidated: adapter registrations are composition-level
+ * facts, and a reload rebuilds the plugin (and this cache) with them.
+ */
+export class RoutePreflight {
+  private readonly ctx: Context
+  private readonly onDegrade: (key: string, note: string) => void
+  private readonly capabilities = new Map<string, Promise<Capability>>()
+  private readonly degraded = new Set<string>()
+
+  /** @param options - the plugin context and the degrade reporter. */
+  constructor(options: RoutePreflightOptions) {
+    this.ctx = options.ctx
+    this.onDegrade = options.onDegrade
+  }
+
+  /** One cached capability lookup; a failing adapter is treated as lenient. */
+  private capability(provider: string, model: string): Promise<Capability> {
+    const key = `${provider}/${model}`
+    let pending = this.capabilities.get(key)
+    if (pending === undefined) {
+      const providers = this.ctx.llm.listProviders()
+      const registered = providers.some(entry => entry.id === provider)
+      pending = registered
+        ? this.ctx.llm.resolveModelInfo(provider, model).then(
+          info => ({ registered: true, efforts: info.reasoning === undefined ? undefined : new Set(info.reasoning.efforts.map(effort => String(effort.id))) }),
+          () => ({ registered: true, efforts: undefined }),
+        )
+        : Promise.resolve({ registered: false, efforts: undefined })
+      this.capabilities.set(key, pending)
+    }
+    return pending
+  }
+
+  /** Report one degradation at most once per key. */
+  private degrade(key: string, note: string): void {
+    if (this.degraded.has(key)) return
+    this.degraded.add(key)
+    this.onDegrade(key, note)
+  }
+
+  /**
+   * Make one tier landing safe to apply.
+   * @param route - the landing the policy produced.
+   * @param tier - the tier configuration, for its fallback chain.
+   * @returns a landing that will not fail the request on provider/effort facts.
+   */
+  async sanitize(route: TierRoute, tier: ResolvedTierConfig): Promise<TierRoute> {
+    const capability = await this.capability(route.provider, route.model)
+    let safe = route
+    if (!capability.registered) {
+      const entry = tier.fallback.find(candidate => this.ctx.llm.listProviders().some(p => p.id === candidate.provider))
+      if (entry !== undefined) {
+        this.degrade(
+          `provider:${route.provider}`,
+          `provider "${route.provider}" is not registered; using fallback "${entry.provider}/${entry.model}"`,
+        )
+        safe = tier.followSession
+          ? { provider: entry.provider, model: entry.model }
+          : { provider: entry.provider, model: entry.model, effort: tier.effort }
+      } else {
+        this.degrade(`provider:${route.provider}`, `provider "${route.provider}" is not registered and the tier has no usable fallback`)
+      }
+    }
+    const effort = safe.effort
+    if (effort !== undefined && capability.efforts !== undefined && !capability.efforts.has(effort)) {
+      this.degrade(
+        `effort:${route.provider}/${route.model}`,
+        `model "${route.model}" does not accept reasoning effort "${effort}"; the adapter default applies`,
+      )
+      safe = { provider: safe.provider, model: safe.model }
+    }
+    return safe
+  }
+}

package/src/routing.ts

@@ -33,6 +33,7 @@ import {
   type Decision,
   type RouteState,
 } from './policy.ts'
+import { RoutePreflight } from './preflight.ts'
 import type { AutotierService } from './service.ts'
 import type { AgentStateStore } from './state.ts'
 import { classifyFallback, EFFORT_LADDER, effortRank, escalationLadder, resolveRoute } from './tiers.ts'
@@ -122,6 +123,7 @@ export class AutotierRouter {
   private readonly counters = new WeakMap<Session, { toolNames: string[]; messageCount: number }>()
   /** Router-owned lifetime signal: aborts in-flight judge calls on unload. */
   private readonly lifetime = new AbortController()
+  private readonly preflight: RoutePreflight
   private disposed = false
 
   /**
@@ -132,6 +134,10 @@ export class AutotierRouter {
     this.ctx = options.ctx
     this.service = options.service
     this.states = options.states
+    this.preflight = new RoutePreflight({
+      ctx: this.ctx,
+      onDegrade: (_key, note) => this.ctx.logger.warn('dsh-autotier: %s', note),
+    })
     this.ctx.on('agent/inbox/inserted', payload => this.onInboxInserted(payload.agent, payload.message), { prepend: true })
     this.ctx.on('agent/request', (payload, next) => this.onRequest(payload.agent, payload.turn, payload.step, next), { prepend: true })
     this.ctx.on('agent/error', payload => this.onAgentError(payload.agent, payload.error))
@@ -431,7 +437,11 @@ export class AutotierRouter {
     const source: RouteSource = veto === undefined || veto === null ? decision.source : 'manual'
     const reason = veto === undefined || veto === null ? decision.reason : `veto: ${veto.reason}`
     const route = this.routeFor(tier, config, intent, state, now, base)
-    const applied = resolveRoute(base, route)
+    // Pre-flight the landing against the live registry: an unregistered
+    // provider or an effort the target model rejects degrades here instead of
+    // failing the request.
+    const safeRoute = await this.preflight.sanitize(route, tier === 'strong' ? config.tiers.strong : config.tiers.cheap)
+    const applied = resolveRoute(base, safeRoute)
     if (state.appliedTier !== tier) {
       const from = state.appliedTier
       state.appliedTier = tier