helix-assistant-cli 0.2.13 → 0.2.14

package/dist/client/agent-launcher.d.ts

@@ -16,10 +16,6 @@ export declare function probePort(port: number, host?: string, timeoutMs?: numbe
  *   'closed': Connection refused / port closed
  */
 export declare function probeWebSocketAuth(port?: number, token?: string, host?: string, timeoutMs?: number): Promise<'ready' | 'unauthorized' | 'closed'>;
-/**
- * Terminates any rogue or orphaned process occupying the specified port.
- */
-export declare function killProcessOnPort(port?: number): void;
 /**
  * Waits until the agent service has completed startup and successfully accepts WebSocket authentication.
  */

package/dist/client/agent-launcher.js

@@ -11,7 +11,6 @@ exports.findPythonAgentScript = findPythonAgentScript;
 exports.findPythonExecutable = findPythonExecutable;
 exports.probePort = probePort;
 exports.probeWebSocketAuth = probeWebSocketAuth;
-exports.killProcessOnPort = killProcessOnPort;
 exports.waitForAgentReady = waitForAgentReady;
 exports.spawnAgentDaemon = spawnAgentDaemon;
 const child_process_1 = require("child_process");
@@ -231,24 +230,6 @@ function probeWebSocketAuth(port = 8765, token, host = '127.0.0.1', timeoutMs =
         });
     });
 }
-/**
- * Terminates any rogue or orphaned process occupying the specified port.
- */
-function killProcessOnPort(port = 8765) {
-    try {
-        if (process.platform === 'win32') {
-            (0, child_process_1.execSync)(`powershell -NoProfile -Command "$conn = Get-NetTCPConnection -LocalPort ${port} -State Listen -ErrorAction SilentlyContinue; if ($conn) { Stop-Process -Id $conn.OwningProcess -Force -ErrorAction SilentlyContinue }"`, { stdio: 'ignore', windowsHide: true });
-        }
-        else {
-            (0, child_process_1.execSync)(`fuser -k ${port}/tcp || lsof -ti tcp:${port} | xargs kill -9`, {
-                stdio: 'ignore',
-            });
-        }
-    }
-    catch {
-        // Ignore errors
-    }
-}
 /**
  * Waits until the agent service has completed startup and successfully accepts WebSocket authentication.
  */
@@ -289,10 +270,11 @@ async function spawnAgentDaemon(port = 8765) {
     if (currentStatus === 'ready') {
         return { success: true };
     }
-    // 2. If port is occupied by an unauthorized process, clean it up
     if (currentStatus === 'unauthorized') {
-        killProcessOnPort(port);
-        await new Promise((resolve) => setTimeout(resolve, 500));
+        return {
+            success: false,
+            error: `El puerto ${port} ya lo usa un agente HELIX que requiere otro token. Cierra esa instancia o inicia el CLI con --token.`,
+        };
     }
     if (isAgentProcessRunning() || isAgentStarting()) {
         return { success: true };
@@ -310,7 +292,7 @@ async function spawnAgentDaemon(port = 8765) {
     try {
         const child = (0, child_process_1.spawn)(pythonExec, ['main.py', '--ws-port', String(port), '--no-camera'], {
             cwd: agentDir,
-            detached: true,
+            detached: process.platform !== 'win32',
             stdio: 'ignore', // run completely in background
             windowsHide: true,
             env: {

package/dist/index.js

@@ -70,7 +70,7 @@ const program = new commander_1.Command();
 program
     .name('helix')
     .description('HELIX - Interactive Terminal CLI for Windows AI Desktop Agent')
-    .version('0.2.13')
+    .version('0.2.14')
     .option('-u, --ws-url <url>', 'URL del servidor WebSocket del agente', (0, env_1.getWsUrl)())
     .option('-t, --token <token>', 'Token de autenticación WebSocket de HELIX', (0, env_1.getWsToken)())
     .option('--plain', 'Desactivar formato enriquecido de Markdown y mostrar texto plano sin asteriscos')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "helix-assistant-cli",
-  "version": "0.2.13",
+  "version": "0.2.14",
   "description": "HELIX - Interactive Terminal CLI for Windows AI Desktop Agent",
   "private": false,
   "publishConfig": {

package/src/client/agent-launcher.ts

@@ -1,4 +1,4 @@
-import { spawn, ChildProcess, execSync } from 'child_process';
+import { spawn, ChildProcess } from 'child_process';
 import path from 'path';
 import fs from 'fs';
 import crypto from 'crypto';
@@ -240,26 +240,6 @@ export function probeWebSocketAuth(
   });
 }
 
-/**
- * Terminates any rogue or orphaned process occupying the specified port.
- */
-export function killProcessOnPort(port: number = 8765): void {
-  try {
-    if (process.platform === 'win32') {
-      execSync(
-        `powershell -NoProfile -Command "$conn = Get-NetTCPConnection -LocalPort ${port} -State Listen -ErrorAction SilentlyContinue; if ($conn) { Stop-Process -Id $conn.OwningProcess -Force -ErrorAction SilentlyContinue }"`,
-        { stdio: 'ignore', windowsHide: true }
-      );
-    } else {
-      execSync(`fuser -k ${port}/tcp || lsof -ti tcp:${port} | xargs kill -9`, {
-        stdio: 'ignore',
-      });
-    }
-  } catch {
-    // Ignore errors
-  }
-}
-
 /**
  * Waits until the agent service has completed startup and successfully accepts WebSocket authentication.
  */
@@ -313,10 +293,11 @@ export async function spawnAgentDaemon(port: number = 8765): Promise<{ success:
     return { success: true };
   }
 
-  // 2. If port is occupied by an unauthorized process, clean it up
   if (currentStatus === 'unauthorized') {
-    killProcessOnPort(port);
-    await new Promise((resolve) => setTimeout(resolve, 500));
+    return {
+      success: false,
+      error: `El puerto ${port} ya lo usa un agente HELIX que requiere otro token. Cierra esa instancia o inicia el CLI con --token.`,
+    };
   }
 
   if (isAgentProcessRunning() || isAgentStarting()) {
@@ -341,7 +322,7 @@ export async function spawnAgentDaemon(port: number = 8765): Promise<{ success:
       ['main.py', '--ws-port', String(port), '--no-camera'],
       {
         cwd: agentDir,
-        detached: true,
+        detached: process.platform !== 'win32',
         stdio: 'ignore', // run completely in background
         windowsHide: true,
         env: {

package/src/index.ts

@@ -73,7 +73,7 @@ const program = new Command();
 program
   .name('helix')
   .description('HELIX - Interactive Terminal CLI for Windows AI Desktop Agent')
-  .version('0.2.13')
+  .version('0.2.14')
   .option('-u, --ws-url <url>', 'URL del servidor WebSocket del agente', getWsUrl())
   .option('-t, --token <token>', 'Token de autenticación WebSocket de HELIX', getWsToken())
   .option('--plain', 'Desactivar formato enriquecido de Markdown y mostrar texto plano sin asteriscos')