fathom-mcp 0.6.2 → 0.6.4

package/package.json

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

package/scripts/fathom-instructions.sh

@@ -0,0 +1,84 @@
+#!/bin/bash
+# SessionStart hook (Fathom) — inject MCP tool reference + notification instructions.
+# Independent of version check — always runs.
+# Output: JSON with hookSpecificOutput.additionalContext.
+
+# Consume stdin (SessionStart sends JSON we don't need)
+cat > /dev/null
+
+read -r -d '' INSTRUCTIONS << 'FATHOM_EOF'
+# Fathom MCP (`mcp__fathom__*` + `mcp__fathom-vault__*`)
+
+**Load tools:** `ToolSearch query="+fathom" max_results=20`
+
+One MCP server: `fathom-vault`. Handles search, rooms, workspaces, TTS, and routines. Vault file I/O uses Claude Code's native tools (`Read`, `Write`, `Edit`, `Glob`) — a PostToolUse hook validates frontmatter automatically.
+
+**`mcp__fathom-vault__*` tools:**
+
+| Tool | What it does |
+|------|-------------|
+| **Search** | |
+| `fathom_vault_search` | Keyword search (BM25) across vault files — fast, start here |
+| `fathom_vault_vsearch` | Semantic/vector search — conceptual similarity, slower |
+| `fathom_vault_query` | Hybrid search (BM25 + vector + reranking) — most thorough |
+| **Rooms** | |
+| `fathom_room_post` | Post to a shared room (created on first post). Multilateral — all participants see it. Supports `@workspace` mentions and `@all`. |
+| `fathom_room_read` | Read recent room messages (default 60min window anchored to latest). Supports `minutes`/`start` for pagination. |
+| `fathom_room_list` | List all rooms with message count, last activity, unread counts. |
+| `fathom_room_describe` | Set or clear a room's description/topic. |
+| **Workspaces** | |
+| `fathom_workspaces` | List all workspaces with running status, model, and role. |
+| `fathom_send` | DM another workspace — stored in a shared `dm:a+b` room visible to both participants. |
+| **Voice & TTS** | |
+| `fathom_speak` | Generate speech (Kokoro TTS — am_echo 70% + bf_alice 30%). Returns WAV path. Optional `play=true`. |
+| `fathom_send_voice` | Generate speech and send as a voice bubble to Myra via the app. |
+| **Routines** | |
+| `fathom_routine_list` | List routines with merged runtime state (next_ping_at, last_fire_at). Works cross-workspace. |
+| `fathom_routine_fire` | Fire a routine immediately, bypassing conditions. Non-blocking. Works cross-workspace. |
+| **Admin** | |
+| `fathom_key_rotate` | Rotate this agent's API key. Revokes current key, issues new one, reconnects. |
+| `policy_evaluate` | Evaluate a permission request for a tool call (called automatically by --permission-prompt-tool). |
+
+**Image Generation (fal.ai):** Use `mcp__fal-ai__*` tools. Default model: `fal-ai/fast-sdxl/image-to-image` for img2img, `fal-ai/nano-banana-pro` for text-to-image. **Always use nano-banana-pro unless another model is specifically requested.**
+
+**Browser:** Use `mcp__chrome-devtools__*` tools. The MCP manages Chrome automatically — just call tools directly. **Always close your pages when done** (`close_page`) so other agents can use Chrome. Only one agent can drive Chrome at a time.
+
+**Vault structure:** See `vault/CLAUDE.md` for full folder map and what goes where.
+
+### App Notifications (#notification room)
+
+After posting to #general, also post a structured JSON message to `#notification` for the dashboard feed:
+`fathom_room_post room="notification" message='{"type":"post","title":"...","body":"..."}'`
+Types: `"post"` (findings/content), `"status"` (operational), `"content"` (linked content with `content_id`). Plain text fallback works too.
+
+**The body field supports full HTML with inline CSS.** This is a rich rendering surface — use it. Capabilities:
+- **Layout:** `display:flex`, `gap`, `padding`, `margin`, tables — all work. Flexbox is preferred.
+- **Styling:** `border-radius`, `background`, `color`, `font-size`, `font-weight`, `object-fit` — all inline CSS works.
+- **Images:** `<img src="...">` renders inline. Wrap in `<a href="..." target="_blank">` for clickable links to source. Use real CDN image URLs (grab via Chrome `evaluate_script` from product pages, paper figures, screenshots, etc.).
+- **Links:** `<a href="..." target="_blank">` for clickable links. Link images, titles, and add explicit text links — multiple touchpoints per item.
+- **Badges/chips:** Use inline `<span>` with background color, padding, border-radius for sale tags, status pills, warning chips.
+- **Markdown** also works in the body for simpler notifications.
+
+**Design your notifications to be visually rich and scannable.** Myra reads these on a dashboard — think product cards, not log entries. Each workspace should develop templates appropriate to its content (e.g., wardrobe uses product cards with images, NS uses equation summaries with paper links).
+
+**Attachments:** To attach vault files (images, docs, audio) to a notification, add an `attachments` array. Each entry has `path` (relative to your vault) and optional `label`. The dashboard resolves types from extensions and renders images inline, audio as players, and other files as clickable chips.
+```json
+{"type":"content","content_id":"unique-id","title":"Title","body":"<div style=\"font-family:system-ui\">HTML here</div>","attachments":[
+  {"path":"photos/olive-top.jpg","label":"Olive button-up"},
+  {"path":"research/note-96.md","label":"Note 96: Seregin Analysis"}
+]}
+```
+Supported: images (.png/.jpg/.gif/.webp), audio (.mp3/.wav/.webm), video (.mp4), documents (.pdf/.md/.txt/.csv/.json/.svg). Old `images` format still works (backward compat).
+FATHOM_EOF
+
+python3 -c "
+import json, sys
+print(json.dumps({
+    'hookSpecificOutput': {
+        'hookEventName': 'SessionStart',
+        'additionalContext': sys.argv[1]
+    }
+}))
+" "$INSTRUCTIONS"
+
+exit 0

package/src/cli.js

@@ -154,21 +154,6 @@ function copyScripts(targetDir) {
   }
 }
 
-function buildIntegrationPrompt(blob) {
-  return [
-    "The following instructions were generated by fathom-mcp init for this project.",
-    "Add them to the file where you store persistent behavioral instructions",
-    "(e.g. CLAUDE.md for Claude Code). If the file exists, read it first and",
-    "integrate the new section without removing existing content. If a section",
-    "with the same heading already exists, replace it. If no instructions file",
-    "exists yet, create one.",
-    "",
-    "--- INSTRUCTIONS ---",
-    blob,
-    "--- END ---",
-  ].join("\n");
-}
-
 /**
  * Check if fathom-server is available on PATH.
  * Returns "installed" or "not-found".
@@ -182,29 +167,6 @@ function detectFathomServer() {
   }
 }
 
-// Agent commands for non-interactive prompt integration (init --non-interactive)
-const AGENT_PROMPT_CMDS = {
-  "claude-code": (prompt) => ["claude", "-p", "--dangerously-skip-permissions", prompt],
-  "gemini":      (prompt) => ["gemini", prompt],
-};
-
-function runAgentPrompt(agentKey, prompt) {
-  const cmdBuilder = AGENT_PROMPT_CMDS[agentKey];
-  if (!cmdBuilder) return null;
-  const [cmd, ...args] = cmdBuilder(prompt);
-  try {
-    const result = execFileSync(cmd, args, {
-      cwd: process.cwd(),
-      encoding: "utf8",
-      stdio: ["pipe", "pipe", "inherit"],
-      timeout: 60000,
-    });
-    return result;
-  } catch {
-    return null;
-  }
-}
-
 // --- CLI flag parsing --------------------------------------------------------
 
 function parseFlags(argv) {
@@ -572,6 +534,7 @@ async function runInit(flags = {}) {
   }
 
   // Hook scripts (central location, shared across agents)
+  const instructionsCmd = "bash ~/.config/fathom-mcp/scripts/fathom-instructions.sh";
   const sessionStartCmd = "bash ~/.config/fathom-mcp/scripts/fathom-sessionstart.sh";
   const recallCmd = "bash ~/.config/fathom-mcp/scripts/fathom-recall.sh";
   const precompactCmd = "bash ~/.config/fathom-mcp/scripts/fathom-precompact.sh";
@@ -582,6 +545,8 @@ async function runInit(flags = {}) {
     const settingsPath = path.join(cwd, ".claude", "settings.local.json");
     const settings = readJsonFile(settingsPath) || {};
     let changed = ensurePermissions(settings);
+    // Instructions hook always registered (injects tool reference tables)
+    changed = ensureHook(settings, "SessionStart", instructionsCmd, 5000) || changed;
     changed = ensureHook(settings, "SessionStart", sessionStartCmd, 10000) || changed;
     if (enableRecallHook) changed = ensureHook(settings, "UserPromptSubmit", recallCmd, 10000) || changed;
     if (enablePrecompactHook) changed = ensureHook(settings, "PreCompact", precompactCmd, 30000) || changed;
@@ -596,7 +561,8 @@ async function runInit(flags = {}) {
   if (hasGemini) {
     const settingsPath = path.join(cwd, ".gemini", "settings.json");
     const settings = readJsonFile(settingsPath) || {};
-    let changed = ensureHook(settings, "SessionStart", sessionStartCmd, 10000);
+    let changed = ensureHook(settings, "SessionStart", instructionsCmd, 5000);
+    changed = ensureHook(settings, "SessionStart", sessionStartCmd, 10000) || changed;
     if (enableRecallHook) changed = ensureHook(settings, "BeforeAgent", recallCmd, 10000) || changed;
     if (enablePrecompactHook) changed = ensureHook(settings, "PreCompress", precompactCmd, 30000) || changed;
     if (changed) {
@@ -683,79 +649,6 @@ async function runInit(flags = {}) {
     console.log(`\n  Non-interactive equivalent:\n    ${parts.join(" ")}\n`);
   }
 
-  // Auto-integrate agent instructions
-  const agentMdPath = agentMdDest;
-  let instructionsBlob = "";
-  try {
-    instructionsBlob = fs.readFileSync(agentMdPath, "utf-8");
-  } catch { /* file wasn't created — use empty */ }
-
-  const primaryAgent = selectedAgents[0];
-
-  if (instructionsBlob) {
-    const prompt = buildIntegrationPrompt(instructionsBlob);
-    const cmdBuilder = AGENT_PROMPT_CMDS[primaryAgent];
-
-    if (nonInteractive) {
-      if (cmdBuilder) {
-        console.log(`\n  Integrating instructions via ${AGENTS[primaryAgent].name}...`);
-        const result = runAgentPrompt(primaryAgent, prompt);
-        if (result !== null) {
-          console.log(result);
-        } else {
-          console.log("  Agent integration failed — paste these instructions manually:\n");
-          printInstructionsFallback(agentMdPath, selectedAgents);
-        }
-      } else {
-        printInstructionsFallback(agentMdPath, selectedAgents);
-      }
-    } else {
-      if (cmdBuilder) {
-        const [cmd, ...sampleArgs] = cmdBuilder("<prompt>");
-        const flagArgs = sampleArgs.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  ⚠  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();
-
-        if (integrate) {
-          console.log(`\n  Running ${AGENTS[primaryAgent].name}...`);
-          const result = runAgentPrompt(primaryAgent, prompt);
-          if (result !== null) {
-            console.log(result);
-          } else {
-            console.log("  Agent integration failed — paste these instructions manually:\n");
-            printInstructionsFallback(agentMdPath, selectedAgents);
-          }
-        } else {
-          printInstructionsFallback(agentMdPath, selectedAgents);
-        }
-      } else {
-        printInstructionsFallback(agentMdPath, selectedAgents);
-      }
-    }
-  } else {
-    console.log("\n  No agent instructions template found — skipping integration.\n");
-  }
-}
-
-function printInstructionsFallback(agentMdPath, selectedAgents) {
-  const hasNonClaude = selectedAgents.some((k) => k !== "claude-code");
-  const docTarget = hasNonClaude
-    ? "your CLAUDE.md, AGENTS.md, or equivalent"
-    : "your CLAUDE.md";
-
-  console.log(`
-  Agent instructions saved to: ${path.relative(process.cwd(), agentMdPath)}
-
-  Paste into ${docTarget}, or point your agent at the file
-  and ask it to integrate the instructions.
-`);
 }
 
 // --- Status command ----------------------------------------------------------
@@ -823,9 +716,10 @@ async function runUpdate() {
   const scriptsDir = path.join(process.env.HOME, ".config", "fathom-mcp", "scripts");
   const copiedScripts = copyScripts(scriptsDir);
 
-  // Ensure SessionStart hook is registered for agents that support hooks
+  // Ensure SessionStart hooks are registered for agents that support hooks
   // Detect by config agents field or directory presence (older configs may lack agents)
   const agents = found.config.agents || [];
+  const instructionsCmd = "bash ~/.config/fathom-mcp/scripts/fathom-instructions.sh";
   const sessionStartCmd = "bash ~/.config/fathom-mcp/scripts/fathom-sessionstart.sh";
   const registeredHooks = [];
 
@@ -836,6 +730,7 @@ async function runUpdate() {
     const settingsPath = path.join(projectDir, ".claude", "settings.local.json");
     const settings = readJsonFile(settingsPath) || {};
     let changed = ensurePermissions(settings);
+    changed = ensureHook(settings, "SessionStart", instructionsCmd, 5000) || changed;
     changed = ensureHook(settings, "SessionStart", sessionStartCmd, 10000) || changed;
     if (changed) {
       writeJsonFile(settingsPath, settings);
@@ -849,7 +744,9 @@ async function runUpdate() {
   if (hasGemini) {
     const settingsPath = path.join(projectDir, ".gemini", "settings.json");
     const settings = readJsonFile(settingsPath) || {};
-    if (ensureHook(settings, "SessionStart", sessionStartCmd, 10000)) {
+    let changed = ensureHook(settings, "SessionStart", instructionsCmd, 5000);
+    changed = ensureHook(settings, "SessionStart", sessionStartCmd, 10000) || changed;
+    if (changed) {
       writeJsonFile(settingsPath, settings);
       registeredHooks.push("Gemini CLI → .gemini/settings.json");
     }

package/src/index.js

@@ -253,77 +253,6 @@ const tools = [
   },
 ];
 
-// --- Telegram tools (primary agent only) -------------------------------------
-
-const telegramTools = [
-  {
-    name: "fathom_telegram_contacts",
-    description:
-      "List Telegram contacts who have messaged. Returns name, username, chat_id, " +
-      "last_message time, and unread count.",
-    inputSchema: { type: "object", properties: {} },
-  },
-  {
-    name: "fathom_telegram_read",
-    description:
-      "Read recent Telegram messages from a contact. Same windowing as fathom_room_read — " +
-      "anchored to latest message, default 60 minutes. Use start to look further back.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        contact: { type: "string", description: "Contact name, @username, or chat_id" },
-        minutes: { type: "number", description: "Window duration in minutes. Default: 60." },
-        start: { type: "number", description: "Offset in minutes from latest message. Default: 0." },
-        mark_read: { type: "boolean", description: "Mark messages as read. Default: true." },
-      },
-      required: ["contact"],
-    },
-  },
-  {
-    name: "fathom_telegram_send",
-    description:
-      "Send a Telegram message to a contact via the persistent Telethon client.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        contact: { type: "string", description: "Contact name, @username, or chat_id" },
-        message: { type: "string", description: "Message text to send" },
-      },
-      required: ["contact", "message"],
-    },
-  },
-  {
-    name: "fathom_telegram_image",
-    description:
-      "Read a Telegram message's attached image and return it as base64 so Claude can perceive it. " +
-      "Use after fathom_telegram_read shows a message has media: true. " +
-      "Supports jpg, jpeg, png, gif, webp. Max 5MB.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        message_id: { type: "number", description: "The message ID from fathom_telegram_read results" },
-      },
-      required: ["message_id"],
-    },
-  },
-  {
-    name: "fathom_telegram_send_image",
-    description:
-      "Send an image to a Telegram contact via the persistent Telethon client. " +
-      "Provide an absolute file path to a local image. Optionally include a caption. " +
-      "Contact can be a name, @username, or chat_id number.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        contact: { type: "string", description: "Contact name, @username, or chat_id" },
-        file_path: { type: "string", description: "Absolute path to the image file to send" },
-        caption: { type: "string", description: "Optional caption text for the image (max 1024 chars)" },
-      },
-      required: ["contact", "file_path"],
-    },
-  },
-];
-
 // --- Policy evaluation tool (permission-prompt-tool for stream-json) ---------
 
 const policyTools = [
@@ -362,7 +291,6 @@ const policyTools = [
 
 // --- Primary-agent-only tools (reserved for future use) ----------------------
 
-const primaryAgentTools = [];
 
 // --- Policy evaluation -------------------------------------------------------
 
@@ -433,17 +361,7 @@ const server = new Server(
 );
 
 server.setRequestHandler(ListToolsRequestSchema, async () => {
-  // Telegram tools only visible to primary agent workspace + human workspaces
-  let showTelegram = false;
-  try {
-    const settings = await client.getSettings();
-    const primaryAgent = settings.default_workspace;
-    const wsType = settings.workspaces?.[config.workspace]?.type;
-    showTelegram = config.workspace === primaryAgent || wsType === 'human';
-  } catch {
-    // If settings unavailable, hide telegram tools
-  }
-  const allTools = [...tools, ...policyTools, ...(showTelegram ? [...telegramTools, ...primaryAgentTools] : [])];
+  const allTools = [...tools, ...policyTools];
   return { tools: allTools };
 });
 
@@ -553,99 +471,6 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       break;
     }
 
-    // --- Telegram ---
-    case "fathom_telegram_contacts":
-      result = await client.telegramContacts(config.workspace);
-      break;
-    case "fathom_telegram_read": {
-      // Resolve contact name to chat_id via contacts list
-      const contacts = await client.telegramContacts(config.workspace);
-      const contactList = contacts?.contacts || [];
-      const contactArg = (args.contact || "").trim();
-      let chatId = parseInt(contactArg, 10);
-      if (isNaN(chatId)) {
-        const lower = contactArg.toLowerCase().replace(/^@/, "");
-        const match = contactList.find(c =>
-          (c.username || "").toLowerCase() === lower ||
-          (c.first_name || "").toLowerCase() === lower ||
-          (c.first_name || "").toLowerCase().includes(lower)
-        );
-        chatId = match ? match.chat_id : null;
-      }
-      if (!chatId) {
-        result = { error: `Contact not found: ${contactArg}. Use fathom_telegram_contacts to list known contacts.` };
-      } else {
-        result = await client.telegramRead(
-          chatId, args.minutes, args.start,
-          args.mark_read !== false ? config.workspace : undefined,
-          args.mark_read,
-        );
-      }
-      break;
-    }
-    case "fathom_telegram_send": {
-      const sendContacts = await client.telegramContacts(config.workspace);
-      const sendList = sendContacts?.contacts || [];
-      const sendArg = (args.contact || "").trim();
-      let sendChatId = parseInt(sendArg, 10);
-      if (isNaN(sendChatId)) {
-        const lower = sendArg.toLowerCase().replace(/^@/, "");
-        const match = sendList.find(c =>
-          (c.username || "").toLowerCase() === lower ||
-          (c.first_name || "").toLowerCase() === lower ||
-          (c.first_name || "").toLowerCase().includes(lower)
-        );
-        sendChatId = match ? match.chat_id : null;
-      }
-      if (!sendChatId) {
-        result = { error: `Contact not found: ${sendArg}. Use fathom_telegram_contacts to list known contacts.` };
-      } else {
-        result = await client.telegramSend(sendChatId, args.message);
-      }
-      break;
-    }
-    case "fathom_telegram_image": {
-      const msgId = args.message_id;
-      if (!msgId) {
-        result = { error: "message_id is required" };
-      } else {
-        // Check local WebSocket cache first (avoids HTTP round-trip for pushed images)
-        const cached = wsConn?.getCachedImage(msgId);
-        if (cached) {
-          result = { _image: true, data: cached.data, mimeType: cached.mimeType };
-        } else {
-          result = await client.telegramImage(msgId);
-          if (result?.data && result?.mimeType) {
-            result = { _image: true, data: result.data, mimeType: result.mimeType };
-          }
-        }
-      }
-      break;
-    }
-    case "fathom_telegram_send_image": {
-      const imgContactArg = args.contact;
-      if (!imgContactArg) { result = { error: "contact is required" }; break; }
-      if (!args.file_path) { result = { error: "file_path is required" }; break; }
-
-      const imgContacts = await client.telegramContacts(config.workspace);
-      const imgList = imgContacts?.contacts || [];
-      let imgChatId = parseInt(imgContactArg, 10);
-      if (isNaN(imgChatId)) {
-        const lower = imgContactArg.toLowerCase().replace(/^@/, "");
-        const match = imgList.find(c =>
-          (c.username || "").toLowerCase() === lower ||
-          (c.first_name || "").toLowerCase() === lower ||
-          (c.first_name || "").toLowerCase().includes(lower)
-        );
-        imgChatId = match ? match.chat_id : null;
-      }
-      if (!imgChatId) {
-        result = { error: `Contact not found: ${imgContactArg}. Use fathom_telegram_contacts to list known contacts.` };
-      } else {
-        result = await client.telegramSendImage(imgChatId, args.file_path, args.caption);
-      }
-      break;
-    }
     // --- Policy evaluation (permission-prompt-tool for stream-json agents) ---
     case "policy_evaluate": {
       result = await evaluatePermission(args.tool_name, args.input || {});

package/src/server-client.js

@@ -228,46 +228,6 @@ export function createClient(config) {
     return request("POST", `/api/workspaces/${encodeURIComponent(ws)}/heartbeat`, { body });
   }
 
-  // --- Telegram --------------------------------------------------------------
-
-  async function telegramContacts(ws) {
-    return request("GET", "/api/telegram/contacts", {
-      params: { workspace: ws },
-    });
-  }
-
-  async function telegramRead(chatId, minutes, start, ws, markRead) {
-    return request("GET", `/api/telegram/messages/${chatId}`, {
-      params: { minutes, start, workspace: ws, mark_read: markRead },
-    });
-  }
-
-  async function telegramSend(chatId, message) {
-    return request("POST", `/api/telegram/send/${chatId}`, {
-      body: { message },
-    });
-  }
-
-  async function telegramImage(messageId) {
-    return request("GET", `/api/telegram/image/${messageId}`);
-  }
-
-  async function telegramSendImage(chatId, filePath, caption) {
-    return request("POST", `/api/telegram/send-image/${chatId}`, {
-      body: { file_path: filePath, caption: caption || "" },
-    });
-  }
-
-  async function telegramSendVoice(chatId, filePath, caption) {
-    return request("POST", `/api/telegram/send-voice/${chatId}`, {
-      body: { file_path: filePath, caption: caption || "" },
-    });
-  }
-
-  async function telegramStatus() {
-    return request("GET", "/api/telegram/status");
-  }
-
   // --- TTS ------------------------------------------------------------------
 
   async function speak({ text, file, speed, play, format } = {}) {
@@ -333,13 +293,6 @@ export function createClient(config) {
     deleteRoutine,
     fireRoutine,
     heartbeat,
-    telegramContacts,
-    telegramRead,
-    telegramSend,
-    telegramImage,
-    telegramSendImage,
-    telegramSendVoice,
-    telegramStatus,
     speak,
     voiceReply,
     getSettings,

package/src/ws-connection.js

@@ -2,7 +2,6 @@
  * WebSocket push channel — receives server-pushed messages and handles them locally.
  *
  * Connects to fathom-server's /ws/agent/{workspace} endpoint. Receives:
- *   - image → cache base64 data to .fathom/telegram-cache/
  *   - ping → respond with pong
  *
  * Stream-json agents handle inject/ping_fire via subprocess stdin — the server
@@ -11,19 +10,15 @@
  * Auto-reconnects with exponential backoff (1s → 60s cap).
  */
 
-import fs from "fs";
-import os from "os";
-import path from "path";
 import WebSocket from "ws";
 
 const KEEPALIVE_INTERVAL_MS = 30_000;
 const INITIAL_RECONNECT_MS = 1_000;
 const MAX_RECONNECT_MS = 60_000;
-const IMAGE_CACHE_MAX_AGE_MS = 7 * 24 * 60 * 60 * 1000; // 7 days
 
 /**
  * @param {object} config — resolved config from config.js
- * @returns {{ getCachedImage: (messageId: number) => {data: string, mimeType: string} | null, close: () => void }}
+ * @returns {{ close: () => void }}
  */
 export function createWSConnection(config) {
   const workspace = config.workspace;
@@ -37,17 +32,11 @@ export function createWSConnection(config) {
     .replace(/^https:/, "wss:")
     + `/ws/agent/${encodeURIComponent(workspace)}`;
 
-  // Image cache directory
-  const cacheDir = path.join(os.homedir(), ".fathom", "telegram-cache");
-
   let ws = null;
   let reconnectDelay = INITIAL_RECONNECT_MS;
   let keepaliveTimer = null;
   let closed = false;
 
-  // Clean up old cached images on startup
-  cleanupImageCache();
-
   connect();
 
   function connect() {
@@ -98,10 +87,6 @@ export function createWSConnection(config) {
           console.error(`[ws] received ${msg.type} (${(msg.text || "").length} chars) — handled by server subprocess`);
           break;
 
-        case "image":
-          cacheImage(msg);
-          break;
-
         case "ping":
           safeSend({ type: "pong" });
           break;
@@ -158,57 +143,6 @@ export function createWSConnection(config) {
     reconnectDelay = Math.min(reconnectDelay * 2, MAX_RECONNECT_MS);
   }
 
-  // ── Image cache ─────────────────────────────────────────────────────────────
-
-  function cacheImage(msg) {
-    if (!msg.message_id || !msg.data) return;
-
-    try {
-      fs.mkdirSync(cacheDir, { recursive: true });
-      const ext = (msg.filename || "").split(".").pop() || "jpg";
-      const filename = `${msg.message_id}.${ext}`;
-      const filePath = path.join(cacheDir, filename);
-      fs.writeFileSync(filePath, Buffer.from(msg.data, "base64"));
-    } catch {
-      // Cache write failure is non-fatal
-    }
-  }
-
-  function getCachedImage(messageId) {
-    try {
-      const dir = fs.readdirSync(cacheDir);
-      const match = dir.find(f => f.startsWith(`${messageId}.`));
-      if (!match) return null;
-
-      const filePath = path.join(cacheDir, match);
-      const data = fs.readFileSync(filePath);
-      const ext = path.extname(match).slice(1).toLowerCase();
-      const mimeMap = { jpg: "image/jpeg", jpeg: "image/jpeg", png: "image/png", gif: "image/gif", webp: "image/webp" };
-      return {
-        data: data.toString("base64"),
-        mimeType: mimeMap[ext] || "image/jpeg",
-      };
-    } catch {
-      return null;
-    }
-  }
-
-  function cleanupImageCache() {
-    try {
-      if (!fs.existsSync(cacheDir)) return;
-      const now = Date.now();
-      for (const file of fs.readdirSync(cacheDir)) {
-        const filePath = path.join(cacheDir, file);
-        const stat = fs.statSync(filePath);
-        if (now - stat.mtimeMs > IMAGE_CACHE_MAX_AGE_MS) {
-          fs.unlinkSync(filePath);
-        }
-      }
-    } catch {
-      // Cleanup failure is non-fatal
-    }
-  }
-
   function close() {
     closed = true;
     stopKeepalive();
@@ -218,5 +152,5 @@ export function createWSConnection(config) {
     }
   }
 
-  return { getCachedImage, close };
+  return { close };
 }