sideby 0.4.3 → 0.6.0

package/dist/src/panel/i18n.d.ts

@@ -233,6 +233,73 @@ declare const en: {
     'menu.check': string;
     'menu.like': string;
     'menu.tune': string;
+    'menu.model': string;
+    'md.title': string;
+    'md.intro': string;
+    'md.model': string;
+    'md.effort': string;
+    'md.default': string;
+    'md.decides': string;
+    'md.from.sideby': string;
+    'md.from.host': string;
+    'md.from.last': string;
+    'md.none': string;
+    'md.click': string;
+    'md.envNote': string;
+    'md.reset': string;
+    'md.review': string;
+    'md.apply': string;
+    'md.nothing': string;
+    'md.changes': string;
+    'md.saved': string;
+    'page.handoff': string;
+    'hp.title': string;
+    'hp.advanced': string;
+    'hp.loading': string;
+    'hp.intro': string;
+    'hp.how1': string;
+    'hp.how2': string;
+    'hp.how3': string;
+    'hp.noStarters': string;
+    'hp.sameFamily': string;
+    'hp.turnOn': string;
+    'hp.turnOff': string;
+    'hp.willDo': string;
+    'hp.step.config': string;
+    'hp.step.quota': string;
+    'hp.step.hook': string;
+    'hp.step.copy': string;
+    'hp.showChange': string;
+    'hp.sameFamilyOffNote': string;
+    'hp.manual.codexTrust': string;
+    'hp.blocked': string;
+    'hp.confirmOn': string;
+    'hp.applying': string;
+    'hp.stepFailed': string;
+    'hp.tryAgain': string;
+    'hp.onNote': string;
+    'hp.takeover': string;
+    'hp.used': string;
+    'hp.noQuota': string;
+    'hp.goesTo': string;
+    'hp.goesToLimit': string;
+    'hp.waits': string;
+    'hp.waitRule': string;
+    'hp.planChanged': string;
+    'hp.none': string;
+    'hp.noneBack': string;
+    'hp.noAccounts': string;
+    'hp.recent': string;
+    'hp.noneYet': string;
+    'hp.why.threshold': string;
+    'hp.why.limit': string;
+    'hp.why.manual': string;
+    'hp.missing': string;
+    'hp.complete': string;
+    'hp.onlySideby': string;
+    'hp.sameConfirm': string;
+    'hp.sameOn': string;
+    'hp.sameOff': string;
     'page.accounts': string;
     'page.tuning': string;
     'tune.title': string;

package/dist/src/panel/i18n.js

@@ -235,6 +235,73 @@ const en = {
     'menu.check': 'Check this account',
     'menu.like': 'New account like this',
     'menu.tune': 'Context tuning',
+    'menu.model': 'Model and effort…',
+    'md.title': 'Model and effort',
+    'md.intro': 'Applies to new sessions of {ref} that you start with sideby (a short command or sideby run). It is saved in sideby’s config; {host}’s own settings stay as they are.',
+    'md.model': 'Model',
+    'md.effort': 'Effort',
+    'md.default': 'Default',
+    'md.decides': '{host} decides',
+    'md.from.sideby': 'set by sideby for this account',
+    'md.from.host': 'from {host}’s settings',
+    'md.from.last': 'used in the last session',
+    'md.none': 'not known yet',
+    'md.click': 'Click to change.',
+    'md.envNote': 'ANTHROPIC_MODEL or CLAUDE_CODE_EFFORT_LEVEL in your shell, and settings from your organization, override this; sideby cannot see them.',
+    'md.reset': 'Back to default',
+    'md.review': 'Review change',
+    'md.apply': 'Apply',
+    'md.nothing': 'Nothing to change.',
+    'md.changes': 'This changes sideby’s config:',
+    'md.saved': 'Saved. New sessions of {ref} use it.',
+    'page.handoff': 'Auto Handoff',
+    'hp.title': 'Auto Handoff',
+    'hp.advanced': 'Advanced settings',
+    'hp.loading': 'Checking…',
+    'hp.intro': 'When an account is about to run out of quota, your work moves to the next account by itself. You do not have to do anything.',
+    'hp.how1': 'You keep working in a session you started with sideby (a short command such as cc001, or sideby run).',
+    'hp.how2': 'When that account reaches {p}% of its quota, sideby has the AI write a short note about the task and ends the session.',
+    'hp.how3': 'After a {s}-second countdown (Enter cancels), the next account starts in the same terminal and carries on from the note.',
+    'hp.noStarters': 'None of your accounts can start a hand-over yet. Add a Claude, Codex or Grok account first.',
+    'hp.sameFamily': 'Also switch between accounts of the same tool (for example cc001 to cc002)',
+    'hp.turnOn': 'Turn on',
+    'hp.turnOff': 'Turn off',
+    'hp.willDo': 'To turn it on, sideby will:',
+    'hp.step.config': 'Switch Auto Handoff on in sideby’s settings',
+    'hp.step.quota': 'Turn on {host} quota display (hand-over needs it to know how much is used)',
+    'hp.step.hook': 'Add sideby’s hand-over hook to {host}',
+    'hp.step.copy': 'Copy the hook file into your other {host} accounts ({accounts}); nothing else in them changes',
+    'hp.showChange': 'Show the change',
+    'hp.sameFamilyOffNote': 'Accounts of the same tool will not switch between each other. You can turn that on later on this page.',
+    'hp.manual.codexTrust': 'Codex asks once per account to trust sideby’s hooks. Type /hooks in Codex the first time and trust them; sideby reminds you then.',
+    'hp.blocked': 'It cannot be turned on yet: {why}',
+    'hp.confirmOn': 'Confirm and turn on',
+    'hp.applying': 'Turning on…',
+    'hp.stepFailed': 'Stopped at: {step}. {why}',
+    'hp.tryAgain': 'Nothing after it was changed. Try again, or ask for help.',
+    'hp.onNote': 'When an account reaches {p}% of its quota, its session moves to the next account by itself.',
+    'hp.takeover': 'Where work goes next',
+    'hp.used': '{p}% used',
+    'hp.noQuota': 'quota unknown',
+    'hp.goesTo': 'at {p}% it moves to {to}',
+    'hp.goesToLimit': 'when it hits its usage limit it moves to {to}',
+    'hp.waits': 'at the limit it waits: quota is back at {at}',
+    'hp.waitRule': 'If its quota comes back within {w} minutes at that point, it waits instead of switching.',
+    'hp.planChanged': 'Something changed since you looked, so sideby has not changed anything yet. This is what it would do now; confirm again.',
+    'hp.none': 'no account can take over right now',
+    'hp.noneBack': 'no account can take over now; {ref} is back at {at}',
+    'hp.noAccounts': 'No subscription account can start a hand-over.',
+    'hp.recent': 'Recent hand-overs',
+    'hp.noneYet': 'None yet. The next time an account runs low you will see it here.',
+    'hp.why.threshold': 'quota reached the hand-over level',
+    'hp.why.limit': 'it hit its usage limit',
+    'hp.why.manual': 'handed over on request',
+    'hp.missing': 'One step left',
+    'hp.complete': 'Finish setting up',
+    'hp.onlySideby': 'Only sessions started with sideby hand over (a short command such as cc001, or sideby run). Typing claude directly does not.',
+    'hp.sameConfirm': 'Switch it on',
+    'hp.sameOn': 'Same-tool hand-over is on.',
+    'hp.sameOff': 'Same-tool hand-over is off.',
     'page.accounts': 'Accounts',
     'page.tuning': 'Context tuning',
     'tune.title': 'Context tuning',
@@ -617,6 +684,73 @@ const zh = {
     'menu.check': '检查这个账号',
     'menu.like': '照此新建账号',
     'menu.tune': '上下文调优',
+    'menu.model': '模型和 effort…',
+    'md.title': '模型和 effort',
+    'md.intro': '只影响之后用 sideby 启动的 {ref} 新会话（短命令或 sideby run）。保存在 sideby 的配置里，不改 {host} 自己的设置。',
+    'md.model': '模型',
+    'md.effort': 'Effort',
+    'md.default': '默认',
+    'md.decides': '由 {host} 决定',
+    'md.from.sideby': 'sideby 为这个账号设置',
+    'md.from.host': '来自 {host} 的设置',
+    'md.from.last': '最近一次会话用的',
+    'md.none': '暂时不知道',
+    'md.click': '点击修改。',
+    'md.envNote': 'shell 里的 ANTHROPIC_MODEL、CLAUDE_CODE_EFFORT_LEVEL 和组织下发的设置会覆盖这里，sideby 看不到它们。',
+    'md.reset': '恢复默认',
+    'md.review': '查看改动',
+    'md.apply': '应用',
+    'md.nothing': '没有要改的。',
+    'md.changes': '将修改 sideby 的配置：',
+    'md.saved': '已保存，{ref} 的新会话会用它。',
+    'page.handoff': '自动交接',
+    'hp.title': '自动交接',
+    'hp.advanced': '高级设置',
+    'hp.loading': '检查中…',
+    'hp.intro': '账号额度快用完时，你的工作会自动换到下一个账号接着做，不用你操心。',
+    'hp.how1': '你照常在用 sideby 启动的会话里工作（短命令如 cc001，或 sideby run）。',
+    'hp.how2': '这个账号用到 {p}% 时，sideby 让 AI 写一份任务小结，然后结束这个会话。',
+    'hp.how3': '倒计时 {s} 秒后（按回车可取消），下一个账号在同一个终端里按小结接着做。',
+    'hp.noStarters': '你的账号里还没有能发起交接的。先添加一个 Claude、Codex 或 Grok 账号。',
+    'hp.sameFamily': '同一个工具的账号之间也切换（例如 cc001 到 cc002）',
+    'hp.turnOn': '一键开启',
+    'hp.turnOff': '关闭',
+    'hp.willDo': '开启时 sideby 会：',
+    'hp.step.config': '在 sideby 的设置里打开自动交接',
+    'hp.step.quota': '打开 {host} 的额度显示（交接要靠它知道用了多少）',
+    'hp.step.hook': '给 {host} 装上 sideby 的交接钩子',
+    'hp.step.copy': '把钩子文件复制到你的其他 {host} 账号（{accounts}），它们的其他文件不动',
+    'hp.showChange': '查看改动',
+    'hp.sameFamilyOffNote': '同一个工具的账号之间不会互相切换，之后可以在本页打开。',
+    'hp.manual.codexTrust': 'Codex 每个账号第一次要信任 sideby 的钩子：第一次启动时在 Codex 里输入 /hooks 并信任，到时 sideby 会提醒你。',
+    'hp.blocked': '暂时不能开启：{why}',
+    'hp.confirmOn': '确认开启',
+    'hp.applying': '正在开启…',
+    'hp.stepFailed': '停在这一步：{step}。{why}',
+    'hp.tryAgain': '它之后的步骤没有执行。可以重试，或找人帮忙。',
+    'hp.onNote': '任一账号用到 {p}% 时，它的会话会自动换到下一个账号。',
+    'hp.takeover': '接下来会交给谁',
+    'hp.used': '已用 {p}%',
+    'hp.noQuota': '额度未知',
+    'hp.goesTo': '到 {p}% 时交给 {to}',
+    'hp.goesToLimit': '撞到用量上限时交给 {to}',
+    'hp.waits': '到上限时会等待：{at} 额度恢复',
+    'hp.waitRule': '如果那时离额度恢复不到 {w} 分钟，就原地等，不换号。',
+    'hp.planChanged': '你查看之后设置有了变化，所以还没有改任何东西。下面是现在要做的改动，请再确认一次。',
+    'hp.none': '现在没有能接手的账号',
+    'hp.noneBack': '现在没有能接手的账号；{ref} 在 {at} 恢复',
+    'hp.noAccounts': '没有能发起交接的订阅账号。',
+    'hp.recent': '最近的交接',
+    'hp.noneYet': '还没有。下次有账号额度快用完时，这里会出现记录。',
+    'hp.why.threshold': '额度到了交接线',
+    'hp.why.limit': '撞到了用量上限',
+    'hp.why.manual': '按你的要求交接',
+    'hp.missing': '还差一步',
+    'hp.complete': '补全设置',
+    'hp.onlySideby': '只有用 sideby 启动的会话才会交接（短命令如 cc001，或 sideby run）。直接敲 claude 启动的不会。',
+    'hp.sameConfirm': '确认打开',
+    'hp.sameOn': '已开启同工具交接。',
+    'hp.sameOff': '已关闭同工具交接。',
     'page.accounts': '账号',
     'page.tuning': '上下文调优',
     'tune.title': '上下文调优',

package/dist/src/panel/page-script.js

@@ -227,6 +227,8 @@ const MAIN = String.raw `
   // tooltip, a focused field, or a text selection in the account list.
   function uiBusy() {
     if (menu.el || (dlg.el && dlg.el.open) || document.querySelector('.tip.is-open')) return true
+    // A plan on the Auto Handoff page, and the change a person opened to read, stay as they are.
+    if (!$('handoff-page').hidden && (hp.preview || hp.askSame || document.querySelector('#handoff-page details[open]'))) return true
     const el = document.activeElement
     if (el && (el.tagName === 'INPUT' || el.tagName === 'TEXTAREA' || el.tagName === 'SELECT' || el.isContentEditable)) return true
     const sel = window.getSelection && window.getSelection()
@@ -575,6 +577,7 @@ const MAIN = String.raw `
       a.dir ? { icon: 'folder', label: t('menu.copyDir'), hint: a.dir, run: () => copyText(a.dir) } : null,
       a.identity && a.identity.email ? { icon: 'mail', label: t('menu.copyEmail'), hint: emailText(a.identity.email), run: () => copyText(a.identity.email) } : null,
       '-',
+      a.modelInfo && a.modelInfo.settable ? { icon: 'terminal', label: t('menu.model'), run: () => openModel(a) } : null,
       family(a.family).tuning ? { icon: 'check', label: t('menu.tune'), run: () => openTune(a) } : null,
       { icon: 'check', label: t('menu.check'), disabled: S.checking || S.fixing || Boolean(ui.checkingRef), run: () => checkAccount(a.ref) },
       BOOT.readOnly ? null : { icon: 'userPlus', label: t('menu.like'), run: () => openCreate({ family: a.family, api: a.kind === 'api' }) },
@@ -901,6 +904,7 @@ const MAIN = String.raw `
     return h('div', { class: 'ident-sub' }, dots([
       h('span', { class: 'mono' }, a.ref),
       a.kind === 'api' && a.model ? h('span', { class: 'mono', title: t('acct.model') }, a.model) : null,
+      a.kind !== 'api' ? modelChip(a) : null,
       a.kind !== 'api' && plan ? h('span', { class: 'plan' }, plan) : null,
     ]))
   }
@@ -1249,7 +1253,8 @@ const MAIN = String.raw `
   // What each card's size menu shows while the user is choosing, by group id; dropped once a change is made.
   const tuneSel = {}
   const tp = { data: null, loading: false, error: null, at: 0 }
-  let curPage = location.hash === '#tuning' ? 'tuning' : 'accounts'
+  function pageFromHash() { return location.hash === '#tuning' ? 'tuning' : location.hash === '#handoff' ? 'handoff' : 'accounts' }
+  let curPage = pageFromHash()
   function tuneSize(n) { return n === null || n === undefined ? t('tune.hostDefault') : tokens(n) }
   function tuneRedraw() {
     if (dlg.kind === 'tune') renderTune()
@@ -1442,25 +1447,37 @@ const MAIN = String.raw `
   function tuningAvailable() { return Boolean(S.state && S.state.families.some((f) => f.tuning)) }
   function setPage(next) {
     curPage = next
-    try { history.replaceState(null, '', next === 'tuning' ? '#tuning' : location.pathname + location.search) } catch {}
+    try { history.replaceState(null, '', next === 'accounts' ? location.pathname + location.search : '#' + next) } catch {}
     renderPageChrome()
   }
   // The page tabs, and which sections show; runs with every render, so a reload or a language switch keeps them.
   function renderPageChrome() {
     const nav = $('pages')
-    const can = tuningAvailable()
-    if (!can && curPage === 'tuning' && S.state) curPage = 'accounts'
-    nav.hidden = !can
-    const tabs = [['accounts', t('page.accounts')], ['tuning', t('page.tuning')]]
+    const canTune = tuningAvailable()
+    const canHandoff = Boolean(ahState())
+    if (S.state && ((curPage === 'tuning' && !canTune) || (curPage === 'handoff' && !canHandoff))) curPage = 'accounts'
+    const tabs = [['accounts', t('page.accounts')]]
+    if (canTune) tabs.push(['tuning', t('page.tuning')])
+    if (canHandoff) tabs.push(['handoff', t('page.handoff')])
+    nav.hidden = tabs.length < 2
     setKids(nav, h('div', { class: 'seg', role: 'presentation' }, tabs.map(([id, label]) =>
       h('button', { class: 'seg-btn', type: 'button', role: 'tab', 'aria-selected': curPage === id ? 'true' : 'false', onclick: () => setPage(id) }, label))))
-    const on = can && curPage === 'tuning'
-    for (const id of ['summary', 'accounts-page', 'checkup']) $(id).hidden = on
-    $('tuning-page').hidden = !on
-    if (on) {
+    const away = curPage !== 'accounts' && tabs.some(([id]) => id === curPage)
+    for (const id of ['summary', 'accounts-page', 'checkup']) $(id).hidden = away
+    const onTune = away && curPage === 'tuning'
+    const onHandoff = away && curPage === 'handoff'
+    $('tuning-page').hidden = !onTune
+    $('handoff-page').hidden = !onHandoff
+    if (onTune) {
       if (!tp.data && !tp.loading && !tp.error) loadTuningPage()
       else renderTuningPage()
     }
+    if (onHandoff) {
+      // A change made elsewhere (Advanced settings, the CLI) makes what the page loaded out of date.
+      const stale = hp.data && (hp.data.settings.auto !== ahState().settings.auto || hp.data.settings.sameFamily !== ahState().settings.sameFamily)
+      if ((!hp.data || stale) && !hp.loading && !hp.error) loadHandoffPage()
+      else renderHandoffPage()
+    }
   }
   async function loadTuningPage() {
     tp.loading = true
@@ -1491,7 +1508,7 @@ const MAIN = String.raw `
     }
     setKids(box, kids)
   }
-  window.addEventListener('hashchange', () => { curPage = location.hash === '#tuning' ? 'tuning' : 'accounts'; renderPageChrome() })
+  window.addEventListener('hashchange', () => { curPage = pageFromHash(); renderPageChrome() })
 
   // New account. The form is built once per opening so typing keeps focus; only its derived parts re-render.
   let nf = null
@@ -1964,6 +1981,303 @@ const MAIN = String.raw `
     if (ah.loading) loadHandoffStatus()
   }
 
+  // ---------- model and effort (spec §3.19) ----------
+  // Shown under the account name; the dialog changes what sideby starts this account with, never the Host's files.
+  let md = null
+  function modelFrom(a, from) { return t('md.from.' + from, { host: family(a.family).title }) }
+  function modelChip(a) {
+    const mi = a.modelInfo
+    if (!mi || (!mi.model && !mi.effort)) return null
+    const text = [mi.model && mi.model.value, mi.effort && mi.effort.value].filter(Boolean).join(' · ')
+    const title = [
+      mi.model ? t('md.model') + ': ' + mi.model.value + ' (' + modelFrom(a, mi.model.from) + ')' : null,
+      mi.effort ? t('md.effort') + ': ' + mi.effort.value + ' (' + modelFrom(a, mi.effort.from) + ')' : null,
+      mi.settable ? t('md.click') : null,
+    ].filter(Boolean).join('\n')
+    if (!mi.settable) return h('span', { class: 'mono', title }, text)
+    return h('button', { class: 'mono model-btn' + (mi.model && mi.model.from === 'sideby' ? ' model-set' : ''), type: 'button', title, 'aria-label': t('menu.model') + ' ' + a.ref + ': ' + text, onclick: (e) => { e.stopPropagation(); openModel(a) } }, text)
+  }
+  function mdAccount() { return S.state && S.state.accounts.find((x) => x.ref === md.ref) }
+  function openModel(a) {
+    md = { ref: a.ref, family: a.family, preview: null, busy: false, error: null, form: null }
+    showDialog('model')
+    renderModel()
+  }
+  // The inputs are built once per opening, so typing keeps focus; everything else re-renders around them.
+  function mdForm(a) {
+    if (md.form) return md.form
+    const mi = a.modelInfo
+    const host = family(a.family).title
+    const list = h('datalist', { id: 'md-models' }, mi.models.map((m) => h('option', { value: m })))
+    const model = h('input', { type: 'text', list: 'md-models', autocomplete: 'off', spellcheck: 'false', placeholder: t('md.default') + ' (' + t('md.decides', { host }) + ')', disabled: BOOT.readOnly })
+    model.value = mi.sideby.model || ''
+    const effort = h('select', { disabled: BOOT.readOnly }, h('option', { value: '' }, t('md.default') + ' (' + t('md.decides', { host }) + ')'), mi.efforts.map((e) => h('option', { value: e }, e)))
+    effort.value = mi.sideby.effort || ''
+    const changed = () => { md.preview = null; md.error = null; renderModel() }
+    model.addEventListener('input', () => { if (md.preview) changed() })
+    effort.addEventListener('change', changed)
+    md.form = { model, effort, list }
+    return md.form
+  }
+  function mdChange(a, reset) {
+    const mi = a.modelInfo
+    if (reset) return { model: mi.sideby.model ? null : undefined, effort: mi.sideby.effort ? null : undefined }
+    const f = md.form
+    const m = f.model.value.trim()
+    const ch = {}
+    if (m !== (mi.sideby.model || '')) ch.model = m || null
+    if (f.effort.value !== (mi.sideby.effort || '')) ch.effort = f.effort.value || null
+    return ch
+  }
+  async function mdReview(reset) {
+    const a = mdAccount()
+    if (!a) return
+    const change = mdChange(a, reset)
+    for (const k of Object.keys(change)) if (change[k] === undefined) delete change[k]
+    md.error = null
+    if (!Object.keys(change).length) { md.preview = { nothing: true }; renderModel(); return }
+    md.busy = true
+    renderModel()
+    try {
+      const r = await api('/api/account/model', Object.assign({ account: a.ref }, change))
+      md.preview = r.changed ? { change, diff: r.diff } : { nothing: true }
+    } catch (e) { md.error = e }
+    md.busy = false
+    renderModel()
+  }
+  async function mdApply() {
+    const a = mdAccount()
+    if (!a || !md.preview || !md.preview.change) return
+    md.busy = true
+    dlg.busy = true
+    renderModel()
+    try {
+      await api('/api/account/model', Object.assign({ account: a.ref, confirm: true }, md.preview.change))
+      dlg.busy = false
+      toast(t('md.saved', { ref: a.ref }))
+      dlg.el.close()
+      await load({ silent: true })
+      return
+    } catch (e) { md.error = e }
+    md.busy = false
+    dlg.busy = false
+    renderModel()
+  }
+  function renderModel() {
+    if (!md || dlg.kind !== 'model') return
+    const a = mdAccount()
+    if (!a || !a.modelInfo) { dlg.el.close(); return }
+    const mi = a.modelInfo
+    const host = family(a.family).title
+    const f = mdForm(a)
+    const now = (key) => mi[key] ? h('span', null, h('b', { class: 'mono' }, mi[key].value), ' ', h('span', { class: 'muted small' }, '(' + modelFrom(a, mi[key].from) + ')')) : h('span', { class: 'muted' }, t('md.none'))
+    const body = [h('p', { class: 'muted small' }, t('md.intro', { ref: a.ref, host }))]
+    if (BOOT.readOnly) body.push(h('p', { class: 'note' }, t('banner.readOnly')))
+    body.push(h('div', { class: 'md-now' },
+      h('div', null, h('span', { class: 'muted' }, t('md.model') + ': '), now('model')),
+      h('div', null, h('span', { class: 'muted' }, t('md.effort') + ': '), now('effort'))))
+    body.push(h('div', { class: 'ah-grid' },
+      h('label', { class: 'field' }, h('span', null, t('md.model')), f.model, f.list),
+      h('label', { class: 'field' }, h('span', null, t('md.effort')), f.effort)))
+    if (a.family === 'claude') body.push(h('p', { class: 'muted small' }, t('md.envNote')))
+    if (md.error) body.push(errorNote(md.error, null))
+    if (md.preview && md.preview.nothing) body.push(h('p', { class: 'muted small' }, t('md.nothing')))
+    if (md.preview && md.preview.diff) body.push(h('p', { class: 'small' }, t('md.changes')), diffView(md.preview.diff))
+    const foot = [h('button', { class: 'btn', type: 'button', disabled: md.busy, onclick: () => dlg.el.close() }, t('btn.close'))]
+    if (!BOOT.readOnly) {
+      if (mi.sideby.model || mi.sideby.effort) foot.push(h('button', { class: 'btn', type: 'button', disabled: md.busy, onclick: () => mdReview(true) }, t('md.reset')))
+      if (md.preview && md.preview.change) foot.push(h('button', { class: 'btn btn-primary', type: 'button', disabled: md.busy, 'aria-busy': md.busy ? 'true' : null, onclick: mdApply }, md.busy ? spinner() : null, t('md.apply')))
+      else foot.push(h('button', { class: 'btn btn-primary', type: 'button', disabled: md.busy, onclick: () => mdReview(false) }, md.busy ? spinner() : null, t('md.review')))
+    }
+    setKids(dlg.el, dialogFrame(t('md.title') + ' · ' + a.ref, a.family, body, foot))
+  }
+
+  // ---------- the Auto Handoff page ----------
+  // Off: one sentence and one button. On: where each account's work would go next, the last hand-overs and what is
+  // still missing. Turning on is one plan shown first (hp.preview) and one confirmation; no commands to copy.
+  const hp = { data: null, plan: null, loading: false, error: null, preview: null, previewing: false, applying: false, failed: null, changed: false, sameFamily: false, sameTouched: false, busyOff: false, askSame: false }
+  async function loadHandoffPage() {
+    hp.loading = true
+    hp.error = null
+    renderHandoffPage()
+    try {
+      // What is missing is only worth the check once it is on; while off the button shows the whole plan.
+      const [data, plan] = await Promise.all([api('/api/handoff/overview', {}), ahState().settings.auto ? api('/api/handoff/enable', {}) : Promise.resolve(null)])
+      hp.data = data
+      hp.plan = plan
+    } catch (e) { hp.error = e }
+    hp.loading = false
+    renderHandoffPage()
+  }
+  // Off, the box on this page decides; on, "finish setting up" keeps whatever is set.
+  function hpBody() { return ahState().settings.auto ? {} : { sameFamily: hp.sameFamily } }
+  async function hpPreview() {
+    hp.previewing = true
+    hp.failed = null
+    hp.changed = false
+    renderHandoffPage()
+    try { hp.preview = await api('/api/handoff/enable', hpBody()) } catch (e) { hp.failed = { error: e } }
+    hp.previewing = false
+    renderHandoffPage()
+  }
+  async function hpApply() {
+    hp.applying = true
+    hp.failed = null
+    renderHandoffPage()
+    try {
+      const r = await api('/api/handoff/enable', Object.assign(hpBody(), { confirm: true, expect: hp.preview && hp.preview.key }))
+      const bad = r.results.find((x) => !x.ok)
+      // A plan that changed since it was shown is shown again; one with nothing left to do means it is already on.
+      hp.changed = Boolean(r.changed) && !r.plan.alreadyOn
+      if (hp.changed || r.plan.blocked) hp.preview = r.plan
+      else if (bad) hp.failed = { step: bad, plan: r.plan }
+      else { hp.preview = null; toast(t('toast.ahOn')) }
+      await load({ silent: true })
+      await loadHandoffPage()
+    } catch (e) { hp.failed = { error: e } }
+    hp.applying = false
+    renderHandoffPage()
+  }
+  async function hpChange(change, message) {
+    hp.busyOff = true
+    renderHandoffPage()
+    try {
+      await api('/api/handoff/configure', { change, confirm: true })
+      hp.preview = null
+      hp.askSame = false
+      toast(message)
+      await load({ silent: true })
+      await loadHandoffPage()
+    } catch (e) { hp.failed = { error: e } }
+    hp.busyOff = false
+    renderHandoffPage()
+  }
+  function hpStepTitle(step) {
+    const host = step.family ? family(step.family).title : ''
+    return t('hp.step.' + step.id, { host, accounts: (step.accounts || []).join(', ') })
+  }
+  function hpSteps(plan) {
+    return h('ul', { class: 'hp-steps' }, plan.steps.map((step) => h('li', null, h('div', null,
+      h('div', null, hpStepTitle(step)),
+      step.diff ? h('details', { class: 'small' }, h('summary', null, t('hp.showChange')), h('p', { class: 'muted small' }, tx('ah.changes', { file: h('code', null, step.file) })), diffView(step.diff)) : null))))
+  }
+  function hpManual(plan) {
+    return plan.manual.map((m) => h('p', { class: 'note' }, m.id === 'codex-trust' ? t('hp.manual.codexTrust') : (family(m.family).title + ': ' + (m.message || ''))))
+  }
+  function hpPreviewCard() {
+    const p = hp.preview
+    const kids = [h('h3', { class: 'small' }, t('hp.willDo'))]
+    if (hp.changed) kids.push(h('p', { class: 'note note-warn', role: 'status' }, t('hp.planChanged')))
+    if (p.blocked) kids.push(h('p', { class: 'note note-fail' }, t('hp.blocked', { why: p.blocked })), codeCopy('npm i -g sideby'))
+    else {
+      kids.push(hpSteps(p), ...hpManual(p))
+      kids.push(p.sameFamily ? h('p', { class: 'note note-warn' }, t('ah.sameFamilyWarn')) : h('p', { class: 'muted small' }, t('hp.sameFamilyOffNote')))
+    }
+    const foot = [h('button', { class: 'btn', type: 'button', disabled: hp.applying, onclick: () => { hp.preview = null; hp.failed = null; hp.changed = false; renderHandoffPage() } }, t('btn.cancel'))]
+    if (!p.blocked) foot.push(h('button', { class: 'btn btn-primary', type: 'button', disabled: hp.applying, 'aria-busy': hp.applying ? 'true' : null, onclick: hpApply }, hp.applying ? spinner() : null, hp.applying ? t('hp.applying') : t('hp.confirmOn')))
+    kids.push(h('div', { class: 'row-actions' }, foot))
+    return h('div', { class: 'ah-fam' }, kids)
+  }
+  function hpFailed() {
+    const f = hp.failed
+    if (!f) return null
+    if (f.error) return errorNote(f.error, null)
+    return h('p', { class: 'note note-fail', role: 'alert' }, t('hp.stepFailed', { step: hpStepTitle(f.step), why: f.step.message || '' }) + ' ' + t('hp.tryAgain'))
+  }
+  function hpDecision(d, starts) {
+    const thr = ahState().settings.threshold
+    if (d.kind === 'pick') return starts.includes('quota') ? t('hp.goesTo', { to: accountLabel(d.ref), p: thr }) : t('hp.goesToLimit', { to: accountLabel(d.ref) })
+    if (d.kind === 'wait') return t('hp.waits', { at: clock(d.until) })
+    return d.earliestReset ? t('hp.noneBack', { ref: accountLabel(d.earliestReset.ref), at: clock(d.earliestReset.at) }) : t('hp.none')
+  }
+  // The one case where reaching the threshold does not switch (spec §3.17 "选号" 1); none when waiting is off.
+  function hpWaitRule(st) {
+    const w = st.settings.waitIfResetWithinMinutes
+    return w > 0 ? ' ' + t('hp.waitRule', { w }) : null
+  }
+  function hpRows(d) {
+    if (!d.takeover.length) return h('p', { class: 'muted small' }, t('hp.noAccounts'))
+    return h('ul', { class: 'hp-rows' }, d.takeover.map((r) => {
+      const a = S.state.accounts.find((x) => x.ref === r.ref)
+      const p = a ? quotaPressure(a, Date.now()) : -1
+      return h('li', null,
+        h('span', { class: 'title-logo' }, badge(r.family, 'sm'), h('b', { class: 'mono' }, accountLabel(r.ref))),
+        h('span', { class: 'muted' }, p >= 0 ? t('hp.used', { p: Math.round(p) }) : t('hp.noQuota')),
+        h('span', null, hpDecision(r.decision, r.starts)))
+    }))
+  }
+  function hpRecent(d) {
+    if (!d.recent.length) return h('p', { class: 'muted small' }, t('hp.noneYet'))
+    return h('ul', { class: 'hp-rows' }, d.recent.map((r) => h('li', null,
+      h('span', { class: 'mono' }, accountLabel(r.from) + ' → ' + accountLabel(r.to)),
+      h('span', { class: 'muted' }, clock(r.at) + ' · ' + ago(r.at)),
+      h('span', { class: 'muted' }, r.trigger ? t('hp.why.' + r.trigger) : ''))))
+  }
+  function hpSameFamilyBox(checked, onchange) {
+    const input = h('input', { type: 'checkbox', disabled: BOOT.readOnly || hp.busyOff || hp.applying })
+    input.checked = checked
+    input.addEventListener('change', () => onchange(input.checked))
+    return h('div', { class: 'check-row' }, h('label', { class: 'check' }, input, h('span', null, h('b', null, t('hp.sameFamily')), h('span', { class: 'muted small' }, t('ah.sameFamilyWarn')))))
+  }
+  function renderHandoffPage() {
+    const box = $('handoff-page')
+    if (box.hidden || !S.state) return
+    const st = ahState()
+    if (!st) return
+    const kids = [h('div', { class: 'section-head' },
+      h('h2', { id: 'h-handoff' }, t('hp.title')),
+      h('div', { class: 'row-actions' },
+        h('button', { class: 'btn btn-sm', type: 'button', onclick: openHandoff }, t('hp.advanced')),
+        h('button', { class: 'btn btn-sm', type: 'button', disabled: hp.loading, onclick: loadHandoffPage }, hp.loading ? spinner() : icon('refresh'), t('top.refresh'))))]
+    const on = st.settings.auto
+    if (hp.loading && !hp.data) kids.push(h('p', { class: 'muted' }, spinner(), ' ', t('hp.loading')))
+    if (hp.error) kids.push(errorNote(hp.error, loadHandoffPage))
+    if (BOOT.readOnly) kids.push(h('p', { class: 'note' }, t('banner.readOnly')))
+    if (!on) {
+      kids.push(h('p', null, t('hp.intro')))
+      kids.push(h('ol', { class: 'hp-how' }, h('li', null, t('hp.how1')), h('li', null, t('hp.how2', { p: st.settings.threshold }), hpWaitRule(st)), h('li', null, t('hp.how3', { s: st.settings.countdownSeconds }))))
+      if (!S.state.accounts.some((a) => a.kind !== 'api' && st.starters.includes(a.family))) kids.push(h('p', { class: 'note' }, t('hp.noStarters')))
+      else {
+        if (!hp.preview) {
+          // Until the person touches the box it shows what is set now, so turning on again keeps an earlier choice.
+          if (!hp.sameTouched) hp.sameFamily = st.settings.sameFamily
+          kids.push(hpSameFamilyBox(hp.sameFamily, (v) => { hp.sameFamily = v; hp.sameTouched = true }))
+          kids.push(h('div', { class: 'row-actions' }, h('button', { class: 'btn btn-primary', type: 'button', disabled: BOOT.readOnly || hp.previewing, 'aria-busy': hp.previewing ? 'true' : null, onclick: hpPreview }, hp.previewing ? spinner() : null, t('hp.turnOn'))))
+        } else kids.push(hpPreviewCard())
+      }
+    } else {
+      kids.push(h('p', null, h('span', { class: 'chip chip-ok' }, t('ah.on')), ' ', t('hp.onNote', { p: st.settings.threshold }), hpWaitRule(st)))
+      const d = hp.data
+      if (d) {
+        kids.push(h('h3', { class: 'small' }, t('hp.takeover')), hpRows(d))
+        kids.push(h('h3', { class: 'small' }, t('hp.recent')), hpRecent(d))
+      }
+      const plan = hp.plan
+      if (plan && (plan.blocked || plan.steps.length)) {
+        kids.push(h('h3', { class: 'small' }, t('hp.missing')))
+        if (!hp.preview) {
+          if (plan.blocked) kids.push(h('p', { class: 'note note-fail' }, t('hp.blocked', { why: plan.blocked })), codeCopy('npm i -g sideby'))
+          else {
+            kids.push(hpSteps(plan))
+            kids.push(h('div', { class: 'row-actions' }, h('button', { class: 'btn btn-primary', type: 'button', disabled: BOOT.readOnly || hp.previewing, onclick: hpPreview }, hp.previewing ? spinner() : null, t('hp.complete'))))
+          }
+        } else kids.push(hpPreviewCard())
+      } else if (plan) kids.push(...hpManual(plan))
+      kids.push(h('p', { class: 'muted small' }, t('hp.onlySideby')))
+      kids.push(hpSameFamilyBox(st.settings.sameFamily, (v) => {
+        if (v) { hp.askSame = true; renderHandoffPage() } else { hp.askSame = false; hpChange({ sameFamily: false }, t('hp.sameOff')) }
+      }))
+      if (hp.askSame && !st.settings.sameFamily) kids.push(h('div', { class: 'ah-fam' },
+        h('p', { class: 'note note-warn' }, t('ah.sameFamilyWarn')),
+        h('div', { class: 'row-actions' },
+          h('button', { class: 'btn', type: 'button', disabled: hp.busyOff, onclick: () => { hp.askSame = false; renderHandoffPage() } }, t('btn.cancel')),
+          h('button', { class: 'btn btn-primary', type: 'button', disabled: BOOT.readOnly || hp.busyOff, onclick: () => { hp.askSame = false; hpChange({ sameFamily: true }, t('hp.sameOn')) } }, t('hp.sameConfirm')))))
+      kids.push(h('div', { class: 'row-actions' }, h('button', { class: 'btn', type: 'button', disabled: BOOT.readOnly || hp.busyOff, onclick: () => hpChange({ auto: false }, t('toast.ahOff')) }, hp.busyOff ? spinner() : null, t('hp.turnOff'))))
+    }
+    kids.push(hpFailed())
+    setKids(box, kids)
+  }
+
   // ---------- banners ----------
   function renderBanners() {
     const out = []
@@ -1976,7 +2290,7 @@ const MAIN = String.raw `
       if (hint) out.push(h('div', { class: 'banner', role: 'status' },
         h('div', null, t('ah.hint', { ref: hint.ref, p: hint.pressure })),
         h('div', { class: 'banner-actions' },
-          h('button', { class: 'btn btn-sm btn-primary', type: 'button', onclick: openHandoff }, t('ah.setUp')),
+          h('button', { class: 'btn btn-sm btn-primary', type: 'button', onclick: () => setPage('handoff') }, t('ah.setUp')),
           h('button', { class: 'btn btn-sm', type: 'button', onclick: () => { prefs.ahHintAt = Date.now(); savePrefs(); renderBanners() } }, t('ah.dismiss')))))
       const errs = S.state.pluginErrors
       if (errs.length) out.push(h('div', { class: 'banner banner-warn', role: 'status' }, h('div', null,
@@ -2061,7 +2375,7 @@ const MAIN = String.raw `
   // ---------- start ----------
   $('ver').textContent = BOOT.version ? 'v' + BOOT.version : ''
   $('refresh').addEventListener('click', () => load({ check: true, announce: true }))
-  $('handoff').addEventListener('click', openHandoff)
+  $('handoff').addEventListener('click', () => setPage('handoff'))
   $('lang').addEventListener('click', () => {
     if (LANG_FIXED) return
     lang = lang === 'zh' ? 'en' : 'zh'
@@ -2073,6 +2387,7 @@ const MAIN = String.raw `
     if (dlg.kind === 'create' && nf && !nf.creating) renderCreate()
     else if (dlg.kind === 'setup' && qs) renderSetup()
     else if (dlg.kind === 'tune' && tuneState) renderTune()
+    else if (dlg.kind === 'model' && md) { md.form = null; renderModel() }
   })
   $('theme').addEventListener('click', () => {
     const order = CHOICES.theme