wtt-connect 0.2.53 → 0.2.55

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wtt-connect",
-  "version": "0.2.53",
+  "version": "0.2.55",
   "private": false,
   "description": "WTT-native connector daemon for Codex, Claude Code, Cursor, Gemini, ACP, and other coding agent surfaces.",
   "type": "module",

package/src/main.js

@@ -208,7 +208,8 @@ async function previewPort(config, argv) {
 }
 
 async function assertLocalPreviewPort(port, timeoutMs = 5000) {
-  const url = `http://127.0.0.1:${port}/`;
+  const host = String(process.env.WTT_CONNECT_PREVIEW_CHECK_HOST || '10.0.0.1').trim() || '10.0.0.1';
+  const url = `http://${host}:${port}/`;
   try {
     await fetch(url, {
       method: 'GET',
@@ -216,7 +217,7 @@ async function assertLocalPreviewPort(port, timeoutMs = 5000) {
     });
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
-    throw new Error(`preview-port local server is not reachable at ${url}: ${message}`);
+    throw new Error(`preview-port server is not reachable from the Cloudflare preview network at ${url}. Bind the dev server to 0.0.0.0 instead of 127.0.0.1 or localhost: ${message}`);
   }
 }
 

package/src/runner.js

@@ -939,9 +939,10 @@ function renderCloudSandboxStorageInstruction(config, topicId = '') {
     '- If a generated user-facing file is stored in R2/persistent output storage and should appear in WTT chat, still publish it with `wtt-connect upload-file` or a WTT artifact marker.',
     '- If the user asks for a visual page, HTML artifact, chart, dashboard, animation, or browser preview, build it in the workspace, start a local web server, create a Cloudflare Sandbox preview URL, and return that preview URL to WTT.',
     '- The Cloud Sandbox preview URL feature is only for WTT Cloud Sandbox agents. Do not use WTT backend artifact/media preview flows for live sandbox web servers.',
-    '- Preview servers must keep running after your command finishes. Start them in the background with `nohup ... >/tmp/<name>.log 2>&1 &` or an equivalent long-lived process, and bind to `0.0.0.0`.',
-    '- Before publishing a preview URL, verify the server is actually listening and serving content with `curl -fsS http://127.0.0.1:<port>/ >/dev/null`.',
-    '- If local curl fails, fix or restart the web server first. Never publish a preview URL for a dead port.',
+    '- Preview servers must keep running after your command finishes. Start them in the background with `nohup ... >/tmp/<name>.log 2>&1 &` or an equivalent long-lived process, and bind to `0.0.0.0`, not `127.0.0.1` or `localhost`.',
+    '- For Vite use `npm run dev -- --host 0.0.0.0 --port <port>`; for Next use `next dev -H 0.0.0.0 -p <port>`; for Python use `python3 -m http.server <port> --bind 0.0.0.0`.',
+    '- Before publishing a preview URL, verify the server is reachable from the Cloudflare preview network with `curl -fsS http://10.0.0.1:<port>/ >/dev/null`.',
+    '- If that curl fails, fix or restart the web server first. Never publish a preview URL for a dead or localhost-only port.',
     '- `wtt-connect preview-port` automatically keeps the most recent preview servers for this agent and stops older registered previews beyond the retention limit. Default retention is 3 live previews; use `--keep-last <n>` only when the user asks.',
     '- Do not pass `--snapshot-dir` for normal live previews. Live Cloud Sandbox previews should render as inline WTT preview cards, not as ordinary index.html/document artifacts.',
     '- If the user explicitly asks for a persistent static artifact or downloadable HTML, publish that separately with `wtt-connect upload-artifact --dir <dir> --title "Short Title"` instead of mixing it with the live preview URL.',

package/src/terminal-session.js

@@ -1,11 +1,14 @@
 import os from 'node:os';
 import path from 'node:path';
 import fs from 'node:fs';
+import { fileURLToPath, pathToFileURL } from 'node:url';
 import { createRequire } from 'node:module';
 import { log } from './logger.js';
 
 const require = createRequire(import.meta.url);
+const moduleDir = path.dirname(fileURLToPath(import.meta.url));
 let nodePty = null;
+let nodePtyPackageJson = null;
 
 export class TerminalSessionManager {
   constructor(config, sendJson) {
@@ -31,8 +34,8 @@ export class TerminalSessionManager {
     const rows = clampInt(msg.rows, 10, 80, 28);
 
     try {
-      ensureNodePtyHelperExecutable();
       const pty = await loadNodePty();
+      ensureNodePtyHelperExecutable();
       const proc = pty.spawn(shell, [], {
         name: 'xterm-256color',
         cols,
@@ -122,12 +125,24 @@ export class TerminalSessionManager {
 
 async function loadNodePty() {
   if (nodePty) return nodePty;
-  try {
-    nodePty = await import('node-pty');
-    return nodePty;
-  } catch (err) {
-    throw new Error(`node-pty is not installed or failed to load; terminal sessions are unavailable in this runtime: ${err.message}`);
+  const errors = [];
+  for (const candidate of nodePtyCandidates()) {
+    try {
+      if (candidate.kind === 'require') {
+        nodePty = require(candidate.spec);
+      } else {
+        nodePty = await import(candidate.spec);
+      }
+      nodePtyPackageJson = candidate.packageJson || resolveNodePtyPackageJson(candidate.spec);
+      return nodePty.default && nodePty.default.spawn ? nodePty.default : nodePty;
+    } catch (err) {
+      errors.push(`${candidate.label}: ${err.message}`);
+    }
   }
+
+  throw new Error(
+    `node-pty is not installed or failed to load; terminal sessions are unavailable in this runtime: ${errors.join('; ')}`,
+  );
 }
 
 function resolveDir(dir) {
@@ -153,7 +168,7 @@ function clampInt(value, min, max, fallback) {
 function ensureNodePtyHelperExecutable() {
   if (os.platform() !== 'darwin') return;
   try {
-    const pkg = require.resolve('node-pty/package.json');
+    const pkg = nodePtyPackageJson || resolveNodePtyPackageJson('node-pty');
     const arch = os.arch() === 'arm64' ? 'arm64' : 'x64';
     const helper = path.join(path.dirname(pkg), 'prebuilds', `darwin-${arch}`, 'spawn-helper');
     if (fs.existsSync(helper)) fs.chmodSync(helper, 0o755);
@@ -161,3 +176,73 @@ function ensureNodePtyHelperExecutable() {
     // node-pty may be source-built or installed in a different layout.
   }
 }
+
+function nodePtyCandidates() {
+  const candidates = [
+    { kind: 'import', spec: 'node-pty', label: 'default node resolution', packageJson: null },
+  ];
+
+  for (const root of globalModuleRoots()) {
+    addNodePtyCandidate(candidates, path.join(root, 'node-pty'));
+    addNodePtyCandidate(candidates, path.join(root, '@google', 'gemini-cli', 'node_modules', 'node-pty'));
+  }
+
+  return candidates;
+}
+
+function addNodePtyCandidate(candidates, packageDir) {
+  const packageJson = path.join(packageDir, 'package.json');
+  if (!fs.existsSync(packageJson)) return;
+  candidates.push({
+    kind: 'require',
+    spec: packageDir,
+    label: packageDir,
+    packageJson,
+  });
+  const libIndex = path.join(packageDir, 'lib', 'index.js');
+  if (fs.existsSync(libIndex)) {
+    candidates.push({
+      kind: 'import',
+      spec: pathToFileURL(libIndex).href,
+      label: libIndex,
+      packageJson,
+    });
+  }
+}
+
+function globalModuleRoots() {
+  const roots = new Set();
+  const addRoot = (root) => {
+    if (root && fs.existsSync(root)) roots.add(fs.realpathSync(root));
+  };
+
+  const localRoot = path.resolve(moduleDir, '..', '..');
+  addRoot(localRoot);
+  addRoot(path.join(process.execPath ? path.dirname(path.dirname(process.execPath)) : '', 'lib', 'node_modules'));
+
+  if (process.env.npm_config_prefix) {
+    addRoot(path.join(process.env.npm_config_prefix, 'lib', 'node_modules'));
+  }
+  if (process.env.PREFIX) {
+    addRoot(path.join(process.env.PREFIX, 'lib', 'node_modules'));
+  }
+  if (process.env.HOME) {
+    addRoot(path.join(process.env.HOME, '.local', 'lib', 'node_modules'));
+    addRoot(path.join(process.env.HOME, '.npm-global', 'lib', 'node_modules'));
+  }
+
+  return Array.from(roots);
+}
+
+function resolveNodePtyPackageJson(spec) {
+  try {
+    return require.resolve('node-pty/package.json');
+  } catch {
+    if (spec && spec !== 'node-pty') {
+      const packageDir = spec.endsWith('node-pty') ? spec : path.dirname(path.dirname(fileURLToPath(spec)));
+      const packageJson = path.join(packageDir, 'package.json');
+      if (fs.existsSync(packageJson)) return packageJson;
+    }
+    return null;
+  }
+}