vessels 0.2.6 → 0.3.0

package/README.md

@@ -0,0 +1,63 @@
+# vessels
+
+CLI for [Vessels](https://vessels.app) — let your agent reach you.
+
+Vessels is the communication layer between AI agents and their human operators. This CLI handles account setup, API key management, and webhook configuration.
+
+## Installation
+
+```bash
+npm install -g vessels
+```
+
+## Setup (Claude Code and AI assistants — fully non-interactive)
+
+Two commands. One human step (the OTP from your inbox).
+
+```bash
+# Step 1 — send OTP to your email
+vessels init --email me@example.com
+
+# Step 2 — verify and complete setup (run with the code from your inbox)
+vessels init --email me@example.com --otp 847293
+
+# Output:
+# VESSELS_API_KEY=vsl_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
+# npm install vessels-sdk
+
+# With webhook (optional — add once your server is deployed):
+vessels init --email me@example.com --otp 847293 --webhook-url https://myapp.com/hooks/vessels
+# Also prints: VESSELS_WEBHOOK_SECRET=whsec_xxx
+```
+
+`vessels init` creates an account if you don't have one, then creates an API key (and optional webhook endpoint), and prints copy-ready `.env` entries. It's designed for Claude Code or any AI assistant to drive autonomously — the only human touch point is entering the 6-digit OTP.
+
+## All commands
+
+```
+vessels init --email <email> [--otp <code>] [--name <key-name>] [--webhook-url <url>]
+    First-time setup. Run once to send OTP, re-run with --otp to complete.
+
+vessels login [--email <email>] [--otp <code>]
+vessels logout
+vessels whoami
+
+vessels keys list
+vessels keys create [--name <name>]
+vessels keys revoke <id>
+
+vessels webhooks list
+vessels webhooks create --url <https://...> [--events interaction.response,message.user]
+vessels webhooks delete <id>
+vessels webhooks enable <id>
+vessels webhooks disable <id>
+
+vessels push --vessel <id> --message <text> --key <vsl_xxx>
+vessels message --vessel <id> --message <text>
+```
+
+## Full reference
+
+- SDK: [vessels-sdk on npm](https://www.npmjs.com/package/vessels-sdk)
+- Docs: [vessels.app/docs](https://vessels.app/docs)
+- AI-readable reference: [vessels.app/llms-full.txt](https://vessels.app/llms-full.txt)

package/dist/index.js

@@ -213,6 +213,31 @@ async function cmdWebhooksToggle(id, active) {
   });
   console.log(`Webhook ${data.endpoint.id} ${data.endpoint.active ? "enabled" : "disabled"}.`);
 }
+async function cmdWebhooksUpdate(id, args) {
+  const flags = parseFlags(args);
+  const updates = {};
+  if (flags.url !== void 0) {
+    if (!flags.url.startsWith("https://")) {
+      console.error("URL must start with https://");
+      process.exit(1);
+    }
+    updates.url = flags.url;
+  }
+  if (flags.events !== void 0) {
+    updates.events = flags.events.split(/[,\s]+/).filter(Boolean);
+  }
+  if (!Object.keys(updates).length) {
+    console.error("Nothing to update. Pass --url <https://...> and/or --events <a,b>.");
+    process.exit(1);
+  }
+  const data = await api(`/api/v1/webhooks/${id}`, {
+    method: "PATCH",
+    body: JSON.stringify(updates)
+  });
+  console.log(`Webhook ${data.endpoint.id} updated.`);
+  console.log(`  URL:    ${data.endpoint.url}`);
+  console.log(`  Events: ${data.endpoint.events.join(", ")}`);
+}
 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;
@@ -291,14 +316,93 @@ async function cmdPush(args) {
   }
   console.log(`Message sent. vessel_id=${data.vessel_id} message_id=${data.message_id}`);
 }
+async function cmdInit(args) {
+  const flags = parseFlags(args);
+  const email = flags.email || await prompt("Email: ");
+  if (!flags.otp) {
+    const res = await fetch(`${BASE_URL}/api/v1/auth/otp/send`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ email })
+    });
+    if (!res.ok) {
+      const data = await res.json();
+      console.error("Failed to send code:", data.error);
+      process.exit(1);
+    }
+    console.log(`
+OTP sent to ${email}.
+`);
+    const webhookFlag = flags["webhook-url"] ? ` --webhook-url ${flags["webhook-url"]}` : "";
+    const nameFlag = flags.name ? ` --name ${flags.name}` : "";
+    console.log(`Run:
+
+  vessels init --email ${email} --otp <code>${nameFlag}${webhookFlag}
+`);
+    return;
+  }
+  const verifyRes = await fetch(`${BASE_URL}/api/v1/auth/otp/verify`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({ email, token: flags.otp })
+  });
+  const verifyData = await verifyRes.json();
+  if (!verifyRes.ok) {
+    console.error("Invalid or expired code.");
+    process.exit(1);
+  }
+  writeConfig({ access_token: verifyData.access_token, refresh_token: verifyData.refresh_token, email });
+  await api("/api/v1/me");
+  const keyData = await api("/api/v1/keys", {
+    method: "POST",
+    body: JSON.stringify({ name: flags.name || "default" })
+  });
+  console.log(`
+Setup complete.
+`);
+  console.log(`Add to your .env file:
+`);
+  console.log(`  VESSELS_API_KEY=${keyData.key}`);
+  if (flags["webhook-url"]) {
+    const webhookData = await api("/api/v1/webhooks", {
+      method: "POST",
+      body: JSON.stringify({ url: flags["webhook-url"], events: ["interaction.response", "message.user"] })
+    });
+    console.log(`  VESSELS_WEBHOOK_SECRET=${webhookData.endpoint.secret}`);
+  }
+  console.log(`
+Install the SDK:
+
+  npm install vessels-sdk
+`);
+  if (!flags["webhook-url"]) {
+    console.log(`To receive webhooks (once your server is deployed):
+`);
+    console.log(`  vessels webhooks create --url https://your-app.com/hooks/vessels
+`);
+  }
+  console.log(`Full reference: https://vessels.app/llms-full.txt`);
+}
 var [, , cmd, sub, ...rest] = process.argv;
 var HELP = `
 vessels \u2014 CLI for Vessels (vessels.app)
 
+Quick setup (Claude Code / AI agents \u2014 fully non-interactive):
+
+  vessels init --email me@example.com
+  # Vessels emails you a 6-digit code. Then run:
+  vessels init --email me@example.com --otp 847293
+  # Prints VESSELS_API_KEY=vsl_xxx  and  npm install vessels-sdk
+
+  # With a webhook (optional, run once your server is deployed):
+  vessels init --email me@example.com --otp 847293 --webhook-url https://myapp.com/hooks/vessels
+
 Commands:
-  vessels login [--email <email>] [--otp <code>]
-      Log in or sign up. Run without --otp to send the code, then re-run with --otp to verify.
+  vessels init --email <email> [--otp <code>] [--name <key-name>] [--webhook-url <url>]
+      First-time setup: account + API key (+ webhook). Two-step: run once to send OTP,
+      re-run with --otp to complete. Prints copy-ready .env entries.
 
+  vessels login [--email <email>] [--otp <code>]
   vessels logout
   vessels whoami
 
@@ -308,6 +412,7 @@ Commands:
 
   vessels webhooks list
   vessels webhooks create --url <https://...> [--events interaction.response,message.user]
+  vessels webhooks update <id> [--url <https://...>] [--events interaction.response,message.user]
   vessels webhooks delete <id>
   vessels webhooks enable <id>
   vessels webhooks disable <id>
@@ -319,18 +424,14 @@ Commands:
       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 --name my-project
-  vessels webhooks create --url https://myapp.com/hooks/vessels
+Full reference: https://vessels.app/llms-full.txt
 `;
 async function main() {
   if (!cmd || cmd === "help" || cmd === "--help" || cmd === "-h") {
     console.log(HELP);
     return;
   }
+  if (cmd === "init") return cmdInit([sub, ...rest].filter(Boolean));
   if (cmd === "login" || cmd === "signup") return cmdLogin([sub, ...rest].filter(Boolean));
   if (cmd === "logout") return cmdLogout();
   if (cmd === "whoami") return cmdWhoami();
@@ -351,6 +452,13 @@ Run: vessels help`);
   if (cmd === "webhooks") {
     if (sub === "list" || !sub) return cmdWebhooksList();
     if (sub === "create") return cmdWebhooksCreate(rest);
+    if (sub === "update") {
+      if (!rest[0]) {
+        console.error("Usage: vessels webhooks update <id> [--url <https://...>] [--events <a,b>]");
+        process.exit(1);
+      }
+      return cmdWebhooksUpdate(rest[0], rest.slice(1));
+    }
     if (sub === "delete" || sub === "remove") {
       if (!rest[0]) {
         console.error("Usage: vessels webhooks delete <id>");

package/package.json

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