wtt-connect 0.2.33 → 0.2.35

package/package.json

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

@@ -133,7 +133,7 @@ Commands:
   opendesign-upload --dir <path>
                                   Alias for upload-artifact
   preview-port --port <port> [--topic-id <id>]
-                                  Create a Cloud Sandbox port preview URL
+                                  Create a Cloud Sandbox port preview URL through sandbox outbox
   help                           Show this help
 `);
 }
@@ -143,10 +143,10 @@ async function previewPort(config, argv) {
   if (!Number.isInteger(port) || port < 1 || port > 65535) {
     throw new Error('preview-port requires --port <1-65535>');
   }
-  const api = new WTTApi(config);
-  const preview = await api.createSandboxPreviewUrl(port, {
+  const preview = await createSandboxPreviewFromOutbox(config, port, {
     name: String(argv.previewName || argv.title || '').trim(),
     token: String(argv.previewToken || '').trim(),
+    timeoutMs: Number(argv.timeout || 15000),
   });
   const url = preview.preview_url || preview.url;
   if (!url) throw new Error('Cloud Sandbox preview API returned no URL');
@@ -169,6 +169,37 @@ async function previewPort(config, argv) {
   console.log(JSON.stringify({ ok: true, port, url, preview_url: url, markdown, published }, null, 2));
 }
 
+async function createSandboxPreviewFromOutbox(config, port, { name = '', token = '', timeoutMs = 15000 } = {}) {
+  if (!config.cloudSandbox && !process.env.WTT_SANDBOX_OUTBOX_URL) {
+    throw new Error('preview-port is only available inside a WTT Cloud Sandbox');
+  }
+  const base = String(process.env.WTT_SANDBOX_OUTBOX_URL || 'http://wtt.preview').replace(/\/+$/, '');
+  const response = await fetch(`${base}/preview-port`, {
+    method: 'POST',
+    headers: { 'content-type': 'application/json' },
+    body: JSON.stringify({
+      agent_id: config.agentId,
+      port,
+      ...(name ? { name } : {}),
+      ...(token ? { token } : {}),
+    }),
+    signal: AbortSignal.timeout(Math.max(1000, Math.min(Number(timeoutMs || 15000), 60000))),
+  });
+  const text = await response.text();
+  let data = {};
+  if (text) {
+    try {
+      data = JSON.parse(text);
+    } catch {
+      data = { detail: text };
+    }
+  }
+  if (!response.ok) {
+    throw new Error(`Cloud Sandbox outbox preview failed: ${data.detail || data.error || response.statusText || response.status}`);
+  }
+  return data;
+}
+
 async function uploadFile(config, argv) {
   const topicId = String(argv.topicId || argv.sourceId || '').trim();
   if (!topicId) throw new Error('upload-file requires --topic-id <topic_id>');

package/src/runner.js

@@ -937,7 +937,8 @@ function renderCloudSandboxStorageInstruction(config, topicId = '') {
     '- Do not install large dependencies, clone large repositories, download datasets, or write bulky generated files into the workspace unless the user explicitly asks for local temporary storage.',
     '- Keep only source edits, small manifests, notes, and temporary scratch files in the workspace.',
     '- 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 you start a web server in the sandbox and the user should preview it, expose that port with: wtt-connect preview-port --port <port>${topicId ? ` --topic-id ${topicId}` : ' --topic-id <topic_id>'}. This creates a Cloudflare Sandbox preview URL and does not use the legacy artifact/media preview flow.`,
+    `- If you start a web server in the sandbox and the user should preview it, expose that port with: wtt-preview-port <port>. This command calls the Cloudflare Sandbox outbound Worker directly and prints a public preview URL; include that URL in your reply.`,
+    `- Only if you need WTT to publish the preview card automatically, use: wtt-connect preview-port --port <port>${topicId ? ` --topic-id ${topicId}` : ' --topic-id <topic_id>'}. This is a convenience wrapper around the same sandbox outbound Worker, not a backend preview API.`,
   );
   return lines.join('\n');
 }

package/src/wtt-api.js

@@ -103,15 +103,4 @@ export class WTTApi {
     });
   }
 
-  async createSandboxPreviewUrl(port, { name = '', token = '' } = {}) {
-    if (!this.config.agentId) throw new Error('WTT_AGENT_ID is required');
-    return this.request('POST', `/cloud-agents/${encodeURIComponent(this.config.agentId)}/preview`, {
-      headers: this.agentHeaders(),
-      json: {
-        port,
-        ...(name ? { name } : {}),
-        ...(token ? { token } : {}),
-      },
-    });
-  }
 }