@berthdev/berth 0.3.5 → 0.4.2

package/dist/src/index.js.map

@@ -1 +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,UAAU,EAAE,QAAQ,EAAmB,MAAM,mBAAmB,CAAC;AAClI,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAmB,MAAM,wBAAwB,CAAC;AAC7H,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAuC,MAAM,qBAAqB,CAAC;AACzF,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAC/D,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"}
+{"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,UAAU,EAAE,QAAQ,EAAE,iBAAiB,EAAE,iBAAiB,EAAmB,MAAM,mBAAmB,CAAC;AACxK,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAmB,MAAM,wBAAwB,CAAC;AACrJ,OAAO,EAAE,MAAM,EAAgB,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAuC,MAAM,qBAAqB,CAAC;AACzF,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,aAAa,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,kBAAkB,EAAsB,MAAM,qBAAqB,CAAC;AACvJ,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACrF,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;AAErD,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,eAAe,EAAuB,MAAM,uBAAuB,CAAC;AAEpI,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,eAAe,EAA0B,MAAM,qBAAqB,CAAC;AAEnH,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,kBAAkB,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAqB,MAAM,qBAAqB,CAAC;AAEjJ,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEpD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}

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

@@ -16,6 +16,8 @@ export interface Tools {
     cli: string;
     tmux: string;
     socket?: string;
+    socketPath?: string;
+    env?: Record<string, string>;
     /** PATH at install time: AutoLaunch scripts get a minimal one, without tmux or the agents. */
     path?: string;
 }

package/dist/src/iterm2/install.js

@@ -17,7 +17,7 @@ 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)}` : '';
+    const socket = tools.socketPath ? ` -S ${shellQuote(tools.socketPath)}` : 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. */
@@ -29,7 +29,7 @@ export function reattach(ctx, tools, session) {
     return attachCommand(ctx, tools, session);
 }
 export function autoLaunchScript(tools) {
-    const berth = JSON.stringify([tools.node, tools.cli, ...(tools.socket ? ['--socket', tools.socket] : [])]);
+    const berth = JSON.stringify([tools.node, tools.cli, ...(tools.socketPath ? ['--socket-path', tools.socketPath] : tools.socket ? ['--socket', tools.socket] : [])]);
     return `#!/usr/bin/env python3
 """Berth for iTerm2: put each pane iTerm2 restored back in its agent session.
 
@@ -48,7 +48,8 @@ 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", ""))
+ENV = dict(os.environ, **${JSON.stringify(tools.env ?? {})})
+ENV["PATH"] = ${JSON.stringify(tools.path ?? '')} or os.environ.get("PATH", "")
 
 
 def attach_command(session_name):
@@ -67,6 +68,38 @@ async def panes(app):
                 yield session
 
 
+async def ready_prompt(connection, session, name):
+    if await session.async_get_variable(VARIABLE) != name:
+        return None
+    job = await session.async_get_variable("jobName")
+    if os.path.basename(job or "").lstrip("-") not in {"sh", "bash", "zsh", "fish", "tcsh", "xonsh"}:
+        return None
+    prompt = await iterm2.async_get_last_prompt(connection, session.session_id)
+    if prompt and prompt.state == iterm2.PromptState.EDITING and prompt.command == "":
+        return prompt.unique_id
+    return None
+
+
+async def restore_pane(connection, session, name):
+    try:
+        async with iterm2.Transaction(connection):
+            prompt_id = await ready_prompt(connection, session, name)
+        if not prompt_id:
+            print("Berth: reattach deferred for %s; use berth iterm2 reattach from a ready shell." % name)
+            return
+        command = await asyncio.get_running_loop().run_in_executor(None, attach_command, name)
+        if not command:
+            print("Berth: could not restore %s; inspect berth doctor." % name)
+            return
+        async with iterm2.Transaction(connection):
+            if await ready_prompt(connection, session, name) == prompt_id:
+                await session.async_send_text(command + "\\n")
+            else:
+                print("Berth: pane changed while restoring %s; automatic attachment deferred." % name)
+    except (AttributeError, iterm2.RPCException) as error:
+        print("Berth: cannot verify shell readiness for %s: %s" % (name, error))
+
+
 async def main(connection):
     app = await iterm2.async_get_app(connection)
     # Window restoration may still be running when AutoLaunch starts.
@@ -79,15 +112,7 @@ async def main(connection):
         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())
+        await restore_pane(connection, session, name)
 
 
 iterm2.run_until_complete(main)

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

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

package/dist/src/present/attach.js

@@ -1,6 +1,9 @@
+import { withLock } from '../restore/lock.js';
+import { createHash } from 'node:crypto';
+import { profileEnvironment, readProfile } from '../agents/profile.js';
 import { appendFileSync } from 'node:fs';
 import { stamp } from '../registry/sessions.js';
-import { isIterm2, presentState } from './state.js';
+import { clientsOf, isIterm2, presentState } from './state.js';
 import { hookHint, hookStatus } from '../agents/hooks.js';
 import { adoptDiscovered } from '../snapshot/take.js';
 /** iTerm2 user variable naming the session a pane shows (spec §7.3). */
@@ -15,6 +18,13 @@ export function setUserVar(name, value) {
  * client is shown the session's current state.
  */
 export function clientAttached(ctx, client) {
+    withLock(ctx.config.stateDir, () => attachCurrentClient(ctx, client), 3000);
+}
+function attachCurrentClient(ctx, event) {
+    const current = clientsOf(ctx.tmux, event.session).find((client) => client.tty === event.tty);
+    if (!current)
+        return;
+    const client = { ...current, session: event.session };
     adoptDiscovered(ctx);
     const live = ctx.tmux.listSessions().find((s) => s.name === client.session);
     if (!live?.meta.agent)
@@ -31,17 +41,19 @@ export function clientAttached(ctx, client) {
     }
     presentState(ctx.tmux, client.session, live.meta.state ?? '', { note: live.meta.note, clients: [{ tty: client.tty, termtype: client.termtype }] });
     if (live.meta.origin !== 'vscode')
-        hintHooksOnce(ctx, live.meta.agent, client.tty);
+        hintHooksOnce(ctx, live.meta.agent, client.tty, live.meta.profile);
 }
 const HINT_SECONDS = 10;
 /**
  * Terminals other than VS Code (which asks in its own UI) get the hooks hint
  * in tmux's status line, once per agent per tmux server.
  */
-function hintHooksOnce(ctx, agent, tty) {
-    if (hookStatus(agent, ctx.env) !== 'missing')
+function hintHooksOnce(ctx, agent, tty, rawProfile) {
+    const profile = readProfile(agent, rawProfile);
+    if (!profile || hookStatus(agent, profileEnvironment(agent, profile, ctx.env)) !== 'missing')
         return;
-    const flag = `@berth_hinted_${agent}`;
+    const key = createHash('sha256').update(JSON.stringify(profile.environment)).digest('hex').slice(0, 12);
+    const flag = `@berth_hinted_${agent}_${key}`;
     if (ctx.tmux.run(['show-option', '-gqv', flag], true).stdout.trim())
         return;
     ctx.tmux.run(['set-option', '-g', flag, '1'], true);

package/dist/src/present/attach.js.map

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

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

@@ -1,3 +1,4 @@
+import type { Context } from '../context.js';
 import type { Tmux } from '../tmux/client.js';
 export declare function isIterm2(termtype: string): boolean;
 export declare function sequencesFor(state: string, session: string, iterm2: boolean, note?: string): string;
@@ -12,3 +13,5 @@ export interface PresentOptions {
 }
 /** Write the state to each attached terminal; failures are ignored (best effort). */
 export declare function presentState(tmux: Tmux, session: string, state: string, options?: PresentOptions): number;
+/** Attachment must not replay an inventory state older than a hook or acknowledgement. */
+export declare function presentCurrentState(ctx: Context, session: string): void;

package/dist/src/present/state.js

@@ -1,3 +1,5 @@
+import { withLock } from '../restore/lock.js';
+import { formatFields, readFields } from '../tmux/fields.js';
 import { appendFileSync } from 'node:fs';
 /**
  * Show a session's agent state on every terminal attached to it (spec §6, §7.4).
@@ -34,16 +36,10 @@ export function sequencesFor(state, session, iterm2, note = '') {
     return `${OSC}9;4;${PROGRESS[state] ?? '0'};0${ST}${OSC}2;${glyph ? `${glyph} ` : ''}${session}${ST}`;
 }
 export function clientsOf(tmux, session) {
-    const result = tmux.run(['list-clients', '-t', `=${session}`, '-F', '#{client_tty}\t#{client_termtype}'], true);
+    const result = tmux.run(['list-clients', '-t', `=${session}`, '-F', formatFields(['client_tty', 'client_termtype'])], true);
     if (!result.ok)
         return [];
-    return result.stdout
-        .split('\n')
-        .filter(Boolean)
-        .map((line) => {
-        const [tty, termtype = ''] = line.split('\t');
-        return { tty, termtype };
-    });
+    return readFields(result.stdout, 2).map(([tty, termtype]) => ({ tty, termtype }));
 }
 /** Write the state to each attached terminal; failures are ignored (best effort). */
 export function presentState(tmux, session, state, options = {}) {
@@ -60,4 +56,12 @@ export function presentState(tmux, session, state, options = {}) {
     }
     return written;
 }
+/** Attachment must not replay an inventory state older than a hook or acknowledgement. */
+export function presentCurrentState(ctx, session) {
+    withLock(ctx.config.stateDir, () => {
+        const live = ctx.tmux.listSessions().find((row) => row.name === session);
+        if (live)
+            presentState(ctx.tmux, session, live.meta.state ?? '', { note: live.meta.note });
+    }, 3000);
+}
 //# sourceMappingURL=state.js.map

package/dist/src/present/state.js.map

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

package/dist/src/process-arguments.d.ts

@@ -0,0 +1,2 @@
+/** Process display strings are not a shell command and cannot recover word boundaries. */
+export declare function processArguments(pid: number): string[] | undefined;

package/dist/src/process-arguments.js

@@ -0,0 +1,59 @@
+import { spawnSync } from 'node:child_process';
+import { readFileSync } from 'node:fs';
+const MAX_BYTES = 16 * 1024 * 1024;
+// Darwin: SYS___sysctl=202, CTL_KERN=1, KERN_PROCARGS2=49.
+// Keep the bridge inline so the CLI and extension bundle share the same reader.
+// It returns argc argv entries only; environment strings never leave this process.
+// XNU exec_extract_strings aligns the saved executable path to 8 bytes for
+// supported 64-bit macOS processes. kern_procargs2 removes the 16-byte
+// executable_path= prefix and prepends argc (4 bytes). Do not skip NULs: they
+// may be empty argv entries, and skipping them would expose environment data.
+const DARWIN_ARGV = String.raw `use strict;
+use warnings;
+my $pid = shift @ARGV;
+my $mib = pack('i3', 1, 49, $pid);
+my $size = pack('Q', 0);
+syscall(202, $mib, 3, 0, $size, 0, 0) == 0 or die "size";
+my $length = unpack('Q', $size);
+$length > 4 && $length <= 16777216 or die "bound";
+my $buf = "\0" x $length;
+syscall(202, $mib, 3, $buf, $size, 0, 0) == 0 or die "read";
+$buf = substr($buf, 0, unpack('Q', $size));
+my $argc = unpack('i', $buf);
+my $path_end = index($buf, "\0", 4);
+$path_end >= 4 && $argc > 0 && $argc <= 65536 or die "header";
+my $start = 4 + int(($path_end - 4 + 1 + 7) / 8) * 8;
+$start < length($buf) or die "alignment";
+substr($buf, $path_end, $start - $path_end) !~ /[^\0]/ or die "padding";
+my $end = $start;
+for (1 .. $argc) { $end = index($buf, "\0", $end); $end >= 0 or die "truncated"; $end++; }
+print substr($buf, $start, $end - $start);
+`;
+/** Process display strings are not a shell command and cannot recover word boundaries. */
+export function processArguments(pid) {
+    if (!Number.isSafeInteger(pid) || pid < 1 || pid > 0x7fffffff)
+        return undefined;
+    try {
+        let bytes;
+        if (process.platform === 'linux')
+            bytes = readFileSync(`/proc/${pid}/cmdline`);
+        else if (process.platform === 'darwin') {
+            const result = spawnSync('/usr/bin/perl', ['-e', DARWIN_ARGV, String(pid)], {
+                timeout: 1000, killSignal: 'SIGKILL', maxBuffer: MAX_BYTES, encoding: 'buffer',
+            });
+            if (result.status !== 0 || result.error)
+                return undefined;
+            bytes = result.stdout;
+        }
+        else
+            return undefined;
+        if (!bytes.length || bytes.length > MAX_BYTES || bytes.at(-1) !== 0)
+            return undefined;
+        const words = new TextDecoder('utf-8', { fatal: true }).decode(bytes).slice(0, -1).split('\0');
+        return words[0] ? words : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=process-arguments.js.map

package/dist/src/process-arguments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-arguments.js","sourceRoot":"","sources":["../../src/process-arguments.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,MAAM,SAAS,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AACnC,2DAA2D;AAC3D,gFAAgF;AAChF,mFAAmF;AACnF,2EAA2E;AAC3E,uEAAuE;AACvE,8EAA8E;AAC9E,8EAA8E;AAC9E,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;CAoB7B,CAAC;AAEF,0FAA0F;AAC1F,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,GAAG,GAAG,UAAU;QAAE,OAAO,SAAS,CAAC;IAChF,IAAI,CAAC;QACH,IAAI,KAAa,CAAC;QAClB,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO;YAAE,KAAK,GAAG,YAAY,CAAC,SAAS,GAAG,UAAU,CAAC,CAAC;aAC1E,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACvC,MAAM,MAAM,GAAG,SAAS,CAAC,eAAe,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE;gBAC1E,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ;aAC/E,CAAC,CAAC;YACH,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,KAAK;gBAAE,OAAO,SAAS,CAAC;YAC1D,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC;QACxB,CAAC;;YAAM,OAAO,SAAS,CAAC;QACxB,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,GAAG,SAAS,IAAI,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QACtF,MAAM,KAAK,GAAG,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC/F,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,SAAS,CAAC;IAAC,CAAC;AAC/B,CAAC"}

package/dist/src/process-directory.d.ts

@@ -0,0 +1,2 @@
+/** Read directory identity, never a terminal-escaped rendering of its name. */
+export declare function processDirectory(pid: number): string | undefined;

package/dist/src/process-directory.js

@@ -0,0 +1,37 @@
+import { spawnSync } from 'node:child_process';
+import { readlinkSync } from 'node:fs';
+// Darwin proc_info(336), PROC_INFO_CALL_PIDINFO(2), PROC_PIDVNODEPATHINFO(9).
+// proc_vnodepathinfo contains two vnode_info_path structures; each ends with
+// vip_path[MAXPATHLEN=1024]. Derive the offset from the returned structure size.
+const DARWIN_CWD = String.raw `
+use strict;
+use warnings;
+my $pid = int(shift @ARGV);
+my $buffer = "\0" x 16384;
+my $size = syscall(336, 2, $pid, 9, 0, $buffer, 16384);
+$size > 2048 && $size <= 16384 && $size % 2 == 0 or die "process directory unavailable";
+my $path = substr($buffer, $size / 2 - 1024, 1024);
+my $end = index($path, "\0");
+$end > 0 or die "invalid directory";
+print substr($path, 0, $end);
+`;
+/** Read directory identity, never a terminal-escaped rendering of its name. */
+export function processDirectory(pid) {
+    if (!Number.isSafeInteger(pid) || pid < 1 || pid > 0x7fffffff)
+        return undefined;
+    try {
+        if (process.platform === 'linux')
+            return readlinkSync(`/proc/${pid}/cwd`);
+        if (process.platform !== 'darwin')
+            return undefined;
+        const result = spawnSync('/usr/bin/perl', ['-e', DARWIN_CWD, String(pid)], { timeout: 1000, killSignal: 'SIGKILL', maxBuffer: 16384 });
+        if (result.status !== 0 || result.error || !result.stdout.length)
+            return undefined;
+        const path = new TextDecoder('utf-8', { fatal: true }).decode(result.stdout);
+        return path.startsWith('/') ? path : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=process-directory.js.map

package/dist/src/process-directory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-directory.js","sourceRoot":"","sources":["../../src/process-directory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,8EAA8E;AAC9E,6EAA6E;AAC7E,iFAAiF;AACjF,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAA;;;;;;;;;;;CAW5B,CAAC;AAEF,+EAA+E;AAC/E,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,GAAG,GAAG,UAAU;QAAE,OAAO,SAAS,CAAC;IAChF,IAAI,CAAC;QACH,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO;YAAE,OAAO,YAAY,CAAC,SAAS,GAAG,MAAM,CAAC,CAAC;QAC1E,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ;YAAE,OAAO,SAAS,CAAC;QACpD,MAAM,MAAM,GAAG,SAAS,CAAC,eAAe,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;QACvI,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM;YAAE,OAAO,SAAS,CAAC;QACnF,MAAM,IAAI,GAAG,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC7E,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IACjD,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,SAAS,CAAC;IAAC,CAAC;AAC/B,CAAC"}

package/dist/src/process-owner.d.ts

@@ -0,0 +1,7 @@
+export interface ProcessLifetime {
+    key: string;
+    bornAt: number;
+}
+/** Process birth plus boot identity, not PID existence alone. */
+export declare function processLifetime(pid: number): ProcessLifetime | undefined;
+export declare function processOwnerAlive(pid: number, lifetime: string | undefined, recordedAt: number): boolean;

package/dist/src/process-owner.js

@@ -0,0 +1,51 @@
+import { spawnSync } from 'node:child_process';
+import { readFileSync } from 'node:fs';
+let own;
+let boot;
+function bootIdentity() {
+    if (boot)
+        return boot;
+    if (process.platform === 'linux')
+        boot = readFileSync('/proc/sys/kernel/random/boot_id', 'utf8').trim();
+    else {
+        const result = spawnSync('sysctl', ['-n', 'kern.boottime'], { encoding: 'utf8', timeout: 1000, killSignal: 'SIGKILL' });
+        if (result.status !== 0)
+            throw new Error('Cannot verify machine boot identity.');
+        boot = result.stdout.trim();
+    }
+    return boot;
+}
+/** Process birth plus boot identity, not PID existence alone. */
+export function processLifetime(pid) {
+    if (!Number.isSafeInteger(pid) || pid <= 0)
+        return undefined;
+    if (pid === process.pid && own)
+        return own;
+    const result = spawnSync('ps', ['-p', String(pid), '-o', 'lstart='], {
+        env: { ...process.env, LC_ALL: 'C' }, encoding: 'utf8', timeout: 1000, killSignal: 'SIGKILL',
+    });
+    if (result.status !== 0 || !result.stdout.trim()) {
+        try {
+            process.kill(pid, 0);
+        }
+        catch (error) {
+            if (error.code === 'ESRCH')
+                return undefined;
+        }
+        throw new Error(`Cannot verify process lifetime for ${pid}.`);
+    }
+    const bornAt = Date.parse(result.stdout.trim());
+    if (!Number.isFinite(bornAt))
+        throw new Error(`Invalid process lifetime for ${pid}.`);
+    const lifetime = { key: `${bootIdentity()}:${pid}:${bornAt}`, bornAt };
+    if (pid === process.pid)
+        own = lifetime;
+    return lifetime;
+}
+export function processOwnerAlive(pid, lifetime, recordedAt) {
+    const current = processLifetime(pid);
+    if (!current)
+        return false;
+    return lifetime ? current.key === lifetime : current.bornAt <= recordedAt;
+}
+//# sourceMappingURL=process-owner.js.map

package/dist/src/process-owner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-owner.js","sourceRoot":"","sources":["../../src/process-owner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAGvC,IAAI,GAAgC,CAAC;AACrC,IAAI,IAAwB,CAAC;AAC7B,SAAS,YAAY;IACnB,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC;IACtB,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO;QAAE,IAAI,GAAG,YAAY,CAAC,iCAAiC,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;SACnG,CAAC;QACJ,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,eAAe,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC,CAAC;QACxH,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QACjF,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IAC9B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IAC7D,IAAI,GAAG,KAAK,OAAO,CAAC,GAAG,IAAI,GAAG;QAAE,OAAO,GAAG,CAAC;IAC3C,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,EAAE;QACnE,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS;KAC7F,CAAC,CAAC;IACH,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;QACjD,IAAI,CAAC;YAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QAAC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAC3C,IAAK,KAA+B,CAAC,IAAI,KAAK,OAAO;gBAAE,OAAO,SAAS,CAAC;QAC1E,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,sCAAsC,GAAG,GAAG,CAAC,CAAC;IAChE,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IAChD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,GAAG,GAAG,CAAC,CAAC;IACtF,MAAM,QAAQ,GAAG,EAAE,GAAG,EAAE,GAAG,YAAY,EAAE,IAAI,GAAG,IAAI,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC;IACvE,IAAI,GAAG,KAAK,OAAO,CAAC,GAAG;QAAE,GAAG,GAAG,QAAQ,CAAC;IACxC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,GAAW,EAAE,QAA4B,EAAE,UAAkB;IAC7F,MAAM,OAAO,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;IACrC,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAC3B,OAAO,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,IAAI,UAAU,CAAC;AAC5E,CAAC"}

package/dist/src/registry/directory.d.ts

@@ -0,0 +1,2 @@
+export declare function usableDirectory(path: string): boolean;
+export declare function sameDirectory(left: string, right: string): boolean;

package/dist/src/registry/directory.js

@@ -0,0 +1,19 @@
+import { accessSync, constants, realpathSync, statSync } from 'node:fs';
+export function usableDirectory(path) {
+    try {
+        accessSync(path, constants.X_OK);
+        return statSync(path).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+export function sameDirectory(left, right) {
+    try {
+        return realpathSync(left) === realpathSync(right);
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=directory.js.map

package/dist/src/registry/directory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"directory.js","sourceRoot":"","sources":["../../../src/registry/directory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExE,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,IAAI,CAAC;QAAC,UAAU,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;QAAC,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;IAAC,CAAC;IAC9E,MAAM,CAAC;QAAC,OAAO,KAAK,CAAC;IAAC,CAAC;AACzB,CAAC;AACD,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,KAAa;IACvD,IAAI,CAAC;QAAC,OAAO,YAAY,CAAC,IAAI,CAAC,KAAK,YAAY,CAAC,KAAK,CAAC,CAAC;IAAC,CAAC;IAC1D,MAAM,CAAC;QAAC,OAAO,KAAK,CAAC;IAAC,CAAC;AACzB,CAAC"}

package/dist/src/registry/discover.d.ts

@@ -1,7 +1,7 @@
 import type { Context } from '../context.js';
 /**
- * Discovery (spec §4.3): a session nobody stamped is recognised as an agent
- * session from the processes in its active pane, so any launcher - or none -
+ * Discovery (spec §4.3): an unbound session or managed shell is recognised as
+ * an agent session from its active pane, so any launcher - or none -
  * gets its sessions managed without knowing Berth.
  */
 export interface Detected {
@@ -9,19 +9,30 @@ export interface Detected {
     /** The agent's command line, starting with its binary. */
     argv: string;
     pid: number;
+    argvIssue?: string;
 }
-interface Proc {
+export interface Proc {
     pid: number;
     ppid: number;
     args: string;
+    native?: boolean;
 }
+export declare const ARGUMENTS_UNAVAILABLE = "Launch arguments could not be verified. Check process access (macOS also requires /usr/bin/perl) before restoring.";
+export declare const BINDING_UNVERIFIED = "Recovery binding needs verification. No agent process identity was recorded; verified identity evidence must confirm the conversation.";
+export declare const PRODUCER_CHANGED = "Agent producer changed. Verify the conversation before restoring.";
+export declare function processes(): Proc[];
 /**
  * The agent among a process and its descendants: a program named like an
  * agent binary, or a script so named run by an interpreter (`node <cli>`).
  * Names are what matter: some agents run as a binary named after its version,
  * so tmux's pane_current_command does not tell.
  */
+export declare function agentsAmong(rootPid: number, procs: Proc[], depth?: number): Detected[];
 export declare function agentAmong(rootPid: number, procs: Proc[]): Detected | undefined;
+export declare function sessionProducers(ctx: Context, session: string, procs?: Proc[], allPanes?: string): (Detected & {
+    pane: string;
+    cwd: string;
+})[];
 /**
  * A process's working directory. The pane's current path is not it: tmux
  * reads the foreground process group's leader, which is a launcher's shell
@@ -31,8 +42,7 @@ export declare function cwdOf(pid: number): string | undefined;
 /** The agent running in a session's active pane, if any. */
 export declare function detectAgent(ctx: Context, session: string): Detected | undefined;
 /**
- * Stamp every unmanaged live session whose active pane runs an agent. Returns
+ * Stamp every unmanaged session or managed shell whose active pane runs an agent. Returns
  * the sessions stamped; the caller snapshots. Never throws.
  */
 export declare function discover(ctx: Context): string[];
-export {};