@tlbx-ai/midterm 8.2.3 → 8.2.4

package/README.md

@@ -31,6 +31,6 @@ Notes:
 
 - Default channel is `stable`
 - If you do not pass `--bind`, the launcher forces `127.0.0.1`
-- If you do not pass `--port`, the launcher opens `https://127.0.0.1:2000`
+- If you do not pass `--port`, the launcher starts at `https://127.0.0.1:2000` and automatically moves to the next free port if `2000` is unavailable
 - The launcher sets `MIDTERM_LAUNCH_MODE=npx` for the child process
 - If you invoke `npx` from WSL but it resolves to Windows `node/npm`, the launcher detects the WSL working directory and runs the Linux MidTerm build inside that distro

package/bin/midterm.js

@@ -5,12 +5,14 @@
 const fs = require('node:fs');
 const fsp = require('node:fs/promises');
 const https = require('node:https');
+const net = require('node:net');
 const os = require('node:os');
 const path = require('node:path');
 const { spawn, spawnSync } = require('node:child_process');
 
 const { version: PACKAGE_VERSION } = require('../package.json');
 const DEFAULT_PORT = 2000;
+const MAX_PORT_SCAN_ATTEMPTS = 100;
 const SERVER_READY_TIMEOUT_MS = 15000;
 const SERVER_READY_INTERVAL_MS = 500;
 const REPO_OWNER = 'tlbx-ai';
@@ -33,14 +35,30 @@ async function main() {
     : await ensureInstalledRelease(release, target);
 
   const childArgs = passthrough.slice();
+  const hasExplicitPort = hasArg(childArgs, '--port');
   const explicitBind = getArgValue(childArgs, '--bind');
   const explicitPort = parsePortArg(getArgValue(childArgs, '--port'));
+  const effectiveBind = explicitBind ?? '127.0.0.1';
+  const startsServer = shouldStartServer(childArgs);
+
+  let effectivePort = explicitPort ?? DEFAULT_PORT;
 
   if (!explicitBind) {
     childArgs.push('--bind', '127.0.0.1');
   }
 
-  const browserUrl = buildBrowserUrl(explicitBind ?? '127.0.0.1', explicitPort ?? DEFAULT_PORT);
+  if (startsServer && !hasExplicitPort) {
+    effectivePort = await findAvailablePort(effectiveBind, DEFAULT_PORT);
+    childArgs.push('--port', String(effectivePort));
+
+    if (effectivePort !== DEFAULT_PORT) {
+      console.error(`@tlbx-ai/midterm: port ${DEFAULT_PORT} is unavailable, using ${effectivePort}`);
+    }
+  }
+
+  const browserUrl = startsServer
+    ? buildBrowserUrl(effectiveBind, effectivePort)
+    : null;
   const childEnv = {
     ...process.env,
     MIDTERM_LAUNCH_MODE: 'npx',
@@ -57,7 +75,7 @@ async function main() {
         env: childEnv
       });
 
-  if (launcher.openBrowser) {
+  if (launcher.openBrowser && browserUrl) {
     void openBrowserWhenReady(browserUrl);
   }
 
@@ -148,7 +166,7 @@ async function detectWslInteropContext() {
     return null;
   }
 
-  const parsed = parseWslUncPath(process.cwd());
+  const parsed = findWslInteropPath();
   if (!parsed) {
     return null;
   }
@@ -170,6 +188,32 @@ async function detectWslInteropContext() {
   };
 }
 
+function findWslInteropPath() {
+  const candidates = [
+    process.cwd(),
+    process.env.INIT_CWD,
+    process.env.npm_config_local_prefix,
+    getPackageDirectory(process.env.npm_package_json)
+  ];
+
+  for (const candidate of candidates) {
+    const parsed = parseWslUncPath(candidate);
+    if (parsed) {
+      return parsed;
+    }
+  }
+
+  return null;
+}
+
+function getPackageDirectory(packageJsonPath) {
+  if (!packageJsonPath) {
+    return '';
+  }
+
+  return path.win32.dirname(packageJsonPath);
+}
+
 function parseWslUncPath(value) {
   const normalized = String(value || '');
   const match = normalized.match(/^\\\\wsl(?:\.localhost|\$)\\([^\\]+)(\\.*)?$/i);
@@ -476,6 +520,68 @@ function parsePortArg(value) {
   return parsed;
 }
 
+function shouldStartServer(args) {
+  const nonServerFlags = [
+    '--check-update',
+    '--update',
+    '--apply-update',
+    '--version',
+    '-v',
+    '--help',
+    '-h',
+    '--hash-password',
+    '--write-secret',
+    '--generate-cert'
+  ];
+
+  return !nonServerFlags.some((flag) => hasArg(args, flag));
+}
+
+async function findAvailablePort(bindAddress, preferredPort) {
+  for (let offset = 0; offset < MAX_PORT_SCAN_ATTEMPTS; offset++) {
+    const port = preferredPort + offset;
+    if (port > 65535) {
+      break;
+    }
+
+    if (await isPortAvailable(bindAddress, port)) {
+      return port;
+    }
+  }
+
+  throw new Error(`Could not find a free port starting at ${preferredPort}`);
+}
+
+function isPortAvailable(bindAddress, port) {
+  const host = normalizeBindForNetProbe(bindAddress);
+
+  return new Promise((resolve) => {
+    const server = net.createServer();
+
+    server.once('error', (error) => {
+      if (error && (error.code === 'EADDRINUSE' || error.code === 'EACCES')) {
+        resolve(false);
+        return;
+      }
+
+      resolve(false);
+    });
+
+    server.listen(port, host, () => {
+      server.close(() => resolve(true));
+    });
+  });
+}
+
+function normalizeBindForNetProbe(bindAddress) {
+  const raw = String(bindAddress || '').trim();
+  if (!raw || raw === 'localhost') {
+    return '127.0.0.1';
+  }
+
+  return raw.replace(/^\[(.*)\]$/, '$1');
+}
+
 function buildBrowserUrl(bindAddress, port) {
   const normalized = normalizeHostForBrowser(bindAddress);
   return `https://${normalized}:${port}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tlbx-ai/midterm",
-  "version": "8.2.3",
+  "version": "8.2.4",
   "description": "Launch MidTerm via npx by downloading the native binary for your platform",
   "license": "AGPL-3.0-only",
   "repository": {