vessels-mcp 0.2.0 → 0.4.0

package/dist/index.js

@@ -3,7 +3,7 @@
 // src/index.ts
 import { readFileSync } from "fs";
 import { homedir } from "os";
-import { join } from "path";
+import { join, basename } from "path";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z } from "zod";
@@ -11,15 +11,22 @@ import { Vessels } from "vessels-sdk";
 function resolveKey() {
   const env = process.env.VESSELS_API_KEY;
   if (env && !env.startsWith("${")) return env;
-  try {
-    const k = readFileSync(join(homedir(), ".thru-do-vessels-key"), "utf8").trim();
-    if (k) return k;
-  } catch {
+  for (const p of [
+    join(homedir(), ".config", "vessels-mcp", "key"),
+    join(homedir(), ".thru-do-vessels-key")
+    // legacy path — kept for back-compat
+  ]) {
+    try {
+      const k = readFileSync(p, "utf8").trim();
+      if (k) return k;
+    } catch {
+    }
   }
   return void 0;
 }
 var apiKey = resolveKey();
-var defaultVessel = process.env.VESSELS_VESSEL ?? "claude-code";
+var cwdName = basename(process.cwd()) || "workspace";
+var defaultVessel = process.env.VESSELS_VESSEL ?? `claude-code-${cwdName}`;
 var vesselTitle = process.env.VESSELS_VESSEL_TITLE ?? "Claude Code";
 var baseUrl = process.env.VESSELS_BASE_URL ?? "https://vessels.app";
 if (!apiKey) {
@@ -68,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.4.0" });
 server.registerTool(
   "list_vessels",
   {
@@ -305,5 +312,78 @@ server.registerTool(
     return ok("ok");
   }
 );
+server.registerTool(
+  "update_vessel",
+  {
+    title: "Update a vessel",
+    description: "Edit vessel-level state WITHOUT posting a message: title, labels (replaces the whole set), status, archived, or pinned (pin to top of the list). Use list_vessels to find the external_id.",
+    inputSchema: {
+      vessel: z.string().describe("Vessel external_id."),
+      title: z.string().optional(),
+      labels: z.array(z.string()).optional().describe("Replace the vessel labels (full set)."),
+      status: z.enum(["active", "waiting", "resolved"]).optional(),
+      archived: z.boolean().optional().describe("Archive (true) or unarchive (false)."),
+      pinned: z.boolean().optional().describe("Pin (true) / unpin (false) to the top of the list.")
+    }
+  },
+  async ({ vessel, title, labels, status, archived, pinned }) => {
+    const body = {
+      ...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}`);
+  }
+);
+server.registerTool(
+  "delete_vessel",
+  {
+    title: "Delete a vessel (permanent)",
+    description: "Permanently delete a vessel and all its messages (cascade). IRREVERSIBLE \u2014 prefer update_vessel with archived:true unless you truly mean to destroy it.",
+    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}`);
+  }
+);
+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());
 console.error(`[vessels-mcp] ready \u2014 default vessel "${defaultVessel}" @ ${baseUrl}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vessels-mcp",
-  "version": "0.2.0",
+  "version": "0.4.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.16.0"
+    "vessels-sdk": "^0.19.0"
   },
   "devDependencies": {
     "tsup": "^8.5.1",