DeepSeek Harness Plugins
DeepSeek Harness PluginManifest Valid

dsh-model-failover

A DeepSeek Harness circuit-breaker plugin that fails over model requests to configured fallback routes after repeated failures.

Terminal & TUIDeveloper ToolsSecurity & PolicySkills & Workflows

Install

$ dsh plugin --profile web add dsh-model-failover

Repository Intelligence

AI-assisted, source-grounded explanation based on the public repository snapshot. It does not replace compatibility or security verification.

source-grounded
dsh-model-failover is an installable DeepSeek Harness plugin that monitors agent-loop model request failures, opens model or provider-level circuits, and routes subsequent requests to healthy configured fallbacks. It includes a bundled skill for configuring fallback models.

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.

Not tested yetNo runtime compatibility tests have been published yet.

Security Signals

Objective signals discovered from package metadata and source inspection. These are not a guarantee that a plugin is safe.

Dependency Counts

package.json declares 0 runtime, 0 development, 6 peer, and 0 optional dependencies.

info
Dsh Bundle Declared

package.json declares DSH bundle metadata.

info
Package Manifest Available

A root package.json was captured and can be inspected by the registry.

info
License Not Declared

GitHub did not report an SPDX license for this repository snapshot.

low
Source Available

Public GitHub source metadata is available for this registry snapshot.

info
Dependency Counts

package.json declares 0 runtime, 0 development, 6 peer, and 0 optional dependencies.

info
Dsh Bundle Declared

package.json declares DSH bundle metadata.

info
Package Manifest Available

A root package.json was captured and can be inspected by the registry.

info
License Not Declared

GitHub did not report an SPDX license for this repository snapshot.

low
Source Available

Public GitHub source metadata is available for this registry snapshot.

info

Source & Registry Notes

Traceable source and registry metadata for this entry, kept separate from runtime verification.

Source repository
Letter2025/dsh-model-failover
Registry source
Public GitHub repository
Source snapshot
aa40854d8ec3
Artifact type
plugin
AI enrichment
gpt-5.6-terra · 2026-08-14
Prompt version
dsh-plugin-enrichment-v3

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
1
Forks
0
Open issues
0
Last commit
2026-08-14
Last release