@edda-business/mcp 0.56.0 → 0.57.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@edda-business/mcp",
-  "version": "0.56.0",
+  "version": "0.57.0",
   "description": "Edda — the company data layer for AI agents.",
   "license": "Apache-2.0",
   "repository": {

package/src/server.js

@@ -13,7 +13,7 @@
  * Tools, by group (v0.56 — consolidated, Cerebras-style):
  *   RETRIEVE  search (unified, scope=all|company|personal|notes) · get_context ·
  *             get_account · who_knows · query · attention · verify
- *   WRITE     save_note · save_to_vault · propose_company_file
+ *   WRITE     save_note · save_to_vault · update_vault_file · propose_company_file
  *   FIX       merge_contacts (action=merge|split)
  *   RUN       list_integrations · connect_integration
  *
@@ -26,7 +26,7 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { z } from "zod";
 import { get, post, del } from "./client.js";
 
-export const SERVER_VERSION = "0.56.0";
+export const SERVER_VERSION = "0.57.0";
 
 // ─── helpers ──────────────────────────────────────────────────────────────────
 
@@ -610,7 +610,7 @@ export function createServer() {
     },
     async ({ folder, name, content, subfolder }) => {
       const r = await post("/v2/personal/files", { folder, name, content, subfolder });
-      return { content: [{ type: "text", text: `Saved "${name}" to your ${r?.folder || folder} vault — it's searchable now.` }] };
+      return { content: [{ type: "text", text: `"${name}" is waiting in your Inbox to approve — once you do, it files into ${r?.folder || folder}.` }] };
     },
   );
 
@@ -800,13 +800,14 @@ export function createServer() {
   // ===========================================================================
   server.tool(
     "save_to_vault",
-    "Save a file into the MEMBER'S OWN private knowledge vault, in a folder they name " +
-    "(inbox, projects, decisions, companies, people, resources, archive, thoughts). Use it when the " +
-    "member asks you to keep or file something for them — 'save this to projects', 'put this PDF in " +
-    "resources'. Pass markdown/text as `content`, OR a PDF/DOCX as base64 in `file` (it's extracted to " +
-    "text automatically and stored so they can search it later). PRIVATE to the member — nothing is " +
-    "shared until they promote it to their department. NOT the shared company vault (use " +
-    "propose_company_file), NOT a note on a contact (use save_note).",
+    "Save a file into the MEMBER'S OWN private knowledge vault. It lands in their INBOX for review " +
+    "with the target folder you name remembered (inbox, projects, decisions, companies, people, " +
+    "resources, archive, thoughts); the member approves it in the app, which files it into that folder " +
+    "and makes it searchable. Nothing enters their knowledge without their approval. Use it when the " +
+    "member asks you to keep or file something — 'save this to resources', 'put this PDF in projects'. " +
+    "Pass markdown/text as `content`, OR a PDF/DOCX as base64 in `file` (extracted to text automatically). " +
+    "PRIVATE to the member. NOT the shared company vault (use propose_company_file), NOT a note on a " +
+    "contact (use save_note).",
     {
       folder: z.string().describe("The vault folder: inbox | projects | decisions | companies | people | resources | archive | thoughts."),
       name: z.string().describe("The file name, e.g. 'Q3 Plan.md' or 'vendor-contract.pdf'."),
@@ -818,7 +819,7 @@ export function createServer() {
     async ({ folder, name, content, file, mime, subfolder }) => {
       try {
         const r = await post("/v2/personal/files", { folder, name, content, file_base64: file, mime, subfolder });
-        return { content: [{ type: "text", text: `Saved "${name}" to your ${r?.folder || folder} vault — it's searchable now.` }] };
+        return { content: [{ type: "text", text: `"${name}" is waiting in your Inbox to approve — once you do, it files into ${r?.folder || folder} and becomes searchable.` }] };
       } catch (e) {
         const msg = String(e?.message || e);
         if (msg.includes("no_text_extracted")) return { content: [{ type: "text", text: `Couldn't read any text from that file — a scanned/image-only PDF has no extractable text. Text, markdown, or a text-based PDF/DOCX works.` }] };
@@ -828,6 +829,40 @@ export function createServer() {
     }
   );
 
+  // ===========================================================================
+  // TOOL: update_vault_file  —  POST /v2/personal/files/update
+  // Edit an existing personal file. Snapshots the old content to version history,
+  // then replaces/appends + re-embeds. save_to_vault is for NEW files (→ Inbox);
+  // this edits one that's already live.
+  // ===========================================================================
+  server.tool(
+    "update_vault_file",
+    "Edit an EXISTING file in the member's own vault — revise it or append to it. Identify the file by " +
+    "`file_id` (from a search or save result) or by `path` ('folder/[subfolder/]name.md'). The previous " +
+    "content is saved to version history FIRST (never lost), then your new content replaces it — or is added " +
+    "to the end with append:true — and the file is re-embedded; the member sees a fresh 'updated' time. Use " +
+    "this to keep a living document current: a rolling brief, a spec, a running log. For a NEW file use " +
+    "save_to_vault (which lands in the Inbox for approval); this edits one that already exists and is live.",
+    {
+      file_id: z.string().optional().describe("The file's id (from a search/save result). Provide this OR path."),
+      path: z.string().optional().describe("The file's vault path, e.g. 'resources/Edda Architecture.md'. Provide this OR file_id."),
+      content: z.string().describe("The new markdown content. Replaces the file's content unless append is true."),
+      append: z.boolean().optional().describe("If true, append this to the end of the file instead of replacing it."),
+    },
+    async ({ file_id, path, content, append }) => {
+      try {
+        const r = await post("/v2/personal/files/update", { file_id, path, content, append });
+        return { content: [{ type: "text", text: r?.note || "Updated the file." }] };
+      } catch (e) {
+        const msg = String(e?.message || e);
+        if (msg.includes("not_found")) return { content: [{ type: "text", text: "Couldn't find that file — check the file_id or path (folder/name.md)." }] };
+        if (msg.includes("file_id_or_path_required")) return { content: [{ type: "text", text: "Tell me which file to edit — pass file_id or path." }] };
+        if (msg.includes("content_required")) return { content: [{ type: "text", text: "Give me the new content to write." }] };
+        throw e;
+      }
+    }
+  );
+
   server.tool(
     "list_integrations",
     "List the integrations connected to this workspace (Gmail, HubSpot, Apollo, Instantly, LinkedIn, …) " +