fathom-mcp 0.4.10 → 0.4.12

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fathom-mcp",
-  "version": "0.4.10",
+  "version": "0.4.12",
   "description": "MCP server for Fathom — vault operations, search, rooms, and cross-workspace communication",
   "type": "module",
   "bin": {

package/src/cli.js

@@ -129,7 +129,7 @@ function copyScripts(targetDir) {
 // --- Headless agent integration ----------------------------------------------
 
 const HEADLESS_CMDS = {
-  "claude-code": (prompt) => ["claude", "-p", prompt],
+  "claude-code": (prompt) => ["claude", "-p", "--dangerously-skip-permissions", prompt],
   "codex":       (prompt) => ["codex", "exec", prompt],
   "gemini":      (prompt) => ["gemini", prompt],
   "opencode":    (prompt) => ["opencode", "run", prompt],
@@ -411,19 +411,20 @@ async function runInit(flags = {}) {
   }
 
   // 5. Server URL
-  const serverUrl = nonInteractive
+  let serverUrl = nonInteractive
     ? (flagServer || "http://localhost:4243")
     : await ask(rl, "\n  Fathom server URL", "http://localhost:4243");
 
   // 6. API key
-  const apiKey = flagApiKey || (nonInteractive ? "" : await ask(rl, "  API key (from dashboard or server first-run output)", ""));
+  let apiKey = flagApiKey || (nonInteractive ? "" : await ask(rl, "  API key (from dashboard or server first-run output)", ""));
 
   // 7. Server probe — check reachability early
-  const regClient = createClient({ server: serverUrl, apiKey, workspace });
-  const serverReachable = serverUrl ? await regClient.healthCheck() : false;
+  let regClient = createClient({ server: serverUrl, apiKey, workspace });
+  let serverReachable = serverUrl ? await regClient.healthCheck() : false;
   const serverOnPath = detectFathomServer();
 
-  if (!serverReachable) {
+  // Retry loop for server connectivity (interactive mode)
+  while (!serverReachable && !nonInteractive) {
     console.log(`\n  ⚠ Fathom server not reachable at ${serverUrl}\n`);
     if (serverOnPath === "installed") {
       console.log("  Start it:  fathom-server");
@@ -433,11 +434,25 @@ async function runInit(flags = {}) {
       console.log("    # or: docker run -p 4243:4243 ghcr.io/myra/fathom-server");
     }
     console.log("\n  Without the server, only \"local\" and \"none\" vault modes are available.");
+    const retry = await askYesNo(rl, "\n  Try a different server URL or API key?", true);
+    if (!retry) break;
+    serverUrl = await ask(rl, "\n  Fathom server URL", serverUrl);
+    apiKey = await ask(rl, "  API key", apiKey);
+    regClient = createClient({ server: serverUrl, apiKey, workspace });
+    serverReachable = await regClient.healthCheck();
+    if (serverReachable) {
+      console.log("  ✓ Server connected!");
+    }
   }
 
   // 8. Vault mode selection
   let vaultMode;
   if (nonInteractive) {
+    if (!serverReachable && flagServer) {
+      console.error(`\n  Error: Server at ${serverUrl} is not reachable.`);
+      console.error("  Fix the URL or start the server, then re-run init.");
+      process.exit(1);
+    }
     vaultMode = serverReachable ? "hosted" : "local";
     console.log(`  Vault mode: ${vaultMode} (auto-selected)`);
   } else {
@@ -664,12 +679,13 @@ async function runInit(flags = {}) {
     } else {
       if (cmdParts) {
         const [cmd, ...args] = cmdParts;
-        const displayCmd = `${cmd} ${args[0]}${args.length > 1 ? " ..." : ""}`;
+        const flagArgs = args.slice(0, -1).join(" ");
+        const displayCmd = `${cmd} ${flagArgs} <prompt>`;
         const rl2 = readline.createInterface({ input: process.stdin, output: process.stdout });
         console.log("\n" + "─".repeat(60));
         const integrate = await askYesNo(
           rl2,
-          `\n  Auto-integrate instructions into your project?\n  This will run: ${displayCmd}\n\n  Proceed?`,
+          `\n  Auto-integrate instructions into your project?\n  This will run: ${displayCmd}\n\n  ⚠  This uses --dangerously-skip-permissions so the agent can\n  write to CLAUDE.md without prompting. If you prefer, decline\n  and we'll print the instructions for you to add manually.\n\n  Proceed?`,
           true,
         );
         rl2.close();

package/src/index.js

@@ -209,8 +209,8 @@ const tools = [
       "Post a message to a shared room. Rooms are created implicitly on first post. " +
       "Use this for ambient, multilateral communication — unlike fathom_send (point-to-point DM), " +
       "room messages are visible to all participants. Responding is optional — use `<...>` for active silence. " +
-      "Supports @workspace mentions (e.g. @fathom, @navier-stokes) — mentioned workspaces get the message " +
-      "injected into their Claude session, same mechanism as fathom_send. Use @all to notify every workspace except sender.",
+      "Supports @workspace mentions (e.g. @fathom, @navier-stokes) — mentioned workspaces receive " +
+      "notifications in their mentions:{workspace} virtual room via fathom_room_list. Use @all to notify every workspace except sender.",
     inputSchema: {
       type: "object",
       properties: {
@@ -227,7 +227,9 @@ const tools = [
       "to the latest message. Default: 60 minutes before the latest message. Use start to look " +
       "further back. Example: minutes=15, start=120 returns 15 minutes of conversation starting " +
       "2 hours before the latest message. Response includes window metadata with has_older flag " +
-      "for pseudo-pagination. Automatically marks the room as read for this workspace unless mark_read=false.",
+      "for pseudo-pagination. For virtual rooms (dm:*, mentions:*), messages are consumed on read — " +
+      "deleted after being returned. Use mark_read=false to peek without consuming. " +
+      "For regular rooms, automatically marks as read unless mark_read=false.",
     inputSchema: {
       type: "object",
       properties: {
@@ -244,7 +246,8 @@ const tools = [
     description:
       "List all rooms with activity summary — message count, last activity time, last sender, " +
       "description, and per-room unread_count for this workspace. Use to discover active rooms " +
-      "and see which have new messages.",
+      "and see which have new messages. Virtual rooms (dm:{workspace}, mentions:{workspace}) " +
+      "appear only for the owning workspace and disappear when empty.",
     inputSchema: {
       type: "object",
       properties: {},
@@ -279,9 +282,10 @@ const tools = [
   {
     name: "fathom_send",
     description:
-      "Send a message to another workspace's agent instance — for cross-workspace coordination, " +
-      "sharing findings, or requesting action. Use fathom_workspaces first to discover valid " +
-      "targets. The target agent sees: 'Message from workspace ({from}): {message}'",
+      "Send a message to another workspace's agent instance — stored in their dm:{workspace} " +
+      "virtual room. Use fathom_workspaces first to discover valid targets. Recipients see DMs " +
+      "via fathom_room_list and consume them with fathom_room_read. " +
+      "Message format: 'Message from workspace ({from}): {message}'",
     inputSchema: {
       type: "object",
       properties: {
@@ -624,6 +628,16 @@ async function main() {
   // Startup sync for synced mode (fire-and-forget)
   startupSync().catch(() => {});
 
+  // Heartbeat — report liveness to server every 30s
+  if (config.server && config.workspace) {
+    const beat = () =>
+      client
+        .heartbeat(config.workspace, config.agents?.[0], config.vaultMode)
+        .catch(() => {});
+    beat(); // immediate
+    setInterval(beat, 30_000);
+  }
+
   const transport = new StdioServerTransport();
   await server.connect(transport);
 }

package/src/server-client.js

@@ -205,6 +205,15 @@ export function createClient(config) {
     });
   }
 
+  // --- Heartbeat -------------------------------------------------------------
+
+  async function heartbeat(ws, agent, vaultMode) {
+    const body = {};
+    if (agent) body.agent = agent;
+    if (vaultMode) body.vault_mode = vaultMode;
+    return request("POST", `/api/workspaces/${encodeURIComponent(ws)}/heartbeat`, { body });
+  }
+
   // --- Auth ------------------------------------------------------------------
 
   async function getApiKey() {
@@ -245,6 +254,7 @@ export function createClient(config) {
     pushFile,
     syncManifest,
     createRoutine,
+    heartbeat,
     getApiKey,
     healthCheck,
   };