vessels 0.9.0 → 0.10.0

package/dist/index.js

@@ -4156,7 +4156,13 @@ var AgentActivitySchema = external_exports.object({
 });
 var CardFieldSchema = external_exports.object({
   label: external_exports.string().min(1),
-  value: external_exports.string()
+  value: external_exports.string(),
+  // Optional: render the value as a tappable link, deep-linking the human into
+  // your own web UI (e.g. an admin tray). Rendered on full-size cards (surface /
+  // pinned-card detail), not the compact vessel-list preview.
+  url: external_exports.string().url().max(2048).optional(),
+  // Optional colour hint — pure styling, no behaviour. 'default' === unset.
+  tone: external_exports.enum(["default", "success", "warning", "danger"]).optional()
 });
 var CardSchema = external_exports.object({
   // Optional: a glance-facts card under a surface takes its heading from the
@@ -4966,6 +4972,39 @@ Install the SDK:
   }
   console.log(`Full reference: https://vessels.app/llms-full.txt`);
 }
+async function cmdConversation(args) {
+  const flags = parseFlags(args);
+  const vessel = flags.vessel ?? args.find((a) => !a.startsWith("--"));
+  if (!vessel) {
+    console.error("Usage: vessels conversation <vessel> [--out <file.json>] [--limit <n>]");
+    process.exit(1);
+  }
+  const vesselId = await resolveVesselId(vessel);
+  const qs = flags.limit ? `?limit=${encodeURIComponent(flags.limit)}` : "";
+  const data = await api(`/api/v1/vessels/${vesselId}/trace${qs}`);
+  const trace = data.trace;
+  const outPath = resolve(flags.out ?? `vessels-trace-${vessel.replace(/[^a-zA-Z0-9_-]/g, "_")}.json`);
+  writeFileSync(outPath, JSON.stringify(trace, null, 2));
+  const s = trace.summary;
+  console.log(`
+Wrote ${s.events} events \u2192 ${outPath}`);
+  console.log(`  ${s.requests} agent calls \xB7 ${s.degraded} degraded \xB7 ${s.rejected} rejected \xB7 ${s.webhookFailures} webhook failures`);
+  if (!trace.verbose) {
+    console.log(`  note: workspace not in debug mode \u2014 request bodies weren't captured, so agent calls are absent.`);
+  }
+  if (s.issues.length) {
+    console.log(`
+${s.issues.length} issue(s) \u2014 read these first:
+`);
+    for (const i of s.issues) {
+      const where = i.endpoint ? ` ${i.endpoint}` : "";
+      console.log(`  [#${i.seq} ${i.severity}] ${i.code}${i.field ? ` (${i.field})` : ""}${where}`);
+      console.log(`     ${i.message}`);
+      if (i.hint) console.log(`     \u2192 ${i.hint}`);
+    }
+  }
+  console.log("");
+}
 var [, , cmd, sub, ...rest] = process.argv;
 var HELP = `
 vessels \u2014 CLI for Vessels (vessels.app)
@@ -5027,6 +5066,13 @@ Commands:
       Send a message as the logged-in user and print webhook delivery logs.
       Accepts vessel UUID or external_id (e.g. booking-123).
 
+  vessels conversation <vessel> [--out <file.json>] [--limit <n>]
+      Replay a vessel to a JSON trace file for debugging an agent run: a single
+      timeline of your agent's calls (with the sent-vs-applied diff \u2014 which fields
+      actually landed), the messages that rendered, agent-activity step timing,
+      human responses and webhook deliveries. Prints a summary + issues; the full
+      trace goes to the file. Accepts vessel UUID or external_id.
+
   vessels validate <file.json>
       Check a push payload against the required syntax WITHOUT sending it.
       Also reads piped JSON (cat payload.json | vessels validate) or an inline
@@ -5103,6 +5149,7 @@ Run: vessels help`);
 Run: vessels help`);
     process.exit(1);
   }
+  if (cmd === "conversation" || cmd === "trace") return cmdConversation([sub, ...rest].filter(Boolean));
   if (cmd === "feedback") return cmdFeedback([sub, ...rest].filter(Boolean));
   if (cmd === "push") return cmdPush([sub, ...rest].filter(Boolean));
   if (cmd === "message") return cmdMessage([sub, ...rest].filter(Boolean));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vessels",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "description": "Vessels CLI — manage your agent communication layer from the terminal",
   "type": "module",
   "bin": {