@cognivia/mcp 0.1.0 → 0.3.0

package/README.md

@@ -1,7 +1,7 @@
 # @cognivia/mcp
 
 A Model Context Protocol server that gives any AI agent Cognivia's learning
-diagnostics as tools: `diagnose_error`, `get_memory_state`, `generate_report`.
+diagnostics as tools: `diagnose_error`, `get_memory_state`, `generate_report`, and (with a live key) `set_item_misconceptions`, `set_concept_prerequisites` to sharpen diagnosis on your own content.
 
 ```jsonc
 { "mcpServers": { "cognivia": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cognivia/mcp",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Model Context Protocol server for Cognivia. Gives any AI agent learning diagnostics (error type, memory state, session report) as callable tools.",
   "type": "module",
   "bin": { "cognivia-mcp": "server.mjs" },
@@ -10,7 +10,7 @@
   "homepage": "https://cognivia-platform.vercel.app/intelligence",
   "repository": { "type": "git", "url": "git+https://github.com/Manik-Maurya/cognivia-platform.git", "directory": "packages/mcp" },
   "engines": { "node": ">=18" },
-  "dependencies": { "@cognivia/core": "^0.1.0" },
+  "dependencies": { "@cognivia/core": "^0.3.0" },
   "publishConfig": { "access": "public" },
   "license": "MIT",
   "author": "Manik Maurya"

package/server.mjs

@@ -4,9 +4,11 @@
 // JSON-RPC 2.0 over stdio, which every MCP client speaks.
 //
 // Tools:
-//   diagnose_error(subject, question, answer, correct, latencyMs, confidence)
-//   get_memory_state(attempts[])
-//   generate_report(attempts[])
+//   diagnose_error(subject|concept, correct|outcome, latencyMs|latency, confidence)
+//   get_memory_state(learner_ref)   real stored state (live key), or attempts[] (local)
+//   generate_report(learner_ref)    render stored state (live key), or attempts[] (local)
+//   set_item_misconceptions(items[])        (live key; sharpens diagnose on your items)
+//   set_concept_prerequisites(prerequisites[]) (live key; enables prerequisite_gap)
 //
 // All computed by @cognivia/core - the same engine behind the site, console, CLI.
 //
@@ -24,26 +26,55 @@ const err = (id, code, message) => send({ jsonrpc: "2.0", id, error: { code, mes
 const TOOLS = [
   {
     name: "diagnose_error",
-    description: "Diagnose one answered item: the error type, memory state, and next review, each grounded in memory science.",
+    description: "Diagnose one answered item: the error type, memory state, and next review, each grounded in memory science. Accepts correct (bool) OR outcome ('correct'/'wrong'); latencyMs OR latency; subject OR concept.",
     inputSchema: {
       type: "object",
       properties: {
-        subject: { type: "string" }, question: { type: "string" }, answer: { type: "string" },
-        correct: { type: "boolean" }, latencyMs: { type: "number" },
+        subject: { type: "string" }, concept: { type: "string" },
+        question: { type: "string" }, answer: { type: "string" },
+        correct: { type: "boolean" }, outcome: { type: "string" },
+        latencyMs: { type: "number" }, latency: { type: "number" },
         confidence: { type: "number", description: "1-5 (or 0-100)" },
       },
-      required: ["correct"],
     },
   },
   {
     name: "get_memory_state",
-    description: "Compute the Learning Genome and per-item memory state for a set of attempts from any learning or quiz app.",
-    inputSchema: { type: "object", properties: { attempts: { type: "array" } }, required: ["attempts"] },
+    description: "A learner's memory state. Pass learner_ref to READ their real stored state (needs a live COGNIVIA_API_KEY): per-concept decay, retrieval, and next review. Or pass attempts[] to compute a Learning Genome locally, no key needed.",
+    inputSchema: { type: "object", properties: { learner_ref: { type: "string" }, attempts: { type: "array" } } },
   },
   {
     name: "generate_report",
-    description: "Build a full Cognivia Session Report (Learning Genome, per-item diagnosis, recommendation) from a set of attempts.",
-    inputSchema: { type: "object", properties: { attempts: { type: "array" } }, required: ["attempts"] },
+    description: "A readable Cognivia report. Pass learner_ref to render their stored memory state as a Cognitive Passport (needs a live key). Or pass attempts[] to build a Session Report locally.",
+    inputSchema: { type: "object", properties: { learner_ref: { type: "string" }, attempts: { type: "array" } } },
+  },
+  {
+    name: "set_item_misconceptions",
+    description: "Upload item -> misconception maps so diagnose names the misconception behind a wrong answer to YOUR own items. Requires COGNIVIA_API_KEY (a self-serve live key).",
+    inputSchema: {
+      type: "object",
+      properties: {
+        items: {
+          type: "array",
+          description: "[{ item_ref, distractors: { \"the wrong option\": \"the misconception it reveals\" } }]",
+        },
+      },
+      required: ["items"],
+    },
+  },
+  {
+    name: "set_concept_prerequisites",
+    description: "Upload concept -> prerequisite maps so diagnose flags a prerequisite_gap when a learner is weak on a foundation you declared. Requires COGNIVIA_API_KEY (a self-serve live key).",
+    inputSchema: {
+      type: "object",
+      properties: {
+        prerequisites: {
+          type: "array",
+          description: "[{ concept, requires: [\"prerequisite concept\", ...] }]",
+        },
+      },
+      required: ["prerequisites"],
+    },
   },
 ];
 
@@ -55,15 +86,25 @@ async function callTool(name, a = {}) {
   // When COGNIVIA_API_KEY is set, prefer the hosted /v1 API; else compute locally.
   const remote = client.hasKey();
   if (name === "diagnose_error") {
-    if (remote) { try { return textResult(await client.diagnoseRemote(a)); } catch (e) { /* fall back */ } }
-    const tag = core.classify(!!a.correct, a.confidence);
+    // Accept the friendly aliases the Developers page shows.
+    const b = { ...a };
+    if (b.correct === undefined && b.outcome !== undefined) b.correct = /^(correct|right|true|1|yes)$/i.test(String(b.outcome));
+    if (b.latencyMs === undefined && b.latency !== undefined) b.latencyMs = b.latency;
+    if (b.subject === undefined && b.concept !== undefined) b.subject = b.concept;
+    if (remote) { try { return textResult(await client.diagnoseRemote(b)); } catch (e) { /* fall back */ } }
+    const tag = core.classify(!!b.correct, b.confidence);
     return textResult({
       errorType: tag.code, label: tag.label,
-      memoryState: core.memoryState(a), diagnosis: core.diagnosis(a),
-      nextReview: core.reviewFor(tag, a.confidence),
+      memoryState: core.memoryState(b), diagnosis: core.diagnosis(b),
+      nextReview: core.reviewFor(tag, b.confidence),
     });
   }
   if (name === "get_memory_state") {
+    // learner_ref → real stored state (remote); attempts[] → local compute.
+    if (a.learner_ref) {
+      if (!remote) throw new Error("get_memory_state(learner_ref) needs COGNIVIA_API_KEY (a live key). Pass attempts[] to compute locally.");
+      return textResult(await client.memoryStateRemote(a.learner_ref));
+    }
     const atts = a.attempts || [];
     return textResult({
       genome: core.computeGenome(atts),
@@ -71,10 +112,25 @@ async function callTool(name, a = {}) {
     });
   }
   if (name === "generate_report") {
+    // learner_ref → render their stored memory state (remote); attempts[] → local Session Report.
+    if (a.learner_ref) {
+      if (!remote) throw new Error("generate_report(learner_ref) needs COGNIVIA_API_KEY (a live key). Pass attempts[] to build locally.");
+      const st = await client.memoryStateRemote(a.learner_ref);
+      return textResult(st, client.renderMemoryState(st));
+    }
     if (remote) { try { const rep = await client.reportRemote(a.attempts || []); return textResult(rep, core.renderText(rep)); } catch (e) { /* fall back */ } }
     const rep = core.buildReport(a.attempts || [], { idPrefix: "CGV-MCP" });
     return textResult(rep, core.renderText(rep));
   }
+  // Content maps are remote-only writes to the partner's account (a live key).
+  if (name === "set_item_misconceptions") {
+    if (!remote) throw new Error("Set COGNIVIA_API_KEY (a self-serve live key) to upload content maps.");
+    return textResult(await client.setItemMisconceptions(a.items || []));
+  }
+  if (name === "set_concept_prerequisites") {
+    if (!remote) throw new Error("Set COGNIVIA_API_KEY (a self-serve live key) to upload content maps.");
+    return textResult(await client.setConceptPrerequisites(a.prerequisites || []));
+  }
   throw new Error("unknown tool: " + name);
 }
 
@@ -90,7 +146,7 @@ rl.on("line", async (line) => {
       ok(id, {
         protocolVersion: "2024-11-05",
         capabilities: { tools: {} },
-        serverInfo: { name: "cognivia", version: "0.1.0" },
+        serverInfo: { name: "cognivia", version: "0.3.0" },
       });
     } else if (method === "tools/list") {
       ok(id, { tools: TOOLS });