dsh-cline-pass 0.2.10 → 0.2.11

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

@@ -118,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)}',
@@ -361,7 +366,8 @@ window.__ModuleLoader__.load({
       historyTokensHint: '↓输入 ↑输出 ⚡缓存 🧠推理；— 表示网关本次未返回用量',
       historyEffort: '推理强度',
       historyAuto: '(自动)',
-      noChannels: '未探测渠道',
+      historyUnknown: '(未上报)',
+      noChannels: '未探测到渠道，可手动输入',
       pinned: '已钉住',
       auto: '自动路由',
       modeAuto: '智能路由',
@@ -374,6 +380,19 @@ window.__ModuleLoader__.load({
       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: '处理中…',
@@ -453,7 +472,8 @@ 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',
@@ -466,6 +486,19 @@ window.__ModuleLoader__.load({
       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…',
@@ -1123,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) }, '×'),
+          ]))),
       ])
     }
 
@@ -1230,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,
       ])
     }
@@ -1487,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.
@@ -1516,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,
           ]),
         ])),

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.10",
+  "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",