@sentropic/h2a-runtime 0.98.1 → 0.98.2

package/dist/native-terminal/process.js

@@ -1,6 +1,9 @@
 #!/usr/bin/env node
 import { randomUUID } from "node:crypto";
-import { NativeTerminalHost } from "./host.js";
+import { resolve } from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
+import { NativeTerminalHost, readProcessStartTime } from "./host.js";
+import { createHostJournalWriter, getRuntimeVersion } from "./journal.js";
 import { nodePtySpawner } from "../pty.js";
 import { NATIVE_TERMINAL_DEFAULT_MAX_SESSIONS, NATIVE_TERMINAL_MAX_REPLAY_BYTES_PER_SESSION, NATIVE_TERMINAL_MAX_SESSIONS, } from "./protocol.js";
 import { startNativeTerminalHostServer } from "./server.js";
@@ -88,60 +91,145 @@ export function parseNativeTerminalHostArgs(argv) {
     };
 }
 export async function runNativeTerminalHostProcess(argv) {
-    const options = parseNativeTerminalHostArgs(argv);
-    const host = new NativeTerminalHost({
-        generation: options.generation,
-        replayBytesPerSession: options.replayBytesPerSession,
-        maxSessions: options.maxSessions,
-        spawner: nodePtySpawner,
-        socketPath: options.socketPath,
-        ...(options.registryPath !== undefined ? { registryPath: options.registryPath } : {}),
+    const startTime = readProcessStartTime(process.pid) ?? "unknown";
+    const codePath = process.argv[1] ?? fileURLToPath(import.meta.url);
+    let options;
+    let cause = "unknown";
+    const identity = () => ({ pid: process.pid, startTime, generation: options?.generation ?? "unknown" });
+    const journal = createHostJournalWriter();
+    // Exit callbacks only enqueue observations. The independent writer has its
+    // own bounded drain; the monitor preserves Node's fatal behavior.
+    process.on("exit", (exitCode) => {
+        journal.write({ event: "exit", ...identity(), exitCode, cause });
     });
-    const server = await startNativeTerminalHostServer({ socketPath: options.socketPath, host });
-    process.stdout.write(`${JSON.stringify({
-        kind: "h2a.native-terminal.ready",
-        version: 1,
-        generation: host.generation,
-        pid: process.pid,
-        socketPath: server.socketPath,
-    })}\n`);
-    let shutdown;
-    const stop = (signal) => {
-        shutdown ??= (async () => {
-            let gracefulError;
-            try {
-                await server.close({ stopSessions: true, signal: "SIGTERM" });
-            }
-            catch (error) {
-                gracefulError = error;
-            }
-            if (!await waitForTerminalDrain(host, GRACEFUL_DRAIN_MS)) {
+    process.on("uncaughtExceptionMonitor", (error, origin) => {
+        cause = origin === "unhandledRejection" ? "unhandledRejection" : "uncaughtException";
+        journal.write({ event: cause, ...identity(), error: error.message, stack: error.stack, codePath });
+    });
+    try {
+        options = parseNativeTerminalHostArgs(argv);
+        journal.write({
+            event: "start",
+            ...identity(),
+            version: getRuntimeVersion(),
+            codePath,
+            socket: options.socketPath,
+        });
+        const host = new NativeTerminalHost({
+            generation: options.generation,
+            replayBytesPerSession: options.replayBytesPerSession,
+            maxSessions: options.maxSessions,
+            spawner: nodePtySpawner,
+            socketPath: options.socketPath,
+            ...(options.registryPath !== undefined ? { registryPath: options.registryPath } : {}),
+        });
+        const initialization = new AbortController();
+        const serverReady = startNativeTerminalHostServer({
+            socketPath: options.socketPath, host, signal: initialization.signal,
+        });
+        let shutdown;
+        const stop = (signal) => {
+            journal.write({
+                event: "signal",
+                ...identity(),
+                signal,
+            });
+            if (shutdown !== undefined)
+                return;
+            cause = "signal";
+            shutdown = (async () => {
+                initialization.abort();
+                let gracefulError;
+                // Begin terminal shutdown independently of publication/rollback.
                 try {
-                    await host.forceStopAll("SIGKILL");
+                    host.stopAll("SIGTERM");
+                }
+                catch (error) {
+                    gracefulError = error;
                 }
-                catch {
-                    // The post-kill drain check below is authoritative: a raced exit may
-                    // make node-pty report an error even though no terminal remains.
+                const closeServer = serverReady.then(server => server.close()).catch((error) => {
+                    if (error !== initialization.signal.reason)
+                        gracefulError = error;
+                });
+                try {
+                    if (!await waitForTerminalDrain(host, GRACEFUL_DRAIN_MS)) {
+                        try {
+                            await host.forceStopAll("SIGKILL");
+                        }
+                        catch {
+                            // The post-kill drain check below is authoritative: a raced exit may
+                            // make node-pty report an error even though no terminal remains.
+                        }
+                        if (!await waitForTerminalDrain(host, FORCED_DRAIN_MS)) {
+                            throw new Error("terminal sessions did not exit after forced shutdown");
+                        }
+                    }
                 }
-                if (!await waitForTerminalDrain(host, FORCED_DRAIN_MS)) {
-                    throw new Error("terminal sessions did not exit after forced shutdown");
+                finally {
+                    await closeServer;
                 }
-            }
-            if (gracefulError !== undefined)
-                throw gracefulError;
-        })();
-        void shutdown.then(() => { process.exitCode = 0; }, (error) => {
-            process.stderr.write(`[h2a-pty-host] shutdown failed after ${signal}: ${String(error)}\n`);
-            process.exitCode = 1;
+                if (gracefulError !== undefined)
+                    throw gracefulError;
+            })();
+            void shutdown.then(async () => {
+                cause = "clean-stop";
+                journal.write({
+                    event: "stop",
+                    ...identity(),
+                    clean: true,
+                });
+                process.exitCode = 0;
+                await journal.flush();
+            }, (error) => {
+                journal.write({
+                    event: "stop",
+                    ...identity(),
+                    clean: false,
+                });
+                process.stderr.write(`[h2a-pty-host] shutdown failed after ${signal}: ${String(error)}\n`);
+                process.exitCode = 1;
+            });
+        };
+        process.once("SIGINT", () => stop("SIGINT"));
+        process.once("SIGTERM", () => stop("SIGTERM"));
+        process.once("SIGHUP", () => stop("SIGHUP"));
+        // The socket can be visible before its owner record has finished. Install
+        // termination handlers before that asynchronous publication window.
+        const server = await serverReady.catch((error) => {
+            if (shutdown !== undefined && error === initialization.signal.reason)
+                return undefined;
+            throw error;
         });
-    };
-    process.once("SIGINT", () => stop("SIGINT"));
-    process.once("SIGTERM", () => stop("SIGTERM"));
-    process.once("SIGHUP", () => stop("SIGHUP"));
+        if (shutdown !== undefined) {
+            await shutdown;
+            return;
+        }
+        process.stdout.write(`${JSON.stringify({
+            kind: "h2a.native-terminal.ready",
+            version: 1,
+            generation: host.generation,
+            pid: process.pid,
+            socketPath: server.socketPath,
+        })}\n`);
+    }
+    catch (error) {
+        cause = "startupError";
+        journal.write({ event: "startupError", ...identity(), error: "[REDACTED]",
+            stack: error instanceof Error ? error.stack : undefined, codePath });
+        await journal.flush();
+        throw error;
+    }
 }
 function isEntryPoint() {
     const argv1 = process.argv[1];
-    return argv1 !== undefined && import.meta.url === new URL(`file://${argv1}`).href;
+    if (argv1 === undefined)
+        return false;
+    try {
+        return import.meta.url === pathToFileURL(resolve(argv1)).href;
+    }
+    catch {
+        return false;
+    }
 }
 if (isEntryPoint()) {
     runNativeTerminalHostProcess(process.argv).catch((error) => {

package/dist/native-terminal/process.js.map

@@ -1 +1 @@
-{"version":3,"file":"process.js","sourceRoot":"","sources":["../../src/native-terminal/process.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EACL,oCAAoC,EACpC,4CAA4C,EAC5C,4BAA4B,GAC7B,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,6BAA6B,EAAE,MAAM,aAAa,CAAC;AAW5D,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAC9B,MAAM,eAAe,GAAG,GAAG,CAAC;AAE5B,SAAS,KAAK,CAAC,YAAoB;IACjC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC;AACrE,CAAC;AAED,KAAK,UAAU,oBAAoB,CAAC,IAAwB,EAAE,SAAiB;IAC7E,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;IACxC,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,KAAK,QAAQ,CAAC,EAAE,CAAC;QAClE,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,QAAQ;YAAE,OAAO,KAAK,CAAC;QACzC,MAAM,KAAK,CAAC,EAAE,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,oBAAoB,CAAC,GAAuB,EAAE,KAAa;IAClE,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC1B,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,kCAAkC,CAAC,CAAC;IAC9D,CAAC;IACD,IAAI,KAAK,GAAG,4CAA4C,EAAE,CAAC;QACzD,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,oBAAoB,4CAA4C,EAAE,CAAC,CAAC;IAC9F,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,gBAAgB,CAAC,GAAuB;IAC/C,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC1B,IACE,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC;QAC5B,KAAK,IAAI,CAAC;QACV,KAAK,GAAG,4BAA4B,EACpC,CAAC;QACD,MAAM,IAAI,KAAK,CACb,wCAAwC,4BAA4B,EAAE,CACvE,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,IAA2B;IACrE,IAAI,UAA8B,CAAC;IACnC,IAAI,UAAU,GAAW,UAAU,EAAE,CAAC;IACtC,IAAI,qBAAqB,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;IAC5C,IAAI,WAAW,GAAG,oCAAoC,CAAC;IACvD,IAAI,YAAgC,CAAC;IACrC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACpD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QACzB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QAC9B,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,UAAU;gBACb,IAAI,CAAC,KAAK;oBAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;gBACxD,UAAU,GAAG,KAAK,CAAC;gBACnB,KAAK,IAAI,CAAC,CAAC;gBACX,MAAM;YACR,KAAK,cAAc;gBACjB,IAAI,CAAC,KAAK;oBAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;gBAC7D,UAAU,GAAG,KAAK,CAAC;gBACnB,KAAK,IAAI,CAAC,CAAC;gBACX,MAAM;YACR,KAAK,gBAAgB;gBACnB,qBAAqB,GAAG,oBAAoB,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAC;gBACtE,KAAK,IAAI,CAAC,CAAC;gBACX,MAAM;YACR,KAAK,gBAAgB;gBACnB,WAAW,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;gBACtC,KAAK,IAAI,CAAC,CAAC;gBACX,MAAM;YACR,KAAK,iBAAiB;gBACpB,IAAI,CAAC,KAAK;oBAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;gBAC/D,YAAY,GAAG,KAAK,CAAC;gBACrB,KAAK,IAAI,CAAC,CAAC;gBACX,MAAM;YACR;gBACE,MAAM,IAAI,KAAK,CAAC,0CAA0C,IAAI,IAAI,WAAW,EAAE,CAAC,CAAC;QACrF,CAAC;IACH,CAAC;IACD,IAAI,CAAC,UAAU;QAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;IACzD,OAAO;QACL,UAAU;QACV,UAAU;QACV,qBAAqB;QACrB,WAAW;QACX,GAAG,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACxD,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAAC,IAA2B;IAC5E,MAAM,OAAO,GAAG,2BAA2B,CAAC,IAAI,CAAC,CAAC;IAClD,MAAM,IAAI,GAAG,IAAI,kBAAkB,CAAC;QAClC,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,qBAAqB,EAAE,OAAO,CAAC,qBAAqB;QACpD,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,OAAO,EAAE,cAAc;QACvB,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,GAAG,CAAC,OAAO,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACtF,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,MAAM,6BAA6B,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7F,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC;QACrC,IAAI,EAAE,2BAA2B;QACjC,OAAO,EAAE,CAAC;QACV,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,UAAU,EAAE,MAAM,CAAC,UAAU;KAC9B,CAAC,IAAI,CAAC,CAAC;IAER,IAAI,QAAmC,CAAC;IACxC,MAAM,IAAI,GAAG,CAAC,MAAc,EAAQ,EAAE;QACpC,QAAQ,KAAK,CAAC,KAAK,IAAI,EAAE;YACvB,IAAI,aAAsB,CAAC;YAC3B,IAAI,CAAC;gBACH,MAAM,MAAM,CAAC,KAAK,CAAC,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;YAChE,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,aAAa,GAAG,KAAK,CAAC;YACxB,CAAC;YACD,IAAI,CAAC,MAAM,oBAAoB,CAAC,IAAI,EAAE,iBAAiB,CAAC,EAAE,CAAC;gBACzD,IAAI,CAAC;oBACH,MAAM,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;gBACrC,CAAC;gBAAC,MAAM,CAAC;oBACP,qEAAqE;oBACrE,iEAAiE;gBACnE,CAAC;gBACD,IAAI,CAAC,MAAM,oBAAoB,CAAC,IAAI,EAAE,eAAe,CAAC,EAAE,CAAC;oBACvD,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;gBAC1E,CAAC;YACH,CAAC;YACD,IAAI,aAAa,KAAK,SAAS;gBAAE,MAAM,aAAa,CAAC;QACvD,CAAC,CAAC,EAAE,CAAC;QACL,KAAK,QAAQ,CAAC,IAAI,CAChB,GAAG,EAAE,GAAG,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,EAC/B,CAAC,KAAK,EAAE,EAAE;YACR,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,wCAAwC,MAAM,KAAK,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC3F,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACvB,CAAC,CACF,CAAC;IACJ,CAAC,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC7C,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;IAC/C,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED,SAAS,YAAY;IACnB,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC9B,OAAO,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,IAAI,GAAG,CAAC,UAAU,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC;AACpF,CAAC;AAED,IAAI,YAAY,EAAE,EAAE,CAAC;IACnB,4BAA4B,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;QAClE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,yBAAyB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACzH,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"process.js","sourceRoot":"","sources":["../../src/native-terminal/process.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAExD,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACrE,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAyB,MAAM,cAAc,CAAC;AACjG,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EACL,oCAAoC,EACpC,4CAA4C,EAC5C,4BAA4B,GAC7B,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,6BAA6B,EAAE,MAAM,aAAa,CAAC;AAW5D,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAC9B,MAAM,eAAe,GAAG,GAAG,CAAC;AAE5B,SAAS,KAAK,CAAC,YAAoB;IACjC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC;AACrE,CAAC;AAED,KAAK,UAAU,oBAAoB,CAAC,IAAwB,EAAE,SAAiB;IAC7E,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;IACxC,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,KAAK,QAAQ,CAAC,EAAE,CAAC;QAClE,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,QAAQ;YAAE,OAAO,KAAK,CAAC;QACzC,MAAM,KAAK,CAAC,EAAE,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,oBAAoB,CAAC,GAAuB,EAAE,KAAa;IAClE,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC1B,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,kCAAkC,CAAC,CAAC;IAC9D,CAAC;IACD,IAAI,KAAK,GAAG,4CAA4C,EAAE,CAAC;QACzD,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,oBAAoB,4CAA4C,EAAE,CAAC,CAAC;IAC9F,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,gBAAgB,CAAC,GAAuB;IAC/C,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC1B,IACE,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC;QAC5B,KAAK,IAAI,CAAC;QACV,KAAK,GAAG,4BAA4B,EACpC,CAAC;QACD,MAAM,IAAI,KAAK,CACb,wCAAwC,4BAA4B,EAAE,CACvE,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,IAA2B;IACrE,IAAI,UAA8B,CAAC;IACnC,IAAI,UAAU,GAAW,UAAU,EAAE,CAAC;IACtC,IAAI,qBAAqB,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;IAC5C,IAAI,WAAW,GAAG,oCAAoC,CAAC;IACvD,IAAI,YAAgC,CAAC;IACrC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACpD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QACzB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QAC9B,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,UAAU;gBACb,IAAI,CAAC,KAAK;oBAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;gBACxD,UAAU,GAAG,KAAK,CAAC;gBACnB,KAAK,IAAI,CAAC,CAAC;gBACX,MAAM;YACR,KAAK,cAAc;gBACjB,IAAI,CAAC,KAAK;oBAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;gBAC7D,UAAU,GAAG,KAAK,CAAC;gBACnB,KAAK,IAAI,CAAC,CAAC;gBACX,MAAM;YACR,KAAK,gBAAgB;gBACnB,qBAAqB,GAAG,oBAAoB,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAC;gBACtE,KAAK,IAAI,CAAC,CAAC;gBACX,MAAM;YACR,KAAK,gBAAgB;gBACnB,WAAW,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;gBACtC,KAAK,IAAI,CAAC,CAAC;gBACX,MAAM;YACR,KAAK,iBAAiB;gBACpB,IAAI,CAAC,KAAK;oBAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;gBAC/D,YAAY,GAAG,KAAK,CAAC;gBACrB,KAAK,IAAI,CAAC,CAAC;gBACX,MAAM;YACR;gBACE,MAAM,IAAI,KAAK,CAAC,0CAA0C,IAAI,IAAI,WAAW,EAAE,CAAC,CAAC;QACrF,CAAC;IACH,CAAC;IACD,IAAI,CAAC,UAAU;QAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;IACzD,OAAO;QACL,UAAU;QACV,UAAU;QACV,qBAAqB;QACrB,WAAW;QACX,GAAG,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACxD,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAAC,IAA2B;IAC5E,MAAM,SAAS,GAAG,oBAAoB,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,SAAS,CAAC;IACjE,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACnE,IAAI,OAAmC,CAAC;IACxC,IAAI,KAAK,GAA0D,SAAS,CAAC;IAC7E,MAAM,QAAQ,GAAG,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,IAAI,SAAS,EAAY,CAAA,CAAC;IAChH,MAAM,OAAO,GAAG,uBAAuB,EAAE,CAAC;IAC1C,2EAA2E;IAC3E,kEAAkE;IAClE,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE;QAC9B,OAAO,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;IACH,OAAO,CAAC,EAAE,CAAC,0BAA0B,EAAE,CAAC,KAAY,EAAE,MAAM,EAAE,EAAE;QAC9D,KAAK,GAAG,MAAM,KAAK,oBAAoB,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,mBAAmB,CAAC;QACrF,OAAO,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,QAAQ,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;IACrG,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,OAAO,GAAG,2BAA2B,CAAC,IAAI,CAAC,CAAC;QAC5C,OAAO,CAAC,KAAK,CAAC;YACZ,KAAK,EAAE,OAAO;YACd,GAAG,QAAQ,EAAE;YACb,OAAO,EAAE,iBAAiB,EAAE;YAC5B,QAAQ;YACR,MAAM,EAAE,OAAO,CAAC,UAAU;SAC3B,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,IAAI,kBAAkB,CAAC;YAClC,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,qBAAqB,EAAE,OAAO,CAAC,qBAAqB;YACpD,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,OAAO,EAAE,cAAc;YACvB,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,GAAG,CAAC,OAAO,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACtF,CAAC,CAAC;QACH,MAAM,cAAc,GAAG,IAAI,eAAe,EAAE,CAAC;QAC7C,MAAM,WAAW,GAAG,6BAA6B,CAAC;YAChD,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,cAAc,CAAC,MAAM;SACpE,CAAC,CAAC;QAEH,IAAI,QAAmC,CAAC;QACxC,MAAM,IAAI,GAAG,CAAC,MAAc,EAAQ,EAAE;YACpC,OAAO,CAAC,KAAK,CAAC;gBACZ,KAAK,EAAE,QAAQ;gBACf,GAAG,QAAQ,EAAE;gBACb,MAAM;aACP,CAAC,CAAC;YACH,IAAI,QAAQ,KAAK,SAAS;gBAAE,OAAO;YACnC,KAAK,GAAG,QAAQ,CAAC;YACjB,QAAQ,GAAG,CAAC,KAAK,IAAI,EAAE;gBACrB,cAAc,CAAC,KAAK,EAAE,CAAC;gBACvB,IAAI,aAAsB,CAAC;gBAC3B,iEAAiE;gBACjE,IAAI,CAAC;oBAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;gBAAC,CAAC;gBAChC,OAAO,KAAK,EAAE,CAAC;oBAAC,aAAa,GAAG,KAAK,CAAC;gBAAC,CAAC;gBACxC,MAAM,WAAW,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;oBACtF,IAAI,KAAK,KAAK,cAAc,CAAC,MAAM,CAAC,MAAM;wBAAE,aAAa,GAAG,KAAK,CAAC;gBACpE,CAAC,CAAC,CAAC;gBACH,IAAI,CAAC;oBACH,IAAI,CAAC,MAAM,oBAAoB,CAAC,IAAI,EAAE,iBAAiB,CAAC,EAAE,CAAC;wBACzD,IAAI,CAAC;4BACH,MAAM,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;wBACrC,CAAC;wBAAC,MAAM,CAAC;4BACP,qEAAqE;4BACrE,iEAAiE;wBACnE,CAAC;wBACD,IAAI,CAAC,MAAM,oBAAoB,CAAC,IAAI,EAAE,eAAe,CAAC,EAAE,CAAC;4BACvD,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;wBAC1E,CAAC;oBACH,CAAC;gBACH,CAAC;wBAAS,CAAC;oBAAC,MAAM,WAAW,CAAC;gBAAC,CAAC;gBAChC,IAAI,aAAa,KAAK,SAAS;oBAAE,MAAM,aAAa,CAAC;YACvD,CAAC,CAAC,EAAE,CAAC;YACL,KAAK,QAAQ,CAAC,IAAI,CAChB,KAAK,IAAI,EAAE;gBACT,KAAK,GAAG,YAAY,CAAC;gBACrB,OAAO,CAAC,KAAK,CAAC;oBACZ,KAAK,EAAE,MAAM;oBACb,GAAG,QAAQ,EAAE;oBACb,KAAK,EAAE,IAAI;iBACZ,CAAC,CAAC;gBACH,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;gBACrB,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;YACxB,CAAC,EACD,CAAC,KAAK,EAAE,EAAE;gBACR,OAAO,CAAC,KAAK,CAAC;oBACZ,KAAK,EAAE,MAAM;oBACb,GAAG,QAAQ,EAAE;oBACb,KAAK,EAAE,KAAK;iBACb,CAAC,CAAC;gBACH,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,wCAAwC,MAAM,KAAK,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC3F,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACvB,CAAC,CACF,CAAC;QACJ,CAAC,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC7C,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;QAC/C,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC7C,0EAA0E;QAC1E,oEAAoE;QACpE,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;YACxD,IAAI,QAAQ,KAAK,SAAS,IAAI,KAAK,KAAK,cAAc,CAAC,MAAM,CAAC,MAAM;gBAAE,OAAO,SAAS,CAAC;YACvF,MAAM,KAAK,CAAC;QACd,CAAC,CAAC,CAAC;QACH,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,MAAM,QAAQ,CAAC;YACf,OAAO;QACT,CAAC;QACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC;YACrC,IAAI,EAAE,2BAA2B;YACjC,OAAO,EAAE,CAAC;YACV,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,UAAU,EAAE,MAAO,CAAC,UAAU;SAC/B,CAAC,IAAI,CAAC,CAAC;IACV,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,KAAK,GAAG,cAAc,CAAC;QACvB,OAAO,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,GAAG,QAAQ,EAAE,EAAE,KAAK,EAAE,YAAY;YACvE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC;QACvE,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;QACtB,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,YAAY;IACnB,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC9B,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACtC,IAAI,CAAC;QACH,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,aAAa,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IAChE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,IAAI,YAAY,EAAE,EAAE,CAAC;IACnB,4BAA4B,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;QAClE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,yBAAyB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACzH,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/native-terminal/replay-buffer.d.ts

@@ -10,6 +10,8 @@ export type TerminalReplay = Readonly<{
     chunks: ReadonlyArray<TerminalOutputChunk>;
     gap: TerminalReplayGap | null;
     latestSeq: number;
+    /** State and parser prefix immediately before the retained chunks. */
+    terminalModePrefix?: string;
 }>;
 export declare const NATIVE_TERMINAL_MAX_REPLAY_CHUNKS_PER_SESSION = 65536;
 export declare const NATIVE_TERMINAL_MAX_REPLAY_WIRE_BYTES_PER_SESSION: number;
@@ -21,6 +23,7 @@ export declare class TerminalReplayBuffer {
     });
     get latestSeq(): number;
     append(data: string): TerminalOutputChunk;
+    resetSequence(): string;
     readAfter(afterSeq: number): TerminalReplay;
 }
 //# sourceMappingURL=replay-buffer.d.ts.map

package/dist/native-terminal/replay-buffer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"replay-buffer.d.ts","sourceRoot":"","sources":["../../src/native-terminal/replay-buffer.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mBAAmB,GAAG,QAAQ,CAAC;IACzC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACd,CAAC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,QAAQ,CAAC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC;IACpC,MAAM,EAAE,aAAa,CAAC,mBAAmB,CAAC,CAAC;IAC3C,GAAG,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC,CAAC;AAQH,eAAO,MAAM,6CAA6C,QAAS,CAAC;AAGpE,eAAO,MAAM,iDAAiD,QAC5C,CAAC;AAEnB,qBAAa,oBAAoB;;gBAW7B,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAO;IAqB5D,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB;IAkCzC,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc;CAuB5C"}
+{"version":3,"file":"replay-buffer.d.ts","sourceRoot":"","sources":["../../src/native-terminal/replay-buffer.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,mBAAmB,GAAG,QAAQ,CAAC;IACzC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACd,CAAC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,QAAQ,CAAC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC;IACpC,MAAM,EAAE,aAAa,CAAC,mBAAmB,CAAC,CAAC;IAC3C,GAAG,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,sEAAsE;IACtE,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B,CAAC,CAAC;AAQH,eAAO,MAAM,6CAA6C,QAAS,CAAC;AAGpE,eAAO,MAAM,iDAAiD,QAC5C,CAAC;AAEnB,qBAAa,oBAAoB;;gBAa7B,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAO;IAqB5D,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB;IAoCzC,aAAa,IAAI,MAAM;IAIvB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc;CA0B5C"}

package/dist/native-terminal/replay-buffer.js

@@ -1,3 +1,4 @@
+import { TerminalModeTracker } from "./terminal-modes.js";
 export const NATIVE_TERMINAL_MAX_REPLAY_CHUNKS_PER_SESSION = 65_536;
 // Leaves 8 MiB of the 32 MiB protocol frame for the response envelope and
 // bounded identities, while charging the actual JSON-escaped chunk encoding.
@@ -11,6 +12,8 @@ export class TerminalReplayBuffer {
     #bytes = 0;
     #wireBytes = 0;
     #latestSeq = 0;
+    #evictedModes = new TerminalModeTracker();
+    #currentModes = new TerminalModeTracker();
     constructor(maxBytes, limits = {}) {
         if (!Number.isSafeInteger(maxBytes) || maxBytes <= 0) {
             throw new RangeError("maxBytes must be a positive safe integer");
@@ -36,6 +39,7 @@ export class TerminalReplayBuffer {
             throw new RangeError("terminal output chunks must not be empty");
         }
         const chunk = Object.freeze({ seq: ++this.#latestSeq, data });
+        this.#currentModes.feed(data);
         const entry = Object.freeze({
             chunk,
             bytes: Buffer.byteLength(data, "utf8"),
@@ -51,6 +55,7 @@ export class TerminalReplayBuffer {
             this.#head < this.#chunks.length) {
             const evicted = this.#chunks[this.#head++];
             if (evicted) {
+                this.#evictedModes.feed(evicted.chunk.data);
                 this.#bytes -= evicted.bytes;
                 this.#wireBytes -= evicted.wireBytes;
             }
@@ -61,6 +66,9 @@ export class TerminalReplayBuffer {
         }
         return chunk;
     }
+    resetSequence() {
+        return this.#currentModes.resetSequence();
+    }
     readAfter(afterSeq) {
         if (!Number.isSafeInteger(afterSeq) ||
             afterSeq < 0 ||
@@ -71,6 +79,8 @@ export class TerminalReplayBuffer {
         const gap = afterSeq < oldestAvailable - 1
             ? Object.freeze({ fromSeq: afterSeq + 1, toSeq: oldestAvailable - 1 })
             : null;
+        const terminalModePrefix = gap === null ? "" :
+            this.#evictedModes.restoreSequence() + this.#evictedModes.replayPrefix();
         return Object.freeze({
             chunks: this.#chunks
                 .slice(this.#head)
@@ -78,6 +88,7 @@ export class TerminalReplayBuffer {
                 .map(({ chunk }) => chunk),
             gap,
             latestSeq: this.#latestSeq,
+            ...(terminalModePrefix ? { terminalModePrefix } : {}),
         });
     }
 }

package/dist/native-terminal/replay-buffer.js.map

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

package/dist/native-terminal/reset-relay.d.ts

@@ -0,0 +1,11 @@
+/** Native-only wrapper request. The host replaces it with selective VT resets. */
+export declare const NATIVE_TERMINAL_RESET_MARKER = "\u001B]777;h2a-reset\u0007";
+export declare class TerminalResetRelay {
+    #private;
+    readonly emit: (data: string) => void;
+    readonly reset: () => string;
+    constructor(emit: (data: string) => void, reset: () => string);
+    feed(data: string): void;
+    flush(): void;
+}
+//# sourceMappingURL=reset-relay.d.ts.map

package/dist/native-terminal/reset-relay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reset-relay.d.ts","sourceRoot":"","sources":["../../src/native-terminal/reset-relay.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,eAAO,MAAM,4BAA4B,+BAA2B,CAAC;AAErE,qBAAa,kBAAkB;;IAI3B,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,MAAM;gBADnB,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,EAC5B,KAAK,EAAE,MAAM,MAAM;IAG9B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAiBxB,KAAK,IAAI,IAAI;CAId"}

package/dist/native-terminal/reset-relay.js

@@ -0,0 +1,38 @@
+/** Native-only wrapper request. The host replaces it with selective VT resets. */
+export const NATIVE_TERMINAL_RESET_MARKER = "\x1b]777;h2a-reset\x07";
+export class TerminalResetRelay {
+    emit;
+    reset;
+    #pending = "";
+    constructor(emit, reset) {
+        this.emit = emit;
+        this.reset = reset;
+    }
+    feed(data) {
+        let remaining = this.#pending + data;
+        this.#pending = "";
+        for (;;) {
+            const index = remaining.indexOf(NATIVE_TERMINAL_RESET_MARKER);
+            if (index < 0)
+                break;
+            if (index > 0)
+                this.emit(remaining.slice(0, index));
+            const reset = this.reset();
+            if (reset)
+                this.emit(reset);
+            remaining = remaining.slice(index + NATIVE_TERMINAL_RESET_MARKER.length);
+        }
+        let carry = Math.min(remaining.length, NATIVE_TERMINAL_RESET_MARKER.length - 1);
+        while (carry > 0 && !NATIVE_TERMINAL_RESET_MARKER.startsWith(remaining.slice(-carry)))
+            carry--;
+        if (remaining.length > carry)
+            this.emit(remaining.slice(0, remaining.length - carry));
+        this.#pending = carry > 0 ? remaining.slice(-carry) : "";
+    }
+    flush() {
+        if (this.#pending)
+            this.emit(this.#pending);
+        this.#pending = "";
+    }
+}
+//# sourceMappingURL=reset-relay.js.map

package/dist/native-terminal/reset-relay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reset-relay.js","sourceRoot":"","sources":["../../src/native-terminal/reset-relay.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,MAAM,CAAC,MAAM,4BAA4B,GAAG,wBAAwB,CAAC;AAErE,MAAM,OAAO,kBAAkB;IAIlB;IACA;IAJX,QAAQ,GAAG,EAAE,CAAC;IAEd,YACW,IAA4B,EAC5B,KAAmB;QADnB,SAAI,GAAJ,IAAI,CAAwB;QAC5B,UAAK,GAAL,KAAK,CAAc;IAC3B,CAAC;IAEJ,IAAI,CAAC,IAAY;QACf,IAAI,SAAS,GAAG,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrC,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;QACnB,SAAS,CAAC;YACR,MAAM,KAAK,GAAG,SAAS,CAAC,OAAO,CAAC,4BAA4B,CAAC,CAAC;YAC9D,IAAI,KAAK,GAAG,CAAC;gBAAE,MAAM;YACrB,IAAI,KAAK,GAAG,CAAC;gBAAE,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;YACpD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;YAC3B,IAAI,KAAK;gBAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC5B,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC,KAAK,GAAG,4BAA4B,CAAC,MAAM,CAAC,CAAC;QAC3E,CAAC;QACD,IAAI,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,EAAE,4BAA4B,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAChF,OAAO,KAAK,GAAG,CAAC,IAAI,CAAC,4BAA4B,CAAC,UAAU,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC;YAAE,KAAK,EAAE,CAAC;QAC/F,IAAI,SAAS,CAAC,MAAM,GAAG,KAAK;YAAE,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC;QACtF,IAAI,CAAC,QAAQ,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3D,CAAC;IAED,KAAK;QACH,IAAI,IAAI,CAAC,QAAQ;YAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC5C,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;IACrB,CAAC;CACF"}

package/dist/native-terminal/server.d.ts

@@ -1,4 +1,11 @@
 import { NativeTerminalHost } from "./host.js";
+/**
+ * ENOENT/ECONNREFUSED are candidates, never proof by themselves. Serialize
+ * with publication and re-read both the socket and its durable process
+ * identity. A live or unreadable owner keeps the endpoint unknown.
+ * No socket is removed by an inventory; publication owns reclamation.
+ */
+export declare function proveNativeTerminalEndpointAbsent(socketPath: string, failure: unknown): Promise<boolean>;
 export type NativeTerminalHostServer = Readonly<{
     socketPath: string;
     close(options?: {
@@ -9,5 +16,6 @@ export type NativeTerminalHostServer = Readonly<{
 export declare function startNativeTerminalHostServer(options: {
     socketPath: string;
     host: NativeTerminalHost;
+    signal?: AbortSignal;
 }): Promise<NativeTerminalHostServer>;
 //# sourceMappingURL=server.d.ts.map

package/dist/native-terminal/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/native-terminal/server.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,kBAAkB,EAInB,MAAM,WAAW,CAAC;AAglBnB,MAAM,MAAM,wBAAwB,GAAG,QAAQ,CAAC;IAC9C,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,OAAO,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7E,CAAC,CAAC;AAEH,wBAAsB,6BAA6B,CAAC,OAAO,EAAE;IAC3D,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,kBAAkB,CAAC;CAC1B,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAuGpC"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/native-terminal/server.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,kBAAkB,EAMnB,MAAM,WAAW,CAAC;AAgoBnB;;;;;GAKG;AACH,wBAAsB,iCAAiC,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAK9G;AAmWD,MAAM,MAAM,wBAAwB,GAAG,QAAQ,CAAC;IAC9C,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,OAAO,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7E,CAAC,CAAC;AAEH,wBAAsB,6BAA6B,CAAC,OAAO,EAAE;IAC3D,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,kBAAkB,CAAC;IACzB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAQpC"}