@goodandready/dsh-key-rotation 0.8.87 → 0.8.89

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## 0.8.89 (2026-11-03)
+
+### Interactive Header Chip UI & In-Chat Key Controls (Block 16 Release)
+- **Interactive Header Chip Component (Issue #577)**: Enhanced `KeyRotationHeaderChip` (`lib/client-src/60-header-chip.js`) into a rich, interactive control center directly in the DeepSeek Harness chat header.
+- **In-Chat Key Pinning & Selection**: Added instant dropdown selection to pin (`pinnedRef`) any key in the pool or restore `Auto (Round-robin)` rotation without opening the full settings page.
+- **Prompt Cache & Health Badges**: Displays live prompt cache hit counters (`⚡ {promptCacheHits}`) and active/pinned key tails (`...tail`) with real-time health indicator status.
+- **Quick-Action API Pinning Support**: Extended `/dsh-key-rotation/quick-action` route with `action: 'pin'` and audit event emission (`KEY_PINNED` / `KEY_UNPINNED`).
+- **Detailed Health Endpoint**: Enriched `/dsh-key-rotation/health` to expose pool key manifests, individual key statuses (`active`, `pinned`, `paused`, `cooling`), and prompt cache hit statistics.
+
+## 0.8.88 (2026-11-03)
+
+### Subagent Concurrency Partitions & Task Isolation (Block 15 Release)
+- **Subagent Partitions Module (Issue #575)**: Introduced `src/subagent-partitions.js` to detect child tasks and background subagents (`extractSubagentContext`) and partition pool capacity (`partitionPoolKeys`).
+- **Primary Chat Immunity**: Protects main user conversations from rate limit spikes and concurrency starvation caused by parallel background tasks by reserving dedicated subagent keys (`subagentReservedKeysCount`) or applying isolated partitioning (`subagentPartitionStrategy: 'isolated' | 'shared-burst'`).
+- **Per-Key Subagent Concurrency Caps**: Implemented `subagentMaxConcurrencyPerKey` (default: 2) to cap parallel subagent calls per key, preventing sudden RPM/TPM exhaustion.
+- **Config & Schemastery Support**: Added `subagentPartitionsEnabled`, `subagentReservedKeysCount`, `subagentPartitionStrategy`, and `subagentMaxConcurrencyPerKey` across Schemastery configuration, pool builders, and TypeScript types.
+
 ## 0.8.87 (2026-11-03)
 
 ### Cache-Affinity Router for Hot Prompt Cache (Block 14 Release)

package/lib/client-src/10-locales.js

@@ -245,6 +245,11 @@
       quickResetTitle: 'Reset cooldowns and circuit breaker for active provider',
       quickPause: 'Pause',
       quickPauseTitle: 'Pause or resume active key',
+      quickPin: 'Pin',
+      quickPinTitle: 'Pin specific key or select Auto round-robin',
+      quickAuto: 'Auto (Round-robin)',
+      cacheHits: 'Cache: {n}',
+      pinnedBadge: 'pinned',
       exportConfig: 'Export Pools',
       importConfig: 'Import Pools',
       exportSafe: 'Masked (Safe for sharing)',
@@ -518,6 +523,11 @@
       quickResetTitle: '重置当前提供商的冷却时间与断路器',
       quickPause: '暂停',
       quickPauseTitle: '暂停或恢复当前正在使用的密钥',
+      quickPin: '固定',
+      quickPinTitle: '固定指定密钥或设为自动轮换',
+      quickAuto: '自动轮换',
+      cacheHits: '缓存: {n}',
+      pinnedBadge: '已固定',
       exportConfig: '导出密钥池',
       importConfig: '导入密钥池',
       exportSafe: '脱敏导出 (安全分享)',

package/lib/client-src/60-header-chip.js

@@ -1,5 +1,5 @@
-    // (issue 201, #499) header chip: one dot + counts for all pools. Green = all healthy,
-    // amber = some keys cooling, red = a pool fully exhausted. Click opens quick actions popover.
+    // (issue 201, #499, #577) header chip: one dot + counts for all pools. Green = all healthy,
+    // amber = some keys cooling, red = a pool fully exhausted. Click opens interactive quick actions popover.
     function KeyRotationHeaderChip(props) {
       const t = resolveT(props);
       const [snap, setSnap] = React.useState(null);
@@ -93,46 +93,101 @@
             <span style={{ fontSize: '9px', opacity: 0.6 }}>{open ? '▲' : '▼'}</span>
           </button>
           {open ? (
-            <div className="krot-popover" style={{ minWidth: '220px' }}>
-              <div className="krot-pop-title">{t('headerPoolsTitle')}</div>
+            <div className="krot-popover" style={{ minWidth: '260px' }}>
+              <div className="krot-pop-title" style={{ display: 'flex', justifyContent: 'space-between', alignItems: 'center' }}>
+                <span>{t('headerPoolsTitle')}</span>
+                {busy ? <span style={{ fontSize: '11px', opacity: 0.7 }}>...</span> : null}
+              </div>
               {!poolEntries.length ? (
                 <div style={{ fontSize: '12px', color: 'var(--dsw-alias-label-tertiary)' }}>{t('noActivePools')}</div>
               ) : null}
               {poolEntries.map(([name, p]) => {
                 const c = p.exhausted ? 'var(--dsw-alias-state-error-primary)' : (p.healthy < p.total ? 'var(--dsw-alias-state-warn-primary)' : 'var(--dsw-alias-state-success-primary)');
                 const provName = p.providerName || name;
-                const tail = p.lastUsedTail;
+                const activeTail = p.lastUsedTail;
+                const pinnedTail = p.pinnedTail;
+                const isPinned = Boolean(p.pinnedRef);
+                const keysList = Array.isArray(p.keys) ? p.keys : [];
+                const cacheHits = p.promptCacheHits || 0;
+
                 return (
-                  <div key={name} className="krot-pop-row" style={{ display: 'flex', flexDirection: 'column', gap: '4px', padding: '6px 0', borderBottom: '1px solid var(--dsw-alias-border-subtle)' }}>
+                  <div key={name} className="krot-pop-row" style={{ display: 'flex', flexDirection: 'column', gap: '5px', padding: '8px 0', borderBottom: '1px solid var(--dsw-alias-border-subtle)' }}>
                     <div style={{ display: 'flex', justifyContent: 'space-between', alignItems: 'center' }}>
-                      <div className="krot-pop-name">
+                      <div className="krot-pop-name" style={{ display: 'flex', alignItems: 'center', gap: '6px' }}>
                         <span style={{ width: '7px', height: '7px', borderRadius: '50%', background: c, flex: 'none' }} />
-                        {name}
-                        {tail ? <span style={{ marginLeft: '6px', fontSize: '11px', color: 'var(--dsw-alias-label-tertiary)', fontFeatureSettings: '"tnum"', fontFamily: 'monospace' }}>{`...${tail}`}</span> : null}
+                        <strong style={{ fontSize: '12px' }}>{name}</strong>
                       </div>
-                      <div className="krot-pop-count" style={{ color: c, fontWeight: 600 }}>{`${p.healthy}/${p.total}`}</div>
+                      <div className="krot-pop-count" style={{ color: c, fontWeight: 600, fontSize: '11px' }}>{`${p.healthy}/${p.total}`}</div>
+                    </div>
+
+                    <div style={{ display: 'flex', alignItems: 'center', justifyContent: 'space-between', fontSize: '11px', color: 'var(--dsw-alias-label-tertiary)' }}>
+                      <span style={{ display: 'inline-flex', alignItems: 'center', gap: '4px' }}>
+                        <span>{isPinned ? '📌' : '⚡'}</span>
+                        <span style={{ fontFamily: 'monospace' }}>
+                          {isPinned ? (pinnedTail ? `...${pinnedTail} (pinned)` : p.pinnedRef) : (activeTail ? `...${activeTail}` : 'auto')}
+                        </span>
+                      </span>
+                      {cacheHits > 0 ? (
+                        <span style={{ fontSize: '10px', padding: '1px 4px', borderRadius: '3px', background: 'var(--dsw-alias-bg-subtle, transparent)', color: 'var(--dsw-alias-state-success-primary)' }} title="Prompt cache hits">
+                          {`⚡ ${cacheHits}`}
+                        </span>
+                      ) : null}
                     </div>
-                    <div style={{ display: 'flex', gap: '4px', marginTop: '2px' }}>
+
+                    {keysList.length > 1 ? (
+                      <div style={{ display: 'flex', alignItems: 'center', gap: '6px', marginTop: '2px' }}>
+                        <select
+                          disabled={busy}
+                          value={p.pinnedRef || ''}
+                          onChange={(e) => runAction('pin', provName, e.target.value)}
+                          title={t('quickPinTitle')}
+                          style={{
+                            width: '100%',
+                            fontSize: '11px',
+                            padding: '3px 6px',
+                            borderRadius: '4px',
+                            border: '1px solid var(--dsw-alias-border-subtle)',
+                            background: 'var(--dsw-alias-bg-subtle, transparent)',
+                            color: 'inherit',
+                            fontFamily: 'inherit',
+                            cursor: 'pointer'
+                          }}
+                        >
+                          <option value="">{`🔀 ${t('quickAuto')}`}</option>
+                          {keysList.map((k) => {
+                            const marker = k.pinned ? '📌 ' : (k.active ? '▶ ' : '');
+                            const status = k.paused ? ' [paused]' : (k.cooling ? ' [cooling]' : '');
+                            return (
+                              <option key={k.ref} value={k.ref}>
+                                {`${marker}...${k.tail || k.ref.slice(-4)}${status}`}
+                              </option>
+                            );
+                          })}
+                        </select>
+                      </div>
+                    ) : null}
+
+                    <div style={{ display: 'flex', gap: '4px', marginTop: '3px' }}>
                       <button
                         type="button"
                         disabled={busy}
                         onClick={(e) => { e.stopPropagation(); runAction('skip', provName, p.lastUsed); }}
                         title={t('quickSkipTitle')}
-                        style={{ padding: '2px 6px', fontSize: '11px', borderRadius: '4px', border: '1px solid var(--dsw-alias-border-subtle)', background: 'transparent', cursor: 'pointer', color: 'inherit' }}
+                        style={{ flex: 1, padding: '2px 6px', fontSize: '11px', borderRadius: '4px', border: '1px solid var(--dsw-alias-border-subtle)', background: 'transparent', cursor: 'pointer', color: 'inherit' }}
                       >{`⏭️ ${t('quickSkip')}`}</button>
                       <button
                         type="button"
                         disabled={busy}
                         onClick={(e) => { e.stopPropagation(); runAction('reset', provName, p.lastUsed); }}
                         title={t('quickResetTitle')}
-                        style={{ padding: '2px 6px', fontSize: '11px', borderRadius: '4px', border: '1px solid var(--dsw-alias-border-subtle)', background: 'transparent', cursor: 'pointer', color: 'inherit' }}
+                        style={{ flex: 1, padding: '2px 6px', fontSize: '11px', borderRadius: '4px', border: '1px solid var(--dsw-alias-border-subtle)', background: 'transparent', cursor: 'pointer', color: 'inherit' }}
                       >{`🔄 ${t('quickReset')}`}</button>
                       <button
                         type="button"
                         disabled={busy || !p.lastUsed}
                         onClick={(e) => { e.stopPropagation(); runAction('pause', provName, p.lastUsed); }}
                         title={t('quickPauseTitle')}
-                        style={{ padding: '2px 6px', fontSize: '11px', borderRadius: '4px', border: '1px solid var(--dsw-alias-border-subtle)', background: 'transparent', cursor: 'pointer', color: 'inherit' }}
+                        style={{ flex: 1, padding: '2px 6px', fontSize: '11px', borderRadius: '4px', border: '1px solid var(--dsw-alias-border-subtle)', background: 'transparent', cursor: 'pointer', color: 'inherit' }}
                       >{`⏸️ ${t('quickPause')}`}</button>
                     </div>
                   </div>

package/lib/client.js

@@ -264,6 +264,11 @@ window.__ModuleLoader__.load({
       quickResetTitle: "Reset cooldowns and circuit breaker for active provider",
       quickPause: "Pause",
       quickPauseTitle: "Pause or resume active key",
+      quickPin: "Pin",
+      quickPinTitle: "Pin specific key or select Auto round-robin",
+      quickAuto: "Auto (Round-robin)",
+      cacheHits: "Cache: {n}",
+      pinnedBadge: "pinned",
       exportConfig: "Export Pools",
       importConfig: "Import Pools",
       exportSafe: "Masked (Safe for sharing)",
@@ -536,6 +541,11 @@ window.__ModuleLoader__.load({
       quickResetTitle: "重置当前提供商的冷却时间与断路器",
       quickPause: "暂停",
       quickPauseTitle: "暂停或恢复当前正在使用的密钥",
+      quickPin: "固定",
+      quickPinTitle: "固定指定密钥或设为自动轮换",
+      quickAuto: "自动轮换",
+      cacheHits: "缓存: {n}",
+      pinnedBadge: "已固定",
       exportConfig: "导出密钥池",
       importConfig: "导入密钥池",
       exportSafe: "脱敏导出 (安全分享)",
@@ -3833,11 +3843,40 @@ window.__ModuleLoader__.load({
         /* @__PURE__ */ React.createElement("span", { style: { width: "8px", height: "8px", borderRadius: "50%", background: color, flex: "none", boxShadow: `0 0 6px ${color}` } }),
         label,
         /* @__PURE__ */ React.createElement("span", { style: { fontSize: "9px", opacity: 0.6 } }, open ? "▲" : "▼")
-      ), open ? /* @__PURE__ */ React.createElement("div", { className: "krot-popover", style: { minWidth: "220px" } }, /* @__PURE__ */ React.createElement("div", { className: "krot-pop-title" }, t("headerPoolsTitle")), !poolEntries.length ? /* @__PURE__ */ React.createElement("div", { style: { fontSize: "12px", color: "var(--dsw-alias-label-tertiary)" } }, t("noActivePools")) : null, poolEntries.map(([name, p]) => {
+      ), open ? /* @__PURE__ */ React.createElement("div", { className: "krot-popover", style: { minWidth: "260px" } }, /* @__PURE__ */ React.createElement("div", { className: "krot-pop-title", style: { display: "flex", justifyContent: "space-between", alignItems: "center" } }, /* @__PURE__ */ React.createElement("span", null, t("headerPoolsTitle")), busy ? /* @__PURE__ */ React.createElement("span", { style: { fontSize: "11px", opacity: 0.7 } }, "...") : null), !poolEntries.length ? /* @__PURE__ */ React.createElement("div", { style: { fontSize: "12px", color: "var(--dsw-alias-label-tertiary)" } }, t("noActivePools")) : null, poolEntries.map(([name, p]) => {
         const c = p.exhausted ? "var(--dsw-alias-state-error-primary)" : p.healthy < p.total ? "var(--dsw-alias-state-warn-primary)" : "var(--dsw-alias-state-success-primary)";
         const provName = p.providerName || name;
-        const tail = p.lastUsedTail;
-        return /* @__PURE__ */ React.createElement("div", { key: name, className: "krot-pop-row", style: { display: "flex", flexDirection: "column", gap: "4px", padding: "6px 0", borderBottom: "1px solid var(--dsw-alias-border-subtle)" } }, /* @__PURE__ */ React.createElement("div", { style: { display: "flex", justifyContent: "space-between", alignItems: "center" } }, /* @__PURE__ */ React.createElement("div", { className: "krot-pop-name" }, /* @__PURE__ */ React.createElement("span", { style: { width: "7px", height: "7px", borderRadius: "50%", background: c, flex: "none" } }), name, tail ? /* @__PURE__ */ React.createElement("span", { style: { marginLeft: "6px", fontSize: "11px", color: "var(--dsw-alias-label-tertiary)", fontFeatureSettings: '"tnum"', fontFamily: "monospace" } }, `...${tail}`) : null), /* @__PURE__ */ React.createElement("div", { className: "krot-pop-count", style: { color: c, fontWeight: 600 } }, `${p.healthy}/${p.total}`)), /* @__PURE__ */ React.createElement("div", { style: { display: "flex", gap: "4px", marginTop: "2px" } }, /* @__PURE__ */ React.createElement(
+        const activeTail = p.lastUsedTail;
+        const pinnedTail = p.pinnedTail;
+        const isPinned = Boolean(p.pinnedRef);
+        const keysList = Array.isArray(p.keys) ? p.keys : [];
+        const cacheHits = p.promptCacheHits || 0;
+        return /* @__PURE__ */ React.createElement("div", { key: name, className: "krot-pop-row", style: { display: "flex", flexDirection: "column", gap: "5px", padding: "8px 0", borderBottom: "1px solid var(--dsw-alias-border-subtle)" } }, /* @__PURE__ */ React.createElement("div", { style: { display: "flex", justifyContent: "space-between", alignItems: "center" } }, /* @__PURE__ */ React.createElement("div", { className: "krot-pop-name", style: { display: "flex", alignItems: "center", gap: "6px" } }, /* @__PURE__ */ React.createElement("span", { style: { width: "7px", height: "7px", borderRadius: "50%", background: c, flex: "none" } }), /* @__PURE__ */ React.createElement("strong", { style: { fontSize: "12px" } }, name)), /* @__PURE__ */ React.createElement("div", { className: "krot-pop-count", style: { color: c, fontWeight: 600, fontSize: "11px" } }, `${p.healthy}/${p.total}`)), /* @__PURE__ */ React.createElement("div", { style: { display: "flex", alignItems: "center", justifyContent: "space-between", fontSize: "11px", color: "var(--dsw-alias-label-tertiary)" } }, /* @__PURE__ */ React.createElement("span", { style: { display: "inline-flex", alignItems: "center", gap: "4px" } }, /* @__PURE__ */ React.createElement("span", null, isPinned ? "📌" : "⚡"), /* @__PURE__ */ React.createElement("span", { style: { fontFamily: "monospace" } }, isPinned ? pinnedTail ? `...${pinnedTail} (pinned)` : p.pinnedRef : activeTail ? `...${activeTail}` : "auto")), cacheHits > 0 ? /* @__PURE__ */ React.createElement("span", { style: { fontSize: "10px", padding: "1px 4px", borderRadius: "3px", background: "var(--dsw-alias-bg-subtle, transparent)", color: "var(--dsw-alias-state-success-primary)" }, title: "Prompt cache hits" }, `⚡ ${cacheHits}`) : null), keysList.length > 1 ? /* @__PURE__ */ React.createElement("div", { style: { display: "flex", alignItems: "center", gap: "6px", marginTop: "2px" } }, /* @__PURE__ */ React.createElement(
+          "select",
+          {
+            disabled: busy,
+            value: p.pinnedRef || "",
+            onChange: (e) => runAction("pin", provName, e.target.value),
+            title: t("quickPinTitle"),
+            style: {
+              width: "100%",
+              fontSize: "11px",
+              padding: "3px 6px",
+              borderRadius: "4px",
+              border: "1px solid var(--dsw-alias-border-subtle)",
+              background: "var(--dsw-alias-bg-subtle, transparent)",
+              color: "inherit",
+              fontFamily: "inherit",
+              cursor: "pointer"
+            }
+          },
+          /* @__PURE__ */ React.createElement("option", { value: "" }, `🔀 ${t("quickAuto")}`),
+          keysList.map((k) => {
+            const marker = k.pinned ? "📌 " : k.active ? "▶ " : "";
+            const status = k.paused ? " [paused]" : k.cooling ? " [cooling]" : "";
+            return /* @__PURE__ */ React.createElement("option", { key: k.ref, value: k.ref }, `${marker}...${k.tail || k.ref.slice(-4)}${status}`);
+          })
+        )) : null, /* @__PURE__ */ React.createElement("div", { style: { display: "flex", gap: "4px", marginTop: "3px" } }, /* @__PURE__ */ React.createElement(
           "button",
           {
             type: "button",
@@ -3847,7 +3886,7 @@ window.__ModuleLoader__.load({
               runAction("skip", provName, p.lastUsed);
             },
             title: t("quickSkipTitle"),
-            style: { padding: "2px 6px", fontSize: "11px", borderRadius: "4px", border: "1px solid var(--dsw-alias-border-subtle)", background: "transparent", cursor: "pointer", color: "inherit" }
+            style: { flex: 1, padding: "2px 6px", fontSize: "11px", borderRadius: "4px", border: "1px solid var(--dsw-alias-border-subtle)", background: "transparent", cursor: "pointer", color: "inherit" }
           },
           `⏭️ ${t("quickSkip")}`
         ), /* @__PURE__ */ React.createElement(
@@ -3860,7 +3899,7 @@ window.__ModuleLoader__.load({
               runAction("reset", provName, p.lastUsed);
             },
             title: t("quickResetTitle"),
-            style: { padding: "2px 6px", fontSize: "11px", borderRadius: "4px", border: "1px solid var(--dsw-alias-border-subtle)", background: "transparent", cursor: "pointer", color: "inherit" }
+            style: { flex: 1, padding: "2px 6px", fontSize: "11px", borderRadius: "4px", border: "1px solid var(--dsw-alias-border-subtle)", background: "transparent", cursor: "pointer", color: "inherit" }
           },
           `🔄 ${t("quickReset")}`
         ), /* @__PURE__ */ React.createElement(
@@ -3873,7 +3912,7 @@ window.__ModuleLoader__.load({
               runAction("pause", provName, p.lastUsed);
             },
             title: t("quickPauseTitle"),
-            style: { padding: "2px 6px", fontSize: "11px", borderRadius: "4px", border: "1px solid var(--dsw-alias-border-subtle)", background: "transparent", cursor: "pointer", color: "inherit" }
+            style: { flex: 1, padding: "2px 6px", fontSize: "11px", borderRadius: "4px", border: "1px solid var(--dsw-alias-border-subtle)", background: "transparent", cursor: "pointer", color: "inherit" }
           },
           `⏸️ ${t("quickPause")}`
         )));

package/lib/index.js

@@ -146,6 +146,10 @@ const SettingsSchema = Schema.object({
   cacheAffinityEnabled: Schema.boolean().default(true),
   cacheAffinityTtlMs: Schema.number().default(300000),
   cacheAffinityPrefixChars: Schema.number().default(2048),
+  subagentPartitionsEnabled: Schema.boolean().default(true),
+  subagentReservedKeysCount: Schema.number().default(0),
+  subagentPartitionStrategy: Schema.union(['shared-burst', 'isolated']).default('shared-burst'),
+  subagentMaxConcurrencyPerKey: Schema.number().default(2),
   providers: Schema.array(Schema.object({
     provider: Schema.string().required(),
     keys: Schema.array(Schema.string()).default([]),
@@ -184,6 +188,10 @@ const SettingsSchema = Schema.object({
     cacheAffinityEnabled: Schema.boolean(),
     cacheAffinityTtlMs: Schema.number(),
     cacheAffinityPrefixChars: Schema.number(),
+    subagentPartitionsEnabled: Schema.boolean(),
+    subagentReservedKeysCount: Schema.number(),
+    subagentPartitionStrategy: Schema.union(['shared-burst', 'isolated']),
+    subagentMaxConcurrencyPerKey: Schema.number(),
   })).default([...DEFAULT_PROVIDERS]),
 });
 

package/lib/pool-builder.js

@@ -50,6 +50,10 @@ export function buildPoolItem({
   cacheAffinityEnabled = true,
   cacheAffinityTtlMs = 300000,
   cacheAffinityPrefixChars = 2048,
+  subagentPartitionsEnabled = true,
+  subagentReservedKeysCount = 0,
+  subagentPartitionStrategy = 'shared-burst',
+  subagentMaxConcurrencyPerKey = 2,
 }) {
   const seen = new Set();
   const indexed = (Array.isArray(keys) ? keys : []).map((key, index) => ({ ref: typeof key === 'string' ? key.trim() : '', index }))
@@ -169,6 +173,10 @@ const weightsMap = {};
     cacheAffinityEnabled: cacheAffinityEnabled ?? true,
     cacheAffinityTtlMs: typeof cacheAffinityTtlMs === 'number' && Number.isFinite(cacheAffinityTtlMs) && cacheAffinityTtlMs > 0 ? Math.floor(cacheAffinityTtlMs) : 300000,
     cacheAffinityPrefixChars: typeof cacheAffinityPrefixChars === 'number' && Number.isFinite(cacheAffinityPrefixChars) && cacheAffinityPrefixChars > 0 ? Math.floor(cacheAffinityPrefixChars) : 2048,
+    subagentPartitionsEnabled: subagentPartitionsEnabled ?? true,
+    subagentReservedKeysCount: typeof subagentReservedKeysCount === 'number' && Number.isFinite(subagentReservedKeysCount) && subagentReservedKeysCount >= 0 ? Math.floor(subagentReservedKeysCount) : 0,
+    subagentPartitionStrategy: subagentPartitionStrategy === 'isolated' ? 'isolated' : 'shared-burst',
+    subagentMaxConcurrencyPerKey: typeof subagentMaxConcurrencyPerKey === 'number' && Number.isFinite(subagentMaxConcurrencyPerKey) && subagentMaxConcurrencyPerKey > 0 ? Math.floor(subagentMaxConcurrencyPerKey) : 2,
     preemptiveRotationEnabled: preemptiveRotationEnabled ?? true,
     preemptiveSafetyMarginTokens: typeof preemptiveSafetyMarginTokens === 'number' && Number.isFinite(preemptiveSafetyMarginTokens) && preemptiveSafetyMarginTokens >= 0 ? Math.floor(preemptiveSafetyMarginTokens) : 4000,
     preemptiveSafetyMarginRequests: typeof preemptiveSafetyMarginRequests === 'number' && Number.isFinite(preemptiveSafetyMarginRequests) && preemptiveSafetyMarginRequests >= 0 ? Math.floor(preemptiveSafetyMarginRequests) : 2,
@@ -228,6 +236,10 @@ export function buildPools({ cfg = {}, poolState = new Map(), defaultState = ini
       cacheAffinityEnabled: p.cacheAffinityEnabled ?? cfg.cacheAffinityEnabled ?? true,
       cacheAffinityTtlMs: p.cacheAffinityTtlMs ?? cfg.cacheAffinityTtlMs ?? 300000,
       cacheAffinityPrefixChars: p.cacheAffinityPrefixChars ?? cfg.cacheAffinityPrefixChars ?? 2048,
+      subagentPartitionsEnabled: p.subagentPartitionsEnabled ?? cfg.subagentPartitionsEnabled ?? true,
+      subagentReservedKeysCount: p.subagentReservedKeysCount ?? cfg.subagentReservedKeysCount ?? 0,
+      subagentPartitionStrategy: p.subagentPartitionStrategy ?? cfg.subagentPartitionStrategy ?? 'shared-burst',
+      subagentMaxConcurrencyPerKey: p.subagentMaxConcurrencyPerKey ?? cfg.subagentMaxConcurrencyPerKey ?? 2,
       preemptiveRotationEnabled: p.preemptiveRotationEnabled ?? cfg.preemptiveRotationEnabled ?? true,
       preemptiveSafetyMarginTokens: p.preemptiveSafetyMarginTokens ?? cfg.preemptiveSafetyMarginTokens ?? 4000,
       preemptiveSafetyMarginRequests: p.preemptiveSafetyMarginRequests ?? cfg.preemptiveSafetyMarginRequests ?? 2,
@@ -272,6 +284,10 @@ export function buildPools({ cfg = {}, poolState = new Map(), defaultState = ini
         cacheAffinityEnabled: mp.cacheAffinityEnabled ?? p.cacheAffinityEnabled ?? cfg.cacheAffinityEnabled ?? true,
         cacheAffinityTtlMs: mp.cacheAffinityTtlMs ?? p.cacheAffinityTtlMs ?? cfg.cacheAffinityTtlMs ?? 300000,
         cacheAffinityPrefixChars: mp.cacheAffinityPrefixChars ?? p.cacheAffinityPrefixChars ?? cfg.cacheAffinityPrefixChars ?? 2048,
+        subagentPartitionsEnabled: mp.subagentPartitionsEnabled ?? p.subagentPartitionsEnabled ?? cfg.subagentPartitionsEnabled ?? true,
+        subagentReservedKeysCount: mp.subagentReservedKeysCount ?? p.subagentReservedKeysCount ?? cfg.subagentReservedKeysCount ?? 0,
+        subagentPartitionStrategy: mp.subagentPartitionStrategy ?? p.subagentPartitionStrategy ?? cfg.subagentPartitionStrategy ?? 'shared-burst',
+        subagentMaxConcurrencyPerKey: mp.subagentMaxConcurrencyPerKey ?? p.subagentMaxConcurrencyPerKey ?? cfg.subagentMaxConcurrencyPerKey ?? 2,
         preemptiveRotationEnabled: mp.preemptiveRotationEnabled ?? p.preemptiveRotationEnabled ?? cfg.preemptiveRotationEnabled ?? true,
         preemptiveSafetyMarginTokens: mp.preemptiveSafetyMarginTokens ?? p.preemptiveSafetyMarginTokens ?? cfg.preemptiveSafetyMarginTokens ?? 4000,
         preemptiveSafetyMarginRequests: mp.preemptiveSafetyMarginRequests ?? p.preemptiveSafetyMarginRequests ?? cfg.preemptiveSafetyMarginRequests ?? 2,

package/lib/resolver.js

@@ -13,6 +13,7 @@ import { envValue, sortAttemptList, isKeyPaused, isKeyRevoked, isKeyBroken, cost
 import { decryptSecret } from './crypto-storage.js';
 import { applyPreemptiveYield } from './preemptive-yield.js';
 import { extractPromptPrefixKey, applyCacheAffinity } from './cache-affinity.js';
+import { partitionPoolKeys } from './subagent-partitions.js';
 import { resolveRefPool, isQuotaManagedRequest, providerOfBase, basePoolForBase } from './pool-index.js';
 import {
   isModelQuotaAvailable,
@@ -139,6 +140,8 @@ export function createResolver({
     if (cacheKey) {
       list = applyCacheAffinity(list, pool, { cacheKey, now: Date.now() });
     }
+    // Issue #575: Subagent Concurrency Partitions
+    list = partitionPoolKeys(list, pool, { reqOptions: resolveOpts, concurrencyTracker, now: Date.now() });
     // Issue #571: Pre-emptive Token & Request Yield before 429
     list = applyPreemptiveYield(list, pool, { now: Date.now() });
     // Fail closed: when this request is managed by a model pool that has local

package/lib/rotate.js

@@ -29,6 +29,7 @@ import { recordStreamSuccessMetrics, preserveDispatchContext } from './stream-me
 import { withStreamWatchdog, StreamStallError } from './stream-watchdog.js';
 import { applyPreemptiveYield } from './preemptive-yield.js';
 import { extractPromptPrefixKey, applyCacheAffinity } from './cache-affinity.js';
+import { partitionPoolKeys } from './subagent-partitions.js';
 import { penalizeKey } from './rotate-penalty.js';
 import { recordPromptCache } from './prompt-cache.js';
 import { recordRequestOutcome, recordFailureCategory } from './ops-analytics.js';
@@ -210,6 +211,8 @@ export function createRotate(deps) {
       if (reqStore.cacheKey) {
         attemptList = applyCacheAffinity(attemptList, pool, { cacheKey: reqStore.cacheKey, now: wallNow, trace, pushEvent });
       }
+      // Issue #575: Subagent Concurrency Partitions
+      attemptList = partitionPoolKeys(attemptList, pool, { reqOptions: options, concurrencyTracker, now: wallNow, trace });
 
       // Issue #571: Pre-emptive Token & Request Yield before 429
       attemptList = applyPreemptiveYield(attemptList, pool, {

package/lib/routes/quick-action.js

@@ -35,8 +35,8 @@ export function registerQuickActionRoutes(ctx, deps) {
       const provider = typeof body?.provider === 'string' ? body.provider.trim() : '';
       const ref = typeof body?.ref === 'string' ? body.ref.trim() : null;
 
-      if (!action || !['skip', 'reset', 'pause'].includes(action)) {
-        json(res, 400, { error: { code: 'invalid-action', message: 'action must be skip, reset, or pause' } });
+      if (!action || !['skip', 'reset', 'pause', 'pin'].includes(action)) {
+        json(res, 400, { error: { code: 'invalid-action', message: 'action must be skip, reset, pause, or pin' } });
         return;
       }
 
@@ -164,6 +164,30 @@ export function registerQuickActionRoutes(ctx, deps) {
         });
         return;
       }
+      if (action === 'pin') {
+        const targetRef = typeof ref === 'string' && ref.trim().length > 0 ? ref.trim() : null;
+        if (targetRef && targetPool.refs && !targetPool.refs.includes(targetRef)) {
+          json(res, 400, { error: { code: 'invalid-key', message: `Key ${targetRef} not in pool` } });
+          return;
+        }
+        targetPool.pinnedRef = targetRef;
+        if (targetRef) {
+          targetPool.state.lastUsed = targetRef;
+        }
+
+        if (typeof pushEvent === 'function') {
+          pushEvent(targetPool, targetRef || '*', targetRef ? 'KEY_PINNED' : 'KEY_UNPINNED', 0);
+        }
+
+        json(res, 200, {
+          ok: true,
+          action: 'pin',
+          provider,
+          pinnedRef: targetPool.pinnedRef,
+          pinnedTail: targetPool.pinnedRef ? keyTail(targetPool.pinnedRef) : null,
+        });
+        return;
+      }
     },
   }));
 }

package/lib/routes/status.js

@@ -249,6 +249,17 @@ ctx.effect(() => getWebServer(ctx).register({
         modelQuota: quotaAware ? { configured: true, exhaustedKeys: quotaExhausted } : null,
         lastUsed: pool.state.lastUsed ?? null,
         lastUsedTail: pool.state.lastUsed ? keyTail(pool.state.lastUsed) : null,
+        pinnedRef: pool.pinnedRef ?? null,
+        pinnedTail: pool.pinnedRef ? keyTail(pool.pinnedRef) : null,
+        promptCacheHits: pool.state.promptCacheHits ?? 0,
+        keys: pool.refs.map((r) => ({
+          ref: r,
+          tail: keyTail(r),
+          active: pool.state.lastUsed === r,
+          pinned: pool.pinnedRef === r,
+          paused: isKeyPaused(pool, r),
+          cooling: (pool.state.failedUntil?.get(r) ?? 0) > now,
+        })),
       };
     }
     let circuitOpenAny = false;

package/lib/subagent-partitions.js

@@ -0,0 +1,163 @@
+// src/subagent-partitions.js — Subagent Concurrency Partitions & Isolation (#575).
+// Pure module: zero runtime dependencies, strictly < 600 lines.
+
+export const DEFAULT_SUBAGENT_MAX_CONCURRENCY_PER_KEY = 2;
+
+/**
+ * Extracts subagent or background task context from request options and metadata.
+ * @param {object} options
+ * @returns {{ isSubagent: boolean, subagentId?: string, parentSessionId?: string }}
+ */
+export function extractSubagentContext(options) {
+  if (!options || typeof options !== 'object') return { isSubagent: false };
+  const meta = options.metadata || options.meta || {};
+  const parentSessionId = typeof meta.parentSessionId === 'string' && meta.parentSessionId.trim() ? meta.parentSessionId.trim() : undefined;
+
+  let isSubagent = false;
+  let subagentId = undefined;
+
+  if (options.isSubagent === true || meta.isSubagent === true) {
+    isSubagent = true;
+    subagentId = options.subagentId || meta.subagentId;
+  } else if (typeof options.subagentId === 'string' && options.subagentId.trim()) {
+    isSubagent = true;
+    subagentId = options.subagentId.trim();
+  } else if (typeof meta.subagentId === 'string' && meta.subagentId.trim()) {
+    isSubagent = true;
+    subagentId = meta.subagentId.trim();
+  } else if (typeof options.subagent === 'string' && options.subagent.trim()) {
+    isSubagent = true;
+    subagentId = options.subagent.trim();
+  } else if (options.subagent === true) {
+    isSubagent = true;
+  } else if (parentSessionId) {
+    isSubagent = true;
+    subagentId = meta.childSessionId;
+  } else {
+    // Check sessionId prefixes
+    const sid = String(options.sessionId || options.session || options.chatId || options.conversationId || '').trim();
+    if (
+      sid.startsWith('subagent:') ||
+      sid.startsWith('subagent-') ||
+      sid.startsWith('subtask:') ||
+      sid.startsWith('subtask-') ||
+      sid.startsWith('agent:sub:')
+    ) {
+      isSubagent = true;
+      subagentId = sid;
+    } else {
+      // Check tags
+      const tags = Array.isArray(options.tags) ? options.tags : (Array.isArray(meta.tags) ? meta.tags : []);
+      if (tags.some(t => typeof t === 'string' && (t === 'subagent' || t === 'subtask' || t === 'background'))) {
+        isSubagent = true;
+        subagentId = options.subagentId || meta.subagentId;
+      }
+    }
+  }
+
+  if (isSubagent) {
+    const res = { isSubagent: true };
+    if (subagentId) res.subagentId = subagentId;
+    if (parentSessionId) res.parentSessionId = parentSessionId;
+    return res;
+  }
+
+  return { isSubagent: false };
+}
+
+/**
+ * Partitions or reorders candidate keys according to subagent isolation rules.
+ * @param {string[]} attemptList
+ * @param {object} pool
+ * @param {object} [options]
+ * @returns {string[]}
+ */
+export function partitionPoolKeys(attemptList, pool, options = {}) {
+  if (!Array.isArray(attemptList) || attemptList.length <= 1 || !pool) {
+    return (attemptList ?? []).slice();
+  }
+
+  const enabled = options.enabled ?? pool.subagentPartitionsEnabled ?? true;
+  if (!enabled) return attemptList.slice();
+
+  const subCtx = options.subagentContext ?? extractSubagentContext(options.reqOptions);
+  const isSubagent = Boolean(subCtx.isSubagent);
+  const reservedCount = pool.subagentReservedKeysCount ?? 0;
+  const strategy = pool.subagentPartitionStrategy ?? 'shared-burst';
+  const labels = pool.labels || {};
+
+  const explicitSubagentRefs = new Set();
+  const explicitPrimaryRefs = new Set();
+
+  for (const [ref, label] of Object.entries(labels)) {
+    const lbl = String(label).toLowerCase();
+    if (lbl === 'subagent' || lbl === 'subtask' || lbl === 'worker') explicitSubagentRefs.add(ref);
+    if (lbl === 'primary' || lbl === 'main' || lbl === 'user') explicitPrimaryRefs.add(ref);
+  }
+
+  // If reservedCount > 0, reserve the last reservedCount keys of pool.refs if not already labelled primary
+  if (reservedCount > 0 && pool.refs && pool.refs.length > reservedCount) {
+    const reservedSlice = pool.refs.slice(pool.refs.length - reservedCount);
+    for (const r of reservedSlice) {
+      if (!explicitPrimaryRefs.has(r)) explicitSubagentRefs.add(r);
+    }
+  }
+
+  const hasPartitioning = explicitSubagentRefs.size > 0;
+  let list = attemptList.slice();
+
+  if (isSubagent) {
+    // SUBAGENT REQUEST
+    if (hasPartitioning) {
+      const dedicated = list.filter(r => explicitSubagentRefs.has(r));
+      const shared = list.filter(r => !explicitSubagentRefs.has(r));
+
+      if (strategy === 'isolated') {
+        if (dedicated.length > 0) list = dedicated;
+      } else {
+        list = dedicated.concat(shared);
+      }
+    }
+  } else {
+    // PRIMARY / USER REQUEST
+    if (hasPartitioning) {
+      const primary = list.filter(r => !explicitSubagentRefs.has(r));
+      const subOnly = list.filter(r => explicitSubagentRefs.has(r));
+
+      if (primary.length > 0) {
+        list = strategy === 'isolated' ? primary : primary.concat(subOnly);
+      }
+    }
+  }
+
+  // Apply subagent per-key concurrency cap
+  const tracker = options.concurrencyTracker;
+  const maxSubConcurrency = pool.subagentMaxConcurrencyPerKey ?? DEFAULT_SUBAGENT_MAX_CONCURRENCY_PER_KEY;
+  if (isSubagent && tracker && typeof tracker.getActive === 'function' && maxSubConcurrency > 0) {
+    const now = options.now ?? Date.now();
+    const withinCap = [];
+    const saturated = [];
+    for (const r of list) {
+      const active = tracker.getActive(r, now) ?? 0;
+      if (active >= maxSubConcurrency) {
+        saturated.push(r);
+      } else {
+        withinCap.push(r);
+      }
+    }
+    if (withinCap.length > 0 && saturated.length > 0) {
+      list = withinCap.concat(saturated);
+    }
+  }
+
+  if (options.trace && typeof options.trace.addStep === 'function' && list[0] !== attemptList[0]) {
+    options.trace.addStep(
+      list[0],
+      'PRIORITIZED',
+      'SUBAGENT_PARTITION',
+      isSubagent ? 'Subagent partition key allocated' : 'Primary chat partition prioritized'
+    );
+  }
+
+  return list;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goodandready/dsh-key-rotation",
-  "version": "0.8.87",
+  "version": "0.8.89",
   "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": [