@code-yeongyu/senpi-pty 2026.7.25-2

package/dist/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EAAiB,KAAK,mBAAmB,EAAE,KAAK,8BAA8B,EAAE,MAAM,oBAAoB,CAAC;AAUlH,OAAO,KAAK,EAEX,sBAAsB,EACtB,0BAA0B,EAC1B,2BAA2B,EAC3B,mBAAmB,EACnB,wBAAwB,EAExB,8BAA8B,EAC9B,sBAAsB,EACtB,qBAAqB,EACrB,MAAM,oBAAoB,CAAC;AAE5B,YAAY,EACX,2BAA2B,EAC3B,sBAAsB,EACtB,0BAA0B,EAC1B,2BAA2B,EAC3B,mBAAmB,EACnB,wBAAwB,EACxB,wBAAwB,EACxB,qBAAqB,EACrB,4BAA4B,EAC5B,8BAA8B,EAC9B,sBAAsB,EACtB,qBAAqB,GACrB,MAAM,oBAAoB,CAAC;AAE5B,qBAAa,eAAe;IAC3B,QAAQ,CAAC,OAAO,EAAE,sBAAsB,CAAC;IACzC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAsB;IACvD,OAAO,CAAC,QAAQ,CAAC,6BAA6B,CAAC,CAA8B;IAC7E,OAAO,CAAC,QAAQ,CAAC,GAAG,CAA+C;IACnE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAyC;IACtE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAyB;IACtD,OAAO,CAAC,aAAa,CAAsC;IAC3D,OAAO,CAAC,YAAY,CAAuC;IAC3D,OAAO,CAAC,WAAW,CAA6C;IAChE,OAAO,CAAC,WAAW,CAAoC;IACvD,OAAO,CAAC,aAAa,CAAmB;IACxC,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,sBAAsB,CAA6B;IAE3D,YAAY,OAAO,GAAE,sBAA2B,EAAE,YAAY,GAAE,2BAAgC,EAU/F;IAED,IAAI,MAAM,IAAI,mBAAmB,CAEhC;IAED,IAAI,qBAAqB,IAAI,8BAA8B,GAAG,IAAI,CAGjE;IAED,IAAI,OAAO,IAAI,sBAAsB,GAAG,IAAI,CAE3C;IAED,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,IAAI,MAAM,IAAI,aAAa,GAAG,SAAS,GAAG,QAAQ,CAEjD;IAED,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,IAAI,UAAU,IAAI,mBAAmB,GAAG,IAAI,CAE3C;IAED,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED,IAAI,SAAS,IAAI,wBAAwB,CAGxC;IAED,KAAK,IAAI,IAAI,CA2BZ;IAED,MAAM,CAAC,OAAO,EAAE,0BAA0B,GAAG,MAAM,IAAI,CAGtD;IAED,MAAM,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAItC;IAED,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,8BAA8B,CAK/D;IAED,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,8BAA8B,CAKjE;IAED,IAAI,CAAC,MAAM,GAAE,qBAAiC,GAAG,8BAA8B,CAe9E;IAED,IAAI,IAAI,8BAA8B,CAErC;IAEK,QAAQ,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAI7C;YAEa,eAAe;IAU7B,OAAO,CAAC,UAAU;IAUlB,OAAO,CAAC,QAAQ;IAMhB,OAAO,CAAC,aAAa;CAUrB;AAED,wBAAgB,qBAAqB,CACpC,OAAO,GAAE,sBAA2B,EACpC,YAAY,GAAE,2BAAgC,GAC5C,eAAe,CAEjB"}

package/dist/session.js

@@ -0,0 +1,187 @@
+import { Buffer } from "node:buffer";
+import process from "node:process";
+import { loadNativePty } from "./native-loader.js";
+import { PipeFallbackSession, shouldUsePipeFallback } from "./pipe-fallback.js";
+import { exitedOperation, normalizeOperationResult, normalizeTerminalExit, notStartedOperation, } from "./session-exit.js";
+import { getNativeSessionFactory } from "./session-native.js";
+import { defaultCommand, normalizeRawTailBytes, toNativeOptions, toPipeFallbackOptions } from "./session-options.js";
+export class TerminalSession {
+    constructor(options = {}, dependencies = {}) {
+        this.dataHandlers = new Set();
+        this.exitHandlers = new Set();
+        this.backendHandle = null;
+        this.backendValue = null;
+        this.exitPromise = null;
+        this.settledExit = null;
+        this.rawTailBuffer = Buffer.alloc(0);
+        this.rawByteCount = 0;
+        this.killRequested = false;
+        this.unsubscribeBackendData = null;
+        this.options = {
+            ...options,
+            args: options.args ? [...options.args] : undefined,
+            env: options.env ? { ...options.env } : undefined,
+        };
+        this.nativeLoadResult = dependencies.nativeLoadResult ?? loadNativePty();
+        this.createNativeSessionDependency = dependencies.createNativeSession;
+        this.env = dependencies.env ?? process.env;
+        this.rawTailLimit = normalizeRawTailBytes(options.rawTailBytes);
+    }
+    get native() {
+        return this.nativeLoadResult;
+    }
+    get unavailableDiagnostic() {
+        if (this.nativeLoadResult.native !== null)
+            return null;
+        return this.nativeLoadResult.diagnostic;
+    }
+    get backend() {
+        return this.backendValue;
+    }
+    get command() {
+        return this.options.command ?? defaultCommand();
+    }
+    get status() {
+        return this.exitState.status;
+    }
+    get exited() {
+        return this.settledExit !== null;
+    }
+    get isExited() {
+        return this.exited;
+    }
+    get exitResult() {
+        return this.settledExit;
+    }
+    get rawTail() {
+        return Buffer.from(this.rawTailBuffer);
+    }
+    get rawOutputBytes() {
+        return this.rawByteCount;
+    }
+    get exitState() {
+        if (this.settledExit !== null)
+            return { status: "exited", exit: this.settledExit };
+        return { status: this.backendHandle === null ? "not_started" : "running", exit: null };
+    }
+    start() {
+        if (this.settledExit !== null)
+            throw new Error("Cannot restart exited terminal session");
+        if (this.backendHandle !== null)
+            throw new Error("Terminal session has already been started");
+        const nativeFactory = this.createNativeSessionDependency ?? getNativeSessionFactory(this.nativeLoadResult);
+        if (nativeFactory && !shouldUsePipeFallback(this.nativeLoadResult, this.env)) {
+            this.backendValue = "native";
+            this.backendHandle = nativeFactory(toNativeOptions(this.options), (chunk) => this.emitData(chunk));
+        }
+        else {
+            this.backendValue = "pipe-fallback";
+            const fallback = new PipeFallbackSession(toPipeFallbackOptions(this.options));
+            this.backendHandle = fallback;
+            this.unsubscribeBackendData = fallback.onData((chunk) => this.emitData(chunk));
+            fallback.start();
+        }
+        const backendHandle = this.backendHandle;
+        const backendValue = this.backendValue;
+        if (backendHandle === null || backendValue === null) {
+            throw new Error("Terminal session backend did not initialize");
+        }
+        if (backendValue === "native" && backendHandle.onData) {
+            this.unsubscribeBackendData = backendHandle.onData((chunk) => this.emitData(chunk));
+        }
+        this.exitPromise = this.waitBackendExit(backendHandle, backendValue).then((exit) => this.settleExit(exit));
+        return this;
+    }
+    onData(handler) {
+        this.dataHandlers.add(handler);
+        return () => this.dataHandlers.delete(handler);
+    }
+    onExit(handler) {
+        if (this.settledExit !== null)
+            queueMicrotask(handler);
+        else
+            this.exitHandlers.add(handler);
+        return () => this.exitHandlers.delete(handler);
+    }
+    write(data) {
+        const handle = this.backendHandle;
+        if (this.settledExit !== null)
+            return exitedOperation("write");
+        if (handle === null)
+            return notStartedOperation("write");
+        return normalizeOperationResult(handle.write(data), "Wrote data to terminal session.");
+    }
+    resize(cols, rows) {
+        const handle = this.backendHandle;
+        if (this.settledExit !== null)
+            return exitedOperation("resize");
+        if (handle === null)
+            return notStartedOperation("resize");
+        return normalizeOperationResult(handle.resize(cols, rows), `Resized terminal session to ${cols}x${rows}.`);
+    }
+    kill(signal = "SIGTERM") {
+        const handle = this.backendHandle;
+        if (this.killRequested || this.settledExit !== null) {
+            return {
+                ok: true,
+                idempotent: true,
+                note: "Terminal session kill was already requested.",
+            };
+        }
+        if (handle === null)
+            return notStartedOperation("kill");
+        this.killRequested = true;
+        const result = normalizeOperationResult(handle.kill(signal), `Sent ${signal} to terminal session.`);
+        if (!result.ok)
+            this.killRequested = false;
+        return result;
+    }
+    stop() {
+        return this.kill();
+    }
+    async waitExit() {
+        if (this.settledExit !== null)
+            return this.settledExit;
+        if (this.exitPromise === null)
+            throw new Error("Cannot wait for terminal session exit before start");
+        return await this.exitPromise;
+    }
+    async waitBackendExit(handle, backend) {
+        const wait = handle.waitExit ?? handle.wait;
+        if (!wait)
+            throw new Error("Terminal session backend does not expose waitExit or wait");
+        const exit = await wait.call(handle);
+        return normalizeTerminalExit(exit, backend, this.killRequested);
+    }
+    settleExit(exit) {
+        if (this.settledExit !== null)
+            return this.settledExit;
+        this.settledExit = exit;
+        this.unsubscribeBackendData?.();
+        this.unsubscribeBackendData = null;
+        for (const handler of this.exitHandlers)
+            handler();
+        this.exitHandlers.clear();
+        return exit;
+    }
+    emitData(chunk) {
+        const buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+        this.appendRawTail(buffer);
+        for (const handler of this.dataHandlers)
+            handler(buffer);
+    }
+    appendRawTail(chunk) {
+        this.rawByteCount += chunk.byteLength;
+        if (this.rawTailLimit === 0) {
+            this.rawTailBuffer = Buffer.alloc(0);
+            return;
+        }
+        const next = Buffer.concat([this.rawTailBuffer, chunk]);
+        this.rawTailBuffer =
+            next.byteLength <= this.rawTailLimit ? next : next.subarray(next.byteLength - this.rawTailLimit);
+    }
+}
+export function createTerminalSession(options = {}, dependencies = {}) {
+    return new TerminalSession(options, dependencies).start();
+}
+//# sourceMappingURL=session.js.map

package/dist/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"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","sourcesContent":["import { Buffer } from \"node:buffer\";\nimport process from \"node:process\";\nimport { loadNativePty, type NativePtyLoadResult, type NativePtyUnavailableDiagnostic } from \"./native-loader.ts\";\nimport { PipeFallbackSession, shouldUsePipeFallback } from \"./pipe-fallback.ts\";\nimport {\n\texitedOperation,\n\tnormalizeOperationResult,\n\tnormalizeTerminalExit,\n\tnotStartedOperation,\n} from \"./session-exit.ts\";\nimport { getNativeSessionFactory } from \"./session-native.ts\";\nimport { defaultCommand, normalizeRawTailBytes, toNativeOptions, toPipeFallbackOptions } from \"./session-options.ts\";\nimport type {\n\tCreateNativeTerminalSession,\n\tTerminalSessionBackend,\n\tTerminalSessionDataHandler,\n\tTerminalSessionDependencies,\n\tTerminalSessionExit,\n\tTerminalSessionExitState,\n\tTerminalSessionHandle,\n\tTerminalSessionOperationResult,\n\tTerminalSessionOptions,\n\tTerminalSessionSignal,\n} from \"./session-types.ts\";\n\nexport type {\n\tCreateNativeTerminalSession,\n\tTerminalSessionBackend,\n\tTerminalSessionDataHandler,\n\tTerminalSessionDependencies,\n\tTerminalSessionExit,\n\tTerminalSessionExitError,\n\tTerminalSessionExitState,\n\tTerminalSessionHandle,\n\tTerminalSessionNativeOptions,\n\tTerminalSessionOperationResult,\n\tTerminalSessionOptions,\n\tTerminalSessionSignal,\n} from \"./session-types.ts\";\n\nexport class TerminalSession {\n\treadonly options: TerminalSessionOptions;\n\tprivate readonly nativeLoadResult: NativePtyLoadResult;\n\tprivate readonly createNativeSessionDependency?: CreateNativeTerminalSession;\n\tprivate readonly env: Readonly<Record<string, string | undefined>>;\n\tprivate readonly rawTailLimit: number;\n\tprivate readonly dataHandlers = new Set<TerminalSessionDataHandler>();\n\tprivate readonly exitHandlers = new Set<() => void>();\n\tprivate backendHandle: TerminalSessionHandle | null = null;\n\tprivate backendValue: TerminalSessionBackend | null = null;\n\tprivate exitPromise: Promise<TerminalSessionExit> | null = null;\n\tprivate settledExit: TerminalSessionExit | null = null;\n\tprivate rawTailBuffer = Buffer.alloc(0);\n\tprivate rawByteCount = 0;\n\tprivate killRequested = false;\n\tprivate unsubscribeBackendData: (() => void) | null = null;\n\n\tconstructor(options: TerminalSessionOptions = {}, dependencies: TerminalSessionDependencies = {}) {\n\t\tthis.options = {\n\t\t\t...options,\n\t\t\targs: options.args ? [...options.args] : undefined,\n\t\t\tenv: options.env ? { ...options.env } : undefined,\n\t\t};\n\t\tthis.nativeLoadResult = dependencies.nativeLoadResult ?? loadNativePty();\n\t\tthis.createNativeSessionDependency = dependencies.createNativeSession;\n\t\tthis.env = dependencies.env ?? process.env;\n\t\tthis.rawTailLimit = normalizeRawTailBytes(options.rawTailBytes);\n\t}\n\n\tget native(): NativePtyLoadResult {\n\t\treturn this.nativeLoadResult;\n\t}\n\n\tget unavailableDiagnostic(): NativePtyUnavailableDiagnostic | null {\n\t\tif (this.nativeLoadResult.native !== null) return null;\n\t\treturn this.nativeLoadResult.diagnostic;\n\t}\n\n\tget backend(): TerminalSessionBackend | null {\n\t\treturn this.backendValue;\n\t}\n\n\tget command(): string {\n\t\treturn this.options.command ?? defaultCommand();\n\t}\n\n\tget status(): \"not_started\" | \"running\" | \"exited\" {\n\t\treturn this.exitState.status;\n\t}\n\n\tget exited(): boolean {\n\t\treturn this.settledExit !== null;\n\t}\n\n\tget isExited(): boolean {\n\t\treturn this.exited;\n\t}\n\n\tget exitResult(): TerminalSessionExit | null {\n\t\treturn this.settledExit;\n\t}\n\n\tget rawTail(): Buffer {\n\t\treturn Buffer.from(this.rawTailBuffer);\n\t}\n\n\tget rawOutputBytes(): number {\n\t\treturn this.rawByteCount;\n\t}\n\n\tget exitState(): TerminalSessionExitState {\n\t\tif (this.settledExit !== null) return { status: \"exited\", exit: this.settledExit };\n\t\treturn { status: this.backendHandle === null ? \"not_started\" : \"running\", exit: null };\n\t}\n\n\tstart(): this {\n\t\tif (this.settledExit !== null) throw new Error(\"Cannot restart exited terminal session\");\n\t\tif (this.backendHandle !== null) throw new Error(\"Terminal session has already been started\");\n\n\t\tconst nativeFactory = this.createNativeSessionDependency ?? getNativeSessionFactory(this.nativeLoadResult);\n\t\tif (nativeFactory && !shouldUsePipeFallback(this.nativeLoadResult, this.env)) {\n\t\t\tthis.backendValue = \"native\";\n\t\t\tthis.backendHandle = nativeFactory(toNativeOptions(this.options), (chunk) => this.emitData(chunk));\n\t\t} else {\n\t\t\tthis.backendValue = \"pipe-fallback\";\n\t\t\tconst fallback = new PipeFallbackSession(toPipeFallbackOptions(this.options));\n\t\t\tthis.backendHandle = fallback;\n\t\t\tthis.unsubscribeBackendData = fallback.onData((chunk) => this.emitData(chunk));\n\t\t\tfallback.start();\n\t\t}\n\n\t\tconst backendHandle = this.backendHandle;\n\t\tconst backendValue = this.backendValue;\n\t\tif (backendHandle === null || backendValue === null) {\n\t\t\tthrow new Error(\"Terminal session backend did not initialize\");\n\t\t}\n\n\t\tif (backendValue === \"native\" && backendHandle.onData) {\n\t\t\tthis.unsubscribeBackendData = backendHandle.onData((chunk) => this.emitData(chunk));\n\t\t}\n\t\tthis.exitPromise = this.waitBackendExit(backendHandle, backendValue).then((exit) => this.settleExit(exit));\n\t\treturn this;\n\t}\n\n\tonData(handler: TerminalSessionDataHandler): () => void {\n\t\tthis.dataHandlers.add(handler);\n\t\treturn () => this.dataHandlers.delete(handler);\n\t}\n\n\tonExit(handler: () => void): () => void {\n\t\tif (this.settledExit !== null) queueMicrotask(handler);\n\t\telse this.exitHandlers.add(handler);\n\t\treturn () => this.exitHandlers.delete(handler);\n\t}\n\n\twrite(data: string | Uint8Array): TerminalSessionOperationResult {\n\t\tconst handle = this.backendHandle;\n\t\tif (this.settledExit !== null) return exitedOperation(\"write\");\n\t\tif (handle === null) return notStartedOperation(\"write\");\n\t\treturn normalizeOperationResult(handle.write(data), \"Wrote data to terminal session.\");\n\t}\n\n\tresize(cols: number, rows: number): TerminalSessionOperationResult {\n\t\tconst handle = this.backendHandle;\n\t\tif (this.settledExit !== null) return exitedOperation(\"resize\");\n\t\tif (handle === null) return notStartedOperation(\"resize\");\n\t\treturn normalizeOperationResult(handle.resize(cols, rows), `Resized terminal session to ${cols}x${rows}.`);\n\t}\n\n\tkill(signal: TerminalSessionSignal = \"SIGTERM\"): TerminalSessionOperationResult {\n\t\tconst handle = this.backendHandle;\n\t\tif (this.killRequested || this.settledExit !== null) {\n\t\t\treturn {\n\t\t\t\tok: true,\n\t\t\t\tidempotent: true,\n\t\t\t\tnote: \"Terminal session kill was already requested.\",\n\t\t\t};\n\t\t}\n\t\tif (handle === null) return notStartedOperation(\"kill\");\n\n\t\tthis.killRequested = true;\n\t\tconst result = normalizeOperationResult(handle.kill(signal), `Sent ${signal} to terminal session.`);\n\t\tif (!result.ok) this.killRequested = false;\n\t\treturn result;\n\t}\n\n\tstop(): TerminalSessionOperationResult {\n\t\treturn this.kill();\n\t}\n\n\tasync waitExit(): Promise<TerminalSessionExit> {\n\t\tif (this.settledExit !== null) return this.settledExit;\n\t\tif (this.exitPromise === null) throw new Error(\"Cannot wait for terminal session exit before start\");\n\t\treturn await this.exitPromise;\n\t}\n\n\tprivate async waitBackendExit(\n\t\thandle: TerminalSessionHandle,\n\t\tbackend: TerminalSessionBackend,\n\t): Promise<TerminalSessionExit> {\n\t\tconst wait = handle.waitExit ?? handle.wait;\n\t\tif (!wait) throw new Error(\"Terminal session backend does not expose waitExit or wait\");\n\t\tconst exit = await wait.call(handle);\n\t\treturn normalizeTerminalExit(exit, backend, this.killRequested);\n\t}\n\n\tprivate settleExit(exit: TerminalSessionExit): TerminalSessionExit {\n\t\tif (this.settledExit !== null) return this.settledExit;\n\t\tthis.settledExit = exit;\n\t\tthis.unsubscribeBackendData?.();\n\t\tthis.unsubscribeBackendData = null;\n\t\tfor (const handler of this.exitHandlers) handler();\n\t\tthis.exitHandlers.clear();\n\t\treturn exit;\n\t}\n\n\tprivate emitData(chunk: Buffer | Uint8Array | string): void {\n\t\tconst buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);\n\t\tthis.appendRawTail(buffer);\n\t\tfor (const handler of this.dataHandlers) handler(buffer);\n\t}\n\n\tprivate appendRawTail(chunk: Buffer): void {\n\t\tthis.rawByteCount += chunk.byteLength;\n\t\tif (this.rawTailLimit === 0) {\n\t\t\tthis.rawTailBuffer = Buffer.alloc(0);\n\t\t\treturn;\n\t\t}\n\t\tconst next = Buffer.concat([this.rawTailBuffer, chunk]);\n\t\tthis.rawTailBuffer =\n\t\t\tnext.byteLength <= this.rawTailLimit ? next : next.subarray(next.byteLength - this.rawTailLimit);\n\t}\n}\n\nexport function createTerminalSession(\n\toptions: TerminalSessionOptions = {},\n\tdependencies: TerminalSessionDependencies = {},\n): TerminalSession {\n\treturn new TerminalSession(options, dependencies).start();\n}\n"]}

package/native/check-prebuild-fresh.mjs

@@ -0,0 +1,171 @@
+#!/usr/bin/env node
+import { spawn } from "node:child_process";
+import { constants as fsConstants } from "node:fs";
+import { access, copyFile, mkdir, mkdtemp, readFile, rm } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const scriptDir = dirname(fileURLToPath(import.meta.url));
+const defaultRootDir = join(scriptDir, "..", "..", "..");
+const NAPI_CLI_VERSION = "3.7.2";
+
+const napiTargetByHost = new Map([
+	["darwin-arm64", "aarch64-apple-darwin"],
+	["darwin-x64", "x86_64-apple-darwin"],
+	["linux-arm64", "aarch64-unknown-linux-gnu.2.17"],
+	["linux-x64", "x86_64-unknown-linux-gnu.2.17"],
+	["win32-arm64", "aarch64-pc-windows-msvc"],
+	["win32-x64", "x86_64-pc-windows-msvc"],
+]);
+
+export function getHost(platform = process.platform, arch = process.arch) {
+	return `${platform}-${arch}`;
+}
+
+export function getVendoredPrebuildPath(rootDir, host) {
+	return join(rootDir, "packages", "pty", "native", "prebuilds", host, `senpi_pty.${host}.node`);
+}
+
+export async function checkPrebuildFreshness(options = {}) {
+	const rootDir = options.rootDir ?? defaultRootDir;
+	const host = options.host ?? getHost();
+	const napiTarget = options.napiTarget ?? napiTargetByHost.get(host);
+	if (!napiTarget) {
+		throw new Error(`error: unsupported native prebuild host target ${host}`);
+	}
+
+	const tempDir = options.tempDir ?? (await mkdtemp(join(tmpdir(), `senpi-pty-prebuild-${host}-`)));
+	const ownsTempDir = options.tempDir === undefined;
+	try {
+		const builtFile =
+			options.builtFile ??
+			(await buildHostPrebuild({
+				host,
+				napiTarget,
+				outputDir: join(tempDir, "output"),
+				rootDir,
+				targetDir: join(rootDir, "target", "senpi-pty-prebuild", host),
+			}));
+		const vendoredFile = getVendoredPrebuildPath(rootDir, host);
+
+		if (options.update) {
+			await mkdir(dirname(vendoredFile), { recursive: true });
+			await copyFile(builtFile, vendoredFile);
+			return { builtFile, host, napiTarget, status: "updated", vendoredFile };
+		}
+
+		await assertFileExists(vendoredFile, `error: missing vendored prebuild for ${host}: ${vendoredFile}`);
+		const [builtBytes, vendoredBytes] = await Promise.all([readFile(builtFile), readFile(vendoredFile)]);
+		if (!builtBytes.equals(vendoredBytes)) {
+			throw new Error(
+				`error: stale vendored prebuild for ${host}: ${vendoredFile} differs from rebuilt ${builtFile} (${napiTarget})`,
+			);
+		}
+
+		return { builtFile, host, napiTarget, status: "fresh", vendoredFile };
+	} finally {
+		if (ownsTempDir) await rm(tempDir, { force: true, recursive: true });
+	}
+}
+
+async function buildHostPrebuild({ rootDir, host, napiTarget, outputDir, targetDir }) {
+	await mkdir(outputDir, { recursive: true });
+	await run(
+		"npm",
+		[
+			"exec",
+			"--yes",
+			"--package",
+			`@napi-rs/cli@${NAPI_CLI_VERSION}`,
+			"--",
+			"napi",
+			"build",
+			"--manifest-path",
+			"crates/senpi-pty/Cargo.toml",
+			"--package-json-path",
+			"crates/senpi-pty/package.json",
+			"--target",
+			napiTarget,
+			"--target-dir",
+			targetDir,
+			"--output-dir",
+			outputDir,
+			"--release",
+			"--platform",
+			"--",
+			"--locked",
+		],
+		rootDir,
+	);
+
+	const builtFile = join(outputDir, `senpi_pty.${host}.node`);
+	await assertFileExists(builtFile, `error: napi build did not produce expected host target ${host}: ${builtFile}`);
+	return builtFile;
+}
+
+function run(command, args, cwd) {
+	return new Promise((resolve, reject) => {
+		const child = spawn(command, args, {
+			cwd,
+			env: { ...process.env, RUSTFLAGS: appendRustflags(process.env.RUSTFLAGS, `--remap-path-prefix=${cwd}=.`) },
+			shell: false,
+			stdio: "inherit",
+		});
+		child.on("error", reject);
+		child.on("close", (code) => {
+			if (code === 0) {
+				resolve();
+			} else {
+				reject(new Error(`error: ${command} ${args.join(" ")} failed with exit ${code ?? 1}`));
+			}
+		});
+	});
+}
+
+function appendRustflags(current, flag) {
+	return current ? `${current} ${flag}` : flag;
+}
+
+async function assertFileExists(file, message) {
+	try {
+		await access(file, fsConstants.R_OK);
+	} catch {
+		throw new Error(message);
+	}
+}
+
+function parseArgs(argv) {
+	const options = {};
+	for (let i = 0; i < argv.length; i++) {
+		const arg = argv[i];
+		if (arg === "--update") {
+			options.update = true;
+		} else if (arg === "--host") {
+			options.host = argv[++i];
+		} else if (arg.startsWith("--host=")) {
+			options.host = arg.slice("--host=".length);
+		} else if (arg === "--root") {
+			options.rootDir = argv[++i];
+		} else if (arg.startsWith("--root=")) {
+			options.rootDir = arg.slice("--root=".length);
+		} else if (arg === "--built-file") {
+			options.builtFile = argv[++i];
+		} else if (arg.startsWith("--built-file=")) {
+			options.builtFile = arg.slice("--built-file=".length);
+		} else {
+			throw new Error(`error: unknown argument ${arg}`);
+		}
+	}
+	return options;
+}
+
+if (process.argv[1] === fileURLToPath(import.meta.url)) {
+	try {
+		const result = await checkPrebuildFreshness(parseArgs(process.argv.slice(2)));
+		console.log(`${result.status} native prebuild for ${result.host}: ${result.vendoredFile}`);
+	} catch (error) {
+		console.error(error instanceof Error ? error.message : String(error));
+		process.exit(1);
+	}
+}

package/native/index.d.ts

@@ -0,0 +1,25 @@
+export interface NativePtyBinding {
+	readonly [exportName: string]: unknown;
+}
+
+export interface NativePtyUnavailableDiagnostic {
+	readonly code: "native-unavailable";
+	readonly host: string;
+	readonly attemptedPath: string;
+	readonly message: string;
+	readonly cause?: string;
+}
+
+export type NativePtyLoadResult =
+	| {
+			readonly native: NativePtyBinding;
+			readonly diagnostic: null;
+	  }
+	| {
+			readonly native: null;
+			readonly diagnostic: NativePtyUnavailableDiagnostic;
+	  };
+
+export function loadNativePty(): NativePtyLoadResult;
+
+export const nativePty: NativePtyLoadResult;

package/native/index.js

@@ -0,0 +1,30 @@
+import { createRequire } from "node:module";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const require = createRequire(import.meta.url);
+
+export function loadNativePty() {
+	const host = `${process.platform}-${process.arch}`;
+	const attemptedPath = join(dirname(fileURLToPath(import.meta.url)), "prebuilds", host, `senpi_pty.${host}.node`);
+	try {
+		return {
+			native: require(attemptedPath),
+			diagnostic: null,
+		};
+	} catch (error) {
+		const cause = error instanceof Error ? error.message : String(error);
+		return {
+			native: null,
+			diagnostic: {
+				code: "native-unavailable",
+				host,
+				attemptedPath,
+				message: `No @earendil-works/pi-pty native prebuild is available for ${host}.`,
+				cause,
+			},
+		};
+	}
+}
+
+export const nativePty = loadNativePty();

package/package.json

@@ -0,0 +1,61 @@
+{
+	"name": "@code-yeongyu/senpi-pty",
+	"version": "2026.7.25-2",
+	"description": "Typed PTY session loader for Senpi persistent terminals",
+	"type": "module",
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js"
+		},
+		"./screen": {
+			"types": "./dist/screen.d.ts",
+			"import": "./dist/screen.js"
+		},
+		"./registry": {
+			"types": "./dist/registry.d.ts",
+			"import": "./dist/registry.js"
+		},
+		"./native": {
+			"types": "./native/index.d.ts",
+			"import": "./native/index.js"
+		},
+		"./package.json": "./package.json"
+	},
+	"files": [
+		"dist",
+		"native",
+		"README.md"
+	],
+	"scripts": {
+		"clean": "shx rm -rf dist",
+		"build": "tsgo -p tsconfig.build.json",
+		"test": "vitest --run test",
+		"check:prebuild": "node native/check-prebuild-fresh.mjs",
+		"prepublishOnly": "npm run clean && npm run build"
+	},
+	"keywords": [
+		"pty",
+		"terminal",
+		"persistent-terminal",
+		"typescript"
+	],
+	"author": "Earendil Works",
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/earendil-works/pi.git",
+		"directory": "packages/pty"
+	},
+	"engines": {
+		"node": ">=24.0.0"
+	},
+	"dependencies": {
+		"@xterm/headless": "5.5.0"
+	},
+	"devDependencies": {
+		"@types/node": "25.9.1"
+	}
+}