fathom-mcp 0.4.0 → 0.4.2

package/fathom-agents.md

@@ -2,34 +2,9 @@
 
 {{DESCRIPTION}}
 
-## Memory — Memento Protocol
-
-Working memory is managed by Memento (workspace: `{{WORKSPACE_NAME}}`).
-
-**On session start:**
-1. `memento_health` — verify connection
-2. `memento_item_list` — check active work items and their next actions
-3. `memento_recall` with current task context — find relevant past memories
-
-**During work — actively manage your memories:**
-- `memento_store` when you learn something, make a decision, or discover a pattern
-- `memento_recall` before starting any subtask — someone may have already figured it out
-- `memento_item_update` as you make progress — don't wait until the end
-- `memento_item_create` when new work emerges
-- `memento_skip_add` the moment you hit a dead end (with expiry)
-- `memento_consolidate` when recall returns 3+ overlapping memories on the same topic
-- Delete or archive items that are done or wrong — stale memory is worse than no memory
-
-**Writing discipline — instructions, not logs:**
-- Write: "API moved to /v2 — update all calls" not "checked API, got 404"
-- Write: "Skip X until condition Y" not "checked X, it was quiet"
-- Tag generously — tags power recall and consolidation
-- Set expiration on time-sensitive facts
-- The test: could a future you, with zero context, read this and know exactly what to do?
-
 ## Vault
 
-Local files live in `{{VAULT_DIR}}/`. Vault is for long-form content — things that need to breathe, not be queried. Decisions and next-actions go in Memento; reflections, research notes, and finished pieces go in the vault.
+Local files live in `{{VAULT_DIR}}/`. The vault is for long-form content — things that need to breathe, not be queried.
 
 **Folder conventions:**
 - `research/` — reading notes, paper annotations, deep dives
@@ -50,7 +25,6 @@ status: draft           # optional: draft | published | archived
 
 This workspace is part of a multi-workspace system. Other workspaces exist — you can talk to them.
 
-- **Peek at another workspace's memory:** `memento_recall query="..." workspace="other-ws"`
 - **Peek at another workspace's vault:** `fathom_vault_read path="file.md" workspace="other-ws"`
 - **Send a direct message:** `fathom_send workspace="other-ws" message="..."`
 - **Post to a shared room:** `fathom_room_post room="general" message="..."`
@@ -63,6 +37,5 @@ Your sender identity is automatic — messages are tagged with `{{WORKSPACE_NAME
 
 1. Research and reading notes → `vault/research/`
 2. Speculative connections and insights → `vault/thinking/`
-3. Key findings and decisions → `memento_store` with tags
-4. Session heartbeats → `vault/daily/`
-5. When done — update Memento items, write what you found and what questions remain
+3. Session heartbeats → `vault/daily/`
+4. When done — write what you found and what questions remain

package/package.json

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

package/src/index.js

@@ -270,7 +270,7 @@ const tools = [
   {
     name: "fathom_send",
     description:
-      "Send a message to another workspace's Claude instance — for cross-workspace coordination, " +
+      "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}'",
     inputSchema: {
@@ -424,14 +424,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       result = await client.listWorkspaces();
       break;
     case "fathom_send":
-      // Send is implemented server-side (it manages tmux sessions)
-      result = await client.request?.("POST", `/api/room/${encodeURIComponent("__dm__")}`, {
-        body: { message: `Message from workspace (${config.workspace}): ${args.message}`, sender: config.workspace },
-      });
-      // For now, fall back to error until server implements /api/send
-      if (!result || result.error) {
-        result = { error: "fathom_send requires a running fathom-server with session management. This feature is being migrated." };
-      }
+      result = await client.sendToWorkspace(args.workspace, args.message, config.workspace);
       break;
     default:
       result = { error: `Unknown tool: ${name}` };

package/src/server-client.js

@@ -98,6 +98,14 @@ export function createClient(config) {
     });
   }
 
+  // --- Direct messaging -------------------------------------------------------
+
+  async function sendToWorkspace(target, message, from) {
+    return request("POST", `/api/send/${encodeURIComponent(target)}`, {
+      body: { message, from: from || workspace },
+    });
+  }
+
   // --- Workspaces ------------------------------------------------------------
 
   async function listWorkspaces() {
@@ -162,6 +170,7 @@ export function createClient(config) {
     roomRead,
     roomList,
     roomDescribe,
+    sendToWorkspace,
     listWorkspaces,
     registerWorkspace,
     notifyAccess,