wtt-connect 0.2.54 → 0.2.56

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wtt-connect",
-  "version": "0.2.54",
+  "version": "0.2.56",
   "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

@@ -149,7 +149,8 @@ Commands:
                                   Alias for upload-artifact
   preview-port --port <port> [--topic-id <id>] [--snapshot-dir <dir>]
                                   Create a Cloud Sandbox live preview URL; snapshots are opt-in
-  cleanup-previews                Stop preview servers previously registered by this agent
+  cleanup-previews [--keep-last <n>]
+                                  Stop preview servers previously registered by this agent
   help                           Show this help
 `);
 }
@@ -160,11 +161,7 @@ async function previewPort(config, argv) {
     throw new Error('preview-port requires --port <1024-65535>, excluding 3000');
   }
   await assertLocalPreviewPort(port, Number(argv.portCheckTimeout || argv.timeout || 5000));
-  const keepLast = previewKeepLast(config, argv);
-  const cleanup = cleanupOldPreviews(config, {
-    currentPort: port,
-    keepLast: Math.max(0, keepLast - 1),
-  });
+  const cleanup = { stopped: [], kept: readPreviewRegistry(config).map((entry) => ({ port: Number(entry.port), url: entry.url || '' })) };
   const preview = await createSandboxPreviewFromOutbox(config, port, {
     name: String(argv.previewName || argv.title || '').trim(),
     token: String(argv.previewToken || '').trim(),
@@ -208,7 +205,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 +214,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}`);
   }
 }
 
@@ -279,11 +277,6 @@ async function cleanupPreviewsCommand(config, argv) {
   console.log(JSON.stringify({ ok: true, cleanup }, null, 2));
 }
 
-function previewKeepLast(config, argv = {}) {
-  if (Number.isFinite(Number(argv.keepLast))) return Math.max(0, Number(argv.keepLast));
-  return Math.max(0, Number(config.previewKeepLast ?? 3) || 0);
-}
-
 function cleanupOldPreviews(config, { currentPort = 0, keepLast = 0 } = {}) {
   const registry = readPreviewRegistry(config);
   const entries = registry

package/src/runner.js

@@ -939,10 +939,11 @@ 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.',
-    '- `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.',
+    '- 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` must not stop older preview servers. WTT Web closes a live preview only when the user clicks the preview card X, or when `wtt-connect cleanup-previews` is explicitly requested.',
     '- 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.',
     '- If you start a web server in the sandbox and the user should preview it, call the Cloudflare Sandbox outbound Worker directly with curl and include the returned `preview_url` in your reply as `[preview_url:Short Title](<preview_url>)`.',