@edda-business/mcp 0.75.1 → 0.76.0

package/package.json

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

package/src/server.js

@@ -222,6 +222,9 @@ export function createServer() {
           const label = String(c.predicate ?? "").replace(/[_:]/g, " ");
           lines.push(`[claim] ${c.subject ? `${c.subject} · ` : ""}${label}${mark}${infer}: ${c.object}`);
           lines.push(`  as of ${String(c.as_of ?? "").slice(0, 10)} · evidence ${c.source?.kind}:${c.source?.id}`);
+          // The id is what opens the evidence. Without it the agent can repeat what the company
+          // believes and cannot say why — the gap explain_claim exists to close.
+          if (c.id) lines.push(`  claim id: ${c.id}   ← pass this to explain_claim`);
         }
         lines.push("");
       }
@@ -245,6 +248,65 @@ export function createServer() {
     },
   );
 
+  // ===========================================================================
+  // TOOL: explain_claim  —  GET /v2/company/claims/:id/evidence
+  // "Why does Edda believe this?", for an agent. The browser has had this since EDDA-153; a seat
+  // could only repeat the claim.
+  // ===========================================================================
+  server.tool(
+    "explain_claim",
+    "WHY the company believes a claim: how firm it is, when it became true vs when Edda recorded " +
+    "it, the sources you may open, how it was approved, and what it replaced. Take the `claim id` " +
+    "from a search result. " +
+    "Use it before repeating a company fact that carries weight — a figure in a document you are " +
+    "drafting, anything a person will act on, or when a claim looks stale or surprising. " +
+    "Say what it says: if it reports no excerpt, the wording has NOT been checked against the " +
+    "source, and you must not present the claim as quoted. Never invent supporting text.",
+    { claim_id: z.string().describe("The claim id, printed as `claim id:` in search results.") },
+    async ({ claim_id }) => {
+      try {
+        const r = await get(`/v2/company/claims/${encodeURIComponent(claim_id)}/evidence`);
+        const c = r?.claim ?? {};
+        const day = (d) => (d ? String(d).slice(0, 10) : "—");
+        const lines = [
+          `${c.subject?.name ? `${c.subject.name} · ` : ""}${String(c.predicate ?? "").replace(/[_:]/g, " ")}: ${c.object}`,
+          `standing: ${c.standing}${c.confidence === "inferred" ? " · inferred (read between the lines, not stated)" : ""} · ${c.state === "superseded" ? "NO LONGER CURRENT" : "current"}`,
+          `true as of ${day(c.as_of)} · recorded by Edda ${day(c.recorded_at)}`,
+          "",
+        ];
+        lines.push(r?.excerpt?.text
+          ? `Supporting passage (checked word for word against the source):\n  "${r.excerpt.text}"`
+          : "Supporting passage: NONE RECORDED — the source below is where it came from, but nobody checked that it says this in these words. Do not quote it.");
+        if (r?.excerpt_rejected && !r?.excerpt?.text) lines.push("  (a quotation was proposed and was not found in the document, so it was dropped)");
+        lines.push("");
+        const sources = r?.sources ?? [];
+        lines.push(sources.length ? "Sources:" : "Sources: none you can open.");
+        for (const s of sources) {
+          if (s.available === false && s.reason === "missing") { lines.push("  · a cited document that no longer exists"); continue; }
+          lines.push(`  · ${s.name}${s.primary ? " (primary)" : ""}${s.changed_since === true ? " — EDITED since this claim was recorded" : ""}`);
+          if (s.id) lines.push(`    id: ${s.id}   ← pass this to read`);
+        }
+        const a = r?.approval ?? {};
+        const who = (p) => p?.name || (p?.id ? "a team member" : null);
+        lines.push("", a.kind === "inbox_approval"
+          ? `Approved in the Inbox${a.auto_filed ? " automatically" : ` by ${who(a.by) ?? "an admin"}`} on ${day(a.at)}${who(a.submitted_by) ? `, proposed by ${who(a.submitted_by)}` : ""}.`
+          : a.kind === "direct_write"
+            ? `Written directly into the project's knowledge by ${who(a.by) ?? "an admin"} on ${day(a.at)}.`
+            : `Recorded ${day(a.at)}. No approval record exists.`);
+        const h = r?.history ?? {};
+        if (h.replaced?.length) lines.push(`Replaced: ${h.replaced.map((x) => `"${x.object}"`).join(", ")}`);
+        if (h.replaced_by?.length) lines.push(`Replaced by: ${h.replaced_by.map((x) => `"${x.object}"`).join(" → ")}`);
+        if (h.alongside?.length) lines.push(`Also current at a different standing: ${h.alongside.map((x) => `"${x.object}" (${x.standing})`).join(", ")}`);
+        return text(lines.join("\n"));
+      } catch (e) {
+        const msg = String(e?.message || e);
+        if (msg.includes("(404)")) return text("No such claim, or it is not one this seat may read. Claims about people and companies are admin-only for now.");
+        if (msg.includes("(403)")) return text("This seat cannot read company claims.");
+        throw e;
+      }
+    },
+  );
+
   // ===========================================================================
   // TOOL: read  —  GET /v2/company/pages/:id
   // Read one full wiki page. Take the `path:` from a search result, or an id.