@oh-my-pi/pi-natives 11.13.0 → 11.14.0

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@oh-my-pi/pi-natives",
-	"version": "11.13.0",
+	"version": "11.14.0",
 	"description": "Native Rust functionality via N-API",
 	"type": "module",
 	"main": "./src/index.ts",
@@ -32,7 +32,7 @@
 		"directory": "packages/natives"
 	},
 	"dependencies": {
-		"@oh-my-pi/pi-utils": "11.13.0"
+		"@oh-my-pi/pi-utils": "11.14.0"
 	},
 	"devDependencies": {
 		"@types/bun": "^1.3.9"

package/src/index.ts

@@ -111,6 +111,11 @@ export {
 	type ShellRunResult,
 } from "./shell";
 
+// =============================================================================
+// PTY execution
+// =============================================================================
+
+export { type PtyRunResult, PtySession, type PtyStartOptions } from "./pty";
 // =============================================================================
 // Process management
 // =============================================================================

package/src/native.ts

@@ -23,6 +23,7 @@ import "./html/types";
 import "./image/types";
 import "./keys/types";
 import "./ps/types";
+import "./pty/types";
 import "./shell/types";
 import "./system-info/types";
 import "./text/types";
@@ -170,6 +171,7 @@ function validateNative(bindings: NativeBindings, source: string): void {
 	checkFn("extractSegments");
 	checkFn("matchesKittySequence");
 	checkFn("executeShell");
+	checkFn("PtySession");
 	checkFn("Shell");
 	checkFn("parseKey");
 	checkFn("matchesLegacySequence");

package/src/pty/index.ts

@@ -0,0 +1,10 @@
+/**
+ * PTY-backed interactive execution.
+ */
+
+import { native } from "../native";
+
+export type { PtyRunResult, PtySessionConstructor, PtyStartOptions } from "./types";
+
+export const { PtySession } = native;
+export type PtySession = import("./types").PtySession;

package/src/pty/types.ts

@@ -0,0 +1,57 @@
+/**
+ * Types for PTY-backed interactive execution.
+ */
+
+import type { Cancellable, TsFunc } from "../bindings";
+
+/**
+ * Options for starting a command in a pseudo-terminal session.
+ */
+export interface PtyStartOptions extends Cancellable {
+	/** Command to execute. */
+	command: string;
+	/** Working directory for command execution. */
+	cwd?: string;
+	/** Environment variables for this command. */
+	env?: Record<string, string>;
+	/** PTY column count. */
+	cols?: number;
+	/** PTY row count. */
+	rows?: number;
+}
+
+/**
+ * Result of a PTY command run.
+ */
+export interface PtyRunResult {
+	/** Exit code of the command, if available. */
+	exitCode?: number;
+	/** Whether the command was cancelled by abort signal or kill request. */
+	cancelled: boolean;
+	/** Whether the command timed out. */
+	timedOut: boolean;
+}
+
+/** Stateful PTY session instance. */
+export interface PtySession {
+	/** Start command execution and stream output while it runs. */
+	start(options: PtyStartOptions, onChunk?: TsFunc<string>): Promise<PtyRunResult>;
+	/** Write raw input bytes to PTY stdin. */
+	write(data: string): void;
+	/** Resize active PTY. */
+	resize(cols: number, rows: number): void;
+	/** Force-kill active command. */
+	kill(): void;
+}
+
+/** Native PTY session constructor. */
+export interface PtySessionConstructor {
+	new (): PtySession;
+}
+
+declare module "../bindings" {
+	interface NativeBindings {
+		/** Stateful PTY session constructor for interactive terminal passthrough. */
+		PtySession: PtySessionConstructor;
+	}
+}