vessels-mcp 0.3.0 → 0.5.0

package/dist/index.js

@@ -75,7 +75,7 @@ async function ask(vessel, prompt, build, expectedType) {
     if (!r.hasMore) await sleep(2e3);
   }
 }
-var server = new McpServer({ name: "vessels", version: "0.2.0" });
+var server = new McpServer({ name: "vessels", version: "0.5.0" });
 server.registerTool(
   "list_vessels",
   {
@@ -87,16 +87,17 @@ server.registerTool(
     }
   },
   async ({ limit, archived }) => {
-    const res = await fetch(`${baseUrl}/api/v1/vessels?archived=${archived ? "true" : "false"}`, {
-      headers: { Authorization: `Bearer ${apiKey}` }
-    });
-    const data = await res.json();
-    if (!res.ok) return ok(`error: ${data.error ?? res.status}`);
-    const rows = (data.vessels ?? []).slice(0, limit ?? 30);
+    let vessels;
+    try {
+      vessels = await v.listVessels({ archived: !!archived });
+    } catch (e) {
+      return ok(`error: ${e.message}`);
+    }
+    const rows = vessels.slice(0, limit ?? 30);
     if (!rows.length) return ok("(no vessels)");
     const lines = rows.map((x) => {
       const labels = (x.labels ?? []).length ? ` [${x.labels.join(",")}]` : "";
-      return `${x.external_id}  \xB7${x.status}${x.pinned ? " \xB7pinned" : ""}  "${x.title ?? ""}"${labels}`;
+      return `${x.externalId}  \xB7${x.status}${x.pinned ? " \xB7pinned" : ""}  "${x.title ?? ""}"${labels}`;
     });
     return ok(lines.join("\n"));
   }
@@ -142,13 +143,23 @@ server.registerTool(
   "send",
   {
     title: "Send a message or artifact",
-    description: 'Post a message to a vessel. For a chat reply pass `message`. For a full-width artifact (proposal, report, diff, review) pass `body` (block markdown: headings/lists/tables/quotes) and optionally `title` + `card`. Also supports `pinCard` (persistent header), `labels`, `suggestions` (quick-reply chips), `previewUrl` (a link card), and `status` to set the vessel state. Returns the new message id as "mid:<id>".',
+    description: 'Post a message to a vessel. For a chat reply pass `message`. For a full-width artifact (proposal, report, diff, review) pass `body` (block markdown: headings/lists/tables/quotes) and optionally `title` + `card`. Also supports `details` (persistent vessel reference record), `labels`, `suggestions` (quick-reply chips), `previewUrl` (a link card), and `status` to set the vessel state. Returns the new message id as "mid:<id>".',
     inputSchema: {
       message: z.string().optional().describe("Chat-bubble text (use this OR body)."),
       body: z.string().optional().describe("Surface artifact body \u2014 block markdown."),
       title: z.string().optional().describe("Surface heading."),
       card: z.object({ title: z.string().optional(), fields: z.array(z.object({ label: z.string(), value: z.string() })) }).optional().describe("Glance-facts card (label/value rows)."),
-      pinCard: z.object({ title: z.string().optional(), fields: z.array(z.object({ label: z.string(), value: z.string() })) }).optional().describe("Persistent pinned header card for the vessel."),
+      details: z.object({
+        fields: z.array(
+          z.object({
+            label: z.string(),
+            value: z.string(),
+            url: z.string().optional(),
+            tone: z.enum(["default", "success", "warning", "danger"]).optional(),
+            copyable: z.boolean().optional()
+          })
+        )
+      }).optional().describe("Persistent vessel reference record (CRM-style identity: name, contact, links) shown in the top bar. Replaces wholesale."),
       labels: z.array(z.string()).optional().describe("Triage labels (replace semantics)."),
       suggestions: z.array(z.string()).optional().describe("Quick-reply suggestion chips."),
       previewUrl: z.string().optional().describe("A single URL rendered as a link card."),
@@ -156,13 +167,13 @@ server.registerTool(
       vessel: z.string().optional().describe(`Vessel external_id (default "${defaultVessel}").`)
     }
   },
-  async ({ message, body, title, card, pinCard, labels, suggestions, previewUrl, status, vessel }) => {
+  async ({ message, body, title, card, details, labels, suggestions, previewUrl, status, vessel }) => {
     const common = {
       vessel: vessel ?? defaultVessel,
       vesselTitle,
       ...title ? { title } : {},
       ...card ? { card } : {},
-      ...pinCard ? { pinCard } : {},
+      ...details ? { details } : {},
       ...labels ? { labels } : {},
       ...suggestions ? { suggestions } : {},
       ...previewUrl ? { previewUrl } : {},
@@ -173,6 +184,35 @@ server.registerTool(
     return ok(`mid:${res.messageId}`);
   }
 );
+server.registerTool(
+  "mark",
+  {
+    title: "Mark (action receipt)",
+    description: 'Record that you COMMITTED a discrete action, as a slim timeline chip \u2014 an icon + a short `label`, optional small `subtext`, optional deep-link `url`. Use it instead of narrating the action in prose (e.g. after a tool sends an email or records a payment): the chip is the durable record, so just keep working. Does not wait, fires no webhook. Returns the chip id as "mid:<id>".',
+    inputSchema: {
+      label: z.string().describe("The chip label \u2014 what happened (max 120 chars)."),
+      type: z.enum(["email_sent", "payment_recorded", "status_changed", "booking_created", "invoice_voided", "generic"]).optional().describe('Semantic kind \u2014 picks a default icon + tone. Defaults to "generic".'),
+      subtext: z.string().optional().describe("Small secondary line (an amount, an id, a target; max 160 chars)."),
+      icon: z.string().optional().describe('Override the default glyph with a literal emoji (e.g. "\u2709\uFE0F").'),
+      tone: z.enum(["neutral", "success", "warning", "danger"]).optional().describe('Accent colour. Defaults to "neutral".'),
+      url: z.string().optional().describe("Deep-link into your own UI \u2014 renders a right chevron. NOT an interaction."),
+      vessel: z.string().optional().describe(`Vessel external_id (default "${defaultVessel}").`)
+    }
+  },
+  async ({ label, type, subtext, icon, tone, url, vessel }) => {
+    const res = await v.mark({
+      vessel: vessel ?? defaultVessel,
+      vesselTitle,
+      label,
+      ...type ? { type } : {},
+      ...subtext ? { subtext } : {},
+      ...icon ? { icon } : {},
+      ...tone ? { tone } : {},
+      ...url ? { url } : {}
+    });
+    return ok(`mid:${res.markId}`);
+  }
+);
 server.registerTool(
   "ask_human",
   {
@@ -327,21 +367,20 @@ server.registerTool(
     }
   },
   async ({ vessel, title, labels, status, archived, pinned }) => {
-    const body = {
+    const patch = {
       ...title !== void 0 ? { title } : {},
       ...labels !== void 0 ? { labels } : {},
       ...status !== void 0 ? { vesselStatus: status } : {},
       ...archived !== void 0 ? { archived } : {},
       ...pinned !== void 0 ? { pinned } : {}
     };
-    if (!Object.keys(body).length) return ok("error: nothing to update");
-    const res = await fetch(`${baseUrl}/api/v1/vessels/by-external/${encodeURIComponent(vessel)}`, {
-      method: "PATCH",
-      headers: { Authorization: `Bearer ${apiKey}`, "Content-Type": "application/json" },
-      body: JSON.stringify(body)
-    });
-    const data = await res.json();
-    return ok(res.ok ? "ok" : `error: ${data.error ?? res.status}`);
+    if (!Object.keys(patch).length) return ok("error: nothing to update");
+    try {
+      await v.updateVessel(vessel, patch);
+      return ok("ok");
+    } catch (e) {
+      return ok(`error: ${e.message}`);
+    }
   }
 );
 server.registerTool(
@@ -352,12 +391,37 @@ server.registerTool(
     inputSchema: { vessel: z.string().describe("Vessel external_id to delete.") }
   },
   async ({ vessel }) => {
-    const res = await fetch(`${baseUrl}/api/v1/vessels/by-external/${encodeURIComponent(vessel)}`, {
-      method: "DELETE",
-      headers: { Authorization: `Bearer ${apiKey}` }
-    });
-    const data = await res.json();
-    return ok(res.ok ? `deleted ${vessel}` : `error: ${data.error ?? res.status}`);
+    try {
+      await v.deleteVessel(vessel);
+      return ok(`deleted ${vessel}`);
+    } catch (e) {
+      return ok(`error: ${e.message}`);
+    }
+  }
+);
+server.registerTool(
+  "clear_messages",
+  {
+    title: "Clear a range of messages (rewind)",
+    description: `Trim a vessel's feed back to a point \u2014 the durable op behind a "/rewind". Pass EXACTLY ONE anchor; the anchor row is kept. "afterMessageId"/"after" deletes everything strictly newer ("rewind to here"); "beforeMessageId"/"before" deletes everything strictly older. "source" scopes it: "agent" (default) = agent+system, "user" = the human's messages, "all" = everything. This trims the HUMAN-VISIBLE feed only \u2014 it does NOT clear your agent's own context. Hard delete, irreversible \u2014 use dryRun:true first to preview the count.`,
+    inputSchema: {
+      vessel: z.string().optional().describe(`Vessel external_id (default "${defaultVessel}").`),
+      afterMessageId: z.string().optional().describe('Delete everything after this message id ("rewind to here").'),
+      beforeMessageId: z.string().optional().describe("Delete everything before this message id."),
+      after: z.string().optional().describe("Delete messages strictly newer than this ISO timestamp."),
+      before: z.string().optional().describe("Delete messages strictly older than this ISO timestamp."),
+      source: z.enum(["agent", "user", "all"]).optional().describe('Whose messages may go (default "agent" = agent+system).'),
+      dryRun: z.boolean().optional().describe("Count what would be deleted without deleting.")
+    }
+  },
+  async ({ vessel, afterMessageId, beforeMessageId, after, before, source, dryRun }) => {
+    const tgt = vessel ?? defaultVessel;
+    try {
+      const r = await v.clearMessages(tgt, { afterMessageId, beforeMessageId, after, before, source, dryRun });
+      return ok(r.dryRun ? `would delete ${r.deleted} message(s)` : `deleted ${r.deleted} message(s)`);
+    } catch (e) {
+      return ok(`error: ${e instanceof Error ? e.message : String(e)}`);
+    }
   }
 );
 await server.connect(new StdioServerTransport());

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vessels-mcp",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "Vessels MCP server — give any MCP client (Claude Code, Cursor, …) a tool to message a human and BLOCK until they answer.",
   "type": "module",
   "bin": {
@@ -20,7 +20,7 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0",
     "zod": "^3.22",
-    "vessels-sdk": "^0.18.0"
+    "vessels-sdk": "^0.26.0"
   },
   "devDependencies": {
     "tsup": "^8.5.1",