exovault-mcp-server 1.0.2 → 1.1.0

package/dist/extraction-prompt.js

@@ -74,10 +74,10 @@ function truncate(s, max) {
         return undefined;
     return s.length > max ? s.slice(0, max) : s;
 }
-const EXTRACTION_INSTRUCTIONS = `Extract durable knowledge from the activity log above. Return a JSON array, max 8 items.
-Each item uses short keys: {c: content, t: type, i: importance(1-5), e: [entities], s: summary}
-Types: fact, skill, preference, constraint, task
-Only extract knowledge NOT already saved. Skip ephemeral info.
+const EXTRACTION_INSTRUCTIONS = `Extract durable knowledge from the activity log above. Return a JSON array, max 8 items.
+Each item uses short keys: {c: content, t: type, i: importance(1-5), e: [entities], s: summary}
+Types: fact, skill, preference, constraint, task
+Only extract knowledge NOT already saved. Skip ephemeral info.
 Return [] if nothing worth extracting.`;
 // ─── parseExtractionResult ────────────────────────────────────────────
 /**

package/dist/rlm/verify.js

@@ -1,11 +1,11 @@
 import { generateText } from "ai";
 import { createOpenAI } from "@ai-sdk/openai";
-const VERIFY_PROMPT = `You are a verification pass for a recursive retrieval controller.
-
-Review the answer below and assess whether it fully addresses the original goal.
-If the answer is incomplete or potentially wrong, explain what's missing.
-If the answer is sufficient, confirm it.
-
+const VERIFY_PROMPT = `You are a verification pass for a recursive retrieval controller.
+
+Review the answer below and assess whether it fully addresses the original goal.
+If the answer is incomplete or potentially wrong, explain what's missing.
+If the answer is sufficient, confirm it.
+
 Respond with JSON: { "verified": true/false, "revisedAnswer": "...", "confidence": 0.0-1.0, "reason": "..." }`;
 /**
  * Run a verification pass on the controller's answer.

package/dist/rlm/writeback.js

@@ -2,16 +2,16 @@ import { generateText } from "ai";
 import { createOpenAI } from "@ai-sdk/openai";
 import { writeMemory } from "../tools/write-memory.js";
 const ALLOWED_TYPES = new Set(["fact", "plan", "constraint", "skill"]);
-const WRITEBACK_PROMPT = `You are a writeback policy for a knowledge base.
-
-Given the goal and answer below, extract any durable knowledge artifacts worth storing as long-term memories.
-
-Rules:
-- Only extract genuinely new, durable insights — not trivial or transient information.
-- Each artifact must have a memoryType of: fact, plan, constraint, or skill.
-- Set importance (1-5) and confidence (1-5) appropriately.
-- If nothing is worth storing, return an empty array.
-
+const WRITEBACK_PROMPT = `You are a writeback policy for a knowledge base.
+
+Given the goal and answer below, extract any durable knowledge artifacts worth storing as long-term memories.
+
+Rules:
+- Only extract genuinely new, durable insights — not trivial or transient information.
+- Each artifact must have a memoryType of: fact, plan, constraint, or skill.
+- Set importance (1-5) and confidence (1-5) appropriately.
+- If nothing is worth storing, return an empty array.
+
 Respond with JSON: { "artifacts": [{ "content": "...", "memoryType": "fact|plan|constraint|skill", "summary": "...", "importance": 1-5, "confidence": 1-5, "writeReason": "..." }] }`;
 /**
  * Extract durable artifacts from the controller's findings and write them as memories.

package/dist/setup.js

@@ -1,13 +1,94 @@
 #!/usr/bin/env node
 import { createClient } from "@supabase/supabase-js";
 import { createInterface } from "node:readline";
-import { mkdir, writeFile } from "node:fs/promises";
-import { join } from "node:path";
-import { homedir } from "node:os";
+import { copyFile, mkdir, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { homedir, platform } from "node:os";
 import { parseArgs } from "node:util";
+import { fileURLToPath } from "node:url";
 import { deriveWrappingKey, unwrapMasterKey, importMasterKey, bufferToHex, } from "./crypto.js";
 const CONFIG_DIR = join(homedir(), ".exovault-mcp");
 const CONFIG_FILE = join(CONFIG_DIR, "config.json");
+const HOOKS_DIR = join(CONFIG_DIR, "hooks");
+const IS_WINDOWS = platform() === "win32";
+/** Returns platform-appropriate MCP server config snippet. */
+function getMcpServerConfig() {
+    if (IS_WINDOWS) {
+        return {
+            mcpServers: {
+                exovault: {
+                    command: "cmd",
+                    args: ["/c", "npx", "-y", "exovault-mcp-server"],
+                },
+            },
+        };
+    }
+    return {
+        mcpServers: {
+            exovault: {
+                command: "npx",
+                args: ["-y", "exovault-mcp-server"],
+            },
+        },
+    };
+}
+/** Returns hook config snippet for turn capture. */
+function getHooksConfig() {
+    const hookPath = "~/.exovault-mcp/hooks/capture-turn.js";
+    return {
+        hooks: {
+            UserPromptSubmit: [{
+                    matcher: "",
+                    hooks: [{
+                            type: "command",
+                            command: `node ${hookPath} user`,
+                            timeout: 15,
+                        }],
+                }],
+            Stop: [{
+                    matcher: "",
+                    hooks: [{
+                            type: "command",
+                            command: `node ${hookPath} assistant`,
+                            timeout: 15,
+                        }],
+                }],
+        },
+    };
+}
+/** Copies capture-turn.js hook to ~/.exovault-mcp/hooks/ */
+async function installHook() {
+    try {
+        await mkdir(HOOKS_DIR, { recursive: true, mode: 0o700 });
+        // Resolve the bundled hook relative to this file's package
+        const thisDir = dirname(fileURLToPath(import.meta.url));
+        const srcHook = join(thisDir, "..", "hooks", "capture-turn.js");
+        const destHook = join(HOOKS_DIR, "capture-turn.js");
+        await copyFile(srcHook, destHook);
+        console.log(`Turn capture hook installed to: ${destHook}`);
+        return true;
+    }
+    catch (err) {
+        console.warn("Could not install turn capture hook:", err instanceof Error ? err.message : err);
+        return false;
+    }
+}
+/** Prints Claude Code config snippet + optional hook instructions. */
+function printSetupInstructions(hookInstalled) {
+    console.log();
+    console.log("Add this to your project's .mcp.json or ~/.claude/settings.json:");
+    console.log();
+    console.log(JSON.stringify(getMcpServerConfig(), null, 2));
+    if (hookInstalled) {
+        console.log();
+        console.log("Optional: Add turn capture hooks to .claude/settings.json for richer memory:");
+        console.log("(Captures full conversation context — not just MCP tool calls)");
+        console.log();
+        console.log(JSON.stringify(getHooksConfig(), null, 2));
+    }
+    console.log();
+    console.log("Setup complete! Restart Claude Code to connect.");
+}
 function printUsage() {
     console.log("Usage:");
     console.log("  exovault-mcp-server setup --agent-key <key> [--api-url <url>]   (gateway mode)");
@@ -90,20 +171,8 @@ async function setupGatewayMode(agentKey, apiUrl) {
     });
     console.log();
     console.log(`Config saved to: ${CONFIG_FILE}`);
-    // Print Claude Code config snippet
-    console.log();
-    console.log("Add this to your ~/.claude/settings.json (mcpServers section):");
-    console.log();
-    console.log(JSON.stringify({
-        mcpServers: {
-            exovault: {
-                command: "npx",
-                args: ["exovault-mcp-server"],
-            },
-        },
-    }, null, 2));
-    console.log();
-    console.log("Setup complete! Restart Claude Code to connect.");
+    const hookInstalled = await installHook();
+    printSetupInstructions(hookInstalled);
 }
 async function main() {
     // Parse CLI args
@@ -237,20 +306,8 @@ async function main() {
         rl3.close();
         await writeFile(CONFIG_FILE, JSON.stringify(config, null, 2), { encoding: "utf-8", mode: 0o600 });
         console.log(`Config saved to: ${CONFIG_FILE}`);
-        // Print Claude Code config snippet
-        console.log();
-        console.log("Add this to your ~/.claude/settings.json (mcpServers section):");
-        console.log();
-        console.log(JSON.stringify({
-            mcpServers: {
-                exovault: {
-                    command: "npx",
-                    args: ["exovault-mcp-server"],
-                },
-            },
-        }, null, 2));
-        console.log();
-        console.log("Setup complete! Restart Claude Code to connect.");
+        const hookInstalled = await installHook();
+        printSetupInstructions(hookInstalled);
     }
     catch (err) {
         console.error("Setup failed:", err instanceof Error ? err.message : err);

package/hooks/capture-turn.js

@@ -0,0 +1,175 @@
+#!/usr/bin/env node
+/* eslint-disable @typescript-eslint/no-require-imports */
+/**
+ * ExoVault turn capture hook for Claude Code.
+ * Captures user prompts and assistant responses, POSTs to ingest-turn API.
+ *
+ * Usage (called by Claude Code hooks, not directly):
+ *   echo '{"prompt":"hello"}' | node capture-turn.js user
+ *   echo '{"last_assistant_message":"hi"}' | node capture-turn.js assistant
+ *
+ * Config resolution (first match wins):
+ *   1. EXOVAULT_AGENT_KEY / EXOVAULT_API_URL env vars
+ *   2. ~/.exovault-mcp/config.json (agentKey / apiUrl fields)
+ */
+
+const path = require("path");
+const fs = require("fs");
+
+const MAX_CONTENT_LENGTH = 50_000;
+const MIN_CONTENT_LENGTH = 5;
+const FETCH_TIMEOUT_MS = 10_000;
+
+/** Default config file path — same as the MCP server. */
+const CONFIG_PATH = path.join(
+  process.env.HOME || process.env.USERPROFILE || "~",
+  ".exovault-mcp",
+  "config.json",
+);
+
+/**
+ * Resolve agent key and API URL from env vars, falling back to config file.
+ * Returns { agentKey, apiUrl } or null if not configured.
+ */
+function resolveConfig() {
+  // 1. Env vars take priority
+  let agentKey = process.env.EXOVAULT_AGENT_KEY || "";
+  let apiUrl = process.env.EXOVAULT_API_URL || "";
+
+  // 2. Fall back to config file
+  if (!agentKey) {
+    try {
+      const raw = fs.readFileSync(CONFIG_PATH, "utf8");
+      const config = JSON.parse(raw);
+      if (!agentKey && config.agentKey) agentKey = config.agentKey;
+      if (!apiUrl && config.apiUrl) apiUrl = config.apiUrl;
+    } catch {
+      // Config file missing or invalid — that's fine
+    }
+  }
+
+  if (!agentKey) return null;
+
+  return {
+    agentKey,
+    apiUrl: (apiUrl || "https://exovault.co").replace(/\/+$/, ""),
+  };
+}
+
+/**
+ * Extract content from hook input based on role.
+ * Returns null if content should be skipped.
+ */
+function extractContent(input, role) {
+  if (role === "user") {
+    return input.prompt || null;
+  }
+
+  if (role === "assistant") {
+    // Skip re-entry: stop_hook_active means Stop hook already fired
+    if (input.stop_hook_active) return null;
+    return input.last_assistant_message || null;
+  }
+
+  return null;
+}
+
+/**
+ * Prepare the ingest-turn request body.
+ */
+function buildRequestBody(content, role, sessionId) {
+  // Truncate oversized content
+  let trimmed = content;
+  if (trimmed.length > MAX_CONTENT_LENGTH) {
+    trimmed = trimmed.slice(0, MAX_CONTENT_LENGTH) + "\n[truncated]";
+  }
+
+  const body = {
+    content: trimmed,
+    role,
+    agentId: "claude_code",
+  };
+
+  if (sessionId) {
+    body.agentRunId = sessionId;
+  }
+
+  return body;
+}
+
+/**
+ * POST a turn to the ExoVault ingest-turn API.
+ */
+async function postTurn(apiUrl, agentKey, body) {
+  const controller = new AbortController();
+  const timeout = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
+
+  try {
+    await fetch(`${apiUrl}/api/agent/ingest-turn`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${agentKey}`,
+      },
+      body: JSON.stringify(body),
+      signal: controller.signal,
+    });
+  } finally {
+    clearTimeout(timeout);
+  }
+}
+
+/**
+ * Main entry point — reads stdin, extracts content, POSTs to API.
+ */
+async function main() {
+  const role = process.argv[2];
+  if (role !== "user" && role !== "assistant") {
+    process.exit(0);
+  }
+
+  const config = resolveConfig();
+  if (!config) {
+    process.exit(0); // Not configured — silently skip
+  }
+
+  // Read JSON from stdin
+  let data = "";
+  process.stdin.setEncoding("utf8");
+
+  await new Promise((resolve) => {
+    process.stdin.on("data", (chunk) => (data += chunk));
+    process.stdin.on("end", resolve);
+  });
+
+  const input = JSON.parse(data);
+  const content = extractContent(input, role);
+
+  if (!content || content.length < MIN_CONTENT_LENGTH) {
+    process.exit(0); // Too short or empty — skip
+  }
+
+  const body = buildRequestBody(content, role, input.session_id);
+  await postTurn(config.apiUrl, config.agentKey, body);
+}
+
+// Export for testing, execute when run directly
+if (typeof module !== "undefined") {
+  module.exports = {
+    extractContent,
+    buildRequestBody,
+    postTurn,
+    resolveConfig,
+    MAX_CONTENT_LENGTH,
+    MIN_CONTENT_LENGTH,
+    FETCH_TIMEOUT_MS,
+    CONFIG_PATH,
+  };
+}
+
+if (require.main === module) {
+  main().then(
+    () => process.exit(0),
+    () => process.exit(0), // Silently swallow all errors
+  );
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "exovault-mcp-server",
-  "version": "1.0.2",
+  "version": "1.1.0",
   "type": "module",
   "description": "MCP server for ExoVault — read, search, and manage encrypted notes from Claude Code",
   "main": "dist/index.js",
@@ -9,6 +9,7 @@
   },
   "files": [
     "dist/",
+    "hooks/",
     "README.md",
     "LICENSE"
   ],