@edda-business/mcp 0.64.0 → 0.65.0

package/package.json

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

package/src/server.js

@@ -20,11 +20,11 @@
  *     + embeds them. You only RETRIEVE them (they surface in search tagged ·distilled).
  *
  * TOOLS:
- *   search_company        RETRIEVE across BOTH natures (documents + distilled), kind filter
- *   read_company_page     read one full wiki page (by path from a search result, or id)
- *   push_company_file     PUSH one or many files up into the company folders (shared wiki)
- *   update_company_page   edit an existing wiki page (replace or append)
- *   create_company_folder organize the wiki tree
+ *   search        RETRIEVE across BOTH natures (documents + distilled), kind filter
+ *   read     read one full wiki page (by path from a search result, or id)
+ *   push     PUSH one or many files up into the company folders (shared wiki)
+ *   update   edit an existing wiki page (replace or append)
+ *   create organize the wiki tree
  *
  * Sources (connecting Slack/HubSpot/… so distillation happens) are wired in the Edda web
  * app, not here — the agent only reads and writes knowledge.
@@ -34,7 +34,7 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { z } from "zod";
 import { get, post, patch } from "./client.js";
 
-export const SERVER_VERSION = "0.64.0";
+export const SERVER_VERSION = "0.65.0";
 
 // ─── helpers ──────────────────────────────────────────────────────────────────
 
@@ -63,7 +63,7 @@ async function resolvePathToId(path) {
   const pages = list?.pages ?? [];
   const base = norm(String(path).split("/").pop());
   let cands = pages.filter((p) => norm(p.name) === base);
-  if (!cands.length) return { error: `No company page named "${String(path).split("/").pop()}". Use search_company to find the exact path first.` };
+  if (!cands.length) return { error: `No company page named "${String(path).split("/").pop()}". Use search to find the exact path first.` };
   if (cands.length > 1) {
     // Prefer a candidate whose folder slug appears in the requested path.
     const pref = cands.filter((p) => p.folder && norm(path).includes(norm(p.folder)));
@@ -87,7 +87,7 @@ export function createServer() {
       "Edda — the company's shared knowledge for AI agents. Search the company wiki (declared " +
       "policies, playbooks, decisions) AND distilled knowledge from connected sources (Slack, " +
       "HubSpot, calls) in one call; read a full page; and contribute pages/folders back. Reach " +
-      "for search_company before answering from generic knowledge. (Personal files live on the " +
+      "for search before answering from generic knowledge. (Personal files live on the " +
       "user's own disk; this is the shared company layer only.)",
     icons: [
       { src: "https://opennous.cloud/newlogoP.png", mimeType: "image/png", sizes: ["64x64"] },
@@ -95,18 +95,18 @@ export function createServer() {
   });
 
   // ===========================================================================
-  // TOOL: search_company  —  POST /v2/company/search
+  // TOOL: search  —  POST /v2/company/search
   // The primary read surface. Hybrid retrieval (RRF + rerank) fused across the DECLARED wiki
   // and the DERIVED distilled layer, ACL-filtered. `kind` narrows to one nature.
   // ===========================================================================
   server.tool(
-    "search_company",
+    "search",
     "Search the COMPANY'S SHARED KNOWLEDGE in one call — both natures at once: the DECLARED wiki " +
     "(policies, playbooks, decisions, SOPs, how-we-work) AND DERIVED knowledge distilled from " +
     "connected sources (Slack, HubSpot, Stripe, calls). This is the default retrieval tool: reach " +
     "for it before answering from generic knowledge about how the company works or what happened. " +
     "Each hit is tagged [company] (a wiki page) or [company·distilled] (from activity), with a " +
-    "snippet; wiki hits include a `path:` you can pass to read_company_page for the full text. " +
+    "snippet; wiki hits include a `path:` you can pass to read for the full text. " +
     "Narrow with `kind`: 'documents' (wiki only), 'distilled' (activity only), or 'all' (default).",
     {
       question: z.string().describe("Natural-language query."),
@@ -132,7 +132,7 @@ export function createServer() {
         const tag = declared ? "[company]" : "[company·distilled]";
         const from = d.source_member ? ` · from ${d.source_member}` : "";
         lines.push(`${tag} ${String(d.name ?? "").replace(/\.md$/, "")}${from}  (${pct(d.similarity)})`);
-        if (declared && d.ref) lines.push(`  path: ${d.ref}`);          // pass to read_company_page
+        if (declared && d.ref) lines.push(`  path: ${d.ref}`);          // pass to read
         else if (d.ref) lines.push(`  source: ${d.ref}`);              // distilled: origin, read-only
         if (d.snippet) lines.push(`  ${d.snippet}`);
         lines.push("");
@@ -142,12 +142,12 @@ export function createServer() {
   );
 
   // ===========================================================================
-  // TOOL: read_company_page  —  GET /v2/company/pages/:id
-  // Read one full wiki page. Take the `path:` from a search_company result, or an id.
+  // TOOL: read  —  GET /v2/company/pages/:id
+  // Read one full wiki page. Take the `path:` from a search result, or an id.
   // ===========================================================================
   server.tool(
-    "read_company_page",
-    "Read the FULL text of one company wiki page — search_company returns snippets; use this to " +
+    "read",
+    "Read the FULL text of one company wiki page — search returns snippets; use this to " +
     "get the whole document. Pass the `path:` shown under a [company] search hit (e.g. " +
     "'Company/Policies/Refund Policy.md'), or an `id` if you already have one. Also returns the " +
     "page's LINK GRAPH — outgoing [[links]] and backlinks — so you can TRAVERSE the wiki to " +
@@ -164,7 +164,7 @@ export function createServer() {
         if (res.error) return text(res.error);
         pageId = res.id;
       }
-      if (!pageId) return text("Tell me which page to read — pass the `path` from a search_company result (its `path:` line), or an `id`.");
+      if (!pageId) return text("Tell me which page to read — pass the `path` from a search result (its `path:` line), or an `id`.");
       try {
         const r = await get(`/v2/company/pages/${encodeURIComponent(pageId)}`);
         const p = r?.page;
@@ -175,14 +175,14 @@ export function createServer() {
         const outgoing = p.ingest?.outgoing ?? [];
         const backlinks = p.ingest?.backlinks ?? [];
         if (outgoing.length || backlinks.length) {
-          out.push("", "---", "Links (read_company_page on any of these to traverse):");
+          out.push("", "---", "Links (read on any of these to traverse):");
           if (outgoing.length) out.push("  → links to: " + outgoing.map((l) => `${l.target}${l.resolved ? "" : " (unresolved)"}`).join(", "));
           if (backlinks.length) out.push("  ← linked from: " + backlinks.map((b) => b.source).join(", "));
         }
         return text(out.join("\n"));
       } catch (e) {
         const msg = String(e?.message || e);
-        if (msg.includes("not_found") || msg.includes("(404)")) return text("No page with that id — use search_company to find the path, then read it.");
+        if (msg.includes("not_found") || msg.includes("(404)")) return text("No page with that id — use search to find the path, then read it.");
         if (msg.includes("forbidden") || msg.includes("(403)")) return text("You don't have access to read that company page.");
         throw e;
       }
@@ -190,15 +190,15 @@ export function createServer() {
   );
 
   // ===========================================================================
-  // TOOL: push_company_file  —  POST /v2/company/pages/batch
+  // TOOL: push  —  POST /v2/company/pages/batch
   // PUSH one or many files UP into the shared company folders (the personal→company promotion).
   // Hybrid write policy: a write role publishes live; a viewer sends the batch to the company
   // inbox to approve.
   // ===========================================================================
   server.tool(
-    "push_company_file",
+    "push",
     "PUSH a file (or several) UP into the COMPANY WIKI — promote knowledge from your own work into " +
-    "the shared company folders every member's agent can read via search_company. Typically you " +
+    "the shared company folders every member's agent can read via search. Typically you " +
     "push a personal/working file up so the company has it. All pushed files go into the SAME " +
     "folder (resolved or created once). Name the target with `folder` — a name or path like " +
     "'Projects/Data Centre' (top-level folders are fixed; a bare name becomes a project under " +
@@ -233,16 +233,16 @@ export function createServer() {
   );
 
   // ===========================================================================
-  // TOOL: update_company_page  —  PATCH /v2/company/pages/:id
+  // TOOL: update  —  PATCH /v2/company/pages/:id
   // Edit an existing wiki page: replace its content, or append. Re-embeds on the server.
   // ===========================================================================
   server.tool(
-    "update_company_page",
+    "update",
     "Edit an EXISTING company wiki page — revise it or append to it. Identify the page by `path` " +
-    "(the `path:` from a search_company result) or `id`. By default the new `content` REPLACES the " +
+    "(the `path:` from a search result) or `id`. By default the new `content` REPLACES the " +
     "page; set append:true to add to the end instead (kept for a rolling log or a running doc). " +
     "You can also rename it with `name`. Re-embedded so search picks up the change. For a NEW page " +
-    "use push_company_file. Distilled items (from sources) are read-only and can't be edited here.",
+    "use push. Distilled items (from sources) are read-only and can't be edited here.",
     {
       path: z.string().optional().describe("The page path from a search result's `path:` line. Provide this OR id."),
       id: z.string().optional().describe("The page id (advanced). Provide this OR path."),
@@ -257,7 +257,7 @@ export function createServer() {
         if (res.error) return text(res.error);
         pageId = res.id;
       }
-      if (!pageId) return text("Tell me which page to edit — pass the `path` from a search_company result, or an `id`.");
+      if (!pageId) return text("Tell me which page to edit — pass the `path` from a search result, or an `id`.");
       try {
         const body = {};
         if (append) {
@@ -271,7 +271,7 @@ export function createServer() {
         return text(`Updated "${name ? name.replace(/\.md$/, "") : (path ? String(path).split("/").pop().replace(/\.md$/, "") : pageId)}"${append ? " (appended)" : ""} — re-embedded, searchable now.`);
       } catch (e) {
         const msg = String(e?.message || e);
-        if (msg.includes("not_found") || msg.includes("(404)")) return text("No editable page with that id — distilled items are read-only. Use search_company to find a wiki page.");
+        if (msg.includes("not_found") || msg.includes("(404)")) return text("No editable page with that id — distilled items are read-only. Use search to find a wiki page.");
         if (msg.includes("forbidden") || msg.includes("(403)")) return text("You don't have access to edit that company page.");
         throw e;
       }
@@ -279,17 +279,17 @@ export function createServer() {
   );
 
   // ===========================================================================
-  // TOOL: create_company_folder  —  POST /v2/company/folders
+  // TOOL: create  —  POST /v2/company/folders
   // Create a folder / nested path in the shared company tree so pages can be filed into it.
   // ===========================================================================
   server.tool(
-    "create_company_folder",
+    "create",
     "Create a folder in the COMPANY WIKI tree so you can file pages into it. The TOP-LEVEL folders " +
     "are FIXED (Company · Projects · Decisions · Companies · People · Raw Documents · Archive) — you " +
     "cannot add new ones. A bare name (or a path not starting with a fixed folder) becomes a PROJECT " +
     "under Projects: 'Agency' → Projects/Agency. To nest under a specific top-level folder, start the " +
     "path with it, e.g. 'Company/Policies' or 'Projects/Data Centre/Specs'. A write role is required; " +
-    "the folder appears immediately. Then push files into it with push_company_file using the same " +
+    "the folder appears immediately. Then push files into it with push using the same " +
     "path. Returns the folder id.",
     { path: z.string().describe("Folder name or path. A bare name → a project under Projects; 'Top-Level/Sub' nests under a fixed top-level folder.") },
     async ({ path }) => {