@opennous/mcp 0.58.0 → 0.59.0

package/package.json

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

package/src/server.js

@@ -29,7 +29,7 @@ const APP_URL = () => (process.env.NOUS_APP_URL || "https://app.opennous.cloud")
 const OAUTH_CONNECT = { gmail: "gmail", gmail_oauth: "gmail", google: "gmail", "google-mail": "gmail", googlemail: "gmail", linkedin: "linkedin" };
 const connectLink = (slug) => `${APP_URL()}/settings?section=integrations&connect=${slug}`;
 
-export const SERVER_VERSION = "0.57.0";
+export const SERVER_VERSION = "0.59.0";
 
 // ─── helpers ──────────────────────────────────────────────────────────────────
 
@@ -67,6 +67,24 @@ function whenLabel(type, ts) {
 }
 
 const fmtType = (p) => (p || "").replace(/^interaction\./, "").replace(/_/g, " ");
+// The EVIDENCE line under a fact: who said it, their verbatim words, and where it
+// came from. This is what makes a fact checkable instead of something the user has
+// to take on faith — the rep reads the actual sentence rather than trusting a
+// summary. Returns [] when there is nothing to show: facts recorded before evidence
+// capture shipped, and facts with nothing quotable (an attendee list, a CRM field),
+// so the block degrades quietly on historical data instead of looking broken.
+function evidenceLines(f) {
+  const out = [];
+  const who = f.speaker ? String(f.speaker).trim() : "";
+  const quote = f.quote ? String(f.quote).trim() : "";
+  const where = [f.source, f.date ? new Date(f.date).toISOString().slice(0, 10) : null]
+    .filter(Boolean).join(" \u00b7 ");
+  if (quote) out.push(`      ${who ? `${who} \u00b7 ` : ""}"${quote}"`);
+  else if (who) out.push(`      ${who}`);
+  if (where && (quote || who)) out.push(`      ${where}`);
+  return out;
+}
+
 const fmtVal  = (v) => (v != null && typeof v === "object") ? JSON.stringify(v) : String(v ?? "");
 const pct     = (c) => `${Math.round((c ?? 0) * 100)}%`;
 
@@ -92,7 +110,7 @@ export function createServer() {
   // Reads: get_context · get_account · query (search folds in via facts:true) · score.
   // Identity: whoami (who the key acts as, scope, GTM role[s]) — the governance
   // substrate. record_signal folds into record; save_note is out. The `tool()` guard
-  // keeps the surface locked to these seven — a stray non-primitive registration is
+  // keeps the surface locked to these eight — a stray non-primitive registration is
   // dropped, not exposed. See docs/revenue-plugin/README.md §2–3.
   const PLUGIN_TOOLS = new Set([
     "record", "record_insight", "get_context", "get_account", "query", "score", "whoami", "set_icp",
@@ -145,7 +163,10 @@ export function createServer() {
       if (ctx.facts?.length) {
         // Atomic memory — the durable, decision-relevant facts learned about them.
         lines.push(`FACTS (${ctx.facts.length} — durable memory about them):`);
-        for (const f of ctx.facts) lines.push(`  [${f.category}] ${f.content}${f.date ? `  (${relAge(f.date)})` : ""}`);
+        for (const f of ctx.facts) {
+          lines.push(`  [${f.category}] ${f.content}${f.date ? `  (${relAge(f.date)})` : ""}`);
+          for (const e of evidenceLines(f)) lines.push(e);
+        }
         lines.push("");
       }
       if (ctx.claims?.length) {
@@ -261,7 +282,10 @@ export function createServer() {
       if (rec.facts?.length) {
         // Atomic memory — the durable, decision-relevant facts learned about them.
         lines.push(`FACTS (${rec.facts.length} — durable memory about them):`);
-        for (const f of rec.facts) lines.push(`  [${f.category}] ${f.content}${f.date ? `  (${relAge(f.date)})` : ""}`);
+        for (const f of rec.facts) {
+          lines.push(`  [${f.category}] ${f.content}${f.date ? `  (${relAge(f.date)})` : ""}`);
+          for (const e of evidenceLines(f)) lines.push(e);
+        }
         lines.push("");
       }
       const docs = rec.documents ?? [];
@@ -357,8 +381,17 @@ export function createServer() {
     "about the contact — a preference, an objection, a competitor they mentioned, a general note — " +
     "use property:'intel' with a category: {kind:'state',property:'intel',value:{category:'objection'," +
     "content:'skeptical about market demand',label:'Market demand skepticism'}} (category ∈ " +
-    "preference | objection | competitor | buying_signal | budget | timing | authority | general). " +
-    "Insights about YOUR OWN business (product/positioning/market/buyer) go to record_insight, not here.",
+    "status_quo | goal | pain | objection | authority | budget | timeline | buying_signal | " +
+    "preference | competitor | discovery | relationship | general — use the MOST specific one; " +
+    "'general' is a last resort, and it's 'timeline', never 'timing'). " +
+    "Insights about YOUR OWN business (product/positioning/market/buyer) go to record_insight, not here. " +
+    "CLOSING THE LOOP — when you RECOMMEND an action, write the recommendation down before it happens: " +
+    "{kind:'state',property:'decision.proposed',value:{decision_id:'<your id>',proposal:'send a follow-up " +
+    "naming the security objection',action_type:'email_send',category:'outreach'}}. When the human answers, " +
+    "record the verdict: property 'decision.accepted' | 'decision.edited' | 'decision.rejected' with the same " +
+    "decision_id (pass drafted_body + sent_body on accepted and the edit is measured for you). Then pass that " +
+    "same decision_id on the interaction observation when the action fires. That is what turns advice into " +
+    "learnable data — without it a send is an orphan nobody can grade.",
     {
       focus: z.string().describe("Email address, LinkedIn URL, domain, or entity UUID — a precise identifier, never a bare name"),
       observations: z.array(z.object({
@@ -371,6 +404,7 @@ export function createServer() {
         external_id: z.string().optional().describe("idempotency key, unique per (source). Re-recording the same one is a no-op. One raw item → many observations → give each a distinct id, e.g. '<itemId>:<property>'."),
         source_ref: z.string().optional().describe("pointer to the raw this came from, e.g. 'git://<repo>/raw/fireflies/2026-03-14-9182.md'. Keeps provenance without storing raw in Nous."),
         content_hash: z.string().optional().describe("sha256 of the raw file, so a later fetch can be verified untampered. Set when raw lives in git (not sent here)."),
+        decision_id: z.string().optional().describe("the recommendation this action came from. Stamp it on the interaction observation you record when the action fires (an email send, a LinkedIn message) and Nous attributes whatever comes back — reply, meeting, bounce, silence — to that decision."),
       })).describe("One or more observations to record"),
     },
     async ({ focus, observations }) => {