icoa-cli 2.19.331 → 2.19.332

package/dist/lib/interactive-spawn.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Run an interactive child process (nc / ncat / ssh) with the terminal fully
+ * released so the user's INPUT and Ctrl-C reach the child.
+ *
+ * Why this exists (BUG: pwn `connect` could read output but not send input and
+ * Ctrl-C was dead): when dispatched IN-PROCESS from the icoa REPL, the main
+ * readline holds stdin in RAW mode. A child spawned with `stdio: 'inherit'`
+ * then inherits a raw, non-blocking stdin → its reads see no keystrokes, and
+ * raw mode means Ctrl-C is delivered as a byte (0x03), never as SIGINT → the
+ * session looks frozen and won't quit. `execSync`/`execFileSync` never dropped
+ * raw mode, which is the bug.
+ *
+ * This mirrors repl.ts `runSystemCommand`'s proven TTY dance (pause the rl +
+ * `setRawMode(false)` + async spawn + restore), but pulls the active REPL
+ * readline via getMainRl() so it works BOTH inside the REPL and standalone
+ * (`icoa connect …`, where getMainRl() === null → pause/restore are no-ops).
+ *
+ * Pass a file + args (no shell — injection-safe, preferred for server-supplied
+ * host/port) OR set `shell: true` to run `file` as a full command string.
+ *
+ * Resolves with the child's exit code (1 on spawn error).
+ */
+export declare function runInteractive(file: string, args?: string[], opts?: {
+    shell?: boolean;
+}): Promise<number>;

package/dist/lib/interactive-spawn.js

@@ -0,0 +1 @@
+import{spawn as e}from"node:child_process";import{getMainRl as t}from"./main-rl.js";export function runInteractive(o,s=[],i={}){return new Promise(r=>{const n=t(),c=process.stdin,a=!!c.isTTY&&!!c.isRaw;if(n?.pause(),c.isTTY&&"function"==typeof c.setRawMode)try{c.setRawMode(!1)}catch{}const f=i.shell?e(o,{shell:!0,stdio:"inherit"}):e(o,s,{stdio:"inherit"});let d=!1;const l=e=>{if(!d){if(d=!0,c.isTTY&&"function"==typeof c.setRawMode&&a)try{c.setRawMode(!0)}catch{}n?.resume(),r(e)}};f.on("close",e=>l(e??0)),f.on("error",()=>l(1))})}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "icoa-cli",
-  "version": "2.19.331",
+  "version": "2.19.332",
   "description": "ICOA CLI — The world's first CLI-native cyber & AI security olympiad terminal: AI4CTF (Day 1), CTF4AI (Day 2), VLA4CTF (Pioneer Round — embodied AI)",
   "type": "module",
   "bin": {