@code-yeongyu/senpi-pty 2026.7.25-2

package/dist/screen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screen.d.ts","sourceRoot":"","sources":["../src/screen.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,qBAAqB;IACrC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,sBAAsB;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE;QAChB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;CACF;AAWD,qBAAa,cAAc;IAC1B,OAAO,CAAC,QAAQ,CAAoB;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAS;IAChD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IAEpC,YAAY,OAAO,GAAE,qBAA0B,EAM9C;IAED,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAK7C;IAED,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMhD;IAED,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAErB;IAED,QAAQ,IAAI,sBAAsB,CAwBjC;IAED,OAAO,IAAI,IAAI,CAEd;IAED,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,KAAK;IAeb,OAAO,CAAC,aAAa;IAMrB,OAAO,CAAC,WAAW;CAcnB"}

package/dist/screen.js

@@ -0,0 +1,155 @@
+import xterm from "@xterm/headless";
+const XtermTerminal = xterm.Terminal;
+const DEFAULT_COLS = 80;
+const DEFAULT_ROWS = 24;
+const DEFAULT_SCROLLBACK = 1000;
+const MIN_SIZE = 1;
+const MAX_SIZE = 10000;
+const MIN_REPLAY_HISTORY_LENGTH = 4096;
+const MAX_REPLAY_HISTORY_LENGTH = 1_000_000;
+export class TerminalScreen {
+    constructor(options = {}) {
+        this.history = [];
+        this.historyLength = 0;
+        const cols = normalizeDimension(options.cols, DEFAULT_COLS);
+        const rows = normalizeDimension(options.rows, DEFAULT_ROWS);
+        this.scrollback = normalizeScrollback(options.scrollback);
+        this.maxReplayHistoryLength = normalizeReplayHistoryLength(cols, rows, this.scrollback);
+        this.terminal = this.createTerminal(cols, rows);
+    }
+    feed(data) {
+        const payload = decodeInput(data);
+        const sanitizedPayload = sanitizeString(payload);
+        if (sanitizedPayload.length > 0)
+            this.appendHistory(sanitizedPayload);
+        return this.write(payload);
+    }
+    resize(cols, rows) {
+        const nextCols = normalizeDimension(cols, this.terminal.cols);
+        const nextRows = normalizeDimension(rows, this.terminal.rows);
+        this.terminal.dispose();
+        this.terminal = this.createTerminal(nextCols, nextRows);
+        return this.write(this.history.join(""));
+    }
+    flush() {
+        return this.write("");
+    }
+    snapshot() {
+        const buffer = this.terminal.buffer.active;
+        const viewportStart = buffer.viewportY;
+        const visibleGrid = [];
+        const scrollback = [];
+        const scrollbackStart = Math.max(0, viewportStart - this.scrollback);
+        for (let lineIndex = scrollbackStart; lineIndex < viewportStart; lineIndex += 1) {
+            scrollback.push(readLine(buffer, lineIndex));
+        }
+        for (let row = 0; row < this.terminal.rows; row += 1) {
+            visibleGrid.push(readLine(buffer, viewportStart + row));
+        }
+        return {
+            cols: this.terminal.cols,
+            rows: this.terminal.rows,
+            visibleGrid,
+            scrollback,
+            cursor: {
+                x: buffer.cursorX,
+                y: buffer.cursorY,
+            },
+        };
+    }
+    dispose() {
+        this.terminal.dispose();
+    }
+    createTerminal(cols, rows) {
+        return new XtermTerminal({
+            cols,
+            rows,
+            scrollback: this.scrollback,
+            disableStdin: true,
+            allowProposedApi: true,
+            logLevel: "off",
+        });
+    }
+    write(payload) {
+        return new Promise((resolve, reject) => {
+            try {
+                this.terminal.write(payload, resolve);
+            }
+            catch (error) {
+                const sanitizedPayload = sanitizeString(payload);
+                if (sanitizedPayload === payload) {
+                    reject(error instanceof Error ? error : new Error(String(error)));
+                    return;
+                }
+                this.terminal.write(sanitizedPayload, resolve);
+            }
+        });
+    }
+    appendHistory(payload) {
+        this.history.push(payload);
+        this.historyLength += payload.length;
+        this.trimHistory();
+    }
+    trimHistory() {
+        while (this.historyLength > this.maxReplayHistoryLength && this.history.length > 1) {
+            const removed = this.history.shift();
+            if (removed === undefined)
+                return;
+            this.historyLength -= removed.length;
+        }
+        if (this.historyLength <= this.maxReplayHistoryLength)
+            return;
+        const [onlyChunk] = this.history;
+        if (onlyChunk === undefined)
+            return;
+        const trimmed = sanitizeString(onlyChunk.slice(-this.maxReplayHistoryLength));
+        this.history[0] = trimmed;
+        this.historyLength = trimmed.length;
+    }
+}
+function readLine(buffer, lineIndex) {
+    return buffer.getLine(lineIndex)?.translateToString(true) ?? "";
+}
+function normalizeDimension(value, fallback) {
+    if (value === undefined || !Number.isFinite(value))
+        return fallback;
+    return Math.min(MAX_SIZE, Math.max(MIN_SIZE, Math.trunc(value)));
+}
+function normalizeScrollback(value) {
+    if (value === undefined || !Number.isFinite(value))
+        return DEFAULT_SCROLLBACK;
+    return Math.max(0, Math.trunc(value));
+}
+function normalizeReplayHistoryLength(cols, rows, scrollback) {
+    const visibleCells = Math.max(MIN_SIZE, cols) * Math.max(MIN_SIZE, rows + scrollback + 1);
+    return Math.min(MAX_REPLAY_HISTORY_LENGTH, Math.max(MIN_REPLAY_HISTORY_LENGTH, visibleCells * 4));
+}
+function decodeInput(value) {
+    if (typeof value === "string")
+        return value;
+    return new TextDecoder("utf-8", { fatal: false }).decode(value);
+}
+function sanitizeString(value) {
+    let output = "";
+    for (let index = 0; index < value.length; index += 1) {
+        const code = value.charCodeAt(index);
+        if (code >= 0xd800 && code <= 0xdbff) {
+            const next = value.charCodeAt(index + 1);
+            if (next >= 0xdc00 && next <= 0xdfff) {
+                output += value[index] + value[index + 1];
+                index += 1;
+            }
+            else {
+                output += "\uFFFD";
+            }
+        }
+        else if (code >= 0xdc00 && code <= 0xdfff) {
+            output += "\uFFFD";
+        }
+        else {
+            output += value[index];
+        }
+    }
+    return output;
+}
+//# sourceMappingURL=screen.js.map

package/dist/screen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"screen.js","sourceRoot":"","sources":["../src/screen.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Terminal as XtermTerminalType } from \"@xterm/headless\";\nimport xterm from \"@xterm/headless\";\n\nexport interface TerminalScreenOptions {\n\treadonly cols?: number;\n\treadonly rows?: number;\n\treadonly scrollback?: number;\n}\n\nexport interface TerminalScreenSnapshot {\n\treadonly cols: number;\n\treadonly rows: number;\n\treadonly visibleGrid: readonly string[];\n\treadonly scrollback: readonly string[];\n\treadonly cursor: {\n\t\treadonly x: number;\n\t\treadonly y: number;\n\t};\n}\n\nconst XtermTerminal = xterm.Terminal;\nconst DEFAULT_COLS = 80;\nconst DEFAULT_ROWS = 24;\nconst DEFAULT_SCROLLBACK = 1000;\nconst MIN_SIZE = 1;\nconst MAX_SIZE = 10000;\nconst MIN_REPLAY_HISTORY_LENGTH = 4096;\nconst MAX_REPLAY_HISTORY_LENGTH = 1_000_000;\n\nexport class TerminalScreen {\n\tprivate terminal: XtermTerminalType;\n\tprivate readonly history: string[] = [];\n\tprivate historyLength = 0;\n\tprivate readonly maxReplayHistoryLength: number;\n\tprivate readonly scrollback: number;\n\n\tconstructor(options: TerminalScreenOptions = {}) {\n\t\tconst cols = normalizeDimension(options.cols, DEFAULT_COLS);\n\t\tconst rows = normalizeDimension(options.rows, DEFAULT_ROWS);\n\t\tthis.scrollback = normalizeScrollback(options.scrollback);\n\t\tthis.maxReplayHistoryLength = normalizeReplayHistoryLength(cols, rows, this.scrollback);\n\t\tthis.terminal = this.createTerminal(cols, rows);\n\t}\n\n\tfeed(data: string | Uint8Array): Promise<void> {\n\t\tconst payload = decodeInput(data);\n\t\tconst sanitizedPayload = sanitizeString(payload);\n\t\tif (sanitizedPayload.length > 0) this.appendHistory(sanitizedPayload);\n\t\treturn this.write(payload);\n\t}\n\n\tresize(cols: number, rows: number): Promise<void> {\n\t\tconst nextCols = normalizeDimension(cols, this.terminal.cols);\n\t\tconst nextRows = normalizeDimension(rows, this.terminal.rows);\n\t\tthis.terminal.dispose();\n\t\tthis.terminal = this.createTerminal(nextCols, nextRows);\n\t\treturn this.write(this.history.join(\"\"));\n\t}\n\n\tflush(): Promise<void> {\n\t\treturn this.write(\"\");\n\t}\n\n\tsnapshot(): TerminalScreenSnapshot {\n\t\tconst buffer = this.terminal.buffer.active;\n\t\tconst viewportStart = buffer.viewportY;\n\t\tconst visibleGrid: string[] = [];\n\t\tconst scrollback: string[] = [];\n\t\tconst scrollbackStart = Math.max(0, viewportStart - this.scrollback);\n\n\t\tfor (let lineIndex = scrollbackStart; lineIndex < viewportStart; lineIndex += 1) {\n\t\t\tscrollback.push(readLine(buffer, lineIndex));\n\t\t}\n\t\tfor (let row = 0; row < this.terminal.rows; row += 1) {\n\t\t\tvisibleGrid.push(readLine(buffer, viewportStart + row));\n\t\t}\n\n\t\treturn {\n\t\t\tcols: this.terminal.cols,\n\t\t\trows: this.terminal.rows,\n\t\t\tvisibleGrid,\n\t\t\tscrollback,\n\t\t\tcursor: {\n\t\t\t\tx: buffer.cursorX,\n\t\t\t\ty: buffer.cursorY,\n\t\t\t},\n\t\t};\n\t}\n\n\tdispose(): void {\n\t\tthis.terminal.dispose();\n\t}\n\n\tprivate createTerminal(cols: number, rows: number): XtermTerminalType {\n\t\treturn new XtermTerminal({\n\t\t\tcols,\n\t\t\trows,\n\t\t\tscrollback: this.scrollback,\n\t\t\tdisableStdin: true,\n\t\t\tallowProposedApi: true,\n\t\t\tlogLevel: \"off\",\n\t\t});\n\t}\n\n\tprivate write(payload: string): Promise<void> {\n\t\treturn new Promise((resolve, reject) => {\n\t\t\ttry {\n\t\t\t\tthis.terminal.write(payload, resolve);\n\t\t\t} catch (error) {\n\t\t\t\tconst sanitizedPayload = sanitizeString(payload);\n\t\t\t\tif (sanitizedPayload === payload) {\n\t\t\t\t\treject(error instanceof Error ? error : new Error(String(error)));\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tthis.terminal.write(sanitizedPayload, resolve);\n\t\t\t}\n\t\t});\n\t}\n\n\tprivate appendHistory(payload: string): void {\n\t\tthis.history.push(payload);\n\t\tthis.historyLength += payload.length;\n\t\tthis.trimHistory();\n\t}\n\n\tprivate trimHistory(): void {\n\t\twhile (this.historyLength > this.maxReplayHistoryLength && this.history.length > 1) {\n\t\t\tconst removed = this.history.shift();\n\t\t\tif (removed === undefined) return;\n\t\t\tthis.historyLength -= removed.length;\n\t\t}\n\n\t\tif (this.historyLength <= this.maxReplayHistoryLength) return;\n\t\tconst [onlyChunk] = this.history;\n\t\tif (onlyChunk === undefined) return;\n\t\tconst trimmed = sanitizeString(onlyChunk.slice(-this.maxReplayHistoryLength));\n\t\tthis.history[0] = trimmed;\n\t\tthis.historyLength = trimmed.length;\n\t}\n}\n\nfunction readLine(buffer: XtermTerminalType[\"buffer\"][\"active\"], lineIndex: number): string {\n\treturn buffer.getLine(lineIndex)?.translateToString(true) ?? \"\";\n}\n\nfunction normalizeDimension(value: number | undefined, fallback: number): number {\n\tif (value === undefined || !Number.isFinite(value)) return fallback;\n\treturn Math.min(MAX_SIZE, Math.max(MIN_SIZE, Math.trunc(value)));\n}\n\nfunction normalizeScrollback(value: number | undefined): number {\n\tif (value === undefined || !Number.isFinite(value)) return DEFAULT_SCROLLBACK;\n\treturn Math.max(0, Math.trunc(value));\n}\n\nfunction normalizeReplayHistoryLength(cols: number, rows: number, scrollback: number): number {\n\tconst visibleCells = Math.max(MIN_SIZE, cols) * Math.max(MIN_SIZE, rows + scrollback + 1);\n\treturn Math.min(MAX_REPLAY_HISTORY_LENGTH, Math.max(MIN_REPLAY_HISTORY_LENGTH, visibleCells * 4));\n}\n\nfunction decodeInput(value: string | Uint8Array): string {\n\tif (typeof value === \"string\") return value;\n\treturn new TextDecoder(\"utf-8\", { fatal: false }).decode(value);\n}\n\nfunction sanitizeString(value: string): string {\n\tlet output = \"\";\n\tfor (let index = 0; index < value.length; index += 1) {\n\t\tconst code = value.charCodeAt(index);\n\t\tif (code >= 0xd800 && code <= 0xdbff) {\n\t\t\tconst next = value.charCodeAt(index + 1);\n\t\t\tif (next >= 0xdc00 && next <= 0xdfff) {\n\t\t\t\toutput += value[index] + value[index + 1];\n\t\t\t\tindex += 1;\n\t\t\t} else {\n\t\t\t\toutput += \"\\uFFFD\";\n\t\t\t}\n\t\t} else if (code >= 0xdc00 && code <= 0xdfff) {\n\t\t\toutput += \"\\uFFFD\";\n\t\t} else {\n\t\t\toutput += value[index];\n\t\t}\n\t}\n\treturn output;\n}\n"]}

package/dist/session-exit.d.ts

@@ -0,0 +1,8 @@
+import type { PipeFallbackOperationResult } from "./pipe-fallback.ts";
+import type { TerminalSessionBackend, TerminalSessionExit, TerminalSessionOperationResult } from "./session-types.ts";
+export declare function normalizeTerminalExit(exit: unknown, backend: TerminalSessionBackend, killRequested: boolean): TerminalSessionExit;
+export declare function normalizeOperationResult(result: TerminalSessionOperationResult | PipeFallbackOperationResult | undefined, defaultNote: string): TerminalSessionOperationResult;
+export declare function normalizeUnknownOperationResult(result: unknown): TerminalSessionOperationResult | undefined;
+export declare function notStartedOperation(operation: string): TerminalSessionOperationResult;
+export declare function exitedOperation(operation: string): TerminalSessionOperationResult;
+//# sourceMappingURL=session-exit.d.ts.map

package/dist/session-exit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-exit.d.ts","sourceRoot":"","sources":["../src/session-exit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAA2B,MAAM,oBAAoB,CAAC;AAC/F,OAAO,KAAK,EACX,sBAAsB,EACtB,mBAAmB,EAEnB,8BAA8B,EAC9B,MAAM,oBAAoB,CAAC;AAE5B,wBAAgB,qBAAqB,CACpC,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,sBAAsB,EAC/B,aAAa,EAAE,OAAO,GACpB,mBAAmB,CAkBrB;AAED,wBAAgB,wBAAwB,CACvC,MAAM,EAAE,8BAA8B,GAAG,2BAA2B,GAAG,SAAS,EAChF,WAAW,EAAE,MAAM,GACjB,8BAA8B,CAIhC;AAED,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,OAAO,GAAG,8BAA8B,GAAG,SAAS,CAQ3G;AAED,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,8BAA8B,CAMrF;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,8BAA8B,CAMjF"}

package/dist/session-exit.js

@@ -0,0 +1,103 @@
+export function normalizeTerminalExit(exit, backend, killRequested) {
+    if (backend === "pipe-fallback" && isPipeFallbackSessionExit(exit)) {
+        return normalizePipeFallbackExit(exit, killRequested);
+    }
+    const record = isRecord(exit) ? exit : {};
+    if (record.backend === "pipe-fallback" && isPipeFallbackSessionExit(exit)) {
+        return normalizePipeFallbackExit(exit, killRequested);
+    }
+    const timedOut = readBoolean(record, "timedOut") ?? readBoolean(record, "timed_out") ?? false;
+    return {
+        backend,
+        exitCode: readNullableNumber(record, "exitCode") ?? readNullableNumber(record, "exit_code") ?? null,
+        signal: readNullableString(record, "signal"),
+        cancelled: (readBoolean(record, "cancelled") ?? readBoolean(record, "canceled") ?? false) || killRequested || timedOut,
+        timedOut,
+        error: readTerminalExitError(record),
+    };
+}
+export function normalizeOperationResult(result, defaultNote) {
+    if (result === undefined)
+        return { ok: true, note: defaultNote };
+    if ("ok" in result)
+        return result;
+    return { ok: true, note: defaultNote };
+}
+export function normalizeUnknownOperationResult(result) {
+    if (!isRecord(result))
+        return undefined;
+    const ok = result.ok;
+    const note = result.note;
+    if (typeof ok !== "boolean" || typeof note !== "string")
+        return undefined;
+    const code = typeof result.code === "string" ? result.code : undefined;
+    const idempotent = typeof result.idempotent === "boolean" ? result.idempotent : undefined;
+    return { ok, note, code, idempotent };
+}
+export function notStartedOperation(operation) {
+    return {
+        ok: false,
+        code: "not_started",
+        note: `Cannot ${operation} terminal session: session has not started.`,
+    };
+}
+export function exitedOperation(operation) {
+    return {
+        ok: false,
+        code: "exited",
+        note: `Cannot ${operation} terminal session: session has exited.`,
+    };
+}
+function normalizePipeFallbackExit(exit, killRequested) {
+    return {
+        backend: "pipe-fallback",
+        exitCode: exit.exitCode,
+        signal: exit.signal,
+        cancelled: killRequested || exit.timedOut,
+        timedOut: exit.timedOut,
+        error: exit.error,
+    };
+}
+function isPipeFallbackSessionExit(value) {
+    if (!isRecord(value))
+        return false;
+    const exitCode = value.exitCode;
+    const signal = value.signal;
+    const timedOut = value.timedOut;
+    const error = value.error;
+    const exitCodeValid = exitCode === null || (typeof exitCode === "number" && Number.isFinite(exitCode));
+    const signalValid = signal === null || typeof signal === "string";
+    const errorValid = error === undefined || isTerminalExitError(error);
+    return exitCodeValid && signalValid && typeof timedOut === "boolean" && errorValid;
+}
+function isTerminalExitError(value) {
+    if (!isRecord(value))
+        return false;
+    return typeof value.code === "string" && typeof value.message === "string";
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+function readNullableNumber(record, key) {
+    const value = record[key];
+    if (value === null)
+        return null;
+    return typeof value === "number" && Number.isFinite(value) ? value : undefined;
+}
+function readNullableString(record, key) {
+    const value = record[key];
+    if (value === null)
+        return null;
+    return typeof value === "string" ? value : null;
+}
+function readBoolean(record, key) {
+    const value = record[key];
+    return typeof value === "boolean" ? value : undefined;
+}
+function readTerminalExitError(record) {
+    const error = record.error;
+    if (!isTerminalExitError(error))
+        return undefined;
+    return error;
+}
+//# sourceMappingURL=session-exit.js.map

package/dist/session-exit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-exit.js","sourceRoot":"","sources":["../src/session-exit.ts"],"names":[],"mappings":"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","sourcesContent":["import type { PipeFallbackOperationResult, PipeFallbackSessionExit } from \"./pipe-fallback.ts\";\nimport type {\n\tTerminalSessionBackend,\n\tTerminalSessionExit,\n\tTerminalSessionExitError,\n\tTerminalSessionOperationResult,\n} from \"./session-types.ts\";\n\nexport function normalizeTerminalExit(\n\texit: unknown,\n\tbackend: TerminalSessionBackend,\n\tkillRequested: boolean,\n): TerminalSessionExit {\n\tif (backend === \"pipe-fallback\" && isPipeFallbackSessionExit(exit)) {\n\t\treturn normalizePipeFallbackExit(exit, killRequested);\n\t}\n\tconst record = isRecord(exit) ? exit : {};\n\tif (record.backend === \"pipe-fallback\" && isPipeFallbackSessionExit(exit)) {\n\t\treturn normalizePipeFallbackExit(exit, killRequested);\n\t}\n\tconst timedOut = readBoolean(record, \"timedOut\") ?? readBoolean(record, \"timed_out\") ?? false;\n\treturn {\n\t\tbackend,\n\t\texitCode: readNullableNumber(record, \"exitCode\") ?? readNullableNumber(record, \"exit_code\") ?? null,\n\t\tsignal: readNullableString(record, \"signal\"),\n\t\tcancelled:\n\t\t\t(readBoolean(record, \"cancelled\") ?? readBoolean(record, \"canceled\") ?? false) || killRequested || timedOut,\n\t\ttimedOut,\n\t\terror: readTerminalExitError(record),\n\t};\n}\n\nexport function normalizeOperationResult(\n\tresult: TerminalSessionOperationResult | PipeFallbackOperationResult | undefined,\n\tdefaultNote: string,\n): TerminalSessionOperationResult {\n\tif (result === undefined) return { ok: true, note: defaultNote };\n\tif (\"ok\" in result) return result;\n\treturn { ok: true, note: defaultNote };\n}\n\nexport function normalizeUnknownOperationResult(result: unknown): TerminalSessionOperationResult | undefined {\n\tif (!isRecord(result)) return undefined;\n\tconst ok = result.ok;\n\tconst note = result.note;\n\tif (typeof ok !== \"boolean\" || typeof note !== \"string\") return undefined;\n\tconst code = typeof result.code === \"string\" ? result.code : undefined;\n\tconst idempotent = typeof result.idempotent === \"boolean\" ? result.idempotent : undefined;\n\treturn { ok, note, code, idempotent };\n}\n\nexport function notStartedOperation(operation: string): TerminalSessionOperationResult {\n\treturn {\n\t\tok: false,\n\t\tcode: \"not_started\",\n\t\tnote: `Cannot ${operation} terminal session: session has not started.`,\n\t};\n}\n\nexport function exitedOperation(operation: string): TerminalSessionOperationResult {\n\treturn {\n\t\tok: false,\n\t\tcode: \"exited\",\n\t\tnote: `Cannot ${operation} terminal session: session has exited.`,\n\t};\n}\n\nfunction normalizePipeFallbackExit(exit: PipeFallbackSessionExit, killRequested: boolean): TerminalSessionExit {\n\treturn {\n\t\tbackend: \"pipe-fallback\",\n\t\texitCode: exit.exitCode,\n\t\tsignal: exit.signal,\n\t\tcancelled: killRequested || exit.timedOut,\n\t\ttimedOut: exit.timedOut,\n\t\terror: exit.error,\n\t};\n}\n\nfunction isPipeFallbackSessionExit(value: unknown): value is PipeFallbackSessionExit {\n\tif (!isRecord(value)) return false;\n\tconst exitCode = value.exitCode;\n\tconst signal = value.signal;\n\tconst timedOut = value.timedOut;\n\tconst error = value.error;\n\tconst exitCodeValid = exitCode === null || (typeof exitCode === \"number\" && Number.isFinite(exitCode));\n\tconst signalValid = signal === null || typeof signal === \"string\";\n\tconst errorValid = error === undefined || isTerminalExitError(error);\n\treturn exitCodeValid && signalValid && typeof timedOut === \"boolean\" && errorValid;\n}\n\nfunction isTerminalExitError(value: unknown): value is TerminalSessionExitError {\n\tif (!isRecord(value)) return false;\n\treturn typeof value.code === \"string\" && typeof value.message === \"string\";\n}\n\nfunction isRecord(value: unknown): value is Readonly<Record<string, unknown>> {\n\treturn typeof value === \"object\" && value !== null;\n}\n\nfunction readNullableNumber(record: Readonly<Record<string, unknown>>, key: string): number | null | undefined {\n\tconst value = record[key];\n\tif (value === null) return null;\n\treturn typeof value === \"number\" && Number.isFinite(value) ? value : undefined;\n}\n\nfunction readNullableString(record: Readonly<Record<string, unknown>>, key: string): string | null {\n\tconst value = record[key];\n\tif (value === null) return null;\n\treturn typeof value === \"string\" ? value : null;\n}\n\nfunction readBoolean(record: Readonly<Record<string, unknown>>, key: string): boolean | undefined {\n\tconst value = record[key];\n\treturn typeof value === \"boolean\" ? value : undefined;\n}\n\nfunction readTerminalExitError(record: Readonly<Record<string, unknown>>): TerminalSessionExitError | undefined {\n\tconst error = record.error;\n\tif (!isTerminalExitError(error)) return undefined;\n\treturn error;\n}\n"]}

package/dist/session-native.d.ts

@@ -0,0 +1,4 @@
+import type { NativePtyLoadResult } from "./native-loader.ts";
+import type { CreateNativeTerminalSession } from "./session-types.ts";
+export declare function getNativeSessionFactory(loadResult: NativePtyLoadResult): CreateNativeTerminalSession | null;
+//# sourceMappingURL=session-native.d.ts.map

package/dist/session-native.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-native.d.ts","sourceRoot":"","sources":["../src/session-native.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9D,OAAO,KAAK,EACX,2BAA2B,EAK3B,MAAM,oBAAoB,CAAC;AAa5B,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,mBAAmB,GAAG,2BAA2B,GAAG,IAAI,CAW3G"}

package/dist/session-native.js

@@ -0,0 +1,94 @@
+import { normalizeUnknownOperationResult } from "./session-exit.js";
+export function getNativeSessionFactory(loadResult) {
+    if (loadResult.native === null)
+        return null;
+    const create = loadResult.native.createPtySession ?? loadResult.native.startPtySession;
+    if (isNativeSessionCreator(create)) {
+        return (options, onData) => normalizeTerminalSessionHandle(create(options, onData));
+    }
+    const PtySession = loadResult.native.PtySession;
+    if (isNativeSessionConstructor(PtySession)) {
+        return (options, onData) => normalizeTerminalSessionHandle(new PtySession(options, onData));
+    }
+    return null;
+}
+function normalizeTerminalSessionHandle(value) {
+    if (!isRecord(value))
+        throw new Error("Native PTY session factory did not return an object");
+    const write = value.write;
+    const resize = value.resize;
+    const kill = value.kill;
+    if (!isNativeWrite(write))
+        throw new Error("Native PTY session handle is missing write()");
+    if (!isNativeResize(resize))
+        throw new Error("Native PTY session handle is missing resize()");
+    if (!isNativeKill(kill))
+        throw new Error("Native PTY session handle is missing kill()");
+    const waitExit = value.waitExit;
+    const wait = value.wait;
+    if (!isNativeWait(waitExit) && !isNativeWait(wait)) {
+        throw new Error("Native PTY session handle is missing waitExit() or wait()");
+    }
+    const requiredHandle = {
+        write(data) {
+            return normalizeUnknownOperationResult(write.call(value, data));
+        },
+        resize(cols, rows) {
+            return normalizeUnknownOperationResult(resize.call(value, cols, rows));
+        },
+        kill(signal) {
+            return normalizeUnknownOperationResult(kill.call(value, signal));
+        },
+    };
+    const onData = value.onData;
+    if (isNativeWait(waitExit) && isNativeOnData(onData)) {
+        return {
+            ...requiredHandle,
+            onData: (handler) => normalizeUnsubscribe(onData.call(value, handler)),
+            waitExit: async () => waitExit.call(value),
+        };
+    }
+    if (isNativeWait(waitExit))
+        return { ...requiredHandle, waitExit: async () => waitExit.call(value) };
+    if (isNativeOnData(onData) && isNativeWait(wait)) {
+        return {
+            ...requiredHandle,
+            onData: (handler) => normalizeUnsubscribe(onData.call(value, handler)),
+            wait: async () => wait.call(value),
+        };
+    }
+    if (isNativeWait(wait))
+        return { ...requiredHandle, wait: async () => wait.call(value) };
+    throw new Error("Native PTY session handle is missing waitExit() or wait()");
+}
+function normalizeUnsubscribe(value) {
+    return isUnsubscribe(value) ? value : () => { };
+}
+function isNativeSessionCreator(value) {
+    return typeof value === "function";
+}
+function isNativeSessionConstructor(value) {
+    return typeof value === "function";
+}
+function isNativeWrite(value) {
+    return typeof value === "function";
+}
+function isNativeResize(value) {
+    return typeof value === "function";
+}
+function isNativeKill(value) {
+    return typeof value === "function";
+}
+function isNativeWait(value) {
+    return typeof value === "function";
+}
+function isNativeOnData(value) {
+    return typeof value === "function";
+}
+function isUnsubscribe(value) {
+    return typeof value === "function";
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+//# sourceMappingURL=session-native.js.map

package/dist/session-native.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-native.js","sourceRoot":"","sources":["../src/session-native.ts"],"names":[],"mappings":"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","sourcesContent":["import type { NativePtyLoadResult } from \"./native-loader.ts\";\nimport { normalizeUnknownOperationResult } from \"./session-exit.ts\";\nimport type {\n\tCreateNativeTerminalSession,\n\tTerminalSessionDataHandler,\n\tTerminalSessionHandle,\n\tTerminalSessionNativeOptions,\n\tTerminalSessionSignal,\n} from \"./session-types.ts\";\n\ntype NativeSessionCreator = (options: TerminalSessionNativeOptions, onData: TerminalSessionDataHandler) => unknown;\ntype NativeSessionConstructor = new (\n\toptions: TerminalSessionNativeOptions,\n\tonData: TerminalSessionDataHandler,\n) => unknown;\ntype NativeWrite = (data: string | Uint8Array) => unknown;\ntype NativeResize = (cols: number, rows: number) => unknown;\ntype NativeKill = (signal?: TerminalSessionSignal) => unknown;\ntype NativeWait = () => Promise<unknown> | unknown;\ntype NativeOnData = (handler: TerminalSessionDataHandler) => (() => void) | unknown;\n\nexport function getNativeSessionFactory(loadResult: NativePtyLoadResult): CreateNativeTerminalSession | null {\n\tif (loadResult.native === null) return null;\n\tconst create = loadResult.native.createPtySession ?? loadResult.native.startPtySession;\n\tif (isNativeSessionCreator(create)) {\n\t\treturn (options, onData) => normalizeTerminalSessionHandle(create(options, onData));\n\t}\n\tconst PtySession = loadResult.native.PtySession;\n\tif (isNativeSessionConstructor(PtySession)) {\n\t\treturn (options, onData) => normalizeTerminalSessionHandle(new PtySession(options, onData));\n\t}\n\treturn null;\n}\n\nfunction normalizeTerminalSessionHandle(value: unknown): TerminalSessionHandle {\n\tif (!isRecord(value)) throw new Error(\"Native PTY session factory did not return an object\");\n\tconst write = value.write;\n\tconst resize = value.resize;\n\tconst kill = value.kill;\n\tif (!isNativeWrite(write)) throw new Error(\"Native PTY session handle is missing write()\");\n\tif (!isNativeResize(resize)) throw new Error(\"Native PTY session handle is missing resize()\");\n\tif (!isNativeKill(kill)) throw new Error(\"Native PTY session handle is missing kill()\");\n\n\tconst waitExit = value.waitExit;\n\tconst wait = value.wait;\n\tif (!isNativeWait(waitExit) && !isNativeWait(wait)) {\n\t\tthrow new Error(\"Native PTY session handle is missing waitExit() or wait()\");\n\t}\n\n\tconst requiredHandle = {\n\t\twrite(data: string | Uint8Array) {\n\t\t\treturn normalizeUnknownOperationResult(write.call(value, data));\n\t\t},\n\t\tresize(cols: number, rows: number) {\n\t\t\treturn normalizeUnknownOperationResult(resize.call(value, cols, rows));\n\t\t},\n\t\tkill(signal?: TerminalSessionSignal) {\n\t\t\treturn normalizeUnknownOperationResult(kill.call(value, signal));\n\t\t},\n\t};\n\tconst onData = value.onData;\n\tif (isNativeWait(waitExit) && isNativeOnData(onData)) {\n\t\treturn {\n\t\t\t...requiredHandle,\n\t\t\tonData: (handler) => normalizeUnsubscribe(onData.call(value, handler)),\n\t\t\twaitExit: async () => waitExit.call(value),\n\t\t};\n\t}\n\tif (isNativeWait(waitExit)) return { ...requiredHandle, waitExit: async () => waitExit.call(value) };\n\tif (isNativeOnData(onData) && isNativeWait(wait)) {\n\t\treturn {\n\t\t\t...requiredHandle,\n\t\t\tonData: (handler) => normalizeUnsubscribe(onData.call(value, handler)),\n\t\t\twait: async () => wait.call(value),\n\t\t};\n\t}\n\tif (isNativeWait(wait)) return { ...requiredHandle, wait: async () => wait.call(value) };\n\tthrow new Error(\"Native PTY session handle is missing waitExit() or wait()\");\n}\n\nfunction normalizeUnsubscribe(value: unknown): () => void {\n\treturn isUnsubscribe(value) ? value : () => {};\n}\n\nfunction isNativeSessionCreator(value: unknown): value is NativeSessionCreator {\n\treturn typeof value === \"function\";\n}\n\nfunction isNativeSessionConstructor(value: unknown): value is NativeSessionConstructor {\n\treturn typeof value === \"function\";\n}\n\nfunction isNativeWrite(value: unknown): value is NativeWrite {\n\treturn typeof value === \"function\";\n}\n\nfunction isNativeResize(value: unknown): value is NativeResize {\n\treturn typeof value === \"function\";\n}\n\nfunction isNativeKill(value: unknown): value is NativeKill {\n\treturn typeof value === \"function\";\n}\n\nfunction isNativeWait(value: unknown): value is NativeWait {\n\treturn typeof value === \"function\";\n}\n\nfunction isNativeOnData(value: unknown): value is NativeOnData {\n\treturn typeof value === \"function\";\n}\n\nfunction isUnsubscribe(value: unknown): value is () => void {\n\treturn typeof value === \"function\";\n}\n\nfunction isRecord(value: unknown): value is Readonly<Record<string, unknown>> {\n\treturn typeof value === \"object\" && value !== null;\n}\n"]}

package/dist/session-options.d.ts

@@ -0,0 +1,10 @@
+import type { PipeFallbackSessionOptions } from "./pipe-fallback.ts";
+import type { TerminalSessionNativeOptions, TerminalSessionOptions } from "./session-types.ts";
+export declare const DEFAULT_COLS = 80;
+export declare const DEFAULT_ROWS = 24;
+export declare const DEFAULT_RAW_TAIL_BYTES: number;
+export declare function normalizeRawTailBytes(value: number | undefined): number;
+export declare function defaultCommand(): string;
+export declare function toNativeOptions(options: TerminalSessionOptions): TerminalSessionNativeOptions;
+export declare function toPipeFallbackOptions(options: TerminalSessionOptions): PipeFallbackSessionOptions;
+//# sourceMappingURL=session-options.d.ts.map

package/dist/session-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-options.d.ts","sourceRoot":"","sources":["../src/session-options.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,KAAK,EAAE,4BAA4B,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAE/F,eAAO,MAAM,YAAY,KAAK,CAAC;AAC/B,eAAO,MAAM,YAAY,KAAK,CAAC;AAC/B,eAAO,MAAM,sBAAsB,QAAY,CAAC;AAEhD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAMvE;AAED,wBAAgB,cAAc,IAAI,MAAM,CAGvC;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,4BAA4B,CAU7F;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,0BAA0B,CAQjG"}

package/dist/session-options.js

@@ -0,0 +1,38 @@
+import process from "node:process";
+export const DEFAULT_COLS = 80;
+export const DEFAULT_ROWS = 24;
+export const DEFAULT_RAW_TAIL_BYTES = 64 * 1024;
+export function normalizeRawTailBytes(value) {
+    if (value === undefined)
+        return DEFAULT_RAW_TAIL_BYTES;
+    if (!Number.isSafeInteger(value) || value < 0) {
+        throw new Error("Invalid rawTailBytes: must be a non-negative safe integer");
+    }
+    return value;
+}
+export function defaultCommand() {
+    if (process.platform === "win32")
+        return process.env.ComSpec ?? "cmd.exe";
+    return process.env.SHELL ?? "sh";
+}
+export function toNativeOptions(options) {
+    return {
+        command: options.command ?? defaultCommand(),
+        args: [...(options.args ?? [])],
+        cwd: options.cwd,
+        env: options.env ? { ...options.env } : undefined,
+        cols: options.cols ?? DEFAULT_COLS,
+        rows: options.rows ?? DEFAULT_ROWS,
+        timeoutMs: options.timeoutMs,
+    };
+}
+export function toPipeFallbackOptions(options) {
+    return {
+        command: options.command ?? defaultCommand(),
+        args: options.args ? [...options.args] : undefined,
+        cwd: options.cwd,
+        env: options.env ? { ...options.env } : undefined,
+        timeoutMs: options.timeoutMs,
+    };
+}
+//# sourceMappingURL=session-options.js.map

package/dist/session-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-options.js","sourceRoot":"","sources":["../src/session-options.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,cAAc,CAAC;AAInC,MAAM,CAAC,MAAM,YAAY,GAAG,EAAE,CAAC;AAC/B,MAAM,CAAC,MAAM,YAAY,GAAG,EAAE,CAAC;AAC/B,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,GAAG,IAAI,CAAC;AAEhD,MAAM,UAAU,qBAAqB,CAAC,KAAyB;IAC9D,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,sBAAsB,CAAC;IACvD,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;IAC9E,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC;AAED,MAAM,UAAU,cAAc;IAC7B,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO;QAAE,OAAO,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,SAAS,CAAC;IAC1E,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,IAAI,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAA+B;IAC9D,OAAO;QACN,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,cAAc,EAAE;QAC5C,IAAI,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;QAC/B,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,SAAS;QACjD,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,YAAY;QAClC,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,YAAY;QAClC,SAAS,EAAE,OAAO,CAAC,SAAS;KAC5B,CAAC;AACH,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,OAA+B;IACpE,OAAO;QACN,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,cAAc,EAAE;QAC5C,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;QAClD,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,SAAS;QACjD,SAAS,EAAE,OAAO,CAAC,SAAS;KAC5B,CAAC;AACH,CAAC","sourcesContent":["import process from \"node:process\";\nimport type { PipeFallbackSessionOptions } from \"./pipe-fallback.ts\";\nimport type { TerminalSessionNativeOptions, TerminalSessionOptions } from \"./session-types.ts\";\n\nexport const DEFAULT_COLS = 80;\nexport const DEFAULT_ROWS = 24;\nexport const DEFAULT_RAW_TAIL_BYTES = 64 * 1024;\n\nexport function normalizeRawTailBytes(value: number | undefined): number {\n\tif (value === undefined) return DEFAULT_RAW_TAIL_BYTES;\n\tif (!Number.isSafeInteger(value) || value < 0) {\n\t\tthrow new Error(\"Invalid rawTailBytes: must be a non-negative safe integer\");\n\t}\n\treturn value;\n}\n\nexport function defaultCommand(): string {\n\tif (process.platform === \"win32\") return process.env.ComSpec ?? \"cmd.exe\";\n\treturn process.env.SHELL ?? \"sh\";\n}\n\nexport function toNativeOptions(options: TerminalSessionOptions): TerminalSessionNativeOptions {\n\treturn {\n\t\tcommand: options.command ?? defaultCommand(),\n\t\targs: [...(options.args ?? [])],\n\t\tcwd: options.cwd,\n\t\tenv: options.env ? { ...options.env } : undefined,\n\t\tcols: options.cols ?? DEFAULT_COLS,\n\t\trows: options.rows ?? DEFAULT_ROWS,\n\t\ttimeoutMs: options.timeoutMs,\n\t};\n}\n\nexport function toPipeFallbackOptions(options: TerminalSessionOptions): PipeFallbackSessionOptions {\n\treturn {\n\t\tcommand: options.command ?? defaultCommand(),\n\t\targs: options.args ? [...options.args] : undefined,\n\t\tcwd: options.cwd,\n\t\tenv: options.env ? { ...options.env } : undefined,\n\t\ttimeoutMs: options.timeoutMs,\n\t};\n}\n"]}

package/dist/session-types.d.ts

@@ -0,0 +1,64 @@
+import type { Buffer } from "node:buffer";
+import type { NativePtyLoadResult } from "./native-loader.ts";
+export type TerminalSessionBackend = "native" | "pipe-fallback";
+export type TerminalSessionDataHandler = (chunk: Buffer) => void;
+export type TerminalSessionSignal = NodeJS.Signals;
+export interface TerminalSessionOptions {
+    readonly command?: string;
+    readonly args?: readonly string[];
+    readonly cwd?: string;
+    readonly env?: Readonly<Record<string, string | undefined>>;
+    readonly cols?: number;
+    readonly rows?: number;
+    readonly timeoutMs?: number;
+    readonly rawTailBytes?: number;
+}
+export interface TerminalSessionNativeOptions {
+    readonly command: string;
+    readonly args: readonly string[];
+    readonly cwd?: string;
+    readonly env?: Readonly<Record<string, string | undefined>>;
+    readonly cols: number;
+    readonly rows: number;
+    readonly timeoutMs?: number;
+}
+export interface TerminalSessionOperationResult {
+    readonly ok: boolean;
+    readonly note: string;
+    readonly code?: string;
+    readonly idempotent?: boolean;
+}
+export interface TerminalSessionExitError {
+    readonly code: string;
+    readonly message: string;
+}
+export interface TerminalSessionExit {
+    readonly backend: TerminalSessionBackend;
+    readonly exitCode: number | null;
+    readonly signal: string | null;
+    readonly cancelled: boolean;
+    readonly timedOut: boolean;
+    readonly error?: TerminalSessionExitError;
+}
+export type TerminalSessionExitState = {
+    readonly status: "not_started" | "running";
+    readonly exit: null;
+} | {
+    readonly status: "exited";
+    readonly exit: TerminalSessionExit;
+};
+export interface TerminalSessionHandle {
+    readonly onData?: (handler: TerminalSessionDataHandler) => () => void;
+    readonly write: (data: string | Uint8Array) => TerminalSessionOperationResult | undefined;
+    readonly resize: (cols: number, rows: number) => TerminalSessionOperationResult | undefined;
+    readonly kill: (signal?: TerminalSessionSignal) => TerminalSessionOperationResult | undefined;
+    readonly waitExit?: () => Promise<unknown>;
+    readonly wait?: () => Promise<unknown>;
+}
+export type CreateNativeTerminalSession = (options: TerminalSessionNativeOptions, onData: TerminalSessionDataHandler) => TerminalSessionHandle;
+export interface TerminalSessionDependencies {
+    readonly nativeLoadResult?: NativePtyLoadResult;
+    readonly createNativeSession?: CreateNativeTerminalSession;
+    readonly env?: Readonly<Record<string, string | undefined>>;
+}
+//# sourceMappingURL=session-types.d.ts.map

package/dist/session-types.d.ts.map

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

package/dist/session-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=session-types.js.map

package/dist/session-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-types.js","sourceRoot":"","sources":["../src/session-types.ts"],"names":[],"mappings":"","sourcesContent":["import type { Buffer } from \"node:buffer\";\nimport type { NativePtyLoadResult } from \"./native-loader.ts\";\n\nexport type TerminalSessionBackend = \"native\" | \"pipe-fallback\";\nexport type TerminalSessionDataHandler = (chunk: Buffer) => void;\nexport type TerminalSessionSignal = NodeJS.Signals;\n\nexport interface TerminalSessionOptions {\n\treadonly command?: string;\n\treadonly args?: readonly string[];\n\treadonly cwd?: string;\n\treadonly env?: Readonly<Record<string, string | undefined>>;\n\treadonly cols?: number;\n\treadonly rows?: number;\n\treadonly timeoutMs?: number;\n\treadonly rawTailBytes?: number;\n}\n\nexport interface TerminalSessionNativeOptions {\n\treadonly command: string;\n\treadonly args: readonly string[];\n\treadonly cwd?: string;\n\treadonly env?: Readonly<Record<string, string | undefined>>;\n\treadonly cols: number;\n\treadonly rows: number;\n\treadonly timeoutMs?: number;\n}\n\nexport interface TerminalSessionOperationResult {\n\treadonly ok: boolean;\n\treadonly note: string;\n\treadonly code?: string;\n\treadonly idempotent?: boolean;\n}\n\nexport interface TerminalSessionExitError {\n\treadonly code: string;\n\treadonly message: string;\n}\n\nexport interface TerminalSessionExit {\n\treadonly backend: TerminalSessionBackend;\n\treadonly exitCode: number | null;\n\treadonly signal: string | null;\n\treadonly cancelled: boolean;\n\treadonly timedOut: boolean;\n\treadonly error?: TerminalSessionExitError;\n}\n\nexport type TerminalSessionExitState =\n\t| {\n\t\t\treadonly status: \"not_started\" | \"running\";\n\t\t\treadonly exit: null;\n\t  }\n\t| {\n\t\t\treadonly status: \"exited\";\n\t\t\treadonly exit: TerminalSessionExit;\n\t  };\n\nexport interface TerminalSessionHandle {\n\treadonly onData?: (handler: TerminalSessionDataHandler) => () => void;\n\treadonly write: (data: string | Uint8Array) => TerminalSessionOperationResult | undefined;\n\treadonly resize: (cols: number, rows: number) => TerminalSessionOperationResult | undefined;\n\treadonly kill: (signal?: TerminalSessionSignal) => TerminalSessionOperationResult | undefined;\n\treadonly waitExit?: () => Promise<unknown>;\n\treadonly wait?: () => Promise<unknown>;\n}\n\nexport type CreateNativeTerminalSession = (\n\toptions: TerminalSessionNativeOptions,\n\tonData: TerminalSessionDataHandler,\n) => TerminalSessionHandle;\n\nexport interface TerminalSessionDependencies {\n\treadonly nativeLoadResult?: NativePtyLoadResult;\n\treadonly createNativeSession?: CreateNativeTerminalSession;\n\treadonly env?: Readonly<Record<string, string | undefined>>;\n}\n"]}

package/dist/session.d.ts

@@ -0,0 +1,47 @@
+import { Buffer } from "node:buffer";
+import { type NativePtyLoadResult, type NativePtyUnavailableDiagnostic } from "./native-loader.ts";
+import type { TerminalSessionBackend, TerminalSessionDataHandler, TerminalSessionDependencies, TerminalSessionExit, TerminalSessionExitState, TerminalSessionOperationResult, TerminalSessionOptions, TerminalSessionSignal } from "./session-types.ts";
+export type { CreateNativeTerminalSession, TerminalSessionBackend, TerminalSessionDataHandler, TerminalSessionDependencies, TerminalSessionExit, TerminalSessionExitError, TerminalSessionExitState, TerminalSessionHandle, TerminalSessionNativeOptions, TerminalSessionOperationResult, TerminalSessionOptions, TerminalSessionSignal, } from "./session-types.ts";
+export declare class TerminalSession {
+    readonly options: TerminalSessionOptions;
+    private readonly nativeLoadResult;
+    private readonly createNativeSessionDependency?;
+    private readonly env;
+    private readonly rawTailLimit;
+    private readonly dataHandlers;
+    private readonly exitHandlers;
+    private backendHandle;
+    private backendValue;
+    private exitPromise;
+    private settledExit;
+    private rawTailBuffer;
+    private rawByteCount;
+    private killRequested;
+    private unsubscribeBackendData;
+    constructor(options?: TerminalSessionOptions, dependencies?: TerminalSessionDependencies);
+    get native(): NativePtyLoadResult;
+    get unavailableDiagnostic(): NativePtyUnavailableDiagnostic | null;
+    get backend(): TerminalSessionBackend | null;
+    get command(): string;
+    get status(): "not_started" | "running" | "exited";
+    get exited(): boolean;
+    get isExited(): boolean;
+    get exitResult(): TerminalSessionExit | null;
+    get rawTail(): Buffer;
+    get rawOutputBytes(): number;
+    get exitState(): TerminalSessionExitState;
+    start(): this;
+    onData(handler: TerminalSessionDataHandler): () => void;
+    onExit(handler: () => void): () => void;
+    write(data: string | Uint8Array): TerminalSessionOperationResult;
+    resize(cols: number, rows: number): TerminalSessionOperationResult;
+    kill(signal?: TerminalSessionSignal): TerminalSessionOperationResult;
+    stop(): TerminalSessionOperationResult;
+    waitExit(): Promise<TerminalSessionExit>;
+    private waitBackendExit;
+    private settleExit;
+    private emitData;
+    private appendRawTail;
+}
+export declare function createTerminalSession(options?: TerminalSessionOptions, dependencies?: TerminalSessionDependencies): TerminalSession;
+//# sourceMappingURL=session.d.ts.map