@tlbx-ai/midterm 0.1.0 → 8.2.1

package/README.md

@@ -6,7 +6,7 @@ Launch MidTerm through `npx`.
 npx @tlbx-ai/midterm
 ```
 
-The launcher downloads the native MidTerm release for your platform, caches it in your user profile, and runs it locally.
+The launcher downloads the native MidTerm release for your platform, caches it in your user profile, runs it locally, and opens MidTerm in your default browser.
 
 Supported platforms:
 
@@ -24,10 +24,12 @@ npx @tlbx-ai/midterm -- --port 2001 --bind 127.0.0.1
 Launcher-only options:
 
 - `--channel stable|dev`
+- `--no-browser`
 - `--help-launcher`
 
 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`
 - The launcher sets `MIDTERM_LAUNCH_MODE=npx` for the child process

package/bin/midterm.js

@@ -4,11 +4,15 @@
 
 const fs = require('node:fs');
 const fsp = require('node:fs/promises');
+const https = require('node:https');
 const os = require('node:os');
 const path = require('node:path');
 const { spawn, spawnSync } = require('node:child_process');
 
-const PACKAGE_VERSION = '0.1.0';
+const { version: PACKAGE_VERSION } = require('../package.json');
+const DEFAULT_PORT = 2000;
+const SERVER_READY_TIMEOUT_MS = 15000;
+const SERVER_READY_INTERVAL_MS = 500;
 const REPO_OWNER = 'tlbx-ai';
 const REPO_NAME = 'MidTerm';
 const GITHUB_API = `https://api.github.com/repos/${REPO_OWNER}/${REPO_NAME}`;
@@ -32,10 +36,14 @@ async function main() {
   }
 
   const childArgs = passthrough.slice();
-  if (!hasArg(childArgs, '--bind')) {
+  const explicitBind = getArgValue(childArgs, '--bind');
+  const explicitPort = parsePortArg(getArgValue(childArgs, '--port'));
+
+  if (!explicitBind) {
     childArgs.push('--bind', '127.0.0.1');
   }
 
+  const browserUrl = buildBrowserUrl(explicitBind ?? '127.0.0.1', explicitPort ?? DEFAULT_PORT);
   const childEnv = {
     ...process.env,
     MIDTERM_LAUNCH_MODE: 'npx',
@@ -49,6 +57,10 @@ async function main() {
     env: childEnv
   });
 
+  if (launcher.openBrowser) {
+    void openBrowserWhenReady(browserUrl);
+  }
+
   forwardSignal(child, 'SIGINT');
   forwardSignal(child, 'SIGTERM');
   forwardSignal(child, 'SIGHUP');
@@ -66,7 +78,8 @@ async function main() {
 function parseArgs(args) {
   const launcher = {
     help: false,
-    channel: 'stable'
+    channel: 'stable',
+    openBrowser: true
   };
   const passthrough = [];
 
@@ -83,6 +96,11 @@ function parseArgs(args) {
       continue;
     }
 
+    if (arg === '--no-browser') {
+      launcher.openBrowser = false;
+      continue;
+    }
+
     if (arg === '--channel') {
       const value = args[i + 1];
       if (value !== 'stable' && value !== 'dev') {
@@ -106,6 +124,7 @@ function printHelp() {
   console.log('');
   console.log('Launcher options:');
   console.log('  --channel stable|dev  Choose the release channel (default: stable)');
+  console.log('  --no-browser          Do not auto-open MidTerm in the default browser');
   console.log('  --help-launcher       Show launcher help');
   console.log('');
   console.log('All other arguments are passed to mt.');
@@ -295,6 +314,127 @@ function hasArg(args, name) {
   return args.some((arg) => arg === name || arg.startsWith(`${name}=`));
 }
 
+function getArgValue(args, name) {
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    if (arg === name) {
+      return args[i + 1];
+    }
+    if (arg.startsWith(`${name}=`)) {
+      return arg.slice(name.length + 1);
+    }
+  }
+
+  return undefined;
+}
+
+function parsePortArg(value) {
+  if (!value) {
+    return undefined;
+  }
+
+  const parsed = Number.parseInt(value, 10);
+  if (!Number.isInteger(parsed) || parsed < 1 || parsed > 65535) {
+    return undefined;
+  }
+
+  return parsed;
+}
+
+function buildBrowserUrl(bindAddress, port) {
+  const normalized = normalizeHostForBrowser(bindAddress);
+  return `https://${normalized}:${port}`;
+}
+
+function normalizeHostForBrowser(bindAddress) {
+  const raw = String(bindAddress || '').trim();
+  if (!raw || raw === '0.0.0.0' || raw === '::' || raw === '[::]') {
+    return '127.0.0.1';
+  }
+
+  const host = raw.replace(/^\[(.*)\]$/, '$1');
+  if (host.includes(':')) {
+    return `[${host}]`;
+  }
+
+  return host;
+}
+
+async function openBrowserWhenReady(url) {
+  const ready = await waitForServer(url, SERVER_READY_TIMEOUT_MS);
+  if (!ready) {
+    console.error(`@tlbx-ai/midterm: server did not become ready within ${SERVER_READY_TIMEOUT_MS}ms, opening browser anyway`);
+  }
+
+  openUrl(url);
+}
+
+async function waitForServer(url, timeoutMs) {
+  const deadline = Date.now() + timeoutMs;
+
+  while (Date.now() < deadline) {
+    if (await probeUrl(url)) {
+      return true;
+    }
+
+    await sleep(SERVER_READY_INTERVAL_MS);
+  }
+
+  return false;
+}
+
+function probeUrl(url) {
+  return new Promise((resolve) => {
+    const request = https.request(url, {
+      method: 'GET',
+      rejectUnauthorized: false,
+      timeout: SERVER_READY_INTERVAL_MS
+    }, (response) => {
+      response.resume();
+      resolve(true);
+    });
+
+    request.on('error', () => resolve(false));
+    request.on('timeout', () => {
+      request.destroy();
+      resolve(false);
+    });
+    request.end();
+  });
+}
+
+function sleep(ms) {
+  return new Promise((resolve) => {
+    setTimeout(resolve, ms);
+  });
+}
+
+function openUrl(url) {
+  let command;
+  let args;
+
+  if (process.platform === 'win32') {
+    command = 'cmd';
+    args = ['/c', 'start', '', url];
+  } else if (process.platform === 'darwin') {
+    command = 'open';
+    args = [url];
+  } else {
+    command = 'xdg-open';
+    args = [url];
+  }
+
+  const result = spawn(command, args, {
+    detached: true,
+    stdio: 'ignore',
+    windowsHide: true
+  });
+  result.on('error', (error) => {
+    console.error(`@tlbx-ai/midterm: failed to open browser automatically: ${error.message}`);
+  });
+  result.unref();
+}
+
 function forwardSignal(child, signal) {
   process.on(signal, () => {
     if (!child.killed) {

package/package.json

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