dsh-failover-continue
English | Русский
English
Unified auto-continue + model failover plugin for DeepSeek Harness (DSH).
One plugin owns the whole resilience loop instead of splitting it across an
auto-continue plugin and a failover plugin:
- Ordered fallback chain with two-level circuit breaking (model + provider).
The first failure opens the route (threshold 1); the next request leaves the
dead route. A provider that reports
Retry-After (e.g. gateways answering
"retry in 3594s") is honoured instead of re-hammered after 60s.
- AUTH and BILLING switch the route instead of killing the session. A
401/403 or a billing/check-in 402 opens the failed route and the turn
continues on the next healthy fallback. Stop-loss fires only when the whole
chain is open.
CONTEXT_WINDOW_EXCEEDED is request-scoped: the oversized request moves
to a larger-context candidate without parking the healthy route.- Automatic continuation of failed turns: live firehose + cold-session scan
(survives host restarts: orphaned turns wake up and continue), adaptive
backoff, loop guard.
- Safety valves:
maxSwitchesPerStep caps walk loops; maxConsecutive
bounds continue storms.
- Session-log safety by construction: the plugin never writes custom event
types (the
Session.append API cannot carry the ignorable envelope
marker). Switch notices go out as ordinary user/message rows; state lives
in the status route and the settings namespace.
- Bilingual RU/EN settings card: every string via locale dictionaries
(the plugin registers a
ru language pack — DSH ships only zh/en).
Install
dsh plugin --profile web add link:/path/to/dsh-failover-continue
# or: dsh plugin --profile web add github:<you>/dsh-failover-continue
Disable the plugins it replaces (exactly one owner per waterfall), migrate
settings, restart the host:
node scripts/migrate-settings.mjs --apply
# ~/.dsh/profiles/web/cordis.patch.yml
- id: auto-continue
disabled: true
- id: model-failover
disabled: true
- id: model-failover-settings
disabled: true
Configuration
Single failover-continue: namespace in settings.yaml, fully editable from
Settings → Plugins → Failover + auto-continue: ordered fallbacks
(provider/model), tripCodes, thresholds/cooldowns, continue text/timing,
backoff, loop guard. See .kiro/specs/failover-continue/ (design repo) for
the full requirements/design/tasks.
Verify
npm run typecheck && npm test && npm run build
License
MIT — see LICENSE. Donor code and ideas are attributed in
NOTICE.md.
Russian
Единый плагин автопродолжения + фолбэка моделей для DeepSeek Harness.
Один плагин владеет всем контуром устойчивости вместо связки
«auto-continue + model-failover»:
- Упорядоченная цепочка резервов с двухуровневым предохранителем
(маршрут + провайдер). Первое падение открывает маршрут (порог 1);
следующий запрос уходит с мёртвого маршрута.
Retry-After от провайдера
(например «retry in 3594s») соблюдается, а не забивается повторами.
- AUTH и BILLING переключают, а не хоронят. 401/403 или биллинговый 402
открывают маршрут, терн продолжается на следующем живом резерве. Стоп — лишь
когда открыта вся цепочка.
CONTEXT_WINDOW_EXCEEDED — request-scoped: тяжёлый запрос уходит на
модель с большим окном без парковки здорового маршрута.- Автопродолжение упавших тернов: живой поток событий + скан холодных
сессий (переживает рестарты хоста: сессии-«сироты» будятся и продолжаются),
адаптивный бэкофф, сторож зацикливаний.
- Предохранители:
maxSwitchesPerStep режет петли ходьбы по цепочке,
maxConsecutive — штормы продолжений.
- Безопасность лога по построению: своих типов событий не пишем вовсе
(
Session.append не умеет маркер ignorable). Уведомления — обычными
user/message; состояние — в статус-роуте и неймспейсе настроек.
- Двуязычная карточка RU/EN: все строки через словари (плагин
регистрирует языковой пакет
ru — в DSH из коробки только zh/en).
Установка
dsh plugin --profile web add link:/path/to/dsh-failover-continue
# или: dsh plugin --profile web add github:<you>/dsh-failover-continue
Отключить заменяемые плагины (ровно один владелец на waterfall), смигрировать
настройки, перезапустить хост (см. выше). Миграция настроек:
node scripts/migrate-settings.mjs --apply
Проверка
npm run typecheck && npm test && npm run build
Лицензия
MIT — см. LICENSE. Доноры кода и идей — в NOTICE.md.
