@goodandready/dsh-clinebot 0.5.26 → 0.5.28

package/CHANGELOG.md

@@ -5,6 +5,24 @@ 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.5.28] - 2026-10-17
+
+### Added
+- **Sidebar Quota Meter (`sidebar.footer.action` slot) (Issue #229)**: Added live subscription quota indicator in DSH sidebar footer right above Settings. Supports collapsed rail mode with 20px dynamic circular ring (`MiniRing`) and wide mode with plan name (`ClinePass Pro`), rolling 5h quota progress bar, and percentage used.
+- **Center-Column Dashboard Overlay (`main` slot) (Issue #229)**: Registered full overlay dashboard under key `clinebot-dashboard`, providing detailed view of 5-hour and weekly quota rolling windows, reset countdown timers, active account pool routing mode, and a close button (`×`) that restores the current chat view without page reload.
+- **Native Models Provider Card (`settings.models.provider-card` slot) (Issue #230)**: Added native provider card registered under `clinebot` and `llm-clinebot` on DSH Settings -> Models page, featuring connection status badges, quick API key input and save into DSH credentials, active model count, and direct navigation to full ClineBot settings.
+- **Sidebar Quota Toggle (`showSidebarQuota`) (Issue #229)**: Added volatile config field and settings toggle (default `true`) allowing users to easily enable or disable the sidebar quota meter.
+
+## [0.5.27] - 2026-10-17
+
+### Added
+- **Visible Models Multi-Select (`visibleModels`) (Issue #228)**: Users can now select an exact subset of models to expose in the DSH chat model picker. Includes search filtering, quick-select buttons (*All*, *Plan only*, *Clean stale*), and badge indicators for genuine context window and max output limits.
+- **Subscription Plan Auto-Filtering (`filterModelsByPlan`) (Issue #228)**: Added toggle to automatically hide models that are not included in the active Cline account's subscription tier, preventing request failures due to tier mismatch.
+- **Visible Models API Endpoint (Issue #228)**: Added `POST /dsh-clinebot/models/visible` for updating visible model selections with input validation.
+
+### Changed
+- **Genuine Creator Limits Default (Issue #228)**: `createCuratedModel` now defaults context window and max tokens directly to genuine vendor factory limits (`origCtx` / `origMax`) instead of legacy hardcoded 128k/8k limits.
+
 ## [0.5.26] - 2026-10-17
 
 ### Fixed

package/lib/client.js

@@ -123,7 +123,17 @@ const en = {
       'ui.retry': 'Retry',
       'update.check_failed': 'Failed to check for updates',
       'update.retry': 'Retry check',
-      'models.title': '🎯 Model Picker in DSH ({enabled} of {total} active)',
+            'models.filter_by_plan': 'Hide models not in active plan',
+      'models.filter_by_plan_hint': 'Automatically filter chat model picker to models included in your active ClinePass subscription plan.',
+      'models.visible_models': 'Visible Models in Chat',
+      'models.visible_models_hint': 'Choose which models appear in the DSH chat selector (empty means all supported models).',
+      'models.in_plan': 'In Plan',
+      'models.out_of_plan': 'Out of Plan',
+      'models.plan_only': 'Plan Only',
+      'models.show_all': 'Show All',
+      'models.clean_stale': 'Clean Stale ({count})',
+      'models.models_selected': '{selected} of {total} selected for chat',
+'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.',
       'models.reasoning_tooltip': 'Supports thinking effort selection in composer model menu (Off / Low / Medium / High / Max)',
       'models.sync': '🔄 Check Plan Models',
@@ -209,6 +219,28 @@ const en = {
       'update.failed': 'Update failed: {error}',
       'update.checking': 'Checking for updates…',
       'update.up_to_date': 'Up to date',
+      'sidebar.quota_title': 'Cline Quota',
+      'sidebar.show_quota': 'Show quota meter in sidebar',
+      'sidebar.show_quota_hint': 'Display compact quota meter in DSH sidebar footer.',
+      'dashboard.title': 'Cline Quota & Status',
+      'dashboard.subtitle': 'Real-time subscription quota, rolling limits, and account pool status.',
+      'dashboard.close': 'Close dashboard',
+      'dashboard.refresh': 'Refresh',
+      'dashboard.refreshing': 'Refreshing…',
+      'dashboard.rolling_window': '5-Hour Window',
+      'dashboard.weekly_window': 'Weekly Window',
+      'dashboard.remaining': 'remaining',
+      'dashboard.used': 'used',
+      'dashboard.account_pool': 'Active Routing Account',
+      'dashboard.credits': 'Credit Balance',
+      'dashboard.updated_at': 'Updated at',
+      'card.title': 'ClineBot Provider',
+      'card.status_connected': 'Connected',
+      'card.status_no_key': 'Key missing',
+      'card.open_settings': 'Settings & Accounts',
+      'card.save_key': 'Save Key',
+      'card.key_saved': 'Key saved',
+      'card.models_active': '{count} active models',
     }
 
     const zh = {
@@ -296,7 +328,17 @@ const en = {
       'ui.retry': '重试',
       'update.check_failed': '检查更新失败',
       'update.retry': '重试检查',
-      'models.title': '🎯 DSH 模型选择列表（已启用 {enabled}/{total}）',
+            'models.filter_by_plan': '隐藏未订阅模型',
+      'models.filter_by_plan_hint': '在聊天模型选择器中自动隐藏当前 ClinePass 订阅套餐未包含的模型。',
+      'models.visible_models': '聊天可见模型',
+      'models.visible_models_hint': '选择在 DSH 聊天选择器中显示的模型（为空时显示全部可用模型）。',
+      'models.in_plan': '套餐内',
+      'models.out_of_plan': '套餐外',
+      'models.plan_only': '仅套餐模型',
+      'models.show_all': '显示全部',
+      'models.clean_stale': '清理过期 ({count})',
+      'models.models_selected': '已选择 {selected} / {total} 个模型用于聊天',
+'models.title': '🎯 DSH 模型选择列表（已启用 {enabled}/{total}）',
       'models.desc': '模型目录与 ClinePass 官方订阅实时同步。新订阅模型默认自动启用。取消勾选可在 DSH 对话模型列表中隐藏不需要的模型。支持在对话输入框上方切换推理思考强度（Effort）。',
       'models.reasoning_tooltip': '支持在对话框上方模型菜单中选择思考强度（Off / Low / Medium / High / Max）',
       'models.sync': '🔄 同步订阅模型',
@@ -382,6 +424,28 @@ const en = {
       'update.failed': '更新失败：{error}',
       'update.checking': '正在检查更新…',
       'update.up_to_date': '已是最新版本',
+      'sidebar.quota_title': 'Cline 额度',
+      'sidebar.show_quota': '在侧边栏显示额度条',
+      'sidebar.show_quota_hint': '在 DSH 侧边栏底部常驻显示额度 mini 进度指示器。',
+      'dashboard.title': 'Cline 额度与状态',
+      'dashboard.subtitle': '实时订阅额度、滑动窗口限制与账户池状态。',
+      'dashboard.close': '关闭面板',
+      'dashboard.refresh': '刷新',
+      'dashboard.refreshing': '正在刷新…',
+      'dashboard.rolling_window': '5小时滑动窗口',
+      'dashboard.weekly_window': '每周配额窗口',
+      'dashboard.remaining': '剩余',
+      'dashboard.used': '已用',
+      'dashboard.account_pool': '当前承载账户',
+      'dashboard.credits': '点数余额',
+      'dashboard.updated_at': '更新于',
+      'card.title': 'ClineBot 模型服务',
+      'card.status_connected': '已连接',
+      'card.status_no_key': '未配置密钥',
+      'card.open_settings': '完整设置与多账户',
+      'card.save_key': '保存密钥',
+      'card.key_saved': '密钥已保存',
+      'card.models_active': '{count} 个可用模型',
     }
 
     function makeT(dict, fallback) {
@@ -484,6 +548,34 @@ function ensureCss() {
 .cb-stat-val{font-size:18px;font-weight:700;color:var(--dsw-alias-label-primary)}
 .cb-stat-lbl{font-size:12px;color:var(--dsw-alias-label-secondary)}
 .cb-preview{padding:12px;border-radius:8px;background:var(--dsw-alias-bg-layer-2);font-family:monospace;font-size:12px;white-space:pre-wrap;word-break:break-all;border:1px solid var(--dsw-alias-border-l2)}
+
+[class*="_footArea"] [class*="_footerActions"]{flex-direction:column}
+.cb-foot{box-sizing:border-box;flex:0 0 auto;width:100%;min-width:0;font:inherit;color:var(--dsw-alias-label-secondary);text-align:left;cursor:pointer;background:transparent;border:1px solid transparent;border-radius:10px;flex-direction:column;gap:6px;margin:0 0 4px;padding:8px;display:flex}
+.cb-foot:hover{color:var(--dsw-alias-label-primary);background:var(--dsw-alias-interactive-bg-hover);border-color:var(--dsw-alias-border-l2)}
+.cb-foot:focus-visible{outline:2px solid var(--dsw-alias-brand-primary);outline-offset:1px}
+.cb-footTop{align-items:center;gap:8px;min-width:0;display:flex}
+.cb-footName{white-space:nowrap;text-overflow:ellipsis;color:var(--dsw-alias-label-primary);min-width:0;overflow:hidden;font-size:13px;font-weight:500;line-height:20px}
+.cb-footRow{flex-direction:column;gap:4px;min-width:0;display:flex}
+.cb-footHead{align-items:baseline;gap:8px;min-width:0;display:flex}
+.cb-footLabel{flex:1;color:var(--dsw-alias-label-tertiary);font-size:12px;line-height:16px}
+.cb-footAmount{flex:none;color:var(--dsw-alias-label-secondary);font-size:12px;line-height:16px;font-variant-numeric:tabular-nums;white-space:nowrap}
+.cb-footBar{display:block;background:var(--dsw-alias-bg-layer-2);border-radius:999px;height:5px;overflow:hidden}
+.cb-footFill{display:block;background:var(--dsw-alias-brand-primary);border-radius:999px;height:100%;transition:width .3s ease}
+.cb-footFillWarn{background:var(--dsw-alias-state-error-primary)}
+.cb-footPct{flex:none;width:34px;color:var(--dsw-alias-label-secondary);text-align:right;font-size:12px;line-height:16px;font-variant-numeric:tabular-nums}
+.cb-railButton{box-sizing:border-box;width:36px;height:36px;color:var(--dsw-alias-label-secondary);cursor:pointer;background:transparent;border:1px solid transparent;border-radius:8px;flex:none;justify-content:center;align-items:center;margin:0 0 4px;padding:0;display:inline-flex}
+.cb-railButton:hover{color:var(--dsw-alias-label-primary);background:var(--dsw-alias-interactive-bg-hover)}
+.cb-railButton:focus-visible{outline:2px solid var(--dsw-alias-brand-primary);outline-offset:1px}
+.cb-glyph{flex:none;justify-content:center;align-items:center;display:inline-flex;color:var(--dsw-alias-brand-primary)}
+
+.cb-mainOverlay{background:var(--dsw-alias-bg-layer-1);width:100%;height:100%;overflow:auto;display:block}
+.cb-mainInner{max-width:760px;margin:0 auto;padding:24px 20px 40px;flex-direction:column;gap:14px;display:flex;color:var(--dsw-alias-label-primary)}
+.cb-mainHeader{align-items:center;gap:10px;display:flex;flex-wrap:wrap;border-bottom:1px solid var(--dsw-alias-border-l2);padding-bottom:14px}
+.cb-mainTitle{margin:0;font-size:18px;font-weight:600;line-height:1.4}
+.cb-mainSub{margin:0;color:var(--dsw-alias-label-tertiary);font-size:12px;line-height:1.5}
+.cb-mainCard{border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-3);border-radius:12px;padding:16px 18px;display:flex;flex-direction:column;gap:14px}
+
+.cb-providerCard{border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-3);border-radius:12px;padding:16px 18px;display:flex;flex-direction:column;gap:12px;margin:8px 0}
 `
       document.head.appendChild(style)
     }
@@ -1269,7 +1361,7 @@ function AccountsSection({
 }
 
 // --- src/client/components/quota-section.js ---
-function QuotaSection({ keyPresent, status, usage, busy, handleRefreshQuota, t }) {
+function QuotaSection({ keyPresent, status, usage, busy, handleRefreshQuota, showSidebarQuota, onToggleSidebarQuota, t }) {
   const isLowQuota = Boolean(
     (usage?.windows?.weekly && typeof usage.windows.weekly.remainingPercent === 'number' && usage.windows.weekly.remainingPercent <= 10) ||
     (usage?.windows?.monthly && typeof usage.windows.monthly.remainingPercent === 'number' && usage.windows.monthly.remainingPercent <= 10) ||
@@ -1359,6 +1451,22 @@ function QuotaSection({ keyPresent, status, usage, busy, handleRefreshQuota, t }
                   t,
                 })
               : null
+          ),
+          React.createElement(
+            'div',
+            { style: { display: 'flex', alignItems: 'center', justifyContent: 'space-between', marginTop: '4px', paddingTop: '10px', borderTop: '1px solid var(--dsw-alias-border-l2)' } },
+            React.createElement(
+              'div',
+              { style: { display: 'flex', flexDirection: 'column' } },
+              React.createElement('span', { style: { fontSize: '13px', fontWeight: 500, color: 'var(--dsw-alias-label-primary)' } }, t('sidebar.show_quota')),
+              React.createElement('span', { style: { fontSize: '11px', color: 'var(--dsw-alias-label-tertiary)' } }, t('sidebar.show_quota_hint'))
+            ),
+            React.createElement('input', {
+              type: 'checkbox',
+              style: { cursor: 'pointer', width: '16px', height: '16px' },
+              checked: showSidebarQuota !== false,
+              onChange: (e) => onToggleSidebarQuota && onToggleSidebarQuota(e.target.checked),
+            })
           )
         )
       : null
@@ -1537,6 +1645,254 @@ function CustomModelsSub({ customModels = [], onConfigUpdate, busy, t }) {
   )
 }
 
+// --- src/client/components/visible-models.js ---
+function formatModelLimits(num) {
+  num = Number(num) || 0
+  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)
+}
+
+function VisibleModelsSub({
+  modelsList = [],
+  visibleModels = [],
+  filterModelsByPlan = true,
+  onConfigUpdate,
+  busy,
+  t,
+}) {
+  const [open, setOpen] = React.useState(false)
+  const [search, setSearch] = React.useState('')
+
+  const allModelIds = modelsList.map((m) => m.id)
+  const allModelIdSet = new Set(allModelIds)
+  const staleIds = Array.isArray(visibleModels) ? visibleModels.filter((id) => !allModelIdSet.has(id)) : []
+  const isAllVisible = !Array.isArray(visibleModels) || visibleModels.length === 0
+  const count = isAllVisible ? modelsList.length : visibleModels.length
+
+  function handleToggleModel(modelId) {
+    if (typeof onConfigUpdate !== 'function') return
+    if (isAllVisible) {
+      const next = allModelIds.filter((id) => id !== modelId)
+      onConfigUpdate({ visibleModels: next })
+    } else {
+      let next
+      if (visibleModels.includes(modelId)) {
+        next = visibleModels.filter((id) => id !== modelId)
+      } else {
+        next = [...visibleModels, modelId]
+      }
+      onConfigUpdate({ visibleModels: next })
+    }
+  }
+
+  function handleSelectOnlyPlan() {
+    if (typeof onConfigUpdate !== 'function') return
+    const planOnly = modelsList.filter((m) => m.inPlan).map((m) => m.id)
+    onConfigUpdate({ visibleModels: planOnly.length > 0 ? planOnly : allModelIds })
+  }
+
+  function handleShowAll() {
+    if (typeof onConfigUpdate !== 'function') return
+    onConfigUpdate({ visibleModels: [] })
+  }
+
+  function handleCleanStale() {
+    if (typeof onConfigUpdate !== 'function') return
+    const cleaned = visibleModels.filter((id) => allModelIdSet.has(id))
+    onConfigUpdate({ visibleModels: cleaned })
+  }
+
+  const filtered = modelsList.filter((m) => {
+    if (!search.trim()) return true
+    const q = search.trim().toLowerCase()
+    return (
+      (m.name && m.name.toLowerCase().includes(q)) ||
+      (m.id && m.id.toLowerCase().includes(q)) ||
+      (m.category && m.category.toLowerCase().includes(q))
+    )
+  })
+
+  return React.createElement(
+    'div',
+    {
+      style: {
+        display: 'flex',
+        flexDirection: 'column',
+        gap: '10px',
+        padding: '12px 14px',
+        border: '1px solid var(--dsw-alias-border-l2)',
+        borderRadius: '8px',
+        background: 'var(--dsw-alias-bg-layer-2)',
+        marginBottom: '14px',
+      },
+    },
+    React.createElement(
+      'div',
+      { style: { display: 'flex', justifyContent: 'space-between', alignItems: 'center', flexWrap: 'wrap', gap: '8px' } },
+      React.createElement(
+        'label',
+        { style: { display: 'flex', alignItems: 'center', gap: '8px', cursor: 'pointer', fontSize: '13px', fontWeight: '500' } },
+        React.createElement('input', {
+          type: 'checkbox',
+          checked: !!filterModelsByPlan,
+          disabled: !!busy,
+          onChange: (e) => onConfigUpdate && onConfigUpdate({ filterModelsByPlan: e.target.checked }),
+        }),
+        React.createElement('span', null, t('models.filter_by_plan'))
+      ),
+      React.createElement(
+        'div',
+        { style: { display: 'flex', gap: '6px', alignItems: 'center', flexWrap: 'wrap' } },
+        !isAllVisible
+          ? React.createElement(
+              'button',
+              {
+                type: 'button',
+                className: 'cb-btn',
+                style: { padding: '4px 8px', fontSize: '12px' },
+                disabled: !!busy,
+                onClick: handleShowAll,
+              },
+              t('models.show_all')
+            )
+          : null,
+        React.createElement(
+          'button',
+          {
+            type: 'button',
+            className: 'cb-btn',
+            style: { padding: '4px 8px', fontSize: '12px' },
+            disabled: !!busy,
+            onClick: handleSelectOnlyPlan,
+          },
+          t('models.plan_only')
+        ),
+        staleIds.length > 0
+          ? React.createElement(
+              'button',
+              {
+                type: 'button',
+                className: 'cb-btn',
+                style: { padding: '4px 8px', fontSize: '12px', color: 'var(--dsw-alias-state-warn-primary)' },
+                disabled: !!busy,
+                onClick: handleCleanStale,
+              },
+              t('models.clean_stale', { count: staleIds.length })
+            )
+          : null,
+        React.createElement(
+          'button',
+          {
+            type: 'button',
+            className: 'cb-btn',
+            style: { padding: '4px 10px', fontSize: '12px' },
+            onClick: () => setOpen(!open),
+          },
+          open ? '▲ ' + t('models.models_selected', { selected: count, total: modelsList.length }) : '▼ ' + t('models.models_selected', { selected: count, total: modelsList.length })
+        )
+      )
+    ),
+    React.createElement(
+      'div',
+      { style: { fontSize: '12px', color: 'var(--dsw-alias-label-secondary)', marginTop: '-4px' } },
+      t('models.filter_by_plan_hint')
+    ),
+    open
+      ? React.createElement(
+          'div',
+          {
+            style: {
+              display: 'flex',
+              flexDirection: 'column',
+              gap: '8px',
+              paddingTop: '8px',
+              borderTop: '1px solid var(--dsw-alias-border-l2)',
+            },
+          },
+          React.createElement('input', {
+            type: 'text',
+            className: 'cb-input',
+            style: { height: '30px', fontSize: '12px' },
+            placeholder: t('models.search_placeholder'),
+            value: search,
+            onChange: (e) => setSearch(e.target.value),
+          }),
+          React.createElement(
+            'div',
+            {
+              style: {
+                display: 'flex',
+                flexDirection: 'column',
+                gap: '4px',
+                maxHeight: '240px',
+                overflowY: 'auto',
+                paddingRight: '4px',
+              },
+            },
+            filtered.map((m) => {
+              const isChecked = isAllVisible || visibleModels.includes(m.id)
+              const ctxStr = `${formatModelLimits(m.contextLength)} / ${formatModelLimits(m.maxTokens)}`
+              return React.createElement(
+                'label',
+                {
+                  key: m.id,
+                  style: {
+                    display: 'flex',
+                    alignItems: 'center',
+                    justifyContent: 'space-between',
+                    padding: '5px 8px',
+                    borderRadius: '6px',
+                    background: isChecked ? 'var(--dsw-alias-bg-layer-3)' : 'transparent',
+                    cursor: 'pointer',
+                    fontSize: '12px',
+                    opacity: m.inPlan ? 1 : 0.65,
+                  },
+                },
+                React.createElement(
+                  'div',
+                  { style: { display: 'flex', alignItems: 'center', gap: '8px', flex: 1, minWidth: 0 } },
+                  React.createElement('input', {
+                    type: 'checkbox',
+                    checked: isChecked,
+                    onChange: () => handleToggleModel(m.id),
+                  }),
+                  React.createElement('span', { style: { fontWeight: '500', whiteSpace: 'nowrap', overflow: 'hidden', textOverflow: 'ellipsis' } }, m.name),
+                  React.createElement('span', { style: { color: 'var(--dsw-alias-label-secondary)', fontSize: '11px' } }, `(${m.id})`)
+                ),
+                React.createElement(
+                  'div',
+                  { style: { display: 'flex', alignItems: 'center', gap: '6px' } },
+                  React.createElement(
+                    'span',
+                    {
+                      className: 'cb-badge',
+                      style: { fontSize: '11px', padding: '2px 6px', fontWeight: '600' },
+                      title: 'Context Window / Max Output Tokens',
+                    },
+                    ctxStr
+                  ),
+                  m.inPlan
+                    ? React.createElement('span', { className: 'cb-badge cb-badge-ok', style: { fontSize: '10px', padding: '1px 6px' } }, t('models.in_plan'))
+                    : React.createElement('span', { className: 'cb-badge', style: { fontSize: '10px', padding: '1px 6px', color: 'var(--dsw-alias-label-secondary)' } }, t('models.out_of_plan')),
+                  !m.isContextOverridden
+                    ? React.createElement('span', { className: 'cb-badge cb-badge-ok', style: { fontSize: '10px', padding: '1px 5px' } }, '原厂')
+                    : null
+                )
+              )
+            })
+          )
+        )
+      : null
+  )
+}
+
 // --- src/client/components/models-section.js ---
 function ModelsSection({
   modelsList,
@@ -1553,6 +1909,8 @@ function ModelsSection({
   defaultModelWarning,
   customModels,
   modelReasoningDefaults,
+  visibleModels,
+  filterModelsByPlan,
   onConfigUpdate,
   onUpdateReasoningEffort,
   t,
@@ -1604,6 +1962,14 @@ function ModelsSection({
     defaultModelWarning
       ? React.createElement('div', { className: 'cb-alert-bad', style: { marginBottom: '12px' } }, `⚠️ ${defaultModelWarning}`)
       : null,
+    React.createElement(VisibleModelsSub, {
+      modelsList,
+      visibleModels,
+      filterModelsByPlan,
+      onConfigUpdate,
+      busy,
+      t,
+    }),
     React.createElement(
       'div',
       { className: 'cb-section-title' },
@@ -2295,6 +2661,482 @@ function DiagSection({
   )
 }
 
+// --- src/client/components/sidebar-quota.js ---
+function MiniRing({ percent, size = 18, warn = false }) {
+  const r = 7
+  const c = 2 * Math.PI * r
+  const pct = Math.max(0, Math.min(100, Number(percent) || 0))
+  const offset = c - (pct / 100) * c
+  const strokeColor = warn ? 'var(--dsw-alias-state-error-primary)' : 'var(--dsw-alias-brand-primary)'
+
+  return React.createElement(
+    'svg',
+    {
+      className: 'cb-glyph',
+      width: size,
+      height: size,
+      viewBox: '0 0 20 20',
+      fill: 'none',
+    },
+    React.createElement('circle', {
+      cx: 10,
+      cy: 10,
+      r,
+      stroke: 'var(--dsw-alias-bg-layer-2)',
+      strokeWidth: 2.5,
+    }),
+    React.createElement('circle', {
+      cx: 10,
+      cy: 10,
+      r,
+      stroke: strokeColor,
+      strokeWidth: 2.5,
+      strokeDasharray: c,
+      strokeDashoffset: offset,
+      strokeLinecap: 'round',
+      transform: 'rotate(-90 10 10)',
+      style: { transition: 'stroke-dashoffset 0.3s ease' },
+    })
+  )
+}
+
+function SidebarQuota({ ctx, wide, open, t: propT }) {
+  const t = propT || makeT(en, en)
+  const [data, setData] = React.useState(null)
+  const [visible, setVisible] = React.useState(true)
+
+  const loadQuota = React.useCallback(async () => {
+    try {
+      const res = await fetchWithTimeout(`${ROUTE_PREFIX}/usage`, { cache: 'no-store' })
+      if (!res.ok) return
+      const json = await res.json().catch(() => null)
+      if (json && json.ok) setData(json)
+    } catch {
+      // quiet on network fail
+    }
+  }, [])
+
+  React.useEffect(() => {
+    let timer = null
+    const scheduleNext = () => {
+      timer = setTimeout(async () => {
+        await loadQuota()
+        scheduleNext()
+      }, 60000)
+    }
+    loadQuota()
+    scheduleNext()
+    return () => { if (timer) clearTimeout(timer) }
+  }, [loadQuota])
+
+  // Check configForms snapshot for showSidebarQuota toggle
+  const config = useConfigFormsSnapshot(ctx)
+  const show = config?.showSidebarQuota !== false
+  if (!show || !visible) return null
+
+  const fiveHour = data?.windows?.fiveHour
+  const weekly = data?.windows?.weekly
+  const activeWindow = fiveHour || weekly
+  const pct = Math.round(activeWindow?.percentUsed || 0)
+  const isWarn = pct >= 85
+  const planName = data?.plan || t('title')
+
+  const handleOpen = () => {
+    if (typeof open === 'function') {
+      open()
+    } else {
+      ctx?.get?.('layout')?.selectPanel?.('clinebot-dashboard')
+    }
+  }
+
+  const tooltip = `${t('sidebar.quota_title')}: ${pct}% ${t('dashboard.used')} (${planName})`
+
+  if (!wide) {
+    return React.createElement(
+      'button',
+      {
+        type: 'button',
+        className: 'cb-railButton',
+        'aria-label': tooltip,
+        title: tooltip,
+        onClick: handleOpen,
+      },
+      React.createElement(MiniRing, { percent: pct, warn: isWarn, size: 20 })
+    )
+  }
+
+  return React.createElement(
+    'button',
+    {
+      type: 'button',
+      className: 'cb-foot',
+      'aria-label': tooltip,
+      title: tooltip,
+      onClick: handleOpen,
+    },
+    React.createElement(
+      'div',
+      { className: 'cb-footTop' },
+      React.createElement(MiniRing, { percent: pct, warn: isWarn, size: 16 }),
+      React.createElement('span', { className: 'cb-footName' }, planName),
+      React.createElement('span', { className: 'cb-footPct', style: { marginLeft: 'auto', fontWeight: 600, color: isWarn ? 'var(--dsw-alias-state-error-primary)' : 'var(--dsw-alias-label-secondary)' } }, `${pct}%`)
+    ),
+    React.createElement(
+      'div',
+      { className: 'cb-footRow' },
+      React.createElement(
+        'div',
+        { className: 'cb-footHead' },
+        React.createElement('span', { className: 'cb-footLabel' }, t('dashboard.rolling_window')),
+        React.createElement('span', { className: 'cb-footAmount' }, `${100 - pct}% ${t('dashboard.remaining')}`)
+      ),
+      React.createElement(
+        'span',
+        { className: 'cb-footBar' },
+        React.createElement('span', {
+          className: isWarn ? 'cb-footFill cb-footFillWarn' : 'cb-footFill',
+          style: { width: `${Math.min(100, Math.max(2, pct))}%` },
+        })
+      )
+    )
+  )
+}
+
+// --- src/client/components/dashboard-overlay.js ---
+function DashboardOverlay(props) {
+  const ctx = props?.ctx
+  const t = props?.t || makeT(en, en)
+  const [data, setData] = React.useState(null)
+  const [status, setStatus] = React.useState(null)
+  const [loading, setLoading] = React.useState(false)
+  const [updatedAt, setUpdatedAt] = React.useState('')
+  const [err, setErr] = React.useState('')
+
+  const handleClose = () => {
+    if (typeof props?.close === 'function') {
+      props.close()
+    } else {
+      ctx?.get?.('layout')?.selectPanel?.(null)
+    }
+  }
+
+  const loadData = React.useCallback(async () => {
+    setLoading(true)
+    setErr('')
+    try {
+      const [uRes, sRes] = await Promise.all([
+        fetchWithTimeout(`${ROUTE_PREFIX}/usage`, { cache: 'no-store' }),
+        fetchWithTimeout(`${ROUTE_PREFIX}/status`, { cache: 'no-store' }),
+      ])
+      const uJson = await uRes.json().catch(() => ({}))
+      const sJson = await sRes.json().catch(() => ({}))
+      if (uJson?.ok) setData(uJson)
+      if (sJson?.ok) setStatus(sJson)
+      setUpdatedAt(new Date().toLocaleTimeString())
+    } catch (e) {
+      setErr(String(e?.message || e))
+    } finally {
+      setLoading(false)
+    }
+  }, [])
+
+  React.useEffect(() => {
+    loadData()
+  }, [loadData])
+
+  const plan = data?.plan || status?.config?.defaultModel || 'ClinePass'
+  const email = data?.user?.email || ''
+  const activeAcc = status?.config?.activeAccount || 'Auto (Least-used)'
+  const enabledCount = status?.config?.enabledModels?.length || 0
+
+  return React.createElement(
+    'div',
+    { className: 'cb-mainOverlay', role: 'region', 'aria-label': t('dashboard.title') },
+    React.createElement(
+      'div',
+      { className: 'cb-mainInner' },
+      // Header
+      React.createElement(
+        'header',
+        { className: 'cb-mainHeader' },
+        React.createElement(
+          'div',
+          { style: { display: 'flex', flexDirection: 'column', gap: '2px', minWidth: 0 } },
+          React.createElement('h2', { className: 'cb-mainTitle' }, t('dashboard.title')),
+          React.createElement('p', { className: 'cb-mainSub' }, t('dashboard.subtitle'))
+        ),
+        React.createElement('span', { style: { flex: 1 } }),
+        updatedAt
+          ? React.createElement(
+              'span',
+              { style: { fontSize: '12px', color: 'var(--dsw-alias-label-tertiary)', fontVariantNumeric: 'tabular-nums' } },
+              `${t('dashboard.updated_at')} ${updatedAt}`
+            )
+          : null,
+        React.createElement(
+          'button',
+          {
+            type: 'button',
+            className: 'cb-btn',
+            disabled: loading,
+            onClick: loadData,
+          },
+          loading ? t('dashboard.refreshing') : t('dashboard.refresh')
+        ),
+        React.createElement(
+          'button',
+          {
+            type: 'button',
+            className: 'cb-btn',
+            style: { minWidth: '32px', padding: '0 8px', fontSize: '16px' },
+            'aria-label': t('dashboard.close'),
+            title: t('dashboard.close'),
+            onClick: handleClose,
+          },
+          '✕'
+        )
+      ),
+
+      err ? React.createElement('div', { className: 'cb-alert-bad' }, err) : null,
+
+      // Card 1: Account & Plan Status
+      React.createElement(
+        'div',
+        { className: 'cb-mainCard' },
+        React.createElement(
+          'div',
+          { style: { display: 'flex', justifyContent: 'space-between', alignItems: 'center' } },
+          React.createElement(
+            'div',
+            { style: { display: 'flex', alignItems: 'center', gap: '10px' } },
+            React.createElement('span', { style: { fontSize: '20px' } }, '💳'),
+            React.createElement(
+              'div',
+              null,
+              React.createElement('div', { style: { fontSize: '15px', fontWeight: 600, color: 'var(--dsw-alias-label-primary)' } }, plan),
+              email ? React.createElement('div', { style: { fontSize: '12px', color: 'var(--dsw-alias-label-secondary)' } }, email) : null
+            )
+          ),
+          React.createElement(
+            'span',
+            { className: 'cb-badge cb-badge-ok' },
+            t('badge.registered', { count: enabledCount })
+          )
+        ),
+        React.createElement(
+          'div',
+          { className: 'cb-grid-2', style: { display: 'grid', gridTemplateColumns: 'repeat(auto-fit, minmax(200px, 1fr))', gap: '10px', marginTop: '6px' } },
+          React.createElement(
+            'div',
+            { className: 'cb-stat-box' },
+            React.createElement('div', { className: 'cb-stat-lbl' }, t('dashboard.account_pool')),
+            React.createElement('div', { className: 'cb-stat-val', style: { fontSize: '14px', wordBreak: 'break-all' } }, activeAcc)
+          ),
+          React.createElement(
+            'div',
+            { className: 'cb-stat-box' },
+            React.createElement('div', { className: 'cb-stat-lbl' }, t('accounts.mode_label')),
+            React.createElement('div', { className: 'cb-stat-val', style: { fontSize: '14px' } }, status?.config?.accountMode === 'round_robin' ? t('accounts.mode_round_robin') : t('accounts.mode_least_used'))
+          )
+        )
+      ),
+
+      // Card 2: Quota Windows
+      React.createElement(
+        'div',
+        { className: 'cb-mainCard' },
+        React.createElement(
+          'div',
+          { style: { fontSize: '15px', fontWeight: 600, color: 'var(--dsw-alias-label-primary)' } },
+          t('quota.title')
+        ),
+        React.createElement(
+          'div',
+          { style: { display: 'flex', flexDirection: 'column', gap: '12px' } },
+          data?.windows?.fiveHour
+            ? React.createElement(ProgressBar, {
+                label: t('quota.window_5h'),
+                percentUsed: data.windows.fiveHour.percentUsed || 0,
+                remainingPercent: data.windows.fiveHour.remainingPercent || 100,
+                resetsAt: data.windows.fiveHour.resetsAt,
+                t,
+              })
+            : null,
+          React.createElement(ProgressBar, {
+            label: t('quota.window_weekly'),
+            percentUsed: data?.windows?.weekly?.percentUsed || 0,
+            remainingPercent: data?.windows?.weekly?.remainingPercent || 100,
+            resetsAt: data?.windows?.weekly?.resetsAt,
+            t,
+          }),
+          data?.windows?.monthly
+            ? React.createElement(ProgressBar, {
+                label: t('quota.window_monthly'),
+                percentUsed: data.windows.monthly.percentUsed || 0,
+                remainingPercent: data.windows.monthly.remainingPercent || 100,
+                resetsAt: data.windows.monthly.resetsAt,
+                t,
+              })
+            : null
+        )
+      )
+    )
+  )
+}
+
+// --- src/client/components/models-provider-card.js ---
+function ModelsProviderCard(props) {
+  const ctx = props?.ctx
+  const t = props?.t || makeT(en, en)
+  const [status, setStatus] = React.useState(null)
+  const [apiKey, setApiKey] = React.useState('')
+  const [showKey, setShowKey] = React.useState(false)
+  const [saving, setSaving] = React.useState(false)
+  const [msg, setMsg] = React.useState('')
+  const [err, setErr] = React.useState('')
+
+  const loadStatus = React.useCallback(async () => {
+    try {
+      const res = await fetchWithTimeout(`${ROUTE_PREFIX}/status`, { cache: 'no-store' })
+      if (!res.ok) return
+      const json = await res.json().catch(() => null)
+      if (json && json.ok) setStatus(json)
+    } catch {
+      // quiet on network fail
+    }
+  }, [])
+
+  React.useEffect(() => {
+    loadStatus()
+  }, [loadStatus])
+
+  const keyConfigured = Boolean(status?.keyPresent || status?.config?.hasKey)
+  const modelsCount = status?.config?.enabledModels?.length || status?.availableModels?.length || 0
+
+  const handleSaveKey = async () => {
+    const keyVal = String(apiKey || '').trim()
+    if (!keyVal) {
+      setErr(t('key.empty_err'))
+      return
+    }
+    setSaving(true)
+    setErr('')
+    setMsg('')
+    try {
+      const res = await fetchWithTimeout(`${ROUTE_PREFIX}/save-key`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ apiKey: keyVal, apiKeyEnv: status?.config?.apiKeyEnv }),
+      })
+      const data = await res.json().catch(() => ({}))
+      if (!res.ok || !data.ok) throw new Error(data.error || `HTTP ${res.status}`)
+      setApiKey('')
+      setMsg(t('card.key_saved'))
+      await loadStatus()
+    } catch (e) {
+      setErr(String(e?.message || e))
+    } finally {
+      setSaving(false)
+    }
+  }
+
+  const handleOpenSettings = () => {
+    const layout = ctx?.get?.('layout')
+    if (typeof layout?.selectPanel === 'function') {
+      layout.selectPanel('clinebot-dashboard')
+    } else if (typeof props?.openSettings === 'function') {
+      props.openSettings()
+    }
+  }
+
+  return React.createElement(
+    'div',
+    { className: 'cb-providerCard', 'data-clinebot-provider-card': 'true' },
+    // Header
+    React.createElement(
+      'div',
+      { style: { display: 'flex', justifyContent: 'space-between', alignItems: 'center' } },
+      React.createElement(
+        'div',
+        { style: { display: 'flex', alignItems: 'center', gap: '8px' } },
+        React.createElement('span', { style: { fontSize: '18px' } }, '🤖'),
+        React.createElement('span', { style: { fontSize: '15px', fontWeight: 600, color: 'var(--dsw-alias-label-primary)' } }, t('card.title'))
+      ),
+      React.createElement(
+        'div',
+        { style: { display: 'flex', alignItems: 'center', gap: '6px' } },
+        React.createElement(
+          'span',
+          { className: keyConfigured ? 'cb-badge cb-badge-ok' : 'cb-badge cb-badge-warn' },
+          keyConfigured ? `✓ ${t('card.status_connected')}` : `⚠️ ${t('card.status_no_key')}`
+        ),
+        modelsCount > 0
+          ? React.createElement(
+              'span',
+              { className: 'cb-badge cb-badge-ok' },
+              t('card.models_active', { count: modelsCount })
+            )
+          : null
+      )
+    ),
+
+    // Quick Key Input Form
+    React.createElement(
+      'div',
+      { style: { display: 'flex', flexDirection: 'column', gap: '8px' } },
+      React.createElement(
+        'div',
+        { className: 'cb-input-group' },
+        React.createElement('input', {
+          type: showKey ? 'text' : 'password',
+          className: 'cb-input',
+          style: { flex: 1 },
+          value: apiKey,
+          placeholder: keyConfigured ? t('key.placeholder_has') : t('key.placeholder_empty'),
+          onChange: (e) => setApiKey(e.target.value),
+          onKeyDown: (e) => { if (e.key === 'Enter') handleSaveKey() },
+        }),
+        React.createElement(
+          'button',
+          {
+            type: 'button',
+            className: 'cb-btn',
+            onClick: () => setShowKey(!showKey),
+          },
+          showKey ? t('key.hide') : t('key.show')
+        ),
+        React.createElement(
+          'button',
+          {
+            type: 'button',
+            className: 'cb-btn cb-btn-primary',
+            disabled: saving || !apiKey.trim(),
+            onClick: handleSaveKey,
+          },
+          saving ? t('key.saving') : t('card.save_key')
+        )
+      ),
+      msg ? React.createElement('div', { className: 'cb-alert-ok' }, msg) : null,
+      err ? React.createElement('div', { className: 'cb-alert-bad' }, err) : null
+    ),
+
+    // Footer with navigation to full settings
+    React.createElement(
+      'div',
+      { style: { display: 'flex', justifyContent: 'flex-end', alignItems: 'center', borderTop: '1px solid var(--dsw-alias-border-l2)', paddingTop: '10px' } },
+      React.createElement(
+        'button',
+        {
+          type: 'button',
+          className: 'cb-btn',
+          onClick: handleOpenSettings,
+        },
+        `⚙️ ${t('card.open_settings')}`
+      )
+    )
+  )
+}
+
 // --- src/client/settings-page.js ---
 function SettingsPage(props) {
   const ctx = props?.ctx
@@ -2742,7 +3584,7 @@ function SettingsPage(props) {
     }),
 
     // Quota Warning & Dashboard Card
-    React.createElement(QuotaSection, { keyPresent, status, usage, busy, handleRefreshQuota, t }),
+    React.createElement(QuotaSection, { keyPresent, status, usage, busy, handleRefreshQuota, showSidebarQuota: draft?.showSidebarQuota !== false, onToggleSidebarQuota: (v) => handleConfigPatch({ showSidebarQuota: v }), t }),
 
     // Card 3: Model Picker Management
     React.createElement(ModelsSection, {
@@ -2760,6 +3602,8 @@ function SettingsPage(props) {
       defaultModelWarning: status?.config?.defaultModelWarning || '',
       customModels: draft?.customModels || [],
       modelReasoningDefaults: draft?.modelReasoningDefaults || {},
+      visibleModels: draft?.visibleModels || [],
+      filterModelsByPlan: draft?.filterModelsByPlan !== false,
       onConfigUpdate: handleConfigPatch,
       onUpdateReasoningEffort: (modelId, effort) => {
         const next = { ...(draft?.modelReasoningDefaults || {}) }
@@ -2957,6 +3801,48 @@ function apply(ctx) {
       (props) => React.createElement(ErrorBoundary, { t: props && props.t }, React.createElement(PluginCard, { ...props, ctx: (props && props.ctx) || ctx }))
     )
   )
+
+  // Sidebar Quota Meter (sidebar.footer.action slot)
+  registerSlotWhenReady('sidebar.footer.action', () =>
+    ctx.slots.register(
+      {
+        name: 'sidebar.footer.action',
+        id: 'clinebot-quota',
+        order: 20,
+        locale: NS,
+        inject: () => ({ ctx }),
+      },
+      (props) => React.createElement(ErrorBoundary, { t: props && props.t }, React.createElement(SidebarQuota, { ...props, ctx: (props && props.ctx) || ctx }))
+    )
+  )
+
+  // Central Overlay Dashboard (main slot)
+  registerSlotWhenReady('main', () =>
+    ctx.slots.register(
+      {
+        name: 'main',
+        key: 'clinebot-dashboard',
+        locale: NS,
+        inject: () => ({ ctx }),
+      },
+      (props) => React.createElement(ErrorBoundary, { t: props && props.t }, React.createElement(DashboardOverlay, { ...props, ctx: (props && props.ctx) || ctx }))
+    )
+  )
+
+  // Settings Models Provider Card (settings.models.provider-card slot)
+  for (const pKey of ['clinebot', 'llm-clinebot']) {
+    registerSlotWhenReady('settings.models.provider-card', () =>
+      ctx.slots.register(
+        {
+          name: 'settings.models.provider-card',
+          key: pKey,
+          locale: NS,
+          inject: () => ({ ctx }),
+        },
+        (props) => React.createElement(ErrorBoundary, { t: props && props.t }, React.createElement(ModelsProviderCard, { ...props, ctx: (props && props.ctx) || ctx }))
+      )
+    )
+  }
 }
 
 module.exports = { apply, inject: ['slots', 'locale', 'configForms'] }

package/lib/config.js

@@ -37,6 +37,12 @@ export const Config = z.object({
     .description('Default model ID for chat and smoke tests.').volatile(),
   disabledModels: z.array(z.string()).default([])
     .description('List of model IDs explicitly disabled by the user (new models are enabled automatically).').volatile(),
+  filterModelsByPlan: z.boolean().default(true)
+    .description('Automatically hide models not included in active subscription plan from chat picker.').volatile(),
+  visibleModels: z.array(z.string()).default([])
+    .description('User-selected visible models in chat model picker (empty means all supported models).').volatile(),
+  showSidebarQuota: z.boolean().default(true)
+    .description('Display compact quota meter in DSH sidebar footer.').volatile(),
   enabledModels: z.array(z.string()).default([])
     .description('Deprecated: preserved for backwards compatibility with earlier versions.'),
   dynamicModels: z.array(z.object({
@@ -144,7 +150,34 @@ export function publicConfig(cfg) {
     disabledList = allDefaultIds.filter((id) => !enabledSet.has(id))
   }
 
+  const filterModelsByPlan = cfg?.filterModelsByPlan !== false
+  const visibleModels = Array.isArray(cfg?.visibleModels) ? cfg.visibleModels.map(migrateModelId) : []
+
+  const planModelSet = new Set(dynamic.map((m) => m.id))
+  for (const m of allModels) {
+    if (m.inPlan === undefined) {
+      m.inPlan = isSynced ? (planModelSet.has(m.id) || planModelSet.has(migrateModelId(m.id)) || Boolean(m.isCustom)) : true
+    }
+  }
+
   let activeIds = getActiveModelIds(allDefaultIds, disabledList)
+  if (filterModelsByPlan && isSynced && planModelSet.size > 0) {
+    const inPlanIds = activeIds.filter((id) => {
+      const m = allModels.find((mod) => mod.id === id)
+      return m ? m.inPlan : true
+    })
+    if (inPlanIds.length > 0) {
+      activeIds = inPlanIds
+    }
+  }
+  if (visibleModels.length > 0) {
+    const visibleSet = new Set(visibleModels)
+    const filteredByVisible = activeIds.filter((id) => visibleSet.has(id))
+    if (filteredByVisible.length > 0) {
+      activeIds = filteredByVisible
+    }
+  }
+
   if (!activeIds.length && allDefaultIds.length) {
     activeIds = [allDefaultIds[0]]
   }
@@ -176,6 +209,9 @@ export function publicConfig(cfg) {
     proxyMode: cfg?.proxyMode !== false,
     statsPath: String(cfg?.statsPath || '~/.dsh/clinebot-stats.json'),
     disabledModels: disabledList,
+    filterModelsByPlan,
+    visibleModels,
+    showSidebarQuota: cfg?.showSidebarQuota !== false,
     enabledModels: activeIds,
     timeoutMs: Number(cfg?.timeoutMs) || DEFAULT_TIMEOUT_MS,
     smokeTimeoutMs: Number(cfg?.smokeTimeoutMs) || DEFAULT_SMOKE_TIMEOUT_MS,

package/lib/models.js

@@ -85,7 +85,7 @@ export function getOriginalModelProvider(nameOrId) {
 
 function createCuratedModel({
   id, name, description,
-  ctx = 128000, maxTokens = 8192,
+  ctx, maxTokens,
   origCtx, origMax, origProv,
   input = ['text'], category = 'general',
   recommended = false, reasoningEfforts,
@@ -93,11 +93,13 @@ function createCuratedModel({
   const c = origCtx || getOriginalModelContext(id)
   const p = origProv || getOriginalModelProvider(id)
   const om = origMax || getOriginalModelMaxTokens(id)
+  const activeCtx = ctx || c
+  const activeMax = maxTokens || om
   return {
     id, name, description,
-    clineContextLength: ctx, defaultContextLength: ctx, contextLength: ctx,
+    clineContextLength: activeCtx, defaultContextLength: activeCtx, contextLength: activeCtx,
     originalContextLength: c, originalProvider: p, originalMaxTokens: om,
-    maxTokens, defaultMaxTokens: maxTokens,
+    maxTokens: activeMax, defaultMaxTokens: activeMax,
     input, category, recommended, isCustom: false,
     ...(reasoningEfforts ? { reasoningEfforts } : {}),
   }
@@ -107,76 +109,65 @@ export const CLINE_MODELS = Object.freeze([
   createCuratedModel({
     id: 'cline-pass/deepseek-v4.1-flash',
     name: 'DeepSeek V4.1 Flash',
-    description: 'High-speed reasoning & code completion model optimized for agentic loops.',
-    ctx: 128000, maxTokens: 8192, input: ['text', 'image'], category: 'coding', recommended: true,
+    description: 'High-speed reasoning & code completion model optimized for agentic loops.', input: ['text', 'image'], category: 'coding', recommended: true,
     reasoningEfforts: ['low', 'medium', 'high'],
   }),
   createCuratedModel({
     id: 'cline-pass/deepseek-v4-pro',
     name: 'DeepSeek V4 Pro',
-    description: 'Flagship reasoning and multi-turn architectural coding model.',
-    ctx: 128000, maxTokens: 8192, input: ['text', 'image'], category: 'coding', recommended: true,
+    description: 'Flagship reasoning and multi-turn architectural coding model.', input: ['text', 'image'], category: 'coding', recommended: true,
     reasoningEfforts: ['low', 'medium', 'high', 'max'],
   }),
   createCuratedModel({
     id: 'cline-pass/glm-5.2',
     name: 'GLM 5.2',
-    description: 'Bilingual general & coding model with strong instruction following.',
-    ctx: 128000, maxTokens: 8192, input: ['text'], category: 'general', recommended: false,
+    description: 'Bilingual general & coding model with strong instruction following.', input: ['text'], category: 'general', recommended: false,
     reasoningEfforts: ['low', 'medium', 'high'],
   }),
   createCuratedModel({
     id: 'cline-pass/kimi-k3',
     name: 'Kimi K3',
-    description: 'Long-context reasoning & document synthesis model by Moonshot AI.',
-    ctx: 200000, maxTokens: 8192, input: ['text'], category: 'reasoning', recommended: true,
+    description: 'Long-context reasoning & document synthesis model by Moonshot AI.', input: ['text'], category: 'reasoning', recommended: true,
     reasoningEfforts: ['low', 'medium', 'high', 'max'],
   }),
   createCuratedModel({
     id: 'cline-pass/kimi-k2.7-code',
     name: 'Kimi K2.7 Code',
-    description: 'Specialized coding model with agentic tool calling support.',
-    ctx: 200000, maxTokens: 8192, input: ['text'], category: 'coding', recommended: false,
+    description: 'Specialized coding model with agentic tool calling support.', input: ['text'], category: 'coding', recommended: false,
   }),
   createCuratedModel({
     id: 'cline-pass/kimi-k2.6',
     name: 'Kimi K2.6',
-    description: 'Balanced long-context conversational model.',
-    ctx: 200000, maxTokens: 8192, input: ['text'], category: 'general', recommended: false,
+    description: 'Balanced long-context conversational model.', input: ['text'], category: 'general', recommended: false,
   }),
   createCuratedModel({
     id: 'cline-pass/qwen3.7-max',
     name: 'Qwen 3.7 Max',
-    description: 'Large-scale multimodal foundation model from Alibaba Cloud with reasoning support.',
-    ctx: 128000, maxTokens: 8192, input: ['text', 'image'], category: 'multimodal', recommended: true,
+    description: 'Large-scale multimodal foundation model from Alibaba Cloud with reasoning support.', input: ['text', 'image'], category: 'multimodal', recommended: true,
     reasoningEfforts: ['low', 'medium', 'high', 'max'],
   }),
   createCuratedModel({
     id: 'cline-pass/qwen3.7-plus',
     name: 'Qwen 3.7 Plus',
-    description: 'Fast, capable multimodal model with strong multilingual skills and reasoning.',
-    ctx: 128000, maxTokens: 8192, input: ['text', 'image'], category: 'multimodal', recommended: false,
+    description: 'Fast, capable multimodal model with strong multilingual skills and reasoning.', input: ['text', 'image'], category: 'multimodal', recommended: false,
     reasoningEfforts: ['low', 'medium', 'high', 'max'],
   }),
   createCuratedModel({
     id: 'cline-pass/minimax-m3',
     name: 'MiniMax M3',
-    description: 'High throughput reasoning and synthesis model.',
-    ctx: 200000, maxTokens: 8192, input: ['text'], category: 'reasoning', recommended: false,
+    description: 'High throughput reasoning and synthesis model.', input: ['text'], category: 'reasoning', recommended: false,
     reasoningEfforts: ['low', 'medium', 'high'],
   }),
   createCuratedModel({
     id: 'cline-pass/mimo-v2.5',
     name: 'MiMo V2.5',
-    description: 'Xiaomi MiMo efficient instruction model with reasoning and multimodal support.',
-    ctx: 128000, maxTokens: 8192, input: ['text', 'image'], category: 'general', recommended: false,
+    description: 'Xiaomi MiMo efficient instruction model with reasoning and multimodal support.', input: ['text', 'image'], category: 'general', recommended: false,
     reasoningEfforts: ['low', 'medium', 'high', 'max'],
   }),
   createCuratedModel({
     id: 'cline-pass/mimo-v2.5-pro',
     name: 'MiMo V2.5 Pro',
-    description: 'Xiaomi MiMo advanced agentic reasoning model with multimodal support.',
-    ctx: 128000, maxTokens: 8192, input: ['text', 'image'], category: 'coding', recommended: false,
+    description: 'Xiaomi MiMo advanced agentic reasoning model with multimodal support.', input: ['text', 'image'], category: 'coding', recommended: false,
     reasoningEfforts: ['low', 'medium', 'high', 'max'],
   }),
 ])
@@ -285,7 +276,7 @@ export function parsePlanIncludedModels(includedInput) {
  *
  * Applies user-defined modelContextOverrides (custom contextLength and maxTokens).
  */
-export function getAllModels(dynamicModels = [], modelContextOverrides = [], customModels = []) {
+export function getAllModels(dynamicModels = [], modelContextOverrides = [], customModels = [], options = {}) {
   const normalizedDynamic = (Array.isArray(dynamicModels) ? dynamicModels : []).map(migrateModelEntry)
   const overridesMap = new Map()
   if (Array.isArray(modelContextOverrides)) {
@@ -328,6 +319,7 @@ export function getAllModels(dynamicModels = [], modelContextOverrides = [], cus
     }
   }
 
+  const dynamicIdSet = new Set(normalizedDynamic.map((m) => m.id))
   let baseModels = []
   if (normalizedDynamic.length > 0) {
     const normalize = (s) => String(s || '').toLowerCase().replace(/[\s._-]+/g, '')
@@ -348,26 +340,41 @@ export function getAllModels(dynamicModels = [], modelContextOverrides = [], cus
           originalContextLength: curated.originalContextLength || getOriginalModelContext(curated.id),
           originalMaxTokens: curated.originalMaxTokens || getOriginalModelMaxTokens(curated.id),
           originalProvider: curated.originalProvider || getOriginalModelProvider(curated.id),
-          defaultMaxTokens: curated.defaultMaxTokens || curated.maxTokens || 8192,
+          defaultMaxTokens: curated.defaultMaxTokens || curated.maxTokens || getOriginalModelMaxTokens(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,
+          inPlan: true,
           unverified: false,
         })
       }
+      const dynOrigCtx = getOriginalModelContext(dm.id)
+      const dynOrigMax = getOriginalModelMaxTokens(dm.id)
       return applyOverride({
         ...dm,
-        clineContextLength: dm.contextLength || 200000,
-        defaultContextLength: dm.contextLength || 200000,
-        originalContextLength: dm.originalContextLength || getOriginalModelContext(dm.id),
-        originalMaxTokens: dm.originalMaxTokens || getOriginalModelMaxTokens(dm.id),
+        clineContextLength: dm.contextLength || dynOrigCtx,
+        defaultContextLength: dm.contextLength || dynOrigCtx,
+        originalContextLength: dm.originalContextLength || dynOrigCtx,
+        originalMaxTokens: dm.originalMaxTokens || dynOrigMax,
         originalProvider: dm.originalProvider || getOriginalModelProvider(dm.id),
-        defaultMaxTokens: dm.maxTokens || 8192,
+        defaultMaxTokens: dm.maxTokens || dynOrigMax,
+        contextLength: dm.contextLength || dynOrigCtx,
+        maxTokens: dm.maxTokens || dynOrigMax,
+        inPlan: true,
         unverified: false,
       })
     })
+
+    if (options && options.includeOutOfPlan) {
+      const baseModelIds = new Set(baseModels.map((m) => m.id))
+      for (const cm of CLINE_MODELS) {
+        if (!baseModelIds.has(cm.id) && !dynamicIdSet.has(cm.id)) {
+          baseModels.push(applyOverride({ ...cm, inPlan: false, unverified: false }))
+        }
+      }
+    }
   } else {
-    baseModels = CLINE_MODELS.map((m) => applyOverride({ ...m, unverified: true }))
+    baseModels = CLINE_MODELS.map((m) => applyOverride({ ...m, inPlan: true, unverified: true }))
   }
 
   if (Array.isArray(customModels) && customModels.length > 0) {
@@ -383,6 +390,7 @@ export function getAllModels(dynamicModels = [], modelContextOverrides = [], cus
           input: Array.isArray(cm.input) && cm.input.length ? cm.input : ['text'],
           category: cm.category || 'general',
           isCustom: true,
+          inPlan: true,
           reasoningEfforts: cm.reasoningEfforts !== undefined ? cm.reasoningEfforts : (cm.isReasoning ? ['low', 'medium', 'high', 'max'] : undefined),
           unverified: false,
         }

package/lib/proxy-token.js

@@ -14,9 +14,9 @@ export const LOCAL_PROXY_KEY_ENV = 'CLINEBOT_LOCAL_PROXY_TOKEN'
 let cachedToken = null
 
 const require = createRequire(import.meta.url)
-let packageVersion = '0.5.26'
+let packageVersion = '0.5.28'
 try {
-  packageVersion = require('../package.json').version || '0.5.26'
+  packageVersion = require('../package.json').version || '0.5.28'
 } catch (err) {
   /* fallback to default version if manifest is unreadable */
 }

package/lib/routes/models.js

@@ -274,4 +274,41 @@ export function registerModelsRoutes(ctx, { live, getSettingsApi, syncProviderSt
       }
     },
   }), 'dsh-clinebot: /models/probe')
+  // POST /dsh-clinebot/models/visible — configure visible models and plan filtering
+  ctx.effect(() => ctx.webServer.register({
+    kind: 'exact',
+    path: '/dsh-clinebot/models/visible',
+    handler: async (req, res) => {
+      if (req.method !== 'POST') return writeJson(res, 405, { ok: false, error: 'POST only' })
+      if (!assertTrustedSettingsRequest(req, res, ctx)) 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 current = plainConfig(live())
+        const next = { ...current }
+        if (Array.isArray(body.visibleModels)) {
+          next.visibleModels = body.visibleModels
+        }
+        if (typeof body.filterModelsByPlan === 'boolean') {
+          next.filterModelsByPlan = body.filterModelsByPlan
+        }
+        await settingsApi.replace(next)
+        await syncProviderState(next)
+        writeJson(res, 200, {
+          ok: true,
+          visibleModels: next.visibleModels,
+          filterModelsByPlan: next.filterModelsByPlan,
+          enabledModels: publicConfig(next).enabledModels,
+        })
+      } catch (err) {
+        writeJson(res, 500, { ok: false, error: String(err?.message || err) })
+      }
+    },
+  }), 'dsh-clinebot: /models/visible')
+
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goodandready/dsh-clinebot",
-  "version": "0.5.26",
+  "version": "0.5.28",
   "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",