sideby 0.2.2 → 0.4.0

package/dist/src/panel/i18n.js

@@ -89,6 +89,12 @@ const en = {
     'need.quota-high.other': '{n} near limit',
     'need.health-warn.one': '{n} with warnings',
     'need.health-warn.other': '{n} with warnings',
+    'why.error': 'unreadable',
+    'why.health-fail': 'Health check found issues',
+    'why.signed-out': 'signed out',
+    'why.not-installed': 'tool not installed',
+    'why.quota-high': '{label} at {pct}% (warns from {warn}%)',
+    'why.health-warn': 'Health check has warnings',
     'tb.search': 'Search accounts',
     'tb.searchPh': 'Search name, alias, email, model…',
     'tb.family': 'Filter by tool',
@@ -119,6 +125,7 @@ const en = {
     'group.toggle': '{title} ({count}): {action}',
     'group.attention.one': '{n} needs attention',
     'group.attention.other': '{n} need attention',
+    'group.attentionShow': 'Show {name}',
     'acct.alias': 'Alias',
     'acct.aliasArgs': 'Alias, starts this account with {args}',
     'acct.api': 'API',
@@ -132,6 +139,7 @@ const en = {
     'acct.notInstalled': 'Tool missing',
     'acct.readError': 'Could not read this account.',
     'acct.installHost': '{host} is not installed on this machine. {link}',
+    'acct.nearLimit': '{label} quota is {pct}% used; warnings start at {warn}%.',
     'acct.installIt': 'Install it',
     'quota.pctUsed': '{n}% used',
     'quota.pctLeft': '{n}% left',
@@ -226,6 +234,55 @@ const en = {
     'menu.copyEmail': 'Copy email',
     'menu.check': 'Check this account',
     'menu.like': 'New account like this',
+    'menu.tune': 'Context tuning',
+    'page.accounts': 'Accounts',
+    'page.tuning': 'Context tuning',
+    'tune.title': 'Context tuning',
+    'tune.intro': 'Looks at how you used this over the last {days} days and estimates what auto-compact size would use the fewest tokens. It is only an estimate, and nothing changes until you press Use.',
+    'tune.loading': 'Working it out from your recent sessions…',
+    'tune.none': 'No sessions to look at yet for this account.',
+    'tune.noSource': 'There is nothing to estimate from for this tool.',
+    'tune.unreadable': 'The session records could not be read.',
+    'tune.calls': '{n} calls',
+    'tune.now': 'Now',
+    'tune.hostDefault': 'Default',
+    'tune.best': 'Suggested',
+    'tune.saved': 'Expected to use about {n}% fewer tokens (an estimate).',
+    'tune.compactions.one': 'It compacted once, when the conversation reached about {size}.',
+    'tune.compactions.other': 'It compacted {n} times, usually when the conversation reached about {size}.',
+    'tune.noCompactions': 'It did not compact in this period.',
+    'tune.groupShared': 'One setting for these accounts, because they share a settings file: {list}',
+    'tune.basis': 'Based on {model} on {ref}, the one used most.',
+    'tune.groupNone': 'Not used enough to suggest a size yet. You can still pick one below.',
+    'tune.details': 'Details for each account',
+    'tune.detailsObserved': 'Only observed (there is no setting to change)',
+    'tune.use': 'Use {size}',
+    'tune.setting': 'Auto-compact size',
+    'tune.hostDefaultLong': 'Default (Claude Code decides)',
+    'tune.suggestedTag': 'suggested',
+    'tune.useThis': 'Use this',
+    'tune.working': 'One moment…',
+    'tune.confirmTitle': 'This will change:',
+    'tune.change': 'Auto-compact size',
+    'tune.file': 'File',
+    'tune.willCreate': '(will be created)',
+    'tune.shared': 'This file is shared, so this changes all of: {list}',
+    'tune.newSessions': 'Only new sessions use it; sessions already running are not affected. You can undo it any time.',
+    'tune.confirm': 'Yes, use it',
+    'tune.done': 'Done: set to {size}. New sessions use it.',
+    'tune.already': 'It is already set to {size}; nothing to change.',
+    'tune.applied': 'sideby set this for you (it was {prev} before).',
+    'tune.undo': 'Undo',
+    'tune.undone': 'Undone. New sessions go back to how it was.',
+    'tune.reason.already-best': 'The current setting is already about the cheapest we can estimate for how you work.',
+    'tune.reason.insufficient-calls': 'Not enough use in this period to estimate (needs {min} calls).',
+    'tune.reason.no-compactions': 'It has not compacted in this period, so there is nothing to estimate from.',
+    'tune.reason.no-optimum': 'No clear best value: the cheapest point is outside the range we tried.',
+    'tune.reason.unknown-model': 'This is not a Claude model, so sideby cannot estimate it.',
+    'tune.reason.observe-only': 'For Codex sideby only shows what happened; it cannot suggest a value yet.',
+    'tpage.title': 'Context tuning',
+    'tpage.none': 'No account has been used enough to estimate yet.',
+    'tpage.idle': 'No use in this period: {list}',
     'nf.title': 'New account',
     'nf.intro': 'It runs next to your existing accounts and shares their skills and settings.',
     'nf.tool': 'Tool',
@@ -266,6 +323,45 @@ const en = {
     'nf.aliasNotAdded': 'Short command not added.',
     'nf.shellFileUpdated': 'Updated {file}.',
     'nf.shellFileSame': '{file} is up to date.',
+    'ah.button': 'Auto Handoff',
+    'ah.on': 'On',
+    'ah.off': 'Off',
+    'ah.title': 'Auto Handoff',
+    'ah.intro': 'When a session that sideby started runs low on quota, it writes a handoff brief, sideby ends it, and the next account carries on in the same terminal. Off by default.',
+    'ah.auto': 'Hand over when quota runs low',
+    'ah.sameFamily': 'Also hand over between accounts of the same tool',
+    'ah.sameFamilyWarn': 'Moving work between subscriptions of one vendor to get past a limit may break its terms; the risk is yours.',
+    'ah.prepareAt': 'Start the brief at (%)',
+    'ah.threshold': 'Hand over at (%)',
+    'ah.wait': 'Wait if it resets within (min)',
+    'ah.countdown': 'Countdown before switching (s)',
+    'ah.badLevels': 'Start the brief below the hand-over level.',
+    'ah.order': '{host} hands over to',
+    'ah.byQuota': 'Most quota left',
+    'ah.myOrder': 'My order',
+    'ah.byQuotaHint': 'Its own accounts with the most quota left (when same-tool hand-over is on), then API accounts.',
+    'ah.add': 'Add account',
+    'ah.up': 'Move up',
+    'ah.down': 'Move down',
+    'ah.remove': 'Remove',
+    'ah.emptyOrder': 'Add at least one account, or switch back to most quota left.',
+    'ah.readiness': 'On this machine',
+    'ah.checking': 'Checking…',
+    'ah.ready': 'Ready',
+    'ah.notYet': 'Not ready',
+    'ah.takesOver': 'Takes over only',
+    'ah.steps': 'Still to do, in a terminal:',
+    'ah.review': 'Review change',
+    'ah.apply': 'Apply',
+    'ah.applying': 'Applying…',
+    'ah.nothing': 'Nothing to change.',
+    'ah.saved': 'Saved to {file}.',
+    'ah.changes': 'This changes {file}:',
+    'ah.hint': '{ref} is at {p}% of its quota. Sessions can hand their task to another account by themselves when quota runs low.',
+    'ah.setUp': 'Set up',
+    'ah.dismiss': 'Not now',
+    'toast.ahOn': 'Auto Handoff is on for sessions you start with sideby.',
+    'toast.ahOff': 'Auto Handoff is off.',
     'qs.title': 'Turn on {host} quota',
     'qs.preparing': 'Preparing the change…',
     'qs.changes': 'This changes {file}:',
@@ -372,6 +468,12 @@ const zh = {
     'need.quota-high.other': '{n} 个接近上限',
     'need.health-warn.one': '{n} 个有警告',
     'need.health-warn.other': '{n} 个有警告',
+    'why.error': '读取失败',
+    'why.health-fail': '体检发现问题',
+    'why.signed-out': '未登录',
+    'why.not-installed': '缺少工具',
+    'why.quota-high': '{label} 已用 {pct}%（{warn}% 起提醒）',
+    'why.health-warn': '体检有警告',
     'tb.search': '搜索账号',
     'tb.searchPh': '搜索名称、别名、邮箱、模型…',
     'tb.family': '按工具筛选',
@@ -402,6 +504,7 @@ const zh = {
     'group.toggle': '{title}（{count}）：{action}',
     'group.attention.one': '{n} 个需要处理',
     'group.attention.other': '{n} 个需要处理',
+    'group.attentionShow': '定位到 {name}',
     'acct.alias': '别名',
     'acct.aliasArgs': '别名，启动这个账号并附加 {args}',
     'acct.api': 'API',
@@ -415,6 +518,7 @@ const zh = {
     'acct.notInstalled': '未安装工具',
     'acct.readError': '无法读取这个账号。',
     'acct.installHost': '本机没有安装 {host}。{link}',
+    'acct.nearLimit': '{label} 额度已用 {pct}%，达到 {warn}% 就会提醒。',
     'acct.installIt': '去安装',
     'quota.pctUsed': '已用 {n}%',
     'quota.pctLeft': '剩余 {n}%',
@@ -509,6 +613,55 @@ const zh = {
     'menu.copyEmail': '复制邮箱',
     'menu.check': '检查这个账号',
     'menu.like': '照此新建账号',
+    'menu.tune': '上下文调优',
+    'page.accounts': '账号',
+    'page.tuning': '上下文调优',
+    'tune.title': '上下文调优',
+    'tune.intro': '看看你最近 {days} 天的用法，估算「自动压缩」设成多少最省 token。这只是估算；你点「使用」之前，sideby 不会改任何设置。',
+    'tune.loading': '正在根据你最近的会话计算…',
+    'tune.none': '这个账号还没有可以参考的会话。',
+    'tune.noSource': '这个工具没有可以参考的记录。',
+    'tune.unreadable': '会话记录读不出来。',
+    'tune.calls': '{n} 次调用',
+    'tune.now': '现在',
+    'tune.hostDefault': '默认',
+    'tune.best': '建议',
+    'tune.saved': '预计能少用约 {n}% 的 token（估算）。',
+    'tune.compactions.one': '最近自动压缩了 1 次，在对话长到约 {size} 时触发。',
+    'tune.compactions.other': '最近自动压缩了 {n} 次，通常在对话长到约 {size} 时触发。',
+    'tune.noCompactions': '这段时间没有压缩过。',
+    'tune.groupShared': '这些账号共用一个设置文件，所以用同一个设置：{list}',
+    'tune.basis': '按用得最多的 {model}（{ref}）来定。',
+    'tune.groupNone': '用得还不够多，暂时给不出建议值。你仍然可以在下面自己选一个。',
+    'tune.details': '各账号的详情',
+    'tune.detailsObserved': '只做观测（没有可以改的设置）',
+    'tune.use': '使用 {size}',
+    'tune.setting': '自动压缩大小',
+    'tune.hostDefaultLong': '默认（由 Claude Code 自己决定）',
+    'tune.suggestedTag': '建议',
+    'tune.useThis': '使用这个',
+    'tune.working': '稍等…',
+    'tune.confirmTitle': '将会修改：',
+    'tune.change': '自动压缩大小',
+    'tune.file': '文件',
+    'tune.willCreate': '（会新建）',
+    'tune.shared': '这个文件是几个账号共用的，所以这会同时改变：{list}',
+    'tune.newSessions': '只有新开的会话会用上，已经在运行的不受影响。随时可以撤销。',
+    'tune.confirm': '确认使用',
+    'tune.done': '已设置为 {size}，新开的会话生效。',
+    'tune.already': '已经是 {size}，不用改。',
+    'tune.applied': '这是 sideby 帮你设的（原来是{prev}）。',
+    'tune.undo': '撤销',
+    'tune.undone': '已撤销，新开的会话恢复成原来的样子。',
+    'tune.reason.already-best': '按你的用法，现在的设置已经差不多是我们能估算出的最省了。',
+    'tune.reason.insufficient-calls': '这段时间用得太少，估不准（至少要 {min} 次）。',
+    'tune.reason.no-compactions': '这段时间还没压缩过，没有可以参考的数据。',
+    'tune.reason.no-optimum': '没有明确的最佳值：最省的点在我们试的范围之外。',
+    'tune.reason.unknown-model': '这不是 Claude 的模型，sideby 没法估算。',
+    'tune.reason.observe-only': 'Codex 目前只能看到发生了什么，还不能给建议值。',
+    'tpage.title': '上下文调优',
+    'tpage.none': '还没有账号用得够多，没法估算。',
+    'tpage.idle': '这段时间没有使用：{list}',
     'nf.title': '新建账号',
     'nf.intro': '新账号和现有账号并排运行，共享它们的 skills 和设置。',
     'nf.tool': '工具',
@@ -549,6 +702,45 @@ const zh = {
     'nf.aliasNotAdded': '短命令没有添加。',
     'nf.shellFileUpdated': '已更新 {file}。',
     'nf.shellFileSame': '{file} 已是最新。',
+    'ah.button': '自动交接',
+    'ah.on': '开',
+    'ah.off': '关',
+    'ah.title': '自动交接',
+    'ah.intro': 'sideby 启动的会话额度快用完时，会写好交接说明，sideby 结束它，下一个账号在同一个终端里接着做。默认关闭。',
+    'ah.auto': '额度快用完时自动交接',
+    'ah.sameFamily': '也允许同一工具的账号之间接力',
+    'ah.sameFamilyWarn': '同一家厂商的多个订阅之间接力来绕过限额，可能违反厂商条款，风险由你承担。',
+    'ah.prepareAt': '开始写交接说明（%）',
+    'ah.threshold': '交接阈值（%）',
+    'ah.wait': '这么多分钟内重置就等待',
+    'ah.countdown': '交接前倒计时（秒）',
+    'ah.badLevels': '开始写说明的比例要低于交接阈值。',
+    'ah.order': '{host} 交给',
+    'ah.byQuota': '剩余额度最多的',
+    'ah.myOrder': '按我的顺序',
+    'ah.byQuotaHint': '先选同一工具里剩余额度最多的账号（需打开同工具接力），再选 API 账号。',
+    'ah.add': '添加账号',
+    'ah.up': '上移',
+    'ah.down': '下移',
+    'ah.remove': '移除',
+    'ah.emptyOrder': '至少添加一个账号，或改回“剩余额度最多的”。',
+    'ah.readiness': '本机状态',
+    'ah.checking': '正在检查…',
+    'ah.ready': '已就绪',
+    'ah.notYet': '未就绪',
+    'ah.takesOver': '只能接手',
+    'ah.steps': '还要在终端里做：',
+    'ah.review': '查看改动',
+    'ah.apply': '应用',
+    'ah.applying': '正在应用…',
+    'ah.nothing': '没有要改的。',
+    'ah.saved': '已保存到 {file}。',
+    'ah.changes': '将修改 {file}：',
+    'ah.hint': '{ref} 的额度已用 {p}%。会话可以在额度快用完时，自己把任务交给另一个账号。',
+    'ah.setUp': '去设置',
+    'ah.dismiss': '暂不',
+    'toast.ahOn': '自动交接已开启，对用 sideby 启动的会话生效。',
+    'toast.ahOff': '自动交接已关闭。',
     'qs.title': '开启 {host} 额度显示',
     'qs.preparing': '正在准备改动…',
     'qs.changes': '将修改 {file}：',

package/dist/src/panel/page-logic.d.ts

@@ -71,6 +71,18 @@ export declare function attentionReasons(a: LogicAccount, health: {
     fail: number;
     warn: number;
 } | null, now: number, warn: number): string[];
+/**
+ * The most serious reason an Account needs a look, as a message key and its values for the Panel to show where the
+ * attention count is: `why.<reason>`; for `quota-high` the fullest live window at or over `warn`, with its label and
+ * rounded percentage. Null when all is well.
+ */
+export declare function attentionWhy(a: LogicAccount, health: {
+    fail: number;
+    warn: number;
+} | null, now: number, warn: number): {
+    key: string;
+    vars: Record<string, string | number>;
+} | null;
 /** Sorted copy: `pressure` (fullest Quota first), `name`, or `recent` (last activity first). The Main Account leads ties. */
 export declare function sortAccounts<T extends LogicAccount>(list: T[], mode: string, now: number): T[];
 /**
@@ -152,3 +164,40 @@ export declare function updatedAge(ms: number): {
  * language (`zh*` gives Chinese, anything else English).
  */
 export declare function panelLang(host: string, saved: string, browser: string): string;
+/**
+ * The Account that makes the Panel's Auto Handoff hint worth showing (spec §3.17): Auto Handoff is off and a
+ * subscription Account of a Family that can start a Handoff is at or above the threshold. The fullest wins.
+ */
+export declare function handoffHintAccount(accounts: readonly LogicAccount[], settings: {
+    auto: boolean;
+    threshold: number;
+}, starters: readonly string[], now: number): {
+    ref: string;
+    pressure: number;
+} | null;
+export interface HandoffSettingsView {
+    auto: boolean;
+    sameFamily: boolean;
+    prepareAt: number;
+    threshold: number;
+    waitIfResetWithinMinutes: number;
+    countdownSeconds: number;
+    families: Record<string, {
+        policy: string;
+        order: string[];
+    }>;
+}
+export interface HandoffForm {
+    auto: boolean;
+    sameFamily: boolean;
+    prepareAt: number;
+    threshold: number;
+    wait: number;
+    countdown: number;
+    orders: Record<string, {
+        policy: string;
+        order: string[];
+    }>;
+}
+/** What the Panel's Auto Handoff form changed, as the `change` /api/handoff/configure takes; {} when nothing. */
+export declare function handoffChangeOf(s: HandoffSettingsView, f: HandoffForm): Record<string, unknown>;

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

@@ -82,6 +82,28 @@ export function attentionReasons(a, health, now, warn) {
         out.push('health-warn');
     return out;
 }
+/**
+ * The most serious reason an Account needs a look, as a message key and its values for the Panel to show where the
+ * attention count is: `why.<reason>`; for `quota-high` the fullest live window at or over `warn`, with its label and
+ * rounded percentage. Null when all is well.
+ */
+export function attentionWhy(a, health, now, warn) {
+    const reason = attentionReasons(a, health, now, warn)[0];
+    if (!reason)
+        return null;
+    if (reason !== 'quota-high')
+        return { key: `why.${reason}`, vars: {} };
+    let top = null;
+    for (const w of a.quota?.windows ?? []) {
+        const reset = Date.parse(w.resetsAt);
+        if (Number.isFinite(reset) && reset <= now)
+            continue;
+        const pct = Number(w.usedPercent) || 0;
+        if (pct >= warn && (!top || pct > top.pct))
+            top = { label: w.label, pct };
+    }
+    return { key: 'why.quota-high', vars: { label: top?.label ?? '', pct: Math.round(top?.pct ?? 0), warn } };
+}
 /** Sorted copy: `pressure` (fullest Quota first), `name`, or `recent` (last activity first). The Main Account leads ties. */
 export function sortAccounts(list, mode, now) {
     const byName = (x, y) => Number(Boolean(y.isMain)) - Number(Boolean(x.isMain)) ||
@@ -324,3 +346,48 @@ export function panelLang(host, saved, browser) {
         return saved;
     return /^zh/i.test(browser || '') ? 'zh' : 'en';
 }
+/**
+ * The Account that makes the Panel's Auto Handoff hint worth showing (spec §3.17): Auto Handoff is off and a
+ * subscription Account of a Family that can start a Handoff is at or above the threshold. The fullest wins.
+ */
+export function handoffHintAccount(accounts, settings, starters, now) {
+    if (settings.auto)
+        return null;
+    let best = null;
+    for (const a of accounts) {
+        if (a.kind === 'api' || !starters.includes(a.family))
+            continue;
+        const p = quotaPressure(a, now);
+        if (p >= settings.threshold && (!best || p > best.pressure))
+            best = { ref: a.ref, pressure: Math.round(p) };
+    }
+    return best;
+}
+/** What the Panel's Auto Handoff form changed, as the `change` /api/handoff/configure takes; {} when nothing. */
+export function handoffChangeOf(s, f) {
+    const c = {};
+    if (f.auto !== s.auto)
+        c.auto = f.auto;
+    if (f.sameFamily !== s.sameFamily)
+        c.sameFamily = f.sameFamily;
+    if (f.prepareAt !== s.prepareAt)
+        c.prepareAt = f.prepareAt;
+    if (f.threshold !== s.threshold)
+        c.threshold = f.threshold;
+    if (f.wait !== s.waitIfResetWithinMinutes)
+        c.waitIfResetWithinMinutes = f.wait;
+    if (f.countdown !== s.countdownSeconds)
+        c.countdownSeconds = f.countdown;
+    const orders = [];
+    for (const family of Object.keys(f.orders)) {
+        const o = f.orders[family];
+        const cur = s.families[family];
+        const want = o.policy === 'order' ? o.order : [];
+        const have = cur && cur.policy === 'order' ? cur.order : [];
+        if (want.join('\n') !== have.join('\n'))
+            orders.push({ family, order: want.slice() });
+    }
+    if (orders.length)
+        c.orders = orders;
+    return c;
+}