@luchenglong/cli-bridge 0.2.8 → 0.2.10

package/providers/claude-models.mjs

@@ -0,0 +1,338 @@
+// providers/claude-models.mjs — claude 模型清单探测（账号实时权威源，纯逻辑 + 最小 spawn）。
+//
+// 从 providers/claude.mjs 拆出（规则 §26：单文件 600 行红线）。build 会把
+// providers/claude-*.mjs 按字典序内联进 dynamic 沙箱同一作用域；ESM 形态走 import。
+// ⚠️ 注释里绝不写出口令标记字面量。
+//
+// 为什么必须「探测」而不是读配置（本机 Claude Code 2.0.76 + 第三方 Anthropic 兼容端点实测）：
+//   传一个故意无效的模型名 → 服务端返回 400，CLI 把报文塞进 result 事件：
+//     {"type":"result","subtype":"success","is_error":true,
+//      "result":"API Error: 400 {\"error\":{\"message\":\"The supported API model names are
+//                deepseek-flash, deepseek-v4-pro, but you passed __clb_probe_invalid__.\"}}"}
+//   → 这条 "The supported API model names are X, Y" 就是该端点/该 key 的权威可用清单。
+//   ~/.claude/settings.json 的 env.ANTHROPIC_DEFAULT_*_MODEL 只是「别名映射」，
+//   不是服务端可用全集 —— 红线：绝不把它冒充成可用清单，也绝不静默返回空数组。
+//
+// 缓存与「谁探测」（契约 §3.2 手动拉取）：
+//   • settings.meta() 是同步回调，且**不再自动探测** —— 它只调 readCachedModels() 读这里的
+//     缓存（纯读、不 spawn、不联网）；没命中就留空，由 note 提示用户点「拉取可用模型」。
+//   • 探测只有一条路：settings.refreshModels() → 异步 probeSupportedModels()（用户显式触发）。
+//     成功后经 cachedModels() 写回同一个缓存，下次 meta() 直接命中 —— 面板首屏不再被拖慢。
+//   • 5 分钟 TTL 只约束**工具调用**（claude_models 的重复调用）；面板展示的是「上次拉取到的
+//     权威清单」，过期也照旧展示，但 note 会标注拉取时间（宁可显式标旧，也不让下拉莫名清空）。
+
+import { claudeExeCandidates, claudeProbeCandidates, splitExeSpec, quoteShellArg } from './claude-exe.mjs'
+
+// 故意无效的探测模型名（服务端必然拒绝；保持带前缀，便于日志辨认来源）。
+export const PROBE_MODEL = '__clb_probe_invalid__'
+export const MODELS_TTL_MS = 5 * 60 * 1000
+
+// 探测结果缓存：key（后端/端点标识） → { at, value }
+const modelsCache = new Map()
+
+/** 清空探测缓存（测试与「模型变更后刷新」用）。 */
+export function resetModelsCache() { modelsCache.clear() }
+
+// 缓存键 = 候选可执行文件集合（同一台机器可能切换 CLAUDE_BIN / 面板路径，键必须跟着变，
+// 否则会把「上一个 exe 的探测结果」错配给新 exe）。
+function candidateKey(env, binPath) {
+  const list = claudeProbeCandidates(env, binPath)
+  return list.length ? list.join('|') : 'claude'
+}
+
+/** 缓存的键（面板读缓存与工具探测必须用同一把键，否则写进去读不出来）。 */
+export function modelsCacheKey(env, binPath) {
+  return 'claude:' + candidateKey(env, binPath)
+}
+
+/** 缓存里只可能存「成功的权威清单」；失败绝不入缓存（否则会把坏状态固化）。 */
+function isUsableProbe(v) {
+  return !!(v && v.ok === true && Array.isArray(v.ids) && v.ids.length)
+}
+
+/**
+ * 缓存包装（异步工具路径）：TTL 内直接返回上次成功结果；失败不写缓存。
+ * @param {string} key
+ * @param {() => Promise<object>|object} load
+ * @param {number} [nowMs]
+ */
+export function cachedModels(key, load, nowMs) {
+  const at = Number(nowMs) || Date.now()
+  const hit = modelsCache.get(key)
+  if (hit && at - hit.at < MODELS_TTL_MS) return hit.value
+  return Promise.resolve().then(load).then((v) => {
+    if (isUsableProbe(v)) modelsCache.set(key, { at, value: v })
+    return v
+  })
+}
+
+/**
+ * 只读缓存（settings.meta 专用）：纯读、不 spawn、不联网。
+ * 与 cachedModels 的区别：这里**不受 TTL 限制** —— 面板展示的是「上次真正拉取到的那份
+ * 服务端清单」，附 ageMs 让 note 如实标注新旧；空/过期与否都不该凭空清空用户看到的下拉。
+ *
+ * 为什么要「精确键未命中 → 取最近一次成功结果」：keystone 渲染面板时只把 env 传给
+ * meta()，**拿不到面板里保存的 binPath**（settingsView 里 createProvider 只带 env），
+ * 而缓存键含候选 exe 集合 → 用户一旦填过 binPath，精确键必然错开，下拉会在拉取成功后
+ * 仍然空着（看起来像按钮没起作用）。这不算降级：清单是 claude 自己 settings.json 里
+ * 端点+凭据裁决的，与走哪个候选 exe 无关（exe 只决定探测能否跑起来），且 note 会带上
+ * 「N 分钟前拉取 / 源 account-live」，用户看到的是真实的探测结果与真实的年龄。
+ * @param {object} env
+ * @param {{binPath?: string, nowMs?: number}} [opts]
+ * @returns {{ids: string[], mode: string, exe: (string|null), at: number, ageMs: number}|null}
+ */
+export function readCachedModels(env, opts) {
+  const o = opts || {}
+  const at = Number(o.nowMs) || Date.now()
+  const exact = modelsCache.get(modelsCacheKey(env, o.binPath))
+  let hit = isUsableProbe(exact && exact.value) ? exact : null
+  if (!hit) {
+    for (const entry of modelsCache.values()) {
+      if (!isUsableProbe(entry.value)) continue
+      if (!hit || entry.at > hit.at) hit = entry
+    }
+  }
+  if (!hit) return null
+  return {
+    ids: hit.value.ids.slice(),
+    mode: hit.value.mode || 'account-live',
+    exe: hit.value.exe || null,
+    at: hit.at,
+    ageMs: Math.max(0, at - hit.at)
+  }
+}
+
+/**
+ * 从 400 报文里解析「服务端支持的模型名」。
+ * 主格式（实测）：`The supported API model names are A, B, but you passed Z.`
+ * 兼容：句尾直接是句号（无 "but you passed"）、JSON 转义形态、大小写差异。
+ * @param {string} text
+ * @returns {string[]|null} 无该锚点返回 null（调用方必须据此报错，不得伪造清单）
+ */
+export function parseSupportedModels(text) {
+  const s = String(text || '')
+  if (!s) return null
+  const anchorRe = /the supported API model names are\s+/i
+  const m = anchorRe.exec(s)
+  if (!m) return null
+  const tail = s.slice(m.index + m[0].length)
+  // ① 有 "but you passed" → 这是清单的确定右边界（模型名里可以有 '.'，不能按句点切）。
+  let body = ''
+  const end = /,?\s*but you passed/i.exec(tail)
+  if (end) body = tail.slice(0, end.index)
+  else {
+    // ② 无右边界锚点：截到引号/换行/行尾，再 chomp 单个句点。
+    const stop = tail.search(/["\r\n]/)
+    body = (stop >= 0 ? tail.slice(0, stop) : tail).replace(/[.\s]+$/, '')
+  }
+  const ids = []
+  for (const raw of body.split(/\s*,\s*|\s+and\s+/i)) {
+    const id = String(raw || '').trim().replace(/^["'`[]+|["'`\]]+$/g, '')
+    if (!id) continue
+    if (!/^[A-Za-z0-9][A-Za-z0-9._:@/+-]*$/.test(id)) continue
+    if (id === PROBE_MODEL) continue
+    if (ids.indexOf(id) < 0) ids.push(id)
+  }
+  return ids.length ? ids : null
+}
+
+/**
+ * 从探测进程的完整输出里挖出模型清单。
+ * CLI 的 stdout 是 result 事件 JSON（is_error:true）；它的 result 字段里才是 400 报文，
+ * 且报文自身是 JSON 字符串（转义）。顺序：raw 文本 → 每行 JSON 的 result 字段。
+ * @param {string} stdoutText
+ * @param {string} [stderrText]
+ * @returns {{ids: string[]|null, errorText: string, sawResult: boolean}}
+ */
+export function extractProbeIds(stdoutText, stderrText) {
+  const out = String(stdoutText || '')
+  const err = String(stderrText || '')
+  const lines = out.split(/\r?\n/).filter(Boolean)
+  let errorText = ''
+  let sawResult = false
+  for (const ln of lines) {
+    const t = ln.trim()
+    if (!t.startsWith('{')) continue
+    let obj
+    try { obj = JSON.parse(t) } catch (e) { continue }
+    if (!obj || obj.type !== 'result') continue
+    sawResult = true
+    if (typeof obj.result === 'string' && obj.result) errorText = obj.result
+    else if (obj.is_error && typeof obj.error === 'string') errorText = obj.error
+  }
+  if (!errorText) errorText = err || out
+  const ids = parseSupportedModels(errorText) || parseSupportedModels(out) || parseSupportedModels(err)
+  return { ids: ids || null, errorText: errorText.slice(0, 800), sawResult }
+}
+
+/** ~/.claude/settings.json 路径（CLAUDE_CONFIG_DIR 可覆盖配置根，本机实测存在）。 */
+export function claudeConfigDir(env) {
+  const e = env || {}
+  if (e.CLAUDE_CONFIG_DIR) return String(e.CLAUDE_CONFIG_DIR)
+  const home = e.USERPROFILE || e.HOME || ''
+  if (!home) return ''
+  const path = (function () { try { const p = globalThis.process; return (p && typeof p.getBuiltinModule === 'function') ? p.getBuiltinModule('node:path') : null } catch (x) { return null } })()
+  if (!path || typeof path.join !== 'function') return ''
+  return path.join(home, '.claude')
+}
+
+/**
+ * 读 ~/.claude/settings.json 的 env 块里「用户配置的模型名」。
+ * ⚠️ 这是别名映射（ANTHROPIC_DEFAULT_OPUS_MODEL 之类），**不是**服务端可用全集：
+ * 只作为诊断/解释线索返回，绝不塞进 ok:true 的模型清单。
+ * @returns {{ok: boolean, path: string, models: Array<{id: string, key: string}>, error: string}}
+ */
+export function readConfiguredModels(env) {
+  const dir = claudeConfigDir(env)
+  if (!dir) return { ok: false, path: '', models: [], error: 'cannot resolve home directory (no USERPROFILE/HOME/CLAUDE_CONFIG_DIR)' }
+  const fs = (function () { try { const p = globalThis.process; return (p && typeof p.getBuiltinModule === 'function') ? p.getBuiltinModule('node:fs') : null } catch (x) { return null } })()
+  const path = (function () { try { const p = globalThis.process; return (p && typeof p.getBuiltinModule === 'function') ? p.getBuiltinModule('node:path') : null } catch (x) { return null } })()
+  if (!fs || !path) return { ok: false, path: '', models: [], error: 'no fs capability in this host form' }
+  const file = path.join(dir, 'settings.json')
+  let raw
+  try { raw = JSON.parse(fs.readFileSync(file, 'utf8')) } catch (e) {
+    return { ok: false, path: file, models: [], error: 'cannot read ' + file + ': ' + String(e && e.message || e) }
+  }
+  const envBlock = raw && raw.env && typeof raw.env === 'object' ? raw.env : {}
+  const models = []
+  const seen = Object.create(null)
+  for (const key of Object.keys(envBlock)) {
+    if (!/^(ANTHROPIC_(MODEL|DEFAULT_[A-Z]+_MODEL|DEFAULT_[A-Z]+_MODEL_NAME|SMALL_FAST_MODEL))$/i.test(key)) continue
+    const v = envBlock[key]
+    if (typeof v !== 'string' || !v.trim()) continue
+    const id = v.trim()
+    if (seen[id]) continue
+    seen[id] = true
+    models.push({ id, key })
+  }
+  return { ok: true, path: file, models, error: '' }
+}
+
+/** 探测 argv（不含 exe 前缀）：固定参数集，绝不拼装用户 prompt。 */
+export function probeArgv() {
+  return ['-p', 'hi', '--model', PROBE_MODEL, '--output-format', 'json', '--no-session-persistence']
+}
+
+/** 探测失败时的可操作文案（区分「没找到 CLI」与「CLI 跑了但服务端没报清单」）。 */
+function probeFailureText(reasons, tried) {
+  const head = '无法获取服务端权威模型清单（已尝试探测 ' + tried + ' 个候选可执行文件）'
+  const body = reasons.join('; ')
+  return head + (body ? ': ' + body : '') +
+    '。请确认 claude CLI 已安装且端点/凭据可用（claude 在 ~/.claude/settings.json 的 env 里读 ANTHROPIC_BASE_URL/ANTHROPIC_AUTH_TOKEN），或在设置面板填写正确的可执行文件路径后重试。'
+}
+
+/**
+ * 异步探测（唯一探测实现：MCP / preset / dynamic 三形态 + 面板「拉取可用模型」共用）：
+ * 起一次真实 CLI 调用，解析 400 报文。
+ * 铁律：只认探测结果；失败 = ok:false + 可操作错误，绝不回落到配置文件/静态表。
+ * @param {object} env
+ * @param {{binPath?: string, timeoutMs?: number}} [opts]
+ * @returns {Promise<{ok: boolean, ids: string[], mode: string, exe?: string, error?: string}>}
+ */
+export function probeSupportedModels(env, opts) {
+  const o = opts || {}
+  const child = (function () { try { const p = globalThis.process; return (p && typeof p.getBuiltinModule === 'function') ? p.getBuiltinModule('node:child_process') : null } catch (x) { return null } })()
+  if (!child || typeof child.spawn !== 'function') {
+    return Promise.resolve({ ok: false, ids: [], mode: 'account-live', error: 'no spawn capability in this host form' })
+  }
+  const cands = claudeProbeCandidates(env, o.binPath)
+  const probeList = cands.length ? cands : ['claude']
+  const proc = globalThis.process
+  const env2 = Object.assign({}, (proc && proc.env) || {})
+  return new Promise((resolve) => {
+    let idx = 0
+    const reasons = []
+    const attempt = () => {
+      if (idx >= probeList.length) {
+        resolve({ ok: false, ids: [], mode: 'account-live', error: probeFailureText(reasons, probeList.length) })
+        return
+      }
+      const exe = probeList[idx++]
+      const spec = splitExeSpec(exe)
+      const argv = spec.prefixArgs.concat(probeArgv())
+      let c
+      try {
+        const spawnCmd = spec.shell ? [spec.cmd].concat(argv).map(quoteShellArg).join(' ') : spec.cmd
+        c = child.spawn(spawnCmd, spec.shell ? [] : argv, {
+          stdio: ['ignore', 'pipe', 'pipe'], windowsHide: true, shell: !!spec.shell, env: env2
+        })
+      } catch (e) { reasons.push(exe + ': spawn threw ' + String(e && e.message || e)); attempt(); return }
+      let out = ''
+      let err = ''
+      const timer = setTimeout(() => { try { c.kill() } catch (e) { } }, Math.max(5000, Math.min(Number(o.timeoutMs) || 30000, 90000)))
+      // 一个候选只允许结算一次：spawn 失败时 'error' 与 'close' 会先后都触发，
+      // 两个回调各调一次 attempt() 会把后面的候选整个跳过（idx 多走一格）——
+      // 实测后果是「binPath 填错 → 明明 CLAUDE_BIN 里那个能跑，探测却直接失败」。
+      let settled = false
+      const nextCandidate = (reason) => {
+        if (settled) return
+        settled = true
+        clearTimeout(timer)
+        if (reason) reasons.push(reason)
+        attempt()
+      }
+      c.stdout.on('data', (d) => { out += d; if (out.length > 400000) out = out.slice(-200000) })
+      c.stderr.on('data', (d) => { err += d; if (err.length > 200000) err = err.slice(-100000) })
+      c.on('error', (e) => {
+        nextCandidate(exe + ': ' + String((e && e.code) || (e && e.message) || 'spawn error'))
+      })
+      c.on('close', (code) => {
+        if (settled) return
+        const got = extractProbeIds(out, err)
+        if (got.ids && got.ids.length) {
+          settled = true
+          clearTimeout(timer)
+          resolve({ ok: true, ids: got.ids, mode: 'account-live', exe })
+          return
+        }
+        const head = String(got.errorText || '').replace(/\s+/g, ' ').trim().slice(0, 160)
+        nextCandidate(exe + ': exit ' + code + '，未解析出可用模型清单' + (head ? ' — ' + head : ''))
+      })
+    }
+    attempt()
+  })
+}
+
+/**
+ * 组装 claude_models 的返回值（三形态共用；工具逻辑与 MCP 面共用这一份，杜绝两处漂移）。
+ * 成功 = 服务端清单（source: account-live）；失败 = ok:false + configured 诊断线索
+ * （配置里那串名字只作「你可能想用哪个」的提示，明确标注非权威）。
+ * @param {object} env
+ * @param {{binPath?: string, timeoutMs?: number, refresh?: boolean}} [opts]
+ */
+export async function listAccountModels(env, opts) {
+  const o = opts || {}
+  const key = modelsCacheKey(env, o.binPath)
+  if (o.refresh) modelsCache.delete(key)
+  const probe = await cachedModels(key, () => probeSupportedModels(env, o))
+  const cfg = readConfiguredModels(env)
+  const configured = cfg.models || []
+  if (!probe.ok) {
+    return {
+      ok: false,
+      source: 'account-live',
+      models: [],
+      count: 0,
+      error: String(probe.error || 'probe failed'),
+      diagnostic: {
+        configured: configured,
+        settingsPath: cfg.path,
+        note: 'ANTHROPIC_*_MODEL 只是用户配置的别名映射，不是服务端可用全集；因此不作为 models 返回。'
+      }
+    }
+  }
+  const ids = probe.ids.slice()
+  const byId = new Map(configured.map((m) => [m.id, m]))
+  const byIdLoose = new Map(configured.map((m) => [String(m.id).toLowerCase().replace(/\[.*\]$/, ''), m]))
+  return {
+    ok: true,
+    source: 'account-live',
+    models: ids.map((id) => {
+      const hit = byId.get(id) || byIdLoose.get(String(id).toLowerCase())
+      return { id, source: 'account-live', configuredAs: hit ? hit.key : null }
+    }),
+    count: ids.length,
+    ext: { exe: probe.exe || null, mode: probe.mode },
+    diagnostic: { settingsPath: cfg.path, configured: configured }
+  }
+}

package/providers/claude-policy.mjs

@@ -0,0 +1,37 @@
+// providers/claude-policy.mjs — claude 提示词策略段（preset 与 dynamic 两种宿主唯一来源）。
+//
+// 为什么单独成片：同一段策略文本要在 preset/claude-first/cli-bridge.mjs（ESM 导入）与
+// dynamic/claude.host.template.mjs（沙箱内联，禁 import）两处出现；各写一份必然漂移
+// （历史上 agy/opencode 两处文案已经出现过不一致）。本文件被 scripts/build.mjs 作为
+// providers/claude-*.mjs 之一内联进沙箱同一作用域，故两形态共用同一个常量。
+// ⚠️ 注释里绝不写出口令标记字面量（build 全局替换会把注释劈开）。
+
+export const POLICY_TEXT = [
+  'claude-first execution policy (local Claude Code CLI bridge).',
+  '',
+  'Local agent CLI "claude" handles coding tasks under full DSH control (non-interactive -p mode, permissions auto-approved so claude never blocks on a prompt). By default, claude runs in the background and returns a jobId immediately; collect results via job_output and watch live progress via claude_status anytime.',
+  '',
+  'Decision table for tool selection:',
+  '- Single read/glob/grep or short (<30s) command -> Native tools.',
+  '- Implementing, editing, refactoring, debugging, builds, multi-file investigation -> claude_run.',
+  '- Follow-ups on the same topic -> claude_continue (with latest=true or sessionId; claude preserves session context via --resume).',
+  '- Final build/test verification of claude output -> Native tools.',
+  '',
+  'Context protocol (one topic = one claude session):',
+  '- First dispatch on a topic: provide the task with a compact CONTEXT preamble (point to paths, do not paste file contents):',
+  '  CONTEXT: 2-6 lines — goal; repo root; key paths; decisions/constraints; current state.',
+  '  TASK: the complete instruction.',
+  '- Follow-ups: call claude_continue and state only what is new.',
+  '',
+  'Execution & Fallback protocol:',
+  '- Dispatch defaults to background=true (set background=false only to block). Collect via job_output.',
+  '- mode=auto follows the DSH plan state: in plan mode claude runs with --permission-mode plan (read-only), otherwise permissions are bypassed so long edits/builds never stall on an approval prompt.',
+  '- On rate-limit or network failure, a confirmation dialog opens in BOTH foreground and background while in flight.',
+  '- If result has fallback=true (status FALLBACK_TO_DSH), the user chose DSH-local: finish with native tools and NEVER call claude again for this task.',
+  '- Never loop claude calls; never ask claude to call back into DSH.',
+  '',
+  'Model & credentials:',
+  '- Which model ids actually work is decided by the ENDPOINT, not by this bridge: call claude_models to read the authoritative server-side roster (it probes the endpoint), then pass model. Never trust ANTHROPIC_*_MODEL entries in ~/.claude/settings.json as the usable set — they are alias mappings only.',
+  '- Omit the model unless you have a reason: claude then uses its own configuration (or the model chosen in CLI Bridge settings). A rejected model surfaces as a run failure with the supported list in the diagnostic hint — fix the model, do not retry blindly.',
+  '- Credentials are owned by claude, not by this bridge: base URL and auth token live in ~/.claude/settings.json (env block). On auth/401 failures tell the user to check that file or re-login; do not retry in a loop.'
+].join('\n')