dsh-llm-fallbacks 0.7.0 → 0.8.0

package/dist/client/locales.d.ts

@@ -37,21 +37,26 @@ export declare const zh: {
     'chains.selector.modelPlaceholder': string;
     'chains.selector.wildcardLegacy': string;
     'chains.selector.noModelsStrict': string;
-    'mainAgent.label': string;
     'subagents.label': string;
-    'subagents.policy.label': string;
-    'subagents.policy.allowlist': string;
-    'subagents.policy.head': string;
-    'subagents.policy.source.authorized': string;
-    'subagents.policy.source.injected': string;
-    'subagents.policy.blocked': string;
-    'subagents.policy.unprovable': string;
-    'subagents.policy.offAllowlist': string;
-    'subagents.policy.recommend': string;
-    'subagents.policy.sync': string;
-    'subagents.policy.sync.done': string;
-    'subagents.policy.sync.failed': string;
-    'subagents.policy.sync.dirty': string;
+    'virtualChain.label': string;
+    'virtualChain.hint': string;
+    'chains.tab.add': string;
+    'chains.tab.menu': string;
+    'chains.name.label': string;
+    'chains.name.hint': string;
+    'chains.name.tooltip': string;
+    'chains.tab.renameLabel': string;
+    'chains.tab.renameDone': string;
+    'chains.tab.delete': string;
+    'chains.tab.deleteDisabled': string;
+    'chains.tab.dirty': string;
+    'chains.tab.error': string;
+    'chains.empty.title': string;
+    'chains.empty.body': string;
+    'chains.empty.create': string;
+    'chains.chainFoot.hint': string;
+    'chains.chainFoot.discard': string;
+    'chains.chainFoot.save': string;
     'timeSlots.label': string;
     'timeSlots.hint': string;
     'timeSlots.tz.label': string;
@@ -99,8 +104,6 @@ export declare const zh: {
     'allDay.pro': string;
     'allDay.nonconforming': string;
     'roles.list.label': string;
-    'roles.list.hint': string;
-    'roles.list.tooltip': string;
     'roles.id': string;
     'roles.id.hint': string;
     'roles.idPlaceholder': string;
@@ -112,35 +115,24 @@ export declare const zh: {
     'roles.seedSource.bundled': string;
     'roles.seedSource.external': string;
     'roles.seedSource.user': string;
-    'roles.seedChainOptional': string;
-    'roles.fallback': string;
-    'roles.fallback.inherit-root': string;
-    'roles.fallback.none': string;
+    'roles.list.hint': string;
+    'roles.chain.label': string;
+    'roles.chain.unspecified': string;
+    'roles.chain.hint': string;
+    'roles.chain.tooltip': string;
+    'roles.chainMeta.unspecified': 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.provider': string;
-    'roles.rule.provider.any': string;
-    'roles.rule.model': string;
-    'roles.rule.model.any': string;
-    'roles.rule.role': string;
-    'roles.rule.role.inherit': string;
-    'roles.rule.roleSelectPlaceholder': string;
-    'roles.rule.roleUndeclared.short': string;
-    'roles.addRule': string;
-    'roles.removeRule': string;
     'validation.blocked': string;
     'validation.roleIdFormat': string;
     'validation.roleIdReserved': string;
     'validation.roleIdDuplicate': string;
-    'validation.ruleRoleUndeclared': string;
-    'validation.ruleRoleRequired': string;
-    'validation.roleChainRequired': string;
+    'validation.chainIdFormat': string;
+    'validation.chainIdDuplicate': string;
+    'validation.chainLabelRequired': string;
+    'validation.chainEntriesRequired': string;
     'validation.allDayRequired': string;
     'validation.slotChainRequired': string;
     'validation.slotWindow': string;
@@ -158,24 +150,9 @@ export declare const zh: {
     'catalog.outside.tooltip': string;
     'catalog.outside.short': string;
     'catalog.unconfigured.short': string;
-    'status.title': string;
-    'status.switches.label': string;
-    'status.switches.empty': string;
-    'status.switches.error': string;
-    'status.switches.compact': string;
-    'status.switches.compact.roleInject': string;
     'status.switches.reason.trigger-code': string;
     'status.switches.reason.always-cap': string;
     'status.switches.reason.role-inject': string;
-    'general.title': string;
-    'general.enabled': string;
-    'general.disabled': string;
-    'general.unknown': string;
-    'general.unavailable': string;
-    'general.switch': string;
-    'general.switch.roleInject': string;
-    'general.switch.empty': string;
-    'general.error': string;
     'chat.switch.title': string;
     'chat.switch.summary': string;
     'chat.switch.summary.roleInject': string;
@@ -230,21 +207,26 @@ export declare const en: {
     'chains.selector.modelPlaceholder': string;
     'chains.selector.wildcardLegacy': string;
     'chains.selector.noModelsStrict': string;
-    'mainAgent.label': string;
     'subagents.label': string;
-    'subagents.policy.label': string;
-    'subagents.policy.allowlist': string;
-    'subagents.policy.head': string;
-    'subagents.policy.source.authorized': string;
-    'subagents.policy.source.injected': string;
-    'subagents.policy.blocked': string;
-    'subagents.policy.unprovable': string;
-    'subagents.policy.offAllowlist': string;
-    'subagents.policy.recommend': string;
-    'subagents.policy.sync': string;
-    'subagents.policy.sync.done': string;
-    'subagents.policy.sync.failed': string;
-    'subagents.policy.sync.dirty': string;
+    'virtualChain.label': string;
+    'virtualChain.hint': string;
+    'chains.tab.add': string;
+    'chains.tab.menu': string;
+    'chains.name.label': string;
+    'chains.name.hint': string;
+    'chains.name.tooltip': string;
+    'chains.tab.renameLabel': string;
+    'chains.tab.renameDone': string;
+    'chains.tab.delete': string;
+    'chains.tab.deleteDisabled': string;
+    'chains.tab.dirty': string;
+    'chains.tab.error': string;
+    'chains.empty.title': string;
+    'chains.empty.body': string;
+    'chains.empty.create': string;
+    'chains.chainFoot.hint': string;
+    'chains.chainFoot.discard': string;
+    'chains.chainFoot.save': string;
     'timeSlots.label': string;
     'timeSlots.hint': string;
     'timeSlots.tz.label': string;
@@ -293,7 +275,6 @@ export declare const en: {
     'allDay.nonconforming': string;
     'roles.list.label': string;
     'roles.list.hint': string;
-    'roles.list.tooltip': string;
     'roles.id': string;
     'roles.id.hint': string;
     'roles.idPlaceholder': string;
@@ -305,35 +286,23 @@ export declare const en: {
     'roles.seedSource.bundled': string;
     'roles.seedSource.external': string;
     'roles.seedSource.user': string;
-    'roles.seedChainOptional': string;
-    'roles.fallback': string;
-    'roles.fallback.inherit-root': string;
-    'roles.fallback.none': string;
+    'roles.chain.label': string;
+    'roles.chain.unspecified': string;
+    'roles.chain.hint': string;
+    'roles.chain.tooltip': string;
+    'roles.chainMeta.unspecified': 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.provider': string;
-    'roles.rule.provider.any': string;
-    'roles.rule.model': string;
-    'roles.rule.model.any': string;
-    'roles.rule.role': string;
-    'roles.rule.role.inherit': string;
-    'roles.rule.roleSelectPlaceholder': string;
-    'roles.rule.roleUndeclared.short': string;
-    'roles.addRule': string;
-    'roles.removeRule': string;
     'validation.blocked': string;
     'validation.roleIdFormat': string;
     'validation.roleIdReserved': string;
     'validation.roleIdDuplicate': string;
-    'validation.ruleRoleUndeclared': string;
-    'validation.ruleRoleRequired': string;
-    'validation.roleChainRequired': string;
+    'validation.chainIdFormat': string;
+    'validation.chainIdDuplicate': string;
+    'validation.chainLabelRequired': string;
+    'validation.chainEntriesRequired': string;
     'validation.allDayRequired': string;
     'validation.slotChainRequired': string;
     'validation.slotWindow': string;
@@ -351,24 +320,9 @@ export declare const en: {
     'catalog.outside.tooltip': string;
     'catalog.outside.short': string;
     'catalog.unconfigured.short': string;
-    'status.title': string;
-    'status.switches.label': string;
-    'status.switches.empty': string;
-    'status.switches.error': string;
-    'status.switches.compact': string;
-    'status.switches.compact.roleInject': string;
     'status.switches.reason.trigger-code': string;
     'status.switches.reason.always-cap': string;
     'status.switches.reason.role-inject': string;
-    'general.title': string;
-    'general.enabled': string;
-    'general.disabled': string;
-    'general.unknown': string;
-    'general.unavailable': string;
-    'general.switch': string;
-    'general.switch.roleInject': string;
-    'general.switch.empty': string;
-    'general.error': string;
     'chat.switch.title': string;
     'chat.switch.summary': string;
     'chat.switch.summary.roleInject': string;
@@ -392,8 +346,8 @@ declare module '@deepseek-ai/dsh-client-ui-slots' {
     }
 }
 /**
- * Reason → locale key map for switch summaries (S-c; shared by the card's
- * status block, the General page status row, and the conversation node). All
+ * Reason → locale key map for switch summaries (shared by the conversation
+ * node). All
  * reasons resolve from ONE key family (`status.switches.reason.*`) — the
  * shared reason vocabulary must not mix dictionary families (qc1 F-004). The
  * session log is durable and forward-compatible: a reason value outside the

package/dist/commands.d.ts

@@ -1,10 +1,11 @@
 /**
  * `/fallbacks` slash command (plan fallbacks-role-runtime T3, AC-5).
  *
- * Session-scoped, read-only diagnostic: current session origin → resolved
- * role → resolved chain (role chain, else rootChain — an `inherit: true`
- * tail is annotated 「（inherit-root）」) → recent `fallbacks/switch` events
- * (newest first, capped) → cooldown status. Mirrors dsh-advisor's
+ * Session-scoped, read-only diagnostic: current session origin → the resolved
+ * dispatch role (+ its specified chain pointer) → every configured named chain
+ * with its tail and current slot label, the calling agent's selection marked →
+ * recent `fallbacks/switch` events (newest first, capped) → cooldown status.
+ * Mirrors dsh-advisor's
  * `/advisor` command pattern: a conditional `ctx.inject(['commands'])` child
  * in `src/index.ts` calls {@link registerFallbacksCommands} with a
  * factory-bound handler; `commands` never joins the top-level inject list, so
@@ -26,11 +27,9 @@
  * @module dsh-llm-fallbacks/commands
  */
 import type { CommandDefinition } from '@deepseek-ai/dsh-commands';
-import { type FallbacksRole } from './config.ts';
-import type { Origin } from './roles.ts';
+type Origin = 'root' | 'subagent';
 import type { FallbacksSwitchEventData } from './events.ts';
 import type { SeedRevertFailReason } from './seeds.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`). */
@@ -64,26 +63,21 @@ export interface FallbacksCooldownEntry {
 export interface FallbacksCommandSnapshot {
     /** Session origin: `'root'` when the agent carries no header origin. */
     readonly origin: Origin;
-    /** Resolved role (first matching `roles.rules` entry → built-in `'inherit'`, spec §7.1). */
+    /** Resolved dispatch role (the seam record), `''` when none resolved. */
     readonly role: string;
-    /** True when the role's own chain is non-empty and shown; false when rootChain (or none) is shown. */
-    readonly chainRole: boolean;
-    /** The displayed chain entries: the role's own chain when non-empty, else
-     * rootChain — except `fallback: 'none'` with an empty own chain, which
-     * yields `[]` even when rootChain is non-empty (nothing appended, mirroring
-     * resolveChainViews' `[...[], ...[]]`); empty = not configured. */
-    readonly chain: readonly string[];
-    /** True when rootChain is appended as the inherit fallback tail (role's
-     * `fallback` is `'inherit-root'` — or the role is unknown — and rootChain
-     * is non-empty; the diagnostic annotation source, spec §7.4). */
-    readonly inherit: boolean;
-    /** 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';
+    /** The resolved role's declared chain POINTER (「指定降级链」), `undefined`
+     * when the role is unresolved or specifies nothing (NOT SPECIFIED). */
+    readonly roleChain?: string;
+    /** Every configured named chain with its slot state; `selected` marks the
+     * calling agent's chain (its route names the chain id). */
+    readonly chains: readonly {
+        readonly id: string;
         readonly label: string;
-    };
+        readonly entries: readonly string[];
+        /** Current slot label for the chain (`'all-day'` when no row matches). */
+        readonly slotLabel: string;
+        readonly selected: boolean;
+    }[];
     /** Recent `fallbacks/switch` events (failure walks — 降级切换), newest
      * first, capped at {@link RECENT_SWITCHES_LIMIT}. */
     readonly switches: readonly FallbacksSwitchEventData[];
@@ -91,51 +85,45 @@ export interface FallbacksCommandSnapshot {
     readonly cooldown: readonly FallbacksCooldownEntry[];
 }
 /**
- * The composed-config surface `/fallbacks config` renders (plan
- * fallbacks-tui-client T2, AC-2): the composed `fallbacks` namespace as the
- * runtime sees it (settings user layer included). Roles are summarized from
- * `roles.list` as `{ id, chainCount }` — the two-block model: `roles.list`
- * entities carry id/persona/chain/fallback (NO per-role `model`;
- * `provider`/`model` live on `roles.rules`), so the readback line is id +
- * chain count, never a rules dump.
+ * The composed-config surface `/fallbacks config` renders: the composed
+ * `fallbacks` namespace as the runtime sees it (settings user layer included).
+ * It carries every named chain (`{ id, label, entries, timeSlots }`) and the
+ * declared roles as `{ id, chain? }` — the role's optional POINTER into
+ * `chains[].id` (「指定降级链」), rendered as its `FallbacksChain/<id>` route or
+ * as NOT SPECIFIED. There is no rules dump (rules are gone).
  *
- * Enriched readback (plan fallbacks-tui-settings Task 2, AC-4): timeSlots /
- * tz / roles.rules join the summary so TUI operators can verify `/settings`
- * edits. One summarized time-slot row: preset rows carry `{ preset,
- * chainCount }` (windows are frozen code constants in {@link PRESETS} and
- * never stored on the row — the render resolves the window text from
- * PRESETS); custom rows carry `{ start, end, chainCount }`. Rules rows carry
- * `{ provider, model, role }` — an omitted provider/model (wildcard match at
- * runtime) is summarized as `''` and rendered as `*`.
+ * The config-level `tz` joins the summary so TUI operators can verify
+ * `/settings` edits. One summarized time-slot row: preset rows carry
+ * `{ preset, chainCount }` (windows are frozen code constants in
+ * {@link PRESETS} and never stored on the row — the render resolves the window
+ * text from PRESETS); custom rows carry `{ start, end, chainCount }`.
  */
 export interface FallbacksConfigSummary {
     /**
-     * Content-presence gate (`isFallbackActive`, plan fallbacks-web-ux-alignment
-     * T2 — the removed config-level `enabled` switch re-keyed): the plugin
-     * intervenes exactly when a chain/time-slot/role is configured.
+     * Content-presence gate (`isFallbackActive`): the plugin intervenes exactly
+     * when the named-chain list is non-empty (`chains.length > 0`). Slot rows and
+     * declared roles alone do NOT activate it — they are per-chain / optional.
      */
     readonly active: boolean;
     readonly triggerCodes: readonly string[];
-    readonly rootChain: readonly string[];
-    /** Summarized time-slot rows (preset rows carry `preset`, custom rows carry `start`/`end`; both may carry a day mask). */
-    readonly timeSlots: readonly {
-        preset?: string;
-        start?: string;
-        end?: string;
-        days?: readonly number[];
-        chainCount: number;
+    /** Named chains (v2): id/label/entries + summarized per-chain slot rows. */
+    readonly chains: readonly {
+        id: string;
+        label: string;
+        entries: readonly string[];
+        timeSlots: readonly {
+            preset?: string;
+            start?: string;
+            end?: string;
+            days?: readonly number[];
+            chainCount: number;
+        }[];
     }[];
     /** Config-level timezone for slot matching (default `Asia/Shanghai`). */
     readonly tz: string;
     readonly roles: readonly {
         id: string;
-        chainCount: number;
-    }[];
-    /** Summarized role rules: provider/model patterns → declared role (or the built-in `'inherit'`). */
-    readonly rules: readonly {
-        provider: string;
-        model: string;
-        role: string;
+        chain?: string;
     }[];
     readonly cooldownMs: number;
     readonly revertPolicy: string;
@@ -145,8 +133,8 @@ export interface FallbacksConfigSummary {
 /**
  * The session-scoped read-only operations the `/fallbacks` handler drives.
  * Implemented by the wiring (`src/index.ts`) against the live config source
- * (`roles.list` / `rootChain` — no chain map anymore) and the per-agent
- * state store; faked in unit tests.
+ * (`chains` / `roles.list`), the dispatch seam's per-child record and the
+ * per-agent state store; faked in unit tests.
  */
 export interface FallbacksCommandController {
     /** Snapshot the session's fallback diagnostics. Never mutates state. */
@@ -186,7 +174,6 @@ export declare const FALLBACKS_COMMAND_LOCALES: {
         readonly origin: "会话来源";
         readonly role: "角色";
         readonly chain: "链";
-        readonly inheritRoot: "（inherit-root）";
         readonly chainNone: "未配置";
         readonly slot: "分时";
         readonly switches: "最近降级切换";
@@ -205,16 +192,16 @@ export declare const FALLBACKS_COMMAND_LOCALES: {
         readonly configEnabled: "已启用";
         readonly configDisabled: "未启用";
         readonly configTriggerCodes: "触发码";
-        readonly configRootChain: "根链";
+        readonly configChains: "虚拟链";
         readonly configEmpty: "（空）";
-        readonly configTimeSlots: "分时槽";
+        readonly configChainItem: "{id}（{label}）: {entries}｜分时槽: {slots}";
         readonly configSlotPresetItem: "{preset}（chain: {n}, window {window}）";
         readonly configSlotPresetBare: "{preset}（chain: {n}）";
         readonly configSlotCustomItem: "custom {start}-{end}（chain: {n}）";
         readonly configTz: "时区";
         readonly configRoles: "角色";
-        readonly configRoleItem: "{id}（chain: {n}）";
-        readonly configRules: "角色规则";
+        readonly configRoleItem: "{id}（指定降级链: {chain}）";
+        readonly configRoleUnspecified: "未指定（沿用 dsh 默认）";
         readonly configCooldown: "冷却";
         readonly configRevert: "回主策略";
         readonly configMaxSwitches: "单次请求行走最大切换";
@@ -239,7 +226,6 @@ export declare const FALLBACKS_COMMAND_LOCALES: {
         readonly origin: "Session origin";
         readonly role: "Role";
         readonly chain: "Chain";
-        readonly inheritRoot: " (inherit-root)";
         readonly chainNone: "not configured";
         readonly slot: "Time slot";
         readonly switches: "Recent fallback switches";
@@ -258,16 +244,16 @@ export declare const FALLBACKS_COMMAND_LOCALES: {
         readonly configEnabled: "enabled";
         readonly configDisabled: "disabled";
         readonly configTriggerCodes: "Trigger codes";
-        readonly configRootChain: "Root chain";
+        readonly configChains: "Chains";
         readonly configEmpty: "(empty)";
-        readonly configTimeSlots: "Time slots";
+        readonly configChainItem: "{id} ({label}): {entries} | slots: {slots}";
         readonly configSlotPresetItem: "{preset} (chain: {n}, window {window})";
         readonly configSlotPresetBare: "{preset} (chain: {n})";
         readonly configSlotCustomItem: "custom {start}-{end} (chain: {n})";
         readonly configTz: "TZ";
         readonly configRoles: "Roles";
-        readonly configRoleItem: "{id} (chain: {n})";
-        readonly configRules: "Rules";
+        readonly configRoleItem: "{id} (specified chain: {chain})";
+        readonly configRoleUnspecified: "not specified (dsh default)";
         readonly configCooldown: "Cooldown";
         readonly configRevert: "Revert";
         readonly configMaxSwitches: "Max switches per request walk";
@@ -312,31 +298,6 @@ export declare function parseFallbacksSubcommand(rawInput: string): FallbacksSub
  * `SessionEventMap` type, and the durable log can outlive schema versions).
  */
 export declare function recentFallbacksSwitches(events: readonly unknown[], limit: number): FallbacksSwitchEventData[];
-/**
- * The chain entries `/fallbacks` shows for a role (spec §7.4): the declared
- * role's own chain when non-empty (`chainRole: true`); an empty own chain
- * defers to `rootChain` unless `fallback: 'none'` — then nothing is appended
- * and the display chain is empty, mirroring `resolveChainViews`'s
- * `[...[], ...[]]` exactly; undeclared ids and the built-in `'inherit'`
- * role resolve to `rootChain`. `inherit: true` marks the append-not-replace
- * tail — the role's `fallback` is `'inherit-root'` (the default) or the role
- * is unknown/built-in `'inherit'`, and `rootChain` is non-empty. Mirrors
- * `resolveChainViews`'s concatenation (see {@link roleChainEntries} —
- * `src/chains.ts`; the diagnostic keeps its display semantics: the role's
- * own chain renders in full, `rootChain` only when the role has no own
- * chain, with the inherit tail as an annotation) without a failing model to
- * resolve against (the diagnostic is model-independent).
- *
- * `warn` mirrors {@link resolveChainViews}' defensive unknown-role warn
- * (qc2 F-002 — routed through the injected logger; the `/fallbacks` path
- * never reaches here unsanitized, as {@link resolveRole} resolves to a
- * declared id or `'inherit'` first, so this is direct-caller parity).
- */
-export declare function resolveChainForDiagnostic(roles: readonly FallbacksRole[], rootChain: readonly string[], role: string, warn?: (message: string) => void): {
-    readonly chainRole: boolean;
-    readonly chain: readonly string[];
-    readonly inherit: boolean;
-};
 /**
  * Cap for the composed-config readback's LIST lines — Trigger codes, Root
  * chain, Time slots, Roles, and Rules (qc2 Task-2 Minor): beyond this many
@@ -345,12 +306,13 @@ export declare function resolveChainForDiagnostic(roles: readonly FallbacksRole[
  */
 export declare const FALLBACKS_CONFIG_LIST_CAP = 5;
 /**
- * Render the `/fallbacks config` surface (plan fallbacks-tui-client T2,
- * AC-2 + fallbacks-tui-settings Task 2 AC-4): the composed `fallbacks`
- * namespace as the runtime reads it — enriched with the time-slot rows
- * (preset rows resolve their frozen window from {@link PRESETS}), the
- * config timezone, and the role rules — plus edit hints pointing at the
- * `/settings` TUI edit surface while keeping the file-edit documentation.
+ * Render the `/fallbacks config` surface: the composed `fallbacks` namespace
+ * as the runtime reads it — every named chain with its label, entries and
+ * time-slot rows (preset rows resolve their frozen window from
+ * {@link PRESETS}), the config timezone, and each role with its `chain`
+ * POINTER (the `FallbacksChain/<id>` it specifies, or NOT SPECIFIED) — plus
+ * edit hints pointing at the `/settings` TUI edit surface while keeping the
+ * file-edit documentation.
  * The FIRST LINE marks the composed-config readback — distinct from the
  * diagnostic title and never merged into {@link fallbacksCommandText} (two
  * operator surfaces, product lock). Locale defaults to `zh` (the command
@@ -359,8 +321,10 @@ 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) → current slot (分时) →
- * recent switches (降级切换) → cooldown.
+ * truthful: origin → role (+ its specified chain pointer) → every configured
+ * chain with tail + slot state, the calling agent's selection marked →
+ * recent switches (降级切换) → cooldown. No chain-id argument (named virtual
+ * chains §1): the snapshot lists every chain.
  */
 export declare function fallbacksCommandText(snapshot: FallbacksCommandSnapshot, locale?: FallbacksCommandLocale): string;
 /**
@@ -371,3 +335,4 @@ export declare function fallbacksCommandText(snapshot: FallbacksCommandSnapshot,
  * @returns the registry disposer (the inject child owns its lifetime).
  */
 export declare function registerFallbacksCommands(registry: FallbacksCommandRegistry, controller: FallbacksCommandController, locale?: FallbacksCommandLocale): () => void;
+export {};