Skip to content

Letter2025/dsh-model-failover

20Last commit Aug 14, 2026

dsh-model-failover DSH plugin

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.

How to install the dsh-model-failover DSH plugin

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

Copying does not run this command. Review the repository and version before use.

Data source

Snapshot date: Aug 15, 2026

manifest-valid

What the dsh-model-failover DSH plugin can do

  • 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.

Where the dsh-model-failover DSH plugin fits

  • 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 the dsh-model-failover DSH plugin is for

  • DeepSeek Harness operators configuring multiple model routes.
  • Developers building DSH workflows that need model-request failover behavior.

dsh-model-failover DSH plugin 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.

Objective checks

These signals come from public metadata scans. They are not a security certification.

  • 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
  • license not declared

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

    low
  • package manifest available

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

    info
  • source available

    Public GitHub source metadata is available for this registry snapshot.

    info

dsh-model-failover DSH plugin alternatives

dsh-model-failover DSH plugin questions

What is the dsh-model-failover DSH plugin?

dsh-model-failover is a project included in the current DSH plugin snapshot. This page organizes repository metadata and reviewed notes, but you should still inspect the upstream repository before running it.

How do I install the dsh-model-failover DSH plugin?

The page shows the install command captured from the source record. Copying does not run it, so confirm the package, profile, and version against upstream documentation first.

Which DSH profile does dsh-model-failover use?

The snapshot records web as the dsh-model-failover profile. DSH conventions can change quickly, so verify the manifest and README before installation.

Is dsh-model-failover compatible with the current DSH release?

The source data does not include a verified compatibility matrix. Check recent commits, releases, and DSH breaking changes, then test in a profile you can roll back.

What should I do if dsh-model-failover fails to load?

Check the install command, selected profile, dependency logs, and Cordis startup output first. Keep the exact error string, then compare it with this site's fix pages and upstream issues.

What are the closest alternatives to dsh-model-failover?

Related plugins on this page come from the current snapshot and are only candidates. Compare capabilities, maintenance activity, installation method, and limitations before choosing one.