dsh-llm-fallbacks 0.4.3 → 0.5.0

package/dist/time-slots.d.ts

@@ -1,6 +1,6 @@
 /**
  * Time-slot rows for `fallbacks` (plan fallbacks-timeslots Task 1, pins
- * P4–P6): frozen preset windows, the official-V4 all-day conformance
+ * P4–P6): frozen preset windows, the official all-day conformance
  * guard, and the pure `resolveEffectiveChain` / `resolveSlotState`
  * resolver.
  *
@@ -15,9 +15,17 @@
  * @module dsh-llm-fallbacks/time-slots
  */
 import type { FallbacksConfig } from './config.ts';
-/** Official V4 models — the ONLY legal all-day selectors (length 1, XOR). */
-export declare const OFFICIAL_V4_FLASH = "deepseek-official/deepseek-v4-flash";
-export declare const OFFICIAL_V4_PRO = "deepseek-official/deepseek-v4-pro";
+/** Official all-day selectors — the ONLY legal tails (length 1, XOR):
+ * Flash (the current official default, selectable) and Pro (displayed but
+ * disabled — its model is not yet served by the 0.1.5-rc.1 catalog). The
+ * retired V4 ids (`deepseek-v4-flash` / `deepseek-v4-pro`) are no longer
+ * legal tails. */
+export declare const OFFICIAL_FLASH = "deepseek-official/deepseek-flash";
+export declare const OFFICIAL_PRO = "deepseek-official/deepseek-pro";
+/** The two official all-day tail ids (XOR — exactly one legal tail). */
+export declare const OFFICIAL_ALL_DAY_IDS: readonly ["deepseek-official/deepseek-flash", "deepseek-official/deepseek-pro"];
+/** Whether `id` is one of the two official all-day tail ids. */
+export declare function isOfficialAllDayId(id: string): boolean;
 /** The four frozen preset ids (exact strings, spec lock). */
 export declare const PRESET_IDS: readonly ["liang-peak", "liang-valley", "glm-peak", "glm-valley"];
 export type PresetId = (typeof PRESET_IDS)[number];
@@ -65,12 +73,13 @@ export interface PresetDefinition {
 export declare const PRESETS: Record<PresetId, PresetDefinition>;
 /**
  * All-day conformance (P6): the all-day chain is conforming when its LAST
- * entry (the tail — the card's 默认模型 panel) is exactly one official V4
- * model — Flash XOR Pro. Leading entries (the card's 默认降级链 block) are
- * the ordered walk before that last-resort fallback. An empty chain or a
- * chain whose tail is not an official V4 model keeps slot rows inert and
- * refuses the virtual-row override/delegate; the v0.2.2 failure walk over
- * the raw chain stays verbatim.
+ * entry (the tail — the card's 默认模型 panel) is exactly one official
+ * model — Flash or Pro (XOR). Leading entries (the card's 默认降级链 block)
+ * are the ordered walk before that last-resort fallback. An empty chain or
+ * a chain whose tail is not an official model (including the retired V4
+ * ids) keeps slot rows inert and refuses the virtual-row
+ * delegate; the v0.2.2 failure walk over the raw chain stays
+ * verbatim.
  */
 export declare function isAllDayConforming(chain: readonly string[]): boolean;
 /**
@@ -83,7 +92,8 @@ export declare function isAllDayConforming(chain: readonly string[]): boolean;
  * P6 (qc1 F-001): without a conforming all-day the slot rows are inert, so
  * this IS the raw `rootChain` — the gate lives in {@link resolveSlotState},
  * the single source every slot surface (this, the 分时切换 log, the
- * `/fallbacks` strip, select-is-primary, the virtual adapter delegate) reads.
+ * `/fallbacks` strip, the virtual adapter delegate, its served-route anchor)
+ * reads.
  */
 export declare function resolveEffectiveChain(config: FallbacksConfig, now: Date, tz: string): string[];
 /**

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.3",
+  "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": {
@@ -60,45 +61,65 @@
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-agent": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-api-gateway": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-api-remotes": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-api-session-controller": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-client-connection": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-client-locale": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-client-store": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-client-ui-chat": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-client-ui-settings": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-client-ui-settings-plugins": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-commands": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-llm": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-llm-retry": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-session": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-settings": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-tool-subagent": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-typert-protocol": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-typert-registry": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-agent": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-api-gateway": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-api-remotes": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-api-session-controller": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-client-connection": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-client-locale": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-client-store": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-client-ui-chat": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-client-ui-settings-plugins": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-commands": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-llm": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-llm-retry": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-session": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-settings": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-tool-subagent": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-typert-protocol": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-typert-registry": "^0.1.5-rc.1",
     "@deepseek-ai/schemastery": "^3.18.2",
     "react": "^18.2.0"
   },
   "devDependencies": {
+    "@shikijs/langs": "^4.4.3",
     "@testing-library/dom": "^10.4.1",
     "@testing-library/react": "^16.3.2",
+    "@types/mdast": "^4.0.4",
     "@types/node": "^22.20.0",
     "@types/react": "~18.3.31",
     "@types/react-dom": "~18.3.7",
     "@types/use-sync-external-store": "^1.5.0",
+    "anser": "^2.3.5",
+    "clsx": "^2.1.1",
+    "immer": "^10.2.0",
     "jsdom": "29.1.1",
+    "katex": "^0.16.47",
+    "mdast-util-from-markdown": "^2.0.3",
+    "mdast-util-gfm": "^3.1.0",
+    "mdast-util-math": "^3.0.0",
+    "micromark-core-commonmark": "^2.0.3",
+    "micromark-extension-gfm": "^3.0.0",
+    "micromark-extension-math": "^3.1.0",
+    "micromark-factory-space": "^2.0.1",
+    "micromark-util-character": "^2.1.1",
+    "micromark-util-classify-character": "^2.0.1",
+    "micromark-util-sanitize-uri": "^2.0.1",
+    "micromark-util-symbol": "^2.0.1",
+    "micromark-util-types": "^2.0.2",
     "react": "^18.3.1",
     "react-dom": "^18.3.1",
+    "shiki": "^4.4.3",
     "tsdown": "^0.22.2",
     "tsx": "^4.22.4",
     "typescript": "^5.9.3",
-    "vitest": "^4.1.8"
+    "vitest": "^4.1.8",
+    "zustand": "~4.4.7"
   },
   "repository": {
     "type": "git",

package/scripts/build-client.ts

@@ -48,11 +48,15 @@ const OUT_FILE = 'index.js'
 
 /**
  * Frozen loader module table (dsh mechanism-guide): the plan-documented
- * composition = PLATFORM_MODULES (8 entries in 0.1.2, `web/src/platform.ts:8-15`
- * — the old runtime `./client` exemption became the
- * `@deepseek-ai/dsh-client-store` platform module, so the store VALUE import
- * stays external and resolves from the host loader table) + the
- * PRELOADED_CLIENT_EXTERNALS (empty in 0.1.2, `web/src/platform.ts:16-17`).
+ * composition = PLATFORM_MODULES (9 entries in 0.1.5-rc.1,
+ * `web/src/platform.ts:8-16` — the old runtime `./client` exemption became
+ * the `@deepseek-ai/dsh-client-store` platform module, so the store VALUE
+ * import stays external and resolves from the host loader table) + the
+ * host's PRELOADED_CLIENT_EXTERNALS (empty in `packages/client/web/src/platform.ts`).
+ * The table need not list
+ * every platform module — it lists what this plugin's client half resolves
+ * from the frozen loader table; the rc.1 addition
+ * `@deepseek-ai/dsh-client-ui-dockkit` is not imported by this plugin.
  * rc.8 dropped `dsh-client-web-react` (deleted
  * package — the uSES bridge is vendored in `src/client/use-snapshot.ts`),
  * `dsh-client-ui-attachment` and `dsh-client-schema-form` from the platform