wtt-connect 0.2.38 → 0.2.40

package/package.json

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

package/src/events.js

@@ -20,6 +20,9 @@ export function normalizeAgentEvent(adapterName, event) {
     }
   }
 
+  const generic = normalizeGenericCliEvent(event, now);
+  if (generic) return generic;
+
   if (type === 'item.started') {
     const kind = item.type || 'item';
     if (kind === 'command_execution') return { kind: 'command', status: 'started', text: item.command || 'command', time: now, raw: event };
@@ -35,6 +38,103 @@ export function normalizeAgentEvent(adapterName, event) {
   return null;
 }
 
+function normalizeGenericCliEvent(event, now) {
+  if (!event || typeof event !== 'object') return null;
+  const type = String(event.type || event.event || event.kind || '').trim();
+  const status = statusFromEvent(event, type);
+  const item = event.item || event.delta || event.message || event.data || {};
+  const typeText = `${type} ${String(item.type || item.kind || '').trim()}`.toLowerCase();
+
+  const error = event.error?.message || event.error || event.message?.error || '';
+  if (error && (typeText.includes('error') || String(error).trim())) {
+    return { kind: 'error', status: 'failed', text: String(error), time: now, raw: event };
+  }
+
+  const command = firstString(
+    event.command,
+    event.cmd,
+    event.args && Array.isArray(event.args) ? event.args.join(' ') : '',
+    item.command,
+    item.cmd,
+    item.input?.command,
+    item.arguments?.command,
+  );
+  if (command || includesAny(typeText, ['command', 'exec', 'shell', 'terminal'])) {
+    return { kind: 'command', status, text: command || labelFromEvent(event, item) || 'command', time: now, raw: event };
+  }
+
+  const toolName = firstString(
+    event.tool,
+    event.tool_name,
+    event.name,
+    event.call?.name,
+    item.tool,
+    item.tool_name,
+    item.name,
+    item.call?.name,
+    item.function?.name,
+  );
+  if (toolName || includesAny(typeText, ['tool', 'function_call', 'mcp'])) {
+    const summary = summarizeToolInput(event.input || item.input || item.arguments || event.arguments);
+    return { kind: 'tool', status, text: summary ? `${toolName || 'tool'} ${summary}` : (toolName || labelFromEvent(event, item) || 'tool'), time: now, raw: event };
+  }
+
+  const query = firstString(event.query, item.query, event.search_query, item.search_query);
+  if (query || includesAny(typeText, ['web_search', 'search'])) {
+    return { kind: 'web_search', status, text: query || labelFromEvent(event, item) || 'web search', time: now, raw: event };
+  }
+
+  if (includesAny(typeText, ['reason', 'thinking', 'analysis'])) {
+    return { kind: 'reasoning', status, text: labelFromEvent(event, item) || 'thinking', time: now, raw: event };
+  }
+
+  if (includesAny(typeText, ['message', 'assistant', 'response', 'output', 'answer'])) {
+    const text = firstString(event.text, event.content, event.delta, item.text, item.content);
+    return { kind: 'response', status, text: text ? String(text).slice(0, 120) : 'writing response', time: now, raw: event };
+  }
+
+  if (includesAny(typeText, ['session', 'thread', 'turn'])) {
+    return { kind: 'session', status, text: labelFromEvent(event, item) || 'session', time: now, raw: event };
+  }
+
+  return null;
+}
+
+function statusFromEvent(event, type) {
+  const raw = `${String(event.status || event.state || '')} ${type}`.toLowerCase();
+  if (includesAny(raw, ['fail', 'error'])) return 'failed';
+  if (includesAny(raw, ['complete', 'completed', 'done', 'finish', 'finished', 'end', 'ended', 'stop', 'stopped'])) return 'completed';
+  return 'started';
+}
+
+function labelFromEvent(event, item) {
+  return firstString(
+    event.title,
+    event.label,
+    event.message,
+    event.summary,
+    item.title,
+    item.label,
+    item.message,
+    item.summary,
+    item.type,
+    event.type,
+  );
+}
+
+function firstString(...values) {
+  for (const value of values) {
+    if (value == null) continue;
+    if (typeof value === 'string' && value.trim()) return value.trim();
+    if (typeof value === 'number' || typeof value === 'boolean') return String(value);
+  }
+  return '';
+}
+
+function includesAny(value, needles) {
+  return needles.some((needle) => value.includes(needle));
+}
+
 export function renderStatusLine(evt) {
   if (!evt) return '';
   return `[TASK_STATUS] time=${evt.time} status=${evt.status} action=${evt.kind}:${String(evt.text || '').slice(0, 180)}`;
@@ -49,6 +149,7 @@ export function renderActivityText(evt, adapterName = 'agent') {
   if (evt.kind === 'command') return `${adapter} 正在执行命令：${text || 'command'}`;
   if (evt.kind === 'tool') return `${adapter} 正在调用工具：${text || 'tool'}`;
   if (evt.kind === 'web_search') return `${adapter} 正在搜索：${text || 'web search'}`;
+  if (evt.kind === 'reasoning') return `${adapter} 正在推理：${text || 'thinking'}`;
   if (evt.kind === 'response') return `${adapter} 正在组织回复`;
   if (evt.kind === 'session') return `${adapter} 会话已启动`;
   return `${adapter} 正在执行：${text || labelKind(evt.kind)}`;

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,15 @@ 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.',
+    '- 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`.',
+    '- Before publishing a preview URL, verify the server is actually listening and serving content with `curl -fsS http://127.0.0.1:<port>/ >/dev/null`.',
+    '- If local curl fails, fix or restart the web server first. Never publish a preview URL for a dead port.',
+    '- 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');
 }