wtt-connect 0.2.56 → 0.2.58

package/package.json

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

package/src/runner.js

@@ -939,17 +939,15 @@ 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`, 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.',
+    '- Preview servers are managed by the Cloudflare Sandbox Worker, not by WTT backend and not by `wtt-connect preview-port`.',
+    '- Each sandbox has one fixed live preview slot on port 5173. To create or replace a preview, call the Worker outbox `/preview/start` with a command and cwd. The Worker stops the old port-5173 dev server, starts the new one, checks reachability, exposes it publicly, and returns `preview_url`.',
+    '- The preview start command must bind to `0.0.0.0`, not `127.0.0.1` or `localhost`. The Worker auto-adds common Vite/Next/Python host flags when safe, but you should still provide explicit host flags.',
+    '- For Vite use command `npm run dev -- --host 0.0.0.0 --port 5173`; for Next use `next dev -H 0.0.0.0 -p 5173`; for Python use `python3 -m http.server 5173 --bind 0.0.0.0`.',
+    '- Never start multiple preview dev servers. If you need a new preview, call `/preview/start` again and let the Worker replace the old one.',
     '- 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>)`.',
-    '- Preview ports must be 1024-65535 and cannot be 3000. For Vite/Next-style dev servers prefer 5173, 4173, or 8080.',
-    `- Preview curl rule: curl -sS -X POST "\${WTT_SANDBOX_OUTBOX_URL:-http://wtt.preview}/preview-port" -H 'content-type: application/json' -d '{"agent_id":"'\${WTT_AGENT_ID:-cloud-agent}'","port":<port>}'`,
-    `- Prefer automatic WTT publishing when topic id is available: wtt-connect preview-port --port <port>${topicId ? ` --topic-id ${topicId}` : ' --topic-id <topic_id>'} --title "Short Title". This publishes one cloud_sandbox_preview live card.`,
+    '- If a live preview is requested, call the Worker outbox directly and include the returned `preview_url` in your reply as `[preview_url:Short Title](<preview_url>)`.',
+    `- Preview start command: curl -sS -X POST "\${WTT_SANDBOX_OUTBOX_URL:-http://wtt.preview}/preview/start" -H 'content-type: application/json' -d '{"agent_id":"'\${WTT_AGENT_ID:-cloud-agent}'","title":"Short Title","cwd":"'\$(pwd)'","command":"npm run dev -- --host 0.0.0.0 --port 5173"}'`,
   );
   return lines.join('\n');
 }

package/src/wtt-client.js

@@ -176,13 +176,23 @@ export class WTTClient {
       log('info', 'dry-run publish', { topicId, semanticType, chars: content.length });
       return null;
     }
-    return this.action('publish', {
+    const payload = {
       topic_id: topicId,
       content,
       content_type: 'text',
       semantic_type: semanticType,
       ...(metadata && typeof metadata === 'object' ? { metadata } : {}),
-    });
+    };
+    try {
+      return await this.action('publish', payload, 60000);
+    } catch (err) {
+      log('warn', 'websocket publish failed; trying HTTP fallback', {
+        topicId,
+        semanticType,
+        error: err?.message || err,
+      });
+      return await this.httpPublish(payload, 60000);
+    }
   }
 
   async typing(topicId, state, options = {}) {
@@ -251,6 +261,41 @@ export class WTTClient {
       clearTimeout(timer);
     }
   }
+
+  async httpPublish(payload, timeoutMs = 60000) {
+    const base = String(this.config.wttBaseUrl || '').replace(/\/$/, '');
+    if (!base || !this.config.agentId || !this.config.token) throw new Error('missing HTTP publish configuration');
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+      const headers = { 'Content-Type': 'application/json' };
+      if (this.config.httpToken) headers.Authorization = `Bearer ${this.config.httpToken}`;
+      else headers['X-Agent-Token'] = this.config.token;
+      const response = await fetch(
+        `${base}/topics/${encodeURIComponent(payload.topic_id)}/messages?agent_id=${encodeURIComponent(this.config.agentId)}`,
+        {
+          method: 'POST',
+          headers,
+          body: JSON.stringify({
+            sender_id: this.config.agentId,
+            sender_type: 'AGENT',
+            content: payload.content,
+            content_type: payload.content_type || 'text',
+            semantic_type: payload.semantic_type || 'CHAT_REPLY',
+            ...(payload.metadata ? { metadata: payload.metadata } : {}),
+          }),
+          signal: controller.signal,
+        },
+      );
+      if (!response.ok) {
+        const detail = await response.text().catch(() => '');
+        throw new Error(`HTTP publish failed: ${response.status}${detail ? ` ${detail.slice(0, 160)}` : ''}`);
+      }
+      return await response.json().catch(() => ({}));
+    } finally {
+      clearTimeout(timer);
+    }
+  }
 }
 
 function rid(prefix) {