plazbot-cli 0.3.2 → 0.3.3

package/dist/studio/runRepl.js

@@ -6,6 +6,12 @@ import { dirname, join } from 'node:path';
 import { App } from './components/App.js';
 import { getStoredCredentials } from '../utils/credentials.js';
 import { logger } from '../utils/logger.js';
+// Alternate screen buffer (ANSI). Same trick used by vim, htop, claude code, lazygit.
+// The TUI runs in a clean canvas and the original scrollback is restored on exit,
+// which eliminates the "ghost frames" Ink leaves behind when the terminal is resized.
+const ALT_SCREEN_ENTER = '\x1b[?1049h\x1b[H';
+const ALT_SCREEN_EXIT = '\x1b[?1049l';
+const SHOW_CURSOR = '\x1b[?25h';
 export async function runRepl(opts) {
     let creds;
     try {
@@ -30,6 +36,31 @@ export async function runRepl(opts) {
         dev: opts.dev,
     };
     const version = readVersion();
+    const useAltScreen = !!process.stdout.isTTY;
+    // Cleanup idempotente; lo registramos en varias señales para que la terminal
+    // nunca quede en alt screen ni con el cursor oculto si el proceso muere mal.
+    let cleanedUp = false;
+    const restoreTerminal = () => {
+        if (cleanedUp)
+            return;
+        cleanedUp = true;
+        if (useAltScreen) {
+            process.stdout.write(ALT_SCREEN_EXIT);
+            process.stdout.write(SHOW_CURSOR);
+        }
+    };
+    if (useAltScreen) {
+        process.stdout.write(ALT_SCREEN_ENTER);
+    }
+    process.on('exit', restoreTerminal);
+    process.on('SIGHUP', restoreTerminal);
+    process.on('SIGTERM', restoreTerminal);
+    process.on('uncaughtException', (err) => {
+        restoreTerminal();
+        // Re-emit so node prints the trace after restoring the terminal.
+        console.error(err);
+        process.exit(1);
+    });
     const { waitUntilExit } = render(_jsx(App, { version: version, stream: stream, initialAgentId: opts.agentId ?? null, dev: opts.dev, supportMode: supportMode }), {
         exitOnCtrlC: false,
     });
@@ -37,7 +68,12 @@ export async function runRepl(opts) {
     process.on('SIGINT', () => {
         // no-op aquí; App.tsx llama exit() al detectar Ctrl+C.
     });
-    await waitUntilExit();
+    try {
+        await waitUntilExit();
+    }
+    finally {
+        restoreTerminal();
+    }
 }
 function readVersion() {
     try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "plazbot-cli",
-  "version": "0.3.2",
+  "version": "0.3.3",
   "description": "CLI para Plazbot SDK",
   "type": "module",
   "main": "dist/cli.js",

package/src/studio/runRepl.tsx

@@ -15,6 +15,13 @@ interface RunReplOptions {
   workspaceOverride?: string;
 }
 
+// Alternate screen buffer (ANSI). Same trick used by vim, htop, claude code, lazygit.
+// The TUI runs in a clean canvas and the original scrollback is restored on exit,
+// which eliminates the "ghost frames" Ink leaves behind when the terminal is resized.
+const ALT_SCREEN_ENTER = '\x1b[?1049h\x1b[H';
+const ALT_SCREEN_EXIT = '\x1b[?1049l';
+const SHOW_CURSOR = '\x1b[?25h';
+
 export async function runRepl(opts: RunReplOptions): Promise<void> {
   let creds;
   try {
@@ -42,6 +49,32 @@ export async function runRepl(opts: RunReplOptions): Promise<void> {
   };
 
   const version = readVersion();
+  const useAltScreen = !!process.stdout.isTTY;
+
+  // Cleanup idempotente; lo registramos en varias señales para que la terminal
+  // nunca quede en alt screen ni con el cursor oculto si el proceso muere mal.
+  let cleanedUp = false;
+  const restoreTerminal = () => {
+    if (cleanedUp) return;
+    cleanedUp = true;
+    if (useAltScreen) {
+      process.stdout.write(ALT_SCREEN_EXIT);
+      process.stdout.write(SHOW_CURSOR);
+    }
+  };
+
+  if (useAltScreen) {
+    process.stdout.write(ALT_SCREEN_ENTER);
+  }
+  process.on('exit', restoreTerminal);
+  process.on('SIGHUP', restoreTerminal);
+  process.on('SIGTERM', restoreTerminal);
+  process.on('uncaughtException', (err) => {
+    restoreTerminal();
+    // Re-emit so node prints the trace after restoring the terminal.
+    console.error(err);
+    process.exit(1);
+  });
 
   const { waitUntilExit } = render(
     <App
@@ -61,7 +94,11 @@ export async function runRepl(opts: RunReplOptions): Promise<void> {
     // no-op aquí; App.tsx llama exit() al detectar Ctrl+C.
   });
 
-  await waitUntilExit();
+  try {
+    await waitUntilExit();
+  } finally {
+    restoreTerminal();
+  }
 }
 
 function readVersion(): string {