sideby 0.6.0 → 0.8.0

package/dist/src/core/same-login.js

@@ -0,0 +1,52 @@
+/**
+ * Families whose Identity tells one Quota apart. Codex is left out: its Identity is an email only, and one email can
+ * belong to several ChatGPT workspaces, each with its own Quota (ADR-0016).
+ */
+export const SAME_LOGIN_FAMILIES = new Set(['claude']);
+const norm = (s) => s?.trim().toLowerCase();
+/**
+ * Whether two Accounts are the same login: same Family (one that groups), both subscriptions, the same email, and the
+ * same organization (both have one and it is equal, or neither has one). Without an email nothing groups.
+ */
+export function isSameLogin(a, b) {
+    if (a.ref === b.ref || a.family !== b.family || !SAME_LOGIN_FAMILIES.has(a.family))
+        return false;
+    if (a.kind !== 'subscription' || b.kind !== 'subscription')
+        return false;
+    const ea = norm(a.identity?.email);
+    if (!ea || ea !== norm(b.identity?.email))
+        return false;
+    return norm(a.identity?.org) === norm(b.identity?.org);
+}
+/** Ref → the other refs of its Same Login, in the order given; Accounts without one are left out. */
+export function sameLoginGroups(members) {
+    const out = new Map();
+    for (const a of members) {
+        const peers = members.filter((b) => isSameLogin(a, b)).map((b) => b.ref);
+        if (peers.length)
+            out.set(a.ref, peers);
+    }
+    return out;
+}
+/**
+ * The Quota an Account of a Same Login shows: the freshest `ok` reading of the group (its own wins a tie), marked
+ * with `from` when it is another member's. Without any `ok` reading the Account keeps its own result.
+ */
+export function sharedQuota(ref, readings, peers) {
+    const own = readings.get(ref) ?? { status: 'unavailable', reason: 'unrecognized' };
+    let best;
+    for (const r of [ref, ...peers]) {
+        const q = readings.get(r);
+        if (q?.status !== 'ok')
+            continue;
+        const t = Date.parse(q.observedAt);
+        if (!Number.isFinite(t))
+            continue;
+        if (!best || t > best.t)
+            best = { ref: r, q, t };
+    }
+    if (!best || best.ref === ref)
+        return own;
+    const { from: _from, ...reading } = best.q;
+    return { ...reading, from: best.ref };
+}

package/dist/src/core/tuning-apply.js

@@ -32,7 +32,7 @@ function render(obj, original) {
 }
 async function readObject(file) {
     const st = await stat(file).catch(() => null);
-    if (!st || !st.isFile())
+    if (!st?.isFile())
         return { error: 'it is not a regular file' };
     if (st.size > MAX_BYTES)
         return { error: 'it is too large to be a settings file' };

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

@@ -0,0 +1,6 @@
+import type { DesktopAppDef } from '../desktop.ts';
+/**
+ * Claude Desktop (spec §3.20). Its Code tab honours CLAUDE_CONFIG_DIR; the data folder moves only with
+ * `--user-data-dir` (signed builds ignore CLAUDE_USER_DATA_DIR).
+ */
+export declare const claudeDesktop: DesktopAppDef;

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

@@ -0,0 +1,28 @@
+/**
+ * Claude Desktop (spec §3.20). Its Code tab honours CLAUDE_CONFIG_DIR; the data folder moves only with
+ * `--user-data-dir` (signed builds ignore CLAUDE_USER_DATA_DIR).
+ */
+export const claudeDesktop = {
+    family: 'claude',
+    title: 'Claude Desktop',
+    bundleId: 'com.anthropic.claudefordesktop',
+    bundleNames: ['Claude.app'],
+    installUrl: 'https://claude.ai/download',
+    openArgs: (app, dir, appData) => [
+        '-n',
+        '-a',
+        app,
+        '--env',
+        `CLAUDE_CONFIG_DIR=${dir}`,
+        '--args',
+        `--user-data-dir=${appData}`,
+    ],
+    clearVars: ['CLAUDE_USER_DATA_DIR'],
+    signInInApp: true,
+    sharedFiles: [
+        {
+            path: 'claude_desktop_config.json',
+            mainPath: 'Library/Application Support/Claude/claude_desktop_config.json',
+        },
+    ],
+};

package/dist/src/families/codex/desktop.d.ts

@@ -0,0 +1,7 @@
+import type { DesktopAppDef } from '../desktop.ts';
+/**
+ * The Codex app (`ChatGPT.app`, spec §3.20). It shares the Account's terminal sign-in through CODEX_HOME. Its own
+ * code replaces the path `--user-data-dir` sets, so CODEX_ELECTRON_USER_DATA_PATH goes along (the app's "Codex Demo"
+ * recipe); both are internal to the app and may change.
+ */
+export declare const codexDesktop: DesktopAppDef;

package/dist/src/families/codex/desktop.js

@@ -0,0 +1,25 @@
+/**
+ * The Codex app (`ChatGPT.app`, spec §3.20). It shares the Account's terminal sign-in through CODEX_HOME. Its own
+ * code replaces the path `--user-data-dir` sets, so CODEX_ELECTRON_USER_DATA_PATH goes along (the app's "Codex Demo"
+ * recipe); both are internal to the app and may change.
+ */
+export const codexDesktop = {
+    family: 'codex',
+    title: 'Codex app',
+    bundleId: 'com.openai.codex',
+    bundleNames: ['ChatGPT.app', 'Codex.app'],
+    installUrl: 'https://openai.com/codex/',
+    openArgs: (app, dir, appData) => [
+        '-n',
+        '--env',
+        `CODEX_HOME=${dir}`,
+        '--env',
+        `CODEX_ELECTRON_USER_DATA_PATH=${appData}`,
+        app,
+        '--args',
+        `--user-data-dir=${appData}`,
+    ],
+    clearVars: ['CODEX_ELECTRON_USER_DATA_PATH'],
+    signInInApp: false,
+    sharedFiles: [],
+};

package/dist/src/families/desktop.d.ts

@@ -0,0 +1,27 @@
+export interface DesktopAppDef {
+    /** The Family id. */
+    family: string;
+    /** How messages name the app, for example `Claude Desktop`. */
+    title: string;
+    /** `CFBundleIdentifier` in the app's Info.plist. */
+    bundleId: string;
+    /** Bundle names to look for first in /Applications and ~/Applications. */
+    bundleNames: readonly string[];
+    installUrl: string;
+    /**
+     * `open` arguments for a non-main Account: a new instance (`-n`) with the Account's selecting variable and
+     * App Data. `app` is the bundle path, `dir` the Account directory.
+     */
+    openArgs(app: string, dir: string, appData: string): string[];
+    /** Inherited variables cleared before `open`, besides the Family's Hijack Variables and selecting variable. */
+    clearVars: readonly string[];
+    /** The first sign-in happens inside the app, through a URL callback another running instance may catch. */
+    signInInApp: boolean;
+    /** Files of the App Data shared from the Main Account's default App Data as links (`mainPath` relative to HOME). */
+    sharedFiles: readonly {
+        path: string;
+        mainPath: string;
+    }[];
+}
+/** The Desktop App of a built-in Family id, if it has one. */
+export declare function desktopDef(familyId: string): DesktopAppDef | undefined;

package/dist/src/families/desktop.js

@@ -0,0 +1,9 @@
+// Desktop Apps of the built-in Families (spec §3.20, ADR-0015). Internal on purpose: not part of the public
+// FamilyDef, so plugin Families cannot declare one in v1.
+import { claudeDesktop } from './claude/desktop.js';
+import { codexDesktop } from './codex/desktop.js';
+const DESKTOP_APPS = new Map([claudeDesktop, codexDesktop].map((d) => [d.family, d]));
+/** The Desktop App of a built-in Family id, if it has one. */
+export function desktopDef(familyId) {
+    return DESKTOP_APPS.get(familyId);
+}

package/dist/src/panel/handler.js

@@ -2,6 +2,7 @@
 import { randomBytes, timingSafeEqual } from 'node:crypto';
 import { aliasesByAccount } from '../core/accounts.js';
 import { aliasArgs, aliasRefs } from '../core/config.js';
+import { openDesktopApp, withDesktopApps } from '../core/desktop-app.js';
 import { UserError } from '../core/errors.js';
 import { planHandoff } from '../core/handoff.js';
 import { applyHandoffEnable, planHandoffEnable } from '../core/handoff-enable.js';
@@ -43,7 +44,10 @@ export function handoffByFamily(rt, accounts, now) {
     const out = {};
     for (const [id, f] of rt.families) {
         const list = accounts.filter((a) => a.family === id);
-        if (!f.readQuota || list.filter((a) => a.kind === 'subscription').length < 2)
+        // Count logins, not directories: a Same Login group (spec §3.21) is one Quota, so it alone is no alternative.
+        const subs = list.filter((a) => a.kind === 'subscription');
+        const logins = subs.filter((a, i) => !subs.slice(0, i).some((b) => a.sameLogin?.includes(b.ref))).length;
+        if (!f.readQuota || logins < 2)
             continue;
         const plan = planHandoff(id, list.map((a) => ({
             ref: a.ref,
@@ -203,10 +207,11 @@ async function buildState(rt, opts) {
     ]);
     const health = healthByAccount(history);
     const aliases = aliasesByAccount(aliasRefs(rt.config.aliases), accounts);
-    const list = await Promise.all(accounts.map(async (a) => {
-        const st = await accountState(rt, a, families);
-        const h = health.get(a.ref);
-        const names = aliases.get(a.ref);
+    // Desktop Apps (spec §3.20): one process listing for every Account, run alongside the per-Account reads.
+    const states = await withDesktopApps(rt, accounts, Promise.all(accounts.map((a) => accountState(rt, a, families))));
+    const list = states.map((st) => {
+        const h = health.get(st.ref);
+        const names = aliases.get(st.ref);
         const withArgs = (names ?? [])
             .map((n) => [n, aliasArgs(rt.config.aliases?.[n])])
             .filter(([, args]) => args.length);
@@ -216,7 +221,7 @@ async function buildState(rt, opts) {
             ...(names ? { aliases: names } : {}),
             ...(withArgs.length ? { aliasArgs: Object.fromEntries(withArgs) } : {}),
         };
-    }));
+    });
     const handoff = handoffByFamily(rt, list, ctx.now);
     return {
         schemaVersion: 1,
@@ -434,6 +439,23 @@ export function createPanelHandler(opts) {
                 return { ref: found.ref, ...r, file: tildify(r.file, rt.paths.home) };
             },
         },
+        // Opens the Account's Desktop App, or brings its window to the front (spec §3.20). It creates the Account's
+        // app data folder and starts a program, so a read-only Panel refuses it (writes defaults to true).
+        '/api/account/desktop': {
+            async run(body) {
+                const account = optString(body, 'account');
+                if (!account)
+                    throw new HttpError(400, '"account" is required');
+                const rt = await getRuntime();
+                const r = await openDesktopApp(rt, account);
+                const home = rt.paths.home;
+                return {
+                    ...r,
+                    appPath: tildify(r.appPath, home),
+                    ...(r.appData ? { appData: tildify(r.appData, home) } : {}),
+                };
+            },
+        },
         // The Auto Handoff page (spec §3.17): where work would go next and the last hand-overs. Reads only.
         '/api/handoff/overview': {
             writes: () => false,

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

@@ -134,6 +134,8 @@ declare const en: {
     'acct.next': string;
     'acct.nextHint': string;
     'acct.nextLabel': string;
+    'acct.sameLogin': string;
+    'acct.sameLoginHint': string;
     'acct.notInstalled': string;
     'acct.readError': string;
     'acct.installHost': string;
@@ -148,6 +150,7 @@ declare const en: {
     'quota.resetNoData': string;
     'quota.dataFrom': string;
     'quota.asOf': string;
+    'quota.sharedFrom': string;
     'quota.noWindows': string;
     'quota.off': string;
     'quota.turnOnFamily': string;
@@ -234,6 +237,14 @@ declare const en: {
     'menu.like': string;
     'menu.tune': string;
     'menu.model': string;
+    'desk.open': string;
+    'desk.show': string;
+    'desk.opening': string;
+    'desk.openHint': string;
+    'desk.showHint': string;
+    'desk.started': string;
+    'desk.focused': string;
+    'desk.failed': string;
     'md.title': string;
     'md.intro': string;
     'md.model': string;

package/dist/src/panel/i18n.js

@@ -136,6 +136,8 @@ const en = {
     'acct.next': 'Next',
     'acct.nextHint': 'The account to move on to when this family runs low: most quota left. Click to copy `sideby next {family}`.',
     'acct.nextLabel': '{ref} is next: copy `sideby next {family}`',
+    'acct.sameLogin': 'Same login as {names}',
+    'acct.sameLoginHint': 'Signed in as the same login as {names}. The vendor counts one quota for all of them, so they show the same quota and a handoff never moves between them.',
     'acct.notInstalled': 'Tool missing',
     'acct.readError': 'Could not read this account.',
     'acct.installHost': '{host} is not installed on this machine. {link}',
@@ -150,6 +152,7 @@ const en = {
     'quota.resetNoData': 'Window reset · no new data since {date}',
     'quota.dataFrom': 'Data from {ago}',
     'quota.asOf': 'As of {ago}',
+    'quota.sharedFrom': 'Same login as {name}; quota read from {name}, {ago}',
     'quota.noWindows': 'No quota windows reported.',
     'quota.off': 'Quota not on',
     'quota.turnOnFamily': 'Turn on quota',
@@ -236,6 +239,14 @@ const en = {
     'menu.like': 'New account like this',
     'menu.tune': 'Context tuning',
     'menu.model': 'Model and effort…',
+    'desk.open': 'Open desktop app',
+    'desk.show': 'Desktop app open',
+    'desk.opening': 'Opening {app}…',
+    'desk.openHint': 'Open {app} as {ref}, in its own window next to your other accounts',
+    'desk.showHint': '{app} is open as {ref}; click to bring it to the front',
+    'desk.started': 'Opened {app} as {ref}.',
+    'desk.focused': '{app} for {ref} is in front.',
+    'desk.failed': 'Could not open the desktop app for {ref}: {msg}',
     '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',
@@ -585,6 +596,8 @@ const zh = {
     'acct.next': '下一个',
     'acct.nextHint': '这个家族额度用完时换到这里：剩余额度最多。点击复制 `sideby next {family}`。',
     'acct.nextLabel': '{ref} 是下一个：复制 `sideby next {family}`',
+    'acct.sameLogin': '与 {names} 同一登录',
+    'acct.sameLoginHint': '与 {names} 用同一个身份登录。供应商只算一份额度，所以它们显示同一份额度，交接也不会在它们之间进行。',
     'acct.notInstalled': '未安装工具',
     'acct.readError': '无法读取这个账号。',
     'acct.installHost': '本机没有安装 {host}。{link}',
@@ -599,6 +612,7 @@ const zh = {
     'quota.resetNoData': '已重置，{date}后无新数据',
     'quota.dataFrom': '数据来自 {ago}',
     'quota.asOf': '截至 {ago}',
+    'quota.sharedFrom': '与 {name} 同一登录；额度读自 {name}，{ago}',
     'quota.noWindows': '没有额度窗口数据。',
     'quota.off': '额度未开启',
     'quota.turnOnFamily': '开启额度显示',
@@ -685,6 +699,14 @@ const zh = {
     'menu.like': '照此新建账号',
     'menu.tune': '上下文调优',
     'menu.model': '模型和 effort…',
+    'desk.open': '打开桌面应用',
+    'desk.show': '桌面应用已打开',
+    'desk.opening': '正在打开 {app}…',
+    'desk.openHint': '以 {ref} 打开 {app}，和其他账号的窗口同时开着',
+    'desk.showHint': '{app} 已经以 {ref} 打开，点一下切到前台',
+    'desk.started': '已以 {ref} 打开 {app}。',
+    'desk.focused': '{ref} 的 {app} 已切到前台。',
+    'desk.failed': '没能打开 {ref} 的桌面应用：{msg}',
     'md.title': '模型和 effort',
     'md.intro': '只影响之后用 sideby 启动的 {ref} 新会话（短命令或 sideby run）。保存在 sideby 的配置里，不改 {host} 自己的设置。',
     'md.model': '模型',

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

@@ -26,7 +26,11 @@ export interface LogicAccount {
         }[];
         observedAt?: string;
         plan?: string;
+        /** The Account the reading came from, when it is another Account of the same login (spec §3.21). */
+        from?: string;
     };
+    /** The other Accounts of its Same Login (spec §3.21). */
+    sameLogin?: string[];
     usage?: {
         status: string;
         inputTokens?: number;
@@ -65,7 +69,8 @@ export declare function passedWindow(w: {
 export declare function quotaPressure(a: LogicAccount, now: number): number;
 /**
  * Why an Account needs a look, most serious first: `error`, `health-fail`, `signed-out`, `not-installed`,
- * `quota-high` (a live window at or over the warning level), `health-warn`. Empty when all is well.
+ * `quota-high` (a live window at or over the warning level), `health-warn`. Empty when all is well. A Quota read from
+ * another Account of the same login (`quota.from`, spec §3.21) is that Account's warning, so it counts once per group.
  */
 export declare function attentionReasons(a: LogicAccount, health: {
     fail: number;

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

@@ -55,7 +55,8 @@ export function quotaPressure(a, now) {
 }
 /**
  * Why an Account needs a look, most serious first: `error`, `health-fail`, `signed-out`, `not-installed`,
- * `quota-high` (a live window at or over the warning level), `health-warn`. Empty when all is well.
+ * `quota-high` (a live window at or over the warning level), `health-warn`. Empty when all is well. A Quota read from
+ * another Account of the same login (`quota.from`, spec §3.21) is that Account's warning, so it counts once per group.
  */
 export function attentionReasons(a, health, now, warn) {
     const out = [];
@@ -68,7 +69,7 @@ export function attentionReasons(a, health, now, warn) {
     if (a.hostInstalled === false)
         out.push('not-installed');
     const q = a.quota;
-    if (q && q.status === 'ok' && q.windows)
+    if (q && q.status === 'ok' && q.windows && !q.from)
         for (const w of q.windows) {
             const reset = Date.parse(w.resetsAt);
             if (Number.isFinite(reset) && reset <= now)
@@ -257,8 +258,8 @@ export function suggestName(names) {
     if (!taken.work)
         return 'work';
     for (let i = 2;; i++)
-        if (!taken['work' + i])
-            return 'work' + i;
+        if (!taken[`work${i}`])
+            return `work${i}`;
 }
 /**
  * A Finding's hint as the Panel shows it: for a fixable Finding, "run `sideby doctor --fix`" becomes the

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

@@ -53,7 +53,7 @@ const MAIN = String.raw `
     silent: false, lastTry: 0, pending: false, fastUntil: 0, fastFamily: null,
   }
   // View state that is not saved: the search text, the attention filter, the Health check filter.
-  const ui = { query: '', attention: false, allFindings: false, healthRef: null, checkingRef: null, highlight: null, fade: true }
+  const ui = { query: '', attention: false, allFindings: false, healthRef: null, checkingRef: null, desktopRef: null, highlight: null, fade: true }
   const $ = (id) => document.getElementById(id)
 
   // ---------- preferences ----------
@@ -573,6 +573,7 @@ const MAIN = String.raw `
     const items = [
       { icon: 'terminal', label: t('menu.copyRun'), hint: run, run: () => copyText(run) },
       ...(a.aliases || []).slice(0, 2).map((x) => ({ icon: 'terminal', label: t('menu.copyAlias'), hint: x, run: () => copyText(x) })),
+      a.desktopApp && a.desktopApp.installed && a.kind !== 'api' && !BOOT.readOnly ? { icon: 'terminal', label: t(a.desktopApp.running ? 'desk.show' : 'desk.open', { app: a.desktopApp.app }), disabled: Boolean(ui.desktopRef), run: () => openDesktop(a) } : null,
       a.kind !== 'api' ? { icon: 'key', label: t('menu.copyLogin'), hint: 'sideby login ' + a.ref, run: () => copyText('sideby login ' + a.ref) } : null,
       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,
@@ -836,7 +837,9 @@ const MAIN = String.raw `
     if (q.status !== 'ok') return h('div', { class: 'quota' }, quotaNote(a, q))
     const stale = isStale(q.observedAt, now)
     const wins = q.windows || []
-    return h('div', { class: 'quota' + (stale ? ' is-stale' : ''), title: stale ? null : t('quota.dataFrom', { ago: ago(q.observedAt) }) },
+    // A reading borrowed from another Account of the same login says where it came from (spec §3.21).
+    const from = q.from ? t('quota.sharedFrom', { name: refName(q.from), ago: ago(q.observedAt) }) : null
+    return h('div', { class: 'quota' + (stale ? ' is-stale' : ''), title: from || (stale ? null : t('quota.dataFrom', { ago: ago(q.observedAt) })) },
       wins.length ? cols.map((c) => {
         const w = wins.find((x) => x.label === c)
         return w ? meter(w, now, stale, q.observedAt) : noMeter(c)
@@ -883,6 +886,9 @@ const MAIN = String.raw `
         return h('span', { class: 'tag tag-alias', title: args ? t('acct.aliasArgs', { args: args.join(' ') }) : t('acct.alias') }, x)
       }),
       a.kind === 'api' ? h('span', { class: 'tag tag-warn', title: t('tip.api.body') }, t('acct.api')) : null,
+      a.sameLogin && a.sameLogin.length
+        ? h('span', { class: 'tag', title: t('acct.sameLoginHint', { names: a.sameLogin.map(refName).join(', ') }) }, t('acct.sameLogin', { names: a.sameLogin.map(refName).join(', ') }))
+        : null,
       isNext(a)
         ? h('button', { class: 'tag tag-ok tag-btn', type: 'button', title: t('acct.nextHint', { family: a.family }), 'aria-label': t('acct.nextLabel', { ref: a.ref, family: a.family }), onclick: () => copyText('sideby next ' + a.family) }, t('acct.next'))
         : null,
@@ -891,6 +897,8 @@ const MAIN = String.raw `
         : null,
       a.hostInstalled === false ? h('span', { class: 'tag tag-warn' }, t('acct.notInstalled')) : null)
   }
+  // The name part of a ref (claude:001 gives 001), as rows show other Accounts of the same Family.
+  function refName(ref) { return String(ref).slice(String(ref).indexOf(':') + 1) }
   // Who the account is signed in as, under its name; masked while "Hide emails" is on.
   function emailLine(a) {
     const id = a.identity
@@ -906,8 +914,34 @@ const MAIN = String.raw `
       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,
+      desktopButton(a),
     ]))
   }
+  // The family's desktop app as this account (spec §3.20): only where it is installed, never for API accounts or a
+  // read-only panel. A running window shows as "open"; the click brings it to the front instead of a second one.
+  function desktopButton(a) {
+    const d = a.desktopApp
+    if (!d || !d.installed || a.kind === 'api' || BOOT.readOnly) return null
+    const busy = ui.desktopRef === a.ref
+    const label = busy ? t('desk.opening', { app: d.app }) : t(d.running ? 'desk.show' : 'desk.open', { app: d.app })
+    return h('button', { class: 'tag tag-btn' + (d.running ? ' tag-ok' : ''), type: 'button', disabled: busy, title: t(d.running ? 'desk.showHint' : 'desk.openHint', { app: d.app, ref: a.ref }), 'aria-label': label + ' (' + a.ref + ')', onclick: (e) => { e.stopPropagation(); openDesktop(a) } },
+      d.running ? h('span', { class: 'dot dot-ok', 'aria-hidden': 'true' }) : null, label)
+  }
+  async function openDesktop(a) {
+    if (ui.desktopRef) return
+    ui.desktopRef = a.ref
+    renderAccounts()
+    try {
+      const r = await api('/api/account/desktop', { account: a.ref })
+      const text = r.action === 'started' ? t('desk.started', { app: r.app, ref: r.ref }) : r.action === 'focused' ? t('desk.focused', { app: r.app, ref: r.ref }) : ''
+      if (text) toast(text)
+      // Notices say what to do next (sign in, close other windows while signing in); they stay a little longer.
+      for (const n of r.notices || []) toast(n, { kind: 'info', duration: 12000 })
+    } catch (e) { toast(t('desk.failed', { ref: a.ref, msg: e.message }), { kind: 'fail' }) }
+    ui.desktopRef = null
+    renderAccounts()
+    load({ silent: true })
+  }
   function notes(a) {
     const fam = family(a.family)
     const out = []
@@ -920,7 +954,7 @@ const MAIN = String.raw `
   }
   // What a row or card shows depends on more than the account (health, view preferences, language); the
   // fingerprint covers what its click handlers use.
-  function rowSig(a) { return sig([a, healthOf(a.ref), isNext(a)]) }
+  function rowSig(a) { return sig([a, healthOf(a.ref), isNext(a), ui.desktopRef === a.ref]) }
   // The Account 'sideby next <family>' would pick; the server ranks it with the CLI's rule (spec §3.13).
   function isNext(a) { return Boolean(S.state && S.state.handoff && S.state.handoff[a.family] === a.ref) }
   function row(a, now, cols) {

package/dist/src/runtime.d.ts

@@ -1,6 +1,7 @@
 import { type AccountRefError } from './core/accounts.ts';
 import { type Config, type HandoffSettings } from './core/config.ts';
 import { type CreateResult } from './core/create.ts';
+import { type DesktopDeps } from './core/desktop-app.ts';
 import { type DoctorReport } from './core/doctor.ts';
 import { UserError } from './core/errors.ts';
 import { type HandoffPlan } from './core/handoff.ts';
@@ -102,8 +103,21 @@ export interface AccountStatus extends Account {
     model?: string;
     /** Who the Account is signed in as (email, organization), when its Family can tell. */
     identity?: AccountIdentity;
+    /**
+     * The other Accounts signed in as the same login, which share its Quota (spec §3.21); absent when there are none.
+     */
+    sameLogin?: string[];
     /** Plugin errors met while reading this Account (for example an unreadable settings file). */
     problems?: string[];
+    /**
+     * The Family's Desktop App for this Account (spec §3.20): macOS only, Subscription Accounts of claude and codex.
+     * Filled by `sideby list` and the Panel, which list processes once for all Accounts; `status()` leaves it out.
+     */
+    desktopApp?: {
+        app: string;
+        installed: boolean;
+        running: boolean;
+    };
 }
 export interface DoctorOptions {
     /** Family id or Account ref; all Accounts when omitted. */
@@ -187,7 +201,13 @@ export interface Runtime {
      * (spec §3.15). Throws UnknownFamilyError, or a UserError when the Family cannot route sessions.
      */
     resumeLaunch(familyId: string, userArgs: readonly string[]): Promise<ResumeLaunch>;
+    /**
+     * The Account's Quota. For an Account of a Same Login (spec §3.21) it is the group's freshest reading, with `from`
+     * naming the Account it was read from when that is another one.
+     */
     quota(account: Account): Promise<QuotaResult>;
+    /** The other Accounts signed in as the same login as this one (spec §3.21), in discovery order; empty when none. */
+    sameLogin(account: Account): Promise<string[]>;
     usage(account: Account): Promise<UsageResult>;
     /** Estimated Compaction Threshold per model for one Account (spec §3.18); read-only. */
     tuning(account: Account): Promise<TuningResult>;
@@ -232,4 +252,10 @@ export declare function createRuntime(opts?: {
     env?: Env;
     builtins?: BuiltinPlugin[];
     now?: () => Date;
+    /**
+     * Internal, for tests: replaces the machine the Desktop App calls use (platform, app folders and the programs
+     * `open`, `ps`, `osascript`, `plutil`, `mdfind`; spec §3.20). Omitted, the real machine is used. Not part of
+     * the plugin or Portal contract; it may change without notice.
+     */
+    desktop?: Partial<DesktopDeps>;
 }): Promise<Runtime>;