@goodandready/dsh-clinebot 0.3.25 → 0.4.1

package/CHANGELOG.md

@@ -5,6 +5,38 @@ 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.4.1] - 2026-09-24
+
+### Fixed
+- **Slash Command Contract Fix**: Fixed `/cline` slash command handler to strictly adhere to DSH `@deepseek-ai/dsh-commands` runtime `CommandResult` contract `{ kind: 'success', text }` instead of returning raw strings, preventing `TypeError: command "cline" handler must return a CommandResult` in DSH chat.
+- **Provider Detection via SettingsForms describe() (#102)**: Updated `checkRegisteredInPiAi` to inspect `settings.describe()` descriptors directly without triggering `TypeError` on missing `get()` method in modern DSH `SettingsForms`. Added safe error absorption for `providers.clinebot` removal when already absent.
+- **Model Version Dots Preservation (#103)**: Fixed model parsing to preserve version dot notation (e.g. `claude-3.5-sonnet`, `deepseek-v4.5`), preventing incorrect dot stripping or catalog matching errors.
+- **Strict Credential Validation & HTTPS Key Verify (#82)**: Hardened `/save-key` and `/config` to strictly prevent bypassing `apiKeyEnv` naming rules (forbidding arbitrary standard env variables such as `OPENAI_API_KEY`), and enforced HTTPS for `/key/verify` remote endpoints.
+- **Settings Rollback & Error Display (#81)**: Implemented optimistic UI rollback and explicit error alert banner when model toggle or settings persistence fails, reloading current server state and properly cleaning up debounced unmount timers.
+- **Snapshot Warning Banner & Failover Localization (#104)**: Restored non-blocking warning banner when host `snapshotStatus === 'unavailable'`, and localized `Last failover: ...` via `t('accounts.last_failover')` across English and Chinese locale dictionaries.
+
+### Added
+- **Account Pool Form & Management Routes (#88)**: Completed full account pool UI with dedicated "Add Account" form (label, apiKeyEnv with auto-suggestions, secret input with show/hide toggle), account deletion with confirmation, model search input (`modelsSearch`), and category filter tabs (all, chat, coding, reasoning). Registered `POST /dsh-clinebot/accounts` and `POST /dsh-clinebot/accounts/delete` server endpoints.
+- **Provider Key Failover Verification (#85)**: Added behavioral test assertions confirming that `rotateToNextAccount` mutates `llm-pi-ai` provider settings with the rotated account's `apiKeyEnv`, and replaced source code string inspection in `settings-service.test.js` with pure behavioral mock tests.
+- **Repository Hygiene (#91)**: Pruned obsolete remote tracking branches, confirmed duplicate issue label resolution, and ensured clean working tree.
+
+## [0.4.0] - 2026-09-24
+
+### Added
+- **One-Click In-App Updater (#91)**: Self-update companion plugin directly from the DSH settings card or via loopback `POST /dsh-clinebot/update` with rate limiting, package manifest verification, and restart indicators.
+- **Real DSH Stream 429 & Quota Failover (#79)**: Intercepts HTTP 429 and quota exhaustion at the `llm/stream` waterfall level, automatically rotating to the next account in the pool with 30s storm protection and immediately synchronizing the provider's `apiKeyEnv` in `llm-pi-ai`.
+- **Dynamic Plan Models Discovery (#90)**: Discovers models dynamically from active ClinePass subscription plan via `POST /dsh-clinebot/models/sync`. Removes hardcoded pricing references from UI and settings.
+- **Stream Telemetry & Token Tracking (#83)**: Tracks real DSH chat requests through the ClineBot provider, prompt and completion tokens from stream usage chunks, stream latency, and error counts since process startup.
+- **Live API Key Verification (#84)**: Direct navigation to `https://app.cline.bot/settings/api-keys` and on-the-fly key verification endpoint `POST /dsh-clinebot/key/verify` displaying account email and subscription plan in the UI.
+- **Behavioral Test Suite (#85)**: Comprehensive test suite testing all write endpoints for HTTP 405 Method Not Allowed, HTTP 403 Forbidden on untrusted origins, service error reporting (503), and behavioral execution of all `/cline` slash subcommands.
+
+### Changed
+- **Hardened PUT /dsh-clinebot/config (#89)**: Merges from raw `live()`, accepts only known schema fields, strictly rejects unknown properties with 400 Bad Request, rejects deprecated `enabledModels`, and documents HTTP API in README.
+- **Cordis 4 Clean apply() Return (#89)**: `apply()` now returns `undefined` to eliminate `TypeError: Invalid effect` in Cordis 4, and dead branches without `ctx.inject` were removed.
+- **Strict Credential Naming Pattern (#82)**: Restricts `/dsh-clinebot/save-key` target environment variables strictly to `^CLINEBOT_API_KEY(_[A-Z0-9]+)?$`.
+- **Honest Persistence Reporting (#81)**: Write endpoints report honest errors and HTTP 503 when the DSH settings service is unavailable.
+- **UI and Locale Refinements (#86, #87, #88)**: Eliminated undeclared `ctx` reference in `PluginCard`, removed dead state loops in `SettingsPage`, corrected layout spacing and badge styling across localized cards.
+
 ## [0.3.25] - 2026-09-24
 
 ### Fixed

package/README.md

@@ -38,7 +38,7 @@
 
 ## ⚡ Overview & The Problem
 
-**ClinePass** (`https://cline.bot`) is a flat-rate subscription service ($9.99/mo) providing developers with 2–5x higher rate limits across premier open-weights coding and reasoning models through a single OpenAI-compatible endpoint (`https://api.cline.bot/api/v1`).
+**ClinePass** (`https://cline.bot`) is a subscription service providing developers with 2–5x higher rate limits across premier open-weights coding and reasoning models through a single OpenAI-compatible endpoint (`https://api.cline.bot/api/v1`).
 
 Integrating ClinePass into DeepSeek Harness (DSH) natively poses key challenges:
 1. **No `/v1/models` Discovery**: `GET /v1/models` on `api.cline.bot` returns `404 Not Found`. Dynamic discovery fails silently or leaves the provider with 0 models.
@@ -49,11 +49,11 @@ Integrating ClinePass into DeepSeek Harness (DSH) natively poses key challenges:
 **`@goodandready/dsh-clinebot`** provides a complete solution:
 * 🚀 **One-Click In-App Updater**: Upgrade `@goodandready/dsh-clinebot` directly from the DSH UI or trigger secure loopback updates via `/dsh-clinebot/update`.
 * ⚡ **SWR Quota & Health Caching**: Instantaneous response time (<2ms) on status queries with background revalidation.
-* 🔀 **Smart Quota-Aware Failover**: Automatic multi-account rotation skipping exhausted accounts and recovering when `resetsAt` is reached.
+* 🔀 **Smart Quota-Aware Failover**: Automatic multi-account rotation on stream HTTP 429 and exhausted quota (with 30s storm protection; current request is not retried, subsequent chat requests use the next available account).
 * 🖥️ **Plugin configuration page**: Open the installed ClineBot plugin and choose configure. The page shows the credential name, models, quota, and accounts. It is not a separate sidebar section.
-* 🔄 **Dynamic Subscription Model Sync**: Automatically pulls real models included in your ClinePass plan directly from `GET /api/v1/users/me/plan` with one-click DSH provider sync.
+* 🔄 **Dynamic Subscription Model Sync**: Automatically pulls real models included in your ClinePass plan directly from `GET /api/v1/users/me/plan` with one-click DSH provider sync. Only actual plan models are registered in DSH, while the built-in catalog serves as a rich properties reference and fallback when unsynced.
 * ⚠️ **Quota Exhaustion Alerts**: Real-time visual warning banners when 5-hour rolling limit reaches 80% (warning) and 95% (exhausted), complete with countdown to reset.
-* 📈 **Session Metrics Telemetry**: Live dashboard tracking request counts, token consumption estimates, latency, and last-request timestamp.
+* 📈 **Session Metrics Telemetry**: Live dashboard tracking real in-flight DSH chat requests through the ClineBot provider, prompt and completion tokens, stream latency, and error counts since process startup.
 * 📊 **Live Quota Dashboard**: Visual progress bars for 5-hour rolling limits and weekly windows from the official `GET /users/me/plan/usage-limits` API.
 * 🔑 **In-UI Key Storage**: Paste your API key directly in the UI; it is saved securely via `ctx.credentials.set()` into `~/.dsh/.credentials.yaml`.
 * 🎯 **Model Picker Management**: Granular checkboxes to choose which models appear in the chat picker.
@@ -137,7 +137,7 @@ Restart your DeepSeek Harness instance and refresh the browser.
 From any DSH chat session, type `/cline` to inspect quota, warning alerts, and session telemetry:
 
 ```text
-### 🤖 ClinePass Status (ClinePass ($9.99/mo))
+### 🤖 ClinePass Status (ClinePass)
 * Latency: ✅ 210 ms
 * Active Key: CLINEBOT_API_KEY (credentials)
 * Default Model: `cline-pass/deepseek-v4-flash`
@@ -189,6 +189,22 @@ dsh-clinebot:
 
 ---
 
+## 🌐 HTTP API Endpoints
+
+All endpoints are registered under `/dsh-clinebot/*` and protected against untrusted cross-site origins (same-origin and loopback allowed):
+
+* `GET /dsh-clinebot/status` — Live status report including provider health, active credential, quota, and session metrics.
+* `GET /dsh-clinebot/config` — Diagnostic endpoint returning public configuration without secret keys.
+* `PUT /dsh-clinebot/config` — Update configuration fields. Accepts only known schema properties (unknown fields or deprecated `enabledModels` return `400 Bad Request`).
+* `POST /dsh-clinebot/key/verify` — Validates a candidate API key against `api.cline.bot` and returns account email and plan name.
+* `POST /dsh-clinebot/save-key` — Saves a key into DSH credentials service under a valid `CLINEBOT_API_KEY*` name.
+* `POST /dsh-clinebot/models/sync` — Synchronizes models with your active subscription plan.
+* `POST /dsh-clinebot/models/toggle` — Toggles models via `disabledModels`.
+* `POST /dsh-clinebot/accounts/active` — Pins an active account from the account pool.
+* `POST /dsh-clinebot/smoke` — Runs a live latency test ping.
+
+---
+
 ## 🧪 Testing
 
 Run the automated test suite:

package/README.ru.md

@@ -38,7 +38,7 @@
 
 ## ⚡ Обзор и решаемая проблема
 
-**ClinePass** (`https://cline.bot`) — сервис единой фиксированной подписки (\$9.99/мес), предоставляющий разработчикам повышенные лимиты (в 2–5 раз выше стандартных) на передовые open-weights модели программирования и рассуждений через единый OpenAI-совместимый интерфейс (`https://api.cline.bot/api/v1`).
+**ClinePass** (`https://cline.bot`) — сервис единой фиксированной подписки, предоставляющий разработчикам повышенные лимиты (в 2–5 раз выше стандартных) на передовые open-weights модели программирования и рассуждений через единый OpenAI-совместимый интерфейс (`https://api.cline.bot/api/v1`).
 
 Интеграция ClinePass в DeepSeek Harness (DSH) напрямую сопряжена со следующими сложностями:
 1. **Отсутствие эндпоинта `/v1/models`**: запрос `GET /v1/models` к `api.cline.bot` возвращает `404 Not Found`, из-за чего динамический поиск моделей в DSH падает или оставляет список пустым.
@@ -49,11 +49,11 @@
 Плагин **`@goodandready/dsh-clinebot`** решает эти задачи «из коробки»:
 * 🚀 **Обновление в один клик**: Обновление плагина прямо из интерфейса DSH или через защищённый loopback-эндпоинт `/dsh-clinebot/update`.
 * ⚡ **SWR-кэширование квот и здоровья**: Мгновенный ответ (<2 мс) на запросы статуса с фоновым обновлением данных без блокировки UI.
-* 🔀 **Smart Quota-Aware Failover**: Интеллектуальная ротация аккаунтов с обходом исчерпанных лимитов и авто-восстановлением при наступлении `resetsAt`.
+* 🔀 **Smart Quota-Aware Failover**: Автоматическая ротация аккаунтов в пуле при ошибках 429 и исчерпании квоты в стриме (с 30-секундной защитой от шторма; текущий запрос не повторяется, последующие запросы сразу идут через следующий аккаунт).
 * 🖥️ **Страница конфигурации плагина**: откройте установленный ClineBot и перейдите в настройки плагина. Там имя учётных данных, модели, квота и аккаунты. Отдельного пункта бокового меню нет.
-* 🔄 **Динамическая синхронизация моделей подписки**: автоматическое получение реального списка моделей из `GET /api/v1/users/me/plan` и мгновенное обновление провайдера DSH в один клик.
+* 🔄 **Динамическая синхронизация моделей подписки**: автоматическое получение реального списка моделей из `GET /api/v1/users/me/plan` и мгновенное обновление провайдера DSH в один клик. В DSH регистрируются строго модели активного тарифа, а встроенный каталог служит справочником характеристик и запасным вариантом при недоступности API.
 * ⚠️ **Предупреждения об исчерпании квоты**: баннеры предупреждения при достижении 80% (внимание) и 95% (исчерпано) 5-часового лимита с таймером сброса.
-* 📈 **Метрики сессии**: учет количества запросов, расчетных токенов (Prompt / Completion), задержки и времени последнего вызова.
+* 📈 **Метрики сессии**: Учет реального трафика DSH-чатов через провайдер ClineBot с момента запуска (успешные, прерванные и ошибочные запросы, токены prompt/completion, задержка стрима).
 * 📊 **Дашборд лимитов подписки (Usage)**: наглядные прогресс-бары расхода 5-часового и недельного скользящего окна из официального API `GET /users/me/plan/usage-limits`.
 * 🔑 **Сохранение ключа прямо из UI**: поле ввода ключа с маскировкой; сохранение напрямую в системный сервис `credentials` (`~/.dsh/.credentials.yaml`) без ручной правки файлов на сервере.
 * 🎯 **Управление моделями в пикере**: включение/выключение отображения конкретных моделей в диалогах чата.
@@ -134,7 +134,7 @@ dsh plugin --profile web add @goodandready/dsh-clinebot
 В любой сессии чата введите команду `/cline` для проверки остатка лимитов, предупреждений и статистики:
 
 ```text
-### 🤖 ClinePass Status (ClinePass ($9.99/mo))
+### 🤖 ClinePass Status (ClinePass)
 * Пинг хоста: ✅ 210 мс
 * Активный ключ: CLINEBOT_API_KEY (credentials)
 * Модель по умолчанию: `cline-pass/deepseek-v4-flash`
@@ -184,6 +184,22 @@ dsh-clinebot:
 
 ---
 
+## 🌐 Маршруты HTTP API
+
+Все маршруты регистрируются с префиксом `/dsh-clinebot/*` и защищены от несанкционированных межсайтовых запросов (разрешены same-origin и loopback):
+
+* `GET /dsh-clinebot/status` — Текущее состояние провайдера, активный аккаунт, квоты и статистика сессий.
+* `GET /dsh-clinebot/config` — Диагностический маршрут, возвращающий открытую конфигурацию (без секретов).
+* `PUT /dsh-clinebot/config` — Обновление параметров конфигурации. Принимает только известные поля схемы (неизвестные поля и устаревшее `enabledModels` возвращают `400 Bad Request`).
+* `POST /dsh-clinebot/key/verify` — Проверка API-ключа на сервере `api.cline.bot` с возвратом email и названия тарифа.
+* `POST /dsh-clinebot/save-key` — Сохранение ключа в сервис credentials DSH под именем шаблона `CLINEBOT_API_KEY*`.
+* `POST /dsh-clinebot/models/sync` — Синхронизация списка моделей с официальным тарифом ClinePass.
+* `POST /dsh-clinebot/models/toggle` — Включение и отключение моделей через `disabledModels`.
+* `POST /dsh-clinebot/accounts/active` — Назначение активного аккаунта из пула.
+* `POST /dsh-clinebot/smoke` — Выполнение тестового пинга задержки.
+
+---
+
 ## 🧪 Тестирование
 
 Запуск автоматического набора тестов:

package/README.zh.md

@@ -38,7 +38,7 @@
 
 ## ⚡ 概述与解决的核心痛点
 
-**ClinePass** (`https://cline.bot`) 是一项固定月费（\$9.99/月）的高性价比订阅服务，为开发者提供主流开源代码模型与推理模型 2–5 倍的高并发调用限额，统一通过 OpenAI 兼容接口 (`https://api.cline.bot/api/v1`) 提供服务。
+**ClinePass** (`https://cline.bot`) 是一项高性价比订阅服务，为开发者提供主流开源代码模型与推理模型 2–5 倍的高并发调用限额，统一通过 OpenAI 兼容接口 (`https://api.cline.bot/api/v1`) 提供服务。
 
 在将 ClinePass 接入 DeepSeek Harness (DSH) 时存在以下挑战：
 1. **缺失 `/v1/models` 接口**：`api.cline.bot` 的 `GET /v1/models` 会直接返回 `404 Not Found`，导致动态模型同步失败或模型列表为空。
@@ -49,11 +49,11 @@
 **`@goodandready/dsh-clinebot`** 完美解决以上痛点：
 * 🚀 **应用内一键更新**：直接在 DSH 界面检查并升级插件，或通过受保护的 `/dsh-clinebot/update` 进行本地安全更新。
 * ⚡ **SWR 配额与健康状态缓存**：状态查询毫秒级响应（<2ms），并在后台静默更新，不阻塞前端渲染。
-* 🔀 **智能配额故障转移 (Smart Failover)**：多账号池自动轮询，避开耗尽账号并在 `resetsAt` 到达后自动恢复。
+* 🔀 **智能配额故障转移 (Smart Failover)**：在流式请求遇到 HTTP 429 或配额耗尽时自动轮换多账号（具备 30 秒防风暴保护；当前失败请求不自动重试，后续对话请求无缝使用下一个账号）。
 * 🖥️ **插件配置页**：打开已安装的 ClineBot，进入配置。页面包含凭据名、模型、配额和账号，不单独占用侧边栏。
-* 🔄 **订阅模型动态同步**：从官方 `GET /api/v1/users/me/plan` 自动提取真实包含模型，一键原子级同步至 DSH 提供商配置，无需等待插件更新。
+* 🔄 **订阅模型动态同步**：从官方 `GET /api/v1/users/me/plan` 自动提取真实包含模型，一键原子级同步至 DSH 提供商配置。DSH 严格仅注册当前套餐模型，内置目录作为特性参考并在未同步时作为备用。
 * ⚠️ **额度耗尽实时预警**：当 5 小时滑动窗口达到 80%（警告黄色）和 95%（即将耗尽红色）时展示醒目预警横幅与重置倒计时。
-* 📈 **会话统计与指标看板**：实时追踪请求调用次数、预估 Token（Prompt / Completion）、最近延迟及最后调用时间。
+* 📈 **会话统计与指标看板**：实时监控进程启动后经由 ClineBot 提供商发出的真实 DSH 对话请求、Prompt/Completion Token 消耗、流式延迟及错误统计。
 * 📊 **实时用量仪表盘**：调用官方 `GET /users/me/plan/usage-limits` API，实时渲染 5 小时与每周额度进度条及重置倒计时。
 * 🔑 **界面直存密钥**：在 UI 中直接粘贴 API 密钥，通过 `ctx.credentials.set()` 自动安全保存至 `~/.dsh/.credentials.yaml`。
 * 🎯 **模型选择器管理**：支持勾选开启/关闭特定模型在聊天选择器中的显示。
@@ -136,7 +136,7 @@ dsh plugin --profile web add @goodandready/dsh-clinebot
 在任何聊天会话中输入 `/cline` 即可即时检查配额、预警状态与会话指标：
 
 ```text
-### 🤖 ClinePass Status (ClinePass ($9.99/mo))
+### 🤖 ClinePass Status (ClinePass)
 * 响应延迟: ✅ 210 ms
 * 活跃密钥: CLINEBOT_API_KEY (credentials)
 * 默认模型: `cline-pass/deepseek-v4-flash`
@@ -186,6 +186,22 @@ dsh-clinebot:
 
 ---
 
+## 🌐 HTTP API 接口说明
+
+所有接口注册于 `/dsh-clinebot/*` 路径，并受到严格的跨站防护保护（仅允许同源或环回请求）：
+
+* `GET /dsh-clinebot/status` — 服务运行状态，包括健康探活、当前凭据名称、配额限制及会话统计。
+* `GET /dsh-clinebot/config` — 诊断接口，安全获取脱敏后的公共配置。
+* `PUT /dsh-clinebot/config` — 更新配置项。仅接受模式中的已知字段（未知字段或已废弃的 `enabledModels` 返回 `400 Bad Request`）。
+* `POST /dsh-clinebot/key/verify` — 向 `api.cline.bot` 发送探活请求实时验证密钥，返回绑定邮箱及套餐名称。
+* `POST /dsh-clinebot/save-key` — 将 API 密钥安全存储到 DSH credentials 服务。
+* `POST /dsh-clinebot/models/sync` — 同步 ClinePass 官方套餐内包含的全部动态模型。
+* `POST /dsh-clinebot/models/toggle` — 通过 `disabledModels` 批量切换模型可用性。
+* `POST /dsh-clinebot/accounts/active` — 从多账号池中指定当前主账号。
+* `POST /dsh-clinebot/smoke` — 发起快速探测并返回实时延迟。
+
+---
+
 ## 🧪 测试
 
 运行自动化测试套件：

package/lib/account-pool.js

@@ -11,6 +11,27 @@ function textSetting(value) {
   return typeof current === 'string' ? current.trim() : ''
 }
 
+function arraySetting(value) {
+  let current = value
+  while (current && typeof current === 'object' && !Array.isArray(current) && typeof current.get === 'function') {
+    current = current.get()
+  }
+  return Array.isArray(current) ? current : []
+}
+
+function toPlainSnapshot(cfg) {
+  if (!cfg || typeof cfg !== 'object') return cfg
+  const out = {}
+  for (const [k, v] of Object.entries(cfg)) {
+    let cur = v
+    while (cur && typeof cur === 'object' && !Array.isArray(cur) && typeof cur.get === 'function') {
+      cur = cur.get()
+    }
+    out[k] = cur
+  }
+  return out
+}
+
 export async function resolveAccountPool(ctx, cfg) {
   const apiKeyEnv = textSetting(cfg?.apiKeyEnv) || DEFAULT_API_KEY_ENV
   const defaultSlot = {
@@ -18,7 +39,7 @@ export async function resolveAccountPool(ctx, cfg) {
     label: 'Default',
     apiKeyEnv,
   }
-  const accounts = Array.isArray(cfg?.accounts) ? cfg.accounts : []
+  const accounts = arraySetting(cfg?.accounts)
   const allSlots = [defaultSlot, ...accounts]
   const activeAccount = textSetting(cfg?.activeAccount)
   const resolved = []
@@ -72,7 +93,7 @@ export async function rotateToNextAccount(ctx, cfg, reason = 'rate_limit', setti
     return { rotated: false, reason, message: 'Pool has only 1 configured account' }
   }
 
-  const active = String(cfg?.activeAccount || configured[0].apiKeyEnv)
+  const active = textSetting(cfg?.activeAccount) || configured[0].apiKeyEnv
   const currentIndex = configured.findIndex((acc) => acc.apiKeyEnv === active)
 
   // Candidate pool excluding current account if possible
@@ -105,7 +126,7 @@ export async function rotateToNextAccount(ctx, cfg, reason = 'rate_limit', setti
   let updated = false
   if (settingsApi?.replace) {
     try {
-      const next = { ...cfg, activeAccount: nextAcc.apiKeyEnv }
+      const next = { ...toPlainSnapshot(cfg), activeAccount: nextAcc.apiKeyEnv }
       await settingsApi.replace(next)
       updated = true
     } catch (err) {
@@ -140,11 +161,45 @@ export async function rotateToNextAccount(ctx, cfg, reason = 'rate_limit', setti
   clearUsageCache()
   clearProbeCache()
 
-  return {
+  const result = {
     rotated: true,
     previousAccount: active,
     activeAccount: nextAcc.apiKeyEnv,
     reason,
     updatedSettings: true,
   }
+
+  setLastRotation({
+    at: Date.now(),
+    reason,
+    from: active,
+    to: nextAcc.apiKeyEnv,
+  })
+
+  return result
+}
+
+let lastRotation = null
+
+export function getLastRotation() {
+  return lastRotation
 }
+
+export function setLastRotation(info) {
+  lastRotation = info
+}
+
+export function isQuotaExceededError(detail) {
+  if (!detail || typeof detail !== 'string') return false
+  const s = detail.toLowerCase()
+  return (
+    s.includes('quota') ||
+    s.includes('rate limit') ||
+    s.includes('exhausted') ||
+    s.includes('429') ||
+    s.includes('insufficient_quota') ||
+    s.includes('credit') ||
+    s.includes('too many requests')
+  )
+}
+