@goodandready/dsh-clinebot 0.6.17 → 0.6.18

package/CHANGELOG.md

@@ -5,6 +5,15 @@ All notable changes to `@goodandready/dsh-clinebot` will be documented in this f
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.6.18] - 2026-10-28
+
+### Added
+- **DSH 0.2.1-rc.4** is admitted and recorded in `dsh.compatibility.dshReleases`; the health matrix now covers rc.2, rc.3 and rc.4.
+
+### Fixed
+- **Insufficient credits** (HTTP 402): classified separately as `INSUFFICIENT_CREDITS`; the account is cooled down for 5 minutes only for the affected model, so other models keep working.
+- **Oversized requests** (HTTP 413 / JSON node limit): classified as non-retryable `REQUEST_TOO_LARGE` with an actionable message instead of a generic upstream error.
+
 ## [0.6.17] - 2026-10-28
 
 ### Fixed

package/README.md

@@ -4,7 +4,7 @@
 
 <h3>Native ClineBot / ClinePass Provider Companion for DeepSeek Harness</h3>
 
-<p><b>0.6.17</b> syncs dated ClinePass variants such as <code>deepseek-v4.1-flash-1017</code>, accepts the full DSH <code>0.2.1</code> prerelease line and keeps the multimodal/model/price improvements. Chat runs on the native <code>ctx.llm</code> adapter; the legacy <code>llm-pi-ai</code>, loopback proxy and <code>llm/stream</code> path are removed.</p>
+<p><b>0.6.18</b> adds DSH <code>0.2.1-rc.4</code> coverage, model-scoped credit cooldowns and actionable 402/413 errors. It keeps dated ClinePass model sync, the full <code>0.2.1</code> prerelease line and the multimodal/model/price improvements. Chat runs on the native <code>ctx.llm</code> adapter; the legacy <code>llm-pi-ai</code>, loopback proxy and <code>llm/stream</code> path are removed.</p>
 
 <p align="center">
   <a href="https://www.npmjs.com/package/@goodandready/dsh-clinebot"><img src="https://img.shields.io/npm/v/@goodandready/dsh-clinebot.svg?style=for-the-badge&color=6366f1&labelColor=1e1b4b" alt="npm version"></a>

package/README.ru.md

@@ -4,7 +4,7 @@
 
 <h3>Нативное подключение провайдера ClineBot / ClinePass для DeepSeek Harness</h3>
 
-<p><b>0.6.17</b> синхронизирует dated-варианты ClinePass, включая <code>deepseek-v4.1-flash-1017</code>, поддерживает всю линию DSH <code>0.2.1</code> и сохраняет улучшения мультимодальности, моделей и цен. Чат работает через нативный адаптер <code>ctx.llm</code>; старые <code>llm-pi-ai</code>, loopback-прокси и <code>llm/stream</code> удалены.</p>
+<p><b>0.6.18</b> добавляет DSH <code>0.2.1-rc.4</code>, cooldown недостатка кредитов только для конкретной модели и понятные ошибки 402/413. Сохраняются синхронизация dated-моделей ClinePass, вся линия DSH <code>0.2.1</code> и улучшения мультимодальности, моделей и цен. Чат работает через нативный адаптер <code>ctx.llm</code>; старые <code>llm-pi-ai</code>, loopback-прокси и <code>llm/stream</code> удалены.</p>
 
 <p align="center">
   <a href="https://www.npmjs.com/package/@goodandready/dsh-clinebot"><img src="https://img.shields.io/npm/v/@goodandready/dsh-clinebot.svg?style=for-the-badge&color=6366f1&labelColor=1e1b4b" alt="npm version"></a>

package/README.zh.md

@@ -4,7 +4,7 @@
 
 <h3>适用于 DeepSeek Harness 的 ClineBot / ClinePass 原生模型提供商伴侣插件</h3>
 
-<p><b>0.6.17</b> 同步 ClinePass 日期变体（包括 <code>deepseek-v4.1-flash-1017</code>），支持 DSH <code>0.2.1</code> 整条预发布线，并保留多模态、模型与价格改进。聊天使用原生 <code>ctx.llm</code> 适配器；旧的 <code>llm-pi-ai</code>、回环代理和 <code>llm/stream</code> 已删除。</p>
+<p><b>0.6.18</b> 增加 DSH <code>0.2.1-rc.4</code>、按模型隔离的余额不足冷却和明确的 402/413 错误。保留 ClinePass 日期变体同步、DSH <code>0.2.1</code> 整条预发布线以及多模态、模型与价格改进。聊天使用原生 <code>ctx.llm</code> 适配器；旧的 <code>llm-pi-ai</code>、回环代理和 <code>llm/stream</code> 已删除。</p>
 
 <p align="center">
   <a href="https://www.npmjs.com/package/@goodandready/dsh-clinebot"><img src="https://img.shields.io/npm/v/@goodandready/dsh-clinebot.svg?style=for-the-badge&color=6366f1&labelColor=1e1b4b" alt="npm version"></a>

package/lib/adapter.js

@@ -31,6 +31,7 @@ const PROVIDER_NAME = 'ClineBot (ClinePass)'
 const DEFAULT_CONTEXT_WINDOW = 200000
 const DEFAULT_MAX_TOKENS = 8192
 const COOLDOWN_MS = 60000
+const CREDIT_COOLDOWN_MS = 5 * 60 * 1000
 
 /**
  * Yield one already-consumed item before the rest of an async iterator.
@@ -370,11 +371,13 @@ export class ClineBotAdapter extends LlmAdapter {
           ...(retryAfter ? { providerRetryAfterMs: retryAfter } : {}),
         })
         if (classified.retryable && attempt + 1 < maxAttempts) {
+          const isCredit = classified.code === 'INSUFFICIENT_CREDITS'
           markAccountCooldown(
             accountId,
-            retryAfter || COOLDOWN_MS,
-            retryAfter ? Date.now() + retryAfter : null,
-            `upstream_${response.status}`,
+            isCredit ? CREDIT_COOLDOWN_MS : (retryAfter || COOLDOWN_MS),
+            isCredit ? null : (retryAfter ? Date.now() + retryAfter : null),
+            isCredit ? 'insufficient_credits' : `upstream_${response.status}`,
+            isCredit ? model : '',
           )
           continue
         }
@@ -505,9 +508,18 @@ export class ClineBotAdapter extends LlmAdapter {
           || normalized.code === 'PROVIDER_ERROR'
           || normalized.code === 'TRANSPORT_ERROR'
           || normalized.code === 'EMPTY_RESPONSE'
+          || normalized.code === 'INSUFFICIENT_CREDITS'
+          || normalized.code === 'QUOTA_EXCEEDED'
         lastError = normalized
         if (retryable && attempt + 1 < maxAttempts) {
-          markAccountCooldown(accountId, COOLDOWN_MS, null, 'upstream_pre_token_error')
+          const isCredit = normalized.code === 'INSUFFICIENT_CREDITS'
+          markAccountCooldown(
+            accountId,
+            isCredit ? CREDIT_COOLDOWN_MS : COOLDOWN_MS,
+            null,
+            isCredit ? 'insufficient_credits' : 'upstream_pre_token_error',
+            isCredit ? model : '',
+          )
           continue
         }
         this.recordAttempt({

package/lib/session-router.js

@@ -73,21 +73,26 @@ export function pruneSessions(now = Date.now(), maxLimit = MAX_SESSIONS, ttlMs =
  * Performs automatic recovery if the cooldown duration has passed.
  *
  * @param {string} accountId
+ * @param {string} [modelId] Optional model scope
  * @returns {boolean} true if account is currently blocked
  */
-export function isAccountInCooldown(accountId) {
-  if (!accountId) return false
-  const entry = cooldowns.get(accountId)
+function readCooldown(key, accountId) {
+  const entry = cooldowns.get(key)
   if (!entry) return false
-
   if (Date.now() >= entry.until) {
-    cooldowns.delete(accountId)
+    cooldowns.delete(key)
     emitAccountEvent({ type: 'recover', accountId, reason: entry.reason })
     return false
   }
   return true
 }
 
+export function isAccountInCooldown(accountId, modelId = '') {
+  if (!accountId) return false
+  if (readCooldown(accountId, accountId)) return true
+  return Boolean(modelId && readCooldown(`${accountId}::${modelId}`, accountId))
+}
+
 /**
  * Mark an account as in cooldown (rate-limited or quota exhausted).
  *
@@ -95,8 +100,9 @@ export function isAccountInCooldown(accountId) {
  * @param {number} [durationMs=60000] Default 60s cooldown if resetsAt is not provided
  * @param {string|number|null} [resetsAt] ISO string or timestamp of quota window reset
  * @param {string} [reason='rate_limit']
+ * @param {string} [modelId] Optional model scope
  */
-export function markAccountCooldown(accountId, durationMs = 60000, resetsAt = null, reason = 'rate_limit') {
+export function markAccountCooldown(accountId, durationMs = 60000, resetsAt = null, reason = 'rate_limit', modelId = '') {
   if (!accountId) return
 
   let until = Date.now() + durationMs
@@ -108,8 +114,9 @@ export function markAccountCooldown(accountId, durationMs = 60000, resetsAt = nu
     }
   }
 
-  cooldowns.set(accountId, { until, reason })
-  emitAccountEvent({ type: 'cooldown', accountId, reason, until })
+  const key = modelId ? `${accountId}::${modelId}` : accountId
+  cooldowns.set(key, { until, reason, accountId, ...(modelId ? { modelId } : {}) })
+  emitAccountEvent({ type: 'cooldown', accountId, reason, until, ...(modelId ? { modelId } : {}) })
 }
 
 export function matchesAccount(acc, identifier) {
@@ -117,12 +124,12 @@ export function matchesAccount(acc, identifier) {
   return acc.id === identifier || acc.apiKeyEnv === identifier || acc.label === identifier
 }
 
-export function isAccountBlocked(acc) {
+export function isAccountBlocked(acc, modelId = '') {
   if (!acc) return false
   return Boolean(
-    (acc.id && isAccountInCooldown(acc.id)) ||
-    (acc.apiKeyEnv && isAccountInCooldown(acc.apiKeyEnv)) ||
-    (acc.label && isAccountInCooldown(acc.label))
+    (acc.id && isAccountInCooldown(acc.id, modelId)) ||
+    (acc.apiKeyEnv && isAccountInCooldown(acc.apiKeyEnv, modelId)) ||
+    (acc.label && isAccountInCooldown(acc.label, modelId))
   )
 }
 
@@ -143,11 +150,11 @@ export function getAccountUsageMetric(acc) {
 
 let roundRobinCursor = 0
 
-export function getNextRoundRobinAccount(accounts = []) {
+export function getNextRoundRobinAccount(accounts = [], modelId = '') {
   if (!Array.isArray(accounts) || accounts.length === 0) {
     return null
   }
-  const available = accounts.filter(acc => acc && acc.present !== false && !isAccountBlocked(acc))
+  const available = accounts.filter(acc => acc && acc.present !== false && !isAccountBlocked(acc, modelId))
   const pool = available.length > 0 ? available : accounts.filter(acc => acc && acc.present !== false)
   if (pool.length === 0) {
     return accounts[0] || null
@@ -157,7 +164,7 @@ export function getNextRoundRobinAccount(accounts = []) {
   return chosen
 }
 
-export function selectLeastUsedAccount(accounts = []) {
+export function selectLeastUsedAccount(accounts = [], modelId = '') {
   if (!Array.isArray(accounts) || accounts.length === 0) {
     return null
   }
@@ -165,7 +172,7 @@ export function selectLeastUsedAccount(accounts = []) {
   // Filter available accounts that have keys present and are not in cooldown
   const available = accounts.filter(acc => {
     if (!acc || acc.present === false) return false
-    return !isAccountBlocked(acc)
+    return !isAccountBlocked(acc, modelId)
   })
 
   const candidatePool = available.length > 0 ? available : accounts.filter(a => a && a.present !== false)
@@ -209,7 +216,7 @@ export function resolveModelRouteAccount(modelId, modelRoutes = {}, safeAccounts
   if (!targetKey) return null
 
   const targetAcc = safeAccounts.find((a) => matchesAccount(a, targetKey))
-  if (targetAcc && !isAccountBlocked(targetAcc)) {
+  if (targetAcc && !isAccountBlocked(targetAcc, modelId)) {
     return targetAcc
   }
   return null
@@ -234,7 +241,7 @@ export function resolveSessionAccount(sessionId, accounts = [], defaultActiveId
     }
   }
 
-  const pinnedAvailable = pinnedAccount && !isAccountBlocked(pinnedAccount) ? pinnedAccount : null
+  const pinnedAvailable = pinnedAccount && !isAccountBlocked(pinnedAccount, model) ? pinnedAccount : null
 
   const routedAccount = resolveModelRouteAccount(model, modelRoutes, safeAccounts)
 
@@ -243,9 +250,9 @@ export function resolveSessionAccount(sessionId, accounts = [], defaultActiveId
       return routedAccount
     }
     if (accountMode === 'round_robin') {
-      return getNextRoundRobinAccount(safeAccounts) || safeAccounts[0]
+      return getNextRoundRobinAccount(safeAccounts, model) || safeAccounts[0]
     }
-    return selectLeastUsedAccount(safeAccounts) || safeAccounts[0]
+    return selectLeastUsedAccount(safeAccounts, model) || safeAccounts[0]
   }
 
   // If no sessionId provided:
@@ -324,7 +331,7 @@ export function resolveSessionAccount(sessionId, accounts = [], defaultActiveId
   // If in auto mode or pinned account is unavailable:
   if (existing) {
     const assigned = safeAccounts.find(a => matchesAccount(a, existing.accountId))
-    if (assigned && !isAccountBlocked(assigned)) {
+    if (assigned && !isAccountBlocked(assigned, model)) {
       existing.lastUsedAt = now
       return { account: assigned, isReassigned: false, reason: 'sticky_pinned' }
     }

package/lib/transport/cline-transport.js

@@ -9,7 +9,7 @@
 import { createRequire } from 'node:module'
 
 const require = createRequire(import.meta.url)
-let packageVersion = '0.6.17'
+let packageVersion = '0.6.18'
 try {
   packageVersion = require('../../package.json').version || packageVersion
 } catch {
@@ -106,9 +106,15 @@ export function classifyUpstreamStatus(status, bodyText = '') {
   if (status === 429) {
     return { code: 'RATE_LIMIT', retryable: true, message: `ClinePass rate limit exceeded (HTTP 429)${detail ? `: ${detail}` : ''}` }
   }
-  if (status === 402 || /quota|credit|usage limit|insufficient/i.test(lower)) {
+  if (status === 402 || /insufficient\s+credits?|not enough\s+credits?|credit balance|out of credits/i.test(lower)) {
+    return { code: 'INSUFFICIENT_CREDITS', retryable: true, message: `ClinePass account has insufficient credits (HTTP ${status})${detail ? `: ${detail}` : ''}` }
+  }
+  if (/quota|usage limit/i.test(lower)) {
     return { code: 'QUOTA_EXCEEDED', retryable: true, message: `ClinePass quota exhausted (HTTP ${status})${detail ? `: ${detail}` : ''}` }
   }
+  if (status === 413 || /too large|too many (?:json )?nodes?|request body.*(?:large|exceed)|payload too large/i.test(lower)) {
+    return { code: 'REQUEST_TOO_LARGE', retryable: false, message: `ClinePass request is too large (HTTP ${status}). Start a new session or reduce messages and images.${detail ? ` ${detail}` : ''}` }
+  }
   if (status === 400 && /context|too long|maximum context|token limit/i.test(lower)) {
     return { code: 'CONTEXT_WINDOW_EXCEEDED', retryable: false, message: `Context window exceeded (HTTP 400)${detail ? `: ${detail}` : ''}` }
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goodandready/dsh-clinebot",
-  "version": "0.6.17",
+  "version": "0.6.18",
   "description": "DeepSeek Harness companion for ClineBot / ClinePass: dynamic subscription models sync, quota exhaustion warnings, session metrics, dedicated settings page, live usage limits, and /cline slash-command.",
   "license": "MIT",
   "type": "module",
@@ -53,7 +53,8 @@
       "dsh": ">=0.2.1-rc.2 <0.2.2-0",
       "dshReleases": {
         "0.2.1-rc.2": "compatible",
-        "0.2.1-rc.3": "compatible"
+        "0.2.1-rc.3": "compatible",
+        "0.2.1-rc.4": "compatible"
       }
     },
     "client": {