dsh-loadout 0.12.4 → 0.13.0

package/scripts/client-smoke.mjs

@@ -45,7 +45,7 @@ const React = {
 
 const registrations = []
 let injections = 0
-const SLOTS = ['settings.section', 'conversation.session.header.actions']
+const SLOTS = ['settings.section', 'conversation.session.header.actions', 'conversation.input.right']
 
 const slots = {
   inject(name, callback) {
@@ -83,7 +83,9 @@ globalThis.window = {
 }
 
 // fetch must not run during load; it only runs inside effects, which the fake React never invokes.
-globalThis.fetch = () => Promise.reject(new Error('unexpected network call during load'))
+// The indirection lets one test swap in a recorder and click a row for real.
+let fetchImpl = () => Promise.reject(new Error('unexpected network call during load'))
+globalThis.fetch = (...args) => fetchImpl(...args)
 globalThis.AbortController = class { abort() {} signal = {} }
 
 // The client bundle is plain script text (no exports); evaluate it with `window` in scope.
@@ -95,13 +97,21 @@ check('declares inject', Array.isArray(loaded?.inject) && loaded.inject.includes
 
 loaded?.apply(ctx)
 
-check('slots.inject called twice', injections === 2, String(injections))
-check('two surfaces registered', registrations.length === 2, String(registrations.length))
+check('slots.inject called once per surface', injections === 3, String(injections))
+check('three surfaces registered', registrations.length === 3, String(registrations.length))
 
 const registration = registrations.find((entry) => entry.definition?.name === 'settings.section')
 const header = registrations.find((entry) => entry.definition?.name === 'conversation.session.header.actions')
+const hero = registrations.find((entry) => entry.definition?.name === 'conversation.input.right')
 check('settings panel registered', registration !== undefined)
 check('header chip registered', header !== undefined)
+check('new-conversation picker registered', hero !== undefined)
+// The slot renders only when a Session exists, and a Session-scoped entry gets
+// its id through `inject`; without this the picker would render with no session
+// to read or bind.
+check('the picker is handed its Session id',
+  typeof hero?.definition?.inject === 'function' && hero.definition.inject('session-x').sessionId === 'session-x',
+  typeof hero?.definition?.inject)
 
 const definition = registration?.definition ?? {}
 check('slot name', definition.name === 'settings.section', String(definition.name))
@@ -174,7 +184,7 @@ function expand(node) {
 }
 
 // ---- the rendered menu (seeded through the documented `preview` test seam) --
-const FOOTER = '装备栏只决定「这个对话能用哪些工具」：切换后下一条消息即按新清单组装，随时可以切回「全部」；新对话则从「设置 → 装备栏」的默认套装开始。它作用于工具（tool）这一层——界面面板、宿主服务类插件不注册工具，因此不受影响。'
+const FOOTER = '装备栏只决定「这个对话能用哪些工具」：切换后下一条消息即按新清单组装，随时可以切回「全部」；装备栏作用于工具（tool）这一层——界面面板、宿主服务类插件不注册工具，因此不受影响。'
 const fixture = {
   ok: true,
   source: 'C:/fake/.dsh/loadout.json',
@@ -207,6 +217,7 @@ const fixture = {
     visibleTools: 12, visibleTokens: 860,
     totalTools: 31, totalTokens: 2410, savedTokens: 1550, unpriced: 0,
   },
+  baseTokens: { all: 2410, dsh: 1640 },
 }
 
 let menu
@@ -251,8 +262,13 @@ if (menu !== undefined) {
   // Presets are back from 0.12: they are the quickest way to start a known kind
   // of work, they stay read-only, and each one now says what it leaves out.
   check('menu lists the presets again', allText.includes('预设套装（5）') && allText.includes('写作') && allText.includes('仅聊天'), allText.slice(0, 400))
-  check('加挂 counts extras', allText.includes('加挂（1）'), allText.slice(0, 400))
+  // 加挂 reads as "in this conversation / plugins there are at all", so the
+  // group answers "how much room is left" without opening it — and under 全部
+  // it reads 2/2 rather than 0/2, because everything is already in.
+  check('加挂 counts in-conversation plugins of all plugins', allText.includes('加挂（2/2）'), allText.slice(0, 400))
   check('footer text is the approved sentence', allText.includes(FOOTER))
+  check('footer carries the before-you-start reminder',
+    allText.includes('重要提醒') && allText.includes('建议新建对话时直接选择合适套装'), allText.slice(-600))
   check('the menu shows the note with the kit name', allText.includes('我的套（用于视频制作）'), allText.slice(0, 400))
   check('the save panel can be cancelled', source.includes("setSaveNote('')"), 'the 取消 button does not reset the save panel')
 
@@ -297,6 +313,257 @@ if (menu !== undefined) {
   const kitsOpenText = textOf(kitsOpen)
   check('我的套装 expands to the other kits', kitsOpenText.includes('另一套'), kitsOpenText.slice(0, 400))
   check('新建套装 is offered under 我的套装', kitsOpenText.includes('＋ 新建套装'), kitsOpenText.slice(0, 400))
+
+  // Saving a kit and starting to use it are two decisions. The menu offers both,
+  // and only the second one can change what this conversation's tools are.
+  check('the builder offers save without switching',
+    source.includes("onSaveKeep: () => saveBuilder('keep')"), 'no 保存 button next to 保存并启用')
+  check('the builder labels the switching button', source.includes("saveLabel: '保存并启用'"))
+  check('the switching button warns it rewrites the tools',
+    source.includes('工具清单会变，这个对话下一条消息要按未命中价重新计算一次'), '保存并启用 has no hover text')
+  const keepBranch = source.slice(source.indexOf("if (mode === 'keep')"), source.indexOf('const appliedKit'))
+  check('save-only leaves the current selection alone', keepBranch.includes('return'), keepBranch.slice(0, 200))
+}
+
+// ---- the price of a switch, next to the switch ------------------------------
+// Switching rewrites the tool definitions, so everything after them in the prefix
+// is paid again at the miss price. The number is meaningless without the context
+// that produced it, so the status line names the size too.
+const priced = { ...fixture, context: { tokens: 200000 } }
+let pricedMenu
+try {
+  pricedMenu = expand(header.component({
+    sessionId: 'session-1',
+    preview: { open: true, data: priced, groups: { kits: true, presets: true, extras: true, applied: false } },
+  }))
+} catch (error) {
+  failures.push(`priced menu render threw: ${error instanceof Error ? error.message : String(error)}`)
+}
+
+if (pricedMenu !== undefined) {
+  const pricedText = textOf(pricedMenu)
+  check('the status line states the context size', pricedText.includes('上下文 ~200k'), pricedText.slice(0, 300))
+  // Every row states the tool table it would install. That is what differs
+  // between 全部 / 仅内置 / each kit; the switch bill is the same number for all
+  // of them, so it lives once in the footer instead of on every row.
+  check('an inactive kit states its tool tokens', pricedText.includes('≈420 tokens'), pricedText.slice(0, 900))
+  const activePriced = nodesIn(pricedMenu, (node) => node.props?.role === 'menuitem' && textOf(node).includes('我的套'))
+  check('the kit already in use still states its tokens', textOf(activePriced[0]).includes('≈860 tokens'), textOf(activePriced[0]))
+  check('the default kit is marked after its name', textOf(activePriced[0]).includes('（默认）'), textOf(activePriced[0]))
+
+  // 全部 and 仅内置 pay for different tool tables, and that difference is the
+  // reason to pick one over the other.
+  const allRow = nodesIn(pricedMenu, (node) => node.props?.role === 'menuitem' && textOf(node).trim().startsWith('全部'))
+  check('全部 states its tool tokens', allRow.length === 1 && textOf(allRow[0]).includes('≈2.4k tokens'), JSON.stringify(allRow.map(textOf)))
+  const dshRow = nodesIn(pricedMenu, (node) => node.props?.role === 'menuitem' && textOf(node).trim().startsWith('仅内置'))
+  check('仅内置 states its own, smaller tool table', dshRow.length === 1 && textOf(dshRow[0]).includes('≈1.6k tokens'), JSON.stringify(dshRow.map(textOf)))
+
+  // The bill is stated once, under the reminder — not per row. A tooltip has to
+  // be found; the reminder is the paragraph people actually read.
+  check('the footer states the bill under the reminder',
+    pricedText.includes('本对话上下文（约 200k tokens），下一条未命中价≈¥0.30，之后恢复至缓存价。'),
+    pricedText.slice(-400))
+  // The bill is the one line people are meant to notice; at 11px grey it read as
+  // a footnote to the reminder above it.
+  const billLine = nodesIn(pricedMenu, (node) => node.type === 'div' &&
+    node.props?.style?.fontWeight === 600 && textOf(node).includes('本对话上下文'))
+  check('the bill line is bold and dark', billLine.length === 1, `${billLine.length}`)
+  const rowsWithOldTip = nodesIn(pricedMenu, (node) => node.props?.role === 'menuitem' &&
+    typeof node.props?.title === 'string' && node.props.title.includes('按未命中价重新计算'))
+  check('no row repeats the bill as a tooltip', rowsWithOldTip.length === 0,
+    JSON.stringify(rowsWithOldTip.map(textOf)))
+
+  // What new conversations start from is a global decision and belongs to
+  // 设置 → 装备栏. This menu is scoped to one conversation, so it must not grow
+  // a control that writes `defaultKit` — that would be the same mistake as
+  // letting the picker edit kits.
+  const defaultButtons = nodesIn(pricedMenu, (node) => node.type === 'button' &&
+    ['下次对话', '✓ 新对话', '设为默认'].includes(textOf(node).trim()))
+  check('the conversation menu cannot set the default', defaultButtons.length === 0,
+    defaultButtons.map((node) => textOf(node)).join('|'))
+  check('the conversation menu does not mention 下次对话', !pricedText.includes('下次对话'),
+    pricedText.slice(0, 300))
+
+  // Below 20k the switch is lost in the noise, and a number there would be noise.
+  const shortMenu = expand(header.component({
+    sessionId: 'session-1',
+    preview: { open: true, data: { ...fixture, context: { tokens: 5000 } }, groups: { kits: true, presets: true, extras: false } },
+  }))
+  const shortText = textOf(shortMenu)
+  const shortRows = nodesIn(shortMenu, (node) => node.props?.role === 'menuitem').map(textOf).join('|')
+  check('a short conversation quotes no price on the rows', !shortRows.includes('≈¥'), shortRows.slice(0, 400))
+  check('a short conversation still states tool tokens', shortRows.includes('≈860 tokens'), shortRows.slice(0, 400))
+  // The footer does not use that floor: it is one line whether the number is
+  // ¥0.008 or ¥0.30, and it is the sentence that explains the rows.
+  check('the footer still states the bill, however small',
+    shortText.includes('本对话上下文（约 5.0k tokens），下一条未命中价≈¥0.00'), shortText.slice(-300))
+
+  // A conversation already on the 全部 base: every plugin is in, so 加挂 reads
+  // full — it used to read 0/2 there, which looked like nothing had loaded.
+  const fullMenu = expand(header.component({
+    sessionId: 'session-1',
+    preview: {
+      open: true,
+      data: {
+        ...fixture,
+        selection: { base: 'all', kit: null, extras: [] },
+        appliedPlugins: ['alpha', 'demo'],
+        label: '全部',
+        context: { tokens: 200000 },
+      },
+      groups: { kits: false, presets: false, extras: false, applied: false },
+    },
+  }))
+  const fullText = textOf(fullMenu)
+  check('加挂 reads full under 全部', fullText.includes('加挂（2/2）'), fullText.slice(0, 300))
+  const fullRows = nodesIn(fullMenu, (node) => node.props?.role === 'menuitem')
+  // Under 全部 the pair still states two different tool tables: that is the only
+  // thing separating "hand me everything" from "hand me the built-ins".
+  const pricedBase = ['全部', '仅内置'].filter((label) => {
+    const row = fullRows.find((node) => textOf(node).replace(/^[\s✓]+/, '').startsWith(label))
+    return row !== undefined && textOf(row).includes('≈') && textOf(row).includes('tokens')
+  })
+  check('both base rows state their tool tokens, even the one in use', pricedBase.length === 2,
+    JSON.stringify(fullRows.map(textOf)))
+}
+
+// ---- the blank-conversation picker (composer row, next to 标准模式) ----------
+// This is the one place a switch is free: the agent does not exist yet, so no
+// request prefix has been built and nothing can be re-billed.
+try {
+  // Collapsed, the chip says what it is and keeps the sentence for the tooltip:
+  // the composer row is shared with 权限/计划 and has no room for prose.
+  const collapsed = expand(hero.component({ sessionId: 'session-new', preview: { blank: true, data: fixture } }))
+  const collapsedText = textOf(collapsed)
+  check('the chip says what it chooses and names the kit',
+    collapsedText.includes('选择对话套装') && collapsedText.includes('我的套'), collapsedText)
+  check('the sentence is not printed on the row', !collapsedText.includes('这个新对话会用'), collapsedText)
+  const tipButton = nodesIn(collapsed, (node) => typeof node.props?.title === 'string' && node.props.title.includes('这个新对话会用'))
+  check('the sentence rides on the chip as its tooltip', tipButton.length === 1, JSON.stringify(nodesIn(collapsed, (node) => node.props?.title)))
+  check('the tooltip reads as a sentence about this conversation',
+    tipButton[0]?.props?.title === '这个新对话会用「我的套」套装', String(tipButton[0]?.props?.title))
+
+  // A pick on an unsent screen is a draft: a later visit must start clean, so the
+  // first look asks the host to drop whatever a previous visit left behind.
+  check('a new visit releases the previous visit\'s draft',
+    source.includes("action: 'release'") && source.includes('next.draft === true'),
+    'the picker never releases a draft')
+
+  // With no default set, the collapsed label is 全部.
+  const noDefault = expand(hero.component({
+    sessionId: 'session-new',
+    preview: { blank: true, data: { ...fixture, defaultKit: '' } },
+  }))
+  const noDefaultText = textOf(noDefault)
+  check('with no default, the chip says 全部',
+    noDefaultText.includes('全部') && !noDefaultText.includes('我的套'), noDefaultText)
+  check('the collapsed control is a real button',
+    nodesIn(noDefault, (node) => node.props?.['aria-expanded'] === 'false').length === 1,
+    noDefaultText)
+
+  // Opened: 全部 / 仅内置 / the two groups, groups still folded.
+  const opened = expand(hero.component({
+    sessionId: 'session-new',
+    preview: { blank: true, data: fixture, open: true },
+  }))
+  const openedText = textOf(opened)
+  check('opened, it lists 全部 and 仅内置', openedText.includes('全部') && openedText.includes('仅内置'), openedText)
+  check('opened, it groups presets and my kits', openedText.includes('预设套装') && openedText.includes('我的套装'), openedText)
+  check('both kit groups start folded', !openedText.includes('写作') && !openedText.includes('另一套'), openedText)
+  check('folded groups still say how many they hold',
+    openedText.includes('（5）') && openedText.includes('（2）'), openedText)
+  // A folded group would otherwise answer "nothing chosen" on a fresh screen:
+  // the default kit stays visible and is marked the way the header menu marks it.
+  check('a folded group still shows the default kit',
+    openedText.includes('我的套（用于视频制作）（默认）') && !openedText.includes('另一套'), openedText)
+  const presetFold = expand(hero.component({
+    sessionId: 'session-new',
+    preview: { blank: true, data: { ...fixture, defaultKit: 'chat' }, open: true },
+  }))
+  check('a folded preset group shows the default preset too',
+    textOf(presetFold).includes('仅聊天（默认）') && !textOf(presetFold).includes('写作'), textOf(presetFold))
+  check('the collapsed chip stays plain',
+    !collapsedText.includes('（默认）'), collapsedText)
+
+  // The picker answers one question — which kit this conversation starts with.
+  // Creating, editing and choosing the default are someone else's job (设置), and
+  // a picker that also offered them would be a menu pretending to be a page.
+  const pickerText = textOf(hero.component({
+    sessionId: 'session-new',
+    preview: { blank: true, data: fixture, open: true, groups: { presets: true, kits: true } },
+  }))
+  check('the picker does not create kits', !pickerText.includes('新建套装'), pickerText.slice(0, 300))
+  check('the picker does not edit kits', !pickerText.includes('编辑') && !pickerText.includes('删除'), pickerText.slice(0, 300))
+  check('the picker does not set the default', !pickerText.includes('设为默认') && !pickerText.includes('下次对话'),
+    pickerText.slice(0, 300))
+
+  // Opening the list must not reflow the page, and it opens upward: the composer
+  // row sits at the bottom of the window.
+  const panel = nodesIn(opened, (node) => node.props?.style?.maxHeight === 320)
+  check('the list floats instead of pushing the page',
+    panel.length === 1 && panel[0]?.props?.style?.position === 'absolute', JSON.stringify(panel.map((node) => node.props.style)))
+  check('the list opens upward', String(panel[0]?.props?.style?.bottom ?? '').includes('100%'), JSON.stringify(panel[0]?.props?.style))
+  check('the chip anchors the floating list',
+    opened?.props?.style?.position === 'relative', JSON.stringify(opened?.props?.style))
+
+  // `@dsh` is the wire value for 仅内置; it must never be shown to the user, not
+  // in the list and not in the sentence that confirms a pick.
+  check('仅内置 is never printed as its wire value',
+    !openedText.includes('@dsh') && source.includes("if (name === DEFAULT_DSH) return '仅内置'"),
+    openedText)
+
+  // A kit inside 我的套装 is selectable once that group is opened, and picking it
+  // binds this conversation only.
+  const binds = []
+  fetchImpl = (url, init) => {
+    binds.push({ url, body: JSON.parse(String(init?.body ?? '{}')) })
+    return Promise.resolve({ ok: true, status: 200, json: async () => ({ ...fixture, bound: true, binding: 'other' }) })
+  }
+  const kitsOpen = expand(hero.component({
+    sessionId: 'session-new',
+    preview: { blank: true, data: fixture, open: true, groups: { presets: false, kits: true } },
+  }))
+  const kitRows = nodesIn(kitsOpen, (node) => node.props?.role === 'menuitem')
+  const otherRow = kitRows.find((node) => textOf(node).includes('另一套'))
+  check('my kits open to their rows', otherRow !== undefined, JSON.stringify(kitRows.map(textOf)))
+  otherRow?.props?.onClick?.()
+  check('picking a kit binds this conversation only',
+    binds.length === 1 && binds[0]?.body?.action === 'bind' && binds[0]?.body?.sessionId === 'session-new' && binds[0]?.body?.name === 'other',
+    JSON.stringify(binds))
+  check('picking a kit leaves the default alone',
+    binds[0]?.body?.base === undefined && binds[0]?.body?.apply === undefined && binds[0]?.body?.default === undefined,
+    JSON.stringify(binds[0]?.body))
+
+  // A bound conversation shows its own pick, not the default.
+  const bound = expand(hero.component({
+    sessionId: 'session-new',
+    preview: { blank: true, data: { ...fixture, bound: true, binding: 'other' } },
+  }))
+  check('a bound conversation names its own kit', textOf(bound).includes('另一套'), textOf(bound))
+
+  // A conversation that borrowed the default is not bound: the chip has to show
+  // the current default even though the store still holds the kit it was given
+  // when it was created.
+  const borrowed = expand(hero.component({
+    sessionId: 'session-new',
+    preview: { blank: true, data: { ...fixture, bound: false, binding: 'other' } },
+  }))
+  check('a borrowed kit does not count as this conversation\'s pick',
+    textOf(borrowed).includes('我的套') && !textOf(borrowed).includes('另一套'), textOf(borrowed))
+  check('the picker can ask the host to catch up with the default',
+    source.includes('follow: true') && source.includes("String(next.binding ?? '') !== wanted"),
+    'no catch-up request in the picker')
+  // The catch-up must hang on "this screen is blank", not on "this conversation
+  // never picked": a conversation created under an older default carries a real
+  // binding, and the pill used to show it as if it had been chosen here.
+  check('the catch-up is gated on a blank screen, not on the binding',
+    source.includes('if (blank === true)') && !source.includes('next.bound !== true &&'),
+    'the catch-up still waits for a missing binding')
+
+  // Once the conversation has a message the hero is gone, and so is the picker.
+  check('the picker leaves with the hero', hero.component({ sessionId: 'session-new', preview: { blank: false, data: fixture } }) === null)
+} catch (error) {
+  failures.push(`hero picker render threw: ${error instanceof Error ? error.message : String(error)}`)
 }
 
 // ---- the chip stays a single button while closed ---------------------------
@@ -335,7 +602,21 @@ try {
   // 全部 / 仅内置 sit in the same list as the kits, so they are rendered as cards
   // with the same two actions; presets are read-only and carry no save-as button.
   // The default section says out loud that it cannot reach an open conversation.
-  check('settings says the default only affects new conversations', panelText.includes('只影响之后新建的对话'), panelText.slice(0, 400))
+  check('settings says the default only affects new conversations',
+    panelText.includes('只影响新建对话') && panelText.includes('当前对话在「装备栏」切换'), panelText.slice(0, 400))
+  // The title and its caveat are one thought; the note sits beside the heading
+  // instead of becoming a paragraph of its own above the cards.
+  check('the default heading carries its caveat on the same line',
+    panelText.includes('新对话默认套装只影响新建对话'), panelText.slice(0, 400))
+  // One text node, not two spans: the second span's own 0.6 opacity multiplied
+  // with the heading's 0.6, so the same line came out in two shades.
+  const splitCaveat = nodesIn(panel, (node) => textOf(node) === '只影响新建对话')
+  check('the caveat is not a separately styled node', splitCaveat.length === 0,
+    `${splitCaveat.length} · 只影响新建对话`)
+  // 全部 / 仅内置 are the only two cards that had no number; they price their own
+  // tool tables, which is also what the header menu's rows now show.
+  check('the base cards state their tool tokens',
+    panelText.includes('≈2.4k tokens') && panelText.includes('≈1.6k tokens'), panelText.slice(0, 500))
   const copyButtons = nodesIn(panel, (node) => node.type === 'button' && textOf(node) === '复制切换命令')
   const defaultButtons = nodesIn(panel, (node) => node.type === 'button' && textOf(node) === '设为默认')
   // 2 defaults + 3 presets + 2 user kits — every card carries both actions.
@@ -347,6 +628,16 @@ try {
   const deleteButtons = nodesIn(panel, (node) => node.type === 'button' && textOf(node) === '删除')
   check('only my kits can be deleted', deleteButtons.length === 2, `${deleteButtons.length} · 删除@${panelText.indexOf('删除')} · ${panelText.slice(0, 200)}`)
 
+  // A page that edits defaults has no business quoting what a switch would cost
+  // *this* conversation — that number belongs to the conversation's own menu.
+  check('settings does not price a switch', !panelText.includes('切换一次大概多贵') && !panelText.includes('未命中 ¥/百万'), panelText.slice(0, 600))
+  check('settings explains the numbers are the last live conversation\'s',
+    panelText.includes('设置页不绑定具体会话，上面的数字来自最近活跃的那个对话'), panelText.slice(0, 300))
+  check('settings says where a single conversation is switched',
+    panelText.includes('当前对话在「装备栏」切换'), panelText.slice(0, 300))
+  check('settings names the other two places a kit can be chosen',
+    panelText.includes('新建时也可选套装'), panelText.slice(0, 300))
+
   // Presets start collapsed, and while collapsed they behave like 我的套装: the
   // one that is the default stays visible so the page still answers "a new
   // conversation starts with this".
@@ -412,12 +703,14 @@ try {
   applyError = error
 }
 check('apply survives a missing slot', applyError === undefined, String(applyError))
-check('the remaining surface still registers',
-  keptRegistrations.length === 1 && keptRegistrations[0].name === 'settings.section',
+check('the remaining surfaces still register',
+  keptRegistrations.length === 2
+    && keptRegistrations.some((entry) => entry.name === 'settings.section')
+    && keptRegistrations.some((entry) => entry.name === 'conversation.input.right'),
   JSON.stringify(keptRegistrations.map((entry) => entry.name)))
 
 if (failures.length === 0) {
-  console.log('ok: client bundle loads, renders the new header menu (groups, check marks, tooltips, footer), and renders the settings panel')
+  console.log('ok: client bundle loads, renders the new-conversation picker, the header menu (groups, check marks, tooltips, footer), and the settings panel')
   process.exit(0)
 }
 console.log(`FAILED (${failures.length}):`)

package/scripts/selftest.mjs

@@ -118,6 +118,20 @@ function makeCtx() {
   built.commands = commands
   built.routes = routes
   built.sessions = { get: (sessionId) => sessions.get(sessionId) }
+  // The token meter publishes the prompt size as a session projection. The fake
+  // host answers from `projectionTokens`, so a test can move the number.
+  built.projectionTokens = { value: undefined }
+  built.sessionProjections = {
+    snapshot(session) {
+      const value = built.projectionTokens.value
+      return {
+        asOfSeq: 0,
+        values: value === undefined
+          ? {}
+          : { contextPressure: { pressureTokens: value, projectedTokens: value, contextWindow: 128000 } },
+      }
+    },
+  }
   built.sessionTable = sessions
   built.agentTable = agents
   return built
@@ -148,6 +162,7 @@ function childFor(dependencies, built, commands, routes) {
   // The plugin injects `sessions` optionally; a fake host without it must still
   // work (that is the 0.x path), so this mirrors the real `optional` contract.
   if (dependencies.includes('sessions')) child.sessions = built.sessions
+  if (dependencies.includes('sessionProjections')) child.sessionProjections = built.sessionProjections
   return child
 }
 
@@ -982,6 +997,141 @@ process.env.USERPROFILE = savedProfile
 process.env.HOME = savedHome
 rmSync(legacyHome, { recursive: true, force: true })
 
+// ---- the client is told how big the prompt is -------------------------------
+// A switch costs prompt size × the miss/hit price gap, so the host has to hand
+// over the token meter's own number — not a guess from the session file.
+const pricedAgent = makeAgent()
+sessionAgentOf.agent = pricedAgent
+const unsampled = await getState(pricedAgent.id)
+check('no sample yet means no context size', unsampled.body.context?.tokens === null, JSON.stringify(unsampled.body.context))
+ctx.projectionTokens.value = 150000
+const sampled = await getState(pricedAgent.id)
+check('the context size comes from contextPressure', sampled.body.context?.tokens === 150000, JSON.stringify(sampled.body.context))
+ctx.projectionTokens.value = undefined
+const meterGone = await getState(pricedAgent.id)
+check('a host without a token meter still answers', meterGone.body.context?.tokens === null, JSON.stringify(meterGone.body.context))
+
+// ---- a blank conversation can choose its kit before it has an agent ---------
+// This is the free switch: no agent means no request prefix, so the choice is
+// stored as a binding and applied the moment the agent appears — before the
+// first prompt is built.
+const unknownPick = await post({ action: 'bind', sessionId: 'session-blank', name: 'pick-kit' })
+check('binding an unknown kit is refused', unknownPick.status === 404, `${unknownPick.status} ${unknownPick.body?.message ?? ''}`)
+
+await ctx.registered.get('kit_create').execute(
+  { name: 'pick-kit', title: '新建用', builtins: ['read'], plugins: [] }, exec(agentB))
+const bound = await post({ action: 'bind', sessionId: 'session-blank', name: 'pick-kit' })
+check('a blank conversation can be bound to a kit',
+  bound.status === 200 && bound.body?.ok === true && bound.body?.bound === true && bound.body?.binding === 'pick-kit',
+  JSON.stringify({ status: bound.status, bound: bound.body?.bound, binding: bound.body?.binding }))
+
+const beforeAgent = await getState('session-blank')
+check('the binding is stored before the agent exists',
+  beforeAgent.body?.bound === true && beforeAgent.body?.binding === 'pick-kit',
+  JSON.stringify({ bound: beforeAgent.body?.bound, binding: beforeAgent.body?.binding }))
+
+// The first request is assembled after this, so the pick costs nothing.
+const pickAgent = makeAgent(undefined, { id: 'session-blank' })
+sessionAgentOf.agent = pickAgent
+for (const handler of ctx.handlers.get('agent/created') ?? []) handler(pickAgent)
+const afterAgent = await getState('session-blank')
+check('the pick applies as soon as the agent appears',
+  afterAgent.body?.binding === 'pick-kit' && afterAgent.body?.selection?.kit === 'pick-kit',
+  JSON.stringify({ binding: afterAgent.body?.binding, selection: afterAgent.body?.selection }))
+check('the picked kit is what the first request will see',
+  keptOf(pickAgent).includes('read'), keptOf(pickAgent).join(','))
+// The welcome screen can already have an agent behind it, and the picker still
+// has to know the pick was a draft — otherwise the release never fires and the
+// draft is what the next visit shows.
+const liveDraft = await getState('session-blank')
+check('a live conversation still reports its draft',
+  liveDraft.body?.live === true && liveDraft.body?.draft === true,
+  JSON.stringify({ live: liveDraft.body?.live, draft: liveDraft.body?.draft }))
+
+const cleared = await post({ action: 'bind', sessionId: 'session-blank', name: '' })
+check('binding 全部 clears the pick', cleared.status === 200 && cleared.body?.bound === true && cleared.body?.binding === '',
+  JSON.stringify({ bound: cleared.body?.bound, binding: cleared.body?.binding }))
+const clearedState = await getState('session-blank')
+check('the cleared pick reads back as 全部', clearedState.body?.bound === true && clearedState.body?.binding === '',
+  JSON.stringify({ bound: clearedState.body?.bound, binding: clearedState.body?.binding }))
+
+// ---- a welcome-screen pick is a draft, not a decision ----------------------
+// Leaving the screen without sending anything must reset it, exactly like the
+// host resets its own mode; a completed turn promotes the draft for real.
+const draftBind = await post({ action: 'bind', sessionId: 'session-draft', name: 'pick-kit' })
+check('a welcome-screen pick is marked as a draft', draftBind.body?.draft === true, JSON.stringify(draftBind.body?.draft))
+// The marker has to be on disk, not in this process: a restart used to launder
+// a draft into a decision, so the next visit showed a kit the user never chose.
+const draftStore = () => JSON.parse(readFileSync(storePath, 'utf8'))
+check('the draft marker reaches the store',
+  draftStore().drafts?.['session-draft'] === 'pick-kit',
+  JSON.stringify(draftStore().drafts))
+const draftState = await getState('session-draft')
+check('the draft reads back on the same visit',
+  draftState.body?.draft === true && draftState.body?.binding === 'pick-kit',
+  JSON.stringify({ draft: draftState.body?.draft, binding: draftState.body?.binding }))
+
+const released = await post({ action: 'release', sessionId: 'session-draft' })
+check('leaving the welcome screen drops the draft',
+  released.body?.draft === false && released.body?.bound === false && released.body?.binding === '',
+  JSON.stringify({ draft: released.body?.draft, bound: released.body?.bound, binding: released.body?.binding }))
+check('the released draft leaves nothing behind in the store',
+  draftStore().drafts?.['session-draft'] === undefined && draftStore().assignments['session-draft'] === undefined,
+  JSON.stringify({ drafts: draftStore().drafts, assignment: draftStore().assignments['session-draft'] }))
+const afterRelease = await getState('session-draft')
+check('the next visit starts at the default',
+  afterRelease.body?.draft !== true && afterRelease.body?.bound === false,
+  JSON.stringify({ draft: afterRelease.body?.draft, bound: afterRelease.body?.bound }))
+
+await post({ action: 'bind', sessionId: 'session-draft', name: 'pick-kit' })
+for (const handler of ctx.handlers.get('session/event') ?? []) handler({ id: 'session-draft' }, { type: 'turn/end' })
+const promoted = await getState('session-draft')
+check('a completed turn promotes the draft into a real binding',
+  promoted.body?.draft !== true && promoted.body?.binding === 'pick-kit',
+  JSON.stringify({ draft: promoted.body?.draft, binding: promoted.body?.binding }))
+
+await post({ action: 'bind', sessionId: 'session-draft-2', name: 'pick-kit' })
+for (const handler of ctx.handlers.get('session/disposed') ?? []) handler({ id: 'session-draft-2' })
+const disposed = await getState('session-draft-2')
+check('a disposed welcome screen takes its draft with it',
+  disposed.body?.draft !== true, JSON.stringify(disposed.body?.draft))
+
+// ---- a default is a loan, not a pick ---------------------------------------
+// Creating a conversation while a default is set used to write that default into
+// the conversation's binding as if the user had chosen it. After the default
+// moved, the welcome screen kept showing the old kit under a 「默认」 label.
+const loanAgent = makeAgent(undefined, { id: 'session-loan' })
+fireCreated(loanAgent)
+const loaned = await getState('session-loan')
+check('a conversation that borrowed the default does not count as bound',
+  loaned.body?.bound === false && loaned.body?.binding === 'coding',
+  JSON.stringify({ bound: loaned.body?.bound, binding: loaned.body?.binding }))
+check('the loan is marked as such in the store',
+  draftStore().auto?.['session-loan'] === true && draftStore().drafts?.['session-loan'] === undefined,
+  JSON.stringify({ auto: draftStore().auto, drafts: draftStore().drafts }))
+
+// Changing the default still touches no conversation...
+await ctx.registered.get('kit_set_default').execute({ name: 'pick-kit' }, exec(loanAgent))
+const stillLoaned = await getState('session-loan')
+check('a new default leaves a borrowed conversation on its old kit',
+  stillLoaned.body?.binding === 'coding', JSON.stringify(stillLoaned.body?.binding))
+
+// ...the welcome screen catches it up instead, and the catch-up is still a loan.
+const caughtUp = await post({ action: 'bind', sessionId: 'session-loan', name: 'pick-kit', follow: true })
+check('the follow-up moves a borrowed conversation to the new default',
+  caughtUp.body?.binding === 'pick-kit' && caughtUp.body?.bound === false && caughtUp.body?.draft === false,
+  JSON.stringify({ binding: caughtUp.body?.binding, bound: caughtUp.body?.bound, draft: caughtUp.body?.draft }))
+check('a follow-up writes no draft',
+  draftStore().drafts?.['session-loan'] === undefined && draftStore().auto?.['session-loan'] === true,
+  JSON.stringify({ drafts: draftStore().drafts, auto: draftStore().auto }))
+
+// The first turn turns the loan into this conversation's own kit.
+for (const handler of ctx.handlers.get('session/event') ?? []) handler({ id: 'session-loan' }, { type: 'turn/end' })
+const settled = await getState('session-loan')
+check('the first turn pins the borrowed kit',
+  settled.body?.bound === true && settled.body?.binding === 'pick-kit' && draftStore().auto?.['session-loan'] === undefined,
+  JSON.stringify({ bound: settled.body?.bound, binding: settled.body?.binding, auto: draftStore().auto }))
+
 // ---- report ----------------------------------------------------------------
 rmSync(scratch, { recursive: true, force: true })
 if (failures.length === 0) {

package/scripts/agent-lookup-probe.mjs

@@ -1,24 +0,0 @@
-/**
- * Is there a host service that maps a session id to its live agent?
- */
-import { readFileSync, readdirSync } from 'node:fs'
-
-const BASE = 'C:/Users/JungleYXu/AppData/Local/Programs/DeepSeek Harness/resources/app.asar/dsh/node_modules/@deepseek-ai'
-const packages = readdirSync(BASE)
-const pattern = /agentFor|bySession|sessionAgent|agentOf|resolveAgent/g
-
-for (const name of packages) {
-  if (!name.startsWith('dsh-')) continue
-  let text
-  try {
-    text = readFileSync(`${BASE}/${name}/lib/index.js`, 'utf8')
-  } catch {
-    continue
-  }
-  const hits = [...new Set([...text.matchAll(pattern)].map((m) => m[0]))]
-  if (hits.length === 0) continue
-  const index = text.search(pattern)
-  console.log(`\n### ${name} :: ${hits.join(', ')}`)
-  console.log(text.slice(Math.max(0, index - 200), index + 260).replace(/\s+/g, ' '))
-}
-

package/scripts/agent-probe.mjs

@@ -1,25 +0,0 @@
-/**
- * How does host code get a session id from an agent object?
- */
-import { readFileSync } from 'node:fs'
-
-const BASE = 'C:/Users/JungleYXu/AppData/Local/Programs/DeepSeek Harness/resources/app.asar/dsh/node_modules/@deepseek-ai'
-const files = [
-  'dsh-tools/lib/index.js',
-  'dsh-agent/lib/index.js',
-  'dsh-session/lib/index.js',
-  'dsh-subagent/lib/index.js',
-]
-
-for (const rel of files) {
-  let text
-  try {
-    text = readFileSync(`${BASE}/${rel}`, 'utf8')
-  } catch (error) {
-    console.log(`skip ${rel}: ${error.code}`)
-    continue
-  }
-  const hits = [...text.matchAll(/agent\.session[A-Za-z]*/g)].map((m) => m[0])
-  const unique = [...new Set(hits)]
-  console.log(`${rel} -> ${unique.join(', ') || '(none)'}`)
-}