@sentropic/h2a-runtime 0.91.0 → 0.91.1

package/dist/native-terminal/process.js

@@ -0,0 +1,137 @@
+#!/usr/bin/env node
+import { randomUUID } from "node:crypto";
+import { NativeTerminalHost } from "./host.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";
+const GRACEFUL_DRAIN_MS = 500;
+const FORCED_DRAIN_MS = 500;
+function delay(milliseconds) {
+    return new Promise((resolve) => setTimeout(resolve, milliseconds));
+}
+async function waitForTerminalDrain(host, timeoutMs) {
+    const deadline = Date.now() + timeoutMs;
+    while (host.list().some((session) => session.status !== "exited")) {
+        if (Date.now() >= deadline)
+            return false;
+        await delay(25);
+    }
+    return true;
+}
+function parsePositiveInteger(raw, label) {
+    const value = Number(raw);
+    if (!Number.isSafeInteger(value) || value <= 0) {
+        throw new Error(`${label} must be a positive safe integer`);
+    }
+    if (value > NATIVE_TERMINAL_MAX_REPLAY_BYTES_PER_SESSION) {
+        throw new Error(`${label} must not exceed ${NATIVE_TERMINAL_MAX_REPLAY_BYTES_PER_SESSION}`);
+    }
+    return value;
+}
+function parseMaxSessions(raw) {
+    const value = Number(raw);
+    if (!Number.isSafeInteger(value) ||
+        value <= 0 ||
+        value > NATIVE_TERMINAL_MAX_SESSIONS) {
+        throw new Error(`--max-sessions must be between 1 and ${NATIVE_TERMINAL_MAX_SESSIONS}`);
+    }
+    return value;
+}
+export function parseNativeTerminalHostArgs(argv) {
+    let socketPath;
+    let generation = randomUUID();
+    let replayBytesPerSession = 4 * 1024 * 1024;
+    let maxSessions = NATIVE_TERMINAL_DEFAULT_MAX_SESSIONS;
+    for (let index = 2; index < argv.length; index += 1) {
+        const flag = argv[index];
+        const value = argv[index + 1];
+        switch (flag) {
+            case "--socket":
+                if (!value)
+                    throw new Error("--socket requires a path");
+                socketPath = value;
+                index += 1;
+                break;
+            case "--generation":
+                if (!value)
+                    throw new Error("--generation requires a value");
+                generation = value;
+                index += 1;
+                break;
+            case "--replay-bytes":
+                replayBytesPerSession = parsePositiveInteger(value, "--replay-bytes");
+                index += 1;
+                break;
+            case "--max-sessions":
+                maxSessions = parseMaxSessions(value);
+                index += 1;
+                break;
+            default:
+                throw new Error(`unknown native terminal host argument: ${flag ?? "<missing>"}`);
+        }
+    }
+    if (!socketPath)
+        throw new Error("--socket is required");
+    return { socketPath, generation, replayBytesPerSession, maxSessions };
+}
+export async function runNativeTerminalHostProcess(argv) {
+    const options = parseNativeTerminalHostArgs(argv);
+    const host = new NativeTerminalHost({
+        generation: options.generation,
+        replayBytesPerSession: options.replayBytesPerSession,
+        maxSessions: options.maxSessions,
+        spawner: nodePtySpawner,
+    });
+    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)) {
+                try {
+                    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 (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;
+        });
+    };
+    process.once("SIGINT", () => stop("SIGINT"));
+    process.once("SIGTERM", () => stop("SIGTERM"));
+    process.once("SIGHUP", () => stop("SIGHUP"));
+}
+function isEntryPoint() {
+    const argv1 = process.argv[1];
+    return argv1 !== undefined && import.meta.url === new URL(`file://${argv1}`).href;
+}
+if (isEntryPoint()) {
+    runNativeTerminalHostProcess(process.argv).catch((error) => {
+        process.stderr.write(`[h2a-pty-host] fatal: ${error instanceof Error ? error.stack ?? error.message : String(error)}\n`);
+        process.exitCode = 1;
+    });
+}
+//# sourceMappingURL=process.js.map

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

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

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

@@ -0,0 +1,57 @@
+import type { NativeTerminalControllerLease, NativeTerminalCreateOptions } from "./host.js";
+export declare const NATIVE_TERMINAL_PROTOCOL_VERSION: 1;
+export declare const NATIVE_TERMINAL_MAX_REPLAY_BYTES_PER_SESSION: number;
+export declare const NATIVE_TERMINAL_MAX_FRAME_BYTES: number;
+export declare const NATIVE_TERMINAL_DEFAULT_MAX_SESSIONS = 32;
+export declare const NATIVE_TERMINAL_MAX_SESSIONS = 256;
+export declare const NATIVE_TERMINAL_DEFAULT_REQUEST_TIMEOUT_MS = 5000;
+export declare const NATIVE_TERMINAL_HEALTH_TIMEOUT_MS = 1000;
+export declare const NATIVE_TERMINAL_MAX_ERROR_MESSAGE_CHARS = 1024;
+export declare const NATIVE_TERMINAL_MAX_IDENTIFIER_CHARS = 128;
+export declare const NATIVE_TERMINAL_MAX_CONNECTIONS = 64;
+export declare const NATIVE_TERMINAL_MAX_PENDING_RESPONSES_PER_CONNECTION = 64;
+export declare const NATIVE_TERMINAL_MAX_PENDING_RESPONSE_BYTES_PER_CONNECTION: number;
+export declare const NATIVE_TERMINAL_MAX_PENDING_RESPONSE_BYTES_TOTAL: number;
+export declare const NATIVE_TERMINAL_STOP_SIGNALS: readonly ["SIGHUP", "SIGINT", "SIGTERM", "SIGKILL"];
+export type NativeTerminalStopSignal = (typeof NATIVE_TERMINAL_STOP_SIGNALS)[number];
+export declare function isNativeTerminalStopSignal(value: unknown): value is NativeTerminalStopSignal;
+export type NativeTerminalOperation = "ping" | "create" | "list" | "state" | "read-output" | "attach-observer" | "acquire-controller" | "release-controller" | "write" | "resize" | "stop";
+export type NativeTerminalRequest = Readonly<{
+    version: typeof NATIVE_TERMINAL_PROTOCOL_VERSION;
+    id: string;
+    operation: NativeTerminalOperation;
+    params?: Readonly<Record<string, unknown>>;
+}>;
+export type NativeTerminalSuccessResponse = Readonly<{
+    version: typeof NATIVE_TERMINAL_PROTOCOL_VERSION;
+    id: string;
+    ok: true;
+    result: unknown;
+}>;
+export type NativeTerminalErrorResponse = Readonly<{
+    version: typeof NATIVE_TERMINAL_PROTOCOL_VERSION;
+    id: string;
+    ok: false;
+    error: Readonly<{
+        code: "invalid-request" | "operation-failed";
+        message: string;
+    }>;
+}>;
+export type NativeTerminalResponse = NativeTerminalSuccessResponse | NativeTerminalErrorResponse;
+export type NativeTerminalPing = Readonly<{
+    generation: string;
+    hostPid: number;
+    protocolVersion: typeof NATIVE_TERMINAL_PROTOCOL_VERSION;
+}>;
+export type NativeTerminalCreateParams = NativeTerminalCreateOptions;
+export type NativeTerminalLeaseParams = Readonly<{
+    lease: NativeTerminalControllerLease;
+}>;
+export declare class NativeTerminalRemoteError extends Error {
+    readonly code: NativeTerminalErrorResponse["error"]["code"];
+    constructor(error: NativeTerminalErrorResponse["error"]);
+}
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+export declare function parseNativeTerminalResponse(value: unknown): NativeTerminalResponse;
+export declare function parseNativeTerminalRequest(value: unknown): NativeTerminalRequest;
+//# sourceMappingURL=protocol.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../src/native-terminal/protocol.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,6BAA6B,EAC7B,2BAA2B,EAC5B,MAAM,WAAW,CAAC;AAEnB,eAAO,MAAM,gCAAgC,EAAG,CAAU,CAAC;AAC3D,eAAO,MAAM,4CAA4C,QAAkB,CAAC;AAE5E,eAAO,MAAM,+BAA+B,QAAmB,CAAC;AAChE,eAAO,MAAM,oCAAoC,KAAK,CAAC;AACvD,eAAO,MAAM,4BAA4B,MAAM,CAAC;AAChD,eAAO,MAAM,0CAA0C,OAAQ,CAAC;AAChE,eAAO,MAAM,iCAAiC,OAAQ,CAAC;AACvD,eAAO,MAAM,uCAAuC,OAAQ,CAAC;AAC7D,eAAO,MAAM,oCAAoC,MAAM,CAAC;AACxD,eAAO,MAAM,+BAA+B,KAAK,CAAC;AAClD,eAAO,MAAM,oDAAoD,KAAK,CAAC;AACvE,eAAO,MAAM,yDAAyD,QACrC,CAAC;AAClC,eAAO,MAAM,gDAAgD,QACxB,CAAC;AAEtC,eAAO,MAAM,4BAA4B,qDAK/B,CAAC;AACX,MAAM,MAAM,wBAAwB,GAClC,CAAC,OAAO,4BAA4B,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhD,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,wBAAwB,CAKnC;AAED,MAAM,MAAM,uBAAuB,GAC/B,MAAM,GACN,QAAQ,GACR,MAAM,GACN,OAAO,GACP,aAAa,GACb,iBAAiB,GACjB,oBAAoB,GACpB,oBAAoB,GACpB,OAAO,GACP,QAAQ,GACR,MAAM,CAAC;AAEX,MAAM,MAAM,qBAAqB,GAAG,QAAQ,CAAC;IAC3C,OAAO,EAAE,OAAO,gCAAgC,CAAC;IACjD,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,uBAAuB,CAAC;IACnC,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC5C,CAAC,CAAC;AAEH,MAAM,MAAM,6BAA6B,GAAG,QAAQ,CAAC;IACnD,OAAO,EAAE,OAAO,gCAAgC,CAAC;IACjD,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,IAAI,CAAC;IACT,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC,CAAC;AAEH,MAAM,MAAM,2BAA2B,GAAG,QAAQ,CAAC;IACjD,OAAO,EAAE,OAAO,gCAAgC,CAAC;IACjD,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE,QAAQ,CAAC;QACd,IAAI,EAAE,iBAAiB,GAAG,kBAAkB,CAAC;QAC7C,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;CACJ,CAAC,CAAC;AAEH,MAAM,MAAM,sBAAsB,GAC9B,6BAA6B,GAC7B,2BAA2B,CAAC;AAEhC,MAAM,MAAM,kBAAkB,GAAG,QAAQ,CAAC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,OAAO,gCAAgC,CAAC;CAC1D,CAAC,CAAC;AAEH,MAAM,MAAM,0BAA0B,GAAG,2BAA2B,CAAC;AACrE,MAAM,MAAM,yBAAyB,GAAG,QAAQ,CAAC;IAC/C,KAAK,EAAE,6BAA6B,CAAC;CACtC,CAAC,CAAC;AAEH,qBAAa,yBAA0B,SAAQ,KAAK;IAClD,QAAQ,CAAC,IAAI,EAAE,2BAA2B,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;gBAEhD,KAAK,EAAE,2BAA2B,CAAC,OAAO,CAAC;CAKxD;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE;AAED,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,OAAO,GACb,sBAAsB,CA0CxB;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,GAAG,qBAAqB,CAkChF"}

package/dist/native-terminal/protocol.js

@@ -0,0 +1,102 @@
+export const NATIVE_TERMINAL_PROTOCOL_VERSION = 1;
+export const NATIVE_TERMINAL_MAX_REPLAY_BYTES_PER_SESSION = 4 * 1024 * 1024;
+// JSON escaping can expand one replay byte to six wire bytes (for example NUL).
+export const NATIVE_TERMINAL_MAX_FRAME_BYTES = 32 * 1024 * 1024;
+export const NATIVE_TERMINAL_DEFAULT_MAX_SESSIONS = 32;
+export const NATIVE_TERMINAL_MAX_SESSIONS = 256;
+export const NATIVE_TERMINAL_DEFAULT_REQUEST_TIMEOUT_MS = 5_000;
+export const NATIVE_TERMINAL_HEALTH_TIMEOUT_MS = 1_000;
+export const NATIVE_TERMINAL_MAX_ERROR_MESSAGE_CHARS = 1_024;
+export const NATIVE_TERMINAL_MAX_IDENTIFIER_CHARS = 128;
+export const NATIVE_TERMINAL_MAX_CONNECTIONS = 64;
+export const NATIVE_TERMINAL_MAX_PENDING_RESPONSES_PER_CONNECTION = 64;
+export const NATIVE_TERMINAL_MAX_PENDING_RESPONSE_BYTES_PER_CONNECTION = NATIVE_TERMINAL_MAX_FRAME_BYTES;
+export const NATIVE_TERMINAL_MAX_PENDING_RESPONSE_BYTES_TOTAL = 2 * NATIVE_TERMINAL_MAX_FRAME_BYTES;
+export const NATIVE_TERMINAL_STOP_SIGNALS = [
+    "SIGHUP",
+    "SIGINT",
+    "SIGTERM",
+    "SIGKILL",
+];
+export function isNativeTerminalStopSignal(value) {
+    return (typeof value === "string" &&
+        NATIVE_TERMINAL_STOP_SIGNALS.includes(value));
+}
+export class NativeTerminalRemoteError extends Error {
+    code;
+    constructor(error) {
+        super(error.message);
+        this.name = "NativeTerminalRemoteError";
+        this.code = error.code;
+    }
+}
+export function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+export function parseNativeTerminalResponse(value) {
+    if (!isRecord(value))
+        throw new TypeError("response must be an object");
+    if (value.version !== NATIVE_TERMINAL_PROTOCOL_VERSION) {
+        throw new TypeError("unsupported terminal protocol version");
+    }
+    if (typeof value.id !== "string" ||
+        value.id.length === 0 ||
+        value.id.length > NATIVE_TERMINAL_MAX_IDENTIFIER_CHARS) {
+        throw new TypeError(`response id must be a non-empty string of at most ${NATIVE_TERMINAL_MAX_IDENTIFIER_CHARS} characters`);
+    }
+    if (value.ok === true) {
+        if (!Object.prototype.hasOwnProperty.call(value, "result")) {
+            throw new TypeError("successful response must include a result");
+        }
+        return value;
+    }
+    if (value.ok !== false) {
+        throw new TypeError("response ok must be a boolean");
+    }
+    if (!isRecord(value.error)) {
+        throw new TypeError("error response must include an error object");
+    }
+    if (value.error.code !== "invalid-request" &&
+        value.error.code !== "operation-failed") {
+        throw new TypeError("terminal response error code is invalid");
+    }
+    if (typeof value.error.message !== "string" ||
+        value.error.message.length === 0 ||
+        value.error.message.length > NATIVE_TERMINAL_MAX_ERROR_MESSAGE_CHARS) {
+        throw new TypeError(`terminal response error message must contain 1-${NATIVE_TERMINAL_MAX_ERROR_MESSAGE_CHARS} characters`);
+    }
+    return value;
+}
+export function parseNativeTerminalRequest(value) {
+    if (!isRecord(value))
+        throw new TypeError("request must be an object");
+    if (value.version !== NATIVE_TERMINAL_PROTOCOL_VERSION) {
+        throw new TypeError("unsupported terminal protocol version");
+    }
+    if (typeof value.id !== "string" ||
+        value.id.length === 0 ||
+        value.id.length > NATIVE_TERMINAL_MAX_IDENTIFIER_CHARS) {
+        throw new TypeError(`request id must be a non-empty string of at most ${NATIVE_TERMINAL_MAX_IDENTIFIER_CHARS} characters`);
+    }
+    const operations = new Set([
+        "ping",
+        "create",
+        "list",
+        "state",
+        "read-output",
+        "attach-observer",
+        "acquire-controller",
+        "release-controller",
+        "write",
+        "resize",
+        "stop",
+    ]);
+    if (typeof value.operation !== "string" || !operations.has(value.operation)) {
+        throw new TypeError("unknown terminal operation");
+    }
+    if (value.params !== undefined && !isRecord(value.params)) {
+        throw new TypeError("request params must be an object");
+    }
+    return value;
+}
+//# sourceMappingURL=protocol.js.map

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

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

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

@@ -0,0 +1,26 @@
+export type TerminalOutputChunk = Readonly<{
+    seq: number;
+    data: string;
+}>;
+export type TerminalReplayGap = Readonly<{
+    fromSeq: number;
+    toSeq: number;
+}>;
+export type TerminalReplay = Readonly<{
+    chunks: ReadonlyArray<TerminalOutputChunk>;
+    gap: TerminalReplayGap | null;
+    latestSeq: number;
+}>;
+export declare const NATIVE_TERMINAL_MAX_REPLAY_CHUNKS_PER_SESSION = 65536;
+export declare const NATIVE_TERMINAL_MAX_REPLAY_WIRE_BYTES_PER_SESSION: number;
+export declare class TerminalReplayBuffer {
+    #private;
+    constructor(maxBytes: number, limits?: {
+        maxChunks?: number;
+        maxWireBytes?: number;
+    });
+    get latestSeq(): number;
+    append(data: string): TerminalOutputChunk;
+    readAfter(afterSeq: number): TerminalReplay;
+}
+//# sourceMappingURL=replay-buffer.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,84 @@
+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.
+export const NATIVE_TERMINAL_MAX_REPLAY_WIRE_BYTES_PER_SESSION = 24 * 1024 * 1024;
+export class TerminalReplayBuffer {
+    #maxBytes;
+    #maxChunks;
+    #maxWireBytes;
+    #chunks = [];
+    #head = 0;
+    #bytes = 0;
+    #wireBytes = 0;
+    #latestSeq = 0;
+    constructor(maxBytes, limits = {}) {
+        if (!Number.isSafeInteger(maxBytes) || maxBytes <= 0) {
+            throw new RangeError("maxBytes must be a positive safe integer");
+        }
+        const maxChunks = limits.maxChunks ?? NATIVE_TERMINAL_MAX_REPLAY_CHUNKS_PER_SESSION;
+        const maxWireBytes = limits.maxWireBytes ??
+            NATIVE_TERMINAL_MAX_REPLAY_WIRE_BYTES_PER_SESSION;
+        if (!Number.isSafeInteger(maxChunks) || maxChunks <= 0) {
+            throw new RangeError("maxChunks must be a positive safe integer");
+        }
+        if (!Number.isSafeInteger(maxWireBytes) || maxWireBytes <= 0) {
+            throw new RangeError("maxWireBytes must be a positive safe integer");
+        }
+        this.#maxBytes = maxBytes;
+        this.#maxChunks = maxChunks;
+        this.#maxWireBytes = maxWireBytes;
+    }
+    get latestSeq() {
+        return this.#latestSeq;
+    }
+    append(data) {
+        if (data.length === 0) {
+            throw new RangeError("terminal output chunks must not be empty");
+        }
+        const chunk = Object.freeze({ seq: ++this.#latestSeq, data });
+        const entry = Object.freeze({
+            chunk,
+            bytes: Buffer.byteLength(data, "utf8"),
+            // One byte reserves either the array comma or a conservative bracket.
+            wireBytes: Buffer.byteLength(JSON.stringify(chunk), "utf8") + 1,
+        });
+        this.#chunks.push(entry);
+        this.#bytes += entry.bytes;
+        this.#wireBytes += entry.wireBytes;
+        while ((this.#bytes > this.#maxBytes ||
+            this.#wireBytes > this.#maxWireBytes ||
+            this.#chunks.length - this.#head > this.#maxChunks) &&
+            this.#head < this.#chunks.length) {
+            const evicted = this.#chunks[this.#head++];
+            if (evicted) {
+                this.#bytes -= evicted.bytes;
+                this.#wireBytes -= evicted.wireBytes;
+            }
+        }
+        if (this.#head >= 1_024 && this.#head * 2 >= this.#chunks.length) {
+            this.#chunks.splice(0, this.#head);
+            this.#head = 0;
+        }
+        return chunk;
+    }
+    readAfter(afterSeq) {
+        if (!Number.isSafeInteger(afterSeq) ||
+            afterSeq < 0 ||
+            afterSeq > this.#latestSeq) {
+            throw new RangeError("afterSeq must identify this buffer's history");
+        }
+        const oldestAvailable = this.#chunks[this.#head]?.chunk.seq ?? this.#latestSeq + 1;
+        const gap = afterSeq < oldestAvailable - 1
+            ? Object.freeze({ fromSeq: afterSeq + 1, toSeq: oldestAvailable - 1 })
+            : null;
+        return Object.freeze({
+            chunks: this.#chunks
+                .slice(this.#head)
+                .filter(({ chunk }) => chunk.seq > afterSeq)
+                .map(({ chunk }) => chunk),
+            gap,
+            latestSeq: this.#latestSeq,
+        });
+    }
+}
+//# sourceMappingURL=replay-buffer.js.map

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

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

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

@@ -0,0 +1,13 @@
+import { NativeTerminalHost } from "./host.js";
+export type NativeTerminalHostServer = Readonly<{
+    socketPath: string;
+    close(options?: {
+        stopSessions?: boolean;
+        signal?: string;
+    }): Promise<void>;
+}>;
+export declare function startNativeTerminalHostServer(options: {
+    socketPath: string;
+    host: NativeTerminalHost;
+}): Promise<NativeTerminalHostServer>;
+//# sourceMappingURL=server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/native-terminal/server.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,kBAAkB,EAGnB,MAAM,WAAW,CAAC;AAwhBnB,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"}