dsh-model-failover
A DeepSeek Harness circuit-breaker plugin that fails over model requests to configured fallback routes after repeated failures.
Install
$ dsh plugin --profile web add dsh-model-failoverPlugin Overview & Capabilities
AI-assisted organization based on the public repository snapshot. The content must be grounded in source evidence and does not replace compatibility or security verification.
Key Capabilities
- Opens a circuit for a provider/model route after repeated configured failures within a burst window.
- Opens a provider-level circuit when multiple distinct models from that provider are open.
- Routes requests to the first healthy route in an ordered fallback list.
- Probes open model circuits after cooldown and closes them after a successful probe.
- Works alongside the bundled llm-retry policy by observing failures that escape retry handling.
- Emits typed circuit, failover, and probe events.
- Bundles the configure-model-failover skill when the skills service is available.
Useful For
- Keep agent conversations running when a primary model is rate-limited, unavailable, times out, or returns other configured transient errors.
- Configure alternate providers or models for resilience during model or provider outages.
- Notify users and observe route changes through plugin events.
Who It Fits
- DeepSeek Harness operators configuring multiple model routes.
- Developers building DSH workflows that need model-request failover behavior.
Documented Limitations
- Circuit state is process-local, stored in memory, and resets when the plugin reloads.
- Only main agent-loop calls covered by agent/request are routed; auxiliary calls such as session-title, compaction, and hand-built ctx.llm.stream calls are excluded.
- With retryPolicy.mode set to 'always', llm-retry does not delegate failures to the breaker, leaving failover inactive by design.
- Fallbacks with smaller context windows can still return CONTEXT_WINDOW_EXCEEDED.
- Provider-level circuits recover on cooldown expiry; the plugin does not probe provider circuits.
DSH Compatibility
Version-specific runtime evidence collected by DSH Plugin. A missing result means we have not tested that combination yet.
Security Signals
Objective signals discovered from package metadata and source inspection. These are not a guarantee that a plugin is safe.
package.json declares 0 runtime, 18 development, 6 peer, and 0 optional dependencies.
package.json declares DSH bundle metadata.
GitHub reports the repository license as MIT.
A root package.json was captured and can be inspected by the registry.
Public GitHub source metadata is available for this registry snapshot.
Source & Registry Notes
Public provenance, Registry classification, and the latest source check for this entry, kept separate from runtime verification.
- Source repository
- Letter2025/dsh-model-failover
- Registry source
- GitHub · dsh-plugin topic
- Registry classification
- Plugin
- Source checked
- b971998 · 2026-09-14
This project is independently indexed from public source information. DSH Plugin is not affiliated with DeepSeek or the plugin author. Always check the author repository before installation.
Repository Activity
- GitHub stars
- 4GitHub stars
- Forks
- 0
- Open issues
- 1
- Last commit
- 2026-09-08
- Last release
- No release detected
Related DSH Plugins
Ranked by overlapping capabilities, use cases, plugin type, categories, and DSH profile.
Persistent multi-model Agent teams and bounded DAG workflows with GUI controls for DeepSeek Harness.
View plugin →Second-model AI auto-review for DeepSeek Harness approval requests with fail-closed safety and session audit.
View plugin →Native SQLite-backed local project taskboard plugin and UI for DeepSeek Harness with Agent claim and review flows.
View plugin →Sandbox-first automatic permission policy and intelligent risk classification for DeepSeek Harness.
View plugin →