sideby 0.4.1 → 0.4.3

package/dist/build.json

@@ -1 +1 @@
-{"id":"20261013T093231-6fb759"}
+{"id":"20261014T033619-9eb027"}

package/dist/src/cli/format.js

@@ -93,7 +93,7 @@ export function tuningLines(t) {
         return [t.reason === 'no-source' ? 'no public source for this host' : (t.detail ?? t.reason)];
     return t.models.map((m) => {
         const now = m.configured === null ? 'Host default' : `${compactNumber(m.configured)}`;
-        const head = `${m.model}  ${m.calls} calls  now ${now}  ${m.compactions.total} compactions`;
+        const head = `${m.model}  ${m.calls} calls  now ${now}  ${m.compactions.total} compactions${m.compactions.idle ? ` (${m.compactions.idle} after idle)` : ''}`;
         if (m.suggestion) {
             const saved = m.suggestion.savedPercent === null
                 ? ''

package/dist/src/cli/json-schemas.js

@@ -115,6 +115,9 @@ const TuningModel = Type.Object({
         }),
         auto: Type.Number(),
         manual: Type.Number(),
+        idle: Type.Number({
+            description: 'Automatic compactions Claude Code did after the conversation sat idle; the size setting does not control them.',
+        }),
         preTokensP50: Type.Union([Type.Number(), Type.Null()]),
         preTokensMax: Type.Union([Type.Number(), Type.Null()]),
     }),

package/dist/src/core/tuning.d.ts

@@ -13,6 +13,20 @@ export declare const WEIGHT: {
  */
 export declare const MIN_COMPACT_WINDOW = 100000;
 export declare const MAX_COMPACT_WINDOW = 1000000;
+/**
+ * Claude Code compacts a conversation on its own when it has sat idle for about 90% of the one-hour prompt cache
+ * and holds at least 200K tokens (read from Claude Code 2.1.296 and matched against real logs: 30 of 31 automatic
+ * compactions came after 54-55 minutes of silence and none was smaller than 202K). `autoCompactWindow` does not
+ * control it. A compaction after this much silence is recorded as `idle`.
+ */
+export declare const IDLE_AFTER_MS: number;
+export declare const IDLE_MIN_CTX = 200000;
+/**
+ * How long a silence must be to call a logged compaction `idle`. Deliberately a little below `IDLE_AFTER_MS`, since the log
+ * only has the timestamp of the last message. Replaying with 45, 50 or 54 minutes gave the same simulated counts on real
+ * logs, so the difference does not matter; why the replay finds fewer idle compactions than were logged is not this.
+ */
+export declare const IDLE_OBSERVED_MS: number;
 /** A model with fewer turns than this in the window gets no suggestion. */
 export declare const MIN_CALLS = 200;
 /** Candidate thresholds as a share of the model's context window. */
@@ -30,6 +44,8 @@ export interface Turn {
 export interface Compaction {
     ts: number;
     trigger: 'auto' | 'manual' | 'unknown';
+    /** Claude Code did it by itself after the conversation sat idle (not because a size was reached). */
+    idle?: boolean;
     pre: number;
     post: number;
 }
@@ -42,6 +58,8 @@ export interface ModelRecords {
     /** Where the Host compacts when nothing is set (documented), or null when that is not known. */
     defaultThreshold?: number | null;
 }
+/** Weighted cost of the sessions at a threshold. Exported for the tests of the engine. */
+export declare function replay(sessions: Turn[][], threshold: number, post: number, idle: boolean): number;
 export interface SummarizeOptions {
     /** The Account's configured threshold in tokens; null is the Host default. */
     configured: number | null;

package/dist/src/core/tuning.js

@@ -6,6 +6,20 @@ export const WEIGHT = { input: 1, cacheRead: 0.1, write5m: 1.25, write1h: 2, out
  */
 export const MIN_COMPACT_WINDOW = 100_000;
 export const MAX_COMPACT_WINDOW = 1_000_000;
+/**
+ * Claude Code compacts a conversation on its own when it has sat idle for about 90% of the one-hour prompt cache
+ * and holds at least 200K tokens (read from Claude Code 2.1.296 and matched against real logs: 30 of 31 automatic
+ * compactions came after 54-55 minutes of silence and none was smaller than 202K). `autoCompactWindow` does not
+ * control it. A compaction after this much silence is recorded as `idle`.
+ */
+export const IDLE_AFTER_MS = 54 * 60_000;
+export const IDLE_MIN_CTX = 200_000;
+/**
+ * How long a silence must be to call a logged compaction `idle`. Deliberately a little below `IDLE_AFTER_MS`, since the log
+ * only has the timestamp of the last message. Replaying with 45, 50 or 54 minutes gave the same simulated counts on real
+ * logs, so the difference does not matter; why the replay finds fewer idle compactions than were logged is not this.
+ */
+export const IDLE_OBSERVED_MS = 50 * 60_000;
 /** A model with fewer turns than this in the window gets no suggestion. */
 export const MIN_CALLS = 200;
 /** Candidate thresholds as a share of the model's context window. */
@@ -26,7 +40,7 @@ function writeWeight(t) {
     return n > 0 ? (t.write5m * WEIGHT.write5m + t.write1h * WEIGHT.write1h) / n : WEIGHT.write5m;
 }
 /** Weighted cost of one session's turns if the Host compacted whenever the context reached `threshold`. */
-function replaySession(turns, threshold, post) {
+function replaySession(turns, threshold, post, idle) {
     const first = turns[0];
     if (!first)
         return 0;
@@ -47,7 +61,9 @@ function replaySession(turns, threshold, post) {
             continue;
         const d = t.ctx - prev.ctx;
         const g = d >= 0 ? d : usual;
-        if (ctx + g >= threshold) {
+        // Long silence with a big context: Claude Code compacts by itself, whatever the threshold is.
+        const lapsed = idle && t.ts - prev.ts >= IDLE_AFTER_MS && ctx >= IDLE_MIN_CTX;
+        if (lapsed || ctx + g >= threshold) {
             // The whole context goes in as input, a summary of about `post` tokens comes out, and the next turn
             // writes that summary to the cache again.
             cost += ctx * WEIGHT.input + post * WEIGHT.output + post * WEIGHT.write5m;
@@ -61,10 +77,11 @@ function replaySession(turns, threshold, post) {
     }
     return cost;
 }
-function replay(sessions, threshold, post) {
+/** Weighted cost of the sessions at a threshold. Exported for the tests of the engine. */
+export function replay(sessions, threshold, post, idle) {
     let total = 0;
     for (const s of sessions)
-        total += replaySession(s, threshold, post);
+        total += replaySession(s, threshold, post, idle);
     return total;
 }
 const roundTokens = (n) => Math.round(n / 1000) * 1000;
@@ -73,14 +90,21 @@ export function summarizeModel(rec, o) {
     const auto = rec.compactions.filter((c) => c.trigger === 'auto');
     const pre = rec.compactions.map((c) => c.pre).filter((n) => n > 0);
     const posts = rec.compactions.map((c) => c.post).filter((n) => n > 0);
-    const autoPre = auto.map((c) => c.pre).filter((n) => n > 0);
-    // What is in effect: the configured size, else what the Host did, else where it compacts by default.
+    // Threshold-triggered compactions only: the idle ones say nothing about the size Claude Code was set to.
+    const autoPre = auto
+        .filter((c) => !c.idle)
+        .map((c) => c.pre)
+        .filter((n) => n > 0);
+    const idleCount = auto.filter((c) => c.idle).length;
+    // Replay idle compaction too once the records show Claude Code doing it for this Account.
+    const idleMode = idleCount > 0;
+    // What is in effect: the configured size, else where Claude Code compacts by default, else what it did.
     // A size outside 100K-1M is not one Claude Code runs with (the documentation does not say what it does with it),
     // so it is not taken as the baseline.
     const usable = o.configured !== null && o.configured >= MIN_COMPACT_WINDOW && o.configured <= MAX_COMPACT_WINDOW;
     const effective = usable && o.configured !== null
         ? Math.min(o.configured, rec.contextWindow)
-        : (median(autoPre) ?? rec.defaultThreshold ?? null);
+        : (rec.defaultThreshold ?? median(autoPre));
     const base = {
         model: rec.model,
         calls,
@@ -91,6 +115,7 @@ export function summarizeModel(rec, o) {
             total: rec.compactions.length,
             auto: auto.length,
             manual: rec.compactions.filter((c) => c.trigger === 'manual').length,
+            idle: idleCount,
             preTokensP50: pre.length ? Math.round(median(pre)) : null,
             preTokensMax: pre.length ? Math.max(...pre) : null,
         },
@@ -118,7 +143,7 @@ export function summarizeModel(rec, o) {
         return stop('no-optimum');
     let best = null;
     for (const threshold of sizes) {
-        const cost = replay(rec.sessions, threshold, post);
+        const cost = replay(rec.sessions, threshold, post, idleMode);
         // On a tie the larger threshold wins: fewer compactions for the same cost.
         if (!best || cost < best.cost || (cost === best.cost && threshold > best.threshold))
             best = { threshold, cost };
@@ -132,7 +157,7 @@ export function summarizeModel(rec, o) {
             reason: 'suggested',
             suggestion: { threshold: best.threshold, savedPercent: null, savedWeighted: null },
         };
-    const current = replay(rec.sessions, effective, post);
+    const current = replay(rec.sessions, effective, post, idleMode);
     const saved = current - best.cost;
     const percent = current > 0 ? (saved / current) * 100 : 0;
     if (percent < MIN_SAVING_PERCENT)

package/dist/src/families/claude/tuning.d.ts

@@ -4,8 +4,8 @@ import type { Account, ReadContext, TuningResult } from '../../types.ts';
 export declare const isKnownClaudeModel: (id: string) => boolean;
 /** `[key, ts, session, model, ctx, out, write5m, write1h]` */
 type TurnRow = [string, number, string, string, number, number, number, number];
-/** `[ts, session, model, trigger, pre, post]` */
-type CompactionRow = [number, string, string, string, number, number];
+/** `[ts, session, model, trigger, pre, post, silentMs]`; `silentMs` is how long the session was quiet before it (-1 unknown). */
+type CompactionRow = [number, string, string, string, number, number, number];
 /** What one session log contributes: only what the replay needs, never message text. */
 interface Summary {
     lines: number;

package/dist/src/families/claude/tuning.js

@@ -7,7 +7,7 @@ import { join } from 'node:path';
 import { createInterface } from 'node:readline';
 import { FileMemo } from '../../core/file-memo.js';
 import { USAGE_DAYS } from '../../core/quota-levels.js';
-import { getOrCreate, tuningResult, } from '../../core/tuning.js';
+import { getOrCreate, IDLE_OBSERVED_MS, tuningResult, } from '../../core/tuning.js';
 import { listJsonl } from './usage.js';
 const DAY_MS = 86_400_000;
 const SETTINGS_MAX_BYTES = 1_000_000;
@@ -27,6 +27,8 @@ async function parseFile(file, since) {
     const lastModel = new Map();
     // Compactions logged before the first assistant row of their session in this file: they take that row's model.
     const orphans = new Map();
+    // When each session last spoke, to tell a compaction that came after a long silence from one a size triggered.
+    const lastSpoke = new Map();
     try {
         const rl = createInterface({ input: createReadStream(file), crlfDelay: Number.POSITIVE_INFINITY });
         for await (const line of rl) {
@@ -50,6 +52,7 @@ async function parseFile(file, since) {
                 if (!Number.isFinite(ts) || ts < since || !pre || !post)
                     continue;
                 const t = m?.trigger;
+                const before = lastSpoke.get(session);
                 const entry = [
                     ts,
                     session,
@@ -57,12 +60,19 @@ async function parseFile(file, since) {
                     t === 'auto' || t === 'manual' ? t : 'unknown',
                     pre,
                     post,
+                    before === undefined ? -1 : ts - before,
                 ];
                 out.compactions.push(entry);
+                // The compaction itself is activity: a second one right after it did not follow a silence of its own.
+                lastSpoke.set(session, ts);
                 if (!entry[2])
                     orphans.set(session, [...(orphans.get(session) ?? []), entry]);
                 continue;
             }
+            if ((row?.type === 'assistant' || row?.type === 'user') &&
+                row.isSidechain !== true &&
+                Number.isFinite(ts))
+                lastSpoke.set(session, ts);
             if (row?.type !== 'assistant' || row.isSidechain === true)
                 continue;
             const usage = row.message?.usage;
@@ -101,7 +111,7 @@ async function parseFile(file, since) {
     return out;
 }
 /** Per-file summaries per Account directory; a file is parsed again only after it changed. */
-export const claudeTuningMemo = new FileMemo({ name: 'claude-tuning', version: 2 });
+export const claudeTuningMemo = new FileMemo({ name: 'claude-tuning', version: 3 });
 /** The Account's configured Compaction Threshold, or null for the Host default. Reads exactly one key. */
 export async function readAutoCompactWindow(dir) {
     try {
@@ -163,7 +173,7 @@ export async function readClaudeTuning(account, ctx) {
     const sessionModel = new Map();
     for (const t of [...turns.values()].sort((x, y) => x[1] - y[1]))
         sessionModel.set(t[2], t[3]);
-    const resolved = compactions.map((c) => (c[2] ? c : [c[0], c[1], sessionModel.get(c[1]) ?? '', c[3], c[4], c[5]]));
+    const resolved = compactions.map((c) => (c[2] ? c : [c[0], c[1], sessionModel.get(c[1]) ?? '', c[3], c[4], c[5], c[6]]));
     // Group per model, then per session; a session that switched models is replayed once per model.
     const byModel = new Map();
     for (const [, ts, session, model, c, out, w5, w1] of turns.values()) {
@@ -185,7 +195,13 @@ export async function readClaudeTuning(account, ctx) {
         const maxCtx = Math.max(0, ...list.flat().map((t) => t.ctx));
         const comps = resolved
             .filter((c) => c[2] === model && c[0] >= since && c[0] <= now)
-            .map((c) => ({ ts: c[0], trigger: c[3], pre: c[4], post: c[5] }));
+            .map((c) => ({
+            ts: c[0],
+            trigger: c[3],
+            pre: c[4],
+            post: c[5],
+            idle: c[3] === 'auto' && c[6] >= IDLE_OBSERVED_MS,
+        }));
         const native = NATIVE_1M.test(model);
         // Elsewhere the window comes from the records: a context past 200K means the model runs with 1M.
         const window = native

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

@@ -253,6 +253,7 @@ declare const en: {
     'tune.basis': string;
     'tune.outOfRange': string;
     'tune.overrides': string;
+    'tune.idle': string;
     'tune.groupNone': string;
     'tune.details': string;
     'tune.detailsObserved': string;

package/dist/src/panel/i18n.js

@@ -255,6 +255,7 @@ const en = {
     'tune.basis': 'Based on {model} on {ref}, the one used most.',
     'tune.outOfRange': 'The size now in the file ({size}) is outside what Claude Code accepts (100K to 1M). Pick Default or a size from the menu to replace it.',
     'tune.overrides': 'These models save a size of their own (set with /autocompact), which wins over this one: {list}',
+    'tune.idle': '{n} of its {total} compactions came after the conversation sat idle for about an hour. Claude Code does that by itself, and this size does not change it.',
     '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)',
@@ -636,6 +637,7 @@ const zh = {
     'tune.basis': '按用得最多的 {model}（{ref}）来定。',
     'tune.outOfRange': '文件里现在的大小（{size}）超出了 Claude Code 接受的范围（100K 到 1M）。请选「默认」或菜单里的某个大小来替换它。',
     'tune.overrides': '这些模型自己保存了一个大小（用 /autocompact 设的），对它们来说那个优先于这里的设置：{list}',
+    'tune.idle': '它的 {total} 次压缩里有 {n} 次是对话安静了大约一小时之后发生的。这是 Claude Code 自己做的，这个大小改不了它。',
     'tune.groupNone': '用得还不够多，暂时给不出建议值。你仍然可以在下面自己选一个。',
     'tune.details': '各账号的详情',
     'tune.detailsObserved': '只做观测（没有可以改的设置）',

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

@@ -894,7 +894,7 @@ const MAIN = String.raw `
     if (!id || (!id.email && !id.org)) return null
     const email = id.email ? emailText(id.email) : ''
     return h('div', { class: 'ident-email', title: [email, id.org].filter(Boolean).join(' · ') },
-      dots([email ? h('span', { class: 'email' }, email) : null, id.org ? h('span', { class: 'org' }, id.org) : null]))
+      dots([email ? h('button', { class: 'email email-btn', type: 'button', title: t('menu.copyEmail'), 'aria-label': t('menu.copyEmail') + ' ' + email, onclick: (e) => { e.stopPropagation(); copyText(id.email) } }, email) : null, id.org ? h('span', { class: 'org' }, id.org) : null]))
   }
   function subLine(a) {
     const plan = a.quota && a.quota.status === 'ok' && a.quota.plan
@@ -1347,7 +1347,11 @@ const MAIN = String.raw `
       pick ? h('div', null, h('span', { class: 'muted small' }, t('tune.best')), h('div', { class: 'tune-num tune-best' }, tokens(pick.threshold))) : null))
     if (pick && pick.savedPercent !== null) rows.push(h('p', { class: 'small' }, t('tune.saved', { n: Math.round(pick.savedPercent) })))
     if (pick) rows.push(h('p', { class: 'muted small' }, t('tune.basis', { model: pick.model, ref: pick.ref })))
-    else {
+    if (pick) {
+      const seen = entries.find((e) => e.ref === pick.ref)
+      const stats = seen && seen.tuning.status === 'ok' ? seen.tuning.models.find((m) => m.model === pick.model) : null
+      if (stats && stats.compactions.idle > 0) rows.push(h('p', { class: 'muted small' }, t('tune.idle', { n: stats.compactions.idle, total: stats.compactions.total })))
+    } else {
       // Say why there is no suggestion: when a model is already at its cheapest, that is the news, not "not enough use".
       const why = entries.flatMap((e) => (e.tuning.status === 'ok' ? e.tuning.models : [])).some((m) => m.reason === 'already-best') ? t('tune.reason.already-best') : t('tune.groupNone')
       rows.push(h('p', { class: 'note' }, why))
@@ -1376,6 +1380,7 @@ const MAIN = String.raw `
       m.suggestion ? h('div', null, h('span', { class: 'muted small' }, t('tune.best')), h('div', { class: 'small' }, tokens(m.suggestion.threshold))) : null))
     if (!m.suggestion) rows.push(h('p', { class: 'muted small' }, t('tune.reason.' + m.reason, { min: minCalls })))
     rows.push(h('p', { class: 'muted small' }, m.compactions.total ? tn('tune.compactions', m.compactions.total, { size: tokens(m.compactions.preTokensP50 || 0) }) : t('tune.noCompactions')))
+    if (m.compactions.idle > 0) rows.push(h('p', { class: 'muted small' }, t('tune.idle', { n: m.compactions.idle, total: m.compactions.total })))
     return h('div', { class: 'tune-detail' }, rows)
   }
   function tuneDetails(entries, minCalls, label) {

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

@@ -167,6 +167,9 @@ code, .mono { font-family: var(--mono); font-size: 0.92em; }
 .ident-name { display: flex; align-items: center; gap: 6px; min-width: 0; flex-wrap: wrap; row-gap: 3px; }
 .ident-name .name { font-weight: var(--strong-weight); font-size: var(--font-size); overflow: hidden; text-overflow: ellipsis; white-space: nowrap; max-width: 100%; }
 .ident-email { color: var(--muted); font-size: 12px; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; margin-top: 1px; }
+.email-btn { all: unset; cursor: pointer; border-radius: 4px; }
+.email-btn:hover { color: var(--text); text-decoration: underline dotted; }
+.email-btn:focus-visible { outline: var(--focus-outline); outline-offset: 2px; }
 .ident-email + .ident-sub { color: var(--faint); margin-top: 0; }
 .tools .tb-icon { width: var(--ctl-h); height: var(--ctl-h); border-color: var(--border-strong); background: var(--surface); }
 .tools .tb-icon:hover { background: var(--hover); }

package/dist/src/types.d.ts

@@ -261,6 +261,8 @@ export interface TuningModel {
         total: number;
         auto: number;
         manual: number;
+        /** Automatic compactions Claude Code did after the conversation sat idle; the size setting does not control them. */
+        idle: number;
         preTokensP50: number | null;
         preTokensMax: number | null;
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sideby",
-  "version": "0.4.1",
+  "version": "0.4.3",
   "description": "Run work, personal and API-key accounts at the same time, without their configs drifting apart.",
   "license": "MIT",
   "author": "Adonis0123 (https://github.com/Adonis0123)",

package/schemas/tune.json

@@ -100,6 +100,7 @@
                             "total",
                             "auto",
                             "manual",
+                            "idle",
                             "preTokensP50",
                             "preTokensMax"
                           ],
@@ -114,6 +115,10 @@
                             "manual": {
                               "type": "number"
                             },
+                            "idle": {
+                              "type": "number",
+                              "description": "Automatic compactions Claude Code did after the conversation sat idle; the size setting does not control them."
+                            },
                             "preTokensP50": {
                               "anyOf": [
                                 {

package/skills/sideby/SKILL.md

@@ -2,7 +2,7 @@
 name: sideby
 description: Use when the user runs, or wants to run, several AI coding accounts (Claude Code, Codex, Grok Build, pi) side by side. Covers installing sideby and setting up a new account ("install sideby", "set up another Claude account", "add cc008", "配置一个 cc00x", "再加一个 Codex 账号"), explaining what accounts share and what stays separate ("what do my accounts share?", "这些账号共享了什么"), showing which account a session is ("show [cc001] in the status line", "加上账号标识"), seeing accounts, quota and usage, moving on when one hits its 5-hour or weekly limit, adding a short command (alias), and repairing drifted account directories (skills, hooks, rules or settings not shared, wrong symlinks, credential file permissions). Drives the `sideby` CLI with `--json`; the agent does every step except browser sign-in, filling in secrets and starting interactive sessions, which it hands to the user as one command.
 metadata:
-  version: "0.4.1"
+  version: "0.4.3"
   requires:
     bins: [sideby, node]
   cliHelp: sideby --help