dsh-llm-fallbacks 0.4.4 → 0.5.0

package/dist/virtual-adapter.d.ts

@@ -14,7 +14,7 @@
  * reconcile thunk, wired by `apply()`) plus child activation. The row is
  * visible whenever the plugin is enabled — a non-conforming all-day chain
  * does NOT hide it (PR #62 feedback); conformance still gates a
- * successful override/delegate (`effectiveHeadOf` below refuses a
+ * successful delegate (`effectiveHeadOf` below refuses a
  * non-conforming all-day). The condition deliberately ignores `timeSlots`
  * and conformance, so slot-row edits and chain edits never churn
  * registration.
@@ -26,12 +26,14 @@
  * `agent/request-error`, where the existing engine walks from there).
  * `resolveModel` proxies the current effective head's metadata when
  * resolvable (modalities/context-window/reasoning follow the head) with a
- * permissive default otherwise — never throws.
+ * permissive default otherwise — never throws. `providerRetryPolicy` and
+ * `imageRequestPricing` mirror the same head for the host-captured retry
+ * policy and the token meter — also never throwing.
  *
  * @module dsh-llm-fallbacks/virtual-adapter
  */
 import type { Context } from '@deepseek-ai/cordis';
-import { LlmAdapter, type GenerateOptions, type LlmImageRequestPricing, type LlmModelInfo, type LlmResolvedModelInfo, type LlmRuntime, type StreamChunk } from '@deepseek-ai/dsh-llm';
+import { LlmAdapter, type GenerateOptions, type LlmImageRequestPricing, type LlmModelInfo, type LlmResolvedModelInfo, type LlmRuntime, type ResolvedRetryPolicy, type StreamChunk } from '@deepseek-ai/dsh-llm';
 import type { FallbacksConfig } from './config.ts';
 /** Provider route of the virtual adapter (exact string, spec lock). */
 export declare const FALLBACKS_PROVIDER = "FallbacksChain";
@@ -62,15 +64,33 @@ export interface EffectiveHead {
 }
 /**
  * The FIRST DISPATCHABLE exact head of a chain — the single definition of
- * "effective head" (F-001) shared by the root select-is-primary override
- * (`src/index.ts`) and the virtual adapter's delegate paths. Walks the SAME
- * chain `resolveEffectiveChain` produces, skipping entries that can never
+ * "effective head" (F-001) shared by the virtual adapter's delegate paths and
+ * the routing engine's served-route anchor (`anchorServedRoute` in
+ * `src/index.ts`). Walks the SAME chain `resolveEffectiveChain` produces,
+ * skipping entries that can never
  * be dispatched: malformed selectors (config-warning path), `provider/*`
  * `provider/*` wildcards (no real pair), and self-routes back to
  * `FallbacksChain/*` (the P1 recursion guard). `undefined` when the chain
  * is empty or no entry is dispatchable.
  */
 export declare function firstDispatchableExactHead(chain: readonly string[]): EffectiveHead | undefined;
+/**
+ * The effective chain head at `now` (P1): the first DISPATCHABLE exact head
+ * of the SAME `resolveEffectiveChain` the routing engine uses — thin
+ * config+clock entry into the shared {@link firstDispatchableExactHead} (no
+ * divergent skip/walk rules). `undefined` when the chain is empty or no
+ * entry is dispatchable (wildcard, self-route to `FallbacksChain/*`,
+ * malformed selector).
+ *
+ * Conformance gate (PR #62 feedback): the all-day `rootChain` must be
+ * conforming (exactly one official model — Flash or Pro)
+ * for a successful delegate —
+ * a legacy multi-model (or empty) all-day chain earns no primary
+ * semantics even though the picker row is visible. `resolveModel` then
+ * falls back to the permissive default and `stream()` throws
+ * {@link UNDISPATCHABLE_HEAD_CODE}.
+ */
+export declare function effectiveHeadOf(config: FallbacksConfig, now: Date): EffectiveHead | undefined;
 /**
  * Host picker label: `Auto: <displayName>[<slot>]`.
  * Display name first so the trigger stays readable and platforms stay
@@ -104,6 +124,22 @@ export declare class FallbacksChainAdapter extends LlmAdapter {
      * answer for the CURRENT head. Permissive default otherwise; never throws.
      */
     resolveModel(provider: string, model: string, signal?: AbortSignal): Promise<LlmResolvedModelInfo>;
+    /**
+     * Route-accurate retry attribution: the virtual row declares no policy of
+     * its own — the virtual `provider` argument is intentionally ignored. The
+     * host captures `adapter.providerRetryPolicy(provider) ??
+     * resolveRetryPolicy(void 0, …)` ONCE, when a route is registered, so
+     * answering here with the SAME policy the concrete head route declared
+     * (e.g. a user's `llm-deepseek.retryPolicy`, including `mode: 'always'`)
+     * keeps retries behaving exactly as they do on the head `stream()`
+     * dispatches. Never throws: an unresolvable head, a vanished `llm`, or an
+     * unregistered head provider degrades to `undefined` — the host's own
+     * default. That last arm matters: the runtime's lookup THROWS `NO_ADAPTER`
+     * for an unknown provider, and this call happens inside the plugin's
+     * `registerAdapter`, so an escaping throw would take the whole virtual
+     * route down instead of just degrading its policy.
+     */
+    providerRetryPolicy(_provider: string): ResolvedRetryPolicy | undefined;
     /**
      * Route-accurate image pricing (0.1.2 adoption): the virtual row has no
      * pricing of its own — the virtual `provider`/`model` arguments are

package/package.json

@@ -5,7 +5,7 @@
     "dsh",
     "dsh-plugin"
   ],
-  "version": "0.4.4",
+  "version": "0.5.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -47,9 +47,10 @@
     "build-client": "tsx scripts/build-client.ts",
     "release:prepare": "tsx scripts/prepare-release.ts",
     "release:validate": "tsx scripts/validate-release-version.ts",
-    "repair:fallbacks-switch-logs": "tsx scripts/repair-fallbacks-switch-logs.ts",
+    "repair:session-logs": "tsx scripts/repair-session-logs.ts",
     "test": "vitest run",
-    "typecheck": "tsc -p tsconfig.build.json --noEmit && tsc --noEmit",
+    "typecheck": "tsc -p tsconfig.build.json --noEmit && tsc --noEmit && pnpm run typecheck:scripts",
+    "typecheck:scripts": "tsc -p tsconfig.scripts.json",
     "prepare": "pnpm run build"
   },
   "engines": {