@opennous/mcp 0.63.0 → 0.65.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@opennous/mcp",
-  "version": "0.63.0",
-  "description": "Nous \u2014 the Context Graph for AI Agents.",
+  "version": "0.65.0",
+  "description": "Nous — the Context Graph for AI Agents.",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
@@ -21,7 +21,7 @@
     "start": "node src/index.js",
     "dev:http": "node --watch src/http.js",
     "start:http": "node src/http.js",
-    "typecheck": "echo 'no ts in mcp \u2014 skipping'",
+    "typecheck": "echo 'no ts in mcp — skipping'",
     "test": "node --test tests/*.test.mjs"
   },
   "keywords": [

package/src/server.js

@@ -10,8 +10,8 @@
  * sees raw rows — it gets engineered, epistemics-tagged context. It never
  * "updates" — it records observations; Nous derives.
  *
- * The revenue-plugin surface — 7 primitives, and nothing else (legacy tools pruned):
- *   READ      get_context · get_account · query (search folds in via facts:true) · score
+ * The revenue-plugin surface — the primitives below, and nothing else (legacy tools pruned):
+ *   READ      get_context · get_account · query (search folds in via facts:true) · score · deals
  *   WRITE     record · record_insight   (you observe; the engine derives; no overwrites)
  *   IDENTITY  whoami   (who the key acts as · scope admin|member · GTM role[s])
  */
@@ -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.62.0";
+export const SERVER_VERSION = "0.65.0";
 
 // ─── helpers ──────────────────────────────────────────────────────────────────
 
@@ -129,12 +129,12 @@ export function createServer() {
   // ICP: set_icp writes the hypothesis; record_closed_deals trains it on real
   // won/lost outcomes (contrastive lift). 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 nine — a
-  // stray non-primitive registration is dropped, not exposed. See
-  // docs/revenue-plugin/README.md §2–3.
+  // save_note is out. Deals: deal health + how likely each deal is to close, and why. The
+  // `tool()` guard keeps the surface locked to these ten — 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",
-    "record_closed_deals",
+    "record_closed_deals", "deals",
   ]);
   const _tool = server.tool.bind(server);
   const tool = (name, ...rest) => {
@@ -397,6 +397,106 @@ export function createServer() {
 
 
 
+  // ===========================================================================
+  // TOOL: deals  —  GET /v2/deals · GET /v2/deals/:id
+  // Deal health next to how likely a deal is to close, and why. Per deal — the
+  // revenue roll-up is not this tool.
+  // ===========================================================================
+  tool(
+    "deals",
+    "DEAL HEALTH and HOW LIKELY A DEAL IS TO CLOSE, with the reasons. Two ways to call it:\n" +
+    "  • no `account` → the open deals most likely to close within `within_days` (default 30), ranked. Each carries " +
+    "its chance to close in that window, its overall chance to win, its deal health (score, band, what to watch) and " +
+    "the facts that moved its odds. Use for 'which deals are most likely to close in the next 30 days', 'what will " +
+    "close this month', 'what's closest to closing'.\n" +
+    "  • `account` (email, domain, LinkedIn URL, entity UUID, or name) → that one deal: health with all four signals " +
+    "and the engagement read, its chance to close overall, within `within_days` and within 90 days, the stage-only " +
+    "baseline, and every fact pushing the odds up or down. Use for 'how likely is Acme to close', 'what's the deal " +
+    "health on Acme', 'will Acme close this month'.\n" +
+    "The odds are the stage's base rate moved by what the graph recorded: open objections, competitors, stall, " +
+    "silence, threading, ICP fit, intent. 'unknown' within N days means this stage has no closed deals to judge " +
+    "timing on yet: say so, never call it 0%. When a NOTE says the weights are defaults, pass that on.",
+    {
+      account: z.string().optional().describe("One account to judge: email, domain, LinkedIn URL, entity UUID, or name. Omit to rank the open deals."),
+      within_days: z.number().optional().describe("The window for 'likely to close within N days'. Default 30."),
+      limit: z.number().optional().describe("How many ranked deals to return (max 25, default 10). Ignored with `account`."),
+    },
+    async ({ account, within_days, limit }) => {
+      const pctTxt = (v) => (v == null ? "unknown" : `${v}%`);
+      const q = within_days ? { within_days } : {};
+      const lines = [];
+
+      if (account) {
+        const r = await get(`/v2/deals/${encodeURIComponent(account)}`, q);
+        if (r.status === "ambiguous") {
+          const opts = (r.candidates ?? []).map(c =>
+            `  • ${c.name ?? "(unnamed)"}${c.detail ? ` — ${c.detail}` : ""}  [${c.entity_id}]`).join("\n");
+          return { content: [{ type: "text", text:
+            `"${account}" matches several people. Call deals again with one of these entity ids:\n${opts}` }] };
+        }
+        const name = r.name ?? r.entity_id;
+        if (r.status === "open") {
+          const windows = Object.entries(r.close_within_pct ?? {})
+            .map(([d, v]) => `${pctTxt(v)} within ${d}d`).join(" · ");
+          lines.push(`${name} · ${r.entity_id} · stage ${r.stage}, ${r.days_in_stage}d in stage` +
+            (r.typical_days_in_stage != null ? ` (typical ${r.typical_days_in_stage}d)` : ""));
+          lines.push(`CLOSE: ${pctTxt(r.win_pct)} to win · ${windows}  (stage alone: ${pctTxt(r.stage_only_win_pct)})`);
+          if (r.timing && r.timing !== "judged") lines.push(`TIMING: ${r.timing}`);
+          if (r.why?.length) {
+            lines.push("WHY:");
+            for (const y of r.why) lines.push(`  ${y}`);
+          }
+        } else {
+          lines.push(`${name} · ${r.entity_id}${r.stage ? ` · ${r.stage}` : ""}`);
+          lines.push(r.note);
+        }
+        if (r.icp) {
+          const i = r.icp;
+          if (!i.scored) lines.push(`ICP: ${i.note}`);
+          else {
+            lines.push(`ICP: ${i.score ?? "—"}/100${i.tier ? ` ${i.tier}` : ""}${i.via_person?.name ? ` (scored on ${i.via_person.name})` : ""}`);
+            if (i.fired?.length) for (const f of i.fired) lines.push(`  +${f.weight} ${f.label}`);
+            if (i.note) lines.push(`  ${i.note}`);
+            else if (i.missing_inputs?.length) lines.push(`  not on the record: ${i.missing_inputs.join(", ")}`);
+          }
+        }
+        if (r.health) {
+          lines.push(`HEALTH: ${r.health.score ?? "—"}/100 ${r.health.band ?? ""}`.trim());
+          if (r.health.evidence?.note) lines.push(`  ${r.health.evidence.note}`);
+          for (const s of r.health.signals ?? []) lines.push(`  ${s.signal}: ${s.level} — ${s.reason}`);
+          const e = r.health.engagement ?? {};
+          const eng = [
+            e.last_response && `last response ${e.last_response}`,
+            e.engagement_trend && `engagement ${e.engagement_trend}`,
+            e.multi_threading && `${e.multi_threading}`,
+            e.response_time && e.response_time !== "—" && `buyer replies in ${e.response_time}`,
+            e.meetings && e.meetings,
+          ].filter(Boolean);
+          if (eng.length) lines.push(`  ${eng.join(" · ")}`);
+        }
+        if (r.via_person) lines.push(`(resolved from a person at this account: ${r.via_person})`);
+        for (const n of r.model?.notes ?? []) lines.push(`NOTE: ${n}`);
+        return { content: [{ type: "text", text: lines.join("\n") }] };
+      }
+
+      const r = await get("/v2/deals", { ...q, ...(limit ? { limit } : {}) });
+      const deals = r.deals ?? [];
+      lines.push(`Open deals ranked by ${r.ranked_by}. Showing ${deals.length} of ${r.open_deals} open; ` +
+        `timing known for ${r.timing_known}.`);
+      deals.forEach((d, i) => {
+        lines.push(`${i + 1}. ${d.name ?? "(unnamed)"} [${d.entity_id}] — ${d.stage}, ${d.days_in_stage}d · ` +
+          `${pctTxt(d.close_within_pct?.[r.within_days])} within ${r.within_days}d · ${pctTxt(d.win_pct)} to win · ` +
+          `health ${d.health?.score ?? "—"}${d.health?.band ? ` ${d.health.band}` : ""}`);
+        if (d.timing && d.timing !== "judged") lines.push(`   timing: ${d.timing}`);
+        if (d.why?.length) lines.push(`   why: ${d.why.join("; ")}`);
+        if (d.health?.watch?.length) lines.push(`   watch: ${d.health.watch.join("; ")}`);
+      });
+      if (!deals.length) lines.push("No open deals: nothing has a reconstructed stage between first contact and a close.");
+      for (const n of r.model?.notes ?? []) lines.push(`NOTE: ${n}`);
+      return { content: [{ type: "text", text: lines.join("\n") }] };
+    }
+  );
+
   // ===========================================================================
   // TOOL: record  —  POST /v2/observations
   // The single write verb. You observe — Nous derives the updated facts.
@@ -429,7 +529,12 @@ export function createServer() {
     "facts you actually reasoned from in `evidence_ids` — that is what lets Nous learn which KINDS of " +
     "evidence are worth acting on, not just which actions worked. 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 " +
+    "decision_id (pass drafted_body + sent_body on accepted and the edit is measured for you). On the verdict, " +
+    "say what the correction MEANT — you are the only one who heard it: {interpretation:'cut the pricing " +
+    "paragraph', correction_kind:'rule'|'structure'|'claim'|'constraint'|'none', correction_scope:'once'|" +
+    "'person'|'workspace'|'product'}. 'none' and 'once' are correct most of the time; a typo or a detail only " +
+    "they knew teaches nothing, and recording it crowds out the real signal. Ask 'just this one, or always?' " +
+    "only when you genuinely cannot tell. 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.",
     {