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

package/dist/src/snapshot/store.d.ts

@@ -0,0 +1,29 @@
+/** One managed session as recorded in a snapshot (implementation §2.1). */
+export interface SnapshotSession {
+    name: string;
+    cwd: string;
+    agent: string;
+    argv: string;
+    conversation: string;
+    origin: string;
+}
+export interface Snapshot {
+    version: 1;
+    createdAt: string;
+    sessions: SnapshotSession[];
+}
+export interface StoredSnapshot extends Snapshot {
+    dir: string;
+}
+export declare class SnapshotStore {
+    readonly root: string;
+    constructor(root: string);
+    /** Snapshot directories, newest first. */
+    list(): string[];
+    read(dir: string): StoredSnapshot;
+    newest(): StoredSnapshot | undefined;
+    /** Write atomically: build in a temporary directory, then rename into place. */
+    write(sessions: SnapshotSession[], scrollback: Record<string, string>, now?: Date): string;
+    prune(keep: number): void;
+    scrollback(dir: string, session: string): string;
+}

package/dist/src/snapshot/store.js

@@ -0,0 +1,90 @@
+import { existsSync, mkdirSync, readdirSync, readFileSync, renameSync, rmSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { BerthError, ExitCode } from '../errors.js';
+const SNAPSHOT_VERSION = 1;
+const DIR_PATTERN = /^\d{8}T\d{6}(\d{3})?Z(-\d+)?$/;
+function timestampDir(date) {
+    return date.toISOString().replace(/[-:]/g, '').replace(/\.(\d{3})Z$/, '$1Z');
+}
+/** Session names may contain '/' and other characters a file name cannot. */
+function scrollbackFile(session) {
+    return `${encodeURIComponent(session)}.txt`;
+}
+export class SnapshotStore {
+    root;
+    constructor(root) {
+        this.root = root;
+    }
+    /** Snapshot directories, newest first. */
+    list() {
+        if (!existsSync(this.root))
+            return [];
+        return readdirSync(this.root)
+            .filter((name) => DIR_PATTERN.test(name) && existsSync(join(this.root, name, 'sessions.json')))
+            .sort()
+            .reverse()
+            .map((name) => join(this.root, name));
+    }
+    read(dir) {
+        const file = join(dir, 'sessions.json');
+        let data;
+        try {
+            data = JSON.parse(readFileSync(file, 'utf8'));
+        }
+        catch (error) {
+            throw new BerthError(`cannot read snapshot ${file}: ${error.message}`);
+        }
+        const snapshot = data;
+        if (snapshot.version !== SNAPSHOT_VERSION) {
+            throw new BerthError(`unsupported snapshot version ${String(snapshot.version)} in ${file}`);
+        }
+        if (!Array.isArray(snapshot.sessions))
+            throw new BerthError(`malformed snapshot ${file}`);
+        return { ...snapshot, dir };
+    }
+    newest() {
+        const [dir] = this.list();
+        return dir ? this.read(dir) : undefined;
+    }
+    /** Write atomically: build in a temporary directory, then rename into place. */
+    write(sessions, scrollback, now = new Date()) {
+        mkdirSync(this.root, { recursive: true });
+        let name = timestampDir(now);
+        for (let n = 2; existsSync(join(this.root, name)); n++)
+            name = `${timestampDir(now)}-${n}`;
+        const tmp = join(this.root, `.tmp-${process.pid}-${name}`);
+        mkdirSync(join(tmp, 'scrollback'), { recursive: true });
+        const snapshot = { version: SNAPSHOT_VERSION, createdAt: now.toISOString(), sessions };
+        writeFileSync(join(tmp, 'sessions.json'), `${JSON.stringify(snapshot, null, 2)}\n`);
+        for (const [session, text] of Object.entries(scrollback)) {
+            writeFileSync(join(tmp, 'scrollback', scrollbackFile(session)), text);
+        }
+        // Concurrent snapshots (tmux hooks run in the background) may pick the same name.
+        for (let n = 2;; n++) {
+            const dir = join(this.root, name);
+            try {
+                renameSync(tmp, dir);
+                return dir;
+            }
+            catch (error) {
+                const code = error.code;
+                if ((code !== 'ENOTEMPTY' && code !== 'EEXIST') || n > 50) {
+                    rmSync(tmp, { recursive: true, force: true });
+                    throw error;
+                }
+                name = `${timestampDir(now)}-${n}`;
+            }
+        }
+    }
+    prune(keep) {
+        for (const dir of this.list().slice(keep))
+            rmSync(dir, { recursive: true, force: true });
+    }
+    scrollback(dir, session) {
+        const file = join(dir, 'scrollback', scrollbackFile(session));
+        if (!existsSync(file))
+            throw new BerthError(`no saved scrollback for ${session}`, ExitCode.notFound);
+        return readFileSync(file, 'utf8');
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/src/snapshot/store.js.map

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

package/dist/src/snapshot/take.d.ts

@@ -0,0 +1,5 @@
+import type { Context } from '../context.js';
+/** Record every managed live session; returns the snapshot directory. */
+/** Snapshot, never throwing: for callers whose own work must not fail on it. */
+export declare function snapshotQuietly(ctx: Context): void;
+export declare function takeSnapshot(ctx: Context, now?: Date): string;

package/dist/src/snapshot/take.js

@@ -0,0 +1,33 @@
+import { claudeConversationByName } from '../agents/claude-name.js';
+/** Record every managed live session; returns the snapshot directory. */
+/** Snapshot, never throwing: for callers whose own work must not fail on it. */
+export function snapshotQuietly(ctx) {
+    try {
+        takeSnapshot(ctx);
+    }
+    catch {
+        // The next change or hook snapshots again.
+    }
+}
+export function takeSnapshot(ctx, now = new Date()) {
+    const sessions = [];
+    const scrollback = {};
+    for (const s of ctx.tmux.listSessions()) {
+        if (!s.meta.agent)
+            continue;
+        const cwd = s.meta.cwd ?? s.path;
+        let conversation = s.meta.conversation ?? '';
+        // No hook-reported id: fall back to the name key (spec §4.2).
+        if (!conversation && s.meta.agent === 'claude') {
+            conversation = claudeConversationByName(cwd, s.name) ?? '';
+            if (conversation)
+                ctx.tmux.setMeta(s.name, { conversation });
+        }
+        sessions.push({ name: s.name, cwd, agent: s.meta.agent, argv: s.meta.argv ?? '', conversation, origin: s.meta.origin ?? 'none' });
+        scrollback[s.name] = ctx.tmux.capturePane(s.name, ctx.config.scrollbackLines);
+    }
+    const dir = ctx.store.write(sessions, scrollback, now);
+    ctx.store.prune(ctx.config.retention);
+    return dir;
+}
+//# sourceMappingURL=take.js.map

package/dist/src/snapshot/take.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"take.js","sourceRoot":"","sources":["../../../src/snapshot/take.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAEpE,yEAAyE;AACzE,gFAAgF;AAChF,MAAM,UAAU,eAAe,CAAC,GAAY;IAC1C,IAAI,CAAC;QACH,YAAY,CAAC,GAAG,CAAC,CAAC;IACpB,CAAC;IAAC,MAAM,CAAC;QACP,2CAA2C;IAC7C,CAAC;AACH,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,GAAY,EAAE,GAAG,GAAG,IAAI,IAAI,EAAE;IACzD,MAAM,QAAQ,GAAsB,EAAE,CAAC;IACvC,MAAM,UAAU,GAA2B,EAAE,CAAC;IAC9C,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,CAAC;QACxC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK;YAAE,SAAS;QAC5B,MAAM,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC;QACjC,IAAI,YAAY,GAAG,CAAC,CAAC,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC;QAC7C,8DAA8D;QAC9D,IAAI,CAAC,YAAY,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC/C,YAAY,GAAG,wBAAwB,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YAC3D,IAAI,YAAY;gBAAE,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,YAAY,EAAE,CAAC,CAAC;QAC/D,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,IAAI,MAAM,EAAE,CAAC,CAAC;QAClI,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;IAChF,CAAC;IACD,MAAM,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC;IACvD,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACtC,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/src/tmux/client.d.ts

@@ -0,0 +1,49 @@
+/** Berth metadata stored on a tmux session as user options (spec §4). */
+export declare const META_KEYS: readonly ["agent", "cwd", "argv", "conversation", "origin", "state", "note"];
+export type MetaKey = (typeof META_KEYS)[number];
+export type SessionMeta = Partial<Record<MetaKey, string>>;
+export interface LiveSession {
+    name: string;
+    attachedClients: number;
+    path: string;
+    meta: SessionMeta;
+}
+export interface TmuxTarget {
+    bin: string;
+    /** `-L` socket name; undefined addresses the default server (or $TMUX inside a pane). */
+    socket?: string;
+    /** `-S` socket path; takes precedence over `socket`. Used by hooks running inside a pane. */
+    socketPath?: string;
+}
+export declare class Tmux {
+    readonly target: TmuxTarget;
+    constructor(target: TmuxTarget);
+    private baseArgs;
+    /** Run tmux; returns stdout. Throws BerthError on failure unless `allowFail`. */
+    run(args: string[], allowFail?: boolean): {
+        ok: boolean;
+        stdout: string;
+        stderr: string;
+    };
+    serverRunning(): boolean;
+    listSessions(): LiveSession[];
+    /** Session that owns a pane, e.g. $TMUX_PANE inside an agent's hook. */
+    sessionOfPane(pane: string): string | undefined;
+    /** Working directory of the session's active pane, as the shell or agent left it. */
+    paneCurrentPath(name: string): string | undefined;
+    hasSession(name: string): boolean;
+    newSession(name: string, cwd: string, command: string): void;
+    setMeta(name: string, meta: SessionMeta): void;
+    /**
+     * Make tmux send the session's name, prefixed by its agent state, as the
+     * outer terminal's title (OSC 2). Per session, so switch-client updates it.
+     */
+    setTitle(name: string): void;
+    renameSession(from: string, to: string): void;
+    killSession(name: string): void;
+    capturePane(name: string, lines: number): string;
+    /** Command that attaches a terminal to a session. */
+    attachArgv(name: string): string[];
+    /** Server-wide kill, allowed only on Berth test sockets (implementation §5.1). */
+    killServer(): void;
+}

package/dist/src/tmux/client.js

@@ -0,0 +1,111 @@
+import { spawnSync } from 'node:child_process';
+import { BerthError, ExitCode } from '../errors.js';
+/** Berth metadata stored on a tmux session as user options (spec §4). */
+export const META_KEYS = ['agent', 'cwd', 'argv', 'conversation', 'origin', 'state', 'note'];
+const SEP = '\x1f';
+const TEST_SOCKET_PREFIX = 'berth-test-';
+export class Tmux {
+    target;
+    constructor(target) {
+        this.target = target;
+    }
+    baseArgs() {
+        // -u: UTF-8 output whatever the locale. Without it tmux replaces non-ASCII
+        // bytes and the field separator with '_' (launchd-started editors and
+        // iTerm2 AutoLaunch scripts often have no locale), breaking every row.
+        if (this.target.socketPath)
+            return ['-u', '-S', this.target.socketPath];
+        return this.target.socket ? ['-u', '-L', this.target.socket] : ['-u'];
+    }
+    /** Run tmux; returns stdout. Throws BerthError on failure unless `allowFail`. */
+    run(args, allowFail = false) {
+        const result = spawnSync(this.target.bin, [...this.baseArgs(), ...args], { encoding: 'utf8' });
+        if (result.error) {
+            throw new BerthError(`tmux unavailable (${this.target.bin}): ${result.error.message}`, ExitCode.tmuxUnavailable);
+        }
+        const ok = result.status === 0;
+        if (!ok && !allowFail) {
+            throw new BerthError(`tmux ${args[0]} failed: ${result.stderr.trim()}`, ExitCode.failure);
+        }
+        return { ok, stdout: result.stdout, stderr: result.stderr };
+    }
+    serverRunning() {
+        return this.run(['list-sessions', '-F', '#{session_name}'], true).ok;
+    }
+    listSessions() {
+        const fields = ['#{session_name}', '#{session_attached}', '#{session_path}', ...META_KEYS.map((k) => `#{@berth_${k}}`)];
+        const result = this.run(['list-sessions', '-F', fields.join(SEP)], true);
+        if (!result.ok)
+            return [];
+        return result.stdout
+            .split('\n')
+            .filter((line) => line.length > 0)
+            .map((line) => {
+            const [name, attached, path, ...values] = line.split(SEP);
+            const meta = {};
+            META_KEYS.forEach((key, i) => {
+                if (values[i])
+                    meta[key] = values[i];
+            });
+            return { name, attachedClients: Number(attached) || 0, path, meta };
+        });
+    }
+    /** Session that owns a pane, e.g. $TMUX_PANE inside an agent's hook. */
+    sessionOfPane(pane) {
+        const result = this.run(['display-message', '-p', '-t', pane, '#{session_name}'], true);
+        const name = result.stdout.trim();
+        return result.ok && name ? name : undefined;
+    }
+    /** Working directory of the session's active pane, as the shell or agent left it. */
+    paneCurrentPath(name) {
+        const result = this.run(['display-message', '-p', '-t', `=${name}:`, '#{pane_current_path}'], true);
+        const path = result.stdout.trim();
+        return result.ok && path ? path : undefined;
+    }
+    hasSession(name) {
+        return this.run(['has-session', '-t', `=${name}`], true).ok;
+    }
+    newSession(name, cwd, command) {
+        const args = ['new-session', '-d', '-s', name, '-c', cwd];
+        this.run(command ? [...args, command] : args);
+    }
+    setMeta(name, meta) {
+        for (const [key, value] of Object.entries(meta)) {
+            if (value === undefined)
+                continue;
+            // One line per session in list output: no newlines or separators in values.
+            this.run(['set-option', '-t', `=${name}:`, `@berth_${key}`, value.replace(/[\r\n\x1f]+/g, ' ')]);
+        }
+    }
+    /**
+     * Make tmux send the session's name, prefixed by its agent state, as the
+     * outer terminal's title (OSC 2). Per session, so switch-client updates it.
+     */
+    setTitle(name) {
+        const glyph = '#{?#{==:#{@berth_state},working},● ,}#{?#{==:#{@berth_state},waiting},◐ ,}#{?#{==:#{@berth_state},done},✓ ,}';
+        this.run(['set-option', '-t', `=${name}:`, 'set-titles', 'on'], true);
+        this.run(['set-option', '-t', `=${name}:`, 'set-titles-string', `${glyph}#S`], true);
+    }
+    renameSession(from, to) {
+        this.run(['rename-session', '-t', `=${from}`, to]);
+    }
+    killSession(name) {
+        this.run(['kill-session', '-t', `=${name}`]);
+    }
+    capturePane(name, lines) {
+        const result = this.run(['capture-pane', '-p', '-S', `-${lines}`, '-t', `=${name}:`], true);
+        return result.ok ? result.stdout : '';
+    }
+    /** Command that attaches a terminal to a session. */
+    attachArgv(name) {
+        return [this.target.bin, ...this.baseArgs(), 'attach-session', '-t', `=${name}`];
+    }
+    /** Server-wide kill, allowed only on Berth test sockets (implementation §5.1). */
+    killServer() {
+        if (!this.target.socket?.startsWith(TEST_SOCKET_PREFIX)) {
+            throw new BerthError('refusing to kill a tmux server that is not a Berth test server');
+        }
+        this.run(['kill-server'], true);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/src/tmux/client.js.map

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

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

@@ -0,0 +1,4 @@
+import type { Tmux } from './client.js';
+export declare function tmuxConfPath(env?: NodeJS.ProcessEnv): string;
+export declare function installTmux(tmux: Tmux, cliPath: string, env?: NodeJS.ProcessEnv): string;
+export declare function uninstallTmux(tmux: Tmux, env?: NodeJS.ProcessEnv): string;

package/dist/src/tmux/install.js

@@ -0,0 +1,64 @@
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { shellQuote } from '../shell.js';
+/**
+ * `berth tmux install` (spec §5.3): a managed block in the user's tmux config
+ * that snapshots on session create / rename / close. Hooks use a fixed array
+ * index so the user's own hooks for the same events stay in place.
+ */
+const BEGIN = '# >>> berth >>>';
+const END = '# <<< berth <<<';
+const EVENTS = ['session-created', 'session-renamed', 'session-closed'];
+const ATTACH_EVENTS = ['client-attached', 'client-session-changed'];
+const INDEX = 97;
+function hookArgs(cliPath) {
+    // Hooks are global in the user's tmux config and run in whichever server
+    // fires them: pass that server's socket so state stays per server. #{q:}
+    // quotes values for the shell (session names may contain quotes).
+    const berth = `${shellQuote(process.execPath)} ${shellQuote(cliPath)} --socket-path #{q:socket_path}`;
+    const snapshot = `${berth} snapshot >/dev/null 2>&1`;
+    // A bell asks for attention: agents without hooks become `waiting`.
+    const bell = `${berth} bell --session #{q:session_name} >/dev/null 2>&1`;
+    // Marks iTerm2 panes with their session and shows state on the new client (spec §7.3).
+    const attached = `${berth} attached --session #{q:session_name} --tty #{q:client_tty} --termtype #{q:client_termtype} >/dev/null 2>&1`;
+    return [
+        ...EVENTS.map((event) => ['set-hook', '-g', `${event}[${INDEX}]`, `run-shell -b ${JSON.stringify(snapshot)}`]),
+        ['set-hook', '-g', `alert-bell[${INDEX}]`, `run-shell -b ${JSON.stringify(bell)}`],
+        ...ATTACH_EVENTS.map((event) => ['set-hook', '-g', `${event}[${INDEX}]`, `run-shell -b ${JSON.stringify(attached)}`]),
+    ];
+}
+export function tmuxConfPath(env = process.env) {
+    return join(env.HOME || homedir(), '.tmux.conf');
+}
+function withoutBlock(text) {
+    const start = text.indexOf(BEGIN);
+    const end = text.indexOf(END);
+    if (start < 0 || end < start)
+        return text;
+    return (text.slice(0, start) + text.slice(end + END.length)).replace(/\n{3,}/g, '\n\n').replace(/^\n+/, '');
+}
+export function installTmux(tmux, cliPath, env = process.env) {
+    const file = tmuxConfPath(env);
+    const current = existsSync(file) ? readFileSync(file, 'utf8') : '';
+    const lines = hookArgs(cliPath).map((args) => args.map((a, i) => (i === 3 ? `'${a.replace(/'/g, `'\\''`)}'` : a)).join(' '));
+    const block = [BEGIN, '# Managed by berth; remove with `berth tmux uninstall`.', ...lines, END].join('\n');
+    const base = withoutBlock(current).replace(/\s*$/, '');
+    writeFileSync(file, `${base ? `${base}\n\n` : ''}${block}\n`);
+    if (tmux.serverRunning())
+        for (const args of hookArgs(cliPath))
+            tmux.run(args, true);
+    return file;
+}
+export function uninstallTmux(tmux, env = process.env) {
+    const file = tmuxConfPath(env);
+    if (existsSync(file)) {
+        const rest = withoutBlock(readFileSync(file, 'utf8')).replace(/\s*$/, '');
+        writeFileSync(file, rest ? `${rest}\n` : '');
+    }
+    if (tmux.serverRunning())
+        for (const event of [...EVENTS, 'alert-bell', ...ATTACH_EVENTS])
+            tmux.run(['set-hook', '-gu', `${event}[${INDEX}]`], true);
+    return file;
+}
+//# sourceMappingURL=install.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../../../src/tmux/install.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAClE,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC;;;;GAIG;AACH,MAAM,KAAK,GAAG,iBAAiB,CAAC;AAChC,MAAM,GAAG,GAAG,iBAAiB,CAAC;AAC9B,MAAM,MAAM,GAAG,CAAC,iBAAiB,EAAE,iBAAiB,EAAE,gBAAgB,CAAC,CAAC;AACxE,MAAM,aAAa,GAAG,CAAC,iBAAiB,EAAE,wBAAwB,CAAC,CAAC;AACpE,MAAM,KAAK,GAAG,EAAE,CAAC;AAEjB,SAAS,QAAQ,CAAC,OAAe;IAC/B,yEAAyE;IACzE,yEAAyE;IACzE,kEAAkE;IAClE,MAAM,KAAK,GAAG,GAAG,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,UAAU,CAAC,OAAO,CAAC,iCAAiC,CAAC;IACtG,MAAM,QAAQ,GAAG,GAAG,KAAK,2BAA2B,CAAC;IACrD,oEAAoE;IACpE,MAAM,IAAI,GAAG,GAAG,KAAK,mDAAmD,CAAC;IACzE,uFAAuF;IACvF,MAAM,QAAQ,GAAG,GAAG,KAAK,6GAA6G,CAAC;IACvI,OAAO;QACL,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,UAAU,EAAE,IAAI,EAAE,GAAG,KAAK,IAAI,KAAK,GAAG,EAAE,gBAAgB,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QAC9G,CAAC,UAAU,EAAE,IAAI,EAAE,cAAc,KAAK,GAAG,EAAE,gBAAgB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;QAClF,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,UAAU,EAAE,IAAI,EAAE,GAAG,KAAK,IAAI,KAAK,GAAG,EAAE,gBAAgB,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;KACtH,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG;IAC5C,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,EAAE,EAAE,YAAY,CAAC,CAAC;AACnD,CAAC;AAED,SAAS,YAAY,CAAC,IAAY;IAChC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAClC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,KAAK,GAAG,CAAC,IAAI,GAAG,GAAG,KAAK;QAAE,OAAO,IAAI,CAAC;IAC1C,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAC9G,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAU,EAAE,OAAe,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG;IACxE,MAAM,IAAI,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IAC/B,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACnE,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7H,MAAM,KAAK,GAAG,CAAC,KAAK,EAAE,yDAAyD,EAAE,GAAG,KAAK,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3G,MAAM,IAAI,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACvD,aAAa,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,IAAI,CAAC,CAAC;IAC9D,IAAI,IAAI,CAAC,aAAa,EAAE;QAAE,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,OAAO,CAAC;YAAE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACrF,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAU,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG;IACzD,MAAM,IAAI,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IAC/B,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,GAAG,YAAY,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC1E,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC/C,CAAC;IACD,IAAI,IAAI,CAAC,aAAa,EAAE;QAAE,KAAK,MAAM,KAAK,IAAI,CAAC,GAAG,MAAM,EAAE,YAAY,EAAE,GAAG,aAAa,CAAC;YAAE,IAAI,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,KAAK,EAAE,GAAG,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC;IACrJ,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/src/tools.d.ts

@@ -0,0 +1,5 @@
+import type { Context } from './context.js';
+import type { Tools } from './iterm2/install.js';
+/** Absolute path of a binary on PATH, or the name unchanged when not found. */
+export declare function resolveBinary(name: string, env?: NodeJS.ProcessEnv): string;
+export declare function toolsFor(ctx: Context, cliPath: string): Tools;

package/dist/src/tools.js

@@ -0,0 +1,16 @@
+import { existsSync } from 'node:fs';
+import { delimiter, isAbsolute, join } from 'node:path';
+/** Absolute path of a binary on PATH, or the name unchanged when not found. */
+export function resolveBinary(name, env = process.env) {
+    if (isAbsolute(name))
+        return name;
+    for (const dir of (env.PATH ?? '').split(delimiter)) {
+        if (dir && existsSync(join(dir, name)))
+            return join(dir, name);
+    }
+    return name;
+}
+export function toolsFor(ctx, cliPath) {
+    return { node: process.execPath, cli: cliPath, tmux: resolveBinary(ctx.config.tmuxBin), socket: ctx.config.tmuxSocket, path: process.env.PATH };
+}
+//# sourceMappingURL=tools.js.map

package/dist/src/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAIxD,+EAA+E;AAC/E,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG;IAC3D,IAAI,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAClC,KAAK,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;QACpD,IAAI,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,GAAY,EAAE,OAAe;IACpD,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,QAAQ,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,UAAU,EAAE,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;AAClJ,CAAC"}

package/package.json

@@ -1,6 +1,51 @@
 {
   "name": "@berthdev/berth",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.1-rc.0",
+  "description": "Keep terminal-based coding agents running in tmux and bring each back, conversation included.",
+  "type": "module",
+  "main": "dist/src/index.js",
+  "types": "dist/src/index.d.ts",
+  "bin": {
+    "berth": "dist/src/cli/main.js"
+  },
+  "files": [
+    "dist/src",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "smol-toml": "^1.3.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "typescript": "^5.6.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/maxzyma/berth.git",
+    "directory": "packages/core"
+  },
+  "keywords": [
+    "tmux",
+    "coding agent",
+    "claude code",
+    "codex",
+    "agents",
+    "terminal"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "prepublishOnly": "tsc -b"
+  },
+  "homepage": "https://github.com/maxzyma/berth#readme",
+  "bugs": {
+    "url": "https://github.com/maxzyma/berth/issues"
+  }
+}