@sentropic/h2a-runtime 0.91.0 → 0.92.0

package/dist/native-terminal/host.js

@@ -0,0 +1,275 @@
+import { randomUUID } from "node:crypto";
+import { TerminalReplayBuffer, } from "./replay-buffer.js";
+import { NATIVE_TERMINAL_DEFAULT_MAX_SESSIONS, NATIVE_TERMINAL_MAX_IDENTIFIER_CHARS, NATIVE_TERMINAL_MAX_SESSIONS, } from "./protocol.js";
+export class NativeTerminalHost {
+    #generation;
+    #replayBytesPerSession;
+    #maxSessions;
+    #spawner;
+    #sessions = new Map();
+    constructor(options) {
+        if (options.generation.trim().length === 0 ||
+            options.generation.length > NATIVE_TERMINAL_MAX_IDENTIFIER_CHARS) {
+            throw new RangeError(`terminal host generation must contain 1-${NATIVE_TERMINAL_MAX_IDENTIFIER_CHARS} characters`);
+        }
+        // Validate the budget once, before the first process is spawned.
+        new TerminalReplayBuffer(options.replayBytesPerSession);
+        const maxSessions = options.maxSessions ?? NATIVE_TERMINAL_DEFAULT_MAX_SESSIONS;
+        if (!Number.isSafeInteger(maxSessions) ||
+            maxSessions <= 0 ||
+            maxSessions > NATIVE_TERMINAL_MAX_SESSIONS) {
+            throw new RangeError(`maxSessions must be between 1 and ${NATIVE_TERMINAL_MAX_SESSIONS}`);
+        }
+        this.#generation = options.generation;
+        this.#replayBytesPerSession = options.replayBytesPerSession;
+        this.#maxSessions = maxSessions;
+        this.#spawner = options.spawner;
+    }
+    get generation() {
+        return this.#generation;
+    }
+    create(options) {
+        if (options.id.trim().length === 0 ||
+            options.id.length > NATIVE_TERMINAL_MAX_IDENTIFIER_CHARS) {
+            throw new RangeError(`terminal session id must contain 1-${NATIVE_TERMINAL_MAX_IDENTIFIER_CHARS} characters`);
+        }
+        const existing = this.#sessions.get(options.id);
+        if (existing?.status === "exited") {
+            this.#forget(existing);
+        }
+        else if (existing) {
+            throw new Error(`terminal session already exists: ${options.id}`);
+        }
+        this.#reapExitedUntilBelowLimit();
+        if (this.#sessions.size >= this.#maxSessions) {
+            throw new Error(`terminal host session limit reached: ${this.#maxSessions}`);
+        }
+        const record = {
+            id: options.id,
+            incarnation: randomUUID(),
+            pty: this.#spawner(options),
+            replay: new TerminalReplayBuffer(this.#replayBytesPerSession),
+            status: "running",
+            exit: null,
+            stopSignal: null,
+            controllerId: null,
+            controllerEpoch: 0,
+        };
+        this.#sessions.set(record.id, record);
+        record.dataSubscription = record.pty.onData((data) => {
+            if (record.exit !== null || data.length === 0)
+                return;
+            record.replay.append(data);
+        });
+        record.exitSubscription = record.pty.onExit((event) => {
+            if (record.exit !== null)
+                return;
+            const exit = {
+                exitCode: event.exitCode,
+            };
+            if (event.signal !== undefined)
+                exit.signal = event.signal;
+            record.exit = Object.freeze(exit);
+            record.status = "exited";
+            this.#invalidateController(record);
+            record.dataSubscription?.dispose();
+            record.exitSubscription?.dispose();
+        });
+        return this.#snapshot(record);
+    }
+    list() {
+        return Object.freeze([...this.#sessions.values()].map((record) => this.#snapshot(record)));
+    }
+    state(id) {
+        return this.#snapshot(this.#requireSession(id));
+    }
+    readOutput(id, afterSeq) {
+        const record = this.#requireSession(id);
+        const replay = record.replay.readAfter(afterSeq);
+        return Object.freeze({
+            generation: this.#generation,
+            incarnation: record.incarnation,
+            ...replay,
+        });
+    }
+    attachObserver(id) {
+        const record = this.#requireSession(id);
+        return Object.freeze({
+            role: "observer",
+            id,
+            generation: this.#generation,
+            incarnation: record.incarnation,
+            controllerEpoch: record.controllerEpoch,
+        });
+    }
+    acquireController(id, controllerId) {
+        const record = this.#requireControllableSession(id);
+        if (controllerId.trim().length === 0 ||
+            controllerId.length > NATIVE_TERMINAL_MAX_IDENTIFIER_CHARS) {
+            throw new RangeError(`terminal controller id must contain 1-${NATIVE_TERMINAL_MAX_IDENTIFIER_CHARS} characters`);
+        }
+        if (record.controllerId !== null) {
+            throw new Error(`terminal session already has a controller: ${id}`);
+        }
+        record.controllerEpoch += 1;
+        record.controllerId = controllerId;
+        return Object.freeze({
+            role: "controller",
+            id,
+            generation: this.#generation,
+            incarnation: record.incarnation,
+            controllerId,
+            epoch: record.controllerEpoch,
+        });
+    }
+    releaseController(lease) {
+        const record = this.#requireMatchingController(lease);
+        this.#invalidateController(record);
+        return Object.freeze({
+            id: record.id,
+            generation: this.#generation,
+            incarnation: record.incarnation,
+            controllerEpoch: record.controllerEpoch,
+        });
+    }
+    write(lease, data) {
+        if (data.length === 0) {
+            throw new RangeError("terminal input must not be empty");
+        }
+        this.#requireController(lease).pty.write(data);
+    }
+    resize(lease, cols, rows) {
+        if (!Number.isSafeInteger(cols) ||
+            cols <= 0 ||
+            !Number.isSafeInteger(rows) ||
+            rows <= 0) {
+            throw new RangeError("terminal dimensions must be positive safe integers");
+        }
+        this.#requireController(lease).pty.resize(cols, rows);
+    }
+    stop(lease, signal = "SIGTERM") {
+        const record = this.#requireMatchingController(lease);
+        const previousStatus = record.status;
+        const previousSignal = record.stopSignal;
+        record.status = "stopping";
+        record.stopSignal = signal;
+        try {
+            record.pty.kill(signal);
+        }
+        catch (error) {
+            record.status = previousStatus;
+            record.stopSignal = previousSignal;
+            throw error;
+        }
+        return this.#snapshot(record);
+    }
+    stopAll(signal = "SIGTERM") {
+        for (const record of this.#sessions.values()) {
+            if (record.status !== "running")
+                continue;
+            record.status = "stopping";
+            record.stopSignal = signal;
+            this.#invalidateController(record);
+            try {
+                record.pty.kill(signal);
+            }
+            catch (error) {
+                record.status = "running";
+                record.stopSignal = null;
+                throw error;
+            }
+        }
+        return this.list();
+    }
+    forceStopAll(signal = "SIGKILL") {
+        const errors = [];
+        for (const record of this.#sessions.values()) {
+            if (record.status === "exited")
+                continue;
+            if (record.status === "running") {
+                record.status = "stopping";
+                this.#invalidateController(record);
+            }
+            record.stopSignal = signal;
+            try {
+                record.pty.kill(signal);
+            }
+            catch (error) {
+                errors.push(error);
+            }
+        }
+        if (errors.length > 0) {
+            throw new AggregateError(errors, "failed to force-stop one or more terminal sessions");
+        }
+        return this.list();
+    }
+    #requireSession(id) {
+        const record = this.#sessions.get(id);
+        if (!record)
+            throw new Error(`unknown terminal session: ${id}`);
+        return record;
+    }
+    #requireControllableSession(id) {
+        const record = this.#requireSession(id);
+        if (record.status === "exited") {
+            throw new Error(`terminal session is already exited: ${id}`);
+        }
+        return record;
+    }
+    #requireController(lease) {
+        const record = this.#requireMatchingController(lease);
+        if (record.status !== "running") {
+            throw new Error("stale terminal controller lease");
+        }
+        return record;
+    }
+    #requireMatchingController(lease) {
+        const record = this.#sessions.get(lease.id);
+        if (lease.generation !== this.#generation ||
+            !record ||
+            lease.incarnation !== record.incarnation ||
+            record.status === "exited" ||
+            record.controllerId !== lease.controllerId ||
+            record.controllerEpoch !== lease.epoch) {
+            throw new Error("stale terminal controller lease");
+        }
+        return record;
+    }
+    #reapExitedUntilBelowLimit() {
+        if (this.#sessions.size < this.#maxSessions)
+            return;
+        for (const record of this.#sessions.values()) {
+            if (record.status !== "exited")
+                continue;
+            this.#forget(record);
+            if (this.#sessions.size < this.#maxSessions)
+                return;
+        }
+    }
+    #forget(record) {
+        record.dataSubscription?.dispose();
+        record.exitSubscription?.dispose();
+        delete record.dataSubscription;
+        delete record.exitSubscription;
+        this.#sessions.delete(record.id);
+    }
+    #invalidateController(record) {
+        if (record.controllerId === null)
+            return;
+        record.controllerId = null;
+        record.controllerEpoch += 1;
+    }
+    #snapshot(record) {
+        return Object.freeze({
+            id: record.id,
+            generation: this.#generation,
+            incarnation: record.incarnation,
+            pid: record.pty.pid,
+            status: record.status,
+            latestSeq: record.replay.latestSeq,
+            exit: record.exit,
+            stopSignal: record.stopSignal,
+        });
+    }
+}
+//# sourceMappingURL=host.js.map

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

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

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

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+type ProcessOptions = {
+    socketPath: string;
+    generation: string;
+    replayBytesPerSession: number;
+    maxSessions: number;
+};
+export declare function parseNativeTerminalHostArgs(argv: ReadonlyArray<string>): ProcessOptions;
+export declare function runNativeTerminalHostProcess(argv: ReadonlyArray<string>): Promise<void>;
+export {};
+//# sourceMappingURL=process.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"process.d.ts","sourceRoot":"","sources":["../../src/native-terminal/process.ts"],"names":[],"mappings":";AAYA,KAAK,cAAc,GAAG;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AA2CF,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,cAAc,CAiCvF;AAED,wBAAsB,4BAA4B,CAAC,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAkD7F"}

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":"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"}

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"}