@opennous/mcp 0.42.0 → 0.43.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opennous/mcp",
-  "version": "0.42.0",
+  "version": "0.43.0",
   "description": "Nous — the Context Graph for AI Agents.",
   "license": "AGPL-3.0-only",
   "repository": {

package/src/server.js

@@ -89,9 +89,9 @@ const pct     = (c) => `${Math.round((c ?? 0) * 100)}%`;
 // Gong/Granola). Returned by get_routing_preferences; the agent writes it into
 // the user's CLAUDE.md (Claude Code) or the user pastes it into claude.ai org
 // preferences. Mirrors the Install page's "short" version.
-const ROUTING_PREFERENCES = `# Nous is this workspace's customer graph
+const ROUTING_PREFERENCES = `# Nous is this workspace's GTM context graph
 
-Nous is our customer graph for GTM. It resolves every person, conversation, and
+Nous is our context graph for GTM. It resolves every person, conversation, and
 touchpoint across our GTM tool stack into one account record, with each fact's
 confidence and freshness, the full interaction timeline, a 0-100 ICP fit score on
 every account, plus our own ICP, positioning, and pricing. Agents read engineered
@@ -249,11 +249,27 @@ export function createServer() {
     "get_account",
     "Get the full account record for a person or company — the durable FACTS we've learned about them " +
     "(their atomic memory: budget, authority, pain, stack, plans), every attribute (claim) with its " +
-    "confidence and freshness, plus the recent activity timeline. Pass an email or entity UUID. " +
-    "For a task-specific, ranked view, prefer get_context.",
-    { id: z.string().describe("Email address or entity UUID") },
-    async ({ id }) => {
-      const rec = await get(`/v2/accounts/${encodeURIComponent(id)}`);
+    "confidence and freshness, plus what they actually SAID and did, ranked by how much it tells you. " +
+    "Pass an email or entity UUID, and the intent you're working toward so the record is shaped for it.",
+    {
+      id: z.string().describe("Email address or entity UUID"),
+      intent: z
+        .enum(["meeting_prep", "call_prep", "account_review", "follow_up", "draft_email"])
+        .optional()
+        .describe(
+          "What you're about to do. Shapes how much of their history comes back: a meeting brief wants " +
+          "the conversation in detail, an email draft wants one hook. Defaults to account_review.",
+        ),
+    },
+    async ({ id, intent }) => {
+      // Ask for the RANKED record, not the raw one.
+      //
+      // The timeline this tool used to print was chronological and contentless —
+      // "3d ago  email_sent" — which tells an agent that something happened and
+      // nothing about what. Ranked activity carries the source and the substance,
+      // so the model reads what was actually said instead of a list of event names.
+      const q = new URLSearchParams({ intent: intent ?? "account_review", compress: "1" });
+      const rec = await get(`/v2/accounts/${encodeURIComponent(id)}?${q}`);
       const lines = [`${rec.type} · ${rec.entity_id}`, ""];
 
       if (rec.icp) {
@@ -275,13 +291,37 @@ export function createServer() {
         }
         lines.push("");
       }
-      const obs = rec.recent_observations ?? [];
-      if (obs.length) {
+      // What they actually said and did — the most telling first, each with the
+      // system it came from, so a claim in the answer can always be traced back.
+      const activity = rec.key_activity ?? [];
+      if (activity.length) {
+        lines.push(`WHAT HAPPENED (${activity.length} most telling):`);
+        for (const a of activity) {
+          const when = a.when ? relAge(a.when) : "";
+          const head = `  ${a.what}${a.source ? ` · ${a.source}` : ""}${when ? ` · ${when}` : ""}`;
+          lines.push(a.detail ? `${head}\n      ${a.detail}` : head);
+        }
+        lines.push("");
+      }
+
+      // Say what was left out, and why. An agent that is handed 18 of 300
+      // interactions and does not know it will happily conclude that nothing else
+      // ever happened.
+      const sum = rec.activity_summary;
+      if (sum?.note) lines.push(sum.note);
+      else if (sum?.total_observations) {
+        lines.push(`${sum.total_observations} interactions on record.`);
+      }
+
+      // Fall back to the raw timeline if an older API didn't rank anything.
+      if (!activity.length && rec.recent_observations?.length) {
+        const obs = rec.recent_observations;
         lines.push(`TIMELINE (${obs.length}):`);
         for (const o of obs.slice(0, 30)) {
           lines.push(`  ${whenLabel(o.property, o.observed_at)}  ${fmtType(o.property)}`);
         }
       }
+
       return { content: [{ type: "text", text: lines.join("\n").trim() }] };
     }
   );
@@ -507,9 +547,15 @@ export function createServer() {
         return { content: [{ type: "text", text: "Nothing needs attention right now." }] };
       }
       // Upcoming meetings carry a `when` — render the absolute local date+time.
+      //
+      // Each item also names where it came from: the calendar holding the call, the
+      // transcript the promise was captured from. An agent that can cite the call
+      // someone made a promise ON is making an argument; one that just asserts the
+      // promise is asking to be trusted.
       const lines = r.items.map(it => {
         const when = it.when ? `${fmtWhen(it.when)} — ` : "";
-        return `  ${when}${it.entity_name ?? it.entity_id} — ${it.what}\n      → ${it.suggested_action}`;
+        const from = it.source ? `  [${it.source}]` : "";
+        return `  ${when}${it.entity_name ?? it.entity_id} — ${it.what}${from}\n      → ${it.suggested_action}`;
       });
       return { content: [{ type: "text", text: `Needs attention (${r.items.length}):\n${lines.join("\n")}` }] };
     }
@@ -638,6 +684,11 @@ export function createServer() {
     "whenever you edit a policy file in the repo (e.g. references/voice.md, outreach rules), passing the " +
     "file's new content and its path, so Nous mirrors it and every other agent obeys the same rules. An " +
     "edited playbook file that isn't synced is silently inert — other agents keep reading the old rules. " +
+    "MIRROR, DO NOT REWRITE: when the user already has a playbook file, sync it AS-IS. Their file is the " +
+    "author and Nous is the mirror — always pass file_path so the next sync knows where an in-app edit " +
+    "lands. 'Improving' their wording on the way through means the copy in Nous silently disagrees with " +
+    "the copy in their repo, and they will trust neither. If a file looks wrong, SAY SO; don't fix it in " +
+    "transit. " +
     "(For the ICP/context files specifically, sync_icp is the sync — use that one.)",
     syncPlaybookSchema, syncPlaybookHandler);
 
@@ -752,7 +803,19 @@ export function createServer() {
 
       const mark = (b) => (b ? "✓" : "✗");
       lines.push("SETUP:");
-      lines.push(`  ${mark(setup.onboarding?.done)} Onboarding${setup.onboarding?.done ? "" : ` — missing ${(setup.onboarding?.missing ?? []).join(", ") || "details"}`}`);
+      // The ICP first, because it IS the gate — a workspace without one is not set up, no
+      // matter how many integrations are green. If it's mirrored from a file in their repo,
+      // say so and say where: that file is the author, and editing anything else is a way of
+      // losing their work on the next sync.
+      const icp = setup.icp ?? {};
+      lines.push(
+        `  ${mark(icp.done)} ICP${icp.done
+          ? (icp.source === "claude_code" && icp.file_path
+              ? ` — mirrored from ${icp.file_path} (their repo is the author; edit the FILE, then sync)`
+              : " — authored in Nous")
+          : " — MISSING. The workspace is not set up until this exists. Scan their repo before you ask them anything."}`
+      );
+      lines.push(`  ${mark(setup.onboarding?.done)} Profile${setup.onboarding?.done ? "" : ` — missing ${(setup.onboarding?.missing ?? []).join(", ") || "details"}`}`);
       lines.push(`  ${mark(setup.gtm_playbook?.done)} GTM playbook${setup.gtm_playbook?.model ? " (scoring model live)" : ""}${setup.gtm_playbook?.stale_facts ? ` · ${setup.gtm_playbook.stale_facts} stale fact(s)` : ""}`);
       if (setup.icp_sync) {
         const sy = setup.icp_sync;