dsh-llm-fallbacks 0.2.2 → 0.3.1

package/dist/client/locales.d.ts

@@ -41,15 +41,61 @@ export declare const zh: {
     'roleAutoMatch.hint': string;
     'roleAutoMatch.tooltip': string;
     'rootChain.label': string;
-    'rootChain.firstLine': string;
-    'rootChain.hint': string;
     'rootChain.tooltip': string;
-    'rootChain.selector.add': string;
+    'defaultModel.label': string;
     'chains.selector.remove': string;
     'chains.selector.providerPlaceholder': string;
     'chains.selector.modelPlaceholder': string;
     'chains.selector.wildcardLegacy': string;
     'chains.selector.noModelsStrict': string;
+    'mainAgent.label': string;
+    'subagents.label': string;
+    'timeSlots.label': string;
+    'timeSlots.hint': string;
+    'timeSlots.tz.label': string;
+    'timeSlots.drag': string;
+    'timeSlots.name': string;
+    'timeSlots.expand': string;
+    'timeSlots.collapse': string;
+    'timeSlots.tooltip': string;
+    'timeSlots.addPreset': string;
+    'timeSlots.addCustom': string;
+    'timeSlots.presetPlaceholder': string;
+    'timeSlots.remove': string;
+    'timeSlots.moveUp': string;
+    'timeSlots.moveDown': string;
+    'timeSlots.start': string;
+    'timeSlots.end': string;
+    'timeSlots.days': string;
+    'timeSlots.days.hint': string;
+    'timeSlots.preset.name': string;
+    'timeSlots.preset.windowLabel': string;
+    'timeSlots.preset.chainsOnly': string;
+    'timeSlots.preset.liang-peak.label': string;
+    'timeSlots.preset.liang-peak.window': string;
+    'timeSlots.preset.liang-valley.label': string;
+    'timeSlots.preset.liang-valley.window': string;
+    'timeSlots.preset.glm-peak.label': string;
+    'timeSlots.preset.glm-peak.window': string;
+    'timeSlots.preset.glm-valley.label': string;
+    'timeSlots.preset.glm-valley.window': string;
+    'timeSlots.preset.glm.note': string;
+    'timeSlots.preset.highCost': string;
+    'timeSlots.preset.multiplier': string;
+    'timeSlots.active': string;
+    'timeSlots.preset.glm.unconfigured': string;
+    'timeSlots.day.sun': string;
+    'timeSlots.day.mon': string;
+    'timeSlots.day.tue': string;
+    'timeSlots.day.wed': string;
+    'timeSlots.day.thu': string;
+    'timeSlots.day.fri': string;
+    'timeSlots.day.sat': string;
+    'timeSlots.selector.add': string;
+    'allDay.hint': string;
+    'allDay.flash': string;
+    'allDay.pro': string;
+    'allDay.nonconforming': string;
     'roles.list.label': string;
     'roles.list.hint': string;
     'roles.list.tooltip': string;
@@ -67,14 +113,12 @@ export declare const zh: {
     'roles.fallback.none': string;
     'roles.add': string;
     'roles.remove': string;
+    'roles.expand': string;
+    'roles.collapse': string;
     'roles.selector.add': string;
     'roles.rules': string;
     'roles.rules.hint': string;
     'roles.rules.tooltip': string;
-    'roles.rule.origin': string;
-    'roles.rule.origin.any': string;
-    'roles.rule.origin.root': string;
-    'roles.rule.origin.subagent': string;
     'roles.rule.provider': string;
     'roles.rule.provider.any': string;
     'roles.rule.model': string;
@@ -92,6 +136,14 @@ export declare const zh: {
     'validation.ruleRoleUndeclared': string;
     'validation.ruleRoleRequired': string;
     'validation.roleChainRequired': string;
+    'validation.allDayRequired': string;
+    'validation.slotChainRequired': string;
+    'validation.slotWindow': string;
+    'validation.slotDays': string;
+    'validation.slotKind': string;
+    'validation.slotPresetUnknown': string;
+    'validation.slotPresetDuplicate': string;
+    'validation.slotPresetFrozen': string;
     'validation.selector': string;
     'legacy.banner': string;
     'catalog.empty': string;
@@ -128,12 +180,6 @@ export declare const zh: {
     'save.saving': string;
     'save.error': string;
     close: string;
-    reset: string;
-    'reset.confirmTitle': string;
-    'reset.confirm': string;
-    'reset.confirm.cancel': string;
-    'reset.confirm.action': string;
-    'reset.saving': string;
     loading: string;
     unavailable: string;
     'error.generic': string;
@@ -182,15 +228,61 @@ export declare const en: {
     'roleAutoMatch.hint': string;
     'roleAutoMatch.tooltip': string;
     'rootChain.label': string;
-    'rootChain.firstLine': string;
-    'rootChain.hint': string;
     'rootChain.tooltip': string;
-    'rootChain.selector.add': string;
+    'defaultModel.label': string;
     'chains.selector.remove': string;
     'chains.selector.providerPlaceholder': string;
     'chains.selector.modelPlaceholder': string;
     'chains.selector.wildcardLegacy': string;
     'chains.selector.noModelsStrict': string;
+    'mainAgent.label': string;
+    'subagents.label': string;
+    'timeSlots.label': string;
+    'timeSlots.hint': string;
+    'timeSlots.tz.label': string;
+    'timeSlots.drag': string;
+    'timeSlots.name': string;
+    'timeSlots.expand': string;
+    'timeSlots.collapse': string;
+    'timeSlots.tooltip': string;
+    'timeSlots.addPreset': string;
+    'timeSlots.addCustom': string;
+    'timeSlots.presetPlaceholder': string;
+    'timeSlots.remove': string;
+    'timeSlots.moveUp': string;
+    'timeSlots.moveDown': string;
+    'timeSlots.start': string;
+    'timeSlots.end': string;
+    'timeSlots.days': string;
+    'timeSlots.days.hint': string;
+    'timeSlots.preset.name': string;
+    'timeSlots.preset.windowLabel': string;
+    'timeSlots.preset.chainsOnly': string;
+    'timeSlots.preset.liang-peak.label': string;
+    'timeSlots.preset.liang-peak.window': string;
+    'timeSlots.preset.liang-valley.label': string;
+    'timeSlots.preset.liang-valley.window': string;
+    'timeSlots.preset.glm-peak.label': string;
+    'timeSlots.preset.glm-peak.window': string;
+    'timeSlots.preset.glm-valley.label': string;
+    'timeSlots.preset.glm-valley.window': string;
+    'timeSlots.preset.glm.note': string;
+    'timeSlots.preset.highCost': string;
+    'timeSlots.preset.multiplier': string;
+    'timeSlots.active': string;
+    'timeSlots.preset.glm.unconfigured': string;
+    'timeSlots.day.sun': string;
+    'timeSlots.day.mon': string;
+    'timeSlots.day.tue': string;
+    'timeSlots.day.wed': string;
+    'timeSlots.day.thu': string;
+    'timeSlots.day.fri': string;
+    'timeSlots.day.sat': string;
+    'timeSlots.selector.add': string;
+    'allDay.hint': string;
+    'allDay.flash': string;
+    'allDay.pro': string;
+    'allDay.nonconforming': string;
     'roles.list.label': string;
     'roles.list.hint': string;
     'roles.list.tooltip': string;
@@ -208,14 +300,12 @@ export declare const en: {
     'roles.fallback.none': string;
     'roles.add': string;
     'roles.remove': string;
+    'roles.expand': string;
+    'roles.collapse': string;
     'roles.selector.add': string;
     'roles.rules': string;
     'roles.rules.hint': string;
     'roles.rules.tooltip': string;
-    'roles.rule.origin': string;
-    'roles.rule.origin.any': string;
-    'roles.rule.origin.root': string;
-    'roles.rule.origin.subagent': string;
     'roles.rule.provider': string;
     'roles.rule.provider.any': string;
     'roles.rule.model': string;
@@ -233,6 +323,14 @@ export declare const en: {
     'validation.ruleRoleUndeclared': string;
     'validation.ruleRoleRequired': string;
     'validation.roleChainRequired': string;
+    'validation.allDayRequired': string;
+    'validation.slotChainRequired': string;
+    'validation.slotWindow': string;
+    'validation.slotDays': string;
+    'validation.slotKind': string;
+    'validation.slotPresetUnknown': string;
+    'validation.slotPresetDuplicate': string;
+    'validation.slotPresetFrozen': string;
     'validation.selector': string;
     'legacy.banner': string;
     'catalog.empty': string;
@@ -269,12 +367,6 @@ export declare const en: {
     'save.saving': string;
     'save.error': string;
     close: string;
-    reset: string;
-    'reset.confirmTitle': string;
-    'reset.confirm': string;
-    'reset.confirm.cancel': string;
-    'reset.confirm.action': string;
-    'reset.saving': string;
     loading: string;
     unavailable: string;
     'error.generic': string;

package/dist/client/use-snapshot.d.ts

@@ -0,0 +1,11 @@
+import type { HostObservable, SnapshotSelectorHook } from '@deepseek-ai/dsh-client-ui-slots';
+export type { SnapshotSelectorHook } from '@deepseek-ai/dsh-client-ui-slots';
+/**
+ * Bind a bare observable source to a typed uSES selector hook.
+ * subscribe/getSnapshot are captured once per source into stable closures
+ * (also re-binds `this` for method-based sources), so components never
+ * resubscribe across renders. Equality defaults to Object.is.
+ * @param w - snapshot source (engine store, Session object, store instance).
+ * @returns the selector hook.
+ */
+export declare function bindSnapshotSelector<T>(w: HostObservable<T>): SnapshotSelectorHook<T>;

package/dist/commands.d.ts

@@ -24,6 +24,7 @@ import type { CommandDefinition } from '@deepseek-ai/dsh-commands';
 import { type FallbacksRole } from './config.ts';
 import type { Origin } from './roles.ts';
 import type { FallbacksSwitchEventData } from './events.ts';
+import type { SlotRowConfig } from './time-slots.ts';
 /** How many recent `fallbacks/switch` events `/fallbacks` shows (newest first). */
 export declare const RECENT_SWITCHES_LIMIT = 5;
 /** Minimal command registry surface (satisfied by the dsh `CommandService`). */
@@ -68,7 +69,15 @@ export interface FallbacksCommandSnapshot {
      * `fallback` is `'inherit-root'` — or the role is unknown — and rootChain
      * is non-empty; the diagnostic annotation source, spec §7.4). */
     readonly inherit: boolean;
-    /** Recent `fallbacks/switch` events, newest first, capped at {@link RECENT_SWITCHES_LIMIT}. */
+    /** Current time-slot winner + display label (P5/P7): the 分时切换 side of
+     * the status strip. The switches section below is the 降级切换 side —
+     * the copy never mixes. */
+    readonly slot: {
+        readonly winner: SlotRowConfig | 'all-day';
+        readonly label: string;
+    };
+    /** Recent `fallbacks/switch` events (failure walks — 降级切换), newest
+     * first, capped at {@link RECENT_SWITCHES_LIMIT}. */
     readonly switches: readonly FallbacksSwitchEventData[];
     /** Active cooldown entries for the agent. */
     readonly cooldown: readonly FallbacksCooldownEntry[];
@@ -118,7 +127,7 @@ export interface FallbacksCommandController {
 export declare const FALLBACKS_COMMAND_LOCALES: {
     readonly zh: {
         readonly title: "当前会话 fallback 诊断（只读）";
-        readonly description: "查看当前会话的降级链、最近切换与冷却状态（只读）";
+        readonly description: "查看当前会话的降级链、最近降级切换与冷却状态（只读）";
         readonly usageConfig: "查看组合后的 fallbacks 配置（设置回读）";
         readonly usage: "  /fallbacks config   查看组合后的 fallbacks 配置（设置回读）";
         readonly origin: "会话来源";
@@ -126,7 +135,8 @@ export declare const FALLBACKS_COMMAND_LOCALES: {
         readonly chain: "链";
         readonly inheritRoot: "（inherit-root）";
         readonly chainNone: "未配置";
-        readonly switches: "最近切换";
+        readonly slot: "分时";
+        readonly switches: "最近降级切换";
         readonly switchesNone: "本会话暂无 fallback 切换";
         readonly switchLine: "{from} → {to}（role={role}，reason={reason}）";
         readonly cooldown: "冷却";
@@ -156,7 +166,7 @@ export declare const FALLBACKS_COMMAND_LOCALES: {
     };
     readonly en: {
         readonly title: "Session fallback diagnostics (read-only)";
-        readonly description: "Inspect fallback chain, recent switches, and cooldown for this session (read-only)";
+        readonly description: "Inspect fallback chain, recent fallback switches, and cooldown for this session (read-only)";
         readonly usageConfig: "show the composed fallbacks config (settings readback)";
         readonly usage: "  /fallbacks config   show the composed fallbacks config (settings readback)";
         readonly origin: "Session origin";
@@ -164,7 +174,8 @@ export declare const FALLBACKS_COMMAND_LOCALES: {
         readonly chain: "Chain";
         readonly inheritRoot: " (inherit-root)";
         readonly chainNone: "not configured";
-        readonly switches: "Recent switches";
+        readonly slot: "Time slot";
+        readonly switches: "Recent fallback switches";
         readonly switchesNone: "No fallback switches in this session";
         readonly switchLine: "{from} → {to} (role={role}, reason={reason})";
         readonly cooldown: "Cooldown";
@@ -253,8 +264,8 @@ export declare const FALLBACKS_CONFIG_LIST_CAP = 5;
 export declare function fallbacksConfigText(summary: FallbacksConfigSummary, locale?: FallbacksCommandLocale): string;
 /**
  * Render the `/fallbacks` status surface for one snapshot. Kept minimal and
- * truthful: origin → role → chain (+ inherit tail) → recent switches →
- * cooldown.
+ * truthful: origin → role → chain (+ inherit tail) → current slot (分时) →
+ * recent switches (降级切换) → cooldown.
  */
 export declare function fallbacksCommandText(snapshot: FallbacksCommandSnapshot, locale?: FallbacksCommandLocale): string;
 /**

package/dist/config.d.ts

@@ -27,10 +27,17 @@
  *
  * @module dsh-llm-fallbacks/config
  */
+import type { SlotRowConfig } from './time-slots.ts';
 /** How a cooled-down model comes back (spec §4). */
 export type RevertPolicy = 'cooldown-expiry' | 'never';
-/** A single role rule: match on origin/provider/model patterns (spec §3). */
+/** A single role rule: match on provider/model patterns (spec §3). */
 export interface FallbacksRoleRule {
+    /**
+     * Legacy persisted wire field (PR #62 feedback): rules are subagent-only,
+     * so this constraint is IGNORED at match time — root requests never
+     * match rules. Kept in the type/schema so pre-feedback `settings.yaml`
+     * files that carry `origin` still parse, validate, and save unchanged.
+     */
     origin?: 'root' | 'subagent';
     provider?: string;
     model?: string;
@@ -104,6 +111,20 @@ export interface FallbacksConfig {
      * for direct constructors that omit it).
      */
     roleAutoMatch?: boolean;
+    /**
+     * Extra time-slot rows (plan fallbacks-timeslots Task 1, P5): the FIRST
+     * matching row's chain becomes the effective root chain at request time;
+     * `rootChain` (the all-day chain) is always the last row.
+     * Optional on purpose, mirroring `presets` — additive, non-breaking for
+     * library consumers. Malformed rows warn once and are skipped by the
+     * resolver; the gateway rejects them on save (Task 3).
+     */
+    timeSlots?: SlotRowConfig[];
+    /**
+     * Config-level timezone for slot matching (default `Asia/Shanghai`,
+     * UTC+8). Not per-slot.
+     */
+    tz?: string;
 }
 /**
  * Spec §4 defaults — `Config({})` must equal this (no-op install).

package/dist/index.d.ts

@@ -17,10 +17,13 @@
  *   `{ kind: 'retry' }` (own recovery, no `next()`).
  * - `agent/request` waterfall: apply a pending switch after `await next()`
  *   (provider/model override, inherited `reasoningEffort` dropped — the
- *   `installModelSelection` `withoutInheritedEffort` pattern), then the
- *   always-mode cap check (count `llm/retry` events for the current
- *   turn/step/provider; ≥ `alwaysModeRetryCap` → same decision path, reason
- *   `always-cap` — ADR-2).
+ *   `installModelSelection` `withoutInheritedEffort` pattern); a
+ *   root-origin `FallbacksChain/Auto` seed then overrides to the
+ *   effective chain's first exact head (select-is-primary, plan
+ *   fallbacks-virtual-chain Task 2); then the always-mode cap check (count
+ *   `llm/retry` events for the current turn/step/provider; ≥
+ *   `alwaysModeRetryCap` → same decision path, reason `always-cap` —
+ *   ADR-2).
  * - Per-agent state (`FallbackStateStore`): `agent/disposed` removes it,
  *   `agent/status` idle prunes per-step state defensively, plugin dispose
  *   clears everything (spec §6 — no residual state).