vessels-sdk 0.4.0 → 0.5.0

package/README.md

@@ -1,6 +1,6 @@
 # vessels-sdk
 
-Node.js SDK for [Vessels](https://vessels-two.vercel.app) — let your agent reach you.
+Node.js SDK for [Vessels](https://vessels.app) — let your agent reach you.
 
 Vessels is the communication layer between AI agents and their human operators. Your agent pushes structured messages to a vessel; the human responds via the web or mobile app; your agent receives the answer via polling or webhooks.
 
@@ -38,7 +38,7 @@ const { messageId, vesselId } = await vessels.push({
 });
 ```
 
-Get your API key from Settings → API Keys in the [Vessels app](https://vessels-two.vercel.app), or via the CLI:
+Get your API key from Settings → API Keys in the [Vessels app](https://vessels.app), or via the CLI:
 
 ```bash
 npm install -g vessels
@@ -55,7 +55,7 @@ vessels keys create
 | Option | Type | Default | Description |
 |--------|------|---------|-------------|
 | `apiKey` | `string` | required | Your `vsl_` prefixed API key |
-| `baseUrl` | `string` | `https://vessels-two.vercel.app` | Override for local dev or self-hosted |
+| `baseUrl` | `string` | `https://vessels.app` | Override for local dev or self-hosted |
 
 ---
 
@@ -469,7 +469,7 @@ import type {
 
 ## Links
 
-- Dashboard: [https://vessels-two.vercel.app](https://vessels-two.vercel.app)
-- Full integration reference: [https://vessels-two.vercel.app/docs](https://vessels-two.vercel.app/docs)
+- Dashboard: [https://vessels.app](https://vessels.app)
+- Full integration reference: [https://vessels.app/docs](https://vessels.app/docs)
 - CLI: `npm install -g vessels`
 - npm: [https://www.npmjs.com/package/vessels-sdk](https://www.npmjs.com/package/vessels-sdk)

package/dist/index.cjs

@@ -36,7 +36,7 @@ var Vessels = class {
   _debug;
   constructor(config) {
     this.apiKey = config.apiKey;
-    this.baseUrl = config.baseUrl?.replace(/\/$/, "") ?? "https://vessels-two.vercel.app";
+    this.baseUrl = config.baseUrl?.replace(/\/$/, "") ?? "https://vessels.app";
     this._debug = config.debug ?? false;
   }
   async _fetch(url, init) {
@@ -178,7 +178,8 @@ var Vessels = class {
         type: "message.user",
         timestamp: e.timestamp,
         vessel,
-        message: { id: e.message?.id, content: e.message?.content ?? null }
+        message: { id: e.message?.id, content: e.message?.content ?? null },
+        context: []
       };
     });
     return { ok: true, events, hasMore: data.has_more ?? false };
@@ -209,6 +210,55 @@ var Vessels = class {
       return false;
     }
   }
+  // Verify + parse in one call. Returns a typed event or null (invalid signature or unknown type).
+  // body: raw request body string (before JSON.parse)
+  // signature: X-Vessels-Signature header value
+  // webhookSecret: the secret shown when you created the webhook endpoint in Settings
+  async parseWebhookEvent(body, signature, webhookSecret) {
+    const valid = await this.verifyWebhook(body, signature, webhookSecret);
+    if (!valid) return null;
+    try {
+      const raw = JSON.parse(body);
+      const v = raw.data?.vessel ?? {};
+      const vessel = {
+        id: v.id,
+        externalId: v.external_id ?? null,
+        title: v.title ?? null,
+        metadata: v.metadata ?? {},
+        labels: v.labels ?? []
+      };
+      if (raw.event === "interaction.response") {
+        return {
+          id: raw.data.response_id,
+          type: "interaction.response",
+          timestamp: raw.timestamp,
+          vessel,
+          messageId: raw.data.message_id,
+          interactionType: raw.data.interaction_type,
+          response: raw.data.response,
+          interactionMetadata: raw.data.metadata ?? null,
+          user: raw.data.user ?? null
+        };
+      }
+      if (raw.event === "message.user") {
+        return {
+          id: raw.data.message_id,
+          type: "message.user",
+          timestamp: raw.timestamp,
+          vessel,
+          message: { id: raw.data.message_id, content: raw.data.content ?? null },
+          context: (raw.data.context ?? []).map((m) => ({
+            source: m.source,
+            content: m.content ?? null,
+            createdAt: m.created_at
+          }))
+        };
+      }
+      return null;
+    } catch {
+      return null;
+    }
+  }
 };
 
 exports.AgentActivityTypes = AgentActivityTypes;

package/dist/index.d.cts

@@ -74,6 +74,11 @@ interface UserMessageEvent {
         id: string;
         content: string | null;
     };
+    context: Array<{
+        source: string;
+        content: string | null;
+        createdAt: string;
+    }>;
 }
 type PollEvent = InteractionResponseEvent | UserMessageEvent;
 interface PollResponse {
@@ -138,6 +143,7 @@ declare class Vessels {
     }): _vessels_types.ConfirmPreviewInteraction;
     poll(options?: PollOptions): Promise<PollResponse>;
     verifyWebhook(body: string, signature: string, webhookSecret: string): Promise<boolean>;
+    parseWebhookEvent(body: string, signature: string, webhookSecret: string): Promise<InteractionResponseEvent | UserMessageEvent | null>;
 }
 
 export { AgentActivityTypes, type InteractionResponseEvent, type PollEvent, type PollOptions, type PollResponse, type PushManyResult, type PushResponse, type UserMessageEvent, type VesselContext, Vessels, VesselsAuthError, type VesselsConfig, VesselsRateLimitError, VesselsValidationError };

package/dist/index.d.ts

@@ -74,6 +74,11 @@ interface UserMessageEvent {
         id: string;
         content: string | null;
     };
+    context: Array<{
+        source: string;
+        content: string | null;
+        createdAt: string;
+    }>;
 }
 type PollEvent = InteractionResponseEvent | UserMessageEvent;
 interface PollResponse {
@@ -138,6 +143,7 @@ declare class Vessels {
     }): _vessels_types.ConfirmPreviewInteraction;
     poll(options?: PollOptions): Promise<PollResponse>;
     verifyWebhook(body: string, signature: string, webhookSecret: string): Promise<boolean>;
+    parseWebhookEvent(body: string, signature: string, webhookSecret: string): Promise<InteractionResponseEvent | UserMessageEvent | null>;
 }
 
 export { AgentActivityTypes, type InteractionResponseEvent, type PollEvent, type PollOptions, type PollResponse, type PushManyResult, type PushResponse, type UserMessageEvent, type VesselContext, Vessels, VesselsAuthError, type VesselsConfig, VesselsRateLimitError, VesselsValidationError };

package/dist/index.js

@@ -34,7 +34,7 @@ var Vessels = class {
   _debug;
   constructor(config) {
     this.apiKey = config.apiKey;
-    this.baseUrl = config.baseUrl?.replace(/\/$/, "") ?? "https://vessels-two.vercel.app";
+    this.baseUrl = config.baseUrl?.replace(/\/$/, "") ?? "https://vessels.app";
     this._debug = config.debug ?? false;
   }
   async _fetch(url, init) {
@@ -176,7 +176,8 @@ var Vessels = class {
         type: "message.user",
         timestamp: e.timestamp,
         vessel,
-        message: { id: e.message?.id, content: e.message?.content ?? null }
+        message: { id: e.message?.id, content: e.message?.content ?? null },
+        context: []
       };
     });
     return { ok: true, events, hasMore: data.has_more ?? false };
@@ -207,6 +208,55 @@ var Vessels = class {
       return false;
     }
   }
+  // Verify + parse in one call. Returns a typed event or null (invalid signature or unknown type).
+  // body: raw request body string (before JSON.parse)
+  // signature: X-Vessels-Signature header value
+  // webhookSecret: the secret shown when you created the webhook endpoint in Settings
+  async parseWebhookEvent(body, signature, webhookSecret) {
+    const valid = await this.verifyWebhook(body, signature, webhookSecret);
+    if (!valid) return null;
+    try {
+      const raw = JSON.parse(body);
+      const v = raw.data?.vessel ?? {};
+      const vessel = {
+        id: v.id,
+        externalId: v.external_id ?? null,
+        title: v.title ?? null,
+        metadata: v.metadata ?? {},
+        labels: v.labels ?? []
+      };
+      if (raw.event === "interaction.response") {
+        return {
+          id: raw.data.response_id,
+          type: "interaction.response",
+          timestamp: raw.timestamp,
+          vessel,
+          messageId: raw.data.message_id,
+          interactionType: raw.data.interaction_type,
+          response: raw.data.response,
+          interactionMetadata: raw.data.metadata ?? null,
+          user: raw.data.user ?? null
+        };
+      }
+      if (raw.event === "message.user") {
+        return {
+          id: raw.data.message_id,
+          type: "message.user",
+          timestamp: raw.timestamp,
+          vessel,
+          message: { id: raw.data.message_id, content: raw.data.content ?? null },
+          context: (raw.data.context ?? []).map((m) => ({
+            source: m.source,
+            content: m.content ?? null,
+            createdAt: m.created_at
+          }))
+        };
+      }
+      return null;
+    } catch {
+      return null;
+    }
+  }
 };
 
 export { AgentActivityTypes, Vessels, VesselsAuthError, VesselsRateLimitError, VesselsValidationError };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "vessels-sdk",
-	"version": "0.4.0",
+	"version": "0.5.0",
 	"description": "Let your agent reach you. Official Vessels SDK.",
 	"type": "module",
 	"exports": {