nstantpage-agent 0.5.2 → 0.5.3

package/dist/cli.js

@@ -25,7 +25,7 @@ const program = new Command();
 program
     .name('nstantpage')
     .description('Local development agent for nstantpage.com — run projects on your machine, preview in the cloud')
-    .version('0.5.2');
+    .version('0.5.3');
 program
     .command('login')
     .description('Authenticate with nstantpage.com')

package/dist/commands/start.js

@@ -24,7 +24,7 @@ import { getConfig, getProjectConfig, setProjectConfig, clearProjectConfig, getD
 import { TunnelClient } from '../tunnel.js';
 import { LocalServer } from '../localServer.js';
 import { PackageInstaller } from '../packageInstaller.js';
-const VERSION = '0.5.2';
+const VERSION = '0.5.3';
 /**
  * Resolve the backend API base URL.
  * - If --backend is passed, use it

package/dist/localServer.d.ts

@@ -17,7 +17,8 @@ import { DevServer } from './devServer.js';
 interface TerminalSession {
     id: string;
     projectId: string;
-    shell: ChildProcess;
+    shell: ChildProcess | null;
+    ptyProcess: any | null;
     outputBuffer: string[];
     createdAt: number;
     lastActivity: number;
@@ -35,6 +36,14 @@ interface TerminalSession {
  * Get a terminal session by ID (used by WS relay in tunnel).
  */
 export declare function getTerminalSession(sessionId: string): TerminalSession | undefined;
+/**
+ * Write data to a terminal session (handles both node-pty and child_process).
+ */
+export declare function writeToTerminalSession(session: TerminalSession, data: string): void;
+/**
+ * Resize a terminal session (only works with node-pty).
+ */
+export declare function resizeTerminalSession(session: TerminalSession, cols: number, rows: number): void;
 /**
  * Attach a real-time listener to a terminal session (for WebSocket relay).
  * Returns a cleanup function to detach.

package/dist/localServer.js

@@ -14,12 +14,22 @@
  */
 import http from 'http';
 import os from 'os';
+import { createRequire } from 'module';
 import { spawn } from 'child_process';
 import { DevServer } from './devServer.js';
 import { FileManager } from './fileManager.js';
 import { Checker } from './checker.js';
 import { ErrorStore, structuredErrorToString } from './errorStore.js';
 import { PackageInstaller } from './packageInstaller.js';
+// ─── Try to load node-pty for real PTY support ─────────────────
+let ptyModule = null;
+try {
+    const _require = createRequire(import.meta.url);
+    ptyModule = _require('node-pty');
+}
+catch {
+    // node-pty not available — will fall back to 'script' PTY wrapper
+}
 const terminalSessions = new Map();
 let sessionCounter = 0;
 function generateSessionId() {
@@ -31,6 +41,30 @@ function generateSessionId() {
 export function getTerminalSession(sessionId) {
     return terminalSessions.get(sessionId);
 }
+/**
+ * Write data to a terminal session (handles both node-pty and child_process).
+ */
+export function writeToTerminalSession(session, data) {
+    if (session.ptyProcess) {
+        session.ptyProcess.write(data);
+    }
+    else if (session.shell) {
+        session.shell.stdin?.write(data);
+    }
+}
+/**
+ * Resize a terminal session (only works with node-pty).
+ */
+export function resizeTerminalSession(session, cols, rows) {
+    session.cols = cols;
+    session.rows = rows;
+    if (session.ptyProcess) {
+        try {
+            session.ptyProcess.resize(cols, rows);
+        }
+        catch { }
+    }
+}
 /**
  * Attach a real-time listener to a terminal session (for WebSocket relay).
  * Returns a cleanup function to detach.
@@ -366,17 +400,50 @@ export class LocalServer {
         const isAiSession = parsed.isAiSession || false;
         // Determine shell
         const shellCmd = process.platform === 'win32' ? 'cmd.exe' : (process.env.SHELL || '/bin/bash');
-        const shell = spawn(shellCmd, [], {
-            cwd: this.options.projectDir,
-            env: { ...process.env, TERM: 'xterm-256color', COLUMNS: String(cols), LINES: String(rows) },
-            stdio: ['pipe', 'pipe', 'pipe'],
-        });
+        const shellEnv = { ...process.env, TERM: 'xterm-256color', COLUMNS: String(cols), LINES: String(rows) };
         sessionCounter++;
         const label = parsed.label || `Terminal ${sessionCounter}`;
+        let shell = null;
+        let ptyProcess = null;
+        // Prefer node-pty for real PTY (interactive shell, echo, prompt, resize)
+        if (ptyModule) {
+            ptyProcess = ptyModule.spawn(shellCmd, [], {
+                name: 'xterm-256color',
+                cols,
+                rows,
+                cwd: this.options.projectDir,
+                env: shellEnv,
+            });
+        }
+        else if (process.platform === 'darwin') {
+            // macOS fallback: use 'script' to allocate a PTY
+            shell = spawn('script', ['-q', '/dev/null', shellCmd], {
+                cwd: this.options.projectDir,
+                env: shellEnv,
+                stdio: ['pipe', 'pipe', 'pipe'],
+            });
+        }
+        else if (process.platform === 'linux') {
+            // Linux fallback: 'script' with -c flag
+            shell = spawn('script', ['-qc', shellCmd, '/dev/null'], {
+                cwd: this.options.projectDir,
+                env: shellEnv,
+                stdio: ['pipe', 'pipe', 'pipe'],
+            });
+        }
+        else {
+            // Windows / other: raw spawn (limited interactivity)
+            shell = spawn(shellCmd, [], {
+                cwd: this.options.projectDir,
+                env: shellEnv,
+                stdio: ['pipe', 'pipe', 'pipe'],
+            });
+        }
         const session = {
             id: sessionId,
             projectId: this.options.projectId,
             shell,
+            ptyProcess,
             outputBuffer: [],
             createdAt: Date.now(),
             lastActivity: Date.now(),
@@ -389,39 +456,22 @@ export class LocalServer {
             dataListeners: new Set(),
             exitListeners: new Set(),
         };
-        shell.stdout?.on('data', (data) => {
-            const str = data.toString('utf-8');
+        // Helper to push output to buffer and notify listeners
+        const pushOutput = (str) => {
             session.outputBuffer.push(str);
             session.lastActivity = Date.now();
-            // Keep buffer capped at ~100KB
             while (session.outputBuffer.length > 500)
                 session.outputBuffer.shift();
-            // Notify real-time listeners (WebSocket relay)
             for (const listener of session.dataListeners) {
                 try {
                     listener(str);
                 }
                 catch { }
             }
-        });
-        shell.stderr?.on('data', (data) => {
-            const str = data.toString('utf-8');
-            session.outputBuffer.push(str);
-            session.lastActivity = Date.now();
-            while (session.outputBuffer.length > 500)
-                session.outputBuffer.shift();
-            // Notify real-time listeners
-            for (const listener of session.dataListeners) {
-                try {
-                    listener(str);
-                }
-                catch { }
-            }
-        });
-        shell.on('exit', (code) => {
+        };
+        const handleExit = (code) => {
             session.exited = true;
             session.exitCode = code;
-            // Notify exit listeners
             for (const listener of session.exitListeners) {
                 try {
                     listener(code);
@@ -429,7 +479,17 @@ export class LocalServer {
                 catch { }
             }
             terminalSessions.delete(sessionId);
-        });
+        };
+        if (ptyProcess) {
+            // node-pty: single onData for combined stdout+stderr
+            ptyProcess.onData((data) => pushOutput(data));
+            ptyProcess.onExit(({ exitCode }) => handleExit(exitCode));
+        }
+        else if (shell) {
+            shell.stdout?.on('data', (data) => pushOutput(data.toString('utf-8')));
+            shell.stderr?.on('data', (data) => pushOutput(data.toString('utf-8')));
+            shell.on('exit', (code) => handleExit(code));
+        }
         terminalSessions.set(sessionId, session);
         // Return format matching frontend TerminalSessionInfo
         this.json(res, {
@@ -467,7 +527,7 @@ export class LocalServer {
             this.json(res, { success: false, error: 'Session not found' });
             return;
         }
-        session.shell.stdin?.write(inputData);
+        writeToTerminalSession(session, inputData);
         session.lastActivity = Date.now();
         this.json(res, { success: true });
     }
@@ -490,10 +550,7 @@ export class LocalServer {
             this.json(res, { success: false, error: 'Session not found' });
             return;
         }
-        session.cols = cols || session.cols;
-        session.rows = rows || session.rows;
-        // For real pty we'd call pty.resize(cols, rows), but for child_process
-        // we just update the env (takes effect on next data)
+        resizeTerminalSession(session, cols || session.cols, rows || session.rows);
         this.json(res, { success: true, cols: session.cols, rows: session.rows });
     }
     // ─── /live/agent-status ──────────────────────────────────────
@@ -502,7 +559,7 @@ export class LocalServer {
             connected: true,
             projectId: this.options.projectId,
             agent: {
-                version: '0.5.2',
+                version: '0.5.3',
                 hostname: os.hostname(),
                 platform: `${os.platform()} ${os.arch()}`,
             },
@@ -625,9 +682,18 @@ export class LocalServer {
     }
     // ─── /live/close ─────────────────────────────────────────────
     async handleClose(_req, res) {
-        // Don't stop the dev server on close — user is still working locally.
-        // Just acknowledge.
-        this.json(res, { success: true, message: 'Acknowledged (agent keeps running)' });
+        // Stop the dev server when user explicitly clicks Stop in the UI.
+        // The frontend only calls /live/close from the Stop button, not on navigation.
+        try {
+            if (this.devServer.isRunning) {
+                await this.devServer.stop();
+            }
+            this.json(res, { success: true, message: 'Dev server stopped' });
+        }
+        catch (err) {
+            res.statusCode = 500;
+            this.json(res, { success: false, error: err.message });
+        }
     }
     // ─── /live/heartbeat ────────────────────────────────────────
     async handleHeartbeat(_req, res) {

package/dist/tunnel.js

@@ -20,7 +20,7 @@ import http from 'http';
 import os from 'os';
 import chalk from 'chalk';
 import { getDeviceId } from './config.js';
-import { getTerminalSession, attachTerminalClient } from './localServer.js';
+import { getTerminalSession, attachTerminalClient, writeToTerminalSession, resizeTerminalSession } from './localServer.js';
 export class TunnelClient {
     ws = null;
     options;
@@ -63,7 +63,7 @@ export class TunnelClient {
                 // Send enhanced agent info with capabilities and deviceId
                 this.send({
                     type: 'agent-info',
-                    version: '0.5.2',
+                    version: '0.5.3',
                     hostname: os.hostname(),
                     platform: `${os.platform()} ${os.arch()}`,
                     deviceId: getDeviceId(),
@@ -215,16 +215,13 @@ export class TunnelClient {
             switch (msg.type) {
                 case 'input':
                     if (typeof msg.data === 'string') {
-                        session.shell.stdin?.write(msg.data);
+                        writeToTerminalSession(session, msg.data);
                         session.lastActivity = Date.now();
                     }
                     break;
                 case 'resize':
                     if (typeof msg.cols === 'number' && typeof msg.rows === 'number') {
-                        session.cols = msg.cols;
-                        session.rows = msg.rows;
-                        // Note: child_process.spawn doesn't support resize natively
-                        // (only node-pty does). We update the stored size for future use.
+                        resizeTerminalSession(session, msg.cols, msg.rows);
                     }
                     break;
             }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nstantpage-agent",
-  "version": "0.5.2",
+  "version": "0.5.3",
   "description": "Local development agent for nstantpage.com — run your projects locally, preview in the cloud. Replaces cloud containers for faster builds.",
   "type": "module",
   "bin": {
@@ -58,5 +58,8 @@
     "@types/ws": "^8.5.10",
     "tsx": "^4.19.0",
     "typescript": "^5.5.0"
+  },
+  "optionalDependencies": {
+    "node-pty": "^1.1.0"
   }
 }