dsh-llm-fallbacks 0.7.0 → 0.8.0

package/dist/client/fallbacks-store.d.ts

@@ -24,49 +24,26 @@
  * message in `state.error` for the section's error banner (KD-G3 — the old
  * `settings-conflict` branch is gone).
  */
-import type { LlmConfigurableProvider, ModelCatalog, ModelProviderGroup, SessionFollowFrame, SessionFollowRequest, SessionId, SettingsDescribeValue, SettingsNamespaceView } from '@deepseek-ai/dsh-api-remotes/client';
-import type { SessionEventLikeEntry } from '@deepseek-ai/dsh-api-session-controller/client';
+import type { LlmConfigurableProvider, ModelCatalog, ModelProviderGroup, SessionId, SettingsDescribeValue, SettingsNamespaceView } from '@deepseek-ai/dsh-api-remotes/client';
 import type { ClientConnectionRpc } from '@deepseek-ai/dsh-client-connection/client';
 import { type SnapshotStore } from '@deepseek-ai/dsh-client-store';
 import type { RemoteResult } from '@deepseek-ai/dsh-typert-protocol';
-import { type FallbackStrategy, type FallbacksConfig, type FallbacksRole, type FallbacksRoleRule, type FallbacksRoles } from '../config.ts';
+import { type FallbacksConfig, type FallbacksRole, type NamedChain } from '../config.ts';
 import type { SlotRowConfig } from '../time-slots.ts';
-import type { FallbacksSwitchEventData } from '../events.ts';
 import type { SeedsWireStatus } from '../seeds.ts';
 /** The plugin's settings namespace on the host wire (settings/document-updated ns filter). */
 export declare const FALLBACKS_SETTINGS_NS = "fallbacks";
-/** Single-page history read for the status block (spec §2.5 D-5: `HISTORY_PAGE_MESSAGES`-sized). */
-export declare const SWITCHES_HISTORY_PAGE = 50;
-/** How many recent switches the status block renders (spec §2.5 D-5: N=5). */
-export declare const RECENT_SWITCH_LIMIT = 5;
 /**
- * One recent `fallbacks/switch` event as the status block renders it: the
- * durable payload plus the raw event's ordering key and time (the payload
- * itself carries no seq/time — spec §5 table).
- */
-export interface FallbacksSwitchSnapshot extends FallbacksSwitchEventData {
-    /** Event seq within the session (newest-first ordering key). */
-    seq: number;
-    /** Event time, Unix epoch milliseconds. */
-    time: number;
-}
-/**
- * The status block's derived "current effective model" (spec §2.5 D-6) — a
- * **display value** derived from configuration + recent switches, never a
- * live route probe.
+ * The per-chain "current effective model" (named virtual chains §4) — a
+ * **display value** derived from one chain's entries, never a live route
+ * probe.
  */
 export type EffectiveModelView = 
-/** ① An inactive config (nothing configured) or an empty rootChain. */
+/** ① An inactive config (no chains) or an empty entries list. */
 {
     kind: 'unavailable';
 }
-/** ② The most recent switch's target (`to`). */
- | {
-    kind: 'switched';
-    provider: string;
-    model: string;
-}
-/** ③ No switches yet: the config's primary target (first chain entry). */
+/** ② The chain's first entry (the dispatch head). */
  | {
     kind: 'config';
     provider: string;
@@ -121,54 +98,9 @@ export interface FallbacksSettingsState {
     groups: readonly ModelProviderGroup[];
     /** Bumped on every accepted catalog read; drives row re-classification. */
     catalogEpoch: number;
-    /** Recent-switch summary (spec §2.4 R-4a / §2.5 D-5). */
-    switchesStatus: 'idle' | 'loading' | 'ready' | 'error';
-    /** Switch-read diagnostic (wire message); null when none. */
-    switchesError: string | null;
-    /** Most recent `fallbacks/switch` events of the current session, newest first. */
-    switches: FallbacksSwitchSnapshot[];
-    /**
-     * Host subagent-model-selection policy (spec D4 / T5). `undefined` when
-     * the gateway omitted the additive field (old payload / policy off) —
-     * the card hides the status area and never renders an active allowlist.
-     */
-    subagentPolicy: SubagentPolicyView | undefined;
+    /** Current session id the conversation switch strip follows. */
+    currentSession: SessionId | undefined;
 }
-/** Source label of the effective subagent chain head (spec D4). */
-export type SubagentPolicyHeadSource = 'authorized' | 'injected';
-/** One exact route on the additive `subagentPolicy` wire field. */
-export type SubagentPolicyRoute = {
-    provider: string;
-    model: string;
-};
-/**
- * Client-side view of the additive host-policy payload. Structural twin of
- * the gateway wire type — parsed from unknown, never imported from host
- * modules (`src/client/**` consumes policy only via the gateway channel).
- */
-export type SubagentPolicyView = {
-    state: 'enabled';
-    allowedModels: SubagentPolicyRoute[];
-    head?: {
-        route: SubagentPolicyRoute;
-        source: SubagentPolicyHeadSource;
-    };
-    blockedAttempt?: {
-        at: number;
-        route: SubagentPolicyRoute;
-        reason: string;
-    };
-} | {
-    state: 'disabled';
-} | {
-    state: 'unprovable';
-};
-/**
- * Shape-guard the additive `subagentPolicy` wire field (T5). Malformed
- * payloads resolve to `undefined` (hide the status area) — the store never
- * throws on an old or misshapen field (old-payload tolerance).
- */
-export declare function parseSubagentPolicyWire(value: unknown): SubagentPolicyView | undefined;
 /**
  * The provider dropdown's offer set (spec §2.5 D-4): catalog providers whose
  * settings profile resolves in the describe namespaces — the Models page's
@@ -218,28 +150,12 @@ export declare function classifyProvider(raw: string, catalog: CatalogLookup | u
  */
 export declare function classifyModel(provider: string, raw: string, catalog: CatalogLookup | undefined): CatalogSelection;
 /**
- * Extract the most recent `fallbacks/switch` events from one history page
- * (spec §2.5 D-5): drop packed chunk runs, filter by event type, order by
- * `seq` descending, take at most `limit`. Single-page read — fewer than
- * `limit` events show as-is; no multi-page backfill (Non-Goal).
- */
-export declare function extractRecentSwitches(entries: readonly SessionEventLikeEntry[], limit?: number): FallbacksSwitchSnapshot[];
-/**
- * Derive the "current effective model" (spec §2.5 D-6): ① inactive (nothing
- * configured — the removed `enabled` switch re-keyed to `isFallbackActive`)
- * / empty rootChain → unavailable; ② a recent switch exists → the latest
- * one's `to`; ③ otherwise → the config's primary target. A **display
- * value** — never a live route probe.
- *
- * INTENTIONAL D-6 CONTRACT RETENTION: after the AC-2 trim (plan
- * fallbacks-settings-visibility Task 2) the settings card's status block no
- * longer consumes this derivation, and no other production code imports it —
- * it is retained (NOT dead code to delete) as the spec §2.5 D-6 derived-value
- * surface, pinned by `tests/fallbacks-store.spec.ts` (D-6 display-value
- * contract). Keep both exports until the spec derivation is removed or gains
- * a real consumer.
+ * Derive the per-chain "current effective model" (named virtual chains §4):
+ * an inactive config (no chains) or empty entries → unavailable; otherwise
+ * the chain's first entry (the dispatch head). A **display value** — never a
+ * live route probe.
  */
-export declare function deriveEffectiveModel(config: FallbacksConfig, switches: readonly FallbacksSwitchSnapshot[]): EffectiveModelView;
+export declare function deriveEffectiveModel(chain: NamedChain | undefined): EffectiveModelView;
 /** One chain selector row: provider + model (or wildcard). */
 export interface ChainSelectorRow {
     /** `provider/*` wildcard entry: the model part is absent. */
@@ -250,25 +166,14 @@ export interface ChainSelectorRow {
 }
 /** Serialize one selector row to its wire string (`provider/model` | `provider/*`). */
 export declare function selectorRowToRaw(row: ChainSelectorRow): string;
+/** Parse one entry line into a selector row, classifying against the catalog. */
+export declare function entryToSelectorRow(entry: string, catalog: CatalogLookup | undefined): ChainSelectorRow;
 /**
- * One rootChain row in the editor: the root agent's single fallback chain
- * (block 1 of the two-block model) as an ordered selector list. There is no
- * key input — the row IS the chain.
- */
-export interface RootChainRow {
-    selectors: ChainSelectorRow[];
-}
-/** Project the rootChain entries into editable rows (one flat chain row). */
-export declare function rootChainToRows(rootChain: readonly string[], catalog?: CatalogLookup): RootChainRow[];
-/** Rebuild the rootChain from edited rows; rows with no usable selector drop out. */
-export declare function rowsToRootChain(rows: readonly RootChainRow[]): string[];
-/**
- * One extra time-slot row in the editor (plan fallbacks-timeslots Task 3):
- * preset rows freeze their windows (read-only summary, models-only edits);
- * custom rows edit start/end/days + chain. `kind` rides the wire VERBATIM —
- * a hand-written YAML row with an unknown kind reads back as a custom-shaped
- * row and serializes back unchanged, so the dirty check stays quiet (save
- * validation rejects it).
+ * One time-slot row in the editor: preset rows freeze their windows
+ * (read-only summary, models-only edits); custom rows edit start/end/days +
+ * chain. `kind` rides the wire VERBATIM — a hand-written YAML row with an
+ * unknown kind reads back as a custom-shaped row and serializes back
+ * unchanged, so the dirty check stays quiet (save validation rejects it).
  */
 export interface SlotEditorRow {
     kind: string;
@@ -290,12 +195,35 @@ export interface SlotEditorRow {
 export declare function timeSlotsToRows(timeSlots: readonly SlotRowConfig[], catalog?: CatalogLookup): SlotEditorRow[];
 /** Rebuild the time-slot rows from edited rows; blank selectors drop out.
  * `kind` rides verbatim (a hand-written unknown kind reads back unchanged;
- * save validation rejects it) — the cast asserts the trusted editor shape.
- * `days` is ALWAYS serialized ([] included): schemastery composes absent
- * array fields as `[]`, so the composed config every card load accepts
- * carries `days` on every row — the draft must too, or a clean card would
- * read back dirty. */
+ * save validation rejects it). `days` is ALWAYS serialized ([] included):
+ * schemastery composes absent array fields as `[]`, so the composed config
+ * every card load accepts carries `days` on every row — the draft must too,
+ * or a clean card would read back dirty. */
 export declare function rowsToTimeSlots(rows: readonly SlotEditorRow[]): SlotRowConfig[];
+/**
+ * One named-chain draft in the editor (named virtual chains): the chain's
+ * id (immutable once created), display label, 默认降级链 selector rows, and
+ * its 分时 slot rows. `label`/entries/slots are editable; the id is not.
+ */
+export interface ChainDraft {
+    id: string;
+    label: string;
+    selectors: ChainSelectorRow[];
+    slots: SlotEditorRow[];
+}
+/** Project the named chains into editable drafts (selectors classified). */
+export declare function chainsToDrafts(chains: readonly NamedChain[], catalog?: CatalogLookup): ChainDraft[];
+/**
+ * Generate a fresh unique chain id for the card's `+` affordance. Pass the
+ * DRAFT list, not the accepted config: two unsaved additions must not both
+ * claim `chain-N` (duplicate React keys, and a section the gateway rejects).
+ */
+export declare function newChainId(existing: readonly {
+    id: string;
+}[]): string;
+/** Rebuild one named chain from its draft; blank selectors drop out. */
+export declare function draftToChain(draft: ChainDraft): NamedChain;
+export declare function chainToChainDraftOf(chain: NamedChain, catalog?: CatalogLookup): ChainDraft;
 /**
  * One declared-role row in the editor (block 2 `roles.list`): identity
  * fields + the role's own chain selector list + its append strategy.
@@ -305,62 +233,36 @@ export declare function rowsToTimeSlots(rows: readonly SlotEditorRow[]): SlotRow
 export interface RoleRow {
     id: string;
     persona: string;
-    selectors: ChainSelectorRow[];
-    fallback: FallbackStrategy;
+    /** The MANUALLY specified named-chain POINTER (「指定降级链」); '' = NOT SPECIFIED. */
+    chain: string;
     /** UI-only collapse state — never serialized (dropped by rowsToRoles). */
     collapsed: boolean;
     /**
-     * UI-only seeded-persona brief disclosure (plan role-card-seeded-ux) —
-     * never serialized (dropped by rowsToRoles). Only seeded rows render the
-     * affordance (a read-only single-line brief + the expandable full text);
-     * ordinary rows ignore the flag.
+     * UI-only seeded-persona brief disclosure — never serialized (dropped by
+     * rowsToRoles). Only seeded rows render the affordance; ordinary rows
+     * ignore the flag.
      */
     personaOpen: boolean;
 }
-/** Project the declared roles into editable rows (chain selectors classified). */
-export declare function rolesToRows(roles: readonly FallbacksRole[], catalog?: CatalogLookup): RoleRow[];
-/** Rebuild the declared roles from edited rows; empty selectors drop out. */
+/** Project the declared roles into editable rows (chain pointer kept verbatim). */
+export declare function rolesToRows(roles: readonly FallbacksRole[]): RoleRow[];
+/** Rebuild the declared roles from edited rows; an empty pointer drops out. */
 export declare function rowsToRoles(rows: readonly RoleRow[]): FallbacksRole[];
 /**
  * Rebuild the declared roles from edited rows, re-attaching the
  * schema-reserved `prompt`/`permissions` fields from the last accepted
  * config by role id — they never round-trip through rows this round, so
- * without the merge a save would silently drop them (T2 reviewer minor
- * #2). The id trim matches {@link rowsToRoles}; a row whose id matches no
- * original role (a freshly added one) keeps no extras. Key order mirrors
- * `parseFallbacksConfig` so a clean draft's JSON dirty comparison never
- * flags it.
+ * without the merge a save would silently drop them. The id trim matches
+ * {@link rowsToRoles}; a row whose id matches no original role (a freshly
+ * added one) keeps no extras.
  */
 export declare function mergeRoleExtras(rows: readonly RoleRow[], originalRoles: readonly FallbacksRole[]): FallbacksRole[];
 /**
- * The `roles.rules` role dropdown's offer set — the ONLY data source for the
- * rule rows' role selector: the built-in `'inherit'` target plus every
- * declared `roles.list` id, in declaration order (a role added/removed on
- * the same page is reflected immediately).
- */
-export declare function ruleRoleOptions(roles: Pick<FallbacksRoles, 'list'>): string[];
-/**
- * Client-side legacy fallback detection (spec §9). The gateway's
- * `legacyKeys` wire field is authoritative for the migration banner; this is
- * a defensive fallback for configs that already passed wire normalization
- * yet still carry a `roles.rules` reference to an undeclared role id — the
- * only two-block-era leftover that can survive the wire (the removed
- * `chains`/`roles.default` keys never ride it).
+ * The 「指定降级链」 dropdown's offer set: the NOT-SPECIFIED empty value plus
+ * every declared chain, in declaration order (option label rendered by the
+ * card as `<label>（FallbacksChain/<id>）`).
  */
-export declare function detectLegacyClientKeys(config: FallbacksConfig): string[];
-/**
- * One role-rule row in the editor (PR #62 feedback: no origin control —
- * rules are subagent-only; a persisted wire `origin` is ignored).
- */
-export interface RoleRuleRow {
-    provider: CatalogSelection;
-    model: CatalogSelection;
-    role: string;
-}
-/** Project the role rules into editable rows (provider/model classified). */
-export declare function rulesToRows(rules: readonly FallbacksRoleRule[], catalog?: CatalogLookup): RoleRuleRow[];
-/** Rebuild the role rules from edited rows; empty provider/model drop out. */
-export declare function rowsToRules(rows: readonly RoleRuleRow[]): FallbacksRoleRule[];
+export declare function roleChainOptions(chains: readonly NamedChain[]): string[];
 /**
  * The settings Remote namespace face the fallbacks store reads
  * (`ctx.remote.settings`; api-settings-controller `@Remote` methods).
@@ -384,14 +286,6 @@ export interface FallbacksLlmRemote {
 export interface FallbacksSessionRemote {
     /** Host-generation model catalog: provider groups plus per-provider failures. */
     modelCatalog(): Promise<RemoteResult<ModelCatalog>>;
-    /**
-     * Live event stream for one durable session address; the opening snapshot
-     * frame carries the tail page this store reads, then the stream is
-     * cancelled (successor of the apiproxy `sessions.history` unary —
-     * `session/page` needs the follow opening frame's cursor, so a cold tail
-     * read goes through the follow opening).
-     */
-    follow(request: SessionFollowRequest, signal?: AbortSignal): AsyncIterable<SessionFollowFrame>;
 }
 /**
  * The generated Remote namespaces the fallbacks store consumes, as one
@@ -420,22 +314,12 @@ export declare class FallbacksSettingsController {
      */
     private writeGeneration;
     private catalogGeneration;
-    private switchesGeneration;
     /** Every settings namespace from the last describe, keyed by ns — the configured-provider join's other input. */
     private namespaces;
-    private currentSession;
-    /**
-     * The store's dispose signal (qc3 F-003): created alongside the store
-     * lifecycle, threaded into every `session.follow` call, aborted once in
-     * {@link dispose} — a follow opening still mid-await at plugin unload
-     * (HMR / fiber dispose, or a wedged gateway stream) is cancelled promptly
-     * instead of staying open until the mount abort or socket failure.
-     */
-    private readonly followAbort;
     /**
      * @param api - the Remote namespace faces the store reads (settings
      *   describe `writable` + namespace directory, llm provider directory,
-     *   session model catalog + follow tail page) — `ctx.remote` cast once at
+     *   session model catalog) — `ctx.remote` cast once at
      *   the mount boundary.
      * @param rpc - the connection's generic RPC caller for the host gateway
      *   channel (`/api`), injected from the connection handle.
@@ -468,27 +352,10 @@ export declare class FallbacksSettingsController {
      */
     loadCatalog(): Promise<void>;
     /**
-     * Record the current session the status block reads (spec §2.5 D-5). Once
-     * the block has been read once, its summary follows session switches
-     * immediately; an idle block only records the id — the section's mount
-     * effect performs the first read.
-     * @param sessionId - the session whose history is summarized; undefined
-     *   (no current session) resolves to the empty state.
+     * Record the current session the conversation switch strip follows
+     * (switch events ride the session stream — no client history read).
      */
     setCurrentSession(sessionId: SessionId | undefined): void;
-    /**
-     * Read the recent-switch summary for the current session (spec §2.5 D-5):
-     * one tail page (`maxMessages` = {@link SWITCHES_HISTORY_PAGE}) read from
-     * the `session/follow` opening snapshot — the host has no unary tail-page
-     * read (`session/page` needs the follow opening frame's cursor), so the
-     * stream is cancelled right after its first frame —
-     * `fallbacks/switch` events extracted newest-first capped at
-     * {@link RECENT_SWITCH_LIMIT}. No current session → honest empty ready
-     * state (no RPC); a read failure lands `switchesStatus: 'error'` and never
-     * touches the settings state (the form keeps editing/saving normally).
-     * @returns nothing; {@link store} carries success or failure.
-     */
-    loadSwitches(): Promise<void>;
     /**
      * Persist the full edited configuration through the gateway channel
      * (`/api/fallbacks/set`). The full config is sent as a MERGE patch (guide
@@ -501,19 +368,6 @@ export declare class FallbacksSettingsController {
      * @param next - the complete edited configuration.
      */
     save(next: FallbacksConfig): Promise<void>;
-    /**
-     * Explicit "sync to host allowlist" write (plan
-     * role-chain-allowlist-visibility T2): the gateway endpoint merges the
-     * CURRENT allowlist with this plugin's exact chain routes plus the virtual
-     * `FallbacksChain/Auto` route and writes only `allowedModels`. The button
-     * click is the ONLY trigger — the store never syncs on its own.
-     * @returns true when the write landed (the card then reads the fresh
-     *   snapshot from the store); false on a refused/failed call, leaving the
-     *   last accepted state untouched. A response discarded by the write
-     *   generation guard is still a landed write — dispose() is the only
-     *   invalidator, so it must not report failure.
-     */
-    syncAllowlist(): Promise<boolean>;
     /**
      * Reset to composition defaults through the gateway channel
      * (`/api/fallbacks/reset` — the fallbacks-specific third method; the host
@@ -524,10 +378,10 @@ export declare class FallbacksSettingsController {
     /** Stop in-flight responses from publishing after plugin disposal. */
     dispose(): void;
     /**
-     * Unpack one write response (set / reset / sync-allowlist) into the store
-     * snapshot. The additive fields (legacyKeys §9, seeds §9.4, subagentPolicy
-     * D4) follow the W-1/F-1 rule: absent on the wire keeps the last accepted
-     * value — only a `get` may settle server truth.
+     * Unpack one write response (set / reset) into the store snapshot. The
+     * additive fields (legacyKeys §9, seeds §9.4) follow the W-1/F-1 rule:
+     * absent on the wire keeps the last accepted value — only a `get` may
+     * settle server truth.
      */
     private acceptWire;
     /**
@@ -561,11 +415,3 @@ export declare function refreshFallbacksIfLoaded(controller: FallbacksSettingsCo
  * @param controller - the fallbacks settings controller.
  */
 export declare function refreshCatalogIfLoaded(controller: FallbacksSettingsController): void;
-/**
- * Refetch the recent-switch summary after `settings/document-updated`
- * (fallbacks ns) / `connection/reset` only when the status block has already
- * been read once
- * (the switches twin of {@link refreshFallbacksIfLoaded}).
- * @param controller - the fallbacks settings controller.
- */
-export declare function refreshSwitchesIfLoaded(controller: FallbacksSettingsController): void;

package/dist/client/index.d.ts

@@ -29,7 +29,6 @@
  */
 import type { Context as ClientContext } from '@deepseek-ai/cordis';
 export type { FallbacksCardInjected, FallbacksCardProps } from './FallbacksCard.tsx';
-export type { GeneralFallbacksRowInjected, GeneralFallbacksRowProps } from './GeneralFallbacksRow.tsx';
 export type { ConversationFallbackSwitchProps, FallbacksSwitchChatData, } from './ConversationFallbackSwitch.tsx';
 export type { SubagentRoleBadgeProps } from './SubagentRoleBadge.tsx';
 export type { FallbacksSettingsState } from './fallbacks-store.ts';