@goodandready/dsh-subscriptions 0.6.61 → 0.6.63

package/lib/client.js

@@ -122,6 +122,10 @@ window.__ModuleLoader__.load({
     '.dsub-stat-box{padding:10px 12px;border:1px solid var(--dsw-alias-border-l2);border-radius:8px;background:var(--dsw-alias-bg-layer-2);display:flex;flex-direction:column;gap:3px}' +
     '.dsub-stat-val{font-size:16.5px;font-weight:700;color:var(--dsw-alias-label-primary)}' +
     '.dsub-stat-lbl{font-size:11.5px;color:var(--dsw-alias-label-secondary)}' +
+    '.dsub-chart-wrap{display:flex;align-items:flex-end;gap:3px;height:52px;padding:6px 0;margin-top:8px;border-bottom:1px solid var(--dsw-alias-border-l3)}' +
+    '.dsub-chart-bar{flex:1;background:var(--dsw-alias-brand-primary);border-radius:2px 2px 0 0;min-height:3px;transition:height .2s ease;opacity:0.85;cursor:pointer}' +
+    '.dsub-chart-bar:hover{opacity:1;background:var(--dsw-alias-state-success-primary)}' +
+    '.dsub-chart-labels{display:flex;justify-content:space-between;font-size:10px;color:var(--dsw-alias-label-secondary);margin-top:3px}' +
     '.dsub-alert-ok{padding:8px 12px;border-radius:8px;background:color-mix(in srgb,var(--dsw-alias-state-success-primary) 10%,transparent);color:var(--dsw-alias-state-success-primary);font-size:12.5px;border:1px solid color-mix(in srgb,var(--dsw-alias-state-success-primary) 25%,transparent)}' +
     '.dsub-alert-bad{padding:8px 12px;border-radius:8px;background:color-mix(in srgb,var(--dsw-alias-state-error-primary) 10%,transparent);color:var(--dsw-alias-state-error-primary);font-size:12.5px;border:1px solid color-mix(in srgb,var(--dsw-alias-state-error-primary) 25%,transparent)}' +
     '.dsub-btn-primary{background:var(--dsw-alias-label-primary) !important;color:var(--dsw-alias-bg-layer-3) !important;border-color:transparent !important;font-weight:600}' +
@@ -569,6 +573,42 @@ const cssId = 'dsh-subscriptions/settings.module.css'
       "toastReleased": "Account active and healthy",
       "toastQuotaWarning": "Quota threshold exceeded",
       "enableToasts": "In-app toast alerts",
+      "groupQueue": "Concurrency & Request Queue",
+      "enableQueue": "Enable request queue",
+      "enableQueueHint": "Queue excess requests when account hits concurrency limit instead of failing with 429",
+      "accountMaxConcurrency": "Max concurrent streams per account",
+      "accountMaxConcurrencyHint": "Maximum simultaneous streaming requests allowed per account (default 2)",
+      "maxQueueSize": "Max queue depth",
+      "maxQueueSizeHint": "Maximum queued requests per account before rejecting with overflow (default 20)",
+      "queueTimeoutSec": "Queue wait timeout (seconds)",
+      "queueTimeoutSecHint": "Maximum wait time in queue before timeout rejection (default 30s)",
+      "analyticsTitle": "Subscription & Cache Analytics",
+      "analyticsDesc": "Cache hit rate, token caching efficiency, TTFT latency, generation speed, and 24h activity",
+      "ttftMetric": "TTFT Latency",
+      "speedMetric": "Speed",
+      "queueActive": "Active Streams",
+      "queueWaiting": "Queued",
+      "queueRejected": "Rejected",
+      "activity24h": "24-Hour Activity Distribution",
+      "forecastTitle": "Quota Exhaustion Forecast",
+      "forecastRunway": "Estimated runway",
+      "forecastBurnRate": "Burn rate",
+      "forecastExhaustWarning": "Quota projected to exhaust before reset window",
+      "wizardButton": "Diagnose",
+      "wizardTitle": "Diagnostic Wizard",
+      "wizardAll": "Account Wizard",
+      "wizardIncludeNetwork": "Include active network checks (proxy ping & model catalog discovery)",
+      "wizardRunning": "Running diagnostic checklist...",
+      "wizardStepCreds": "Credentials & Expiry",
+      "wizardStepProxy": "Proxy & Gateway",
+      "wizardStepToken": "Token Validation",
+      "wizardStepCatalog": "Model Catalog Reachability",
+      "wizardHealthy": "Healthy",
+      "wizardDegraded": "Degraded / Warnings",
+      "wizardFailing": "Issues Detected",
+      "wizardRecommendations": "Recommendations & Next Steps",
+      "wizardCopy": "Copy Masked Diagnostic Report",
+      "cachePinnedBadge": "Cache Pinned",
       "field.enableToasts": "Show popup toast notifications on quarantine or quota events"
 };
 
@@ -791,6 +831,42 @@ const cssId = 'dsh-subscriptions/settings.module.css'
       "toastReleased": "账户已解除隔离恢复使用",
       "toastQuotaWarning": "额度预警",
       "enableToasts": "应用内弹窗提醒",
+      "groupQueue": "并发限制与请求队列",
+      "enableQueue": "启用并发请求排队",
+      "enableQueueHint": "当账户达到并发上限时将多余请求排队等待，避免直接触发 429 报错",
+      "accountMaxConcurrency": "单账户最大并发流数",
+      "accountMaxConcurrencyHint": "每个账户允许同时执行的最大流式请求数（默认 2）",
+      "maxQueueSize": "队列最大等待深度",
+      "maxQueueSizeHint": "每个账户允许排队的最大请求数，超限后拒绝执行（默认 20）",
+      "queueTimeoutSec": "排队超时时间（秒）",
+      "queueTimeoutSecHint": "在队列中等待槽位的最长时间，超时后自动放弃并回退（默认 30 秒）",
+      "analyticsTitle": "订阅与缓存深度分析",
+      "analyticsDesc": "缓存命中率、Token 缓存效率、首字响应延迟 (TTFT)、生成速度及 24 小时负载分布",
+      "ttftMetric": "首字响应延迟 (TTFT)",
+      "speedMetric": "生成速度",
+      "queueActive": "活跃流",
+      "queueWaiting": "排队中",
+      "queueRejected": "已拒绝",
+      "activity24h": "24 小时活动分布",
+      "forecastTitle": "额度消耗预测与预警",
+      "forecastRunway": "预计可用时间",
+      "forecastBurnRate": "消耗速率",
+      "forecastExhaustWarning": "预计在额度重置前耗尽",
+      "wizardButton": "诊断",
+      "wizardTitle": "账户诊断向导",
+      "wizardAll": "诊断向导",
+      "wizardIncludeNetwork": "包含活跃网络探测（代理连通性与模型目录探测）",
+      "wizardRunning": "正在执行诊断检查清单...",
+      "wizardStepCreds": "凭据完整性与有效期",
+      "wizardStepProxy": "网络代理与网关",
+      "wizardStepToken": "令牌有效性验证",
+      "wizardStepCatalog": "模型目录可达性",
+      "wizardHealthy": "健康正常",
+      "wizardDegraded": "降级预警",
+      "wizardFailing": "发现故障",
+      "wizardRecommendations": "排查建议与修复步骤",
+      "wizardCopy": "复制脱敏诊断报告",
+      "cachePinnedBadge": "缓存粘性",
       "field.enableToasts": "当账户发生隔离或额度达到警戒线时显示即时弹窗提醒"
 };
     // #51: live countdown to the quota window reset (account.quota.resetAt).
@@ -1015,6 +1091,8 @@ const cssId = 'dsh-subscriptions/settings.module.css'
       const [checkRes, setCheckRes] = React.useState({})
       const [hostPing, setHostPing] = React.useState({ ok: true, latencyMs: null })
       const [telemetry, setTelemetry] = React.useState(null)
+      const [analytics, setAnalytics] = React.useState(null)
+      const [queueStats, setQueueStats] = React.useState(null)
       const [smoke, setSmoke] = React.useState({ testing: false, result: null })
       const [updater, setUpdater] = React.useState({ checking: false, updating: false, status: null, message: '' })
       const [backupModal, setBackupModal] = React.useState(null)
@@ -1023,7 +1101,31 @@ const cssId = 'dsh-subscriptions/settings.module.css'
       const [backupErr, setBackupErr] = React.useState('')
       const [backupInfo, setBackupInfo] = React.useState('')
       const [backupLoading, setBackupLoading] = React.useState(false)
-
+      const [wizardModal, setWizardModal] = React.useState(null)
+
+            const runWizard = async (provider, index, ref, includeNetwork = false) => {
+        setWizardModal({
+          provider: provider || 'all',
+          index: index || 1,
+          ref: ref || null,
+          loading: true,
+          report: null,
+          includeNetwork,
+          error: '',
+        })
+        try {
+          const res = await fetch('/dsh-subscriptions/diagnostic-wizard', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ provider, index, ref, includeNetwork }),
+          })
+          const d = await res.json()
+          if (!d || !d.ok) throw new Error((d && d.error && d.error.message) || ('HTTP ' + res.status))
+          setWizardModal((m) => Object.assign({}, m, { loading: false, report: d.report, error: '' }))
+        } catch (e) {
+          setWizardModal((m) => Object.assign({}, m, { loading: false, error: cleanErrorMessage(e && e.message || e) }))
+        }
+      }
       const doExportBackup = async () => {
         setBackupErr(''); setBackupInfo(''); setBackupLoading(true)
         try {
@@ -1117,6 +1219,14 @@ const cssId = 'dsh-subscriptions/settings.module.css'
           .then((r) => r.json())
           .then((d) => { if (d && d.ok && d.telemetry) setTelemetry(d.telemetry) })
           .catch(() => {})
+        fetch('/dsh-subscriptions/analytics', { cache: 'no-store' })
+          .then((r) => r.json())
+          .then((d) => { if (d && d.ok && d.analytics) setAnalytics(d.analytics) })
+          .catch(() => {})
+        fetch('/dsh-subscriptions/queue', { cache: 'no-store' })
+          .then((r) => r.json())
+          .then((d) => { if (d && d.ok && d.queue) setQueueStats(d.queue) })
+          .catch(() => {})
       }
 
       const runSmokeTest = async (provider, index) => {
@@ -1506,12 +1616,74 @@ const cssId = 'dsh-subscriptions/settings.module.css'
             React.createElement('div', { className: 'dsub-stat-lbl' }, t('statsLastActivity')),
           ),
         ) : null,
+        (analytics && (analytics.totalRequests > 0 || (analytics.hourly && analytics.hourly.some(function(b) { return b.requests > 0 })))) || (queueStats && (queueStats.totalActive > 0 || queueStats.totalQueued > 0)) ? React.createElement('details', { className: 'dsub-group', open: true, style: { marginBottom: '14px' } },
+          React.createElement('summary', { className: 'dsub-groupHead' }, '📊 ' + t('analyticsTitle')),
+          React.createElement('div', { className: 'dsub-sub', style: { marginTop: '4px' } }, t('analyticsDesc')),
+          React.createElement('div', { className: 'dsub-grid-2', style: { marginTop: '10px' } },
+            React.createElement('div', { className: 'dsub-stat-box' },
+              React.createElement('div', { className: 'dsub-stat-val' }, ((analytics && analytics.cache && analytics.cache.cacheHitRate) || 0) + '%'),
+              React.createElement('div', { className: 'dsub-stat-lbl' }, t('cacheHitRate') + (analytics && analytics.cache ? ' (' + (analytics.cache.cacheReadTokens || 0).toLocaleString() + ' tok)' : '')),
+            ),
+            React.createElement('div', { className: 'dsub-stat-box' },
+              React.createElement('div', { className: 'dsub-stat-val' }, (analytics && analytics.performance && analytics.performance.ttft && analytics.performance.ttft.avgMs != null ? analytics.performance.ttft.avgMs + ' ms' : '—')),
+              React.createElement('div', { className: 'dsub-stat-lbl' }, t('ttftMetric') + (analytics && analytics.performance && analytics.performance.ttft && analytics.performance.ttft.p95Ms != null ? ' · p95 ' + analytics.performance.ttft.p95Ms + ' ms' : '')),
+            ),
+            React.createElement('div', { className: 'dsub-stat-box' },
+              React.createElement('div', { className: 'dsub-stat-val' }, (analytics && analytics.performance && analytics.performance.tps && analytics.performance.tps.avg != null ? analytics.performance.tps.avg + ' tok/s' : '—')),
+              React.createElement('div', { className: 'dsub-stat-lbl' }, t('speedMetric') + (analytics && analytics.performance && analytics.performance.tps && analytics.performance.tps.p95 != null ? ' · p95 ' + analytics.performance.tps.p95 : '')),
+            ),
+            React.createElement('div', { className: 'dsub-stat-box' },
+              React.createElement('div', { className: 'dsub-stat-val' }, (queueStats ? queueStats.totalActive : 0) + ' / ' + (queueStats ? queueStats.totalQueued : 0)),
+              React.createElement('div', { className: 'dsub-stat-lbl' }, t('queueActive') + ' / ' + t('queueWaiting') + (queueStats && queueStats.metrics && queueStats.metrics.totalOverflowed ? ' · ' + queueStats.metrics.totalOverflowed + ' ' + t('queueRejected') : '')),
+            ),
+          ),
+          analytics && Array.isArray(analytics.hourly) && analytics.hourly.length ? (function() {
+            var maxReq = Math.max.apply(Math, [1].concat(analytics.hourly.map(function(b) { return b.requests || 0 })))
+            return React.createElement('div', { style: { marginTop: '12px' } },
+              React.createElement('div', { style: { fontSize: '11.5px', fontWeight: 600, color: 'var(--dsw-alias-label-secondary)' } }, t('activity24h')),
+              React.createElement('div', { className: 'dsub-chart-wrap' },
+                analytics.hourly.map(function(b, idx) {
+                  var pct = Math.max(4, Math.round(((b.requests || 0) / maxReq) * 100))
+                  var title = b.label + ': ' + b.requests + ' req (' + b.cacheReadTokens + ' cached tok, ' + b.errorCount + ' err)'
+                  return React.createElement('div', {
+                    key: idx,
+                    className: 'dsub-chart-bar',
+                    style: {
+                      height: pct + '%',
+                      backgroundColor: b.errorCount > 0 && b.requests === b.errorCount
+                        ? 'var(--dsw-alias-state-error-primary)'
+                        : (b.cacheReadTokens > 0 ? 'var(--dsw-alias-brand-primary)' : 'var(--dsw-alias-state-success-primary)'),
+                    },
+                    title: title,
+                  })
+                })
+              ),
+              React.createElement('div', { className: 'dsub-chart-labels' },
+                React.createElement('span', null, '-24h'),
+                React.createElement('span', null, '-18h'),
+                React.createElement('span', null, '-12h'),
+                React.createElement('span', null, '-6h'),
+                React.createElement('span', null, 'Now'),
+              ),
+            )
+          })() : null,
+          analytics && Array.isArray(analytics.forecast) && analytics.forecast.some(function(f) { return f.willExhaustBeforeReset || (f.burnRateTokensPerHour > 0 && f.hoursToExhaustion != null && f.hoursToExhaustion < 72) }) ? React.createElement('div', { style: { marginTop: '12px' } },
+            React.createElement('div', { style: { fontSize: '11.5px', fontWeight: 600, color: 'var(--dsw-alias-state-warn-primary)', marginBottom: '6px' } }, '⚠️ ' + t('forecastTitle')),
+            analytics.forecast.filter(function(f) { return f.willExhaustBeforeReset || (f.burnRateTokensPerHour > 0 && f.hoursToExhaustion != null && f.hoursToExhaustion < 72) }).map(function(f, idx) {
+              return React.createElement('div', { key: idx, className: 'dsub-alert-bad', style: { marginBottom: '6px' } },
+                (f.provider ? f.provider.toUpperCase() : 'LLM') + ' (' + (f.label || f.ref) + '): ' +
+                (f.willExhaustBeforeReset ? t('forecastExhaustWarning') : (t('forecastRunway') + ': ~' + f.hoursToExhaustion + 'h')) +
+                ' · ' + t('forecastBurnRate') + ': ' + f.burnRateTokensPerHour.toLocaleString() + ' tok/h'
+              )
+            })
+          ) : null,
+        ) : null,
         telemetry && Array.isArray(telemetry.recentDecisions) && telemetry.recentDecisions.length ? React.createElement('details', { className: 'dsub-group', style: { marginBottom: '14px' } },
           React.createElement('summary', { className: 'dsub-groupHead' }, '🧭 ' + t('rotationDecisionsTitle')),
           React.createElement('div', { className: 'dsub-sub', style: { marginTop: '4px' } }, t('rotationDecisionsDesc')),
           React.createElement('div', { className: 'dsub-trace-box' },
             telemetry.recentDecisions.map((dec, idx) => {
-              const reasonBadge = dec.cascaded ? ('🔀 ' + t('rotationCascaded')) : (dec.decisionReason === 'session_pinned' ? '📌 Pinned' : ('⚡ ' + dec.decisionReason))
+              const reasonBadge = dec.cascaded ? ('🔀 ' + t('rotationCascaded')) : (dec.decisionReason === 'cache_pinned' ? ('📌 ' + t('cachePinnedBadge')) : (dec.decisionReason === 'session_pinned' ? '📌 Pinned' : ('⚡ ' + dec.decisionReason)))
               return React.createElement('div', { key: idx, className: 'dsub-trace-row' },
                 React.createElement('div', { style: { display: 'flex', alignItems: 'center', gap: '6px' } },
                   dec.provider ? React.createElement('span', { className: 'dsub-brand dsub-brand-' + dec.provider, style: { fontSize: '9px', padding: '1px 4px' } }, dec.provider.toUpperCase()) : null,
@@ -1640,6 +1812,57 @@ const cssId = 'dsh-subscriptions/settings.module.css'
           React.createElement('div', { className: 'dsub-sub' },
             t('expiryNotifyDaysHint')),
           ),
+          React.createElement('details', { className: 'dsub-group', open: true },
+            React.createElement('summary', { className: 'dsub-groupHead' }, '🚦 ' + t('groupQueue')),
+            React.createElement('label', { className: 'dsub-row' },
+              React.createElement('input', {
+                type: 'checkbox',
+                checked: draft.enableQueue !== false,
+                onChange: function(e) { setDraft(function(d) { return Object.assign({}, d, { enableQueue: e.target.checked }) }) },
+              }),
+              React.createElement('span', null, t('enableQueue')),
+            ),
+            React.createElement('div', { className: 'dsub-sub' }, t('enableQueueHint')),
+            React.createElement('div', { className: 'dsub-row' },
+              React.createElement('span', { className: 'dsub-h' }, t('accountMaxConcurrency')),
+              React.createElement('input', {
+                type: 'number',
+                className: 'dsub-inp',
+                style: { width: '80px', minWidth: '80px' },
+                min: 1,
+                max: 20,
+                value: draft.accountMaxConcurrency != null ? draft.accountMaxConcurrency : 2,
+                onChange: function(e) { setDraft(function(d) { return Object.assign({}, d, { accountMaxConcurrency: Math.max(1, Number(e.target.value) || 2) }) }) },
+              }),
+            ),
+            React.createElement('div', { className: 'dsub-sub' }, t('accountMaxConcurrencyHint')),
+            React.createElement('div', { className: 'dsub-row' },
+              React.createElement('span', { className: 'dsub-h' }, t('maxQueueSize')),
+              React.createElement('input', {
+                type: 'number',
+                className: 'dsub-inp',
+                style: { width: '80px', minWidth: '80px' },
+                min: 1,
+                max: 100,
+                value: draft.maxQueueSize != null ? draft.maxQueueSize : 20,
+                onChange: function(e) { setDraft(function(d) { return Object.assign({}, d, { maxQueueSize: Math.max(1, Number(e.target.value) || 20) }) }) },
+              }),
+            ),
+            React.createElement('div', { className: 'dsub-sub' }, t('maxQueueSizeHint')),
+            React.createElement('div', { className: 'dsub-row' },
+              React.createElement('span', { className: 'dsub-h' }, t('queueTimeoutSec')),
+              React.createElement('input', {
+                type: 'number',
+                className: 'dsub-inp',
+                style: { width: '80px', minWidth: '80px' },
+                min: 1,
+                max: 120,
+                value: Math.round((draft.queueTimeoutMs != null ? draft.queueTimeoutMs : 30000) / 1000),
+                onChange: function(e) { setDraft(function(d) { return Object.assign({}, d, { queueTimeoutMs: Math.max(1, Number(e.target.value) || 30) * 1000 }) }) },
+              }),
+            ),
+            React.createElement('div', { className: 'dsub-sub' }, t('queueTimeoutSecHint')),
+          ),
           React.createElement('details', { className: 'dsub-group', open: true },
             React.createElement('summary', { className: 'dsub-groupHead' }, t('groupProvider')),
           React.createElement('label', { className: 'dsub-row' },
@@ -1791,6 +2014,7 @@ const cssId = 'dsh-subscriptions/settings.module.css'
         ),
         React.createElement('div', { className: 'dsub-block' },
           React.createElement('div', { className: 'dsub-row' },
+            React.createElement('button', { type: 'button', className: 'dsub-mini', onClick: () => runWizard(null, null, null, false) }, '🩺 ' + t('wizardAll')),
             React.createElement('button', { type: 'button', className: 'dsub-mini', onClick: genDiag }, t('diagGenerate')),
             React.createElement('button', { type: 'button', className: 'dsub-mini', onClick: runAnalyzeSession }, analyzingCache ? '…' : t('cacheAnalyze')),
             React.createElement('button', { type: 'button', className: 'dsub-mini', onClick: () => { setBackupModal('export'); setBackupErr(''); setBackupInfo('') } }, '🔒 ' + t('backupExport')),
@@ -1809,6 +2033,72 @@ const cssId = 'dsh-subscriptions/settings.module.css'
             }, t('diagCopy')),
             React.createElement('pre', { className: 'dsub-diag' }, diag),
           ) : null,
+          wizardModal ? React.createElement('div', { className: 'dsub-modalWrap', onClick: (e) => { if (e.target === e.currentTarget) setWizardModal(null) } },
+            React.createElement('div', { className: 'dsub-modal' },
+              React.createElement('div', { className: 'dsub-modalHead' },
+                React.createElement('div', { className: 'dsub-modalTitleWrap' },
+                  React.createElement('div', { className: 'dsub-modalIcon' }, '🩺'),
+                  React.createElement('div', null,
+                    React.createElement('div', { style: { fontWeight: 700, fontSize: '15px' } }, t('wizardTitle')),
+                    React.createElement('div', { style: { fontSize: '11.5px', opacity: 0.7 } },
+                      wizardModal.provider && wizardModal.provider !== 'all' ? (wizardModal.provider.toUpperCase() + ' #' + wizardModal.index + (wizardModal.ref ? ' (' + wizardModal.ref + ')' : '')) : t('wizardAll')
+                    ),
+                  ),
+                ),
+                React.createElement('button', { type: 'button', className: 'dsub-mini', onClick: () => setWizardModal(null) }, '✕ ' + t('closeModal')),
+              ),
+              React.createElement('div', { style: { marginTop: '14px' } },
+                React.createElement('label', { className: 'dsub-row', style: { marginBottom: '10px' } },
+                  React.createElement('input', {
+                    type: 'checkbox',
+                    checked: !!wizardModal.includeNetwork,
+                    onChange: (e) => runWizard(wizardModal.provider === 'all' ? null : wizardModal.provider, wizardModal.index, wizardModal.ref, e.target.checked),
+                  }),
+                  React.createElement('span', { style: { fontSize: '12px' } }, t('wizardIncludeNetwork')),
+                ),
+                wizardModal.loading ? React.createElement('div', { className: 'dsub-alert-ok', style: { marginBottom: '12px' } }, '⏳ ' + t('wizardRunning')) : null,
+                wizardModal.error ? React.createElement('div', { className: 'dsub-alert-bad', style: { marginBottom: '12px' } }, wizardModal.error) : null,
+                wizardModal.report ? React.createElement('div', null,
+                  React.createElement('div', { style: { display: 'flex', alignItems: 'center', justifyContent: 'space-between', marginBottom: '12px' } },
+                    React.createElement('span', {
+                      className: 'dsub-badge ' + (wizardModal.report.overallStatus === 'healthy' ? 'dsub-badge-ok' : (wizardModal.report.overallStatus === 'degraded' ? 'dsub-badge-warn' : 'dsub-badge-bad'))
+                    }, (wizardModal.report.overallStatus === 'healthy' ? '🟢 ' + t('wizardHealthy') : (wizardModal.report.overallStatus === 'degraded' ? '🟡 ' + t('wizardDegraded') : '🔴 ' + t('wizardFailing')))),
+                    React.createElement('span', { style: { fontSize: '11.5px', opacity: 0.7 } },
+                      wizardModal.report.summary.passed + ' passed · ' + wizardModal.report.summary.warnings + ' warn · ' + wizardModal.report.summary.failed + ' fail'
+                    ),
+                  ),
+                  React.createElement('div', { className: 'dsub-trace-box', style: { marginBottom: '12px' } },
+                    wizardModal.report.steps.map((st, idx) => {
+                      const icon = st.status === 'pass' ? '✅' : (st.status === 'warn' ? '⚠️' : (st.status === 'fail' ? '❌' : '⚪'))
+                      const color = st.status === 'pass' ? 'var(--dsw-alias-state-success-primary)' : (st.status === 'warn' ? 'var(--dsw-alias-state-warn-primary)' : (st.status === 'fail' ? 'var(--dsw-alias-state-error-primary)' : 'var(--dsw-alias-label-secondary)'))
+                      return React.createElement('div', { key: idx, className: 'dsub-trace-row' },
+                        React.createElement('div', { style: { display: 'flex', alignItems: 'center', gap: '8px' } },
+                          React.createElement('span', null, icon),
+                          React.createElement('span', { style: { fontWeight: 600 } }, st.name),
+                          st.latencyMs != null ? React.createElement('span', { style: { fontSize: '10px', opacity: 0.6 } }, st.latencyMs + 'ms') : null,
+                        ),
+                        React.createElement('span', { style: { fontSize: '11px', color: color } }, st.message),
+                      )
+                    })
+                  ),
+                  wizardModal.report.recommendations && wizardModal.report.recommendations.length ? React.createElement('div', { style: { marginBottom: '12px' } },
+                    React.createElement('div', { style: { fontSize: '11.5px', fontWeight: 600, color: 'var(--dsw-alias-state-warn-primary)', marginBottom: '4px' } }, '💡 ' + t('wizardRecommendations')),
+                    wizardModal.report.recommendations.map((rec, rIdx) => React.createElement('div', { key: rIdx, className: 'dsub-alert-bad', style: { marginBottom: '4px', fontSize: '11.5px' } }, rec))
+                  ) : null,
+                  React.createElement('div', { style: { display: 'flex', justifyContent: 'flex-end', gap: '8px', marginTop: '10px' } },
+                    React.createElement('button', {
+                      type: 'button',
+                      className: 'dsub-mini',
+                      onClick: () => {
+                        const txt = JSON.stringify(wizardModal.report, null, 2)
+                        try { navigator.clipboard.writeText(txt) } catch { /* ignore */ }
+                      },
+                    }, '📋 ' + t('wizardCopy')),
+                  ),
+                ) : null,
+              ),
+            ),
+          ) : null,
           backupModal ? React.createElement('div', { className: 'dsub-panel-box', style: { marginTop: '10px' } },
             React.createElement('div', { className: 'dsub-panel-title' },
               React.createElement('span', null, backupModal === 'export' ? ('🔒 ' + t('backupExportTitle')) : ('📥 ' + t('backupImportTitle'))),
@@ -1909,6 +2199,12 @@ const cssId = 'dsh-subscriptions/settings.module.css'
                     disabled: checking[key],
                     onClick: () => doCheck(row.slot.provider, row.slot.index).catch((e) => setErr(cleanErrorMessage(e.message || e))),
                   }, checking[key] ? t('checking') : t('check')),
+                  React.createElement('button', {
+                    type: 'button', className: 'dsub-mini',
+                    title: t('wizardTitle'),
+                    onClick: () => runWizard(row.slot.provider, row.slot.index, row.slot.ref, false),
+                  }, '🩺 ' + t('wizardButton')),
+                  
                   (account && account.quarantineUntil && Number(account.quarantineUntil) > Date.now() ? React.createElement(React.Fragment, null,
                     React.createElement('button', {
                       type: 'button', className: 'dsub-mini', title: t('probeWarmupTitle'),

package/lib/concurrency-queue.js

@@ -0,0 +1,222 @@
+// Concurrency limiting, bounded queue, and cooperative cancellation per account/provider.
+// Standardized error codes: QUEUE_OVERFLOW, QUEUE_TIMEOUT, ABORT_ERR, QUEUE_DISPOSED.
+
+/**
+ * @param {string} message
+ * @param {string} code
+ * @param {number} [status]
+ * @returns {Error & { code: string, status?: number }}
+ */
+function createQueueError(message, code, status) {
+  const err = /** @type {Error & { code: string, status?: number }} */ (new Error(message))
+  err.code = code
+  if (status !== undefined) err.status = status
+  return err
+}
+
+export class ConcurrencyQueue {
+  constructor(options = {}) {
+    this.maxConcurrency = options.maxConcurrency !== undefined ? Number(options.maxConcurrency) : 2
+    this.maxQueueSize = options.maxQueueSize !== undefined ? Number(options.maxQueueSize) : 20
+    this.timeoutMs = options.timeoutMs !== undefined ? Number(options.timeoutMs) : 30000
+    this.enabled = options.enabled !== undefined ? Boolean(options.enabled) : true
+
+    /** @type {Map<string, number>} */
+    this._active = new Map()
+    /** @type {Map<string, Array<{ id: string, resolve: Function, reject: Function, timer: any, signal: any, abortHandler: Function | null, enqueuedAt: number }>>} */
+    this._waiting = new Map()
+
+    this._stats = {
+      totalAcquired: 0,
+      totalReleased: 0,
+      totalQueued: 0,
+      totalTimedOut: 0,
+      totalOverflowed: 0,
+      totalAborted: 0,
+    }
+  }
+
+  configure(options = {}) {
+    if (options.maxConcurrency !== undefined) this.maxConcurrency = Number(options.maxConcurrency)
+    if (options.maxQueueSize !== undefined) this.maxQueueSize = Number(options.maxQueueSize)
+    if (options.timeoutMs !== undefined) this.timeoutMs = Number(options.timeoutMs)
+    if (options.enabled !== undefined) this.enabled = Boolean(options.enabled)
+  }
+
+  async acquire(key = 'default', options = {}) {
+    if (!this.enabled) {
+      return () => {}
+    }
+
+    const signal = options.signal
+    if (signal && signal.aborted) {
+      const err = createQueueError('Request aborted before acquiring queue slot', 'ABORT_ERR')
+      err.name = 'AbortError'
+      this._stats.totalAborted++
+      throw err
+    }
+
+    const k = String(key || 'default')
+    const active = this._active.get(k) || 0
+    const limit = options.maxConcurrency !== undefined ? Number(options.maxConcurrency) : this.maxConcurrency
+
+    if (active < limit) {
+      this._active.set(k, active + 1)
+      this._stats.totalAcquired++
+      return this._createRelease(k)
+    }
+
+    // Queue is required
+    const queueList = this._waiting.get(k) || []
+    const maxQ = options.maxQueueSize !== undefined ? Number(options.maxQueueSize) : this.maxQueueSize
+
+    if (queueList.length >= maxQ) {
+      this._stats.totalOverflowed++
+      const err = createQueueError(`Concurrency queue overflow for ${k} (max queue size: ${maxQ})`, 'QUEUE_OVERFLOW', 429)
+      throw err
+    }
+
+    const timeoutDuration = options.timeoutMs !== undefined ? Number(options.timeoutMs) : this.timeoutMs
+    this._stats.totalQueued++
+
+    return new Promise((resolve, reject) => {
+      let timer = null
+      let abortHandler = null
+      const id = Math.random().toString(36).slice(2)
+
+      const cleanup = () => {
+        if (timer) clearTimeout(timer)
+        if (signal && abortHandler && typeof signal.removeEventListener === 'function') {
+          signal.removeEventListener('abort', abortHandler)
+        }
+      }
+
+      if (timeoutDuration > 0) {
+        timer = setTimeout(() => {
+          cleanup()
+          this._removeFromWaiting(k, id)
+          this._stats.totalTimedOut++
+          const err = createQueueError(`Concurrency queue wait timeout for ${k} after ${timeoutDuration}ms`, 'QUEUE_TIMEOUT', 504)
+          reject(err)
+        }, timeoutDuration)
+      }
+
+      if (signal) {
+        abortHandler = () => {
+          cleanup()
+          this._removeFromWaiting(k, id)
+          this._stats.totalAborted++
+          const err = createQueueError('Request aborted while waiting in concurrency queue', 'ABORT_ERR')
+          err.name = 'AbortError'
+          reject(err)
+        }
+        signal.addEventListener('abort', abortHandler, { once: true })
+      }
+
+      const item = {
+        id,
+        resolve: () => {
+          cleanup()
+          this._stats.totalAcquired++
+          resolve(this._createRelease(k))
+        },
+        reject: (err) => {
+          cleanup()
+          reject(err)
+        },
+        timer,
+        signal,
+        abortHandler,
+        enqueuedAt: Date.now(),
+      }
+
+      if (!this._waiting.has(k)) {
+        this._waiting.set(k, [])
+      }
+      this._waiting.get(k).push(item)
+    })
+  }
+
+  _createRelease(k) {
+    let released = false
+    return () => {
+      if (released) return
+      released = true
+      this._release(k)
+    }
+  }
+
+  _release(k) {
+    this._stats.totalReleased++
+    const waiting = this._waiting.get(k)
+    if (waiting && waiting.length > 0) {
+      const next = waiting.shift()
+      if (waiting.length === 0) this._waiting.delete(k)
+      // Hand over slot directly to next queued consumer
+      next.resolve()
+    } else {
+      const active = this._active.get(k) || 0
+      if (active <= 1) {
+        this._active.delete(k)
+      } else {
+        this._active.set(k, active - 1)
+      }
+    }
+  }
+
+  _removeFromWaiting(k, id) {
+    const list = this._waiting.get(k)
+    if (!list) return
+    const idx = list.findIndex((item) => item.id === id)
+    if (idx !== -1) {
+      list.splice(idx, 1)
+      if (list.length === 0) this._waiting.delete(k)
+    }
+  }
+
+  stats() {
+    let totalActive = 0
+    let totalQueued = 0
+    const byKey = {}
+
+    for (const [k, count] of this._active) {
+      totalActive += count
+      if (!byKey[k]) byKey[k] = { active: 0, queued: 0 }
+      byKey[k].active = count
+    }
+
+    for (const [k, list] of this._waiting) {
+      totalQueued += list.length
+      if (!byKey[k]) byKey[k] = { active: 0, queued: 0 }
+      byKey[k].queued = list.length
+    }
+
+    return {
+      enabled: this.enabled,
+      maxConcurrency: this.maxConcurrency,
+      maxQueueSize: this.maxQueueSize,
+      timeoutMs: this.timeoutMs,
+      totalActive,
+      totalQueued,
+      byKey,
+      metrics: { ...this._stats },
+    }
+  }
+
+  dispose() {
+    for (const [, list] of this._waiting) {
+      for (const item of list) {
+        if (item.timer) clearTimeout(item.timer)
+        if (item.signal && item.abortHandler && typeof item.signal.removeEventListener === 'function') {
+          item.signal.removeEventListener('abort', item.abortHandler)
+        }
+        const err = createQueueError('Concurrency queue was disposed', 'QUEUE_DISPOSED')
+        item.reject(err)
+      }
+    }
+    this._waiting.clear()
+    this._active.clear()
+  }
+}
+
+export const defaultConcurrencyQueue = new ConcurrencyQueue()

package/lib/config-schema.js

@@ -118,6 +118,14 @@ export const Config = z.object({
     .description('#485 Prioritize accounts with closest reset window to burn expiring quota first.'),
   drainSafetyPercent: z.number().volatile().default(5)
     .description('#485 Safety margin percent: avoid draining accounts below this threshold when alternatives exist.'),
+  enableQueue: z.boolean().volatile().default(true)
+    .description('#518 Bounded concurrency queue to prevent bursts of 429 errors.'),
+  accountMaxConcurrency: z.number().volatile().default(2)
+    .description('#518 Max concurrent requests per account before queuing.'),
+  maxQueueSize: z.number().volatile().default(20)
+    .description('#518 Max requests waiting in queue before reject.'),
+  queueTimeoutMs: z.number().volatile().default(30000)
+    .description('#518 Max queue wait time in ms before timeout.'),
   customVendors: z.array(z.any()).volatile().default([])
     .description('Declarative OpenAI-Responses-compatible providers. See README.'),
 })