@made-by-moonlight/athene-plugin-runtime-process 0.9.1

package/dist/pty-client.d.ts

@@ -0,0 +1,55 @@
+/**
+ * pty-client.ts
+ *
+ * Client library for connecting to a pty-host's Windows named pipe.
+ *
+ * Used by:
+ *   - runtime-process/src/index.ts  (sendMessage, getOutput, isAlive, destroy)
+ *   - direct-terminal-ws.ts         (raw socket relay via connectPtyHost)
+ */
+import { type Socket } from "node:net";
+import { MSG_TERMINAL_INPUT, MSG_TERMINAL_DATA, MSG_RESIZE, encodeMessage, MessageParser } from "./pty-host.js";
+export { MSG_TERMINAL_DATA, MSG_TERMINAL_INPUT, MSG_RESIZE, MessageParser, encodeMessage };
+export interface PtyHostStatus {
+    alive: boolean;
+    pid: number;
+    exitCode?: number;
+}
+/**
+ * Returns the Windows named pipe path for a given session ID.
+ */
+export declare function getPipePath(sessionId: string): string;
+/**
+ * Connect to the pty-host named pipe. Resolves with the socket on success,
+ * rejects on error or timeout.
+ */
+export declare function connectPtyHost(pipePath: string, timeoutMs?: number): Promise<Socket>;
+/**
+ * Send a message (text command) to the PTY via a short-lived connection.
+ * Chunks large payloads to avoid ConPTY buffer truncation on Windows, then
+ * sends Enter as a separate frame after a short pause.
+ *
+ * Sliced by JS string length (UTF-16 code units), not bytes, so multi-byte
+ * codepoints aren't split mid-encoding. Surrogate pairs at chunk boundaries
+ * are still possible but extraordinarily rare in agent prompts; the cost of
+ * a defensive boundary check isn't worth it for our content.
+ */
+export declare function ptyHostSendMessage(pipePath: string, message: string): Promise<void>;
+/**
+ * Request the last N lines of PTY output from the host.
+ * Uses MessageParser to skip any MSG_TERMINAL_DATA frames that arrive before
+ * the MSG_GET_OUTPUT_RES response.
+ * Returns "" on timeout (3 s) or connection failure.
+ */
+export declare function ptyHostGetOutput(pipePath: string, lines?: number): Promise<string>;
+/**
+ * Check whether the pty-host process is still alive.
+ * Returns false if the pipe is unreachable (host has exited).
+ */
+export declare function ptyHostIsAlive(pipePath: string): Promise<boolean>;
+/**
+ * Send a kill request to the pty-host. Silently ignores errors — if the
+ * pipe is unreachable the process is already dead.
+ */
+export declare function ptyHostKill(pipePath: string): Promise<void>;
+//# sourceMappingURL=pty-client.d.ts.map

package/dist/pty-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pty-client.d.ts","sourceRoot":"","sources":["../src/pty-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,UAAU,EAMV,aAAa,EACb,aAAa,EACd,MAAM,eAAe,CAAC;AAMvB,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,UAAU,EAAE,aAAa,EAAE,aAAa,EAAE,CAAC;AAM3F,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAMD;;GAEG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAErD;AAMD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,SAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CA2BlF;AA6BD;;;;;;;;;GASG;AACH,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAqCzF;AAMD;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAmCpF;AAMD;;;GAGG;AACH,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CA4CvE;AAMD;;;GAGG;AACH,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBjE"}

package/dist/pty-client.js

@@ -0,0 +1,248 @@
+/**
+ * pty-client.ts
+ *
+ * Client library for connecting to a pty-host's Windows named pipe.
+ *
+ * Used by:
+ *   - runtime-process/src/index.ts  (sendMessage, getOutput, isAlive, destroy)
+ *   - direct-terminal-ws.ts         (raw socket relay via connectPtyHost)
+ */
+import { connect } from "node:net";
+import { MSG_TERMINAL_INPUT, MSG_TERMINAL_DATA, MSG_RESIZE, MSG_GET_OUTPUT_REQ, MSG_GET_OUTPUT_RES, MSG_STATUS_REQ, MSG_STATUS_RES, MSG_KILL_REQ, encodeMessage, MessageParser, } from "./pty-host.js";
+// ---------------------------------------------------------------------------
+// Re-exports for direct-terminal-ws
+// ---------------------------------------------------------------------------
+export { MSG_TERMINAL_DATA, MSG_TERMINAL_INPUT, MSG_RESIZE, MessageParser, encodeMessage };
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Returns the Windows named pipe path for a given session ID.
+ */
+export function getPipePath(sessionId) {
+    return `\\\\.\\pipe\\ao-pty-${sessionId}`;
+}
+// ---------------------------------------------------------------------------
+// connectPtyHost
+// ---------------------------------------------------------------------------
+/**
+ * Connect to the pty-host named pipe. Resolves with the socket on success,
+ * rejects on error or timeout.
+ */
+export function connectPtyHost(pipePath, timeoutMs = 3000) {
+    return new Promise((resolve, reject) => {
+        let settled = false;
+        const sock = connect(pipePath);
+        const timer = setTimeout(() => {
+            if (settled)
+                return;
+            settled = true;
+            sock.destroy();
+            reject(new Error(`Timed out connecting to pty-host at ${pipePath} (${timeoutMs}ms)`));
+        }, timeoutMs);
+        sock.once("connect", () => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            resolve(sock);
+        });
+        sock.once("error", (err) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            reject(err);
+        });
+    });
+}
+// ---------------------------------------------------------------------------
+// ptyHostSendMessage
+// ---------------------------------------------------------------------------
+// Windows ConPTY silently drops bytes when a single pty.write() exceeds its
+// input buffer (observed truncation around 3–4 KB). Slicing the payload into
+// small chunks with a brief delay between each lets the host's pty.write()
+// drain into ConPTY before the next chunk arrives. Unix PTYs don't have this
+// limitation, but chunking is harmless there — the small added latency
+// (~15 ms × ceil(chars/512)) is imperceptible for typical prompts.
+const PTY_INPUT_CHUNK_CHARS = 512;
+const PTY_INPUT_CHUNK_DELAY_MS = 15;
+const PTY_INPUT_ENTER_DELAY_MS = 300;
+function writeFrame(sock, frame) {
+    return new Promise((resolve, reject) => {
+        sock.write(frame, (err) => {
+            if (err)
+                reject(err);
+            else
+                resolve();
+        });
+    });
+}
+function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Send a message (text command) to the PTY via a short-lived connection.
+ * Chunks large payloads to avoid ConPTY buffer truncation on Windows, then
+ * sends Enter as a separate frame after a short pause.
+ *
+ * Sliced by JS string length (UTF-16 code units), not bytes, so multi-byte
+ * codepoints aren't split mid-encoding. Surrogate pairs at chunk boundaries
+ * are still possible but extraordinarily rare in agent prompts; the cost of
+ * a defensive boundary check isn't worth it for our content.
+ */
+export async function ptyHostSendMessage(pipePath, message) {
+    const sock = await connectPtyHost(pipePath);
+    return new Promise((resolve, reject) => {
+        let settled = false;
+        const finish = (err) => {
+            if (settled)
+                return;
+            settled = true;
+            if (err) {
+                sock.destroy();
+                reject(err);
+            }
+            else {
+                sock.end();
+                resolve();
+            }
+        };
+        sock.once("error", finish);
+        void (async () => {
+            try {
+                for (let offset = 0; offset < message.length; offset += PTY_INPUT_CHUNK_CHARS) {
+                    const slice = message.slice(offset, offset + PTY_INPUT_CHUNK_CHARS);
+                    await writeFrame(sock, encodeMessage(MSG_TERMINAL_INPUT, slice));
+                    if (offset + PTY_INPUT_CHUNK_CHARS < message.length) {
+                        await delay(PTY_INPUT_CHUNK_DELAY_MS);
+                    }
+                }
+                // Brief pause before Enter so the terminal processes the pasted text
+                // as input rather than consuming \r as part of the paste itself.
+                await delay(PTY_INPUT_ENTER_DELAY_MS);
+                await writeFrame(sock, encodeMessage(MSG_TERMINAL_INPUT, "\r"));
+                finish();
+            }
+            catch (err) {
+                finish(err);
+            }
+        })();
+    });
+}
+// ---------------------------------------------------------------------------
+// ptyHostGetOutput
+// ---------------------------------------------------------------------------
+/**
+ * Request the last N lines of PTY output from the host.
+ * Uses MessageParser to skip any MSG_TERMINAL_DATA frames that arrive before
+ * the MSG_GET_OUTPUT_RES response.
+ * Returns "" on timeout (3 s) or connection failure.
+ */
+export async function ptyHostGetOutput(pipePath, lines = 50) {
+    let sock;
+    try {
+        sock = await connectPtyHost(pipePath, 3000);
+    }
+    catch {
+        return "";
+    }
+    return new Promise((resolve) => {
+        let settled = false;
+        const finish = (result) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            sock.destroy();
+            resolve(result);
+        };
+        const timer = setTimeout(() => finish(""), 3000);
+        const parser = new MessageParser((type, payload) => {
+            if (type === MSG_GET_OUTPUT_RES) {
+                finish(payload.toString("utf-8"));
+            }
+            // MSG_TERMINAL_DATA and other types are silently ignored
+        });
+        sock.on("data", (chunk) => parser.feed(chunk));
+        sock.once("error", () => finish(""));
+        sock.once("close", () => finish(""));
+        const req = encodeMessage(MSG_GET_OUTPUT_REQ, JSON.stringify({ lines }));
+        sock.write(req);
+    });
+}
+// ---------------------------------------------------------------------------
+// ptyHostIsAlive
+// ---------------------------------------------------------------------------
+/**
+ * Check whether the pty-host process is still alive.
+ * Returns false if the pipe is unreachable (host has exited).
+ */
+export async function ptyHostIsAlive(pipePath) {
+    let sock;
+    try {
+        sock = await connectPtyHost(pipePath, 2000);
+    }
+    catch {
+        return false;
+    }
+    return new Promise((resolve) => {
+        let settled = false;
+        const finish = (result) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            sock.destroy();
+            resolve(result);
+        };
+        const timer = setTimeout(() => finish(false), 2000);
+        const parser = new MessageParser((type, payload) => {
+            if (type === MSG_STATUS_RES) {
+                // The pty-host process is alive if we got ANY valid response.
+                // Whether the agent inside the PTY has exited (status.alive=false)
+                // is a separate concern handled by getActivityState, not isAlive.
+                // This mirrors tmux: `tmux has-session` returns true even after
+                // the command inside the pane has exited.
+                try {
+                    JSON.parse(payload.toString("utf-8")); // validate it's real JSON
+                    finish(true);
+                }
+                catch {
+                    finish(false);
+                }
+            }
+            // Skip MSG_TERMINAL_DATA and other types
+        });
+        sock.on("data", (chunk) => parser.feed(chunk));
+        sock.once("error", () => finish(false));
+        sock.once("close", () => finish(false));
+        sock.write(encodeMessage(MSG_STATUS_REQ, ""));
+    });
+}
+// ---------------------------------------------------------------------------
+// ptyHostKill
+// ---------------------------------------------------------------------------
+/**
+ * Send a kill request to the pty-host. Silently ignores errors — if the
+ * pipe is unreachable the process is already dead.
+ */
+export async function ptyHostKill(pipePath) {
+    let sock;
+    try {
+        sock = await connectPtyHost(pipePath, 2000);
+    }
+    catch {
+        // Already dead — nothing to do
+        return;
+    }
+    await new Promise((resolve) => {
+        sock.once("error", () => resolve());
+        const frame = encodeMessage(MSG_KILL_REQ, "");
+        sock.write(frame, () => {
+            sock.end();
+            resolve();
+        });
+    });
+}
+//# sourceMappingURL=pty-client.js.map

package/dist/pty-client.js.map

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

package/dist/pty-host.d.ts

@@ -0,0 +1,51 @@
+/**
+ * pty-host.ts
+ *
+ * Dual-purpose file:
+ *   1. Module — exports protocol constants, encodeMessage(), and MessageParser
+ *      (imported by pty-client.ts)
+ *   2. Standalone script — when run as `node pty-host.js <args>` it owns a
+ *      ConPTY session and exposes it over a Windows named pipe so multiple
+ *      clients can attach/detach (analogous to the tmux daemon).
+ *
+ * Usage (standalone):
+ *   node pty-host.js <sessionId> <pipePath> <cwd> <shellCmd> <shellArg1> [shellArg2...]
+ *
+ * Binary protocol over named pipe:
+ *   [1-byte type][4-byte big-endian length][payload]
+ *
+ *   0x01  terminal data    host → client   raw PTY output bytes
+ *   0x02  terminal input   client → host   raw keystrokes for PTY
+ *   0x03  resize           client → host   JSON { cols, rows }
+ *   0x04  get-output req   client → host   JSON { lines: number }
+ *   0x05  get-output res   host → client   UTF-8 text (last N lines joined)
+ *   0x06  status req       client → host   empty payload
+ *   0x07  status res       host → client   JSON { alive, pid, exitCode? }
+ *   0x08  kill req         client → host   empty payload
+ */
+export declare const MSG_TERMINAL_DATA = 1;
+export declare const MSG_TERMINAL_INPUT = 2;
+export declare const MSG_RESIZE = 3;
+export declare const MSG_GET_OUTPUT_REQ = 4;
+export declare const MSG_GET_OUTPUT_RES = 5;
+export declare const MSG_STATUS_REQ = 6;
+export declare const MSG_STATUS_RES = 7;
+export declare const MSG_KILL_REQ = 8;
+/**
+ * Encode a message into the binary framing format.
+ * @param type  One of the MSG_* constants.
+ * @param payload  String (UTF-8 encoded) or raw Buffer.
+ */
+export declare function encodeMessage(type: number, payload: Buffer | string): Buffer;
+/**
+ * Streaming parser for the binary framing protocol.
+ * Feed arbitrary-sized chunks from a TCP/pipe stream and receive complete
+ * decoded messages via the onMessage callback.
+ */
+export declare class MessageParser {
+    private _buf;
+    private readonly _onMessage;
+    constructor(onMessage: (type: number, payload: Buffer) => void);
+    feed(chunk: Buffer): void;
+}
+//# sourceMappingURL=pty-host.d.ts.map

package/dist/pty-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pty-host.d.ts","sourceRoot":"","sources":["../src/pty-host.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAQH,eAAO,MAAM,iBAAiB,IAAO,CAAC;AACtC,eAAO,MAAM,kBAAkB,IAAO,CAAC;AACvC,eAAO,MAAM,UAAU,IAAO,CAAC;AAC/B,eAAO,MAAM,kBAAkB,IAAO,CAAC;AACvC,eAAO,MAAM,kBAAkB,IAAO,CAAC;AACvC,eAAO,MAAM,cAAc,IAAO,CAAC;AACnC,eAAO,MAAM,cAAc,IAAO,CAAC;AACnC,eAAO,MAAM,YAAY,IAAO,CAAC;AAMjC;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAO5E;AAMD;;;;GAIG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,IAAI,CAA2B;IACvC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA0C;gBAEzD,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI;IAI9D,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;CAe1B"}