@berthdev/berth 0.0.0-stage → 0.2.1-rc.0

package/dist/src/cli/main.js

@@ -0,0 +1,236 @@
+#!/usr/bin/env node
+import { spawnSync } from 'node:child_process';
+import { readFileSync, realpathSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { parseArgs } from 'node:util';
+import { createContext } from '../context.js';
+import { BerthError, ExitCode } from '../errors.js';
+import { handleHook, installHooks, uninstallHooks } from '../agents/hooks.js';
+import { adopt, bellRang, checkOrigin, create, list, requireLive, stamp } from '../registry/sessions.js';
+import { doctor } from '../registry/doctor.js';
+import { takeSnapshot } from '../snapshot/take.js';
+import { ensure, restoreFrom } from '../restore/ensure.js';
+import { presentState } from '../present/state.js';
+import { installTmux, uninstallTmux } from '../tmux/install.js';
+import { installIterm2, reattach, uninstallIterm2 } from '../iterm2/install.js';
+import { clientAttached } from '../present/attach.js';
+import { toolsFor } from '../tools.js';
+const USAGE = `usage: berth <command> [options]
+
+  ls [--json]                                   all sessions
+  new <agent> [--name N] [--cwd D] [--origin O] [-- agent args]
+  adopt <session> --agent <id> [--origin O]
+  attach <session> [--origin O]
+  stamp [--session S] key=value...
+  snapshot
+  ensure [--origin O] [<session>]
+  restore [--origin O] [--session S] [<snapshot dir>]
+  show <session> [<snapshot dir>]
+  doctor [--json]
+  hooks install|uninstall <agent>
+  tmux install|uninstall                       snapshot hooks in ~/.tmux.conf
+  iterm2 install|uninstall                     Berth for iTerm2 (AutoLaunch script)
+  iterm2 reattach <session>                    rebuild if missing, print attach command
+  present <session>                            show its state on attached terminals
+
+global: --socket <name>        tmux -L socket (overrides BERTH_TMUX_SOCKET)
+        --socket-path <path>   tmux -S socket (set by Berth's tmux hooks)
+
+run by hooks: hook <agent> <event>, bell --session S, attached --session S --tty T --termtype X`;
+function parse(args, options) {
+    try {
+        return parseArgs({ args, options, allowPositionals: true, strict: true });
+    }
+    catch (error) {
+        throw new BerthError(error.message, ExitCode.usage);
+    }
+}
+function need(value, what) {
+    if (!value)
+        throw new BerthError(`missing ${what}\n${USAGE}`, ExitCode.usage);
+    return value;
+}
+function formatRows(rows) {
+    const lines = rows.map((r) => [r.name, r.managed ? r.agent : '-', r.state || '-', r.managed ? r.origin : '-', r.live ? 'live' : 'stopped', r.conversation ? 'bound' : '-', r.cwd].join('\t'));
+    return ['NAME\tAGENT\tSTATE\tORIGIN\tLIVE\tCONV\tCWD', ...lines].join('\n');
+}
+function formatResults(results) {
+    if (results.length === 0)
+        return 'nothing to restore';
+    return results.map((r) => `${r.name}\t${r.outcome}${r.detail ? `\t${r.detail}` : ''}`).join('\n');
+}
+function cliPath() {
+    return realpathSync(fileURLToPath(import.meta.url));
+}
+function readStdin() {
+    try {
+        return readFileSync(0, 'utf8');
+    }
+    catch {
+        return '';
+    }
+}
+function run(ctx, command, rest, out) {
+    switch (command) {
+        case 'ls': {
+            const { values } = parse(rest, { json: { type: 'boolean' } });
+            const rows = list(ctx);
+            out(values.json ? JSON.stringify(rows, null, 2) : formatRows(rows));
+            return ExitCode.ok;
+        }
+        case 'new': {
+            const dash = rest.indexOf('--');
+            const own = dash >= 0 ? rest.slice(0, dash) : rest;
+            const extraArgs = dash >= 0 ? rest.slice(dash + 1) : [];
+            const { values, positionals } = parse(own, { name: { type: 'string' }, cwd: { type: 'string' }, origin: { type: 'string' } });
+            const name = create(ctx, {
+                agent: need(positionals[0], 'agent'),
+                cwd: resolve(values.cwd ?? process.cwd()),
+                name: values.name,
+                origin: values.origin,
+                extraArgs,
+            });
+            out(name);
+            return ExitCode.ok;
+        }
+        case 'adopt': {
+            const { values, positionals } = parse(rest, { agent: { type: 'string' }, origin: { type: 'string' } });
+            adopt(ctx, need(positionals[0], 'session'), need(values.agent, '--agent'), values.origin);
+            return ExitCode.ok;
+        }
+        case 'attach': {
+            const { values, positionals } = parse(rest, { origin: { type: 'string' } });
+            const name = need(positionals[0], 'session');
+            requireLive(ctx, name);
+            if (values.origin)
+                stamp(ctx, name, { origin: checkOrigin(values.origin) });
+            const [bin, ...args] = ctx.tmux.attachArgv(name);
+            return spawnSync(bin, args, { stdio: 'inherit' }).status ?? ExitCode.failure;
+        }
+        case 'stamp': {
+            const { values, positionals } = parse(rest, { session: { type: 'string' } });
+            const pairs = Object.fromEntries(positionals.map((p) => {
+                const eq = p.indexOf('=');
+                if (eq <= 0)
+                    throw new BerthError(`expected key=value, got ${p}`, ExitCode.usage);
+                return [p.slice(0, eq), p.slice(eq + 1)];
+            }));
+            const session = values.session ?? (process.env.TMUX_PANE ? ctx.tmux.sessionOfPane(process.env.TMUX_PANE) : undefined);
+            stamp(ctx, need(session, '--session (not inside a tmux pane)'), pairs);
+            return ExitCode.ok;
+        }
+        case 'snapshot':
+            out(takeSnapshot(ctx));
+            return ExitCode.ok;
+        case 'present': {
+            const name = need(rest[0], 'session');
+            requireLive(ctx, name);
+            const meta = ctx.tmux.listSessions().find((s) => s.name === name)?.meta ?? {};
+            out(String(presentState(ctx.tmux, name, meta.state ?? '', { note: meta.note })));
+            return ExitCode.ok;
+        }
+        case 'tmux': {
+            if (rest[0] === 'install')
+                out(installTmux(ctx.tmux, cliPath()));
+            else if (rest[0] === 'uninstall')
+                out(uninstallTmux(ctx.tmux));
+            else
+                throw new BerthError(`tmux: expected install or uninstall\n${USAGE}`, ExitCode.usage);
+            return ExitCode.ok;
+        }
+        case 'iterm2': {
+            if (rest[0] === 'install')
+                out(installIterm2(toolsFor(ctx, cliPath())).script);
+            else if (rest[0] === 'uninstall')
+                out(uninstallIterm2().script);
+            else if (rest[0] === 'reattach')
+                out(reattach(ctx, toolsFor(ctx, cliPath()), need(rest[1], 'session')));
+            else
+                throw new BerthError(`iterm2: expected install, uninstall or reattach\n${USAGE}`, ExitCode.usage);
+            return ExitCode.ok;
+        }
+        case 'attached': {
+            const { values } = parse(rest, { session: { type: 'string' }, tty: { type: 'string' }, termtype: { type: 'string' } });
+            clientAttached(ctx, { session: need(values.session, '--session'), tty: need(values.tty, '--tty'), termtype: values.termtype ?? '' });
+            return ExitCode.ok;
+        }
+        case 'ensure': {
+            const { values, positionals } = parse(rest, { origin: { type: 'string' } });
+            out(formatResults(ensure(ctx, { origin: values.origin, session: positionals[0] })));
+            return ExitCode.ok;
+        }
+        case 'restore': {
+            const { values, positionals } = parse(rest, { origin: { type: 'string' }, session: { type: 'string' } });
+            const snapshot = positionals[0] ? ctx.store.read(resolve(positionals[0])) : ctx.store.newest();
+            out(formatResults(restoreFrom(ctx, snapshot, { origin: values.origin, session: values.session })));
+            return ExitCode.ok;
+        }
+        case 'show': {
+            const { positionals } = parse(rest, {});
+            const dir = positionals[1] ? resolve(positionals[1]) : ctx.store.newest()?.dir;
+            if (!dir)
+                throw new BerthError('no snapshots yet', ExitCode.notFound);
+            out(ctx.store.scrollback(dir, need(positionals[0], 'session')));
+            return ExitCode.ok;
+        }
+        case 'doctor': {
+            const { values } = parse(rest, { json: { type: 'boolean' } });
+            const findings = doctor(ctx);
+            out(values.json ? JSON.stringify(findings, null, 2) : findings.map((f) => `${f.session ? `${f.session}: ` : ''}${f.problem}`).join('\n') || 'ok');
+            return ExitCode.ok;
+        }
+        case 'hooks': {
+            const [action, agent] = rest;
+            if (action === 'install')
+                out(installHooks(need(agent, 'agent'), cliPath()));
+            else if (action === 'uninstall')
+                out(uninstallHooks(need(agent, 'agent')));
+            else
+                throw new BerthError(`hooks: expected install or uninstall\n${USAGE}`, ExitCode.usage);
+            return ExitCode.ok;
+        }
+        case 'bell': {
+            const { values } = parse(rest, { session: { type: 'string' } });
+            bellRang(ctx, need(values.session, '--session'));
+            return ExitCode.ok;
+        }
+        case 'hook': {
+            handleHook(need(rest[0], 'agent'), need(rest[1], 'event'), readStdin());
+            return ExitCode.ok;
+        }
+        default:
+            throw new BerthError(USAGE, ExitCode.usage);
+    }
+}
+export function main(argv, out = (t) => process.stdout.write(`${t}\n`)) {
+    const args = [...argv];
+    const env = { ...process.env };
+    for (const [flag, variable] of [['--socket', 'BERTH_TMUX_SOCKET'], ['--socket-path', 'BERTH_TMUX_SOCKET_PATH']]) {
+        const at = args.indexOf(flag);
+        if (at < 0)
+            continue;
+        env[variable] = need(args[at + 1], `${flag} value`);
+        args.splice(at, 2);
+    }
+    const [command, ...rest] = args;
+    if (!command || command === '-h' || command === '--help') {
+        out(USAGE);
+        return command ? ExitCode.ok : ExitCode.usage;
+    }
+    try {
+        return run(createContext(env), command, rest, out);
+    }
+    catch (error) {
+        if (error instanceof BerthError) {
+            process.stderr.write(`berth: ${error.message}\n`);
+            return error.code;
+        }
+        process.stderr.write(`berth: ${error.message}\n`);
+        return ExitCode.failure;
+    }
+}
+if (process.argv[1] && realpathSync(process.argv[1]) === cliPath()) {
+    process.exitCode = main(process.argv.slice(2));
+}
+//# sourceMappingURL=main.js.map

package/dist/src/cli/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../../src/cli/main.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,SAAS,EAAwB,MAAM,WAAW,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAgB,MAAM,eAAe,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAC9E,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAmB,MAAM,yBAAyB,CAAC;AAC1H,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,WAAW,EAAsB,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAChF,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,MAAM,KAAK,GAAG;;;;;;;;;;;;;;;;;;;;;gGAqBkF,CAAC;AAIjG,SAAS,KAAK,CAA0D,IAAc,EAAE,OAAU;IAChG,IAAI,CAAC;QACH,OAAO,SAAS,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAW,CAAC,CAAC;IACrF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,UAAU,CAAE,KAAe,CAAC,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IACjE,CAAC;AACH,CAAC;AAED,SAAS,IAAI,CAAC,KAAyB,EAAE,IAAY;IACnD,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,UAAU,CAAC,WAAW,IAAI,KAAK,KAAK,EAAE,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC9E,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,UAAU,CAAC,IAAkB;IACpC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAC3B,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,KAAK,IAAI,GAAG,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAC/J,CAAC;IACF,OAAO,CAAC,6CAA6C,EAAE,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,aAAa,CAAC,OAAwB;IAC7C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,oBAAoB,CAAC;IACtD,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACpG,CAAC;AAED,SAAS,OAAO;IACd,OAAO,YAAY,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AACtD,CAAC;AAED,SAAS,SAAS;IAChB,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,SAAS,GAAG,CAAC,GAAY,EAAE,OAAe,EAAE,IAAc,EAAE,GAAQ;IAClE,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,IAAI,CAAC,CAAC,CAAC;YACV,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;YAC9D,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;YACvB,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;YACpE,OAAO,QAAQ,CAAC,EAAE,CAAC;QACrB,CAAC;QACD,KAAK,KAAK,CAAC,CAAC,CAAC;YACX,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAChC,MAAM,GAAG,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YACnD,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACxD,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,KAAK,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;YAC9H,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,EAAE;gBACvB,KAAK,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC;gBACpC,GAAG,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;gBACzC,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,SAAS;aACV,CAAC,CAAC;YACH,GAAG,CAAC,IAAI,CAAC,CAAC;YACV,OAAO,QAAQ,CAAC,EAAE,CAAC;QACrB,CAAC;QACD,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,KAAK,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;YACvG,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;YAC1F,OAAO,QAAQ,CAAC,EAAE,CAAC;QACrB,CAAC;QACD,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,KAAK,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;YAC5E,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;YAC7C,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YACvB,IAAI,MAAM,CAAC,MAAM;gBAAE,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAC5E,MAAM,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;YACjD,OAAO,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,IAAI,QAAQ,CAAC,OAAO,CAAC;QAC/E,CAAC;QACD,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,KAAK,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;YAC7E,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,CAC9B,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;gBACpB,MAAM,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;gBAC1B,IAAI,EAAE,IAAI,CAAC;oBAAE,MAAM,IAAI,UAAU,CAAC,2BAA2B,CAAC,EAAE,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;gBAClF,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;YAC3C,CAAC,CAAC,CACH,CAAC;YACF,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;YACtH,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,OAAO,EAAE,oCAAoC,CAAC,EAAE,KAAK,CAAC,CAAC;YACvE,OAAO,QAAQ,CAAC,EAAE,CAAC;QACrB,CAAC;QACD,KAAK,UAAU;YACb,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC;YACvB,OAAO,QAAQ,CAAC,EAAE,CAAC;QACrB,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;YACtC,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YACvB,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC;YAC9E,GAAG,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YACjF,OAAO,QAAQ,CAAC,EAAE,CAAC;QACrB,CAAC;QACD,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS;gBAAE,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;iBAC5D,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,WAAW;gBAAE,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;;gBAC1D,MAAM,IAAI,UAAU,CAAC,wCAAwC,KAAK,EAAE,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;YAC3F,OAAO,QAAQ,CAAC,EAAE,CAAC;QACrB,CAAC;QACD,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS;gBAAE,GAAG,CAAC,aAAa,CAAC,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;iBAC1E,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,WAAW;gBAAE,GAAG,CAAC,eAAe,EAAE,CAAC,MAAM,CAAC,CAAC;iBAC3D,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,UAAU;gBAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;;gBACnG,MAAM,IAAI,UAAU,CAAC,oDAAoD,KAAK,EAAE,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;YACvG,OAAO,QAAQ,CAAC,EAAE,CAAC;QACrB,CAAC;QACD,KAAK,UAAU,CAAC,CAAC,CAAC;YAChB,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;YACvH,cAAc,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,WAAW,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC,CAAC;YACrI,OAAO,QAAQ,CAAC,EAAE,CAAC;QACrB,CAAC;QACD,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,KAAK,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;YAC5E,GAAG,CAAC,aAAa,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YACpF,OAAO,QAAQ,CAAC,EAAE,CAAC;QACrB,CAAC;QACD,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,KAAK,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;YACzG,MAAM,QAAQ,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YAC/F,GAAG,CAAC,aAAa,CAAC,WAAW,CAAC,GAAG,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;YACnG,OAAO,QAAQ,CAAC,EAAE,CAAC;QACrB,CAAC;QACD,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,MAAM,EAAE,WAAW,EAAE,GAAG,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACxC,MAAM,GAAG,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,GAAG,CAAC;YAC/E,IAAI,CAAC,GAAG;gBAAE,MAAM,IAAI,UAAU,CAAC,kBAAkB,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;YACtE,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;YAChE,OAAO,QAAQ,CAAC,EAAE,CAAC;QACrB,CAAC;QACD,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;YAC9D,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7B,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC;YAClJ,OAAO,QAAQ,CAAC,EAAE,CAAC;QACrB,CAAC;QACD,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,IAAI,CAAC;YAC7B,IAAI,MAAM,KAAK,SAAS;gBAAE,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;iBACxE,IAAI,MAAM,KAAK,WAAW;gBAAE,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;;gBACtE,MAAM,IAAI,UAAU,CAAC,yCAAyC,KAAK,EAAE,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;YAC5F,OAAO,QAAQ,CAAC,EAAE,CAAC;QACrB,CAAC;QACD,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;YAChE,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC;YACjD,OAAO,QAAQ,CAAC,EAAE,CAAC;QACrB,CAAC;QACD,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;YACxE,OAAO,QAAQ,CAAC,EAAE,CAAC;QACrB,CAAC;QACD;YACE,MAAM,IAAI,UAAU,CAAC,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IAChD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,IAAc,EAAE,MAAW,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;IACnF,MAAM,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;IACvB,MAAM,GAAG,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC/B,KAAK,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,mBAAmB,CAAC,EAAE,CAAC,eAAe,EAAE,wBAAwB,CAAC,CAAU,EAAE,CAAC;QACzH,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC9B,IAAI,EAAE,GAAG,CAAC;YAAE,SAAS;QACrB,GAAG,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,GAAG,IAAI,QAAQ,CAAC,CAAC;QACpD,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IACrB,CAAC;IACD,MAAM,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAChC,IAAI,CAAC,OAAO,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;QACzD,GAAG,CAAC,KAAK,CAAC,CAAC;QACX,OAAO,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC;IAChD,CAAC;IACD,IAAI,CAAC;QACH,OAAO,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;IACrD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,UAAU,EAAE,CAAC;YAChC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;YAClD,OAAO,KAAK,CAAC,IAAI,CAAC;QACpB,CAAC;QACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAW,KAAe,CAAC,OAAO,IAAI,CAAC,CAAC;QAC7D,OAAO,QAAQ,CAAC,OAAO,CAAC;IAC1B,CAAC;AACH,CAAC;AAED,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,OAAO,EAAE,EAAE,CAAC;IACnE,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AACjD,CAAC"}

package/dist/src/config/index.d.ts

@@ -0,0 +1,21 @@
+export interface AgentOverride {
+    launch?: string;
+    resume?: string;
+}
+export interface BerthConfig {
+    tmuxBin: string;
+    tmuxSocket?: string;
+    /** `-S` socket path; set by tmux hooks, which know the server they run in. */
+    tmuxSocketPath?: string;
+    stateDir: string;
+    snapshotRoot: string;
+    scrollbackLines: number;
+    retention: number;
+    agents: Record<string, AgentOverride>;
+    /** Command a restored iTerm2 pane runs to attach; `{session}` is the session name (spec §7.3). */
+    iterm2Attach?: string;
+}
+type Env = Record<string, string | undefined>;
+/** Precedence: environment > config file > defaults (flags are applied by the CLI). */
+export declare function loadConfig(env?: Env): BerthConfig;
+export {};

package/dist/src/config/index.js

@@ -0,0 +1,77 @@
+import { readFileSync, existsSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { basename, join } from 'node:path';
+import { parse } from 'smol-toml';
+import { BerthError, ExitCode } from '../errors.js';
+function configPath(env) {
+    if (env.BERTH_CONFIG)
+        return env.BERTH_CONFIG;
+    const base = env.XDG_CONFIG_HOME || join(env.HOME || homedir(), '.config');
+    return join(base, 'berth', 'config.toml');
+}
+function defaultStateDir(env) {
+    const base = env.XDG_STATE_HOME || join(env.HOME || homedir(), '.local', 'state');
+    return join(base, 'berth');
+}
+function readFile(path) {
+    if (!existsSync(path))
+        return {};
+    try {
+        return parse(readFileSync(path, 'utf8'));
+    }
+    catch (error) {
+        throw new BerthError(`cannot read config ${path}: ${error.message}`, ExitCode.usage);
+    }
+}
+function positiveInt(value, name, fallback) {
+    if (value === undefined)
+        return fallback;
+    if (typeof value !== 'number' || !Number.isInteger(value) || value < 1) {
+        throw new BerthError(`config: ${name} must be a positive integer`, ExitCode.usage);
+    }
+    return value;
+}
+function agentOverrides(value) {
+    if (value === undefined)
+        return {};
+    if (typeof value !== 'object' || value === null)
+        throw new BerthError('config: [agents] must be a table', ExitCode.usage);
+    const result = {};
+    for (const [id, raw] of Object.entries(value)) {
+        const entry = raw;
+        for (const key of ['launch', 'resume']) {
+            if (entry[key] !== undefined && typeof entry[key] !== 'string') {
+                throw new BerthError(`config: agents.${id}.${key} must be a string`, ExitCode.usage);
+            }
+        }
+        result[id] = { launch: entry.launch, resume: entry.resume };
+    }
+    return result;
+}
+/** Precedence: environment > config file > defaults (flags are applied by the CLI). */
+export function loadConfig(env = process.env) {
+    const file = readFile(configPath(env));
+    const tmux = (file.tmux ?? {});
+    const snapshot = (file.snapshot ?? {});
+    const tmuxSocket = env.BERTH_TMUX_SOCKET || (typeof tmux.socket === 'string' ? tmux.socket : undefined);
+    const tmuxSocketPath = env.BERTH_TMUX_SOCKET_PATH || undefined;
+    // State is per tmux server: snapshots and locks of one server never restore
+    // into another. A server is named by its socket (its -L name is the basename).
+    const server = tmuxSocketPath ? basename(tmuxSocketPath) : (tmuxSocket ?? 'default');
+    const baseState = env.BERTH_STATE_DIR || (typeof file.state_dir === 'string' ? file.state_dir : defaultStateDir(env));
+    const stateDir = join(baseState, 'servers', server);
+    return {
+        tmuxBin: env.BERTH_TMUX || (typeof tmux.binary === 'string' ? tmux.binary : 'tmux'),
+        tmuxSocket,
+        tmuxSocketPath,
+        stateDir,
+        snapshotRoot: typeof snapshot.root === 'string' ? join(snapshot.root, server) : join(stateDir, 'snapshots'),
+        scrollbackLines: positiveInt(snapshot.scrollback_lines, 'snapshot.scrollback_lines', 3000),
+        retention: positiveInt(snapshot.keep, 'snapshot.keep', 5),
+        agents: agentOverrides(file.agents),
+        iterm2Attach: typeof file.iterm2?.attach === 'string'
+            ? file.iterm2.attach
+            : undefined,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/src/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/config/index.ts"],"names":[],"mappings":"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"}

package/dist/src/context.d.ts

@@ -0,0 +1,9 @@
+import { type BerthConfig } from './config/index.js';
+import { SnapshotStore } from './snapshot/store.js';
+import { Tmux } from './tmux/client.js';
+export interface Context {
+    config: BerthConfig;
+    tmux: Tmux;
+    store: SnapshotStore;
+}
+export declare function createContext(env?: Record<string, string | undefined>): Context;

package/dist/src/context.js

@@ -0,0 +1,12 @@
+import { loadConfig } from './config/index.js';
+import { SnapshotStore } from './snapshot/store.js';
+import { Tmux } from './tmux/client.js';
+export function createContext(env = process.env) {
+    const config = loadConfig(env);
+    return {
+        config,
+        tmux: new Tmux({ bin: config.tmuxBin, socket: config.tmuxSocket, socketPath: config.tmuxSocketPath }),
+        store: new SnapshotStore(config.snapshotRoot),
+    };
+}
+//# sourceMappingURL=context.js.map

package/dist/src/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAoB,MAAM,mBAAmB,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAQxC,MAAM,UAAU,aAAa,CAAC,MAA0C,OAAO,CAAC,GAAG;IACjF,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;IAC/B,OAAO;QACL,MAAM;QACN,IAAI,EAAE,IAAI,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,UAAU,EAAE,UAAU,EAAE,MAAM,CAAC,cAAc,EAAE,CAAC;QACrG,KAAK,EAAE,IAAI,aAAa,CAAC,MAAM,CAAC,YAAY,CAAC;KAC9C,CAAC;AACJ,CAAC"}

package/dist/src/errors.d.ts

@@ -0,0 +1,13 @@
+/** Exit codes, see design/implementation.md §2.3. */
+export declare const ExitCode: {
+    readonly ok: 0;
+    readonly failure: 1;
+    readonly usage: 2;
+    readonly tmuxUnavailable: 3;
+    readonly notFound: 4;
+};
+export type ExitCodeValue = (typeof ExitCode)[keyof typeof ExitCode];
+export declare class BerthError extends Error {
+    readonly code: ExitCodeValue;
+    constructor(message: string, code?: ExitCodeValue);
+}

package/dist/src/errors.js

@@ -0,0 +1,17 @@
+/** Exit codes, see design/implementation.md §2.3. */
+export const ExitCode = {
+    ok: 0,
+    failure: 1,
+    usage: 2,
+    tmuxUnavailable: 3,
+    notFound: 4,
+};
+export class BerthError extends Error {
+    code;
+    constructor(message, code = ExitCode.failure) {
+        super(message);
+        this.code = code;
+        this.name = 'BerthError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/src/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,EAAE,EAAE,CAAC;IACL,OAAO,EAAE,CAAC;IACV,KAAK,EAAE,CAAC;IACR,eAAe,EAAE,CAAC;IAClB,QAAQ,EAAE,CAAC;CACH,CAAC;AAIX,MAAM,OAAO,UAAW,SAAQ,KAAK;IACG;IAAtC,YAAY,OAAe,EAAW,OAAsB,QAAQ,CAAC,OAAO;QAC1E,KAAK,CAAC,OAAO,CAAC,CAAC;QADqB,SAAI,GAAJ,IAAI,CAAkC;QAE1E,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,CAAC;CACF"}

package/dist/src/index.d.ts

@@ -0,0 +1,17 @@
+export { createContext, type Context } from './context.js';
+export { loadConfig, type BerthConfig } from './config/index.js';
+export { BerthError, ExitCode } from './errors.js';
+export { Tmux, type LiveSession, type SessionMeta } from './tmux/client.js';
+export { ADAPTERS, getAdapter, type Adapter } from './agents/registry.js';
+export { keptArgs, launchCommand, resumeCommand } from './agents/commands.js';
+export { installHooks, uninstallHooks, handleHook, metaForEvent } from './agents/hooks.js';
+export { list, create, adopt, stamp, bellRang, clearBell, BELL_NOTE, type SessionRow } from './registry/sessions.js';
+export { doctor } from './registry/doctor.js';
+export { SnapshotStore, type Snapshot, type SnapshotSession } from './snapshot/store.js';
+export { takeSnapshot } from './snapshot/take.js';
+export { ensure, restoreFrom, type RestoreResult } from './restore/ensure.js';
+export { presentState, sequencesFor } from './present/state.js';
+export { installTmux, uninstallTmux } from './tmux/install.js';
+export { installIterm2, uninstallIterm2, reattach, attachCommand, autoLaunchScript, type Tools } from './iterm2/install.js';
+export { clientAttached, PANE_VARIABLE } from './present/attach.js';
+export { toolsFor, resolveBinary } from './tools.js';

package/dist/src/index.js

@@ -0,0 +1,18 @@
+export { createContext } from './context.js';
+export { loadConfig } from './config/index.js';
+export { BerthError, ExitCode } from './errors.js';
+export { Tmux } from './tmux/client.js';
+export { ADAPTERS, getAdapter } from './agents/registry.js';
+export { keptArgs, launchCommand, resumeCommand } from './agents/commands.js';
+export { installHooks, uninstallHooks, handleHook, metaForEvent } from './agents/hooks.js';
+export { list, create, adopt, stamp, bellRang, clearBell, BELL_NOTE } from './registry/sessions.js';
+export { doctor } from './registry/doctor.js';
+export { SnapshotStore } from './snapshot/store.js';
+export { takeSnapshot } from './snapshot/take.js';
+export { ensure, restoreFrom } from './restore/ensure.js';
+export { presentState, sequencesFor } from './present/state.js';
+export { installTmux, uninstallTmux } from './tmux/install.js';
+export { installIterm2, uninstallIterm2, reattach, attachCommand, autoLaunchScript } from './iterm2/install.js';
+export { clientAttached, PANE_VARIABLE } from './present/attach.js';
+export { toolsFor, resolveBinary } from './tools.js';
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAgB,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAoB,MAAM,mBAAmB,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,IAAI,EAAsC,MAAM,kBAAkB,CAAC;AAC5E,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAgB,MAAM,sBAAsB,CAAC;AAC1E,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC3F,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAmB,MAAM,wBAAwB,CAAC;AACrH,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAuC,MAAM,qBAAqB,CAAC;AACzF,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,MAAM,EAAE,WAAW,EAAsB,MAAM,qBAAqB,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,QAAQ,EAAE,aAAa,EAAE,gBAAgB,EAAc,MAAM,qBAAqB,CAAC;AAC5H,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/src/iterm2/install.d.ts

@@ -0,0 +1,29 @@
+import type { Context } from '../context.js';
+/**
+ * Berth for iTerm2 (spec §7): iTerm2 restores windows, tabs and split panes;
+ * an AutoLaunch script puts each restored pane back in its session. iTerm2
+ * starts AutoLaunch scripts with a minimal PATH, so every tool is referenced
+ * by absolute path.
+ */
+export interface Iterm2Paths {
+    script: string;
+    /** Written by earlier versions (one profile per session); removed on install. */
+    legacyProfiles: string;
+}
+export declare function iterm2Paths(env?: NodeJS.ProcessEnv): Iterm2Paths;
+export interface Tools {
+    node: string;
+    cli: string;
+    tmux: string;
+    socket?: string;
+    /** PATH at install time: AutoLaunch scripts get a minimal one, without tmux or the agents. */
+    path?: string;
+}
+/** Command that attaches a pane to `session`: the configured template, or tmux attach. */
+export declare function attachCommand(ctx: Context, tools: Tools, session: string): string;
+/** `berth iterm2 reattach <session>`: rebuild the session if missing, return its attach command. */
+export declare function reattach(ctx: Context, tools: Tools, session: string): string;
+export declare function autoLaunchScript(tools: Tools): string;
+export declare function installIterm2(tools: Tools, env?: NodeJS.ProcessEnv): Iterm2Paths;
+export declare function uninstallIterm2(env?: NodeJS.ProcessEnv): Iterm2Paths;
+export declare function iterm2Installed(env?: NodeJS.ProcessEnv): boolean;

package/dist/src/iterm2/install.js

@@ -0,0 +1,112 @@
+import { existsSync, mkdirSync, rmSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, join } from 'node:path';
+import { BerthError, ExitCode } from '../errors.js';
+import { ensure } from '../restore/ensure.js';
+import { renderTemplate, shellQuote } from '../shell.js';
+import { PANE_VARIABLE } from '../present/attach.js';
+export function iterm2Paths(env = process.env) {
+    const base = join(env.HOME || homedir(), 'Library', 'Application Support', 'iTerm2');
+    return {
+        script: join(base, 'Scripts', 'AutoLaunch', 'berth.py'),
+        legacyProfiles: join(base, 'DynamicProfiles', 'berth.json'),
+    };
+}
+/** Command that attaches a pane to `session`: the configured template, or tmux attach. */
+export function attachCommand(ctx, tools, session) {
+    const template = ctx.config.iterm2Attach;
+    if (template)
+        return renderTemplate(template, { session });
+    const socket = tools.socket ? ` -L ${shellQuote(tools.socket)}` : '';
+    return `${shellQuote(tools.tmux)}${socket} attach-session -t ${shellQuote(`=${session}`)}`;
+}
+/** `berth iterm2 reattach <session>`: rebuild the session if missing, return its attach command. */
+export function reattach(ctx, tools, session) {
+    if (!ctx.tmux.hasSession(session))
+        ensure(ctx, { session });
+    if (!ctx.tmux.hasSession(session))
+        throw new BerthError(`cannot restore session ${session}`, ExitCode.notFound);
+    return attachCommand(ctx, tools, session);
+}
+export function autoLaunchScript(tools) {
+    const berth = JSON.stringify([tools.node, tools.cli, ...(tools.socket ? ['--socket', tools.socket] : [])]);
+    return `#!/usr/bin/env python3
+"""Berth for iTerm2: put each pane iTerm2 restored back in its agent session.
+
+Generated by \`berth iterm2 install\`; do not edit. iTerm2 restores the
+windows, tabs and split panes; Berth marked each pane with the session it
+showed (user variable ${PANE_VARIABLE}). This script asks the berth CLI to
+rebuild a missing session and to give the command that attaches it, and
+types that command into the pane. It holds no session logic.
+"""
+import asyncio
+import os
+import subprocess
+
+import iterm2
+
+BERTH = ${berth}
+VARIABLE = "user.${PANE_VARIABLE}"
+# Recorded at install: iTerm2's PATH for AutoLaunch has neither tmux nor the agent CLIs.
+ENV = dict(os.environ, PATH=${JSON.stringify(tools.path ?? '')} or os.environ.get("PATH", ""))
+
+
+def attach_command(session_name):
+    try:
+        done = subprocess.run(BERTH + ["iterm2", "reattach", session_name], capture_output=True, text=True, timeout=120, env=ENV)
+    except (OSError, subprocess.SubprocessError):
+        return None
+    command = done.stdout.strip()
+    return command if done.returncode == 0 and command else None
+
+
+async def panes(app):
+    for window in app.terminal_windows:
+        for tab in window.tabs:
+            for session in tab.sessions:
+                yield session
+
+
+async def main(connection):
+    app = await iterm2.async_get_app(connection)
+    # Window restoration may still be running when AutoLaunch starts.
+    for _ in range(20):
+        if app.terminal_windows:
+            break
+        await asyncio.sleep(0.5)
+    await asyncio.sleep(1)
+    async for session in panes(app):
+        name = await session.async_get_variable(VARIABLE)
+        if not name:
+            continue
+        job = await session.async_get_variable("jobName")
+        if job == "tmux":
+            continue  # still attached (iTerm2 kept the process alive)
+        command = await asyncio.get_running_loop().run_in_executor(None, attach_command, name)
+        if command:
+            await session.async_send_text(command + "\\n")
+        else:
+            # Shown on the screen only, never run by the shell.
+            await session.async_inject(("berth: could not restore session %s\\r\\n" % name).encode())
+
+
+iterm2.run_until_complete(main)
+`;
+}
+export function installIterm2(tools, env = process.env) {
+    const paths = iterm2Paths(env);
+    mkdirSync(dirname(paths.script), { recursive: true });
+    writeFileSync(paths.script, autoLaunchScript(tools), { mode: 0o755 });
+    rmSync(paths.legacyProfiles, { force: true });
+    return paths;
+}
+export function uninstallIterm2(env = process.env) {
+    const paths = iterm2Paths(env);
+    rmSync(paths.script, { force: true });
+    rmSync(paths.legacyProfiles, { force: true });
+    return paths;
+}
+export function iterm2Installed(env = process.env) {
+    return existsSync(iterm2Paths(env).script);
+}
+//# sourceMappingURL=install.js.map

package/dist/src/iterm2/install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../../../src/iterm2/install.ts"],"names":[],"mappings":"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"}

package/dist/src/present/attach.d.ts

@@ -0,0 +1,16 @@
+import type { Context } from '../context.js';
+/** iTerm2 user variable naming the session a pane shows (spec §7.3). */
+export declare const PANE_VARIABLE = "berthSession";
+export declare function setUserVar(name: string, value: string): string;
+export interface AttachedClient {
+    session: string;
+    tty: string;
+    termtype: string;
+}
+/**
+ * A client attached to a session, or switched to one (tmux hooks
+ * client-attached / client-session-changed). For iTerm2 the pane is marked
+ * with the session's name and the session's origin becomes iterm2; every
+ * client is shown the session's current state.
+ */
+export declare function clientAttached(ctx: Context, client: AttachedClient): void;