@wy35002/dsh-model-fallback-ui 0.1.2-alpha.3

package/lib/index.js

@@ -0,0 +1,6 @@
+//#region lib/types/index.js
+/** Host loader entry for the browser implementation exported from `./client`. */
+/** Host plugin body — no host-side behavior for the model-fallback settings panel. */
+function apply() {}
+//#endregion
+export { apply };

package/lib/invariant.js

@@ -0,0 +1,20 @@
+//#region lib/types/invariant.js
+/**
+* Package-owned invariant companion for `@deepseek-ai/dsh-client-ui-model-fallback`.
+* @module @deepseek-ai/dsh-client-ui-model-fallback/invariant
+*/
+const PACKAGE_NAME = "@deepseek-ai/dsh-client-ui-model-fallback";
+/** Cordis companion plugin name. */
+const name = "client-ui-model-fallback-invariant";
+/** Service required before the companion can reserve package ownership. */
+const inject = ["invariants"];
+/**
+* No runtime invariant: a nav-entry-only section plugin that renders a fixed
+* content column and edits the `model-fallback` settings namespace through the
+* standard settings transport; it emits no cordis events and owns no cross-plugin
+* mutable relation beyond that namespace.
+*/
+const install = () => {};
+const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
+//#endregion
+export { apply, inject, name };

package/lib/types/client/ModelFallbackSection.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Model-fallback settings section. Two modes resolved from the `model-fallback`
+ * settings namespace:
+ *
+ * - Auto (default): the plugin auto-discovers free models and tries them first
+ *   before any paid model. The panel exposes free-model overrides and a
+ *   per-provider "trust whole provider (unknown = free)" list.
+ * - Manual: an explicit, ordered fallback chain (shown only when the chain is
+ *   non-empty).
+ *
+ * Edits are local until Save writes through the settings transport with
+ * revision fencing; Revert reloads the current namespace.
+ */
+import { type ReactNode } from 'react';
+import type { InjectFace, PropsRenderSlots } from '@deepseek-ai/dsh-client-ui-slots';
+import type { ModelFallbackActions, ModelFallbackStore } from './store.ts';
+import type { en } from './locales.ts';
+export interface ModelFallbackSectionInjected {
+    controller: ModelFallbackStore;
+    hooks: {
+        snapshot: ModelFallbackStore['store'];
+    };
+    actions: ModelFallbackActions;
+    t: (key: keyof typeof en) => string;
+}
+type ModelFallbackChildSlots = never;
+type ModelFallbackProps = Partial<InjectFace<ModelFallbackSectionInjected>> & PropsRenderSlots<ModelFallbackChildSlots>;
+export declare function ModelFallbackSection(props: ModelFallbackProps): ReactNode;
+export {};
+//# sourceMappingURL=ModelFallbackSection.d.ts.map

package/lib/types/client/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Model-fallback settings panel, browser half: registers a settings section
+ * that edits the `model-fallback` namespace (fallback chain + switching
+ * policy). Discovery is limited to registered providers over the remote llm
+ * namespace; model ids are typed by the user.
+ */
+import type { Context as ClientContext } from '@deepseek-ai/cordis';
+import { type ModelFallbackKey } from './locales.ts';
+export type { ModelFallbackSectionInjected } from './ModelFallbackSection.tsx';
+export type { ModelFallbackKey } from './locales.ts';
+export type { ChainEntry, FallbackPolicy, ModelFallbackActions, ModelFallbackSnapshot } from './store.ts';
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        /** Model-fallback settings section copy. */
+        'model.fallback': ModelFallbackKey;
+    }
+}
+export declare const inject: string[];
+export declare function apply(ctx: ClientContext): void;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/client/locales.d.ts

@@ -0,0 +1,60 @@
+/** Copy dictionaries for the model-fallback settings section. */
+export declare const en: {
+    readonly nav: "Model fallback";
+    readonly title: "Model fallback";
+    readonly intro: "When the current model is rate-limited or out of quota the plugin auto-switches: free models are tried first (discovered automatically), then any paid model only if your policy allows. Override which models count as free, or trust a whole provider.";
+    readonly modeLabel: "Mode";
+    readonly modeAuto: "Auto (discovered free pool, fail-closed)";
+    readonly modeManual: "Manual (explicit chain)";
+    readonly chainLabel: "Fallback chain";
+    readonly chainEmpty: "No chain configured. Add entries below to switch to explicit chain mode; otherwise the plugin runs in auto mode.";
+    readonly chainHelp: "Explicit, ordered chain. Only models you list here are tried, in this order.";
+    readonly pos: "Order";
+    readonly provider: "Provider";
+    readonly model: "Model";
+    readonly modelPlaceholder: "Select a model";
+    readonly modelHelp: "Enter a model id. Use the Models settings page or the model-fallback-discover tool to see what each provider offers.";
+    readonly kind: "Tier";
+    readonly kindPrimary: "Primary";
+    readonly kindFree: "Free";
+    readonly kindPaid: "Paid";
+    readonly addEntry: "Add entry";
+    readonly removeEntry: "Remove";
+    readonly moveUp: "Move up";
+    readonly moveDown: "Move down";
+    readonly freeLabel: "Free-model overrides";
+    readonly freeEmpty: "No overrides. The plugin uses its built-in community free-model table.";
+    readonly freeHelp: "Pick a provider, then load and click its configured models to mark them free beyond the built-in table.";
+    readonly freeProvider: "Provider";
+    readonly addFree: "Add";
+    readonly loadModels: "Load models";
+    readonly loadingModels: "Loading…";
+    readonly modelsEmpty: "This provider reports no models.";
+    readonly modelPickerHelp: "Click a model to add it as free.";
+    readonly modelAdded: "Added";
+    readonly unknownFreeLabel: "Trust whole provider (treat unknown models as free)";
+    readonly unknownFreeEmpty: "None — unknown models are treated as paid (fail-closed).";
+    readonly unknownFreeHelp: "Check a provider you trust entirely; its unrecognized models are counted as free.";
+    readonly policyLabel: "Switching policy";
+    readonly paidPolicy: "Switching into a paid model";
+    readonly paidPolicyAsk: "Ask me each time";
+    readonly paidPolicyAuto: "Switch automatically";
+    readonly paidPolicyNever: "Never switch to paid";
+    readonly switchCodesLabel: "Fail codes that trigger a switch";
+    readonly switchCodesHelp: "Space-separated. RATE_LIMIT and QUOTA are the defaults.";
+    readonly skipQuota: "On quota exhaustion, skip the rest of the same provider";
+    readonly save: "Save";
+    readonly saving: "Saving…";
+    readonly saved: "Saved";
+    readonly revert: "Revert";
+    readonly readOnly: "The settings document is read-only in this deployment.";
+    readonly loadFailed: "Could not load the fallback settings";
+    readonly conflict: "The settings changed while you were editing. Reopen to see the current values.";
+    readonly writeError: "Could not save the settings";
+    readonly providerEmpty: "No registered providers";
+};
+export type ModelFallbackKey = keyof typeof en;
+export declare const zh: {
+    [Key in ModelFallbackKey]: string;
+};
+//# sourceMappingURL=locales.d.ts.map

package/lib/types/client/store.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Page store for the model-fallback settings section. It mirrors the
+ * `model-fallback` settings namespace into an editable draft (chain, free-model
+ * overrides, per-provider "unknown is free" trust, and switching policy), joins
+ * registered providers for the dropdowns, and serializes saves through the
+ * settings transport with revision fencing.
+ */
+import type { Context as ClientContext } from '@deepseek-ai/cordis';
+import { type SnapshotStore } from '@deepseek-ai/dsh-client-store';
+import type { LlmModelInfo, LlmProviderInfo } from '@deepseek-ai/dsh-api-remotes/client';
+import type { SettingsScope } from '@deepseek-ai/dsh-client-ui-settings/client';
+/** Must match the host plugin's DEFAULT_SWITCHABLE_CODES. */
+export declare const DEFAULT_SWITCHABLE_CODES: readonly string[];
+export interface ChainEntry {
+    provider: string;
+    model: string;
+    kind: 'primary' | 'free' | 'paid';
+}
+export interface ModelOverrideGroup {
+    provider: string;
+    ids: string[];
+}
+export interface FallbackPolicy {
+    paidSwitchPolicy: 'ask' | 'auto' | 'never';
+    skipProviderOnQuota: boolean;
+}
+/** Raw namespace value shape the client decodes before it reaches the store. */
+export interface ModelFallbackNamespaceValue {
+    chain?: ChainEntry[];
+    paidSwitchPolicy?: string;
+    skipProviderOnQuota?: boolean;
+    switchableCodes?: string[];
+    freeModelIds?: ModelOverrideGroup[];
+    paidModelIds?: ModelOverrideGroup[];
+    unknownFreeProviders?: string[];
+}
+export interface ModelFallbackSnapshot {
+    status: 'idle' | 'loading' | 'ready' | 'error';
+    error: string | null;
+    writable: boolean;
+    revision: number | undefined;
+    chain: ChainEntry[];
+    policy: FallbackPolicy;
+    switchableCodes: string[];
+    freeModelIds: ModelOverrideGroup[];
+    paidModelIds: ModelOverrideGroup[];
+    unknownFreeProviders: string[];
+    providers: LlmProviderInfo[];
+    saving: boolean;
+    saveError: string | null;
+    saved: boolean | null;
+}
+export interface ModelFallbackActions {
+    load: () => Promise<void>;
+    setChain: (chain: ChainEntry[]) => void;
+    setEntry: (index: number, entry: ChainEntry) => void;
+    addEntry: () => void;
+    removeEntry: (index: number) => void;
+    moveEntry: (from: number, to: number) => void;
+    setPolicy: (policy: Partial<FallbackPolicy>) => void;
+    setSwitchableCodes: (codes: string[]) => void;
+    addFreeModel: (provider: string, modelId: string) => void;
+    removeFreeModel: (groupIndex: number, modelIndex: number) => void;
+    addPaidModel: (provider: string, modelId: string) => void;
+    removePaidModel: (groupIndex: number, modelIndex: number) => void;
+    toggleUnknownFreeProvider: (provider: string) => void;
+    fetchProviderModels: (provider: string) => Promise<LlmModelInfo[]>;
+    save: () => Promise<'ok' | 'conflict' | 'error'>;
+    revert: () => void;
+}
+export declare class ModelFallbackStore {
+    private readonly ctx;
+    private readonly scope;
+    readonly store: SnapshotStore<ModelFallbackSnapshot>;
+    private disposers;
+    constructor(ctx: ClientContext, scope: SettingsScope<ModelFallbackNamespaceValue>);
+    private refetchFromScope;
+    load(): Promise<void>;
+    private fetchProviders;
+    readonly actions: ModelFallbackActions;
+    dispose(): void;
+}
+export declare function createModelFallbackStore(ctx: ClientContext, scope: SettingsScope<ModelFallbackNamespaceValue>): ModelFallbackStore;
+//# sourceMappingURL=store.d.ts.map

package/lib/types/index.d.ts

@@ -0,0 +1,4 @@
+/** Host loader entry for the browser implementation exported from `./client`. */
+/** Host plugin body — no host-side behavior for the model-fallback settings panel. */
+export declare function apply(): void;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/invariant.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Package-owned invariant companion for `@deepseek-ai/dsh-client-ui-model-fallback`.
+ * @module @deepseek-ai/dsh-client-ui-model-fallback/invariant
+ */
+import type { Context } from '@deepseek-ai/cordis';
+/** Cordis companion plugin name. */
+export declare const name = "client-ui-model-fallback-invariant";
+/** Service required before the companion can reserve package ownership. */
+export declare const inject: string[];
+export declare const apply: (ctx: Context) => Promise<() => void>;
+//# sourceMappingURL=invariant.d.ts.map

package/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "@wy35002/dsh-model-fallback-ui",
+  "description": "Click-to-label settings panel for the model-fallback auto-switch chain: label registered models free/paid and build the fallback order",
+  "version": "0.1.2-alpha.3",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/deepseek-ai/deepseek-harness.git",
+    "directory": "packages/client/ui-model-fallback"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./invariant": {
+      "types": "./lib/types/invariant.d.ts",
+      "default": "./lib/invariant.js"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-ui-settings",
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-store",
+        "@deepseek-ai/dsh-api-remotes"
+      ],
+      "platform": "web"
+    }
+  },
+  "scripts": {
+    "bundle": "tsdown",
+    "watch": "tsdown --watch"
+  },
+  "license": "MIT",
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.2"
+  },
+  "devDependencies": {
+    "@deepseek-ai/dsh-api-remotes": "workspace:^",
+    "@deepseek-ai/dsh-client-locale": "workspace:^",
+    "@deepseek-ai/dsh-client-store": "workspace:^",
+    "@deepseek-ai/dsh-client-ui-primitives": "workspace:^",
+    "@deepseek-ai/dsh-client-ui-renderer": "workspace:^",
+    "@deepseek-ai/dsh-client-ui-settings": "workspace:^",
+    "@deepseek-ai/dsh-client-ui-slots": "workspace:^",
+    "@deepseek-ai/dsh-invariants": "workspace:^",
+    "@deepseek-ai/dsh-util-values": "workspace:^",
+    "@types/react": "~18.3.1",
+    "@deepseek-ai/cordis": "workspace:^",
+    "react": "^18.2.0"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/invariant.js",
+    "lib/client.js",
+    "lib/types/**/*.d.ts",
+    "cordis.patch.yml"
+  ]
+}