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

package/README.md

@@ -0,0 +1,46 @@
+# ui-model-fallback
+
+Client settings panel for the model-fallback auto-switch plugin. It composes
+into the existing settings surface as the **Model fallback** section and edits
+the `model-fallback` settings namespace that the host plugin reads on every
+turn.
+
+## What it does
+
+Two modes, resolved automatically from the namespace:
+
+- **Auto (default).** No chain configured. The panel exposes *free-model
+  overrides* (mark specific model ids free, beyond the plugin's built-in
+  community table) and a *trust-whole-provider* list (every unknown model of a
+  checked provider counts as free).
+- **Manual.** An explicit, ordered fallback chain (provider / model id /
+  tier), with reorder, add, and remove. Shown only when the chain is
+  non-empty.
+
+It also exposes the switching policy (`paidSwitchPolicy`: `ask` / `auto` /
+`never`), the quota-skip toggle, and the `switchableCodes` list. The current
+mode is shown at the top of the section.
+
+## Discovery scope
+
+Both the **free-model overrides** row and each **manual chain entry** offer a
+**Load models** button: pick a provider, load its actually-configured models
+(over the remote `llm` namespace), and click one to select it — no guessing
+ids. The Models settings page or the `model-fallback-discover` tool lists what
+each provider offers.
+
+## Model Experience
+
+Indirectly, through the model-fallback host plugin, which reads the `model-fallback` settings namespace and rebuilds the retry request header on a switchable failure.
+
+#### KV Cache effect
+
+None; this panel neither assembles nor sends a provider request.
+
+## Known Limitations and Deferred Work
+
+- The **Load models** list shows models the user configured for the provider
+  (the `listModels` remote surface); it cannot show the adapter's full
+  universe or models the user never added.
+- Per-session fallback chains are a planned professional-tier feature, not
+  this panel.

package/cordis.patch.yml

@@ -0,0 +1,7 @@
+# Bundle patch: insert the model-fallback settings panel into a profile's layer stack.
+# The client half is additionally auto-discovered through the `dsh.client` manifest
+# in package.json; this row declares the host-side entry point so the Loader can
+# wire the bundle.
+- insert:
+    - id: model-fallback-ui
+      name: '@wy35002/dsh-model-fallback-ui'