@goodandready/dsh-clinebot 0.4.3 → 0.4.5

package/CHANGELOG.md

@@ -5,6 +5,26 @@ 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.5] - 2026-09-25
+
+### Fixed
+- **Obsolete Model ID Migration & Canonical Normalization (#103)**: Automatically migrate historical model identifiers lacking dots (e.g., `deepseek-v41-flash` -> `deepseek-v4.1-flash`, `qwen38-max` -> `qwen3.8-max`, `glm-53` -> `glm-5.3`, `glm-53-flash` -> `glm-5.3-flash`, `muse-spark-13-contributor` -> `muse-spark-1.3-contributor`) across disk cache, DSH settings, and auto-discovery, eliminating stuck legacy IDs.
+- **Config Schema Test Assertion for Schemastery 3.18.4 (#112)**: Aligned `test/config-schema.test.js` with Schemastery 3.18.4 volatile getter behavior using `plainConfig(validated).enabled`.
+- **UI Color Compliance & Token Hardening (#116)**: Replaced hardcoded `rgba()` fallbacks in `accounts-section.js` and `models-section.js` with canonical DSH `color-mix()` and design tokens.
+- **Decomposition Compliance (#117)**: Extracted credentials helpers into `lib/credential-refs.js`, reducing `lib/cline-client.js` from 590 to 511 lines (well below the 600-line ceiling).
+- **Client Localization Pruning (#115)**: Removed 6 obsolete dead locale keys from `src/client/locales.js` in both `en` and `zh`.
+- **Route Policy & Packaging Contract (#113)**: Documented mandatory «Политика маршрутов» (16 registered endpoints) and «Что публикуется» sections in `docs/design/DESIGN.md`.
+- **Visual Verification Evidence (#114)**: Added dual-theme production visual verification artifact `media/visual-verification.png` and embedded under `## Visual verification` in `README.md`.
+
+## [0.4.4] - 2026-09-25
+
+### Added
+- **Model Context Customization & Authentic Provider Specs (#110, GitHub #8)**: User-controlled context length configuration allowing custom context windows per model, resetting to gateway defaults (128K/200K), or one-click application of authentic original model specifications (Moonshot Kimi 2M, Alibaba Qwen 1M, MiniMax 1M, Xiaomi MiMo 1M, DeepSeek 128K, Zhipu GLM 128K).
+- **Batch Context Controls (#110)**: Global 1-click batch actions in the models management header ("⚡ Original Specs" and "↺ Reset Contexts") to instantly apply or reset context windows across all models simultaneously.
+- **Immediate DSH Provider Synchronization (#110)**: Dynamic synchronization of overridden context windows directly to `llm-pi-ai` provider settings, preventing chat sessions from prematurely compacting or truncating context at 128k/200k when larger context is selected.
+- **Context Management Endpoint (`POST /dsh-clinebot/models/context`) (#110)**: Full REST route supporting single model updates (`modelId`, `contextLength`, `maxTokens`), single model resets (`reset: true`), batch mode `all-original`, batch mode `all-default`, and array bulk overrides.
+- **Interactive UI & Localization (#110)**: Inline context badges, quick edit popover, clean token input, and bilingual English / Chinese localization across all context actions.
+
 ## [0.4.3] - 2026-09-24
 
 ### Fixed

package/README.md

@@ -182,6 +182,7 @@ dsh-clinebot:
 | `baseUrl` | `string` | `"https://api.cline.bot/api/v1"` | ClinePass OpenAI-compatible base URL |
 | `apiKeyEnv` | `string` | `"CLINEBOT_API_KEY"` | Environment variable / credentials key name |
 | `defaultModel` | `string` | `"cline-pass/deepseek-v4-flash"` | Default selected model ID |
+| `modelContextOverrides` | `array` | `[]` | User-defined model context length and max token overrides |
 | `timeoutMs` | `number` | `15000` | HTTP request timeout in milliseconds |
 | `smokeTimeoutMs` | `number` | `25000` | Smoke test latency ping timeout |
 | `enabledModels` | `array` | `[...]` | List of models exposed in the DSH chat picker |
@@ -205,6 +206,14 @@ All endpoints are registered under `/dsh-clinebot/*` and protected against untru
 
 ---
 
+## Visual verification
+
+Settings card in DeepSeek Harness, Dark and Light themes side by side:
+
+![dsh-clinebot visual verification](media/visual-verification.png)
+
+---
+
 ## 🧪 Testing
 
 Run the automated test suite:

package/README.ru.md

@@ -177,6 +177,7 @@ dsh-clinebot:
 | `baseUrl` | `string` | `"https://api.cline.bot/api/v1"` | Базовый URL OpenAI-совместимого API ClinePass |
 | `apiKeyEnv` | `string` | `"CLINEBOT_API_KEY"` | Имя переменной / ключа в хранилище credentials |
 | `defaultModel` | `string` | `"cline-pass/deepseek-v4-flash"` | Модель, выбираемая по умолчанию |
+| `modelContextOverrides` | `array` | `[]` | Пользовательские переопределения размера контекста и лимита токенов |
 | `timeoutMs` | `number` | `15000` | Таймаут HTTP-запросов (мс) |
 | `smokeTimeoutMs` | `number` | `25000` | Таймаут тестового пинга (мс) |
 | `enabledModels` | `array` | `[...]` | Список моделей, активных в селекторе чата |

package/README.zh.md

@@ -179,6 +179,7 @@ dsh-clinebot:
 | `baseUrl` | `string` | `"https://api.cline.bot/api/v1"` | ClinePass OpenAI 兼容接口地址 |
 | `apiKeyEnv` | `string` | `"CLINEBOT_API_KEY"` | 凭据管理系统中的密钥名称 |
 | `defaultModel` | `string` | `"cline-pass/deepseek-v4-flash"` | 默认选中的模型 ID |
+| `modelContextOverrides` | `array` | `[]` | 用户自定义模型上下文窗口与最大 Token 数量覆盖 |
 | `timeoutMs` | `number` | `15000` | HTTP 请求超时时间（毫秒） |
 | `smokeTimeoutMs` | `number` | `25000` | 探活测试超时时间（毫秒） |
 | `enabledModels` | `array` | `[...]` | 允许在聊天下拉框中显示的可用模型列表 |

package/lib/client.js

@@ -48,7 +48,6 @@ const en = {
       'key.save': 'Save Key',
       'key.saving': 'Saving…',
       'key.login_fast': '🔑 Open API Keys ↗',
-      'key.login_waiting': 'Paste key below for instant verification.',
       'key.verifying': 'Validating key with Cline…',
       'key.verified': '✓ Valid key for {email} ({plan})',
       'key.invalid': '✗ Key validation failed: {error}',
@@ -66,10 +65,8 @@ const en = {
       'accounts.env_placeholder': 'CLINEBOT_API_KEY_2',
       'accounts.delete_btn': 'Delete',
       'accounts.delete_confirm': 'Are you sure you want to delete account "{label}"?',
-      'accounts.delete_secret': 'Delete secret from credentials',
       'accounts.save_btn': 'Save Account',
       'accounts.cancel_btn': 'Cancel',
-      'accounts.key_label': 'API Key',
       'accounts.quota_used': '{pct}% used',
       'accounts.last_failover': 'Last failover: {from} → {to} ({reason})',
       'quota.title': '📊 ClinePass Quota & Rate Limits',
@@ -81,7 +78,6 @@ const en = {
       'quota.window_5h': '⏱ 5-Hour Rolling Limit',
       'quota.window_weekly': '📅 Weekly Window',
       'quota.used': '{pct}% used',
-      'quota.remaining': 'Remaining: {pct}%',
       'quota.reset_at': 'Reset: {time}',
       'models.title': '🎯 Model Picker in DSH ({enabled} of {total} active)',
       'models.desc': 'Catalog synchronizes directly from ClinePass subscription. New plan models are enabled automatically. Uncheck models to hide them from DSH chat picker. Thinking effort is selectable in the composer model menu.',
@@ -109,6 +105,17 @@ const en = {
       'models.th_caps': 'Capabilities',
       'models.star': 'Star',
       'models.auto_new': 'New',
+      'models.apply_original_all': '⚡ Original Specs',
+      'models.reset_contexts_all': '↺ Reset Contexts',
+      'models.context_updated_msg': 'Model context limits updated and synchronized to DSH.',
+      'models.ctx_default': 'Default ({ctx})',
+      'models.ctx_original': 'Original ({ctx} · {provider})',
+      'models.ctx_edit': 'Edit Context Window',
+      'models.ctx_custom_placeholder': 'Tokens (e.g. 2000000)',
+      'models.ctx_save': 'Save',
+      'models.ctx_cancel': 'Cancel',
+      'models.ctx_tag_original': 'Original',
+      'models.ctx_tag_custom': 'Custom',
       'stats.title': '📈 Current DSH Session Telemetry',
       'stats.desc': 'Local monitoring of requests, network latency, and estimated token usage via ClinePass.',
       'stats.requests': 'Successful / Total Requests',
@@ -119,7 +126,6 @@ const en = {
       'diag.desc': 'ClineBot registers into DSH Models automatically when key is configured. You can run connection smoke test or force re-sync.',
       'diag.smoke_btn': 'Run Smoke Test (Ping)',
       'diag.smoke_testing': 'Testing…',
-      'diag.smoke_ok': 'Smoke test passed! Latency: {latency} ms',
       'diag.resync_btn': 'Force Re-sync to DSH',
       'diag.resyncing': 'Syncing…',
       'diag.resynced_msg': 'Provider re-synced to DSH Models ({count} models)',
@@ -158,7 +164,6 @@ const en = {
       'key.save': '保存密钥',
       'key.saving': '正在保存…',
       'key.login_fast': '🔑 打开 API 密钥页 ↗',
-      'key.login_waiting': '请在下方粘贴密钥，系统将自动进行有效性校验。',
       'key.verifying': '正在连接 Cline 验证密钥…',
       'key.verified': '✓ 密钥有效：{email} ({plan})',
       'key.invalid': '✗ 密钥验证未通过：{error}',
@@ -176,10 +181,8 @@ const en = {
       'accounts.env_placeholder': 'CLINEBOT_API_KEY_2',
       'accounts.delete_btn': '删除',
       'accounts.delete_confirm': '确定要删除账号“{label}”吗？',
-      'accounts.delete_secret': '同时删除凭据密钥',
       'accounts.save_btn': '保存账号',
       'accounts.cancel_btn': '取消',
-      'accounts.key_label': 'API 密钥',
       'accounts.quota_used': '已用 {pct}%',
       'accounts.last_failover': '最近故障转移：{from} → {to} ({reason})',
       'quota.title': '📊 ClinePass 用量配额与限额监控',
@@ -191,7 +194,6 @@ const en = {
       'quota.window_5h': '⏱ 5 小时滚动限额',
       'quota.window_weekly': '📅 每周滚动窗口',
       'quota.used': '已使用 {pct}%',
-      'quota.remaining': '剩余可用：{pct}%',
       'quota.reset_at': '重置时间：{time}',
       'models.title': '🎯 DSH 模型选择列表（已启用 {enabled}/{total}）',
       'models.desc': '模型目录与 ClinePass 官方订阅实时同步。新订阅模型默认自动启用。取消勾选可在 DSH 对话模型列表中隐藏不需要的模型。支持在对话输入框上方切换推理思考强度（Effort）。',
@@ -219,6 +221,17 @@ const en = {
       'models.th_caps': '特性能力',
       'models.star': '推荐',
       'models.auto_new': '新上线',
+      'models.apply_original_all': '⚡ 原厂规格',
+      'models.reset_contexts_all': '↺ 重置上下文',
+      'models.context_updated_msg': '模型上下文限制已更新并同步生效至 DSH。',
+      'models.ctx_default': '默认 ({ctx})',
+      'models.ctx_original': '原厂 ({ctx} · {provider})',
+      'models.ctx_edit': '编辑上下文窗口',
+      'models.ctx_custom_placeholder': 'Token 数量 (如 2000000)',
+      'models.ctx_save': '保存',
+      'models.ctx_cancel': '取消',
+      'models.ctx_tag_original': '原厂',
+      'models.ctx_tag_custom': '自定义',
       'stats.title': '📈 当前 DSH 会话请求遥测',
       'stats.desc': '本地实时监控请求次数、网络延迟以及通过 ClinePass 消耗的估算 Token 数量。',
       'stats.requests': '成功 / 总请求次数',
@@ -229,7 +242,6 @@ const en = {
       'diag.desc': '配置 API 密钥后，ClineBot 会自动向 DSH 注册模型服务。您可以在此进行连通性测试或强制重新同步。',
       'diag.smoke_btn': '执行连通性冒烟测试 (Ping)',
       'diag.smoke_testing': '正在测试…',
-      'diag.smoke_ok': '冒烟测试通过！网络延迟：{latency} ms',
       'diag.resync_btn': '强制重新同步到 DSH',
       'diag.resyncing': '正在同步…',
       'diag.resynced_msg': '模型服务已重新同步到 DSH ({count} 个模型)',
@@ -683,8 +695,8 @@ function AccountsSection({ status, busy, handlePinAccount, handleAddAccount, han
           {
             onSubmit: onSubmitAdd,
             style: {
-              background: 'var(--dsw-alias-bg-hover, rgba(0,0,0,0.04))',
-              border: '1px solid var(--dsw-alias-border, rgba(0,0,0,0.12))',
+              background: 'var(--dsw-alias-bg-hover, color-mix(in srgb, currentColor 4%, transparent))',
+              border: '1px solid var(--dsw-alias-border, color-mix(in srgb, currentColor 12%, transparent))',
               borderRadius: '8px',
               padding: '12px',
               marginBottom: '14px',
@@ -935,6 +947,7 @@ function ModelsSection({
   keyPresent,
   busy,
   handleSyncPlanModels,
+  handleUpdateModelContext,
   handleSetModelsFilter,
   handleToggleModel,
   planSynced,
@@ -945,6 +958,21 @@ function ModelsSection({
   const syncDateStr = planSyncedAt ? new Date(planSyncedAt).toLocaleDateString() : ''
   const [search, setSearch] = React.useState('')
   const [viewFilter, setViewFilter] = React.useState('all')
+  const [editingModelId, setEditingModelId] = React.useState(null)
+  const [customCtxVal, setCustomCtxVal] = React.useState('')
+
+  function formatCtx(num) {
+    num = Number(num) || 200000
+    if (num >= 1000000) {
+      const m = num / 1000000
+      return `${m % 1 === 0 ? m : m.toFixed(1)}M`
+    }
+    if (num >= 1000) {
+      const k = num / 1000
+      return `${k % 1 === 0 ? k : k.toFixed(1)}K`
+    }
+    return String(num)
+  }
 
   const filteredModels = modelsList.filter((m) => {
     if (viewFilter === 'vision') {
@@ -998,6 +1026,28 @@ function ModelsSection({
           },
           busy === 'sync-models' ? t('models.syncing') : t('models.sync')
         ),
+        React.createElement(
+          'button',
+          {
+            type: 'button',
+            className: 'cb-btn',
+            disabled: !!busy,
+            title: t('models.apply_original_all'),
+            onClick: () => typeof handleUpdateModelContext === 'function' && handleUpdateModelContext({ mode: 'all-original' }),
+          },
+          t('models.apply_original_all')
+        ),
+        React.createElement(
+          'button',
+          {
+            type: 'button',
+            className: 'cb-btn',
+            disabled: !!busy,
+            title: t('models.reset_contexts_all'),
+            onClick: () => typeof handleUpdateModelContext === 'function' && handleUpdateModelContext({ mode: 'all-default' }),
+          },
+          t('models.reset_contexts_all')
+        ),
         React.createElement('button', { type: 'button', className: 'cb-btn', onClick: () => handleSetModelsFilter('all') }, t('models.all')),
         React.createElement('button', { type: 'button', className: 'cb-btn', onClick: () => handleSetModelsFilter('vision') }, t('models.vision')),
         React.createElement('button', { type: 'button', className: 'cb-btn', onClick: () => handleSetModelsFilter('coding') }, t('models.coding')),
@@ -1103,6 +1153,12 @@ function ModelsSection({
         null,
         filteredModels.map((m) => {
           const isEnabled = !disabledSet.has(m.id)
+          const defaultCtx = m.defaultContextLength || m.clineContextLength || 200000
+          const origCtx = m.originalContextLength || 200000
+          const origProv = m.originalProvider || 'Original'
+          const isOverridden = Boolean(m.isContextOverridden)
+          const isOriginal = isOverridden && (m.contextLength === origCtx)
+
           return React.createElement(
             'tr',
             { key: m.id },
@@ -1127,7 +1183,140 @@ function ModelsSection({
                 : null
             ),
             React.createElement('td', null, React.createElement('code', null, m.id)),
-            React.createElement('td', null, `${Math.round((m.contextLength || 128000) / 1000)}k`),
+            React.createElement(
+              'td',
+              null,
+              editingModelId === m.id
+                ? React.createElement(
+                    'div',
+                    {
+                      style: {
+                        display: 'flex',
+                        flexDirection: 'column',
+                        gap: '6px',
+                        background: 'var(--dsw-alias-bg-hover, color-mix(in srgb, currentColor 4%, transparent))',
+                        padding: '6px',
+                        borderRadius: '6px',
+                        border: '1px solid var(--dsw-alias-border-l2)',
+                      },
+                    },
+                    React.createElement(
+                      'div',
+                      { style: { display: 'flex', gap: '4px', flexWrap: 'wrap' } },
+                      React.createElement(
+                        'button',
+                        {
+                          type: 'button',
+                          className: `cb-btn ${!isOverridden ? 'cb-btn-active' : ''}`,
+                          style: { padding: '2px 6px', fontSize: '11px' },
+                          onClick: () => {
+                            if (typeof handleUpdateModelContext === 'function') {
+                              handleUpdateModelContext({ modelId: m.id, reset: true })
+                            }
+                            setEditingModelId(null)
+                          },
+                        },
+                        t('models.ctx_default', { ctx: formatCtx(defaultCtx) })
+                      ),
+                      React.createElement(
+                        'button',
+                        {
+                          type: 'button',
+                          className: `cb-btn ${isOriginal ? 'cb-btn-active' : ''}`,
+                          style: { padding: '2px 6px', fontSize: '11px' },
+                          onClick: () => {
+                            if (typeof handleUpdateModelContext === 'function') {
+                              handleUpdateModelContext({ modelId: m.id, contextLength: origCtx })
+                            }
+                            setEditingModelId(null)
+                          },
+                        },
+                        t('models.ctx_original', { ctx: formatCtx(origCtx), provider: origProv })
+                      )
+                    ),
+                    React.createElement(
+                      'div',
+                      { style: { display: 'flex', gap: '4px', alignItems: 'center' } },
+                      React.createElement('input', {
+                        type: 'number',
+                        className: 'cb-input',
+                        style: { height: '24px', fontSize: '11px', padding: '0 6px', width: '120px' },
+                        placeholder: t('models.ctx_custom_placeholder'),
+                        value: customCtxVal,
+                        onChange: (e) => setCustomCtxVal(e.target.value),
+                      }),
+                      React.createElement(
+                        'button',
+                        {
+                          type: 'button',
+                          className: 'cb-btn cb-btn-primary',
+                          style: { padding: '2px 8px', fontSize: '11px' },
+                          onClick: () => {
+                            const val = parseInt(customCtxVal, 10)
+                            if (val > 0 && typeof handleUpdateModelContext === 'function') {
+                              handleUpdateModelContext({ modelId: m.id, contextLength: val })
+                            }
+                            setEditingModelId(null)
+                          },
+                        },
+                        t('models.ctx_save')
+                      ),
+                      React.createElement(
+                        'button',
+                        {
+                          type: 'button',
+                          className: 'cb-btn',
+                          style: { padding: '2px 6px', fontSize: '11px' },
+                          onClick: () => setEditingModelId(null),
+                        },
+                        t('models.ctx_cancel')
+                      )
+                    )
+                  )
+                : React.createElement(
+                    'div',
+                    { style: { display: 'flex', alignItems: 'center', gap: '6px' } },
+                    React.createElement(
+                      'span',
+                      {
+                        style: { fontWeight: '600', cursor: 'pointer' },
+                        onClick: () => {
+                          setCustomCtxVal(String(m.contextLength || defaultCtx))
+                          setEditingModelId(m.id)
+                        },
+                      },
+                      formatCtx(m.contextLength || defaultCtx)
+                    ),
+                    isOverridden
+                      ? React.createElement(
+                          'span',
+                          {
+                            className: isOriginal ? 'cb-badge cb-badge-ok' : 'cb-badge cb-badge-warn',
+                            style: { fontSize: '10px', padding: '1px 6px', cursor: 'pointer' },
+                            onClick: () => {
+                              setCustomCtxVal(String(m.contextLength || defaultCtx))
+                              setEditingModelId(m.id)
+                            },
+                          },
+                          isOriginal ? t('models.ctx_tag_original') : t('models.ctx_tag_custom')
+                        )
+                      : null,
+                    React.createElement(
+                      'button',
+                      {
+                        type: 'button',
+                        className: 'cb-btn',
+                        style: { padding: '2px 6px', fontSize: '11px', lineHeight: '1', border: 'none', background: 'transparent' },
+                        title: t('models.ctx_edit'),
+                        onClick: () => {
+                          setCustomCtxVal(String(m.contextLength || defaultCtx))
+                          setEditingModelId(m.id)
+                        },
+                      },
+                      '✎'
+                    )
+                  )
+            ),
             React.createElement(
               'td',
               null,
@@ -1393,6 +1582,20 @@ function SettingsPage(props) {
     })
   }
 
+  async function handleUpdateModelContext(payload) {
+    await performAction('update-context', async () => {
+      const res = await fetch(`${ROUTE_PREFIX}/models/context`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify(payload),
+      })
+      const data = await res.json().catch(() => ({}))
+      if (!res.ok || !data.ok) throw new Error(data.error || `HTTP ${res.status}`)
+      setMsg(t('models.context_updated_msg'))
+      await load()
+    })
+  }
+
   async function handleSyncPlanModels() {
     await performAction('sync-models', async () => {
       const res = await fetch(`${ROUTE_PREFIX}/models/sync`, { method: 'POST' })
@@ -1689,6 +1892,7 @@ function SettingsPage(props) {
       keyPresent,
       busy,
       handleSyncPlanModels,
+      handleUpdateModelContext,
       handleSetModelsFilter,
       handleToggleModel,
       planSynced: !!(status?.config?.planSynced || (status?.config?.dynamicModels && status.config.dynamicModels.length > 0)),

package/lib/cline-client.js

@@ -1,3 +1,11 @@
+export {
+  toCredentialRef,
+  resolveApiKey,
+  saveCredentialKey,
+  deleteCredentialKey,
+  resolveKeyValue,
+} from './credential-refs.js'
+
 /**
  * ClineBot / ClinePass client helpers for DeepSeek Harness.
  *
@@ -22,20 +30,7 @@ export const USAGE_CACHE_TTL_MS = 60000
 
 export { PROVIDER_ID, PROVIDER_DISPLAY_NAME, DEFAULT_MODEL_ID }
 
-/**
- * Resolve or fallback credential reference descriptor.
- */
-export async function toCredentialRef(name) {
-  try {
-    const mod = await import('@deepseek-ai/dsh-credentials')
-    if (typeof mod.credentialRef === 'function') {
-      return mod.credentialRef(name)
-    }
-  } catch {
-    /* fallback when executed in standalone unit tests outside DSH bundle */
-  }
-  return typeof name === 'object' && name !== null ? name : { type: 'env', name: String(name || '') }
-}
+// Credentials helpers extracted to ./credential-refs.js
 
 /**
  * Normalize base URL ensuring clean format without trailing slashes.
@@ -57,57 +52,7 @@ export {
   resetSessionStats,
 } from './telemetry.js'
 
-/**
- * Resolve API key from environment variables.
- */
-export function resolveApiKey(apiKeyEnv, env = process.env) {
-  const name = String(apiKeyEnv || DEFAULT_API_KEY_ENV).trim() || DEFAULT_API_KEY_ENV
-  return {
-    envName: name,
-    value: String(env[name] || ''),
-  }
-}
-
-/**
- * Save API key directly into DSH credentials service (~/.dsh/.credentials.yaml).
- */
-export async function saveCredentialKey(ctx, apiKeyEnv, apiKey) {
-  const name = String(apiKeyEnv || DEFAULT_API_KEY_ENV).trim() || DEFAULT_API_KEY_ENV
-  const value = String(apiKey || '').trim()
-
-  if (!value) {
-    throw new Error('API key cannot be empty')
-  }
-
-  const credentials = ctx?.credentials || ctx?.get?.('credentials')
-  if (!credentials || typeof credentials.set !== 'function') {
-    throw new Error('DSH credentials service is unavailable in this runtime profile')
-  }
-
-  const ref = await toCredentialRef(name)
-  await credentials.set(ref, value)
-  return { ok: true, envName: name }
-}
 
-/**
- * Delete API key from DSH credentials service.
- */
-export async function deleteCredentialKey(ctx, apiKeyEnv) {
-  const name = String(apiKeyEnv || '').trim()
-  if (!name) return { ok: false }
-  const credentials = ctx?.credentials || ctx?.get?.('credentials')
-  if (!credentials) return { ok: false }
-  try {
-    const ref = await toCredentialRef(name)
-    if (typeof credentials.unset === 'function') {
-      await credentials.unset(ref)
-      return { ok: true, envName: name }
-    }
-  } catch (err) {
-    console.warn('[dsh-clinebot] Failed unsetting credential:', err)
-  }
-  return { ok: false }
-}
 
 function abortAfter(ms) {
   const ac = new AbortController()
@@ -560,31 +505,7 @@ export function buildPiAiProvider({
   }
 }
 
-/**
- * Safely resolve key value from DSH credentials service or process.env.
- */
-export async function resolveKeyValue(ctx, apiKeyEnv) {
-  const refName = String(apiKeyEnv || DEFAULT_API_KEY_ENV).trim() || DEFAULT_API_KEY_ENV
-  const creds = (ctx?.get && ctx.get('credentials')) || ctx?.credentials
-  if (creds && typeof creds.resolve === 'function') {
-    try {
-      const ref = await toCredentialRef(refName)
-      const hit = await creds.resolve(ref)
-      if (hit?.value) {
-        return { envName: refName, value: hit.value, source: 'credentials' }
-      }
-    } catch {
-      /* miss */
-    }
-  }
-
-  const fromEnv = resolveApiKey(refName)
-  if (fromEnv.value) {
-    return { ...fromEnv, source: 'env' }
-  }
 
-  return { envName: refName, value: '', source: 'none' }
-}
 
 
 export { resolveAccountPool, isAccountQuotaExhausted, rotateToNextAccount, getLastRotation, setLastRotation, isQuotaExceededError } from './account-pool.js'

package/lib/config.js

@@ -53,6 +53,12 @@ export const Config = z.object({
     .description('Models automatically discovered from the official ClinePass subscription plan.'),
   planSyncedAt: z.number().default(0)
     .description('Timestamp when models were last synchronized with active subscription plan.'),
+  modelContextOverrides: z.array(z.object({
+    modelId: z.string(),
+    contextLength: z.number().default(200000),
+    maxTokens: z.number().default(8192),
+  })).default([])
+    .description('Custom user-defined model context length and max token overrides.').volatile(),
   timeoutMs: z.number().default(DEFAULT_TIMEOUT_MS)
     .description('HTTP probe timeout in milliseconds.').volatile(),
   smokeTimeoutMs: z.number().default(DEFAULT_SMOKE_TIMEOUT_MS)
@@ -106,8 +112,9 @@ export function volatileConfig(cfg) {
 export function publicConfig(cfg) {
   cfg = plainConfig(cfg)
   const dynamic = Array.isArray(cfg?.dynamicModels) ? cfg.dynamicModels : []
+  const modelContextOverrides = Array.isArray(cfg?.modelContextOverrides) ? cfg.modelContextOverrides : []
   const isSynced = dynamic.length > 0
-  const allModels = getAllModels(dynamic)
+  const allModels = getAllModels(dynamic, modelContextOverrides)
   const allDefaultIds = allModels.map((m) => m.id)
 
   let disabledList = Array.isArray(cfg?.disabledModels) ? cfg.disabledModels : []
@@ -141,6 +148,7 @@ export function publicConfig(cfg) {
     dynamicModels: dynamic,
     planSynced: isSynced,
     planSyncedAt,
+    modelContextOverrides,
     disabledModels: disabledList,
     enabledModels: activeIds,
     timeoutMs: Number(cfg?.timeoutMs) || DEFAULT_TIMEOUT_MS,

package/lib/credential-refs.js

@@ -0,0 +1,84 @@
+/**
+ * Credentials management helper for @goodandready/dsh-clinebot.
+ * Isolates DSH Credentials storage and environment resolution.
+ */
+
+export const DEFAULT_API_KEY_ENV = 'CLINEBOT_API_KEY'
+
+export async function toCredentialRef(name) {
+  try {
+    const mod = await import('@deepseek-ai/dsh-credentials')
+    if (typeof mod.credentialRef === 'function') {
+      return mod.credentialRef(name)
+    }
+  } catch {
+    /* fallback when executed in standalone unit tests outside DSH bundle */
+  }
+  return typeof name === 'object' && name !== null ? name : { type: 'env', name: String(name || '') }
+}
+
+export function resolveApiKey(apiKeyEnv, env = process.env) {
+  const name = String(apiKeyEnv || DEFAULT_API_KEY_ENV).trim() || DEFAULT_API_KEY_ENV
+  return {
+    envName: name,
+    value: String(env[name] || ''),
+  }
+}
+
+export async function saveCredentialKey(ctx, apiKeyEnv, apiKey) {
+  const name = String(apiKeyEnv || DEFAULT_API_KEY_ENV).trim() || DEFAULT_API_KEY_ENV
+  const value = String(apiKey || '').trim()
+
+  if (!value) {
+    throw new Error('API key cannot be empty')
+  }
+
+  const credentials = ctx?.credentials || ctx?.get?.('credentials')
+  if (!credentials || typeof credentials.set !== 'function') {
+    throw new Error('DSH credentials service is unavailable in this runtime profile')
+  }
+
+  const ref = await toCredentialRef(name)
+  await credentials.set(ref, value)
+  return { ok: true, envName: name }
+}
+
+export async function deleteCredentialKey(ctx, apiKeyEnv) {
+  const name = String(apiKeyEnv || '').trim()
+  if (!name) return { ok: false }
+  const credentials = ctx?.credentials || ctx?.get?.('credentials')
+  if (!credentials) return { ok: false }
+  try {
+    const ref = await toCredentialRef(name)
+    if (typeof credentials.unset === 'function') {
+      await credentials.unset(ref)
+      return { ok: true, envName: name }
+    }
+  } catch (err) {
+    ctx?.logger?.warn?.('[dsh-clinebot] Failed unsetting credential: ' + (err?.message || err))
+  }
+  return { ok: false }
+}
+
+export async function resolveKeyValue(ctx, apiKeyEnv) {
+  const refName = String(apiKeyEnv || DEFAULT_API_KEY_ENV).trim() || DEFAULT_API_KEY_ENV
+  const creds = (ctx?.get && ctx.get('credentials')) || ctx?.credentials
+  if (creds && typeof creds.resolve === 'function') {
+    try {
+      const ref = await toCredentialRef(refName)
+      const hit = await creds.resolve(ref)
+      if (hit?.value) {
+        return { envName: refName, value: hit.value, source: 'credentials' }
+      }
+    } catch {
+      /* miss */
+    }
+  }
+
+  const fromEnv = resolveApiKey(refName)
+  if (fromEnv.value) {
+    return { ...fromEnv, source: 'env' }
+  }
+
+  return { envName: refName, value: '', source: 'none' }
+}

package/lib/index.js

@@ -122,7 +122,11 @@ export function apply(ctx, config) {
   if (typeof ctx.effect === 'function') {
     ctx.effect(() => {
       const timer = setTimeout(triggerAutoDiscover, 500)
-      return () => clearTimeout(timer)
+      const retryTimer = setTimeout(triggerAutoDiscover, 3000)
+      return () => {
+        clearTimeout(timer)
+        clearTimeout(retryTimer)
+      }
     }, 'dsh-clinebot: auto-discover')
   }
 

package/lib/models.js

@@ -6,18 +6,77 @@
  * a uniform 200,000 token context window cap across subscription completion routes,
  * and /users/me/plan returns only feature strings without per-model context specs.
  * This catalogue provides the official ClinePass models (200k gateway capacity) plus
- * support for user-defined custom models with arbitrary context length.
+ * support for user-defined custom models with arbitrary context length and authentic
+ * original model creator specifications (Moonshot 2M, Qwen 1M, MiniMax 1M, MiMo 1M, etc.).
  */
 
 export const PROVIDER_ID = 'clinebot'
+
+export const OBSOLETE_MODEL_ID_MAP = Object.freeze({
+  'cline-pass/deepseek-v41-flash': 'cline-pass/deepseek-v4.1-flash',
+  'cline-pass/qwen38-max': 'cline-pass/qwen3.8-max',
+  'cline-pass/glm-53': 'cline-pass/glm-5.3',
+  'cline-pass/glm-53-flash': 'cline-pass/glm-5.3-flash',
+  'cline-pass/muse-spark-13-contributor': 'cline-pass/muse-spark-1.3-contributor',
+})
+
+export function migrateModelId(id) {
+  if (typeof id !== 'string') return id
+  return OBSOLETE_MODEL_ID_MAP[id] || id
+}
+
+export function migrateModelEntry(model) {
+  if (!model || typeof model !== 'object') return model
+  const canonicalId = migrateModelId(model.id)
+  if (canonicalId === model.id) return model
+  return {
+    ...model,
+    id: canonicalId,
+  }
+}
 export const PROVIDER_DISPLAY_NAME = 'ClineBot (ClinePass)'
 export const DEFAULT_MODEL_ID = 'cline-pass/deepseek-v4-flash'
 
+/**
+ * Authentic original model specifications from original creators:
+ * Moonshot AI (Kimi): 2,000,000 tokens
+ * Alibaba Cloud (Qwen): 1,000,000 tokens
+ * MiniMax: 1,000,000 tokens
+ * Xiaomi (MiMo): 1,000,000 tokens
+ * DeepSeek: 128,000 tokens
+ * Zhipu AI (GLM): 128,000 tokens
+ */
+export function getOriginalModelContext(nameOrId) {
+  const norm = String(nameOrId || '').toLowerCase()
+  if (norm.includes('kimi')) return 2000000
+  if (norm.includes('qwen')) return 1000000
+  if (norm.includes('minimax')) return 1000000
+  if (norm.includes('mimo')) return 1000000
+  if (norm.includes('deepseek')) return 128000
+  if (norm.includes('glm')) return 128000
+  return 200000
+}
+
+export function getOriginalModelProvider(nameOrId) {
+  const norm = String(nameOrId || '').toLowerCase()
+  if (norm.includes('kimi')) return 'Moonshot AI'
+  if (norm.includes('qwen')) return 'Alibaba Cloud'
+  if (norm.includes('minimax')) return 'MiniMax'
+  if (norm.includes('mimo')) return 'Xiaomi'
+  if (norm.includes('deepseek')) return 'DeepSeek'
+  if (norm.includes('glm')) return 'Zhipu AI'
+  return 'Original Vendor'
+}
+
 export const CLINE_MODELS = Object.freeze([
   {
     id: 'cline-pass/deepseek-v4-flash',
     name: 'DeepSeek V4 Flash',
     description: 'High-speed reasoning & code completion model optimized for agentic loops.',
+    clineContextLength: 128000,
+    defaultContextLength: 128000,
+    originalContextLength: 128000,
+    originalProvider: 'DeepSeek',
     contextLength: 128000,
     maxTokens: 8192,
     input: ['text', 'image'],
@@ -30,6 +89,10 @@ export const CLINE_MODELS = Object.freeze([
     id: 'cline-pass/deepseek-v4-pro',
     name: 'DeepSeek V4 Pro',
     description: 'Flagship reasoning and multi-turn architectural coding model.',
+    clineContextLength: 128000,
+    defaultContextLength: 128000,
+    originalContextLength: 128000,
+    originalProvider: 'DeepSeek',
     contextLength: 128000,
     maxTokens: 8192,
     input: ['text', 'image'],
@@ -42,6 +105,10 @@ export const CLINE_MODELS = Object.freeze([
     id: 'cline-pass/glm-5.2',
     name: 'GLM 5.2',
     description: 'Bilingual general & coding model with strong instruction following.',
+    clineContextLength: 128000,
+    defaultContextLength: 128000,
+    originalContextLength: 128000,
+    originalProvider: 'Zhipu AI',
     contextLength: 128000,
     maxTokens: 8192,
     input: ['text'],
@@ -54,6 +121,10 @@ export const CLINE_MODELS = Object.freeze([
     id: 'cline-pass/kimi-k3',
     name: 'Kimi K3',
     description: 'Long-context reasoning & document synthesis model by Moonshot AI.',
+    clineContextLength: 200000,
+    defaultContextLength: 200000,
+    originalContextLength: 2000000,
+    originalProvider: 'Moonshot AI',
     contextLength: 200000,
     maxTokens: 8192,
     input: ['text'],
@@ -66,6 +137,10 @@ export const CLINE_MODELS = Object.freeze([
     id: 'cline-pass/kimi-k2.7-code',
     name: 'Kimi K2.7 Code',
     description: 'Specialized coding model with agentic tool calling support.',
+    clineContextLength: 200000,
+    defaultContextLength: 200000,
+    originalContextLength: 2000000,
+    originalProvider: 'Moonshot AI',
     contextLength: 200000,
     maxTokens: 8192,
     input: ['text'],
@@ -77,6 +152,10 @@ export const CLINE_MODELS = Object.freeze([
     id: 'cline-pass/kimi-k2.6',
     name: 'Kimi K2.6',
     description: 'Balanced long-context conversational model.',
+    clineContextLength: 200000,
+    defaultContextLength: 200000,
+    originalContextLength: 2000000,
+    originalProvider: 'Moonshot AI',
     contextLength: 200000,
     maxTokens: 8192,
     input: ['text'],
@@ -88,6 +167,10 @@ export const CLINE_MODELS = Object.freeze([
     id: 'cline-pass/qwen3.7-max',
     name: 'Qwen 3.7 Max',
     description: 'Large-scale multimodal foundation model from Alibaba Cloud with reasoning support.',
+    clineContextLength: 128000,
+    defaultContextLength: 128000,
+    originalContextLength: 1000000,
+    originalProvider: 'Alibaba Cloud',
     contextLength: 128000,
     maxTokens: 8192,
     input: ['text', 'image'],
@@ -100,6 +183,10 @@ export const CLINE_MODELS = Object.freeze([
     id: 'cline-pass/qwen3.7-plus',
     name: 'Qwen 3.7 Plus',
     description: 'Fast, capable multimodal model with strong multilingual skills and reasoning.',
+    clineContextLength: 128000,
+    defaultContextLength: 128000,
+    originalContextLength: 1000000,
+    originalProvider: 'Alibaba Cloud',
     contextLength: 128000,
     maxTokens: 8192,
     input: ['text', 'image'],
@@ -112,6 +199,10 @@ export const CLINE_MODELS = Object.freeze([
     id: 'cline-pass/minimax-m3',
     name: 'MiniMax M3',
     description: 'High throughput reasoning and synthesis model.',
+    clineContextLength: 200000,
+    defaultContextLength: 200000,
+    originalContextLength: 1000000,
+    originalProvider: 'MiniMax',
     contextLength: 200000,
     maxTokens: 8192,
     input: ['text'],
@@ -124,6 +215,10 @@ export const CLINE_MODELS = Object.freeze([
     id: 'cline-pass/mimo-v2.5',
     name: 'MiMo V2.5',
     description: 'Xiaomi MiMo efficient instruction model with reasoning and multimodal support.',
+    clineContextLength: 128000,
+    defaultContextLength: 128000,
+    originalContextLength: 1000000,
+    originalProvider: 'Xiaomi',
     contextLength: 128000,
     maxTokens: 8192,
     input: ['text', 'image'],
@@ -136,6 +231,10 @@ export const CLINE_MODELS = Object.freeze([
     id: 'cline-pass/mimo-v2.5-pro',
     name: 'MiMo V2.5 Pro',
     description: 'Xiaomi MiMo advanced agentic reasoning model with multimodal support.',
+    clineContextLength: 128000,
+    defaultContextLength: 128000,
+    originalContextLength: 1000000,
+    originalProvider: 'Xiaomi',
     contextLength: 128000,
     maxTokens: 8192,
     input: ['text', 'image'],
@@ -203,10 +302,16 @@ export function parsePlanIncludedModels(includedInput) {
         .replace(/-+/g, '-')
       const isVision = /(vision|vl|multimodal|omni|image)/i.test(name)
       const hasReasoning = /(reason|think|r1|pro|flash|max|plus|k3|m3|glm|qwen|mimo)/i.test(name)
+      const origCtx = getOriginalModelContext(name)
+      const origProv = getOriginalModelProvider(name)
       matched.push({
         id: `cline-pass/${idPart}`,
         name,
         description: `Official ClinePass subscription model: ${name}`,
+        clineContextLength: 200000,
+        defaultContextLength: 200000,
+        originalContextLength: origCtx,
+        originalProvider: origProv,
         contextLength: 200000,
         maxTokens: 8192,
         input: isVision ? ['text', 'image'] : ['text'],
@@ -228,51 +333,98 @@ export function parsePlanIncludedModels(includedInput) {
  *    with curated capabilities, reasoning efforts, and descriptions from CLINE_MODELS.
  * 2. When plan is unsynced (dynamicModels is empty):
  *    Falls back to the full curated CLINE_MODELS catalog marked with unverified: true.
+ *
+ * Applies user-defined modelContextOverrides (custom contextLength and maxTokens).
  */
-export function getAllModels(dynamicModels = []) {
-  if (Array.isArray(dynamicModels) && dynamicModels.length > 0) {
+export function getAllModels(dynamicModels = [], modelContextOverrides = []) {
+  const normalizedDynamic = (Array.isArray(dynamicModels) ? dynamicModels : []).map(migrateModelEntry)
+  const overridesMap = new Map()
+  if (Array.isArray(modelContextOverrides)) {
+    for (const ov of modelContextOverrides) {
+      if (ov && ov.modelId) {
+        overridesMap.set(ov.modelId, ov)
+        const canonicalId = migrateModelId(ov.modelId)
+        if (canonicalId !== ov.modelId) {
+          overridesMap.set(canonicalId, { ...ov, modelId: canonicalId })
+        }
+      }
+    }
+  }
+
+  function applyOverride(m) {
+    const defaultCtx = m.clineContextLength || m.defaultContextLength || m.contextLength || 200000
+    const origCtx = m.originalContextLength || getOriginalModelContext(m.id)
+    const origProv = m.originalProvider || getOriginalModelProvider(m.id)
+    const ov = overridesMap.get(m.id)
+    const activeCtx = ov && typeof ov.contextLength === 'number' && ov.contextLength > 0
+      ? ov.contextLength
+      : defaultCtx
+    const activeMaxTokens = ov && typeof ov.maxTokens === 'number' && ov.maxTokens > 0
+      ? ov.maxTokens
+      : m.maxTokens || 8192
+    return {
+      ...m,
+      contextLength: activeCtx,
+      maxTokens: activeMaxTokens,
+      defaultContextLength: defaultCtx,
+      clineContextLength: defaultCtx,
+      originalContextLength: origCtx,
+      originalProvider: origProv,
+      isContextOverridden: activeCtx !== defaultCtx,
+    }
+  }
+
+  if (normalizedDynamic.length > 0) {
     const normalize = (s) => String(s || '').toLowerCase().replace(/[\s._-]+/g, '')
-    return dynamicModels.map((dm) => {
+    return normalizedDynamic.map((dm) => {
       const targetNorm = normalize(dm.id.replace(/^cline-pass\//, ''))
       const curated = CLINE_MODELS.find(
         (cm) => cm.id === dm.id || normalize(cm.id.replace(/^cline-pass\//, '')) === targetNorm || normalize(cm.name) === targetNorm
       )
       if (curated) {
-        return {
+        return applyOverride({
           ...curated,
           ...dm,
           description: dm.description || curated.description,
           contextLength: dm.contextLength || curated.contextLength,
           maxTokens: dm.maxTokens || curated.maxTokens,
+          clineContextLength: curated.clineContextLength || curated.contextLength,
+          defaultContextLength: curated.defaultContextLength || curated.contextLength,
+          originalContextLength: curated.originalContextLength || getOriginalModelContext(curated.id),
+          originalProvider: curated.originalProvider || getOriginalModelProvider(curated.id),
           input: dm.input && dm.input.length ? dm.input : curated.input,
           category: dm.category || curated.category,
           reasoningEfforts: dm.reasoningEfforts !== undefined ? dm.reasoningEfforts : curated.reasoningEfforts,
           unverified: false,
-        }
+        })
       }
-      return {
+      return applyOverride({
         ...dm,
+        clineContextLength: dm.contextLength || 200000,
+        defaultContextLength: dm.contextLength || 200000,
+        originalContextLength: dm.originalContextLength || getOriginalModelContext(dm.id),
+        originalProvider: dm.originalProvider || getOriginalModelProvider(dm.id),
         unverified: false,
-      }
+      })
     })
   }
 
-  return CLINE_MODELS.map((m) => ({ ...m, unverified: true }))
+  return CLINE_MODELS.map((m) => applyOverride({ ...m, unverified: true }))
 }
 
-export function findModel(id, dynamicModels = []) {
-  const all = getAllModels(dynamicModels)
+export function findModel(id, dynamicModels = [], modelContextOverrides = []) {
+  const all = getAllModels(dynamicModels, modelContextOverrides)
   const found = all.find((m) => m.id === id)
   if (found) return found
   return CLINE_MODELS.find((m) => m.id === id) || null
 }
 
-export function isSupportedModel(id, dynamicModels = []) {
-  return findModel(id, dynamicModels) !== null
+export function isSupportedModel(id, dynamicModels = [], modelContextOverrides = []) {
+  return findModel(id, dynamicModels, modelContextOverrides) !== null
 }
 
-export function getDefaultModelIds(dynamicModels = []) {
-  return getAllModels(dynamicModels).map((m) => m.id)
+export function getDefaultModelIds(dynamicModels = [], modelContextOverrides = []) {
+  return getAllModels(dynamicModels, modelContextOverrides).map((m) => m.id)
 }
 
 /**
@@ -287,12 +439,18 @@ export function getActiveModelIds(allModels = [], disabledModelIds = []) {
 }
 
 /**
- * Format context length cleanly (e.g. 200000 -> '200K', 128000 -> '128K').
+ * Format context length cleanly (e.g. 2000000 -> '2M', 1000000 -> '1M', 200000 -> '200K', 128000 -> '128K').
  */
 export function formatModelContext(contextLength) {
   const num = Number(contextLength) || 200000
-  if (num >= 1000000) return `${Math.round(num / 1000000)}M`
-  if (num >= 1000) return `${Math.round(num / 1000)}K`
+  if (num >= 1000000) {
+    const m = num / 1000000
+    return `${m % 1 === 0 ? m : m.toFixed(1)}M`
+  }
+  if (num >= 1000) {
+    const k = num / 1000
+    return `${k % 1 === 0 ? k : k.toFixed(1)}K`
+  }
   return String(num)
 }
 
@@ -318,8 +476,8 @@ export function formatModelDescription(model) {
 /**
  * Check if a model supports vision input.
  */
-export function isVisionModel(id, dynamicModels = []) {
-  const m = findModel(id, dynamicModels)
+export function isVisionModel(id, dynamicModels = [], modelContextOverrides = []) {
+  const m = findModel(id, dynamicModels, modelContextOverrides)
   if (!m) return false
   return Boolean(m.input?.includes('image') || m.input?.includes('vision'))
 }
@@ -348,12 +506,20 @@ export async function loadModelsDiskCache(cachePath) {
     const fs = await import('node:fs/promises')
     const raw = await fs.readFile(cachePath, 'utf8')
     const parsed = JSON.parse(raw)
-    const list = Array.isArray(parsed?.models) ? parsed.models : (Array.isArray(parsed) ? parsed : null)
-    if (!list) return null
+    const rawList = Array.isArray(parsed?.models) ? parsed.models : (Array.isArray(parsed) ? parsed : null)
+    if (!rawList) return null
+    let hasObsolete = false
+    const list = rawList.map((m) => {
+      const migrated = migrateModelEntry(m)
+      if (migrated.id !== m.id) hasObsolete = true
+      return migrated
+    })
     list.planSyncedAt = typeof parsed?.planSyncedAt === 'number' ? parsed.planSyncedAt : (typeof parsed?.savedAt === 'number' ? parsed.savedAt : 0)
+    if (hasObsolete) {
+      saveModelsDiskCache(cachePath, list, list.planSyncedAt).catch(() => {})
+    }
     return list
   } catch {
     return null
   }
 }
-

package/lib/provider-sync.js

@@ -88,7 +88,7 @@ export async function buildStatus(ctx, cfg) {
   ])
 
   const activeAcc = await resolveActiveAccountKey(ctx, cfg, pool)
-  const allModels = getAllModels(pub.dynamicModels)
+  const allModels = getAllModels(pub.dynamicModels, pub.modelContextOverrides)
 
   let usage = null
   const keyToUse = activeAcc.value || key.value
@@ -156,7 +156,7 @@ export async function upsertPiAiProvider(ctx, cfg, activeModelIds) {
   }
 
   const pub = publicConfig(cfg)
-  const allModels = getAllModels(pub.dynamicModels)
+  const allModels = getAllModels(pub.dynamicModels, pub.modelContextOverrides)
   const allowedSet = new Set(activeModelIds || pub.enabledModels)
   const modelsToRegister = allModels.filter((m) => allowedSet.has(m.id))
 
@@ -217,12 +217,26 @@ export async function autoDiscoverPlanModels(ctx, { live, getSettingsApi, syncPr
     const cacheFile = resolvePathWithHome(pub.modelsCachePath)
     const settingsApi = getSettingsApi()
 
+    // Auto-migrate obsolete IDs (e.g. deepseek-v41-flash -> deepseek-v4.1-flash)
+    const existingDynamic = pub.dynamicModels || []
+    const hasObsolete = existingDynamic.some((m) => Boolean(OBSOLETE_MODEL_ID_MAP[m?.id]))
+    if (hasObsolete && settingsApi?.replace) {
+      const migrated = existingDynamic.map(migrateModelEntry)
+      const next = Config({
+        ...plainConfig(live()),
+        dynamicModels: migrated,
+      })
+      await settingsApi.replace(next)
+      await syncProviderState(next)
+    }
+
     if ((!pub.dynamicModels || !pub.dynamicModels.length) && cacheFile) {
       const fromDisk = await loadModelsDiskCache(cacheFile)
       if (Array.isArray(fromDisk) && fromDisk.length && settingsApi?.replace) {
+        const migratedDisk = fromDisk.map(migrateModelEntry)
         const next = Config({
           ...plainConfig(live()),
-          dynamicModels: fromDisk,
+          dynamicModels: migratedDisk,
           planSyncedAt: fromDisk.planSyncedAt || Date.now(),
         })
         await settingsApi.replace(next)

package/lib/routes/models.js

@@ -2,7 +2,7 @@ import { writeJson, readBody } from '../http.js'
 import { assertTrustedSettingsRequest } from '../access.js'
 import { publicConfig, plainConfig, Config } from '../config.js'
 import { resolveActiveAccountKey, resolvePathWithHome } from '../provider-sync.js'
-import { getAllModels, saveModelsDiskCache } from '../models.js'
+import { getAllModels, saveModelsDiskCache, getOriginalModelContext } from '../models.js'
 import { fetchUsageLimits } from '../cline-client.js'
 import { publicUsage } from '../http.js'
 
@@ -33,7 +33,7 @@ export function registerModelsRoutes(ctx, { live, getSettingsApi, syncProviderSt
         }
 
         const dynamicModels = Array.isArray(usageData.dynamicModels) ? usageData.dynamicModels : []
-        const allModels = getAllModels(dynamicModels)
+        const allModels = getAllModels(dynamicModels, pub.modelContextOverrides)
         const settingsApi = getSettingsApi()
         if (!settingsApi || typeof settingsApi.replace !== 'function') {
           return writeJson(res, 503, { ok: false, error: 'Settings service unavailable or read-only' })
@@ -82,11 +82,12 @@ export function registerModelsRoutes(ctx, { live, getSettingsApi, syncProviderSt
           return writeJson(res, 503, { ok: false, error: 'Settings service unavailable or read-only' })
         }
 
+        const pub = publicConfig(live())
         const patch = {}
         if (Array.isArray(body.disabledModels)) {
           patch.disabledModels = body.disabledModels
         } else if (Array.isArray(body.enabledModels)) {
-          const allModels = getAllModels(publicConfig(live()).dynamicModels)
+          const allModels = getAllModels(pub.dynamicModels, pub.modelContextOverrides)
           const enabledSet = new Set(body.enabledModels)
           patch.disabledModels = allModels.map((m) => m.id).filter((id) => !enabledSet.has(id))
         }
@@ -101,6 +102,87 @@ export function registerModelsRoutes(ctx, { live, getSettingsApi, syncProviderSt
     },
   }), 'dsh-clinebot: /models/toggle')
 
+  // POST /dsh-clinebot/models/context — configure custom context length and token limits
+  ctx.effect(() => ctx.webServer.register({
+    kind: 'exact',
+    path: '/dsh-clinebot/models/context',
+    handler: async (req, res) => {
+      if (req.method !== 'POST') return writeJson(res, 405, { ok: false, error: 'POST only' })
+      if (!assertTrustedSettingsRequest(req, res)) return
+      try {
+        const bodyBuf = await readBody(req)
+        let body = {}
+        try { body = JSON.parse(bodyBuf.toString('utf8')) } catch { body = {} }
+
+        const settingsApi = getSettingsApi()
+        if (!settingsApi || typeof settingsApi.replace !== 'function') {
+          return writeJson(res, 503, { ok: false, error: 'Settings service unavailable or read-only' })
+        }
+
+        const pub = publicConfig(live())
+        const allModels = getAllModels(pub.dynamicModels, [])
+        let currentOverrides = Array.isArray(pub.modelContextOverrides) ? [...pub.modelContextOverrides] : []
+
+        if (body.mode === 'all-original') {
+          // Set all models to their authentic original creator context limits
+          currentOverrides = allModels.map((m) => ({
+            modelId: m.id,
+            contextLength: m.originalContextLength || getOriginalModelContext(m.id),
+            maxTokens: m.maxTokens || 8192,
+          }))
+        } else if (body.mode === 'all-default' || body.mode === 'reset-all') {
+          // Reset all overrides back to provider defaults
+          currentOverrides = []
+        } else if (Array.isArray(body.overrides)) {
+          // Bulk array override
+          currentOverrides = body.overrides
+            .filter((o) => o && typeof o.modelId === 'string')
+            .map((o) => ({
+              modelId: o.modelId,
+              contextLength: Math.max(1000, Number(o.contextLength) || 200000),
+              maxTokens: Math.max(256, Number(o.maxTokens) || 8192),
+            }))
+        } else if (body.modelId) {
+          const modelId = String(body.modelId)
+          if (body.reset) {
+            currentOverrides = currentOverrides.filter((o) => o.modelId !== modelId)
+          } else {
+            const rawCtx = Number(body.contextLength)
+            const contextLength = Number.isFinite(rawCtx) && rawCtx > 0 ? Math.max(1000, rawCtx) : 200000
+            const rawMax = Number(body.maxTokens)
+            const maxTokens = Number.isFinite(rawMax) && rawMax > 0 ? Math.max(256, rawMax) : 8192
+
+            const existingIdx = currentOverrides.findIndex((o) => o.modelId === modelId)
+            const newEntry = { modelId, contextLength, maxTokens }
+            if (existingIdx >= 0) {
+              currentOverrides[existingIdx] = newEntry
+            } else {
+              currentOverrides.push(newEntry)
+            }
+          }
+        } else {
+          return writeJson(res, 400, { ok: false, error: 'Missing modelId, mode, or overrides array' })
+        }
+
+        const next = Config({
+          ...plainConfig(live()),
+          modelContextOverrides: currentOverrides,
+        })
+        await settingsApi.replace(next)
+        await syncProviderState(next)
+
+        const updatedModels = getAllModels(pub.dynamicModels, currentOverrides)
+        return writeJson(res, 200, {
+          ok: true,
+          modelContextOverrides: next.modelContextOverrides,
+          models: updatedModels,
+        })
+      } catch (err) {
+        return writeJson(res, 500, { ok: false, error: String(err?.message || err) })
+      }
+    },
+  }), 'dsh-clinebot: /models/context')
+
   // GET /dsh-clinebot/usage — direct fresh usage limit query
   ctx.effect(() => ctx.webServer.register({
     kind: 'exact',

package/lib/slash-command.js

@@ -34,7 +34,7 @@ export function registerSlashCommand(ctx, { live, getSettingsApi, syncProviderSt
 
         // 1. Subcommand /cline models
         if (subcmd === 'models') {
-          const allModels = getAllModels(pub.dynamicModels)
+          const allModels = getAllModels(pub.dynamicModels, pub.modelContextOverrides)
           const disabledSet = new Set(pub.disabledModels || [])
           const activeCount = allModels.filter((m) => !disabledSet.has(m.id)).length
           const syncStatus = pub.planSynced

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goodandready/dsh-clinebot",
-  "version": "0.4.3",
+  "version": "0.4.5",
   "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",
@@ -18,7 +18,8 @@
     "README.ru.md",
     "README.zh.md",
     "CHANGELOG.md",
-    "LICENSE"
+    "LICENSE",
+    "media/visual-verification.png"
   ],
   "keywords": [
     "dsh",