dsh-superinput 0.0.0-stage → 0.12.1

package/scripts/build-suite.mjs

@@ -0,0 +1,325 @@
+#!/usr/bin/env node
+/**
+ * dsh-superinput 套件生成器：从 upstream/ 内的六个模块源机械搬迁模块代码。
+ *
+ * 服务端：**单文件内联**——宿主 interception loader 对 link 包内部的相对
+ * 导入没有先例（六个旧插件都是自包含单文件；套件首版因相对导入静默不被
+ * import）。六个模块各包进 IIFE（作用域隔离顶层 const），import 提升到
+ * 顶部去重，modules/*.js 仅作生成中间产物保留可读源。
+ * 客户端：client.js 单文件闭包（宿主不拆模块），各包 __ModuleLoader__
+ * 头尾改写为 `function createX(require)` 工厂按序拼入，套件 factory 里
+ * 逐模块 try/catch（一个模块失败不拖垮其他）。
+ *
+ * 六个模块源原本是独立 git 仓（2026-11-07 收编进本仓 upstream/，GitHub
+ * 上游仓已归档）；改上游源码直接改 upstream/<包名>/，重跑本脚本再生成。
+ * 重复执行幂等。
+ */
+import { readFileSync, writeFileSync, mkdirSync } from 'node:fs'
+import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const root = dirname(dirname(fileURLToPath(import.meta.url))) // packages/dsh-superinput
+const pkgRoot = join(root, 'upstream')
+
+/** key → [包目录, 客户端工厂名] */
+const MODULES = [
+  ['cost', 'dsh-cost', 'createCostClient'],
+  ['picker', 'dsh-power-picker', 'createPickerClient'],
+  ['enhancer', 'dsh-prompt-enhancer', 'createEnhancerClient'],
+  ['followup', 'dsh-followup', 'createFollowupClient'],
+  ['voice', 'dsh-siri-voice', 'createVoiceClient'],
+  // 0.10.0 起并入套件（此前独立插件）；apply 顺序在 enhancer 之后——
+  // pre-step 瀑布里压缩落档消息在增强之后追加，不会被二次改写。
+  ['compaction', 'dsh-compaction-control', 'createCompactionClient'],
+]
+
+function transformServer(pkg, key) {
+  let src = readFileSync(join(pkgRoot, pkg, 'index.js'), 'utf8')
+  const head = `/* 由 scripts/build-suite.mjs 从 ${pkg}/index.js 机械生成；勿手改，重跑脚本再生成。 */\n`
+  src = src.replace(/^export const name = /m, 'const name = ')
+  src = src.replace(/^export default \{[^\n]*\}\s*$/m, '')
+  if (/^const inject = /m.test(src)) src += '\nexport { inject }\n'
+  if (!/export const Config/.test(src)) {
+    src += "import Schema from '@deepseek-ai/schemastery'\nexport const Config = Schema.object({ enabled: Schema.boolean().default(true).description('启用') })\n"
+  }
+  return head + src
+}
+
+function transformClient(pkg, factoryName) {
+  let src = readFileSync(join(pkgRoot, pkg, 'client.js'), 'utf8').trimEnd()
+  // 不锚定行首：各包文件头都有注释块。
+  const headRe = /window\.__ModuleLoader__\.load\(\{\s*\n\s*id:\s*'[^']+',\s*\n\s*factory\(require\) \{/
+  if (!headRe.test(src)) throw new Error(`${pkg}/client.js head pattern mismatch`)
+  src = src.replace(headRe, `function ${factoryName}(require) {`)
+  const tailRe = /\n  \},\n\}\)\s*$/
+  if (!tailRe.test(src)) throw new Error(`${pkg}/client.js tail pattern mismatch`)
+  src = src.replace(tailRe, '\n}')
+  return `/* 由 scripts/build-suite.mjs 从 ${pkg}/client.js 机械生成；勿手改。 */\n${src}\n`
+}
+
+/* ---- 服务端：单文件内联 ---- */
+
+/** 抽顶层 import（单行）、去 export 关键字，返回 { imports, body }。 */
+function inlineSource(src) {
+  const imports = []
+  let body = src.replace(/^import [^\n]+$/gm, (line) => { imports.push(line.trim()); return '' })
+  body = body
+    .replace(/^export const name = /m, 'const name = ')
+    .replace(/^export const inject = /m, 'const moduleInject = ')
+    .replace(/^export const Config/m, 'const Config')
+    .replace(/^export function apply\(/m, 'function apply(')
+    .replace(/^export \{ inject \}\s*$/m, '')
+    .replace(/^export default \{[^\n]*\}\s*$/m, '')
+    // compaction-control 尾部的离线自测导出（CI import 用，运行时无用）
+    .replace(/^export const __internals/m, 'const __internals')
+  return { imports, body: body.trim() }
+}
+
+/** 按 source 分组合并 import 绑定符（整行去重不够：不同行的子集会重复声明）。 */
+function mergeImports(importLines) {
+  const bySource = new Map() // source → { defaults:Set, names:Set }
+  for (const line of importLines) {
+    const m = line.match(/^import\s+(?:([A-Za-z_$][\w$]*)\s*,?\s*)?(?:\{([^}]*)\})?\s*from\s*['"]([^'"]+)['"]/)
+    if (!m) throw new Error(`unparsed import: ${line}`)
+    const [, defaults, named, source] = m
+    const entry = bySource.get(source) ?? { defaults: new Set(), names: new Set() }
+    if (defaults) entry.defaults.add(defaults)
+    if (named) for (const part of named.split(',')) {
+      const name = part.trim()
+      if (name) entry.names.add(name)
+    }
+    bySource.set(source, entry)
+  }
+  const lines = []
+  for (const [source, { defaults, names }] of bySource) {
+    const parts = []
+    if (defaults.size > 0) parts.push([...defaults][0])
+    if (names.size > 0) parts.push(`{ ${[...names].join(', ')} }`)
+    lines.push(`import ${parts.join(', ')} from '${source}'`)
+  }
+  return lines.sort()
+}
+
+mkdirSync(join(root, 'modules'), { recursive: true })
+const importLines = []
+const iifes = []
+for (const [key, pkg] of MODULES) {
+  const transformed = transformServer(pkg, key)
+  writeFileSync(join(root, 'modules', `${key}.js`), transformed) // 可读中间产物
+  const { imports, body } = inlineSource(transformed)
+  importLines.push(...imports.filter((line) => !line.includes("@deepseek-ai/schemastery")))
+  iifes.push(`/* ==== module: ${key}（原 ${pkg}） ==== */\nconst ${key}Module = (() => {\n${body}\n  return { apply, Config, inject: typeof moduleInject === 'undefined' ? undefined : moduleInject }\n})()`)
+  console.log(`✓ inline ${key}`)
+}
+// prompts（手写模块源）同样内联。
+{
+  const src = readFileSync(join(root, 'modules', 'prompts.js'), 'utf8')
+  const { imports, body } = inlineSource(src)
+  importLines.push(...imports)
+  iifes.push(`/* ==== module: prompts（手写） ==== */\nconst promptsModule = (() => {\n${body}\n  return { apply, Config, inject: typeof moduleInject === 'undefined' ? undefined : moduleInject }\n})()`)
+  console.log('✓ inline prompts')
+}
+// hub（手写模块源）同样内联。
+{
+  const src = readFileSync(join(root, 'modules', 'hub.js'), 'utf8')
+  const { imports, body } = inlineSource(src)
+  importLines.push(...imports)
+  iifes.push(`/* ==== module: hub（手写） ==== */\nconst hubModule = (() => {\n${body}\n  return { apply, Config, inject: typeof moduleInject === 'undefined' ? undefined : moduleInject }\n})()`)
+  console.log('✓ inline hub')
+}
+const allImports = mergeImports(importLines)
+// schemastery 由 glue 使用，保证在列。
+if (!allImports.some((line) => line.includes('@deepseek-ai/schemastery'))) {
+  allImports.unshift("import Schema from '@deepseek-ai/schemastery'")
+}
+
+const server = `/* dsh-superinput 服务端核心（由 scripts/build-suite.mjs 生成；勿手改）。
+ * 入口拆分：index.js 是零依赖探针（先 trace 再动态 import 本文件并捕获失败）——
+ * 顶层静态 import 的失败发生在入口任何语句之前，静默且永远取不到证据。 */
+import { appendFileSync as diagAppend, mkdirSync as diagMkdir } from 'node:fs'
+import { homedir as diagHomedir } from 'node:os'
+import { dirname as diagDirname, join as pathJoin } from 'node:path'
+${allImports.join('\n')}
+
+const SUITE_DIAG = pathJoin(diagHomedir(), '.dsh', 'superinput-debug.log')
+const trace = (line) => {
+  try {
+    diagMkdir(diagDirname(SUITE_DIAG), { recursive: true })
+    diagAppend(SUITE_DIAG, \`\${new Date().toISOString()} \${line}\\n\`, 'utf8')
+  } catch { /* ignore */ }
+}
+
+${iifes.join('\n\n')}
+
+const MODULES = [
+  ['cost', costModule],
+  ['picker', pickerModule],
+  ['enhancer', enhancerModule],
+  ['followup', followupModule],
+  ['voice', voiceModule],
+  ['prompts', promptsModule],
+  ['compaction', compactionModule],
+  ['hub', hubModule],
+]
+
+export const name = 'superinput'
+
+export const inject = [...new Set(MODULES.flatMap(([, mod]) => mod.inject ?? []))]
+
+export const Config = Schema.object({
+  cost: costModule.Config,
+  picker: pickerModule.Config,
+  enhancer: enhancerModule.Config,
+  followup: followupModule.Config,
+  voice: voiceModule.Config,
+  prompts: promptsModule.Config,
+  compaction: compactionModule.Config,
+  hub: hubModule.Config,
+})
+
+/**
+ * 嵌套默认值兜底：宿主对插件 row config 的解析深度未知——套件层自己跑
+ * 一遍每个模块的 Config({}) 拿完整默认，与宿主传入的 slice 合并。
+ */
+const DEFAULTS = new Map()
+for (const [key, mod] of MODULES) {
+  try { DEFAULTS.set(key, mod.Config ? mod.Config({}) : {}) } catch { DEFAULTS.set(key, {}) }
+}
+
+export function apply(ctx, config) {
+  const keys = Object.keys(config ?? {})
+  console.info(\`[dsh-superinput] server apply: host config keys=\${keys.length ? keys.join(',') : '(none)'} — merging schema defaults\`)
+  // 先算出每个模块的最终生效配置，hub 用它做总览（自己拿不到别人的 config）。
+  const merged = {}
+  for (const [key] of MODULES) {
+    merged[key] = { ...(DEFAULTS.get(key) ?? {}), ...(config?.[key] ?? {}) }
+  }
+  for (const [key, mod] of MODULES) {
+    try {
+      const own = merged[key]
+      mod.apply(ctx, key === 'hub' ? { ...own, snapshot: merged } : own)
+      trace(\`module "\${key}" applied OK\`)
+    } catch (error) {
+      console.error(\`[dsh-superinput] server module "\${key}" failed:\`, error)
+      trace(\`module "\${key}" FAILED: \${String(error?.stack ?? error).slice(0, 600)}\`)
+    }
+  }
+}
+
+export default { name, Config, apply }
+`
+
+const entry = `/* dsh-superinput 入口：零依赖探针（由 scripts/build-suite.mjs 生成；勿手改）。
+ * 静态 import 的失败发生在本文件第一条语句之前（宿主静默），所以核心代码
+ * 全部放在 server.js 由这里动态加载——成败都会留下取证记录。 */
+import { appendFileSync, mkdirSync } from 'node:fs'
+import { homedir } from 'node:os'
+import { dirname, join } from 'node:path'
+
+const DIAG = join(homedir(), '.dsh', 'superinput-debug.log')
+const trace = (line) => {
+  try {
+    mkdirSync(dirname(DIAG), { recursive: true })
+    appendFileSync(DIAG, \`\${new Date().toISOString()} \${line}\\n\`, 'utf8')
+  } catch { /* ignore */ }
+}
+
+trace(\`suite ENTRY pid=\${process.pid}\`)
+
+let core
+try {
+  core = await import('./server.js')
+  trace(\`server.js LOADED pid=\${process.pid}\`)
+} catch (error) {
+  trace(\`server.js FAILED: \${String(error?.stack ?? error).slice(0, 600)}\`)
+  throw error
+}
+
+export const name = core.name
+export const inject = core.inject
+export const Config = core.Config
+export function apply(ctx, config) {
+  trace(\`suite APPLY pid=\${process.pid}\`)
+  return core.apply(ctx, config)
+}
+export default core.default
+`
+writeFileSync(join(root, 'server.js'), server)
+writeFileSync(join(root, 'index.js'), entry)
+console.log(`✓ index.js 零依赖探针入口（${entry.length} bytes）+ server.js 核心（${server.length} bytes）`)
+
+/* ---- 客户端：六工厂内联 + glue ---- */
+const clientFiles = []
+for (const [key, pkg, factory] of MODULES) {
+  clientFiles.push(transformClient(pkg, factory))
+  console.log(`✓ client ${factory}`)
+}
+clientFiles.push(readFileSync(join(root, 'modules', 'prompts.client.js'), 'utf8'))
+clientFiles.push(readFileSync(join(root, 'modules', 'hub.client.js'), 'utf8'))
+
+const glue = `/* dsh-superinput 客户端：单 __ModuleLoader__ 入口，内部逐模块装配。
+ * 本文件由 scripts/build-suite.mjs 生成（模块工厂内联 + 下方 glue）；勿手改模块工厂。 */
+
+${clientFiles.join('\n')}
+
+window.__ModuleLoader__.load({
+  id: 'dsh-superinput',
+  factory(require) {
+    const defs = [
+      ['cost', createCostClient],
+      ['picker', createPickerClient],
+      ['enhancer', createEnhancerClient],
+      ['followup', createFollowupClient],
+      ['voice', createVoiceClient],
+      ['prompts', createPromptsClient],
+      ['compaction', createCompactionClient],
+      ['hub', createHubClient],
+    ]
+    // 模块异常上报：console 不落盘，失败必须走 prompts /diag 留痕。
+    const reportModuleError = (key, when, error) => {
+      console.error(\`[dsh-superinput] client module "\${key}" \${when}:\`, error)
+      try {
+        void fetch('/api/dsh-superinput/prompts/diag', {
+          method: 'POST',
+          headers: { 'content-type': 'application/json' },
+          body: JSON.stringify({ message: \`client module "\${key}" \${when}: \${String(error?.stack ?? error).slice(0, 400)}\` }),
+        }).catch(() => {})
+      } catch { /* ignore */ }
+    }
+    const modules = []
+    for (const [key, create] of defs) {
+      try { modules.push([key, create(require)]) }
+      catch (error) { reportModuleError(key, 'factory failed', error) }
+    }
+    console.info('[dsh-superinput] client active:', modules.map(([key]) => key).join('+'))
+    return {
+      // 各模块 client 的 inject 并集：picker 需要 sessions/remote/modelDirectories
+      // 等，只声明 slots 会让它在 apply 时报 cannot get property without inject。
+      inject: [...new Set(modules.flatMap(([, mod]) => mod.inject ?? ['slots']))],
+      apply(ctx) {
+        for (const [key, mod] of modules) {
+          try { mod.apply(ctx) }
+          catch (error) { reportModuleError(key, 'apply failed', error) }
+        }
+      },
+    }
+  },
+})
+`
+// Electron 渲染器禁用 API 门禁：window.prompt/alert/confirm 在 Electron 直接
+// 抛错（2026-11-01 真机事故：prompts 模板一点就消失）。构建期拦截。
+const forbiddenHits = []
+for (const [re, why] of [
+  [/window\.prompt\s*\(/, 'window.prompt（Electron 不支持，改用面板内表单）'],
+  [/window\.alert\s*\(/, 'window.alert（Electron 不支持，改用面板内提示）'],
+  [/window\.confirm\s*\(/, 'window.confirm（Electron 不支持，改用面板内按钮）'],
+]) {
+  if (re.test(glue)) forbiddenHits.push(why)
+}
+if (forbiddenHits.length) {
+  console.error('✗ client.js 含 Electron 渲染器禁用 API:\n  ' + forbiddenHits.join('\n  '))
+  process.exit(1)
+}
+writeFileSync(join(root, 'client.js'), glue)
+const clientModuleCount = (glue.match(/\['\w+', create\w+\]/g) ?? []).length
+console.log(`✓ client.js (${glue.length} bytes, ${clientModuleCount} modules)`)

package/scripts/smoke.mjs

@@ -0,0 +1,172 @@
+/**
+ * dsh-superinput 冒烟测试：桩服务逐模块 apply + prompts 端到端
+ * （save/use/slash/list/export/import 合并逻辑）。
+ *
+ * 会临时写真实存储 ~/.dsh/storages/dsh-superinput/prompts.json——
+ * 启动时自动备份，结束时（无论成败）恢复原文件；存储不存在则清理测试残留。
+ * 用法：node scripts/smoke.mjs（退出码 0 = 全过）
+ */
+import { readFileSync, writeFileSync, unlinkSync, existsSync } from 'node:fs'
+import { homedir } from 'node:os'
+import { join } from 'node:path'
+import mod from '../server.js'
+
+const STORE = join(homedir(), '.dsh', 'storages', 'dsh-superinput', 'prompts.json')
+const hadStore = existsSync(STORE)
+const backup = hadStore ? readFileSync(STORE) : null
+
+let promptsHandler = null
+let enhancerHandler = null
+const webPaths = []
+const eventHandlers = {}
+const services = {
+  webServer: { register(spec) { webPaths.push(spec.path); if (spec.path.endsWith('/prompts')) promptsHandler = spec.handler; if (spec.path === '/api/prompt-enhancer') enhancerHandler = spec.handler } },
+  tools: { register() {} },
+  // stub llm 流：/rewrite 端到端用它验证「请求期经嵌套作用域取 llm」的数据流
+  llm: {
+    stream() {
+      return (async function* () { yield { type: 'text-delta', text: 'ENHANCED OUTPUT TEXT' } })()
+    },
+  },
+  slots: { inject() {}, register() {} },
+}
+const ctx = {
+  effect(fn) { fn() },
+  get() { return undefined }, // defaultRoute() 的 ctx.get('agentDefaultModel') 安全回落
+  inject(deps, cb) {
+    const scope = Object.create(this)
+    for (const d of deps) if (!(d in scope)) scope[d] = services[d] ?? {}
+    cb(scope)
+  },
+  // cordis 瀑布语义：同名事件多个监听按注册顺序链式执行（后者拿到前者
+  // 的 next 结果）。套件合并后 pre-step 有多个监听（prompts /context 注入、
+  // compaction 落档、enhancer），单槽覆盖会让测试调到错误的那个。
+  on(name, handler) {
+    (eventHandlers[name] ??= []).push(handler)
+    return () => {
+      const list = eventHandlers[name]
+      if (!Array.isArray(list)) return
+      const index = list.indexOf(handler)
+      if (index >= 0) list.splice(index, 1)
+    }
+  },
+}
+
+const assert = (cond, label) => { if (!cond) throw new Error(label); console.log('ok:', label) }
+const call = async (handler, prefix, method, sub, body) => {
+  const chunks = body === undefined ? [] : [JSON.stringify(body)]
+  const req = { url: `${prefix}${sub}`, method, async *[Symbol.asyncIterator]() { for (const c of chunks) yield c } }
+  let status = 0
+  let out = null
+  const res = { setHeader() {}, set statusCode(v) { status = v }, end(b) { out = b ? JSON.parse(b) : null } }
+  await handler(req, res)
+  return { status, out }
+}
+const prompts = (method, sub, body) => call(promptsHandler, '/api/dsh-superinput/prompts', method, sub, body)
+const byLastUsed = (x, y) => (y.usedAt ?? y.at ?? 0) - (x.usedAt ?? x.at ?? 0)
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms))
+
+let failed = false
+try {
+  const config = {}
+  // enhancer 给显式 provider/model，让 configRoute 命中、不依赖 agentDefaultModel
+  for (const key of ['cost', 'picker', 'enhancer', 'followup', 'voice', 'prompts', 'compaction', 'hub']) config[key] = {}
+  config.enhancer = { provider: 'stub', model: 'stub-model' }
+  mod.apply(ctx, config)
+  for (const path of ['/api/dsh-cost', '/api/dsh-superinput/prompts', '/api/dsh-superinput/hub', '/api/prompt-enhancer', '/api/dsh-compaction-control']) {
+    assert(webPaths.includes(path), `module apply: ${path} registered`)
+  }
+  assert(!!promptsHandler, 'module apply: prompts handler captured')
+  assert(!!enhancerHandler, 'module apply: enhancer handler captured')
+
+  // /rewrite 端到端：回归「请求期经嵌套作用域取 llm」——处理器若退回外层
+  // ctx（0.3.1 真机事故），stub 环境里 ctx.llm 为 undefined → 502，此处必挂。
+  const rw = await call(enhancerHandler, '/api/prompt-enhancer', 'POST', '/rewrite', { text: '帮我写个东西' })
+  assert(rw.status === 200 && rw.out?.text === 'ENHANCED OUTPUT TEXT', `rewrite e2e: status=${rw.status} text=${JSON.stringify(rw.out?.text ?? rw.out)}`)
+
+  const a = await prompts('POST', '/save', { title: 'e2e-写周报', body: '写周报，日期 {{日期}}', tags: ['test'] })
+  const b = await prompts('POST', '/save', { title: 'e2e-plain', body: 'plain body' })
+  assert(a.out.ok && b.out.ok, 'save two templates')
+  const idA = a.out.id
+  const idB = b.out.id
+
+  await sleep(5) // 避免 usedAt 与保存 at 同毫秒打平（稳定排序会保留原序）
+  assert((await prompts('POST', '/use', { id: idA })).out.ok, 'use A')
+  assert((await prompts('POST', '/use', { id: idA })).out.ok, 'use A again')
+  assert((await prompts('POST', '/slash', { id: idA, slash: true })).out.ok, 'slash A on')
+  assert((await prompts('POST', '/slash', { id: idB, slash: true })).out.ok, 'slash B on')
+
+  const list1 = (await prompts('GET', '/list')).out.items
+  const itemA = list1.find((i) => i.id === idA)
+  assert(itemA.uses === 2 && itemA.usedAt > 0, 'list: A carries uses=2 + usedAt')
+  assert(itemA.slash === true && list1.find((i) => i.id === idB).slash === true, 'list: slash flags on')
+  assert([...list1].sort(byLastUsed)[0].id === idA, 'client sort: A (recently used) first')
+
+  const dump = (await prompts('GET', '/export')).out
+  assert(dump.version === 1 && dump.items.length >= 2, 'export: version+items')
+
+  const modA = { ...dump.items.find((i) => i.id === idA), title: 'e2e-写周报-v2', at: Date.now() + 10 }
+  const c = await prompts('POST', '/save', { title: 'e2e-temp-c', body: 'ccc' })
+  const delC = c.out.id
+  await prompts('POST', '/remove', { id: delC })
+  const importedC = { id: delC, title: 'e2e-C-imported', body: 'ccc', tags: [], at: Date.now(), pinned: false }
+  const stale = { ...dump.items.find((i) => i.id === idB), body: 'stale-overwrite-should-skip', at: 1 }
+  const imp = await prompts('POST', '/import', { items: [modA, importedC, stale, { body: '' }] })
+  assert(imp.out.ok && imp.out.updated === 1 && imp.out.added === 1, `import: added=${imp.out.added} updated=${imp.out.updated}`)
+  const list2 = (await prompts('GET', '/list')).out.items
+  assert(list2.find((i) => i.id === idA).title === 'e2e-写周报-v2', 'import: newer A overwrote')
+  assert(list2.find((i) => i.id === delC).title === 'e2e-C-imported', 'import: deleted C back with original id')
+  assert(list2.find((i) => i.id === idB).body !== 'stale-overwrite-should-skip', 'import: stale skipped')
+  assert((await prompts('POST', '/import', { items: 'not-an-array' })).status === 400, 'import: invalid payload rejected')
+
+  // 划选上下文：/context 暂存 → agent/pre-step 一次性注入
+  const ctxStore = await prompts('POST', '/context', { sessionId: 'smoke-session', items: [{ text: '选中的对话内容', comment: '帮我解释这一段' }] })
+  assert(ctxStore.status === 200 && ctxStore.out?.count === 1, 'context: stored')
+  // 套件合并后 pre-step 是瀑布链（prompts /context + compaction 落档 +
+  // enhancer……），按注册顺序链式调用，断言走到全链后的结果。
+  const preHandlers = eventHandlers['agent/pre-step'] ?? []
+  assert(Array.isArray(preHandlers) && preHandlers.length >= 2, `context: pre-step waterfall registered (${preHandlers.length} listeners)`)
+  const runPreStep = async (payload) => {
+    const run = async (index) => {
+      if (index >= preHandlers.length) return { kind: 'enter', messages: [] }
+      return preHandlers[index](payload, () => run(index + 1))
+    }
+    return run(0)
+  }
+  // followup 的 pre-step 读 payload.messages（真机宿主字段）——冒烟桩也要给
+  const prePayload = () => ({ agent: { session: 'smoke-session' }, messages: [], step: 1, signal: { aborted: false } })
+  const preOnce = await runPreStep(prePayload())
+  const injected = preOnce.messages?.map((m) => m?.content?.[0]?.text ?? '').join('\n') ?? ''
+  assert(injected.includes('选中的对话内容') && injected.includes('帮我解释这一段'), 'context: text + comment injected')
+  const preTwice = await runPreStep(prePayload())
+  const twiceText = preTwice.messages?.map((m) => m?.content?.[0]?.text ?? '').join('\n') ?? ''
+  assert(!twiceText.includes('选中的对话内容'), 'context: one-shot consumed')
+
+  // 客户端草稿桥：划选「添加到对话」/模板插入/斜杠命令都依赖它；
+  // 0.4.0 移除 snippets 时整块丢失过一次，静态断言防再犯。
+  const clientSource = readFileSync(new URL('../client.js', import.meta.url), 'utf8')
+  assert(clientSource.includes('window.__dshSuperinputSetDraft ='), 'client: draft bridge setter present')
+  assert(clientSource.includes('dsh-superinput-prompts-bridge'), 'client: draft bridge registered on input.dock')
+  assert(clientSource.includes("superinput-selection"), 'client: inline selection reference source registered')
+  assert(clientSource.includes("slash/input-insert-reference"), 'client: chip inserted through the official input event')
+  assert(clientSource.includes('conversation.user.text.node'), 'client: sent-message selection chip renderer registered')
+  assert(clientSource.includes('__dshSuperinputCommentContext'), 'client: selection comment card entry present')
+  assert(clientSource.includes('dsh-si-comment-editor'), 'client: anchored comment editor present (Trae previewCommentCard)')
+  assert(clientSource.includes('__dshSuperinputDropContext'), 'client: drag-drop insert entry present (Trae dragDropMention)')
+  assert(clientSource.includes('application/x-dsh-selection'), 'client: drag payload marker present')
+  assert(clientSource.includes('__dshSuperinputInsertQuote'), 'client: official insertQuote bridge present (引用文本)')
+  assert(clientSource.includes('[class*="U4oBDW_action"]'), 'client: official floating pill hidden (menu replaces it)')
+
+  console.log('SMOKE ALL PASS')
+} catch (error) {
+  failed = true
+  console.log('SMOKE FAIL:', error?.message ?? error)
+  if (error?.stack) console.log(error.stack.split('\n').slice(1, 6).join('\n'))
+} finally {
+  try {
+    if (backup) writeFileSync(STORE, backup)
+    else unlinkSync(STORE)
+  } catch { /* 恢复失败只能报出来 */ }
+  if (!backup) console.log('(no prior store: test artifacts removed)')
+}
+process.exit(failed ? 1 : 0)