wtt-connect 0.2.38 → 0.2.39

package/package.json

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

@@ -150,7 +150,8 @@ async function previewPort(config, argv) {
   });
   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 title = String(argv.title || argv.previewName || preview.name || 'Cloud Sandbox Preview').trim();
+  const markdown = preview.markdown || `[preview_url:${title}](${url})`;
   const topicId = String(argv.topicId || argv.sourceId || '').trim();
   let published = null;
   if (topicId) {

package/src/runner.js

@@ -937,10 +937,12 @@ 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, call the Cloudflare Sandbox outbound Worker directly with curl and include the returned `preview_url` in your reply.',
+    '- 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.',
+    '- 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>}'`,
-    `- 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.`,
+    `- 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 a cloud_sandbox_preview card and is a convenience wrapper around the same sandbox outbound Worker.`,
   );
   return lines.join('\n');
 }