vessels 0.2.1 → 0.2.3

package/dist/index.js

@@ -37,7 +37,10 @@ async function api(path, options = {}) {
     }
   });
   const data = await res.json();
-  if (!res.ok) throw new Error(data.error ?? `HTTP ${res.status}`);
+  if (!res.ok) {
+    const hint = res.status === 401 ? ` Run: vessels login --email <email>` : "";
+    throw new Error((data.error ?? `HTTP ${res.status}`) + hint);
+  }
   return data;
 }
 function prompt(question) {
@@ -108,11 +111,12 @@ async function cmdKeysList() {
     console.log(`${k.prefix}\u2026  ${used}${name}  [${k.id}]`);
   }
 }
-async function cmdKeysCreate(name) {
-  if (!name) name = await prompt("Key name (optional): ");
+async function cmdKeysCreate(args) {
+  const flags = parseFlags(args);
+  const name = flags.name || (args[0] && !args[0].startsWith("--") ? args[0] : null) || null;
   const data = await api("/api/v1/keys", {
     method: "POST",
-    body: JSON.stringify({ name: name || null })
+    body: JSON.stringify({ name })
   });
   console.log(`
 API key created. Copy it now \u2014 it won't be shown again.
@@ -120,6 +124,7 @@ API key created. Copy it now \u2014 it won't be shown again.
   console.log(`  ${data.key}
 `);
   if (data.name) console.log(`Name: ${data.name}`);
+  console.log(`VESSELS_API_KEY=${data.key}`);
 }
 async function cmdKeysRevoke(id) {
   await api(`/api/v1/keys/${id}`, { method: "DELETE" });
@@ -179,18 +184,72 @@ async function cmdWebhooksToggle(id, active) {
   });
   console.log(`Webhook ${data.endpoint.id} ${data.endpoint.active ? "enabled" : "disabled"}.`);
 }
-async function cmdPush(args) {
-  const flags = {};
-  for (let i = 0; i < args.length; i++) {
-    if (args[i].startsWith("--")) flags[args[i].slice(2)] = args[i + 1] ?? "";
+var UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+async function resolveVesselId(input) {
+  if (UUID_RE.test(input)) return input;
+  const data = await api("/api/v1/vessels?limit=200&archived=true");
+  const vessel = (data.vessels ?? []).find((v) => v.external_id === input);
+  if (!vessel) {
+    console.error(`Vessel not found: ${input}`);
+    process.exit(1);
   }
+  return vessel.id;
+}
+async function cmdMessage(args) {
+  const flags = parseFlags(args);
+  if (!flags.vessel || !flags.message) {
+    console.error("Usage: vessels message --vessel <id> --message <text>");
+    process.exit(1);
+  }
+  const vesselId = await resolveVesselId(flags.vessel);
+  const since = new Date(Date.now() - 5e3).toISOString();
+  const data = await api(`/api/v1/vessels/${vesselId}/messages`, {
+    method: "POST",
+    body: JSON.stringify({ message: flags.message })
+  });
+  console.log(`
+Sent.`);
+  console.log(`  vessel_id  ${vesselId}`);
+  console.log(`  message_id ${data.message_id}`);
+  const logsData = await api(`/api/v1/webhooks/deliveries?since=${encodeURIComponent(since)}&limit=10`);
+  const deliveries = logsData.deliveries ?? [];
+  if (!deliveries.length) {
+    console.log("\nNo webhook deliveries \u2014 add an endpoint at vessels-two.vercel.app/settings/webhooks");
+    return;
+  }
+  console.log(`
+Webhook deliveries (${deliveries.length}):
+`);
+  for (const d of deliveries) {
+    const ok = d.response_status !== null && d.response_status >= 200 && d.response_status < 300;
+    const icon = ok ? "\u2713" : "\u2717";
+    const status = d.response_status ?? "no response";
+    const url = d.endpoint_url ?? "(deleted endpoint)";
+    const retry = d.attempt > 1 ? `  \xB7 attempt ${d.attempt}` : "";
+    const time = new Date(d.delivered_at).toLocaleTimeString([], { timeStyle: "medium" });
+    console.log(`  ${icon} ${status}  ${url}`);
+    console.log(`       ${d.event_type}${retry}  \xB7  ${time}`);
+    if (d.response_body) {
+      const body = d.response_body.length > 300 ? d.response_body.slice(0, 300) + "\u2026" : d.response_body;
+      console.log(`
+       ${body.split("\n").join("\n       ")}`);
+    }
+    console.log();
+  }
+}
+async function cmdPush(args) {
+  const flags = parseFlags(args);
   const apiKey = flags.key ?? process.env.VESSELS_API_KEY;
   if (!apiKey) {
     console.error("Provide an API key via --key or VESSELS_API_KEY env var");
     process.exit(1);
   }
-  const message = flags.message ?? await prompt("Message: ");
-  const vessel = flags.vessel ?? await prompt("Vessel ID (or press enter for default): ");
+  if (!flags.message) {
+    console.error("Usage: vessels push --vessel <id> --message <text> --key <api_key>");
+    process.exit(1);
+  }
+  const message = flags.message;
+  const vessel = flags.vessel ?? void 0;
   const res = await fetch(`${BASE_URL}/api/v1/push`, {
     method: "POST",
     headers: { "Content-Type": "application/json", Authorization: `Bearer ${apiKey}` },
@@ -215,7 +274,7 @@ Commands:
   vessels whoami
 
   vessels keys list
-  vessels keys create [name]
+  vessels keys create [--name <name>]
   vessels keys revoke <id>
 
   vessels webhooks list
@@ -227,11 +286,15 @@ Commands:
   vessels push --vessel <id> --message <text> --key <api_key>
       (--key can be omitted if VESSELS_API_KEY is set)
 
+  vessels message --vessel <id> --message <text>
+      Send a message as the logged-in user and print webhook delivery logs.
+      Accepts vessel UUID or external_id (e.g. booking-123).
+
 Agent/Claude Code setup (fully non-interactive):
   vessels login --email me@example.com
   # tell your agent the OTP from the email
   vessels login --email me@example.com --otp 847293
-  vessels keys create my-project
+  vessels keys create --name my-project
   vessels webhooks create --url https://myapp.com/hooks/vessels
 `;
 async function main() {
@@ -244,7 +307,7 @@ async function main() {
   if (cmd === "whoami") return cmdWhoami();
   if (cmd === "keys") {
     if (sub === "list" || !sub) return cmdKeysList();
-    if (sub === "create") return cmdKeysCreate(rest[0]);
+    if (sub === "create") return cmdKeysCreate(rest);
     if (sub === "revoke") {
       if (!rest[0]) {
         console.error("Usage: vessels keys revoke <id>");
@@ -252,6 +315,9 @@ async function main() {
       }
       return cmdKeysRevoke(rest[0]);
     }
+    console.error(`Unknown subcommand: keys ${sub}
+Run: vessels help`);
+    process.exit(1);
   }
   if (cmd === "webhooks") {
     if (sub === "list" || !sub) return cmdWebhooksList();
@@ -277,8 +343,12 @@ async function main() {
       }
       return cmdWebhooksToggle(rest[0], false);
     }
+    console.error(`Unknown subcommand: webhooks ${sub}
+Run: vessels help`);
+    process.exit(1);
   }
   if (cmd === "push") return cmdPush([sub, ...rest].filter(Boolean));
+  if (cmd === "message") return cmdMessage([sub, ...rest].filter(Boolean));
   console.error(`Unknown command: ${cmd}
 Run: vessels help`);
   process.exit(1);

package/package.json

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