dsh-cline-pass 0.2.9 → 0.2.11

package/README.en.md

@@ -22,7 +22,7 @@ Requires Node.js `>= 20.3.0`, dsh `>= 0.1.2-alpha.3 < 0.3.0`, and a valid Cline
 dsh plugin --profile web add dsh-cline-pass
 ```
 
-Restart dsh, open **Settings → Built-in Plugins → Cline Pass** to save and test your API key, then select a Cline Pass model in the model picker. Keys are stored in the dsh credential store and displayed only in masked form.
+Restart dsh, open **Settings → Cline Pass** to save and test your API key, then select a Cline Pass model in the model picker. Keys are stored in the dsh credential store and displayed only in masked form.
 
 Alternatively, configure the key through an environment variable:
 

package/README.md

@@ -22,7 +22,7 @@
 dsh plugin --profile web add dsh-cline-pass
 ```
 
-安装后重启 dsh，在 **设置 → 内置插件 → Cline Pass** 中保存并测试 API Key，然后在模型选择器中选择 Cline Pass 模型。Key 存入 dsh 凭据库，界面仅显示掩码。
+安装后重启 dsh，在 **设置 → Cline Pass** 中保存并测试 API Key，然后在模型选择器中选择 Cline Pass 模型。Key 存入 dsh 凭据库，界面仅显示掩码。
 
 也可以通过环境变量配置：
 

package/lib/adapter.js

@@ -992,7 +992,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/client.js

@@ -84,6 +84,17 @@ window.__ModuleLoader__.load({
       '.cp-dot{width:8px;height:8px;border-radius:50%;display:inline-block;flex:none}',
       '.cp-table{display:flex;flex-direction:column;gap:6px}',
       '.cp-model{border:0.5px solid var(--dsw-alias-border-l2);border-radius:8px;padding:8px;display:flex;flex-direction:column;gap:8px}',
+      // The bulk toolbar sits directly above the first row; the card's own 10px gap
+      // reads as none against two stacked borders, so this card opens it up.
+      '.cp-models{gap:14px}',
+      '.cp-models-body{flex-direction:column;gap:16px;display:flex}',
+      // One line per model. `.cp-row` wraps by default, which a long id plus a long
+      // pin order turns into a two-line row that reads as broken rather than dense;
+      // both texts ellipsis instead, and their full value stays in `title`.
+      '.cp-model-head{flex-wrap:nowrap;min-width:0}',
+      '.cp-model-head .cp-grow{min-width:0}',
+      '.cp-model-mode{flex:none;max-width:55%}',
+      '.cp-ellipsis{overflow:hidden;text-overflow:ellipsis;white-space:nowrap}',
       // The account table is a real table for the same reason the history one
       // is: per-row grids size their `auto` tracks from their own content, so a
       // header cell never lines up with the data under it.
@@ -107,6 +118,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)}',
@@ -195,16 +211,10 @@ window.__ModuleLoader__.load({
       // Plugins-page card chrome, mirrored token for token from the host's own
       // `PluginCard`: that tab hands a plugin the whole card, so matching it —
       // rather than inventing a second look — is this bundle's job.
-      '.cp-set-card{border:0.5px solid var(--dsw-alias-border-l4);background:var(--dsw-alias-bg-layer-3);border-radius:16px;list-style:none;transition:border-color .16s,background .16s}',
-      '.cp-set-card:hover{border-color:var(--dsw-alias-label-dimmed)}',
-      '.cp-set-card-open{background:var(--dsw-alias-bg-layer-2);border-color:var(--dsw-alias-label-dimmed)}',
-      '.cp-set-header{appearance:none;width:100%;font:inherit;color:inherit;text-align:left;cursor:pointer;background:0 0;border:0;border-radius:12px;align-items:center;gap:12px;padding:14px 16px;display:flex}',
-      '.cp-set-header:focus-visible{outline:2px solid var(--dsw-alias-brand-primary);outline-offset:-2px}',
-      '.cp-set-head-text{flex-direction:column;flex:1;gap:4px;min-width:0;display:flex}',
+      '.cp-set-card{border:0.5px solid var(--dsw-alias-border-l4);background:var(--dsw-alias-bg-layer-3);border-radius:16px;list-style:none}',
+      '.cp-set-head{flex-direction:column;gap:4px;display:flex;padding:14px 16px}',
       '.cp-set-name{color:var(--dsw-alias-label-primary);font-size:15px;font-weight:600;line-height:1.4}',
       '.cp-set-desc{color:var(--dsw-alias-label-tertiary);font-size:13px;line-height:1.5}',
-      '.cp-set-chevron{color:var(--dsw-alias-label-tertiary);flex:none;transition:transform .16s}',
-      '.cp-set-chevron-open{transform:rotate(180deg)}',
       '.cp-chevron{color:var(--dsw-alias-label-tertiary);flex:none;transition:transform .16s;display:inline-flex}',
       'details[open]>summary .cp-chevron{transform:rotate(180deg)}',
       // A summary laid out as a flex row keeps no native affordance, so the
@@ -288,8 +298,6 @@ window.__ModuleLoader__.load({
       title: 'Cline Pass',
       description: '订阅模型的渠道钉住与账号池配置',
       panelUnavailable: '浏览器通道不可用。',
-      expand: '展开设置',
-      collapse: '收起设置',
       keyOk: 'API Key 已配置',
       keyMissing: '尚未配置 API Key',
       keyValue: 'API Key',
@@ -317,9 +325,10 @@ window.__ModuleLoader__.load({
       active: '当前账号',
       addAccount: '添加',
       accountName: '账号名',
-      models: '订阅模型',
+      models: 'cline-pass',
       modelsCount: '{n} 个模型',
-      hiddenModels: '{n} 个已从选择列表隐藏',
+      hiddenModels: '{n} 隐藏',
+      hiddenModelsHint: '{n} 个已从选择列表隐藏',
       visible: '在模型选择列表中显示',
       hiddenTag: '已隐藏',
       selectAll: '全选',
@@ -357,15 +366,33 @@ window.__ModuleLoader__.load({
       historyTokensHint: '↓输入 ↑输出 ⚡缓存 🧠推理；— 表示网关本次未返回用量',
       historyEffort: '推理强度',
       historyAuto: '(自动)',
-      noChannels: '未探测渠道',
+      historyUnknown: '(未上报)',
+      noChannels: '未探测到渠道，可手动输入',
       pinned: '已钉住',
       auto: '自动路由',
+      modeAuto: '智能路由',
+      modeStrict: '钉住',
+      modePreferred: '优先',
+      channelsCount: '{n} 个渠道',
       probe: '探测',
       validate: '校验',
       testPin: '测试',
       reset: '恢复自动',
       refresh: '刷新',
       channels: '渠道（点选＝钉住顺序，⊘＝排除）',
+      channelPlaceholder: '输入渠道名，回车添加',
+      channelAdd: '添加',
+      channelUnverified: '未验证',
+      channelsKnown: '已探测：{list}',
+      capabilities: '上游能力',
+      capabilitiesExtraPlaceholder: '如 quantization:fp8 或 !quantization:bf16',
+      capabilitiesDirect: '最近一次探测走 OpenRouter，该路由会忽略此筛选',
+      capFree: '免费',
+      capImplicitCaching: '隐式缓存',
+      capReasoning: '推理',
+      capStructuredOutput: '结构化输出',
+      capToolUse: '工具调用',
+      capVision: '视觉',
       history: '最近请求',
       noHistory: '暂无记录。',
       busy: '处理中…',
@@ -377,8 +404,6 @@ window.__ModuleLoader__.load({
       title: 'Cline Pass',
       description: 'Channel pins and the account pool for the subscription models',
       panelUnavailable: 'The browser channel is unavailable.',
-      expand: 'Show settings',
-      collapse: 'Hide settings',
       keyOk: 'API key configured',
       keyMissing: 'No API key',
       keyValue: 'API key',
@@ -406,9 +431,10 @@ window.__ModuleLoader__.load({
       active: 'Active',
       addAccount: 'Add',
       accountName: 'Name',
-      models: 'Models',
+      models: 'cline-pass',
       modelsCount: '{n} model(s)',
-      hiddenModels: '{n} hidden from the pickers',
+      hiddenModels: '{n} hidden',
+      hiddenModelsHint: '{n} hidden from the model pickers',
       visible: 'Show in the model pickers',
       hiddenTag: 'Hidden',
       selectAll: 'Check all',
@@ -446,15 +472,33 @@ window.__ModuleLoader__.load({
       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',
+      modeStrict: 'Pinned',
+      modePreferred: 'Preferred',
+      channelsCount: '{n} channels',
       probe: 'Probe',
       validate: 'Validate',
       testPin: 'Test',
       reset: 'Back to auto',
       refresh: 'Refresh',
       channels: 'Channels (click = pin order, ⊘ = exclude)',
+      channelPlaceholder: 'Channel name, Enter to add',
+      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…',
@@ -1112,47 +1156,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) }, '×'),
+          ]))),
       ])
     }
 
@@ -1170,12 +1355,29 @@ window.__ModuleLoader__.load({
       const { t, model, disabled, actions } = props
       const [open, setOpen] = React.useState(false)
       const hidden = model.hidden === true
-      const pinnedLabel = model.pinned.length === 0 ? t('auto') : model.pinned.join(' › ')
+      // What a request will actually do, readable without expanding the row. The
+      // old line read `已钉住: 自动路由` — claiming a pin while saying nothing is
+      // pinned, which is exactly how it was misread.
+      // Every row is this route, and the card header already names it, so the prefix
+      // is 11 characters of noise on each of nineteen rows. The full id stays in
+      // `title` for anything that needs to copy it.
+      const label = typeof model.displayName === 'string' && model.displayName !== ''
+        ? model.displayName
+        : String(model.id).replace(/^cline-pass\//, '')
+      const mode = model.pinned.length === 0
+        ? t('modeAuto')
+        : `${t(model.pinMode === 'preferred' ? 'modePreferred' : 'modeStrict')} · ${model.pinned.join(' › ')}`
+      // How many channels sit behind it and how many of those the order pins. After a
+      // probe only: before that the list is empty and a count would be a guess.
+      const channelCount = model.upstreams.length === 0 ? '' : fill(t('channelsCount'), { n: model.upstreams.length })
       const action = (key, label, run) => h('button', {
         key, type: 'button', className: 'cp-btn', disabled, onClick: () => run(model.id),
       }, label)
       return h('div', { className: `cp-model${hidden ? ' cp-model-hidden' : ''}` }, [
-        h('div', { key: 'head', className: 'cp-row' }, [
+        // One line, always. The id and the mode are long enough to collide on a
+        // narrow panel, so both ellipsis and keep their full text in `title`: a
+        // second line here reads as a broken row, not as more information.
+        h('div', { key: 'head', className: 'cp-row cp-model-head' }, [
           h('input', {
             key: 'vis',
             type: 'checkbox',
@@ -1186,11 +1388,12 @@ window.__ModuleLoader__.load({
             'aria-label': `${t('visible')}: ${model.id}`,
             onChange: (event) => actions.setModelVisible(model.id, event.target.checked),
           }),
-          h('span', { key: 'name', className: 'cp-mono cp-grow' }, model.id),
+          h('span', { key: 'name', className: 'cp-mono cp-grow cp-ellipsis', title: model.id }, label),
           hidden ? h('span', { key: 'off', className: 'cp-muted' }, t('hiddenTag')) : null,
-          h('span', { key: 'pin', className: 'cp-muted cp-mono' }, `${t('pinned')}: ${pinnedLabel}`),
+          h('span', { key: 'mode', className: 'cp-muted cp-mono cp-model-mode cp-ellipsis', title: mode }, mode),
           h('button', {
-            key: 'more', type: 'button', className: 'cp-btn', title: t('channels'),
+            key: 'more', type: 'button', className: 'cp-btn',
+            title: channelCount === '' ? t('channels') : `${t('channels')} · ${channelCount}`,
             onClick: () => setOpen(!open),
           }, open ? '▾' : '▸'),
         ]),
@@ -1201,9 +1404,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,
       ])
     }
@@ -1392,8 +1594,8 @@ window.__ModuleLoader__.load({
      * which drops the browser's own disclosure marker — without it a folded
      * section looks like a plain card title, not something to open.
      */
-    function foldHeader(title) {
-      return h('summary', { key: 'sum', className: 'cp-card-title cp-fold' }, [
+    function foldHeader(title, hint) {
+      return h('summary', { key: 'sum', className: 'cp-card-title cp-fold', ...(hint === undefined || hint === '' ? {} : { title: hint }) }, [
         h('span', { key: 'l' }, title),
         h(Chevron, { key: 'chevron', className: 'cp-chevron' }),
       ])
@@ -1409,27 +1611,40 @@ window.__ModuleLoader__.load({
     function ModelsCard(props) {
       const { t, data, disabled, busy, actions } = props
       const hidden = Number(data.hiddenModels ?? 0)
-      return h('details', { className: 'cp-card' }, [
-        foldHeader(`${t('models')} · ${fill(t('modelsCount'), { n: data.models.length })}${hidden === 0 ? '' : ` · ${fill(t('hiddenModels'), { n: hidden })}`}`),
+      // Open by default: the pins are what this page is for, and a collapsed card
+      // makes a user click before they can see whether anything is pinned at all.
+      // The fold stays available for the days a pool has nineteen models in it.
+      return h('details', { className: 'cp-card cp-models', open: true }, [
+        // Short enough for a fold header; the long spelling is the tooltip.
+        foldHeader(
+          `${t('models')} · ${fill(t('modelsCount'), { n: data.models.length })}${hidden === 0 ? '' : ` · ${fill(t('hiddenModels'), { n: hidden })}`}`,
+          hidden === 0 ? '' : fill(t('hiddenModelsHint'), { n: hidden }),
+        ),
         // The refresh and the bulk checkbox actions sit in the body, not the
         // header: a button inside a summary would also toggle the fold.
-        h('div', { key: 'bar', className: 'cp-row' }, [
-          h('button', {
-            key: 'all', type: 'button', className: 'cp-btn', disabled,
-            onClick: () => actions.setModelsVisibility('all'),
-          }, t('selectAll')),
-          h('button', {
-            key: 'invert', type: 'button', className: 'cp-btn', disabled,
-            onClick: () => actions.setModelsVisibility('invert'),
-          }, t('invertSelection')),
-          h('button', {
-            key: 'r', type: 'button', className: 'cp-btn cp-grow-end', disabled,
-            onClick: () => actions.refreshModels(),
-          }, t('refresh')),
+        //
+        // `details` wraps everything after its summary, so the card's own flex gap
+        // stops at that wrapper and the toolbar sat flush against the first row. This
+        // grouping carries the spacing itself, whatever the engine's `details` layout.
+        h('div', { key: 'models', className: 'cp-models-body' }, [
+          h('div', { key: 'bar', className: 'cp-row' }, [
+            h('button', {
+              key: 'all', type: 'button', className: 'cp-btn', disabled,
+              onClick: () => actions.setModelsVisibility('all'),
+            }, t('selectAll')),
+            h('button', {
+              key: 'invert', type: 'button', className: 'cp-btn', disabled,
+              onClick: () => actions.setModelsVisibility('invert'),
+            }, t('invertSelection')),
+            h('button', {
+              key: 'r', type: 'button', className: 'cp-btn cp-grow-end', disabled,
+              onClick: () => actions.refreshModels(),
+            }, t('refresh')),
+          ]),
+          h('div', { key: 'rows', className: 'cp-table' }, data.models.map((model) => h(ModelRow, {
+            key: model.id, t, model, disabled, busy, actions,
+          }))),
         ]),
-        h('div', { key: 'rows', className: 'cp-table' }, data.models.map((model) => h(ModelRow, {
-          key: model.id, t, model, disabled, busy, actions,
-        }))),
       ])
     }
 
@@ -1445,7 +1660,7 @@ 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.
@@ -1474,7 +1689,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,
           ]),
         ])),
@@ -1837,31 +2052,21 @@ window.__ModuleLoader__.load({
      * host's own cards — and because the panel only mounts once opened, a folded
      * card costs no round trip.
      */
+    /**
+     * The section's page: the panel itself, under a static heading.
+     *
+     * It used to fold, because it lived inside the Plugins tab where a long panel
+     * had to stay out of the way. As a first-level page the fold only asks for a
+     * click on the thing the user just navigated to.
+     */
     function PluginSettingsCard(props) {
       const t = props.t
-      const [open, setOpen] = React.useState(false)
-      const title = t('title')
-      return h('div', { className: `cp-set-card${open ? ' cp-set-card-open' : ''}` }, [
-        h('button', {
-          key: 'head',
-          type: 'button',
-          className: 'cp-set-header',
-          'aria-expanded': open,
-          'aria-label': `${t(open ? 'collapse' : 'expand')}: ${title}`,
-          onClick: () => setOpen(!open),
-        }, [
-          h('span', { key: 'text', className: 'cp-set-head-text' }, [
-            h('span', { key: 'name', className: 'cp-set-name' }, title),
-            h('span', { key: 'desc', className: 'cp-set-desc' }, t('description')),
-          ]),
-          h(Chevron, {
-            key: 'chevron',
-            className: `cp-set-chevron${open ? ' cp-set-chevron-open' : ''}`,
-          }),
+      return h('div', { className: 'cp-set-card' }, [
+        h('div', { key: 'head', className: 'cp-set-head' }, [
+          h('span', { key: 'name', className: 'cp-set-name' }, t('title')),
+          h('span', { key: 'desc', className: 'cp-set-desc' }, t('description')),
         ]),
-        open
-          ? h('div', { key: 'body', className: 'cp-set-body' }, h(Panel, { ...props, hideTitle: true }))
-          : null,
+        h('div', { key: 'body', className: 'cp-set-body' }, h(Panel, { ...props, hideTitle: true })),
       ])
     }
 
@@ -2147,19 +2352,20 @@ window.__ModuleLoader__.load({
       const renderPluginCard = (props) => h(PluginSettingsCard, { ...props, ...face, t: translate })
       const renderQuick = (props) => h(QuickCard, { ...props, ...face, t: translate })
 
-      // 1. The one configuration surface: a tab inside the Plugins settings
-      //    section, which already enumerates this namespace. No
-      //    `settings.section` alongside it — a second page in the Settings nav
-      //    would only duplicate this panel, and the nav is for surfaces that are
-      //    not already listed there.
+      // 1. The one configuration surface: a first-level page in the Settings nav.
+      //
+      //    It used to be a tab under Plugins, which put the channel pins five or six
+      //    clicks deep — Settings, Plugins, the tab, the collapsed card, the model
+      //    list, the row. The pins are what this plugin is for, so they get the same
+      //    standing as the shell's own pages: `order: 12` sits between Models (10) and
+      //    Plugins (15), which is also where a reader looks for a provider's routing.
       //
-      //    `settings.plugins.tab` is a list slot: its key is `id`, its position
-      //    is `order` (the host's own inventory tab sits at 10), and its tab
-      //    label is a thunk so it follows the active locale.
-      ctx.slots.inject('settings.plugins.tab', () => ctx.slots.register({
-        name: 'settings.plugins.tab',
+      //    `settings.section` is a list slot: its key is `id`, its position is
+      //    `order`, and its nav label is a thunk so it follows the active locale.
+      ctx.slots.inject('settings.section', () => ctx.slots.register({
+        name: 'settings.section',
         id: NS,
-        order: 20,
+        order: 12,
         label: () => translate('title'),
         locale: NS,
         inject: face,

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([]),
 })
 
 /**

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 ?? ''),
@@ -377,6 +378,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()) }

package/lib/protocol.js

@@ -184,6 +184,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 +200,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 +218,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 +320,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.9",
+  "version": "0.2.11",
   "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",