dsh-cline-pass 0.2.10 → 0.2.12

package/lib/adapter.js

@@ -54,17 +54,7 @@ export const DEFAULT_MAX_CONCURRENT_REQUESTS = 16
  * unknown ones; raise it per model in configuration when a new model ships.
  */
 export const DEFAULT_CONTEXT_WINDOW = 128000
-/**
- * Per-request output budget for a model whose caller names no `maxTokens`.
- *
- * A budget, not a ceiling: the harness materializes it into requests that omit
- * `maxTokens` and reserves the same number as completion room before it compacts,
- * so this is the number that decides how much of the window stays available to the
- * conversation. 64k is far past any single response a tool-calling agent emits
- * while keeping the reserve well under the point where it would start displacing
- * the compaction ratio. The published ceiling clamps it per model.
- */
-export const DEFAULT_MAX_TOKENS = 64000
+export { DEFAULT_MAX_TOKENS } from './catalog.js'
 /**
  * Request-image budget applied when the caller names none.
  *
@@ -992,7 +982,11 @@ export class ClinePassAdapter extends LlmAdapter {
             : 'ok',
         })
         this.config.record(options.model, {
-          provider: observed.provider ?? (attempt.upstream ?? null),
+          // The upstream the gateway actually served from, never the one we asked
+          // for: a pin the gateway declined is exactly what this column exists to
+          // expose, and filling it with the requested name would report the pin as if
+          // it had been adopted. An unreported routing reads as unknown upstream.
+          provider: observed.provider,
           canonical: observed.canonical,
           attempts: trace.map((row) => row.upstream),
           ms: Date.now() - startedAt,

package/lib/catalog.js

@@ -167,6 +167,22 @@ function pick(configured, published, fallback) {
   return fallback
 }
 
+/**
+ * Per-request output budget used when nothing else names one.
+ *
+ * A budget, not a ceiling: the harness materializes it into requests that omit
+ * `maxTokens`, and reserves the same number as completion room before it compacts, so
+ * this is the number that decides how much of the window stays available to the
+ * conversation.
+ *
+ * 128k doubles the room a long reasoning pass gets without moving that point on a 1M
+ * window: the 80% rule stays the binding one until the reserve passes ~144k. It is
+ * not applied flat, though — a 128k reserve on a 256k window would leave almost
+ * nothing to compact into — so the shipped default scales to the window while a
+ * configured value does not, because that one is a choice rather than a default.
+ */
+export const DEFAULT_MAX_TOKENS = 131072
+
 /**
  * The seam's whole `ModelModality` vocabulary. A catalog entry may list more
  * than this (models.dev reports `audio` for mimo-v2.5); the seam would reject
@@ -219,8 +235,11 @@ function resolveOutputBudget(budget, ceiling, contextWindow) {
   const most = Number.isFinite(ceiling) && ceiling > 0 ? ceiling : undefined
   const chosen = wanted === undefined ? most : most === undefined ? wanted : Math.min(wanted, most)
   if (chosen === undefined) return undefined
-  const half = Number.isFinite(contextWindow) && contextWindow > 0 ? Math.floor(contextWindow / 2) : undefined
-  return half === undefined ? chosen : Math.min(chosen, half)
+  if (!Number.isFinite(contextWindow) || contextWindow <= 0) return chosen
+  // The shipped default follows the window; a configured value is the user's choice
+  // and is only held back from reserving the window outright.
+  const share = wanted === DEFAULT_MAX_TOKENS ? 8 : 2
+  return Math.min(chosen, Math.floor(contextWindow / share))
 }
 
 /**

package/lib/client.js

@@ -77,6 +77,7 @@ window.__ModuleLoader__.load({
       '.cp-input,.cp-select{background:var(--dsw-alias-bg-base);color:var(--dsw-alias-label-primary);border:0.5px solid var(--dsw-alias-border-l2);border-radius:6px;padding:6px 8px;font-size:13px;min-width:0}',
       '.cp-input:focus-visible,.cp-select:focus-visible{outline:2px solid var(--dsw-alias-brand-primary);outline-offset:1px}',
       '.cp-btn{border:0.5px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-2);color:var(--dsw-alias-label-primary);border-radius:6px;padding:5px 10px;font-size:12px;cursor:pointer}',
+      '.cp-btn-on{border-color:var(--dsw-alias-brand-primary);color:var(--dsw-alias-brand-primary)}',
       '.cp-btn:hover:not(:disabled){border-color:var(--dsw-alias-brand-primary)}',
       '.cp-btn:disabled{opacity:.5;cursor:default}',
       '.cp-btn-primary{background:var(--dsw-alias-brand-primary);border-color:var(--dsw-alias-brand-primary);color:var(--dsw-alias-bg-base);font-weight:600}',
@@ -118,6 +119,11 @@ window.__ModuleLoader__.load({
       '.cp-acct-newname{flex:0 0 150px}',
       '.cp-acct-add,.cp-acct-key{border-top:0.5px solid var(--dsw-alias-border-l2);padding-top:10px;margin-top:2px}',
       '.cp-chips{display:flex;flex-wrap:wrap;gap:6px}',
+      '.cp-chip-manual{border-style:dashed;color:var(--dsw-alias-label-tertiary)}',
+      '.cp-small{font-size:11.5px}',
+      '.cp-caps{flex-direction:column;gap:8px;display:flex}',
+      '.cp-caps-boxes{flex-wrap:wrap;gap:10px}',
+      '.cp-cap{display:inline-flex;align-items:center;gap:5px;font-size:12px;color:var(--dsw-alias-label-secondary);cursor:pointer}',
       '.cp-chip{border:0.5px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-base);color:var(--dsw-alias-label-secondary);border-radius:999px;padding:2px 8px;font-size:12px;cursor:pointer;display:inline-flex;align-items:center;gap:5px}',
       '.cp-chip-on{border-color:var(--dsw-alias-brand-primary);color:var(--dsw-alias-label-primary);font-weight:600}',
       '.cp-chip-excluded{text-decoration:line-through;color:var(--dsw-alias-label-tertiary)}',
@@ -194,6 +200,7 @@ window.__ModuleLoader__.load({
       '.cp-history-load-row>span{white-space:nowrap}',
       '.cp-history-load-row>span:first-child{flex:none}',
       '.cp-history-load-row>span:last-child{min-width:0;overflow:hidden;text-overflow:ellipsis;text-align:right}',
+      '.cp-history-token-stack{display:flex;flex-direction:column;gap:1px;align-items:center}',
       '.cp-history-meta{display:flex;align-items:center;justify-content:center;gap:6px;min-width:0;overflow:hidden}',
       // A failure gets its own row under the entry rather than widening it: the
       // gateway's messages are long enough to wreck a one-line layout.
@@ -355,13 +362,15 @@ window.__ModuleLoader__.load({
       historyUpstream: '上游',
       historyLoad: '延迟',
       historyTokens: 'TOKEN',
+      historyCacheHit: '缓存',
       historyFirstChunk: '首字',
       historyTotal: '总耗时',
       historyRate: '输出速率',
       historyTokensHint: '↓输入 ↑输出 ⚡缓存 🧠推理；— 表示网关本次未返回用量',
       historyEffort: '推理强度',
       historyAuto: '(自动)',
-      noChannels: '未探测渠道',
+      historyUnknown: '(未上报)',
+      noChannels: '未探测到渠道，可手动输入',
       pinned: '已钉住',
       auto: '自动路由',
       modeAuto: '智能路由',
@@ -374,6 +383,24 @@ window.__ModuleLoader__.load({
       reset: '恢复自动',
       refresh: '刷新',
       channels: '渠道（点选＝钉住顺序，⊘＝排除）',
+      channelPlaceholder: '输入渠道名，回车添加',
+      budget: '输出预算',
+      budgetCurrent: '{n} tok',
+      budgetRecommended: '128K（推荐）',
+      budgetOfficial: '256K（对齐官方）',
+      budgetCustom: '自定义 token 数',
+      channelAdd: '添加',
+      channelUnverified: '未验证',
+      channelsKnown: '已探测：{list}',
+      capabilities: '上游能力',
+      capabilitiesExtraPlaceholder: '如 quantization:fp8 或 !quantization:bf16',
+      capabilitiesDirect: '最近一次探测走 OpenRouter，该路由会忽略此筛选',
+      capFree: '免费',
+      capImplicitCaching: '隐式缓存',
+      capReasoning: '推理',
+      capStructuredOutput: '结构化输出',
+      capToolUse: '工具调用',
+      capVision: '视觉',
       history: '最近请求',
       noHistory: '暂无记录。',
       busy: '处理中…',
@@ -447,13 +474,15 @@ window.__ModuleLoader__.load({
       historyUpstream: 'Upstream',
       historyLoad: 'Latency',
       historyTokens: 'Tokens',
+      historyCacheHit: 'cache',
       historyFirstChunk: 'first',
       historyTotal: 'total',
       historyRate: 'rate',
       historyTokensHint: '↓in ↑out ⚡cache 🧠reasoning; a dash means the gateway reported no usage',
       historyEffort: 'effort',
       historyAuto: '(auto)',
-      noChannels: 'No channels probed',
+      historyUnknown: '(unreported)',
+      noChannels: 'Nothing probed yet — type a name',
       pinned: 'Pinned',
       auto: 'Auto',
       modeAuto: 'Smart routing',
@@ -466,6 +495,24 @@ window.__ModuleLoader__.load({
       reset: 'Back to auto',
       refresh: 'Refresh',
       channels: 'Channels (click = pin order, ⊘ = exclude)',
+      channelPlaceholder: 'Channel name, Enter to add',
+      budget: 'Output budget',
+      budgetCurrent: '{n} tok',
+      budgetRecommended: '128K (recommended)',
+      budgetOfficial: '256K (matches official)',
+      budgetCustom: 'Custom token count',
+      channelAdd: 'Add',
+      channelUnverified: 'unverified',
+      channelsKnown: 'Probed: {list}',
+      capabilities: 'Upstream capabilities',
+      capabilitiesExtraPlaceholder: 'e.g. quantization:fp8 or !quantization:bf16',
+      capabilitiesDirect: 'The last probe saw OpenRouter; that route ignores this filter',
+      capFree: 'Free',
+      capImplicitCaching: 'Implicit caching',
+      capReasoning: 'Reasoning',
+      capStructuredOutput: 'Structured output',
+      capToolUse: 'Tool use',
+      capVision: 'Vision',
       history: 'Recent requests',
       noHistory: 'Nothing recorded.',
       busy: 'Working…',
@@ -751,6 +798,7 @@ window.__ModuleLoader__.load({
           pinModel: (payload) => controller.pinModel(payload),
           setModelVisible: (model, visible) => controller.setModelVisible(model, visible),
           setToolsExposed: (value) => controller.setToolsExposed(value),
+          setBudget: (value) => controller.setBudget(value),
           setModelsVisibility: (mode) => controller.setModelsVisibility(mode),
           probeModel: (model) => controller.probeModel(model),
           validateModel: (model) => controller.validateModel(model),
@@ -941,6 +989,13 @@ window.__ModuleLoader__.load({
         return result
       }
 
+      /** Set the per-request output budget, in tokens. */
+      async setBudget(value) {
+        const result = await this.run('budget', async () => await this.call('budget.set', { value }))
+        if (result !== undefined) this.applyState(result)
+        return result
+      }
+
       /**
        * Show, hide or swap every subscription model at once.
        *
@@ -1123,47 +1178,188 @@ window.__ModuleLoader__.load({
     }
 
     /** The channel chooser for one model. */
-    function ChannelPicker(props) {
+    /** The capability names the gateway accepts, in its own spelling. */
+    const CAPABILITIES = [
+      ['free', 'capFree'],
+      ['implicit-caching', 'capImplicitCaching'],
+      ['reasoning', 'capReasoning'],
+      ['structured-output', 'capStructuredOutput'],
+      ['tool-use', 'capToolUse'],
+      ['vision', 'capVision'],
+    ]
+
+    /**
+     * The channel list, editable.
+     *
+     * The chips used to be exactly what a probe returned, which made an account whose
+     * probe came back empty a dead end: the row said no channels were probed and
+     * offered no way to name the upstream the user already knew served them. The list
+     * is the user's data now — a probe fills it in, typing fills it in, and both are
+     * the same list.
+     */
+    function ChannelEditor(props) {
       const { t, model, disabled, onPin } = props
-      if (model.upstreams.length === 0) return h('div', { className: 'cp-muted' }, t('noChannels'))
+      const [draft, setDraft] = React.useState('')
       const verdicts = new Map((model.upstreamStatus ?? []).map((entry) => [entry.upstream, entry]))
-      return h('div', { className: 'cp-row' }, [
-        h('span', { key: 'label', className: 'cp-muted' }, t('channels')),
-        h('span', { key: 'chips', className: 'cp-chips' }, model.upstreams.map((upstream) => {
-          const pinned = model.pinned.includes(upstream)
-          const excluded = model.excluded.includes(upstream)
-          const verdict = verdicts.get(upstream)
-          const detail = verdict === undefined
-            ? ''
-            : ` · ${VERDICT[verdict.status] ?? verdict.status}${verdict.note ? `\n${verdict.note}` : ''}`
-          return h('span', { key: upstream, className: `cp-chip${pinned ? ' cp-chip-on' : ''}${excluded ? ' cp-chip-excluded' : ''}` }, [
-            h('span', {
-              key: 'pin',
-              role: 'button',
-              tabIndex: 0,
-              title: `${upstream}${detail}`,
-              onClick: () => {
-                if (disabled) return
-                const next = pinned ? model.pinned.filter((name) => name !== upstream) : [...model.pinned, upstream]
-                onPin({ model: model.id, upstreams: next })
-              },
-            }, [
-              h('span', { key: 'dot', style: { marginRight: 5 } }, h(Dot, { color: verdictColor(verdict?.status ?? 'unknown'), title: VERDICT[verdict?.status ?? 'unknown'] })),
-              upstream,
-            ]),
-            h('span', {
-              key: 'ex',
-              role: 'button',
-              tabIndex: 0,
-              title: excluded ? 'un-exclude' : 'exclude',
-              onClick: () => {
-                if (disabled) return
-                const next = excluded ? model.excluded.filter((name) => name !== upstream) : [...model.excluded, upstream]
-                onPin({ model: model.id, exclude: next })
-              },
-            }, '⊘'),
-          ])
-        })),
+      const known = model.upstreams
+      // A chosen name shows even when no probe reported it: a chip that disappears is
+      // a chip that cannot be removed.
+      const names = [...new Set([...known, ...model.pinned, ...model.excluded])]
+      const pin = (next) => {
+        if (disabled) return
+        onPin({ model: model.id, upstreams: next })
+      }
+      const add = () => {
+        const name = draft.trim()
+        if (name === '') return
+        setDraft('')
+        const needle = name.toLowerCase()
+        if (model.pinned.some((entry) => String(entry).toLowerCase() === needle)) return
+        pin([...model.pinned, name])
+      }
+      return h('div', { className: 'cp-caps' }, [
+        h('div', { key: 'row', className: 'cp-row' }, [
+          h('span', { key: 'label', className: 'cp-muted' }, t('channels')),
+          names.length === 0
+            ? h('span', { key: 'none', className: 'cp-muted' }, t('noChannels'))
+            : h('span', { key: 'chips', className: 'cp-chips' }, names.map((upstream) => {
+              const pinned = model.pinned.includes(upstream)
+              const excluded = model.excluded.includes(upstream)
+              const probed = known.includes(upstream)
+              const verdict = verdicts.get(upstream)
+              const detail = verdict === undefined
+                ? ''
+                : ` · ${VERDICT[verdict.status] ?? verdict.status}${verdict.note ? `\n${verdict.note}` : ''}`
+              return h('span', {
+                key: upstream,
+                className: `cp-chip${pinned ? ' cp-chip-on' : ''}${excluded ? ' cp-chip-excluded' : ''}${probed ? '' : ' cp-chip-manual'}`,
+              }, [
+                h('span', {
+                  key: 'pin',
+                  role: 'button',
+                  tabIndex: 0,
+                  title: `${upstream}${probed ? '' : ` · ${t('channelUnverified')}`}${detail}`,
+                  onClick: () => {
+                    if (disabled) return
+                    const next = pinned ? model.pinned.filter((name) => name !== upstream) : [...model.pinned, upstream]
+                    onPin({ model: model.id, upstreams: next })
+                  },
+                }, [
+                  h('span', { key: 'dot', style: { marginRight: 5 } }, h(Dot, { color: verdictColor(verdict?.status ?? 'unknown'), title: VERDICT[verdict?.status ?? 'unknown'] })),
+                  upstream,
+                ]),
+                h('span', {
+                  key: 'ex',
+                  role: 'button',
+                  tabIndex: 0,
+                  title: excluded ? 'un-exclude' : 'exclude',
+                  onClick: () => {
+                    if (disabled) return
+                    const next = excluded ? model.excluded.filter((name) => name !== upstream) : [...model.excluded, upstream]
+                    onPin({ model: model.id, exclude: next })
+                  },
+                }, '⊘'),
+                // A name that only exists because someone typed it has no discovery
+                // list to fall back on, so it needs an explicit way out: un-pinning
+                // removes it, and this is what says so.
+                probed ? null : h('span', {
+                  key: 'del',
+                  role: 'button',
+                  tabIndex: 0,
+                  title: 'remove',
+                  onClick: () => {
+                    if (disabled) return
+                    onPin({
+                      model: model.id,
+                      upstreams: model.pinned.filter((name) => name !== upstream),
+                      exclude: model.excluded.filter((name) => name !== upstream),
+                    })
+                  },
+                }, '×'),
+              ])
+            })),
+        ]),
+        h('div', { key: 'add', className: 'cp-row' }, [
+          h('input', {
+            key: 'in',
+            type: 'text',
+            className: 'cp-input cp-grow',
+            value: draft,
+            disabled,
+            placeholder: t('channelPlaceholder'),
+            'aria-label': `${t('channelAdd')}: ${model.id}`,
+            onChange: (event) => setDraft(event.target.value),
+            onKeyDown: (event) => {
+              if (event.key !== 'Enter') return
+              event.preventDefault()
+              add()
+            },
+          }),
+          h('button', { key: 'b', type: 'button', className: 'cp-btn', disabled, onClick: add }, t('channelAdd')),
+        ]),
+        known.length === 0 ? null : h('div', { key: 'known', className: 'cp-muted cp-small' }, fill(t('channelsKnown'), { list: known.join(' · ') })),
+      ])
+    }
+
+    /**
+     * The capabilities an upstream must offer for this model.
+     *
+     * The gateway applies this itself and rejects a name it does not know, so the six
+     * it documents are checkboxes and anything else — a weight format such as
+     * `quantization:fp8`, or its negation — is typed. It only exists on the planner
+     * pipeline: OpenRouter has no equivalent, and a model known to run there says so
+     * rather than letting a filter look active while it is ignored.
+     */
+    function CapabilityFilter(props) {
+      const { t, model, disabled, onPin } = props
+      const [extra, setExtra] = React.useState('')
+      const chosen = model.has ?? []
+      const write = (next) => {
+        if (disabled) return
+        onPin({ model: model.id, has: next })
+      }
+      const toggle = (id) => write(chosen.includes(id) ? chosen.filter((name) => name !== id) : [...chosen, id])
+      const addExtra = () => {
+        const value = extra.trim()
+        if (value === '') return
+        setExtra('')
+        if (chosen.includes(value)) return
+        write([...chosen, value])
+      }
+      const extras = chosen.filter((name) => !CAPABILITIES.some(([id]) => id === name))
+      return h('div', { className: 'cp-caps' }, [
+        h('div', { key: 'head', className: 'cp-row' }, [
+          h('span', { key: 'l', className: 'cp-muted' }, t('capabilities')),
+          model.pipeline === 'direct' ? h('span', { key: 'w', className: 'cp-muted cp-small' }, t('capabilitiesDirect')) : null,
+        ]),
+        h('span', { key: 'boxes', className: 'cp-row cp-caps-boxes' }, CAPABILITIES.map(([id, key]) =>
+          h('label', { key: id, className: 'cp-cap' }, [
+            h('input', {
+              key: 'c', type: 'checkbox', className: 'cp-check',
+              checked: chosen.includes(id), disabled, onChange: () => toggle(id),
+            }),
+            h('span', { key: 't' }, t(key)),
+          ]))),
+        h('div', { key: 'extra', className: 'cp-row' }, [
+          h('input', {
+            key: 'in', type: 'text', className: 'cp-input cp-grow',
+            value: extra, disabled,
+            placeholder: t('capabilitiesExtraPlaceholder'),
+            'aria-label': `${t('capabilities')}: ${model.id}`,
+            onChange: (event) => setExtra(event.target.value),
+            onKeyDown: (event) => {
+              if (event.key !== 'Enter') return
+              event.preventDefault()
+              addExtra()
+            },
+          }),
+          h('button', { key: 'b', type: 'button', className: 'cp-btn', disabled, onClick: addExtra }, t('channelAdd')),
+        ]),
+        extras.length === 0 ? null : h('span', { key: 'list', className: 'cp-chips' }, extras.map((name) =>
+          h('span', { key: name, className: 'cp-chip cp-chip-on' }, [
+            h('span', { key: 'n' }, name),
+            h('span', { key: 'x', role: 'button', tabIndex: 0, title: 'remove', onClick: () => toggle(name) }, '×'),
+          ]))),
       ])
     }
 
@@ -1230,9 +1426,8 @@ window.__ModuleLoader__.load({
             action('test', t('testPin'), actions.testModel),
             action('reset', t('reset'), actions.resetModel),
           ]),
-          model.upstreams.length > 0
-            ? h(ChannelPicker, { key: 'channels', t, model, disabled, onPin: (payload) => actions.pinModel(payload) })
-            : h('div', { key: 'none', className: 'cp-muted' }, t('noChannels')),
+          h(ChannelEditor, { key: 'channels', t, model, disabled, onPin: (payload) => actions.pinModel(payload) }),
+          h(CapabilityFilter, { key: 'caps', t, model, disabled, onPin: (payload) => actions.pinModel(payload) }),
         ]) : null,
       ])
     }
@@ -1428,6 +1623,60 @@ window.__ModuleLoader__.load({
       ])
     }
 
+    /**
+     * The per-request output budget.
+     *
+     * One number for the whole route: the harness reserves it as completion room on
+     * every request, so it decides where compaction fires as much as how long one
+     * response may be. The two presets are the shipped default and the figure
+     * DeepSeek's own provider uses; anything else is typed.
+     */
+    function BudgetCard(props) {
+      const { t, data, disabled, actions } = props
+      const current = Number(data.defaultMaxTokens ?? 0)
+      const [draft, setDraft] = React.useState('')
+      const write = (value) => {
+        if (disabled) return
+        actions.setBudget(value)
+      }
+      const custom = () => {
+        const value = Number(draft.trim())
+        if (!Number.isSafeInteger(value) || value < 1024) return
+        setDraft('')
+        write(value)
+      }
+      return h('div', { className: 'cp-card' }, [
+        h('div', { key: 'title', className: 'cp-card-title' }, `${t('budget')} · ${fill(t('budgetCurrent'), { n: current.toLocaleString('en-US') })}`),
+        h('div', { key: 'row', className: 'cp-row' }, [
+          h('button', {
+            key: 'recommended', type: 'button',
+            className: `cp-btn${current === 131072 ? ' cp-btn-on' : ''}`,
+            disabled, onClick: () => write(131072),
+          }, t('budgetRecommended')),
+          h('button', {
+            key: 'official', type: 'button',
+            className: `cp-btn${current === 256000 ? ' cp-btn-on' : ''}`,
+            disabled, onClick: () => write(256000),
+          }, t('budgetOfficial')),
+        ]),
+        h('div', { key: 'custom', className: 'cp-row' }, [
+          h('input', {
+            key: 'in', type: 'text', className: 'cp-input cp-grow',
+            value: draft, disabled,
+            placeholder: t('budgetCustom'),
+            'aria-label': t('budget'),
+            onChange: (event) => setDraft(event.target.value),
+            onKeyDown: (event) => {
+              if (event.key !== 'Enter') return
+              event.preventDefault()
+              custom()
+            },
+          }),
+          h('button', { key: 'b', type: 'button', className: 'cp-btn', disabled, onClick: custom }, t('channelAdd')),
+        ]),
+      ])
+    }
+
     /**
      * The models card: a fold-away section, like the request history.
      *
@@ -1487,12 +1736,13 @@ window.__ModuleLoader__.load({
      */
     function historyRows(t, entry, showAccount) {
       const failed = String(entry.error ?? '') !== ''
-      const upstream = `${entry.provider || t('historyAuto')}${showAccount && entry.account !== '' ? ` · ${entry.account}` : ''}`
+      const upstream = `${entry.provider || t('historyUnknown')}${showAccount && entry.account !== '' ? ` · ${entry.account}` : ''}`
       // The route prefix is constant across every row of this list, so it is
       // carried in the tooltip instead of eating the width the model name needs
       // — centred text that overflows loses BOTH ends, not just the tail.
       const label = String(entry.model).replace(/^cline-pass\//, '')
       const figures = latency(entry)
+      const cacheHit = entry.cacheHit === undefined ? null : entry.cacheHit
       const row = h('tr', {
         key: 'row',
         // The whole row restates itself on hover, including the figures the three
@@ -1516,7 +1766,7 @@ window.__ModuleLoader__.load({
         h('td', { key: 'model', className: 'cp-history-model-cell' }, h('div', { className: 'cp-history-model-stack' }, [
           h('span', { key: 'name', className: 'cp-history-model', title: entry.model }, label),
           h('span', { key: 'upstream', className: 'cp-history-meta' }, [
-            h('span', { key: 'provider', className: 'cp-tag' }, entry.provider || t('historyAuto')),
+            h('span', { key: 'provider', className: 'cp-tag' }, entry.provider || t('historyUnknown')),
             showAccount && entry.account !== '' ? h('span', { key: 'account', className: 'cp-tag cp-tag-quiet' }, entry.account) : null,
           ]),
         ])),
@@ -1526,8 +1776,11 @@ window.__ModuleLoader__.load({
         h('td', {
           key: 'tokens',
           className: 'cp-history-tokens',
-          title: `${tokenSummaryExact(entry)}\n${t('historyTokensHint')}`,
-        }, tokenSummary(entry)),
+          title: `${tokenSummaryExact(entry)}\n${cacheHit === null ? '' : `${t('historyCacheHit')} ${cacheHit.toFixed(2)}%\n`}${t('historyTokensHint')}`,
+        }, h('div', { className: 'cp-history-token-stack' }, [
+          h('span', { key: 'sum' }, tokenSummary(entry)),
+          cacheHit === null ? null : h('span', { key: 'cache', className: 'cp-muted cp-small' }, `${t('historyCacheHit')} ${cacheHit.toFixed(2)}%`),
+        ])),
         h('td', { key: 'load', className: 'cp-history-load' }, [
           h('span', { key: 'first', className: 'cp-history-load-row' }, [
             h('span', { key: 'k', className: 'cp-muted' }, t('historyFirstChunk')),
@@ -1780,6 +2033,7 @@ window.__ModuleLoader__.load({
         pinModel: props.pinModel,
         setModelVisible: props.setModelVisible,
         setToolsExposed: props.setToolsExposed,
+        setBudget: props.setBudget,
         setModelsVisibility: props.setModelsVisibility,
         probeModel: props.probeModel,
         validateModel: props.validateModel,
@@ -1837,8 +2091,9 @@ window.__ModuleLoader__.load({
         // Everything below the accounts card reads through the key that card
         // stores, so none of it exists until there is one.
         data === null || !ready ? null : h(ModelsCard, { key: 'models', t, data, disabled, busy: state.busy, actions }),
-        // Route-wide switches last: they are not about one model or account, and
+        // Route-wide settings last: they are not about one model or account, and
         // nothing below them depends on their value.
+        data === null ? null : h(BudgetCard, { key: 'budget', t, data, disabled: state.busy !== null || data.settingsAvailable === false, actions }),
         data === null ? null : h('div', { key: 'tools', className: 'cp-card' }, [
           h('label', { key: 'head', className: 'cp-row cp-tools-label' }, [
             h('input', {

package/lib/index.js

@@ -106,6 +106,17 @@ export const PinProfile = z.object({
   exclude: z.array(z.string()).default([]),
   pinMode: z.string().default('strict'),
   sort: z.string().default(''),
+  /**
+   * Capabilities an upstream must offer for this model, in the gateway's own
+   * vocabulary: `free`, `implicit-caching`, `reasoning`, `structured-output`,
+   * `tool-use`, `vision`, or a weight condition such as `quantization:fp8` /
+   * `!quantization:bf16`.
+   *
+   * The gateway applies this server-side and rejects a name it does not know, so
+   * the panel checks the list before it is written. It only exists on the planner
+   * pipeline — OpenRouter has no equivalent — and a model routed there ignores it.
+   */
+  has: z.array(z.string()).default([]),
 })
 
 /**
@@ -149,6 +160,11 @@ export const Config = z.object({
    * larger, and reporting that here reserves it on every request — at the shipped
    * 384k figure a 1M window compacts at 55% instead of the 80% the threshold ratio
    * asks for. Each model's published ceiling clamps whatever is set here.
+   *
+   * Nothing here may reserve more than half the window. The shipped default goes
+   * further and scales to an eighth on a small window, because a flat 128k reserve
+   * leaves a 256k model almost nothing to compact into; an explicit value counts as a
+   * choice and only gets the half-window limit.
    */
   defaultMaxTokens: z.number().default(DEFAULT_MAX_TOKENS),
   streamIdleTimeoutMs: z.number().default(DEFAULT_STREAM_IDLE_TIMEOUT_MS),

package/lib/panel.js

@@ -71,6 +71,7 @@ export function projectModel(model, pin, meta, hidden = false) {
     sort: String(pin?.sort ?? ''),
     pinned: Array.isArray(pin?.upstreams) ? pin.upstreams.map(String) : [],
     excluded: Array.isArray(pin?.exclude) ? pin.exclude.map(String) : [],
+    has: Array.isArray(pin?.has) ? pin.has.map(String) : [],
     upstreams: Array.isArray(meta?.upstreams) ? meta.upstreams.map(String) : [],
     upstreamStatus,
     lastProvider: String(meta?.lastProvider ?? ''),
@@ -129,6 +130,9 @@ export function createPanel({ control, engine, store }) {
       provider: control.providerName,
       displayName: control.displayName,
       baseURL: String(config.baseURL ?? ''),
+      // The per-request output budget: one number for the whole route, because it
+      // decides how much of every window the harness holds back as completion room.
+      defaultMaxTokens: Number(config.defaultMaxTokens ?? 0),
       settingsAvailable: control.settingsAvailable(),
       accountMode: config.accountMode === 'roundrobin' ? 'roundrobin' : 'single',
       activeAccount: String(config.activeAccount ?? ''),
@@ -377,6 +381,9 @@ export function createPanel({ control, engine, store }) {
       sort: payload?.sort === undefined
         ? (current.sort ?? '')
         : (payload.sort === 'none' || payload.sort === '' ? '' : String(payload.sort)),
+      has: Array.isArray(payload?.has)
+        ? [...new Set(payload.has.map((name) => String(name).trim()).filter((name) => name.length > 0))]
+        : (current.has ?? []).map(String),
     }
     await control.updateConfig({ perModel: { ...(config.perModel ?? {}), [model]: next } })
     return { model, pin: next, ...(await state()) }
@@ -445,6 +452,21 @@ export function createPanel({ control, engine, store }) {
     return await modelPin({ model: modelOf(payload), upstreams: [], exclude: [], sort: 'none', pinMode: 'preferred' })
   }
 
+  /**
+   * Cache reads as a share of billed prompt tokens, or null when nothing was measured.
+   *
+   * A ratio over zero is not a reading, and 0% would claim "nothing cached" for a
+   * request the gateway never reported usage for.
+   */
+  function cacheHitOf(usage) {
+    if (usage === null || usage === undefined) return null
+    const cached = Number(usage.cacheReadTokens ?? 0)
+    const billed = cached + Number(usage.inputTokens ?? 0)
+    // Two decimals: an integer round turns 99.6% into a flat 100%, which reads as a
+    // claim the numbers do not support.
+    return billed <= 0 ? null : Math.round((cached / billed) * 10000) / 100
+  }
+
   /** The live request history, newest first. */
   async function history(payload) {
     const limit = Number.isSafeInteger(payload?.limit) && payload.limit > 0 ? Math.min(payload.limit, 100) : 25
@@ -469,6 +491,7 @@ export function createPanel({ control, engine, store }) {
           cacheReadTokens: Number(entry.usage?.cacheReadTokens ?? 0),
           reasoningTokens: Number(entry.usage?.reasoningTokens ?? 0),
         },
+        cacheHit: cacheHitOf(entry.usage),
         effort: String(entry.effort ?? ''),
         stream: entry.stream === true,
         error: firstLine(entry.error, 200),
@@ -486,6 +509,23 @@ export function createPanel({ control, engine, store }) {
    * The response carries `restartRequired` so the panel can say so instead of
    * implying the switch already took effect.
    */
+  /**
+   * Set the per-request output budget.
+   *
+   * The panel offers the two numbers that matter — the shipped default, and the one
+   * DeepSeek's own provider uses — plus whatever a user types. It is a route-wide
+   * setting rather than a per-model one because it is the same policy for every
+   * model: how much of a window to hold back for one response.
+   */
+  async function budgetSet(payload) {
+    const value = Number(payload?.value)
+    if (!Number.isSafeInteger(value) || value < 1024 || value > 2000000) {
+      throw new Error(`the output budget must be a whole number of tokens between 1024 and 2000000 (got ${JSON.stringify(payload?.value)})`)
+    }
+    await control.updateConfig({ defaultMaxTokens: value })
+    return await state()
+  }
+
   async function toolsExpose(payload) {
     if (typeof payload?.value !== 'boolean') throw new Error('this action needs a boolean `value`')
     await control.updateConfig({ exposeTools: payload.value })
@@ -510,6 +550,7 @@ export function createPanel({ control, engine, store }) {
     'model.reset': modelReset,
     'models.refresh': modelsRefresh,
     'tools.expose': toolsExpose,
+    'budget.set': budgetSet,
     history,
   }
 }

package/lib/protocol.js

@@ -59,7 +59,15 @@ export function isAuthenticationError(message, status) {
 export function parseRouting(json) {
   const payload = unwrapEnvelope(json)
   const message = payload?.choices?.[0]?.message
-  const routing = message?.provider_metadata?.gateway?.routing ?? payload?.provider_metadata?.gateway?.routing ?? {}
+  // A non-streaming answer carries routing on the message; a stream carries the same
+  // object on the delta instead. Reading only the message left every streamed request
+  // with no upstream at all, which the history then filled in with the pinned name —
+  // reporting a pin the gateway may never have adopted.
+  const delta = payload?.choices?.[0]?.delta
+  const routing = message?.provider_metadata?.gateway?.routing
+    ?? delta?.provider_metadata?.gateway?.routing
+    ?? payload?.provider_metadata?.gateway?.routing
+    ?? {}
   const direct = typeof payload?.provider === 'string' ? payload.provider : null
   return {
     content: typeof message?.content === 'string' ? message.content : null,
@@ -184,6 +192,9 @@ function knownChannels(meta, pipeline) {
 export function injectPrefs(body, meta, attempt) {
   const next = { ...body }
   const { upstream = null, orderRest = [], excludeList = [], strict = true } = attempt ?? {}
+  // `has` names the capabilities an upstream must offer. There is no equivalent on
+  // the OpenRouter spelling, so a direct-pipeline model simply does not carry it.
+  const required = (Array.isArray(attempt?.has) ? attempt.has : []).map((name) => String(name).trim()).filter((name) => name.length > 0)
   // Normalized here as well as in buildAttempts: this function is exported, so
   // a caller can hand it an attempt straight from configuration.
   const sort = normalizeSort(attempt?.sort)
@@ -197,7 +208,7 @@ export function injectPrefs(body, meta, attempt) {
   const both = attempt?.spelling !== 'detected'
   const useGateway = both || pipeline === 'planner' || pipeline === null
   const useOpenRouter = both || pipeline === 'direct' || pipeline === null
-  const gatewayUsable = useGateway && (upstream !== null || sort !== null || (gatewayAllow !== null && gatewayAllow.length > 0))
+  const gatewayUsable = useGateway && (upstream !== null || sort !== null || required.length > 0 || (gatewayAllow !== null && gatewayAllow.length > 0))
   // `ignore` is OpenRouter's own exclusion field: written alongside the
   // allow-list so an exclusion still bites when the allow-list cannot be
   // computed (no channel list yet) or has gone stale.
@@ -215,6 +226,7 @@ export function injectPrefs(body, meta, attempt) {
       gateway.only = spell(gatewayAllow, 'planner')
     }
     if (sort !== null) gateway.sort = sort
+    if (required.length > 0) gateway.has = required
     next.providerOptions = { ...(next.providerOptions ?? {}), gateway: { ...(next.providerOptions?.gateway ?? {}), ...gateway } }
   }
   if (openRouterUsable) {
@@ -316,7 +328,12 @@ export function buildAttempts(config) {
   const wanted = listed.filter((name) => !excluded.has(normalizeSlug(name)))
   const strict = normalizePinMode(config?.pinMode) === 'strict'
   const sort = normalizeSort(config?.sort)
-  const base = { strict, sort, excludeList: exclude }
+  // The capability filter is gateway-only and applies to every attempt, so it rides
+  // in the shared base rather than being threaded through each candidate.
+  const has = (Array.isArray(config?.has) ? config.has : [])
+    .map((name) => String(name).trim())
+    .filter((name) => name.length > 0)
+  const base = { strict, sort, excludeList: exclude, ...(has.length > 0 ? { has } : {}) }
   // Carried through only when the caller configured it, so an attempt built from
   // a bare pin profile keeps its historical shape.
   if (typeof config?.spelling === 'string' && config.spelling.length > 0) base.spelling = config.spelling

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-cline-pass",
-  "version": "0.2.10",
+  "version": "0.2.12",
   "description": "Self-contained Cline Pass provider for dsh: register Cline Pass subscription models on the harness LLM seam, enumerate and validate the upstream channels behind each model, pin or exclude them with failover, and drive an account pool. No proxy process and no external cline-pass-switcher install required.",
   "type": "module",
   "main": "lib/index.js",