isol8 0.11.1 → 0.11.2

package/README.md

@@ -169,11 +169,13 @@ isol8 serve --update  # Force re-download the server binary
 
 | Flag | Description | Default |
 |------|-------------|---------|
-| `-p, --port <port>` | Port to listen on | `3000` |
+| `-p, --port <port>` | Port to listen on | `--port` > `$ISOL8_PORT` > `$PORT` > `3000` |
 | `-k, --key <key>` | API key for Bearer token auth | `$ISOL8_API_KEY` |
 | `--update` | Force re-download the server binary | `false` |
 | `--debug` | Enable debug logging for server operations | `false` |
 
+If the selected port is already in use, `isol8 serve` now prompts to enter another port or auto-select an available one. In non-interactive environments, it auto-falls back to a free port.
+
 ### `isol8 config`
 
 Display the resolved configuration (merged defaults + config file). Shows the source file, defaults, network rules, cleanup policy, and dependencies.

package/dist/cli.js

@@ -57171,7 +57171,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "isol8",
-    version: "0.11.0",
+    version: "0.11.1",
     description: "Secure code execution engine for AI agents",
     author: "Illusion47586",
     license: "MIT",
@@ -62747,14 +62747,16 @@ program2.command("run").description("Execute code in isol8").argument("[file]",
     process.exit(exitCode);
   }
 });
-program2.command("serve").description("Start the isol8 remote server").option("-p, --port <port>", "Port to listen on", "3000").option("-k, --key <key>", "API key for authentication").option("--update", "Force re-download the server binary").option("--debug", "Enable debug logging").action(async (opts) => {
+program2.command("serve").description("Start the isol8 remote server").option("-p, --port <port>", "Port to listen on").option("-k, --key <key>", "API key for authentication").option("--update", "Force re-download the server binary").option("--debug", "Enable debug logging").action(async (opts) => {
   const apiKey = opts.key ?? process.env.ISOL8_API_KEY;
   if (!apiKey) {
     console.error("[ERR] API key required. Use --key or ISOL8_API_KEY env var.");
     process.exit(1);
   }
-  const port = Number.parseInt(opts.port, 10);
-  logger.debug(`[Serve] Port: ${port}`);
+  const requestedPort = resolveServePort(opts.port);
+  const port = await resolveAvailableServePort(requestedPort);
+  logger.debug(`[Serve] Requested port: ${requestedPort}`);
+  logger.debug(`[Serve] Using port: ${port}`);
   logger.debug(`[Serve] API key: ${"*".repeat(apiKey.length)}`);
   if (typeof globalThis.Bun !== "undefined") {
     logger.debug("[Serve] Running under Bun, starting server in-process");
@@ -62861,6 +62863,11 @@ async function downloadServerBinary(binaryPath) {
   }
 }
 async function promptYesNo(question) {
+  const answer = await promptText(question);
+  const normalized = answer.trim().toLowerCase();
+  return normalized === "" || normalized === "y" || normalized === "yes";
+}
+async function promptText(question) {
   const readline = await import("node:readline");
   const rl = readline.createInterface({
     input: process.stdin,
@@ -62870,8 +62877,103 @@ async function promptYesNo(question) {
     rl.question(question, resolve3);
   });
   rl.close();
-  const normalized = answer.trim().toLowerCase();
-  return normalized === "" || normalized === "y" || normalized === "yes";
+  return answer;
+}
+function parsePort(raw2, source) {
+  const parsed = Number(raw2);
+  if (!Number.isInteger(parsed) || parsed < 1 || parsed > 65535) {
+    console.error(`[ERR] Invalid port from ${source}: ${raw2}. Expected 1-65535.`);
+    process.exit(1);
+  }
+  return parsed;
+}
+function resolveServePort(portFlag) {
+  if (typeof portFlag === "string") {
+    return parsePort(portFlag, "--port");
+  }
+  if (process.env.ISOL8_PORT) {
+    return parsePort(process.env.ISOL8_PORT, "ISOL8_PORT");
+  }
+  if (process.env.PORT) {
+    return parsePort(process.env.PORT, "PORT");
+  }
+  return 3000;
+}
+async function isPortAvailable(port) {
+  const { createServer: createServer2 } = await import("node:net");
+  return await new Promise((resolve3) => {
+    const server = createServer2();
+    server.once("error", () => {
+      resolve3(false);
+    });
+    server.once("listening", () => {
+      server.close(() => resolve3(true));
+    });
+    server.listen(port);
+  });
+}
+async function findAvailablePort() {
+  const { createServer: createServer2 } = await import("node:net");
+  return await new Promise((resolve3, reject) => {
+    const server = createServer2();
+    server.once("error", reject);
+    server.once("listening", () => {
+      const address = server.address();
+      if (!address || typeof address === "string") {
+        server.close(() => reject(new Error("Failed to determine available port")));
+        return;
+      }
+      server.close((closeErr) => {
+        if (closeErr) {
+          reject(closeErr);
+          return;
+        }
+        resolve3(address.port);
+      });
+    });
+    server.listen(0);
+  });
+}
+async function resolveAvailableServePort(port) {
+  if (await isPortAvailable(port)) {
+    return port;
+  }
+  if (!(process.stdin.isTTY && process.stdout.isTTY)) {
+    const autoPort = await findAvailablePort();
+    console.warn(`[WARN] Port ${port} is in use. Falling back to available port ${autoPort}.`);
+    return autoPort;
+  }
+  let candidate = port;
+  while (true) {
+    console.warn(`[WARN] Port ${candidate} is already in use.`);
+    const choice = (await promptText("Choose: [1] Enter another port  [2] Find an available port  [3] Exit (default: 2): ")).trim().toLowerCase();
+    if (choice === "" || choice === "2") {
+      const autoPort = await findAvailablePort();
+      console.log(`[INFO] Using available port ${autoPort}`);
+      return autoPort;
+    }
+    if (choice === "1") {
+      const rawPort = (await promptText("Enter port (1-65535): ")).trim();
+      if (!rawPort) {
+        continue;
+      }
+      const parsed = Number(rawPort);
+      if (!Number.isInteger(parsed) || parsed < 1 || parsed > 65535) {
+        console.error(`[ERR] Invalid port: ${rawPort}. Expected 1-65535.`);
+        continue;
+      }
+      candidate = parsed;
+      if (await isPortAvailable(candidate)) {
+        return candidate;
+      }
+      continue;
+    }
+    if (choice === "3") {
+      console.error("[ERR] Server startup cancelled.");
+      process.exit(1);
+    }
+    console.error("[ERR] Invalid selection. Enter 1, 2, or 3.");
+  }
 }
 async function ensureServerBinary(forceUpdate) {
   const binDir = join4(homedir2(), ".isol8", "bin");
@@ -63240,4 +63342,4 @@ if (!process.argv.slice(2).length) {
 }
 program2.parse();
 
-//# debugId=6B3AFECE6CC836BD64756E2164756E21
+//# debugId=33A00A6A263B687D64756E2164756E21

package/dist/index.js

@@ -2349,7 +2349,7 @@ init_logger();
 // package.json
 var package_default = {
   name: "isol8",
-  version: "0.11.0",
+  version: "0.11.1",
   description: "Secure code execution engine for AI agents",
   author: "Illusion47586",
   license: "MIT",
@@ -2717,4 +2717,4 @@ export {
   BunAdapter
 };
 
-//# debugId=C48E982CAC86EB5964756E2164756E21
+//# debugId=E6910E46B07952A064756E2164756E21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "isol8",
-  "version": "0.11.1",
+  "version": "0.11.2",
   "description": "Secure code execution engine for AI agents",
   "author": "Illusion47586",
   "license": "MIT",