@cotal-ai/seat 0.47.0 → 0.48.0

package/dist/handle.d.ts

@@ -0,0 +1,36 @@
+import type { SeatRecord } from "./record.js";
+export interface SeatAttachSession {
+    readonly cols: number;
+    readonly rows: number;
+    backlog(): Promise<Buffer>;
+    onData(fn: (chunk: Buffer) => void): () => void;
+    onExit(fn: () => void): () => void;
+    write(data: string): void;
+    resize(cols: number, rows: number): void;
+}
+export interface SeatHandle {
+    readonly name: string;
+    readonly kind: "pty";
+    readonly reference: {
+        kind: "pty";
+        id: string;
+    };
+    readonly pid: number;
+    readonly record: SeatRecord;
+    status(): "running" | "exited";
+    exitInfo(): {
+        code?: number;
+        signal?: number;
+    } | undefined;
+    stop(opts?: {
+        graceful?: boolean;
+    }): void;
+    waitForExit(): Promise<void>;
+    interrupt(): void;
+    write(data: string): void;
+    attach(): SeatAttachSession;
+    close(): void;
+}
+export declare function adoptSeatSync(record: SeatRecord): SeatHandle;
+export declare function adoptSeat(record: SeatRecord): Promise<SeatHandle>;
+//# sourceMappingURL=handle.d.ts.map

package/dist/handle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handle.d.ts","sourceRoot":"","sources":["../src/handle.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3B,MAAM,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IAChD,MAAM,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IACnC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1C;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,SAAS,EAAE;QAAE,IAAI,EAAE,KAAK,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAChD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,MAAM,IAAI,SAAS,GAAG,QAAQ,CAAC;IAC/B,QAAQ,IAAI;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IAC3D,IAAI,CAAC,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IAC1C,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,SAAS,IAAI,IAAI,CAAC;IAClB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,IAAI,iBAAiB,CAAC;IAC5B,KAAK,IAAI,IAAI,CAAC;CACf;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CAoJ5D;AAED,wBAAsB,SAAS,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAIvE"}

package/dist/handle.js

@@ -0,0 +1,158 @@
+import { SeatClient } from "./client.js";
+export function adoptSeatSync(record) {
+    const client = new SeatClient(record);
+    const ready = client.connect();
+    let status = "running";
+    let exit;
+    let cols = 120;
+    let rows = 32;
+    let helloGeometryApplied = false;
+    const liveUnsubs = new Set();
+    const whenReady = () => ready.then((hello) => {
+        // Hello reports spawn size. Re-applying it on every later() overwrites a
+        // resize that already updated these fields (mesh-attach-plane resize cell).
+        if (!helloGeometryApplied) {
+            cols = hello.cols;
+            rows = hello.rows;
+            helloGeometryApplied = true;
+        }
+        status = hello.status;
+        exit = hello.exit;
+        return client;
+    });
+    const later = (fn) => {
+        void whenReady()
+            .then(fn)
+            .catch(() => undefined);
+    };
+    later((c) => {
+        c.onExit(() => {
+            status = "exited";
+        });
+    });
+    return {
+        name: record.name,
+        kind: "pty",
+        reference: { kind: "pty", id: record.id },
+        pid: record.childPid,
+        record,
+        status: () => status,
+        exitInfo: () => exit,
+        stop: (opts) => {
+            later((c) => c.stop(opts?.graceful === false ? "hard" : "graceful"));
+        },
+        waitForExit: async () => {
+            try {
+                const c = await whenReady();
+                if (status !== "exited") {
+                    const info = await c.waitExit();
+                    status = "exited";
+                    if (info)
+                        exit = info;
+                }
+            }
+            finally {
+                client.close();
+            }
+        },
+        interrupt: () => {
+            later((c) => c.interrupt());
+        },
+        write: (data) => {
+            later((c) => c.write(data));
+        },
+        attach: () => {
+            const sessionUnsubs = new Set();
+            // Fast-exit children print and die before hello. onData must replay the
+            // screen, and onExit must wait for that replay so a dump-then-exit spawn
+            // is not observed as an empty attach (env-isolate printenv).
+            let pendingOutput = Promise.resolve();
+            return {
+                get cols() {
+                    return cols;
+                },
+                get rows() {
+                    return rows;
+                },
+                backlog: async () => {
+                    const c = await whenReady();
+                    const snap = await c.snapshot();
+                    cols = snap.cols;
+                    rows = snap.rows;
+                    return Buffer.from(snap.data, "utf8");
+                },
+                onData: (fn) => {
+                    let unsub = () => { };
+                    let cancelled = false;
+                    let releaseOutput = () => { };
+                    const outputReady = new Promise((resolve) => {
+                        releaseOutput = resolve;
+                    });
+                    pendingOutput = pendingOutput.then(() => outputReady);
+                    later(async (c) => {
+                        try {
+                            const u = await c.subscribeOutput(fn);
+                            unsub = u;
+                            if (cancelled) {
+                                u();
+                                return;
+                            }
+                            sessionUnsubs.add(u);
+                            liveUnsubs.add(u);
+                        }
+                        finally {
+                            releaseOutput();
+                        }
+                    });
+                    return () => {
+                        cancelled = true;
+                        unsub();
+                        sessionUnsubs.delete(unsub);
+                        liveUnsubs.delete(unsub);
+                    };
+                },
+                onExit: (fn) => {
+                    let unsub = () => { };
+                    let cancelled = false;
+                    later(async (c) => {
+                        await pendingOutput;
+                        if (cancelled)
+                            return;
+                        unsub = c.onExit(fn);
+                        sessionUnsubs.add(unsub);
+                        liveUnsubs.add(unsub);
+                    });
+                    return () => {
+                        cancelled = true;
+                        unsub();
+                        sessionUnsubs.delete(unsub);
+                        liveUnsubs.delete(unsub);
+                    };
+                },
+                write: (data) => {
+                    later((c) => c.write(data));
+                },
+                resize: (c, r) => {
+                    if (c <= 0 || r <= 0)
+                        return;
+                    cols = c;
+                    rows = r;
+                    helloGeometryApplied = true;
+                    later((cli) => cli.resize(c, r));
+                },
+            };
+        },
+        close: () => {
+            for (const u of liveUnsubs)
+                u();
+            liveUnsubs.clear();
+            client.close();
+        },
+    };
+}
+export async function adoptSeat(record) {
+    const handle = adoptSeatSync(record);
+    await handle.attach().backlog();
+    return handle;
+}
+//# sourceMappingURL=handle.js.map

package/dist/handle.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { PROTOCOL_VERSION, unsupportedTransport } from "./protocol.js";
+export { launchSeat, loadSeat, type LaunchSeatOpts, type SeatLaunchSpec } from "./launcher.js";
+export { adoptSeat, adoptSeatSync, type SeatHandle, type SeatAttachSession } from "./handle.js";
+export { readRecord, recordPath, socketPath, type SeatRecord } from "./record.js";
+export { SeatClient } from "./client.js";
+export { runCustodian, type CustodianLaunch } from "./custodian.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACvE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/F,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,KAAK,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChG,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAClF,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export { PROTOCOL_VERSION, unsupportedTransport } from "./protocol.js";
+export { launchSeat, loadSeat } from "./launcher.js";
+export { adoptSeat, adoptSeatSync } from "./handle.js";
+export { readRecord, recordPath, socketPath } from "./record.js";
+export { SeatClient } from "./client.js";
+export { runCustodian } from "./custodian.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACvE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAA4C,MAAM,eAAe,CAAC;AAC/F,OAAO,EAAE,SAAS,EAAE,aAAa,EAA2C,MAAM,aAAa,CAAC;AAChG,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAmB,MAAM,aAAa,CAAC;AAClF,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,YAAY,EAAwB,MAAM,gBAAgB,CAAC"}

package/dist/launcher.d.ts

@@ -0,0 +1,17 @@
+import { type SeatRecord } from "./record.js";
+export interface SeatLaunchSpec {
+    command: string;
+    args: string[];
+    env?: Record<string, string>;
+    confirm?: boolean;
+}
+export interface LaunchSeatOpts {
+    root: string;
+    name: string;
+    spec: SeatLaunchSpec;
+    cwd: string;
+}
+export declare function launchSeat(opts: LaunchSeatOpts): SeatRecord;
+export declare function loadSeat(root: string, id: string): SeatRecord;
+export declare function readSeatFile(path: string): SeatRecord;
+//# sourceMappingURL=launcher.d.ts.map

package/dist/launcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"launcher.d.ts","sourceRoot":"","sources":["../src/launcher.ts"],"names":[],"mappings":"AAIA,OAAO,EAAmD,KAAK,UAAU,EAAc,MAAM,aAAa,CAAC;AAG3G,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;CACb;AAwBD,wBAAgB,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,UAAU,CA8D3D;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,UAAU,CAE7D;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAErD"}

package/dist/launcher.js

@@ -0,0 +1,102 @@
+import { spawn, spawnSync } from "node:child_process";
+import { closeSync, existsSync, mkdirSync, openSync, readFileSync, unlinkSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { capabilityToken, recordPath, seatId, socketPath, readRecord } from "./record.js";
+import { unsupportedTransport } from "./protocol.js";
+function packageRoot() {
+    return dirname(dirname(fileURLToPath(import.meta.url)));
+}
+/** Always the compiled entry. tsx loading `src/` must not spawn a missing `src/custodian.js`. */
+function custodianEntry() {
+    const path = join(packageRoot(), "dist", "custodian.js");
+    if (!existsSync(path))
+        throw new Error(`custodian entry missing at ${path}; build @cotal-ai/seat first`);
+    return path;
+}
+function pidLive(pid) {
+    if (typeof pid !== "number" || pid <= 0)
+        return false;
+    try {
+        const stat = readFileSync(`/proc/${pid}/stat`, "utf8");
+        const state = stat.slice(stat.lastIndexOf(") ") + 2).split(" ")[0];
+        return state !== "Z";
+    }
+    catch {
+        return false;
+    }
+}
+export function launchSeat(opts) {
+    if (process.platform !== "linux")
+        throw unsupportedTransport();
+    mkdirSync(opts.root, { recursive: true, mode: 0o700 });
+    const id = seatId();
+    const token = capabilityToken();
+    const socket = socketPath(opts.root, id);
+    const recPath = recordPath(opts.root, id);
+    mkdirSync(dirname(recPath), { recursive: true, mode: 0o700 });
+    const logPath = join(dirname(recPath), "custodian.log");
+    const payload = JSON.stringify({
+        id,
+        name: opts.name,
+        command: opts.spec.command,
+        args: opts.spec.args,
+        env: opts.spec.env ?? {},
+        cwd: opts.cwd,
+        socket,
+        token,
+        recordPath: recPath,
+        logPath,
+        confirm: Boolean(opts.spec.confirm),
+    });
+    // Payload carries spec.env (provider keys) and the capability token.
+    // argv is world-readable via /proc/<pid>/cmdline (0444). Inherit a 0600
+    // file as stdin so the JSON never appears on argv.
+    const launchPath = join(dirname(recPath), "launch.json");
+    writeFileSync(launchPath, payload, { mode: 0o600 });
+    const launchFd = openSync(launchPath, "r");
+    const child = spawn(process.execPath, [custodianEntry()], {
+        detached: true,
+        stdio: [launchFd, "ignore", "ignore"],
+        env: { PATH: process.env.PATH ?? "" },
+    });
+    closeSync(launchFd);
+    try {
+        unlinkSync(launchPath);
+    }
+    catch {
+        /* child still holds the fd */
+    }
+    child.unref();
+    const deadline = Date.now() + 10_000;
+    while (Date.now() < deadline) {
+        try {
+            const rec = readRecord(recPath);
+            if (rec.custodianPid > 0 && rec.childPid > 0) {
+                return rec;
+            }
+        }
+        catch {
+            /* record not written yet */
+        }
+        if (!pidLive(child.pid)) {
+            let err = "";
+            try {
+                err = readFileSync(logPath, "utf8").trim();
+            }
+            catch {
+                /* no log */
+            }
+            throw new Error(`custodian exited before ready: ${err || `pid ${String(child.pid)} gone`}`);
+        }
+        spawnSync("sleep", ["0.025"], { stdio: "ignore" });
+    }
+    throw new Error(`custodian did not write a seat record at ${recPath}`);
+}
+export function loadSeat(root, id) {
+    return readRecord(recordPath(root, id));
+}
+export function readSeatFile(path) {
+    return JSON.parse(readFileSync(path, "utf8"));
+}
+//# sourceMappingURL=launcher.js.map

package/dist/launcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"launcher.js","sourceRoot":"","sources":["../src/launcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC9G,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAmB,UAAU,EAAE,MAAM,aAAa,CAAC;AAC3G,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAgBrD,SAAS,WAAW;IAClB,OAAO,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAC1D,CAAC;AAED,iGAAiG;AACjG,SAAS,cAAc;IACrB,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,EAAE,MAAM,EAAE,cAAc,CAAC,CAAC;IACzD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,IAAI,8BAA8B,CAAC,CAAC;IACzG,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,OAAO,CAAC,GAAuB;IACtC,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACtD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,YAAY,CAAC,SAAS,GAAG,OAAO,EAAE,MAAM,CAAC,CAAC;QACvD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACnE,OAAO,KAAK,KAAK,GAAG,CAAC;IACvB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAoB;IAC7C,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO;QAAE,MAAM,oBAAoB,EAAE,CAAC;IAC/D,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACvD,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;IACpB,MAAM,KAAK,GAAG,eAAe,EAAE,CAAC;IAChC,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACzC,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAC1C,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC9D,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,eAAe,CAAC,CAAC;IACxD,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC;QAC7B,EAAE;QACF,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO;QAC1B,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI;QACpB,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE;QACxB,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,MAAM;QACN,KAAK;QACL,UAAU,EAAE,OAAO;QACnB,OAAO;QACP,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;KACpC,CAAC,CAAC;IACH,qEAAqE;IACrE,wEAAwE;IACxE,mDAAmD;IACnD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC,CAAC;IACzD,aAAa,CAAC,UAAU,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACpD,MAAM,QAAQ,GAAG,QAAQ,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;IAC3C,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,cAAc,EAAE,CAAC,EAAE;QACxD,QAAQ,EAAE,IAAI;QACd,KAAK,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC;QACrC,GAAG,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,EAAE;KACtC,CAAC,CAAC;IACH,SAAS,CAAC,QAAQ,CAAC,CAAC;IACpB,IAAI,CAAC;QACH,UAAU,CAAC,UAAU,CAAC,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,8BAA8B;IAChC,CAAC;IACD,KAAK,CAAC,KAAK,EAAE,CAAC;IACd,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC;IACrC,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;QAC7B,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;YAChC,IAAI,GAAG,CAAC,YAAY,GAAG,CAAC,IAAI,GAAG,CAAC,QAAQ,GAAG,CAAC,EAAE,CAAC;gBAC7C,OAAO,GAAG,CAAC;YACb,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,4BAA4B;QAC9B,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,IAAI,GAAG,GAAG,EAAE,CAAC;YACb,IAAI,CAAC;gBACH,GAAG,GAAG,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;YAC7C,CAAC;YAAC,MAAM,CAAC;gBACP,YAAY;YACd,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,kCAAkC,GAAG,IAAI,OAAO,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QAC9F,CAAC;QACD,SAAS,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;IACrD,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,4CAA4C,OAAO,EAAE,CAAC,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,EAAU;IAC/C,OAAO,UAAU,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAe,CAAC;AAC9D,CAAC"}

package/dist/peercred.d.ts

@@ -0,0 +1,12 @@
+import type { Socket } from "node:net";
+export interface PeerCredentials {
+    pid: number;
+    uid: number;
+    gid: number;
+}
+export declare const LINUX_NATIVE_ARCHES: readonly ["x64", "arm64"];
+export declare function nativeHelperPath(arch?: string): string;
+export declare function unsupportedNativeArch(platform: string, arch: string): Error;
+export declare function socketFd(sock: Socket): number;
+export declare function peerCredentials(sock: Socket): PeerCredentials;
+//# sourceMappingURL=peercred.d.ts.map

package/dist/peercred.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"peercred.d.ts","sourceRoot":"","sources":["../src/peercred.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAGvC,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb;AAID,eAAO,MAAM,mBAAmB,2BAA4B,CAAC;AAI7D,wBAAgB,gBAAgB,CAAC,IAAI,GAAE,MAAqB,GAAG,MAAM,CAGpE;AAMD,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,KAAK,CAI3E;AAqBD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK7C;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAE7D"}

package/dist/peercred.js

@@ -0,0 +1,49 @@
+import { createRequire } from "node:module";
+import { existsSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { unsupportedTransport } from "./protocol.js";
+export const LINUX_NATIVE_ARCHES = ["x64", "arm64"];
+let loaded;
+export function nativeHelperPath(arch = process.arch) {
+    const here = dirname(fileURLToPath(import.meta.url));
+    return join(here, "..", "build", "Release", `linux-${arch}`, "peercred.node");
+}
+function isLinuxNativeArch(arch) {
+    return LINUX_NATIVE_ARCHES.includes(arch);
+}
+export function unsupportedNativeArch(platform, arch) {
+    return new Error(`@cotal-ai/seat: SO_PEERCRED native helper unsupported on ${platform}-${arch} (supported: linux-x64, linux-arm64)`);
+}
+function loadNative() {
+    if (loaded)
+        return loaded;
+    if (process.platform !== "linux")
+        throw unsupportedTransport();
+    const platformArch = `${process.platform}-${process.arch}`;
+    if (!isLinuxNativeArch(process.arch))
+        throw unsupportedNativeArch(process.platform, process.arch);
+    const path = nativeHelperPath(process.arch);
+    if (!existsSync(path))
+        throw new Error(`@cotal-ai/seat: SO_PEERCRED native helper missing at ${path}`);
+    const require = createRequire(import.meta.url);
+    try {
+        loaded = require(path);
+    }
+    catch (err) {
+        const detail = err instanceof Error ? err.message : String(err);
+        throw new Error(`@cotal-ai/seat: SO_PEERCRED native helper failed to load at ${path} for ${platformArch}: ${detail}`);
+    }
+    return loaded;
+}
+export function socketFd(sock) {
+    const handle = sock._handle;
+    const fd = handle?.fd;
+    if (typeof fd !== "number" || fd < 0)
+        throw new Error("unix socket has no file descriptor");
+    return fd;
+}
+export function peerCredentials(sock) {
+    return loadNative().peercred(socketFd(sock));
+}
+//# sourceMappingURL=peercred.js.map

package/dist/peercred.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"peercred.js","sourceRoot":"","sources":["../src/peercred.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAUrD,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,KAAK,EAAE,OAAO,CAAU,CAAC;AAE7D,IAAI,MAAkC,CAAC;AAEvC,MAAM,UAAU,gBAAgB,CAAC,OAAe,OAAO,CAAC,IAAI;IAC1D,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACrD,OAAO,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,IAAI,EAAE,EAAE,eAAe,CAAC,CAAC;AAChF,CAAC;AAED,SAAS,iBAAiB,CAAC,IAAY;IACrC,OAAQ,mBAAyC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,QAAgB,EAAE,IAAY;IAClE,OAAO,IAAI,KAAK,CACd,4DAA4D,QAAQ,IAAI,IAAI,sCAAsC,CACnH,CAAC;AACJ,CAAC;AAED,SAAS,UAAU;IACjB,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAC1B,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO;QAAE,MAAM,oBAAoB,EAAE,CAAC;IAC/D,MAAM,YAAY,GAAG,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;IAC3D,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,MAAM,qBAAqB,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAClG,MAAM,IAAI,GAAG,gBAAgB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,wDAAwD,IAAI,EAAE,CAAC,CAAC;IACvG,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/C,IAAI,CAAC;QACH,MAAM,GAAG,OAAO,CAAC,IAAI,CAAmB,CAAC;IAC3C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,MAAM,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAChE,MAAM,IAAI,KAAK,CACb,+DAA+D,IAAI,QAAQ,YAAY,KAAK,MAAM,EAAE,CACrG,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,MAAM,MAAM,GAAI,IAAiD,CAAC,OAAO,CAAC;IAC1E,MAAM,EAAE,GAAG,MAAM,EAAE,EAAE,CAAC;IACtB,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,EAAE,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;IAC5F,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,UAAU,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;AAC/C,CAAC"}

package/dist/protocol.d.ts

@@ -0,0 +1,137 @@
+/** Protocol version this process speaks. Additive later; M2 is a single implicit controller. */
+export declare const PROTOCOL_VERSION = 1;
+export declare const DEFAULT_COLS = 120;
+export declare const DEFAULT_ROWS = 32;
+export declare const SCROLLBACK_ROWS = 1000;
+export declare const CONFIRM_INTERVAL_MS = 1000;
+export declare const MAX_CONFIRMS = 5;
+export declare const GRACE_MS = 3000;
+/**
+ * Max JSON body the local protocol accepts in one frame.
+ * A 1000-row, 120-col 16-color serialize is ~744 KiB, and JSON-escaping that
+ * snapshot is 1_365_109 bytes. Truecolor fg+bg per cell is 4_876_998. 8 MiB
+ * covers both so adopt can return scrollback; a 500 MiB claimed length still
+ * fails the per-frame check.
+ */
+export declare const MAX_FRAME_SIZE: number;
+/** Max undecoded residual AFTER complete frames have been drained. */
+export declare const MAX_BUFFER_SIZE: number;
+export type StopMode = "graceful" | "hard";
+export type ClientRequest = {
+    id: number;
+    op: "hello";
+    token: string;
+} | {
+    id: number;
+    op: "snapshot";
+} | {
+    id: number;
+    op: "subscribe-output";
+} | {
+    id: number;
+    op: "unsubscribe-output";
+    sub: number;
+} | {
+    id: number;
+    op: "write";
+    data: string;
+} | {
+    id: number;
+    op: "resize";
+    cols: number;
+    rows: number;
+} | {
+    id: number;
+    op: "interrupt";
+} | {
+    id: number;
+    op: "stop";
+    mode: StopMode;
+} | {
+    id: number;
+    op: "wait-exit";
+} | {
+    id: number;
+    op: "health";
+};
+export type ServerEvent = {
+    event: "output";
+    sub: number;
+    data: string;
+} | {
+    event: "exit";
+    sub?: number;
+};
+export type ServerReply = {
+    id: number;
+    ok: true;
+    op: "hello";
+    name: string;
+    pid: number;
+    cols: number;
+    rows: number;
+    status: "running" | "exited";
+    exit?: {
+        code?: number;
+        signal?: number;
+    };
+} | {
+    id: number;
+    ok: true;
+    op: "snapshot";
+    data: string;
+    cols: number;
+    rows: number;
+} | {
+    id: number;
+    ok: true;
+    op: "subscribe-output";
+    sub: number;
+} | {
+    id: number;
+    ok: true;
+    op: "unsubscribe-output";
+} | {
+    id: number;
+    ok: true;
+    op: "write";
+} | {
+    id: number;
+    ok: true;
+    op: "resize";
+} | {
+    id: number;
+    ok: true;
+    op: "interrupt";
+} | {
+    id: number;
+    ok: true;
+    op: "stop";
+} | {
+    id: number;
+    ok: true;
+    op: "wait-exit";
+    exit?: {
+        code?: number;
+        signal?: number;
+    };
+} | {
+    id: number;
+    ok: true;
+    op: "health";
+    pid: number;
+    status: "running" | "exited";
+    protocol: number;
+} | {
+    id: number;
+    ok: false;
+    error: string;
+};
+export type ServerMessage = ServerReply | ServerEvent;
+export declare function encodeFrame(value: unknown): Buffer;
+export declare class FrameReader {
+    private buf;
+    push(chunk: Buffer): unknown[];
+}
+export declare function unsupportedTransport(platform?: string): Error;
+//# sourceMappingURL=protocol.d.ts.map

package/dist/protocol.d.ts.map

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

package/dist/protocol.js

@@ -0,0 +1,55 @@
+/** Protocol version this process speaks. Additive later; M2 is a single implicit controller. */
+export const PROTOCOL_VERSION = 1;
+export const DEFAULT_COLS = 120;
+export const DEFAULT_ROWS = 32;
+export const SCROLLBACK_ROWS = 1000;
+export const CONFIRM_INTERVAL_MS = 1_000;
+export const MAX_CONFIRMS = 5;
+export const GRACE_MS = 3_000;
+/**
+ * Max JSON body the local protocol accepts in one frame.
+ * A 1000-row, 120-col 16-color serialize is ~744 KiB, and JSON-escaping that
+ * snapshot is 1_365_109 bytes. Truecolor fg+bg per cell is 4_876_998. 8 MiB
+ * covers both so adopt can return scrollback; a 500 MiB claimed length still
+ * fails the per-frame check.
+ */
+export const MAX_FRAME_SIZE = 8 * 1024 * 1024;
+/** Max undecoded residual AFTER complete frames have been drained. */
+export const MAX_BUFFER_SIZE = MAX_FRAME_SIZE + 4;
+export function encodeFrame(value) {
+    const body = Buffer.from(JSON.stringify(value), "utf8");
+    if (body.length > MAX_FRAME_SIZE) {
+        throw new Error(`frame length ${body.length} exceeds ${MAX_FRAME_SIZE} bytes`);
+    }
+    const header = Buffer.allocUnsafe(4);
+    header.writeUInt32BE(body.length, 0);
+    return Buffer.concat([header, body]);
+}
+export class FrameReader {
+    buf = Buffer.alloc(0);
+    push(chunk) {
+        this.buf = Buffer.concat([this.buf, chunk]);
+        const out = [];
+        while (this.buf.length >= 4) {
+            const size = this.buf.readUInt32BE(0);
+            if (size > MAX_FRAME_SIZE) {
+                this.buf = Buffer.alloc(0);
+                throw new Error(`frame length ${size} exceeds ${MAX_FRAME_SIZE} bytes`);
+            }
+            if (this.buf.length < 4 + size)
+                break;
+            const body = this.buf.subarray(4, 4 + size);
+            this.buf = this.buf.subarray(4 + size);
+            out.push(JSON.parse(body.toString("utf8")));
+        }
+        if (this.buf.length > MAX_BUFFER_SIZE) {
+            this.buf = Buffer.alloc(0);
+            throw new Error(`frame buffer exceeds ${MAX_BUFFER_SIZE} bytes`);
+        }
+        return out;
+    }
+}
+export function unsupportedTransport(platform = process.platform) {
+    return new Error(`custody transport unsupported on ${platform}`);
+}
+//# sourceMappingURL=protocol.js.map

package/dist/protocol.js.map

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