wtt-connect 0.2.32 → 0.2.34

package/package.json

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

@@ -35,6 +35,7 @@ export async function main(args) {
   if (cmd === 'smoke-chat') return smokeChat(loadConfig(argv), argv);
   if (cmd === 'upload-file' || cmd === 'send-file') return uploadFile(loadConfig(argv), argv);
   if (cmd === 'upload-artifact' || cmd === 'opendesign-upload') return uploadArtifact(loadConfig(argv), argv);
+  if (cmd === 'preview-port' || cmd === 'sandbox-preview') return previewPort(loadConfig(argv), argv);
   if (cmd === 'start') {
     const config = loadConfig(argv);
     if (!config.agentId) throw new Error('WTT_AGENT_ID is required');
@@ -91,6 +92,9 @@ function parseArgs(args) {
     else if (a === '--title') out.title = args[++i];
     else if (a === '--entry') out.entry = args[++i];
     else if (a === '--type') out.type = args[++i];
+    else if (a === '--port') out.port = Number(args[++i]);
+    else if (a === '--preview-name') out.previewName = args[++i];
+    else if (a === '--preview-token') out.previewToken = args[++i];
     else if (a === '--timeout') out.timeout = Number(args[++i]) * 1000;
     else if (a === '--sender-agent-id') out.senderAgentId = args[++i];
     else if (a === '--sender-token') out.senderToken = args[++i];
@@ -128,10 +132,74 @@ Commands:
   upload-artifact --dir <path>  Upload an OpenDesign/artifact directory to WTT
   opendesign-upload --dir <path>
                                   Alias for upload-artifact
+  preview-port --port <port> [--topic-id <id>]
+                                  Create a Cloud Sandbox port preview URL through sandbox outbox
   help                           Show this help
 `);
 }
 
+async function previewPort(config, argv) {
+  const port = Number(argv.port || argv._[0]);
+  if (!Number.isInteger(port) || port < 1 || port > 65535) {
+    throw new Error('preview-port requires --port <1-65535>');
+  }
+  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');
+  const markdown = preview.markdown || `[preview_url](${url})`;
+  const topicId = String(argv.topicId || argv.sourceId || '').trim();
+  let published = null;
+  if (topicId) {
+    const wtt = new WTTClient(config, async () => {});
+    try {
+      await wtt.connectForActions();
+      published = await wtt.publish(topicId, markdown, argv.semanticType || 'CHAT_REPLY', {
+        type: 'cloud_sandbox_preview',
+        port,
+        preview_url: url,
+      });
+    } finally {
+      await wtt.close();
+    }
+  }
+  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

@@ -221,7 +221,7 @@ export class Runner {
         '',
         staged.promptBlock,
         renderTranscriptBlock(transcripts),
-        renderCloudSandboxStorageInstruction(this.config),
+        renderCloudSandboxStorageInstruction(this.config, topicId),
         renderGeneratedFileArtifactInstruction(this.config, topicId),
         'Reply naturally and concisely unless the user asks for detail.',
       ].filter(Boolean).join('\n');
@@ -917,7 +917,7 @@ function renderGeneratedFileArtifactInstruction(config, topicId = '') {
   ].join('\n');
 }
 
-function renderCloudSandboxStorageInstruction(config) {
+function renderCloudSandboxStorageInstruction(config, topicId = '') {
   if (!config.cloudSandbox) return '';
   const workDir = config.workDir || process.cwd();
   const persistentDir = String(config.persistentOutputDir || '').trim();
@@ -937,6 +937,7 @@ function renderCloudSandboxStorageInstruction(config) {
     '- 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 calls the Cloudflare Sandbox outbound Worker directly to create a preview URL and does not use WTT backend preview or legacy artifact/media preview flows.`,
   );
   return lines.join('\n');
 }
@@ -1381,7 +1382,7 @@ function buildTaskPrompt(task, config, staged = { promptBlock: '' }, transcripts
     renderTranscriptBlock(transcripts),
     '',
     config.requireCommitPush ? 'For code changes, commit and push before final response, and include commit id.' : '',
-    renderCloudSandboxStorageInstruction(config),
+    renderCloudSandboxStorageInstruction(config, task.topic_id || task.topicId || ''),
     renderGeneratedFileArtifactInstruction(config, task.topic_id || task.topicId || ''),
     'Return a concise final summary with evidence, changed files, tests, artifacts, and blockers.',
   ].filter(Boolean).join('\n');

package/src/wtt-api.js

@@ -102,4 +102,5 @@ export class WTTApi {
       json: { agent_id: this.config.agentId, result },
     });
   }
+
 }