wtt-connect 0.2.32 → 0.2.33

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wtt-connect",
-  "version": "0.2.32",
+  "version": "0.2.33",
   "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,43 @@ 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
   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 api = new WTTApi(config);
+  const preview = await api.createSandboxPreviewUrl(port, {
+    name: String(argv.previewName || argv.title || '').trim(),
+    token: String(argv.previewToken || '').trim(),
+  });
+  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 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 creates a Cloudflare Sandbox preview URL and does not use the legacy artifact/media preview flow.`,
   );
   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,16 @@ export class WTTApi {
       json: { agent_id: this.config.agentId, result },
     });
   }
+
+  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 } : {}),
+      },
+    });
+  }
 }