@goodandready/dsh-key-rotation 0.8.62 → 0.8.63

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 0.8.63 - 2026-10-16
+
+### Added
+- **Configurable Switch to Disable Chat Header Status Chip (#493 / GitHub #25)**:
+  - Added `showChatHeaderChip` boolean setting (defaults to `true` for 100% backward compatibility) in `SettingsSchema` and runtime configuration.
+  - Added user-facing toggle in the Settings card ("Chat Header Status Chip" / "聊天头部状态按钮") under rotation settings.
+  - `KeyRotationHeaderChip` (`conversation.session.header.utilities`) dynamically subscribes to settings and checks server health state, cleanly returning `null` when disabled without taking up conversational header toolbar space.
+  - Additive field `showChatHeaderChip` exposed in `/dsh-key-rotation/status` and `/dsh-key-rotation/health`.
+
 ## 0.8.62 - 2026-10-16
 
 ### Added

package/README.md

@@ -378,6 +378,7 @@ dsh-key-rotation:
 | `circuitBreakerOpenMs` | `number` | `30000` | How long the circuit stays open (ms). |
 | `circuitBreakerHalfOpenProbes` | `number` | `1` | Probe requests allowed in half-open state. |
 | `verboseLogging` | `boolean` | `false` | Per-request rotation logs (noisy; off by default). |
+| `showChatHeaderChip` | `boolean` | `true` | Show or hide the pool status button in conversation header toolbar (#25). |
 | `concurrencyLimit` | `number` | `0` (disabled) | Max concurrent in-flight streams per key (0 = unlimited). |
 | `quotaResetWindow` | `object` | `null` | Calendar reset alignment for both provider-reported quota cooldowns and local per-model token budgets (`midnight_utc`, `midnight_pst`, `rolling_24h`). |
 | `cascade` | `array` | `[]` | Fallback provider chain when primary pool is completely exhausted. |

package/README.ru.md

@@ -409,6 +409,7 @@ MIT © [GooDAnDReaDY](https://github.com/GooDAnDReaDY)
 | `circuitBreakerOpenMs` | number | `30000` | Длительность open, мс |
 | `circuitBreakerHalfOpenProbes` | number | `1` | Проб в half-open |
 | `verboseLogging` | boolean | `false` | Подробные логи rotation (шумно) |
+| `showChatHeaderChip` | boolean | `true` | Показывать кнопку статуса пула в шапке чата (#25) |
 
 Status API (v0.8.0): у каждого провайдера `circuit`, в корне ответа `meta.expectedClones` и `meta.notifyQueue`.
 

package/README.zh.md

@@ -378,3 +378,4 @@ MIT © [GooDAnDReaDY](https://github.com/GooDAnDReaDY)
 | `circuitBreakerThreshold` | number | `5` | 连续失败阈值 |
 | `circuitBreakerOpenMs` | number | `30000` | 打开时长 ms |
 | `circuitBreakerHalfOpenProbes` | number | `1` | 半开探测次数 |
+| `showChatHeaderChip` | boolean | `true` | 在会话界面顶部工具栏显示密钥池状态按钮 (#25) |

package/lib/client.js

@@ -224,6 +224,8 @@ window.__ModuleLoader__.load({
       routingStrategySticky: 'Sticky (preserves prompt cache)',
       proactiveGuardLabel: 'Proactive Rate-Limit Guard',
       proactiveGuardHint: 'Pre-emptively pause keys when remaining quota or Retry-After header indicates limit before hitting 429',
+      showChatHeaderChipLabel: 'Chat Header Status Chip',
+      showChatHeaderChipDesc: 'Show pool status chip in conversation header',
       selfHealingLabel: 'Auto-Unbreak Interval (min)',
       selfHealingHint: 'Periodic free model check to revive broken keys (0 to disable)',
       updateCheck: 'Check for updates',
@@ -422,6 +424,8 @@ window.__ModuleLoader__.load({
       routingStrategySticky: '粘性模式 (优先保持提示词缓存)',
       proactiveGuardLabel: '前瞻性限流防护',
       proactiveGuardHint: '当响应中的剩余配额或 Retry-After 头提示即将超限时，预先冷却密钥以防触发 429',
+      showChatHeaderChipLabel: '聊天头部状态按钮',
+      showChatHeaderChipDesc: '在会话界面顶部工具栏显示密钥池状态按钮',
       selfHealingLabel: '自愈检查间隔 (分钟)',
       selfHealingHint: '定期轻量探测以自动恢复损坏密钥 (0 为禁用)',
       updateCheck: '检查更新',
@@ -2596,6 +2600,16 @@ window.__ModuleLoader__.load({
             }),
             h('span', { key: 'label', style: { fontSize: '13px', color: 'var(--dsw-alias-label-secondary)' } }, t('proactiveGuardLabel')),
           ]))
+        ),
+        h('div', { className: 'krot-grid-2', style: { marginTop: '10px' } },
+          field(t('showChatHeaderChipLabel'), h('label', { style: { display: 'flex', alignItems: 'center', gap: '8px', height: '36px', cursor: 'pointer' } }, [
+            h('input', {
+              key: 'input', type: 'checkbox',
+              checked: val.showChatHeaderChip ?? true,
+              onChange: (e) => setField((cur) => ({ ...cur, showChatHeaderChip: e.target.checked })),
+            }),
+            h('span', { key: 'label', style: { fontSize: '13px', color: 'var(--dsw-alias-label-secondary)' } }, t('showChatHeaderChipDesc')),
+          ]))
         )
       );
 
@@ -2886,6 +2900,7 @@ window.__ModuleLoader__.load({
       const t = resolveT(props);
       const [snap, setSnap] = React.useState(null);
       const [open, setOpen] = React.useState(false);
+      const [, setTick] = React.useState(0);
       const ref = React.useRef(null);
 
       React.useEffect(() => {
@@ -2895,7 +2910,7 @@ window.__ModuleLoader__.load({
           fetch('/dsh-key-rotation/health', { headers: { accept: 'application/json' }, credentials: 'same-origin', signal: (typeof AbortSignal !== 'undefined' && typeof AbortSignal.timeout === 'function') ? AbortSignal.timeout(8000) : undefined })
             .then((r) => (r.ok ? r.json() : null))
             .then((d) => { if (alive) setSnap(d); })
-            .catch(() => {});
+            .catch((e) => { void e; });
         };
         load();
         const id = setInterval(load, 5000);
@@ -2908,6 +2923,13 @@ window.__ModuleLoader__.load({
         };
       }, []);
 
+      React.useEffect(() => {
+        if (!props?.settingsSource?.subscribe) return;
+        return props.settingsSource.subscribe(() => {
+          setTick((c) => c + 1);
+        });
+      }, [props?.settingsSource]);
+
       React.useEffect(() => {
         if (!open) return;
         const onDocClick = (e) => {
@@ -2917,6 +2939,16 @@ window.__ModuleLoader__.load({
         return () => document.removeEventListener('click', onDocClick);
       }, [open]);
 
+      let settingsVal = null;
+      try {
+        const sSnap = props?.settingsSource?.getSnapshot?.()?.service?.getSnapshot?.();
+        settingsVal = sSnap?.value;
+      } catch (e) {
+        void e;
+      }
+      if (settingsVal && settingsVal.showChatHeaderChip === false) return null;
+      if (snap && snap.showChatHeaderChip === false) return null;
+
       const poolsObj = (snap && snap.pools) || {};
       const poolEntries = Object.entries(poolsObj);
       const total = poolEntries.reduce((a, [, p]) => a + (p.total || 0), 0);
@@ -2952,7 +2984,6 @@ window.__ModuleLoader__.load({
         ) : null
       );
     }
-
     function apply(ctx) {
       const settingsSource = createSettingsSource(ctx);
       ctx.effect(() => ctx.locale.register(NS, { en, zh }), 'dsh-key-rotation: dictionaries');
@@ -2963,7 +2994,7 @@ window.__ModuleLoader__.load({
         try {
           ctx.slots.inject('conversation.session.header.utilities', () =>
             ctx.slots.register(
-              { name: 'conversation.session.header.utilities', id: 'dsh-key-rotation-header-chip', order: 6, locale: NS },
+              { name: 'conversation.session.header.utilities', id: 'dsh-key-rotation-header-chip', order: 6, locale: NS, inject: () => ({ ctx, settingsSource }) },
               KeyRotationHeaderChip,
             ));
         } catch { /* slot not available in this build */ }

package/lib/index.js

@@ -119,6 +119,7 @@ const SettingsSchema = Schema.object({
   earlyWarningKeyThreshold: Schema.number().default(0.25),
   warnBelowHealthy: Schema.number().default(0),
   latencySloMs: Schema.number().default(0),
+  showChatHeaderChip: Schema.boolean().default(true),
   providers: Schema.array(Schema.object({
     provider: Schema.string().required(),
     keys: Schema.array(Schema.string()).default([]),
@@ -350,6 +351,7 @@ export function apply(ctx, config = {}) {
       proactiveRateLimitGuard: cfg.proactiveRateLimitGuard ?? true,
       selfHealingIntervalMinutes: cfg.selfHealingIntervalMinutes ?? 30,
       routingStrategy: cfg.routingStrategy ?? 'round-robin',
+      showChatHeaderChip: cfg.showChatHeaderChip !== false,
       switchNotifyThrottleMs: cfg.switchNotifyThrottleMs ?? 60000,
       warnBelowHealthy: cfg.warnBelowHealthy ?? 0, latencySloMs: cfg.latencySloMs ?? 0,
       index, pools,

package/lib/ops-status.js

@@ -178,6 +178,7 @@ ctx.effect(() => ctx.webServer.register({
     }
     json(res, 200, sanitizeSnapshot({
       providers,
+      showChatHeaderChip: runtime.showChatHeaderChip !== false,
       // #266/#263 operational extras (additive)
       meta: {
         expectedClones: [...(runtime.expectedClones ?? [])],
@@ -248,7 +249,7 @@ ctx.effect(() => ctx.webServer.register({
       }
     }
     const isDegraded = exhaustedAny || circuitOpenAny;
-    json(res, 200, { status: isDegraded ? 'degraded' : 'ok', pools, exhaustedAny, latency: latencyHistogram.snapshotAll(), quota: typeof quotaStore?.snapshot === 'function' ? quotaStore.snapshot() : null });
+    json(res, 200, { status: isDegraded ? 'degraded' : 'ok', showChatHeaderChip: runtimeH.showChatHeaderChip !== false, pools, exhaustedAny, latency: latencyHistogram.snapshotAll(), quota: typeof quotaStore?.snapshot === 'function' ? quotaStore.snapshot() : null });
   },
 }), 'dsh-key-rotation: health');
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goodandready/dsh-key-rotation",
-  "version": "0.8.62",
+  "version": "0.8.63",
   "packageManager": "pnpm@10.33.2",
   "description": "Per-provider API key rotation for DeepSeek Harness: a key pool per provider, auto-created clone routes, and switching to the next key on quota/rate-limit errors. Includes a Settings section (Key Rotation) to edit the key pools, cooldown and switch codes.",
   "keywords": [