@swarmify/agents-cli 1.10.3 → 1.10.4

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

@@ -0,0 +1,22 @@
+/**
+ * PTY Client
+ *
+ * Thin client that connects to the PTY sidecar server over unix socket.
+ * Each call opens a connection, sends a JSON request, reads the JSON response, and closes.
+ */
+export interface PtyResponse {
+    ok: boolean;
+    error?: string;
+    [key: string]: any;
+}
+/**
+ * Send a request to the PTY server and return the response.
+ * Auto-starts the server if not running.
+ */
+export declare function ptyRequest(action: string, id?: string, params?: Record<string, any>): Promise<PtyResponse>;
+/**
+ * Parse escape sequences in user input strings.
+ * Handles: \n \r \t \e \xHH \\
+ */
+export declare function unescapeInput(input: string): string;
+//# sourceMappingURL=pty-client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pty-client.d.ts","sourceRoot":"","sources":["../../src/lib/pty-client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAQhH;AAiJD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAgBnD"}

package/dist/lib/pty-client.js

@@ -0,0 +1,181 @@
+/**
+ * PTY Client
+ *
+ * Thin client that connects to the PTY sidecar server over unix socket.
+ * Each call opens a connection, sends a JSON request, reads the JSON response, and closes.
+ */
+import * as net from 'net';
+import * as fs from 'fs';
+import { spawn, execSync } from 'child_process';
+import { fileURLToPath } from 'url';
+import * as path from 'path';
+import { getSocketPath, isPtyServerRunning } from './pty-server.js';
+const CONNECT_TIMEOUT_MS = 5000;
+const RESPONSE_TIMEOUT_MS = 30000;
+/**
+ * Send a request to the PTY server and return the response.
+ * Auto-starts the server if not running.
+ */
+export async function ptyRequest(action, id, params) {
+    await ensureServer();
+    const req = { action };
+    if (id)
+        req.id = id;
+    if (params)
+        req.params = params;
+    return sendRequest(req);
+}
+/**
+ * Ensure the PTY server is running. Start it if not.
+ */
+async function ensureServer() {
+    if (isPtyServerRunning())
+        return;
+    // Find the entry point to spawn the server
+    const { bin, args } = getServerSpawnArgs();
+    const logPath = path.join(path.dirname(getSocketPath()), 'pty.log');
+    const logFd = fs.openSync(logPath, 'a');
+    const child = spawn(bin, args, {
+        stdio: ['ignore', logFd, logFd],
+        detached: true,
+    });
+    child.unref();
+    fs.closeSync(logFd);
+    // Wait for socket to appear
+    const socketPath = getSocketPath();
+    const deadline = Date.now() + 5000;
+    while (Date.now() < deadline) {
+        if (fs.existsSync(socketPath)) {
+            // Verify we can connect
+            try {
+                await sendRequest({ action: 'ping' });
+                return;
+            }
+            catch {
+                // Not ready yet
+            }
+        }
+        await new Promise(r => setTimeout(r, 100));
+    }
+    throw new Error('PTY server failed to start within 5 seconds. Check ~/.agents/pty.log');
+}
+function getServerSpawnArgs() {
+    // Prefer the dist/index.js from the same installation as this code.
+    // This avoids version mismatch when a globally installed `agents` is older.
+    try {
+        const __dirname = path.dirname(fileURLToPath(import.meta.url));
+        const distIndex = path.join(__dirname, '..', 'index.js');
+        if (fs.existsSync(distIndex)) {
+            return { bin: process.execPath, args: [distIndex, 'pty', '_server'] };
+        }
+    }
+    catch { }
+    // Fallback: use the globally installed agents command
+    try {
+        const agentsBin = execSync('which agents', { encoding: 'utf-8' }).trim();
+        if (agentsBin) {
+            return { bin: agentsBin, args: ['pty', '_server'] };
+        }
+    }
+    catch { }
+    return { bin: 'agents', args: ['pty', '_server'] };
+}
+/**
+ * Send a JSON request over the unix socket and return the parsed response.
+ */
+function sendRequest(req) {
+    return new Promise((resolve, reject) => {
+        const socketPath = getSocketPath();
+        if (!fs.existsSync(socketPath)) {
+            reject(new Error('PTY server socket not found. Is the server running?'));
+            return;
+        }
+        const conn = net.createConnection({ path: socketPath });
+        let data = '';
+        let settled = false;
+        const connectTimeout = setTimeout(() => {
+            if (!settled) {
+                settled = true;
+                conn.destroy();
+                reject(new Error('Connection to PTY server timed out'));
+            }
+        }, CONNECT_TIMEOUT_MS);
+        const responseTimeout = setTimeout(() => {
+            if (!settled) {
+                settled = true;
+                conn.destroy();
+                reject(new Error('PTY server response timed out'));
+            }
+        }, RESPONSE_TIMEOUT_MS);
+        conn.on('connect', () => {
+            clearTimeout(connectTimeout);
+            conn.write(JSON.stringify(req) + '\n');
+        });
+        conn.on('data', (chunk) => {
+            data += chunk.toString();
+            const nlIndex = data.indexOf('\n');
+            if (nlIndex !== -1) {
+                if (!settled) {
+                    settled = true;
+                    clearTimeout(connectTimeout);
+                    clearTimeout(responseTimeout);
+                    try {
+                        resolve(JSON.parse(data.slice(0, nlIndex)));
+                    }
+                    catch (err) {
+                        reject(new Error(`Invalid JSON from PTY server: ${data.slice(0, 200)}`));
+                    }
+                }
+                conn.end();
+            }
+        });
+        conn.on('error', (err) => {
+            if (!settled) {
+                settled = true;
+                clearTimeout(connectTimeout);
+                clearTimeout(responseTimeout);
+                reject(new Error(`PTY server connection error: ${err.message}`));
+            }
+        });
+        conn.on('end', () => {
+            if (!settled) {
+                settled = true;
+                clearTimeout(connectTimeout);
+                clearTimeout(responseTimeout);
+                if (data.trim()) {
+                    try {
+                        resolve(JSON.parse(data.trim()));
+                    }
+                    catch {
+                        reject(new Error('PTY server closed connection with invalid response'));
+                    }
+                }
+                else {
+                    reject(new Error('PTY server closed connection without response'));
+                }
+            }
+        });
+    });
+}
+/**
+ * Parse escape sequences in user input strings.
+ * Handles: \n \r \t \e \xHH \\
+ */
+export function unescapeInput(input) {
+    return input.replace(/\\(n|r|t|e|\\|x[0-9a-fA-F]{2})/g, (match, seq) => {
+        switch (seq) {
+            case 'n': return '\n';
+            case 'r': return '\r';
+            case 't': return '\t';
+            case 'e': return '\x1b';
+            case '\\': return '\\';
+            default:
+                // \xHH
+                if (seq.startsWith('x')) {
+                    return String.fromCharCode(parseInt(seq.slice(1), 16));
+                }
+                return match;
+        }
+    });
+}
+//# sourceMappingURL=pty-client.js.map

package/dist/lib/pty-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pty-client.js","sourceRoot":"","sources":["../../src/lib/pty-client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,GAAG,MAAM,KAAK,CAAC;AAC3B,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAiB,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAEnF,MAAM,kBAAkB,GAAG,IAAI,CAAC;AAChC,MAAM,mBAAmB,GAAG,KAAK,CAAC;AAQlC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,MAAc,EAAE,EAAW,EAAE,MAA4B;IACxF,MAAM,YAAY,EAAE,CAAC;IAErB,MAAM,GAAG,GAAQ,EAAE,MAAM,EAAE,CAAC;IAC5B,IAAI,EAAE;QAAE,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC;IACpB,IAAI,MAAM;QAAE,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC;IAEhC,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,YAAY;IACzB,IAAI,kBAAkB,EAAE;QAAE,OAAO;IAEjC,2CAA2C;IAC3C,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,kBAAkB,EAAE,CAAC;IAE3C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC;IACpE,MAAM,KAAK,GAAG,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAExC,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE;QAC7B,KAAK,EAAE,CAAC,QAAQ,EAAE,KAAK,EAAE,KAAK,CAAC;QAC/B,QAAQ,EAAE,IAAI;KACf,CAAC,CAAC;IACH,KAAK,CAAC,KAAK,EAAE,CAAC;IACd,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAEpB,4BAA4B;IAC5B,MAAM,UAAU,GAAG,aAAa,EAAE,CAAC;IACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;IACnC,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;QAC7B,IAAI,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC9B,wBAAwB;YACxB,IAAI,CAAC;gBACH,MAAM,WAAW,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;gBACtC,OAAO;YACT,CAAC;YAAC,MAAM,CAAC;gBACP,gBAAgB;YAClB,CAAC;QACH,CAAC;QACD,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;IAC7C,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,sEAAsE,CAAC,CAAC;AAC1F,CAAC;AAED,SAAS,kBAAkB;IACzB,oEAAoE;IACpE,4EAA4E;IAC5E,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAC/D,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;QACzD,IAAI,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC7B,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,SAAS,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,CAAC;QACxE,CAAC;IACH,CAAC;IAAC,MAAM,CAAC,CAAA,CAAC;IAEV,sDAAsD;IACtD,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,QAAQ,CAAC,cAAc,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACzE,IAAI,SAAS,EAAE,CAAC;YACd,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,CAAC;QACtD,CAAC;IACH,CAAC;IAAC,MAAM,CAAC,CAAA,CAAC;IAEV,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,CAAC;AACrD,CAAC;AAED;;GAEG;AACH,SAAS,WAAW,CAAC,GAAQ;IAC3B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,UAAU,GAAG,aAAa,EAAE,CAAC;QAEnC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC/B,MAAM,CAAC,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC,CAAC;YACzE,OAAO;QACT,CAAC;QAED,MAAM,IAAI,GAAG,GAAG,CAAC,gBAAgB,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;QACxD,IAAI,IAAI,GAAG,EAAE,CAAC;QACd,IAAI,OAAO,GAAG,KAAK,CAAC;QAEpB,MAAM,cAAc,GAAG,UAAU,CAAC,GAAG,EAAE;YACrC,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,OAAO,GAAG,IAAI,CAAC;gBACf,IAAI,CAAC,OAAO,EAAE,CAAC;gBACf,MAAM,CAAC,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC,CAAC;YAC1D,CAAC;QACH,CAAC,EAAE,kBAAkB,CAAC,CAAC;QAEvB,MAAM,eAAe,GAAG,UAAU,CAAC,GAAG,EAAE;YACtC,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,OAAO,GAAG,IAAI,CAAC;gBACf,IAAI,CAAC,OAAO,EAAE,CAAC;gBACf,MAAM,CAAC,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC,CAAC;YACrD,CAAC;QACH,CAAC,EAAE,mBAAmB,CAAC,CAAC;QAExB,IAAI,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;YACtB,YAAY,CAAC,cAAc,CAAC,CAAC;YAC7B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;QACzC,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;YACxB,IAAI,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YACzB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACnC,IAAI,OAAO,KAAK,CAAC,CAAC,EAAE,CAAC;gBACnB,IAAI,CAAC,OAAO,EAAE,CAAC;oBACb,OAAO,GAAG,IAAI,CAAC;oBACf,YAAY,CAAC,cAAc,CAAC,CAAC;oBAC7B,YAAY,CAAC,eAAe,CAAC,CAAC;oBAC9B,IAAI,CAAC;wBACH,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;oBAC9C,CAAC;oBAAC,OAAO,GAAG,EAAE,CAAC;wBACb,MAAM,CAAC,IAAI,KAAK,CAAC,iCAAiC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;oBAC3E,CAAC;gBACH,CAAC;gBACD,IAAI,CAAC,GAAG,EAAE,CAAC;YACb,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACvB,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,OAAO,GAAG,IAAI,CAAC;gBACf,YAAY,CAAC,cAAc,CAAC,CAAC;gBAC7B,YAAY,CAAC,eAAe,CAAC,CAAC;gBAC9B,MAAM,CAAC,IAAI,KAAK,CAAC,gCAAgC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YACnE,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE;YAClB,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,OAAO,GAAG,IAAI,CAAC;gBACf,YAAY,CAAC,cAAc,CAAC,CAAC;gBAC7B,YAAY,CAAC,eAAe,CAAC,CAAC;gBAC9B,IAAI,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;oBAChB,IAAI,CAAC;wBACH,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;oBACnC,CAAC;oBAAC,MAAM,CAAC;wBACP,MAAM,CAAC,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC,CAAC;oBAC1E,CAAC;gBACH,CAAC;qBAAM,CAAC;oBACN,MAAM,CAAC,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC,CAAC;gBACrE,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,OAAO,KAAK,CAAC,OAAO,CAAC,iCAAiC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QACrE,QAAQ,GAAG,EAAE,CAAC;YACZ,KAAK,GAAG,CAAC,CAAC,OAAO,IAAI,CAAC;YACtB,KAAK,GAAG,CAAC,CAAC,OAAO,IAAI,CAAC;YACtB,KAAK,GAAG,CAAC,CAAC,OAAO,IAAI,CAAC;YACtB,KAAK,GAAG,CAAC,CAAC,OAAO,MAAM,CAAC;YACxB,KAAK,IAAI,CAAC,CAAC,OAAO,IAAI,CAAC;YACvB;gBACE,OAAO;gBACP,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;oBACxB,OAAO,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;gBACzD,CAAC;gBACD,OAAO,KAAK,CAAC;QACjB,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/lib/pty-server.d.ts

@@ -0,0 +1,16 @@
+/**
+ * PTY Sidecar Server
+ *
+ * Lightweight unix socket server that manages persistent PTY sessions.
+ * Started as a detached process by `agents pty` commands. Sessions survive
+ * across multiple CLI invocations. Each session holds a real PTY (via node-pty)
+ * and a headless terminal emulator (via @xterm/headless) for screen rendering.
+ *
+ * Protocol: newline-delimited JSON over ~/.agents/pty.sock
+ */
+export declare function getSocketPath(): string;
+export declare function getPtyPidPath(): string;
+export declare function getPtyLogPath(): string;
+export declare function isPtyServerRunning(): boolean;
+export declare function runPtyServer(): Promise<void>;
+//# sourceMappingURL=pty-server.d.ts.map

package/dist/lib/pty-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pty-server.d.ts","sourceRoot":"","sources":["../../src/lib/pty-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAwCH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED,wBAAgB,kBAAkB,IAAI,OAAO,CAY5C;AAcD,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAqYlD"}

package/dist/lib/pty-server.js

@@ -0,0 +1,422 @@
+/**
+ * PTY Sidecar Server
+ *
+ * Lightweight unix socket server that manages persistent PTY sessions.
+ * Started as a detached process by `agents pty` commands. Sessions survive
+ * across multiple CLI invocations. Each session holds a real PTY (via node-pty)
+ * and a headless terminal emulator (via @xterm/headless) for screen rendering.
+ *
+ * Protocol: newline-delimited JSON over ~/.agents/pty.sock
+ */
+import * as net from 'net';
+import * as fs from 'fs';
+import * as path from 'path';
+import * as crypto from 'crypto';
+import { fileURLToPath } from 'url';
+import { getAgentsDir } from './state.js';
+// --- Constants ---
+const SENTINEL = '__AGENTS_PTY_DONE__';
+const SOCKET_NAME = 'pty.sock';
+const PID_FILE = 'pty.pid';
+const LOG_FILE = 'pty.log';
+const SESSION_IDLE_MS = 30 * 60 * 1000; // 30 min
+const SERVER_IDLE_MS = 60 * 60 * 1000; // 1 hour
+// --- Path helpers ---
+export function getSocketPath() {
+    return path.join(getAgentsDir(), SOCKET_NAME);
+}
+export function getPtyPidPath() {
+    return path.join(getAgentsDir(), PID_FILE);
+}
+export function getPtyLogPath() {
+    return path.join(getAgentsDir(), LOG_FILE);
+}
+export function isPtyServerRunning() {
+    const pidPath = getPtyPidPath();
+    if (!fs.existsSync(pidPath))
+        return false;
+    try {
+        const pid = parseInt(fs.readFileSync(pidPath, 'utf-8').trim(), 10);
+        if (isNaN(pid))
+            return false;
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        try {
+            fs.unlinkSync(pidPath);
+        }
+        catch { }
+        return false;
+    }
+}
+// --- Logging ---
+function log(level, message) {
+    const ts = new Date().toISOString();
+    const line = `[${ts}] [${level}] ${message}\n`;
+    try {
+        fs.appendFileSync(getPtyLogPath(), line, 'utf-8');
+    }
+    catch { }
+}
+// --- Server ---
+export async function runPtyServer() {
+    // Dynamic imports for optional native deps
+    let nodePty;
+    let XtermTerminal;
+    try {
+        nodePty = await import('node-pty');
+        // Handle ESM default export
+        if (nodePty.default?.spawn)
+            nodePty = nodePty.default;
+        // Ensure spawn-helper is executable (bun install doesn't set +x on prebuilds)
+        try {
+            const __dirname = path.dirname(fileURLToPath(import.meta.url));
+            const ptyBase = path.resolve(__dirname, '..', '..', 'node_modules', 'node-pty');
+            const helpers = [
+                path.join(ptyBase, 'prebuilds', `${process.platform}-${process.arch}`, 'spawn-helper'),
+                path.join(ptyBase, 'build', 'Release', 'spawn-helper'),
+            ];
+            for (const h of helpers) {
+                if (fs.existsSync(h)) {
+                    fs.chmodSync(h, 0o755);
+                }
+            }
+        }
+        catch { }
+    }
+    catch (err) {
+        console.error('node-pty is required for PTY support.');
+        console.error('Install: cd ' + getAgentsDir() + '/../agents-cli && bun add node-pty');
+        process.exit(1);
+    }
+    try {
+        const xterm = await import('@xterm/headless');
+        // Handle ESM default export wrapping
+        XtermTerminal = xterm.Terminal || xterm.default?.Terminal;
+    }
+    catch {
+        console.error('@xterm/headless is required for PTY support.');
+        console.error('Install: cd ' + getAgentsDir() + '/../agents-cli && bun add @xterm/headless');
+        process.exit(1);
+    }
+    const sessions = new Map();
+    const socketPath = getSocketPath();
+    // Remove stale socket
+    if (fs.existsSync(socketPath)) {
+        try {
+            fs.unlinkSync(socketPath);
+        }
+        catch { }
+    }
+    let lastActivityTime = Date.now();
+    function generateId() {
+        return crypto.randomBytes(4).toString('hex');
+    }
+    function killSession(session) {
+        if (!session.exited) {
+            try {
+                session.pty.kill();
+            }
+            catch { }
+            session.exited = true;
+        }
+        if (session.terminal) {
+            try {
+                session.terminal.dispose();
+            }
+            catch { }
+        }
+    }
+    function getScreenLines(session) {
+        const lines = [];
+        const buf = session.terminal.buffer.active;
+        for (let y = 0; y < session.rows; y++) {
+            const line = buf.getLine(y);
+            const text = line ? line.translateToString(true) : '';
+            // Strip lines containing the sentinel pattern
+            if (text.includes(SENTINEL))
+                continue;
+            lines.push(text);
+        }
+        // Trim trailing empty lines
+        while (lines.length > 0 && lines[lines.length - 1] === '') {
+            lines.pop();
+        }
+        return lines;
+    }
+    // Session idle cleanup + server auto-exit
+    const cleanupInterval = setInterval(() => {
+        const now = Date.now();
+        for (const [id, session] of sessions) {
+            if (now - session.lastActivity > SESSION_IDLE_MS) {
+                log('INFO', `Cleaning up idle session ${id}`);
+                killSession(session);
+                sessions.delete(id);
+            }
+        }
+        if (sessions.size === 0 && now - lastActivityTime > SERVER_IDLE_MS) {
+            log('INFO', 'No sessions, server idle timeout reached. Shutting down.');
+            shutdown();
+        }
+    }, 60_000);
+    // --- Request handlers ---
+    async function handleRequest(req) {
+        lastActivityTime = Date.now();
+        switch (req.action) {
+            case 'start': {
+                const rows = req.params?.rows || 24;
+                const cols = req.params?.cols || 120;
+                const shell = req.params?.shell || process.env.SHELL || 'zsh';
+                const cwd = req.params?.cwd || process.env.HOME || '/';
+                const id = generateId();
+                let ptyProcess;
+                try {
+                    ptyProcess = nodePty.spawn(shell, [], {
+                        name: 'xterm-256color',
+                        cols,
+                        rows,
+                        cwd,
+                        env: { ...process.env },
+                    });
+                }
+                catch (err) {
+                    return { ok: false, error: `Failed to spawn PTY: ${err.message}` };
+                }
+                const terminal = new XtermTerminal({ rows, cols, allowProposedApi: true });
+                const session = {
+                    id,
+                    pty: ptyProcess,
+                    terminal,
+                    rows,
+                    cols,
+                    shell,
+                    cwd,
+                    pid: ptyProcess.pid,
+                    startedAt: Date.now(),
+                    lastActivity: Date.now(),
+                    pendingOutput: '',
+                    appActive: false,
+                    activeCommand: '',
+                    exited: false,
+                    exitCode: null,
+                };
+                ptyProcess.onData((data) => {
+                    session.pendingOutput += data;
+                    terminal.write(data);
+                    session.lastActivity = Date.now();
+                    // Check for sentinel to detect command completion
+                    if (session.appActive && session.pendingOutput.includes(SENTINEL + ':')) {
+                        session.appActive = false;
+                        session.activeCommand = '';
+                    }
+                });
+                ptyProcess.onExit(({ exitCode }) => {
+                    session.exited = true;
+                    session.exitCode = exitCode;
+                    session.appActive = false;
+                });
+                // Wait for shell to initialize, then clear init output
+                await new Promise(r => setTimeout(r, 300));
+                session.pendingOutput = '';
+                sessions.set(id, session);
+                log('INFO', `Session started: ${id} (pid=${ptyProcess.pid}, shell=${shell}, ${cols}x${rows})`);
+                return { ok: true, id, pid: ptyProcess.pid, rows, cols, shell };
+            }
+            case 'exec': {
+                const session = sessions.get(req.id);
+                if (!session)
+                    return { ok: false, error: `Session not found: ${req.id}` };
+                if (session.exited)
+                    return { ok: false, error: 'Session has exited' };
+                if (session.appActive) {
+                    return { ok: false, error: `Command already active: ${session.activeCommand}. Use write to interact or signal to interrupt.` };
+                }
+                const command = req.params?.command;
+                if (!command)
+                    return { ok: false, error: 'command is required' };
+                session.appActive = true;
+                session.activeCommand = command;
+                session.pendingOutput = '';
+                session.pty.write(`${command}; echo "${SENTINEL}:$?"\n`);
+                session.lastActivity = Date.now();
+                return { ok: true, submitted: true };
+            }
+            case 'read': {
+                const session = sessions.get(req.id);
+                if (!session)
+                    return { ok: false, error: `Session not found: ${req.id}` };
+                const waitMs = Math.min(Math.max(req.params?.ms || 100, 50), 5000);
+                // Wait for output to accumulate
+                if (session.pendingOutput.length === 0) {
+                    await new Promise(r => setTimeout(r, waitMs));
+                }
+                const output = session.pendingOutput;
+                session.pendingOutput = '';
+                // Strip sentinel lines from output
+                const cleaned = output
+                    .split('\n')
+                    .filter(line => !line.includes(SENTINEL))
+                    .join('\n');
+                return {
+                    ok: true,
+                    output: cleaned,
+                    bytes: output.length,
+                    app_active: session.appActive,
+                    active_command: session.activeCommand || undefined,
+                    exited: session.exited,
+                    exit_code: session.exitCode,
+                };
+            }
+            case 'write': {
+                const session = sessions.get(req.id);
+                if (!session)
+                    return { ok: false, error: `Session not found: ${req.id}` };
+                if (session.exited)
+                    return { ok: false, error: 'Session has exited' };
+                let input = req.params?.input ?? '';
+                if (input === '')
+                    input = '\n';
+                session.pty.write(input);
+                session.lastActivity = Date.now();
+                return { ok: true };
+            }
+            case 'screen': {
+                const session = sessions.get(req.id);
+                if (!session)
+                    return { ok: false, error: `Session not found: ${req.id}` };
+                const lines = getScreenLines(session);
+                const buf = session.terminal.buffer.active;
+                return {
+                    ok: true,
+                    screen: lines.join('\n'),
+                    rows: session.rows,
+                    cols: session.cols,
+                    cursor: { x: buf.cursorX, y: buf.cursorY },
+                    app_active: session.appActive,
+                    active_command: session.activeCommand || undefined,
+                    exited: session.exited,
+                };
+            }
+            case 'signal': {
+                const session = sessions.get(req.id);
+                if (!session)
+                    return { ok: false, error: `Session not found: ${req.id}` };
+                if (session.exited)
+                    return { ok: false, error: 'Session has exited' };
+                const sig = (req.params?.signal || 'INT').toUpperCase();
+                if (!['INT', 'TERM', 'KILL', 'HUP'].includes(sig)) {
+                    return { ok: false, error: `Unsupported signal: ${sig}` };
+                }
+                try {
+                    // node-pty kill accepts signal number; use process.kill for named signals
+                    process.kill(session.pid, `SIG${sig}`);
+                }
+                catch (err) {
+                    return { ok: false, error: `Failed to send signal: ${err.message}` };
+                }
+                return { ok: true };
+            }
+            case 'resize': {
+                const session = sessions.get(req.id);
+                if (!session)
+                    return { ok: false, error: `Session not found: ${req.id}` };
+                if (session.exited)
+                    return { ok: false, error: 'Session has exited' };
+                const rows = req.params?.rows || session.rows;
+                const cols = req.params?.cols || session.cols;
+                session.pty.resize(cols, rows);
+                session.terminal.resize(cols, rows);
+                session.rows = rows;
+                session.cols = cols;
+                return { ok: true, rows, cols };
+            }
+            case 'list': {
+                const list = [];
+                for (const [, session] of sessions) {
+                    list.push({
+                        id: session.id,
+                        pid: session.pid,
+                        shell: session.shell,
+                        cwd: session.cwd,
+                        rows: session.rows,
+                        cols: session.cols,
+                        started_at: session.startedAt,
+                        last_activity: session.lastActivity,
+                        app_active: session.appActive,
+                        active_command: session.activeCommand || undefined,
+                        exited: session.exited,
+                        exit_code: session.exitCode,
+                    });
+                }
+                return { ok: true, sessions: list };
+            }
+            case 'stop': {
+                const session = sessions.get(req.id);
+                if (!session)
+                    return { ok: false, error: `Session not found: ${req.id}` };
+                killSession(session);
+                sessions.delete(req.id);
+                log('INFO', `Session stopped: ${req.id}`);
+                return { ok: true };
+            }
+            case 'ping': {
+                return { ok: true, sessions: sessions.size, pid: process.pid };
+            }
+            default:
+                return { ok: false, error: `Unknown action: ${req.action}` };
+        }
+    }
+    // --- Socket server ---
+    const server = net.createServer((conn) => {
+        let buf = '';
+        conn.on('data', async (chunk) => {
+            buf += chunk.toString();
+            const nlIndex = buf.indexOf('\n');
+            if (nlIndex === -1)
+                return;
+            const line = buf.slice(0, nlIndex);
+            buf = '';
+            try {
+                const req = JSON.parse(line);
+                const res = await handleRequest(req);
+                conn.write(JSON.stringify(res) + '\n');
+            }
+            catch (err) {
+                conn.write(JSON.stringify({ ok: false, error: err.message || String(err) }) + '\n');
+            }
+            conn.end();
+        });
+        conn.on('error', () => { });
+    });
+    await new Promise((resolve) => {
+        server.listen(socketPath, () => resolve());
+    });
+    // Write PID
+    fs.writeFileSync(getPtyPidPath(), String(process.pid), 'utf-8');
+    log('INFO', `PTY server started (PID: ${process.pid}, socket: ${socketPath})`);
+    // Shutdown handler
+    function shutdown() {
+        log('INFO', 'PTY server shutting down');
+        for (const session of sessions.values()) {
+            killSession(session);
+        }
+        sessions.clear();
+        clearInterval(cleanupInterval);
+        server.close();
+        try {
+            fs.unlinkSync(socketPath);
+        }
+        catch { }
+        try {
+            fs.unlinkSync(getPtyPidPath());
+        }
+        catch { }
+        process.exit(0);
+    }
+    process.on('SIGTERM', shutdown);
+    process.on('SIGINT', shutdown);
+    // Keep alive
+    await new Promise(() => { });
+}
+//# sourceMappingURL=pty-server.js.map