fathom-mcp 0.4.10 → 0.4.11

package/package.json

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

package/src/cli.js

@@ -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 {

package/src/index.js

@@ -624,6 +624,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,
   };