@opennous/mcp 0.47.0 → 0.49.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opennous/mcp",
-  "version": "0.47.0",
+  "version": "0.49.0",
   "description": "Nous — the Context Graph for AI Agents.",
   "license": "Apache-2.0",
   "repository": {

package/src/server.js

@@ -17,6 +17,7 @@
  *   WRITE   record · record_signal · save_note · propose_vault_file · merge_contacts ·
  *           sync_foundation
  *   ACT     send_linkedin_message
+ *   CORRECT retract_observation · delete_note · unmerge_contacts
  *   RUN     get_workspace_status · set_workspace_profile · build_icp_model · train_icp_model ·
  *           sync_icp · export_icp_model · connect_integration · configure_crm_sync ·
  *           sync_crm_now · scrape_engagers · get_routing_preferences
@@ -24,9 +25,9 @@
 
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { z } from "zod";
-import { get, post } from "./client.js";
+import { get, post, del } from "./client.js";
 
-export const SERVER_VERSION = "0.47.0";
+export const SERVER_VERSION = "0.49.0";
 
 // ─── helpers ──────────────────────────────────────────────────────────────────
 
@@ -405,12 +406,54 @@ export function createServer() {
         (r.relationships_repointed || r.relationships_removed)
           ? `  relationships: ${r.relationships_repointed} re-pointed, ${r.relationships_removed} pruned` : null,
         moved ? `  re-pointed: ${moved}` : null,
-        `The duplicate is now a reversible tombstone (merged into the survivor).`,
+        `Reversible: if this was wrong, unmerge_contacts with drop_id "${r.drop_id}" puts it all back.`,
       ].filter(Boolean);
       return { content: [{ type: "text", text: lines.join("\n") }] };
     }
   );
 
+  server.tool(
+    "unmerge_contacts",
+    "REVERSE a merge — split a wrongly-merged duplicate back out into its own account. Identify the " +
+    "merge to undo either by `drop_id` (the tombstone's id, exactly as merge_contacts reported it) or by " +
+    "`keep` (an identifier for the survivor — undoes the MOST RECENT merge into it). Every re-pointed " +
+    "identifier, claim, observation, relationship and the record itself go back where they were. " +
+    "Forward-only: it can only reverse merges made after reversible-merge tracking existed — an older " +
+    "merge returns a clear 'not reversible'. Use this when two DIFFERENT people were merged by mistake; " +
+    "it is not for editing a correctly-merged account.",
+    {
+      drop_id: z.string().optional().describe("The merged-away entity's id, from the merge_contacts result. Provide this OR keep."),
+      keep: z.string().optional().describe("The survivor (email, LinkedIn URL, entity UUID, or name) — undoes the most recent un-reversed merge into it."),
+    },
+    async ({ drop_id, keep }) => {
+      if (!drop_id && !keep) {
+        return { content: [{ type: "text", text: "Give me the drop_id from the merge result, or the `keep` survivor whose last merge to undo." }] };
+      }
+      try {
+        const r = await post("/v2/accounts/unmerge", { drop_id, keep });
+        if (r.status === "ambiguous") {
+          const opts = (r.candidates ?? []).map(c => `  • ${c.name ?? "(unnamed)"}  [${c.entity_id}]`).join("\n");
+          return { content: [{ type: "text", text: `"${keep}" matches several people. Re-call unmerge_contacts with one of these entity ids as keep:\n${opts}` }] };
+        }
+        const lines = [
+          `Un-merged — ${r.drop_id} is its own account again.`,
+          `  identifiers restored: ${r.identifiers}, claims: ${r.claims}, observations: ${r.observations}, relationships: ${r.relationships}`,
+          r.contact_restored ? `  the contact record was recreated.` : null,
+        ].filter(Boolean);
+        return { content: [{ type: "text", text: lines.join("\n") }] };
+      } catch (e) {
+        const msg = /not_reversible/.test(e.message)
+          ? "That merge can't be reversed — it predates reversible-merge tracking, or it was already un-merged."
+          : /no_reversible_merge/.test(e.message)
+          ? "No un-reversed merge on that survivor to undo."
+          : /entity_not_found/.test(e.message)
+          ? "Couldn't find that survivor — check the keep identifier."
+          : `Couldn't un-merge: ${e.message}`;
+        return { content: [{ type: "text", text: msg }] };
+      }
+    }
+  );
+
   // ===========================================================================
   // TOOL: record  —  POST /v2/observations
   // The single write verb. You observe — Nous derives the updated facts.
@@ -1595,6 +1638,62 @@ export function createServer() {
     }
   );
 
+  // ===========================================================================
+  // TOOLS: the CORRECTION layer — unsay something recorded by mistake. `record` and
+  // `save_note` are how you write; these are how you take it back. Both heal the
+  // derived layer: retracting an observation re-derives the claim from what remains,
+  // deleting a note drops it from search/context. DELETE /v2/observations|notes/:id.
+  // ===========================================================================
+  server.tool(
+    "retract_observation",
+    "RETRACT an observation you recorded by mistake, and heal the record. Pass the observation's " +
+    "`id` (returned by `record`). Nous deletes it and re-derives the affected fact from the " +
+    "observations that remain — so a wrong value you observed is un-observed and the claim reverts as " +
+    "if it had never happened; if it was the only observation for that fact, the fact is invalidated. " +
+    "Use this when you recorded the wrong thing (wrong value, wrong person, a test), NOT to represent a " +
+    "real change over time — a genuine change is a NEW `record`, which supersedes by recency.",
+    {
+      id: z.string().describe("The observation id to retract (from a prior `record` result)."),
+    },
+    async ({ id }) => {
+      try {
+        const r = await del(`/v2/observations/${encodeURIComponent(id)}`);
+        return { content: [{ type: "text", text:
+          `Observation retracted. The claim for ${r.property} was ${r.claim === "invalidated" ? "invalidated (no observations left)" : "re-derived from the remaining observations"}.` }] };
+      } catch (e) {
+        const msg = /observation_not_found/.test(e.message)
+          ? "No observation with that id in this workspace — check the id from the record result."
+          : `Couldn't retract the observation: ${e.message}`;
+        return { content: [{ type: "text", text: msg }] };
+      }
+    }
+  );
+
+  server.tool(
+    "delete_note",
+    "DELETE a note saved by mistake. Pass the note's `id` (returned by `save_note`). It's removed from " +
+    "search and context immediately; the timeline stays reconstructable. Only touches notes — it will " +
+    "refuse an id that isn't a note. Use this for a note saved in error; to CHANGE a note, save a new " +
+    "one instead.",
+    {
+      id: z.string().describe("The note id to delete (from a prior `save_note` result)."),
+    },
+    async ({ id }) => {
+      try {
+        const r = await del(`/v2/notes/${encodeURIComponent(id)}`);
+        return { content: [{ type: "text", text:
+          r.status === "already_deleted" ? "That note was already deleted." : "Note deleted — it's out of search and context now." }] };
+      } catch (e) {
+        const msg = /note_not_found/.test(e.message)
+          ? "No note with that id in this workspace — check the id from the save_note result."
+          : /not_a_note/.test(e.message)
+          ? "That id isn't a note, so it can't be deleted here. Only save_note notes can be deleted this way."
+          : `Couldn't delete the note: ${e.message}`;
+        return { content: [{ type: "text", text: msg }] };
+      }
+    }
+  );
+
   // ===========================================================================
   // TOOL: get_routing_preferences
   // The routing preferences that make THIS agent default to Nous for GTM. The