sideby 0.9.3 → 0.11.0

package/dist/src/handoff/hook.js

@@ -7,7 +7,7 @@ import { FILES, HANDOFF_ENV, readJsonFile, writeJsonFile, } from '../core/handof
 import { claudeHookReader } from '../families/claude/handoff-hook.js';
 import { codexHookReader } from '../families/codex/handoff-hook.js';
 import { grokHookReader } from '../families/grok/handoff-hook.js';
-import { endTurnMessage, prepareMessage, sessionStartMessage, stopMessage, thresholdMessage, } from './messages.js';
+import { endTurnMessage, notifySequence, prepareMessage, sessionStartMessage, stopMessage, thresholdMessage, waitNotice, } from './messages.js';
 import { field } from './reader.js';
 export const HOOK_COMMAND = 'sideby handoff-hook';
 const READERS = {
@@ -77,10 +77,21 @@ export async function decide(opts) {
     }
     const threshold = usable?.threshold ?? 95;
     const pressure = reader.pressure ? await reader.pressure(input, env, now) : null;
+    const ref = env.SIDEBY_ACCOUNT ?? family;
+    const waiting = usable?.decision === 'wait' && usable.until ? usable.until : undefined;
+    // Once per run, shown to the user (not the model): sideby will wait for the reset, and how to move on now.
+    const waitOutput = async () => {
+        if (!waiting || pressure === null || pressure < threshold || state.waitNoticeSentAt)
+            return undefined;
+        await save({ ...state, waitNoticeSentAt: now.toISOString() });
+        return { systemMessage: waitNotice(ref, waiting, pressure) };
+    };
     if (event === 'StopFailure') {
-        if (reader.limitHit?.(input, pressure, threshold))
-            await ready({ trigger: 'limit' });
-        return {};
+        if (!reader.limitHit?.(input, pressure, threshold))
+            return {};
+        await ready({ trigger: 'limit' });
+        // The Host keeps only `terminalSequence` of a StopFailure hook's output.
+        return waiting ? { output: { terminalSequence: notifySequence(waitNotice(ref, waiting)) } } : {};
     }
     if (event === 'Stop') {
         // Grok also fires Stop when the session ends; only a finished turn counts.
@@ -95,6 +106,9 @@ export async function decide(opts) {
         }
         if (!usable)
             return {};
+        const notice = await waitOutput();
+        if (notice)
+            return { output: notice };
         if (state.thresholdSentAt && usable.agentBrief === false) {
             await ready({ trigger: 'threshold' });
             return {};
@@ -125,6 +139,9 @@ export async function decide(opts) {
     // PostToolUse
     if (!usable || pressure === null)
         return {};
+    const notice = await waitOutput();
+    if (notice)
+        return { output: notice };
     if (pressure >= usable.threshold && usable.decision === 'pick' && !state.thresholdSentAt) {
         await save({ ...state, thresholdSentAt: now.toISOString() });
         const text = usable.agentBrief === false ? endTurnMessage(pressure) : thresholdMessage(usable.brief, pressure);

package/dist/src/handoff/messages.d.ts

@@ -12,4 +12,8 @@ declare const WHY: {
 };
 /** The next session's first prompt: the Brief's path only, never its text (it would show in a process list). */
 export declare function firstPrompt(fromRef: string, brief: string, trigger: keyof typeof WHY): string;
+/** For the user, not the model (ADR-0018): this session will wait for the reset, and how to move on now instead. */
+export declare function waitNotice(ref: string, until: string, pressure?: number): string;
+/** A desktop notification through the Host (OSC 9 and OSC 777), the only output `StopFailure` keeps. */
+export declare function notifySequence(text: string): string;
 export {};

package/dist/src/handoff/messages.js

@@ -34,3 +34,15 @@ const WHY = {
 export function firstPrompt(fromRef, brief, trigger) {
     return `This task was handed over from ${fromRef} by sideby because ${WHY[trigger]}. Read ${brief} first, then continue the task it describes. If the user asks to move the task to another account (back to ${fromRef}, say), run \`sideby handoff ready --to <account>\` and end your turn.`;
 }
+const clock = (iso) => new Date(iso).toLocaleTimeString(undefined, { hour: '2-digit', minute: '2-digit' });
+/** For the user, not the model (ADR-0018): this session will wait for the reset, and how to move on now instead. */
+export function waitNotice(ref, until, pressure) {
+    const now = pressure === undefined ? 'hit its limit' : `is at ${Math.round(pressure)}%`;
+    const then = pressure === undefined ? 'this session waits' : 'when it runs out this session waits';
+    return `sideby: ${ref} ${now}; its quota is back at ${clock(until)}, so ${then} and goes on by itself instead of moving to another account. To move on now, type: ! sideby handoff ready`;
+}
+/** A desktop notification through the Host (OSC 9 and OSC 777), the only output `StopFailure` keeps. */
+export function notifySequence(text) {
+    const safe = [...text].map((ch) => (ch < ' ' || ch === '\u007f' ? ' ' : ch)).join('');
+    return `\u001b]9;${safe}\u0007\u001b]777;notify;sideby;${safe}\u0007`;
+}

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

@@ -1,6 +1,8 @@
 import type { IncomingMessage, ServerResponse } from 'node:http';
+import { type AppProfileStatus } from '../core/app-profiles.ts';
 import { type HandoffSettings } from '../core/config.ts';
 import { type AccountModel } from '../core/model-choice.ts';
+import type { RemoteControlGroup } from '../core/remote-control.ts';
 import type { AccountStatus, DoctorHistory, FamilyInfo, Runtime } from '../runtime.ts';
 import type { Account, FamilyLogo, QuotaResult, QuotaSetupPlan, UsageResult } from '../types.ts';
 import { type PanelTheme } from './theme.ts';
@@ -94,7 +96,14 @@ export interface PanelState {
         settings: HandoffSettings;
         starters: string[];
     };
+    /** Claude settings files grouped as `sideby remote-control` shows them (spec §3.22); absent without Claude Accounts. */
+    remoteControl?: RemoteControlView[];
+    /** Grok Bot windows (ADR-0019), data folders shown as `~/…`; absent when there are none to show. */
+    appProfiles?: AppProfileStatus[];
 }
 /** The `handoff` map of the Panel state, from the statuses and Quota already read for the page. */
 export declare function handoffByFamily(rt: Runtime, accounts: readonly PanelAccount[], now: Date): Record<string, string>;
+export type RemoteControlView = Omit<RemoteControlGroup, 'file'> & {
+    file: string;
+};
 export declare function createPanelHandler(opts: PanelHandlerOptions): PanelHandler;

package/dist/src/panel/handler.js

@@ -1,6 +1,7 @@
 // HTTP handler for the local Panel. Mountable under any basePath; standalone and embedded use the same rules.
 import { randomBytes, timingSafeEqual } from 'node:crypto';
 import { aliasesByAccount } from '../core/accounts.js';
+import { listAppProfiles, openAppProfile, removeAppProfile, } from '../core/app-profiles.js';
 import { aliasArgs, aliasRefs } from '../core/config.js';
 import { openDesktopApp, withDesktopApps } from '../core/desktop-app.js';
 import { UserError } from '../core/errors.js';
@@ -197,18 +198,25 @@ async function accountState(rt, account, families) {
         ...(errors.length ? { error: errors.join('; ') } : {}),
     };
 }
+function rcView(groups, home) {
+    return groups.map((g) => ({ ...g, file: tildify(g.file, home) }));
+}
 async function buildState(rt, opts) {
     const ctx = rt.readContext();
-    const [families, accounts, history, quotaSetups] = await Promise.all([
+    const [families, accounts, history, quotaSetups, remoteControl] = await Promise.all([
         rt.familyInfo(),
         rt.accounts(),
         rt.doctorHistory(),
         rt.quotaSetups(),
+        rt.remoteControl(),
     ]);
     const health = healthByAccount(history);
     const aliases = aliasesByAccount(aliasRefs(rt.config.aliases), accounts);
     // 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 [states, appProfiles] = await Promise.all([
+        withDesktopApps(rt, accounts, Promise.all(accounts.map((a) => accountState(rt, a, families)))),
+        listAppProfiles(rt),
+    ]);
     const list = states.map((st) => {
         const h = health.get(st.ref);
         const names = aliases.get(st.ref);
@@ -239,6 +247,12 @@ async function buildState(rt, opts) {
         ...(history ? { history } : {}),
         ...(rt.config.aliases ? { configAliases: aliasRefs(rt.config.aliases) } : {}),
         ...(Object.keys(handoff).length ? { handoff } : {}),
+        ...(remoteControl.length ? { remoteControl: rcView(remoteControl, ctx.home) } : {}),
+        ...(appProfiles.length
+            ? {
+                appProfiles: appProfiles.map((p) => p.appData ? { ...p, appData: tildify(p.appData, rt.paths.home) } : p),
+            }
+            : {}),
         autoHandoff: {
             settings: rt.handoffSettings(),
             starters: [...rt.families.values()]
@@ -400,6 +414,24 @@ export function createPanelHandler(opts) {
                 return { ref: found.ref, undone: r.ok, message: r.message };
             },
         },
+        // Remote Control off by default (spec §3.22, ADR-0017): writes `remoteControlAtStartup: false` into each Claude
+        // settings file that turns it on or leaves it to the default; the page shows the files first, from the state.
+        '/api/remote-control/off': {
+            async run() {
+                const rt = await getRuntime();
+                const r = await rt.remoteControlOff();
+                const home = rt.paths.home;
+                return { ...r, results: r.results.map((x) => ({ ...x, file: tildify(x.file, home) })) };
+            },
+        },
+        '/api/remote-control/undo': {
+            async run() {
+                const rt = await getRuntime();
+                const r = await rt.remoteControlUndo();
+                const home = rt.paths.home;
+                return { ...r, results: r.results.map((x) => ({ ...x, file: tildify(x.file, home) })) };
+            },
+        },
         // Auto Handoff (spec §3.17): readiness reads only; configure shows the config change unless `confirm`.
         '/api/handoff/status': {
             writes: () => false,
@@ -456,6 +488,33 @@ export function createPanelHandler(opts) {
                 };
             },
         },
+        // Opens a Grok Bot window, creating it when the name is new, or brings it to the front (ADR-0019).
+        '/api/app-profile/open': {
+            async run(body) {
+                const ref = optString(body, 'ref');
+                if (!ref)
+                    throw new HttpError(400, '"ref" is required');
+                const rt = await getRuntime();
+                const r = await openAppProfile(rt, ref);
+                const home = rt.paths.home;
+                return {
+                    ...r,
+                    appPath: tildify(r.appPath, home),
+                    ...(r.appData ? { appData: tildify(r.appData, home) } : {}),
+                };
+            },
+        },
+        // Removes a Grok Bot window's data folder (ADR-0019). The page asks first, so this call is the confirmation.
+        '/api/app-profile/remove': {
+            async run(body) {
+                const ref = optString(body, 'ref');
+                if (!ref)
+                    throw new HttpError(400, '"ref" is required');
+                const rt = await getRuntime();
+                const r = await removeAppProfile(rt, ref, { yes: true });
+                return { ...r, appData: tildify(r.appData, rt.paths.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

@@ -247,6 +247,36 @@ declare const en: {
     'desk.started': string;
     'desk.focused': string;
     'desk.failed': string;
+    'app.apart': string;
+    'app.apartTip': string;
+    'app.mainName': string;
+    'app.mainData': string;
+    'app.isOpen': string;
+    'app.signedIn': string;
+    'app.signedOut': string;
+    'app.signedInHint': string;
+    'app.openBtn': string;
+    'app.show': string;
+    'app.openHint': string;
+    'app.showHint': string;
+    'app.started': string;
+    'app.failed': string;
+    'app.remove': string;
+    'app.removeHint': string;
+    'app.removeRunning': string;
+    'app.removeAsk': string;
+    'app.removeYes': string;
+    'app.removing': string;
+    'app.removed': string;
+    'app.removeFailed': string;
+    'app.another': string;
+    'app.anotherHint': string;
+    'app.nameLabel': string;
+    'app.create': string;
+    'app.newHint': string;
+    'app.exists': string;
+    'app.nameEmpty': string;
+    'app.nameBad': string;
     'md.title': string;
     'md.intro': string;
     'md.model': string;
@@ -457,6 +487,22 @@ declare const en: {
     'empty.install': string;
     'empty.noFamilies': string;
     'empty.create': string;
+    'rc.title': string;
+    'rc.body.one': string;
+    'rc.body.other': string;
+    'rc.turnOff': string;
+    'rc.keep': string;
+    'rc.hidden': string;
+    'rc.readOnly': string;
+    'rc.confirmTitle': string;
+    'rc.change': string;
+    'rc.notSet': string;
+    'rc.usedBy': string;
+    'rc.confirmNote': string;
+    'rc.confirm': string;
+    'rc.done': string;
+    'rc.failed': string;
+    'rc.undone': string;
     'banner.readOnly': string;
     'banner.plugins.one': string;
     'banner.plugins.other': string;

package/dist/src/panel/i18n.js

@@ -249,6 +249,36 @@ const en = {
     '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}',
+    'app.apart': 'Signs in on its own',
+    'app.apartTip': '{app} signs in with a Cursor account, not with any account above. Each window here keeps its own sign-in, so several can be open at once.',
+    'app.mainName': 'main',
+    'app.mainData': 'the app’s own data',
+    'app.isOpen': 'Open',
+    'app.signedIn': 'Signed in',
+    'app.signedOut': 'Not signed in',
+    'app.signedInHint': 'What the app last reported. Which account is signed in is not shown: sideby does not read sign-in files.',
+    'app.openBtn': 'Open',
+    'app.show': 'Switch to it',
+    'app.openHint': 'Open {app} as {ref}, in its own window next to the others',
+    'app.showHint': '{app} is open as {ref}; click to bring it to the front',
+    'app.started': 'Opened {app} as {ref}.',
+    'app.failed': 'Could not open {ref}: {msg}',
+    'app.remove': 'Remove',
+    'app.removeHint': 'Remove this {app} window: signs it out and deletes its local data on this Mac',
+    'app.removeRunning': 'Quit this {app} window first, then remove it',
+    'app.removeAsk': 'Remove {ref}? This signs that window out and deletes its local data on this Mac.',
+    'app.removeYes': 'Remove',
+    'app.removing': 'Removing…',
+    'app.removed': 'Removed {ref}.',
+    'app.removeFailed': 'Could not remove {ref}: {msg}',
+    'app.another': 'Open another {app}',
+    'app.anotherHint': 'A new window with its own sign-in.',
+    'app.nameLabel': 'Name for the new window',
+    'app.create': 'Create and open',
+    'app.newHint': 'Sign in inside the new window with the account you want for it. Close the other {app} windows while you sign in.',
+    'app.exists': '{ref} already exists; this opens it.',
+    'app.nameEmpty': 'Enter a name.',
+    'app.nameBad': 'Use lowercase letters, digits and dashes, starting with a letter or digit.',
     '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',
@@ -459,6 +489,22 @@ const en = {
     'empty.install': 'Install',
     'empty.noFamilies': 'No tools are registered. Check sideby plugins.',
     'empty.create': 'Create your first account',
+    'rc.title': 'Remote Control starts by itself.',
+    'rc.body.one': 'Sessions of {refs} connect to claude.ai and the Claude app, where every device signed in to that account can read them.',
+    'rc.body.other': 'Sessions of {n} accounts ({refs}) connect to claude.ai and the Claude app, where every device signed in to that account can read them.',
+    'rc.turnOff': 'Turn all off',
+    'rc.keep': 'Keep it on',
+    'rc.hidden': 'Hidden in this browser. sideby remote-control off turns it off later.',
+    'rc.readOnly': 'Run sideby remote-control off to turn it off.',
+    'rc.confirmTitle': 'Turn off Remote Control at startup?',
+    'rc.change': 'remoteControlAtStartup {from} → false',
+    'rc.notSet': 'not set',
+    'rc.usedBy': 'used by {refs}',
+    'rc.confirmNote': 'Running sessions stay connected until you restart them. You can still start it in a session with /remote-control.',
+    'rc.confirm': 'Turn off',
+    'rc.done': 'Remote Control is off for new sessions. Restart sessions that are running.',
+    'rc.failed': 'Could not turn it off: {msg}',
+    'rc.undone': 'Undone. New sessions go back to the previous setting.',
     'banner.readOnly': 'Read-only view. Use the sideby CLI to fix or create accounts.',
     'banner.plugins.one': '{n} plugin problem.',
     'banner.plugins.other': '{n} plugin problems.',
@@ -712,6 +758,36 @@ const zh = {
     'desk.started': '已以 {ref} 打开 {app}。',
     'desk.focused': '{ref} 的 {app} 已切到前台。',
     'desk.failed': '没能打开 {ref} 的桌面应用：{msg}',
+    'app.apart': '单独登录',
+    'app.apartTip': '{app} 用 Cursor 账号登录，和上面的账号都无关。这里每个窗口各自保存登录，可以同时开几个。',
+    'app.mainName': 'main',
+    'app.mainData': '应用自己的数据',
+    'app.isOpen': '已打开',
+    'app.signedIn': '已登录',
+    'app.signedOut': '未登录',
+    'app.signedInHint': '应用最后一次报告的状态。不显示登录的是哪个账号：sideby 不读登录文件。',
+    'app.openBtn': '打开',
+    'app.show': '切到窗口',
+    'app.openHint': '以 {ref} 打开 {app}，和其他窗口同时开着',
+    'app.showHint': '{app} 已经以 {ref} 打开，点一下切到前台',
+    'app.started': '已以 {ref} 打开 {app}。',
+    'app.failed': '没能打开 {ref}：{msg}',
+    'app.remove': '删除',
+    'app.removeHint': '删除这个 {app} 窗口：退出它的登录，删掉它在这台 Mac 上的数据',
+    'app.removeRunning': '先退出这个 {app} 窗口，再删除',
+    'app.removeAsk': '删除 {ref}？会退出这个窗口的登录，删掉它在这台 Mac 上的数据。',
+    'app.removeYes': '删除',
+    'app.removing': '正在删除…',
+    'app.removed': '已删除 {ref}。',
+    'app.removeFailed': '没能删除 {ref}：{msg}',
+    'app.another': '再开一个 {app}',
+    'app.anotherHint': '新窗口单独登录。',
+    'app.nameLabel': '新窗口的名字',
+    'app.create': '新建并打开',
+    'app.newHint': '在新窗口里用你想给它的账号登录。登录时先关掉其他 {app} 窗口。',
+    'app.exists': '{ref} 已经有了，点了会直接打开它。',
+    'app.nameEmpty': '请填一个名字。',
+    'app.nameBad': '只能用小写字母、数字和横线，以字母或数字开头。',
     'md.title': '模型和 effort',
     'md.intro': '只影响之后用 sideby 启动的 {ref} 新会话（短命令或 sideby run）。保存在 sideby 的配置里，不改 {host} 自己的设置。',
     'md.model': '模型',
@@ -922,6 +998,22 @@ const zh = {
     'empty.install': '安装',
     'empty.noFamilies': '没有注册任何工具，请检查 sideby plugins。',
     'empty.create': '创建第一个账号',
+    'rc.title': 'Remote Control 会自动打开。',
+    'rc.body.one': '{refs} 的会话会连到 claude.ai 和 Claude 手机 App，登录这个账号的设备都能看到对话。',
+    'rc.body.other': '{n} 个账号（{refs}）的会话会连到 claude.ai 和 Claude 手机 App，登录这个账号的设备都能看到对话。',
+    'rc.turnOff': '全部关闭',
+    'rc.keep': '保持开启',
+    'rc.hidden': '本浏览器不再提示。以后可以运行 sideby remote-control off 关闭。',
+    'rc.readOnly': '运行 sideby remote-control off 关闭。',
+    'rc.confirmTitle': '关闭 Remote Control 自动打开？',
+    'rc.change': 'remoteControlAtStartup {from} → false',
+    'rc.notSet': '未设置',
+    'rc.usedBy': '用于 {refs}',
+    'rc.confirmNote': '已经开着的会话要重开才断开。需要时仍可在会话里运行 /remote-control 手动打开。',
+    'rc.confirm': '确认关闭',
+    'rc.done': '新会话不会再自动打开 Remote Control。开着的会话要重开。',
+    'rc.failed': '没能关闭：{msg}',
+    'rc.undone': '已撤销，新会话恢复原来的设置。',
     'banner.readOnly': '只读视图。修复或创建账号请用 sideby 命令行。',
     'banner.plugins.one': '{n} 个插件问题。',
     'banner.plugins.other': '{n} 个插件问题。',