exovault-mcp-server 1.0.0

package/dist/gateway-client.js

@@ -0,0 +1,285 @@
+/**
+ * Gateway client for the ExoVault Agent Gateway HTTP API.
+ *
+ * When EXOVAULT_AGENT_KEY is configured, the MCP server routes all operations
+ * through this client instead of talking to Supabase directly.
+ * This ensures the agent key's lastUsedAt is touched on every request,
+ * enabling verification polling and unified activity tracking.
+ */
+export class GatewayError extends Error {
+    status;
+    body;
+    constructor(message, status, body) {
+        super(message);
+        this.status = status;
+        this.body = body;
+        this.name = "GatewayError";
+    }
+}
+const MAX_RETRIES = 3;
+const RETRY_BASE_MS = 500;
+const RETRYABLE_PATTERNS = [
+    "ECONNREFUSED",
+    "ECONNRESET",
+    "fetch failed",
+    "socket hang up",
+    "network",
+];
+function isRetryableError(err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    return RETRYABLE_PATTERNS.some((p) => msg.toLowerCase().includes(p.toLowerCase()));
+}
+export class GatewayClient {
+    baseUrl;
+    apiKey;
+    sessionRunId;
+    constructor(baseUrl, apiKey, sessionRunId) {
+        // Strip trailing slash
+        this.baseUrl = baseUrl.replace(/\/$/, "");
+        this.apiKey = apiKey;
+        this.sessionRunId = sessionRunId;
+    }
+    async request(method, path, body) {
+        const url = `${this.baseUrl}${path}`;
+        const headers = {
+            Authorization: `Bearer ${this.apiKey}`,
+        };
+        if (this.sessionRunId) {
+            headers["X-Agent-Run-Id"] = this.sessionRunId;
+        }
+        if (body !== undefined) {
+            headers["Content-Type"] = "application/json";
+        }
+        let lastError;
+        for (let attempt = 0; attempt <= MAX_RETRIES; attempt++) {
+            try {
+                const response = await fetch(url, {
+                    method,
+                    headers,
+                    body: body !== undefined ? JSON.stringify(body) : undefined,
+                });
+                if (!response.ok) {
+                    let errorBody;
+                    try {
+                        errorBody = await response.json();
+                    }
+                    catch {
+                        errorBody = await response.text().catch(() => null);
+                    }
+                    const message = errorBody?.error ??
+                        `Gateway returned ${response.status}`;
+                    throw new GatewayError(message, response.status, errorBody);
+                }
+                return response.json();
+            }
+            catch (err) {
+                // Never retry HTTP errors (server responded) — only network failures
+                if (err instanceof GatewayError)
+                    throw err;
+                lastError = err;
+                if (attempt < MAX_RETRIES && isRetryableError(err)) {
+                    const delayMs = RETRY_BASE_MS * 2 ** attempt;
+                    console.error(`[gateway] Retry ${attempt + 1}/${MAX_RETRIES} for ${path} — waiting ${delayMs}ms`);
+                    await new Promise((r) => setTimeout(r, delayMs));
+                    continue;
+                }
+                throw err;
+            }
+        }
+        // Unreachable — loop always throws on final attempt — but satisfies TS
+        throw lastError;
+    }
+    // ─── Info ──────────────────────────────────────────────────────────────────
+    async info() {
+        return this.request("GET", "/api/agent/info");
+    }
+    // ─── Memory operations ─────────────────────────────────────────────────────
+    async writeMemory(params) {
+        const result = await this.request("POST", "/api/agent/write-memory", params);
+        return JSON.stringify(result);
+    }
+    async searchMemories(params) {
+        const result = await this.request("POST", "/api/agent/search-memories", params);
+        return JSON.stringify(result);
+    }
+    async readMemories(memoryIds) {
+        const result = await this.request("POST", "/api/agent/read-memories", { memoryIds });
+        return JSON.stringify(result);
+    }
+    async updateMemory(params) {
+        const result = await this.request("POST", "/api/agent/update-memory", params);
+        return JSON.stringify(result);
+    }
+    async archiveMemory(memoryId, archived) {
+        const result = await this.request("POST", "/api/agent/archive-memory", { memoryId, archived: archived ?? true });
+        return JSON.stringify(result);
+    }
+    async getRelatedMemories(memoryId, limit, vaultId) {
+        const result = await this.request("POST", "/api/agent/get-related-memories", { memoryId, limit, vaultId });
+        return JSON.stringify(result);
+    }
+    async listActiveAgents(sinceDays, limit) {
+        const result = await this.request("POST", "/api/agent/list-active-agents", { sinceDays, limit });
+        return JSON.stringify(result);
+    }
+    async cleanupMemories(params) {
+        const result = await this.request("POST", "/api/agent/cleanup-memories", params);
+        return JSON.stringify(result);
+    }
+    // ─── Composite operations ──────────────────────────────────────────────────
+    async sessionStart(params) {
+        const result = await this.request("POST", "/api/agent/session-start", params);
+        return JSON.stringify(result);
+    }
+    async contextCheckpoint(params) {
+        const result = await this.request("POST", "/api/agent/context-checkpoint", params);
+        return JSON.stringify(result);
+    }
+    // ─── Vault operations ──────────────────────────────────────────────────────
+    async listVaults() {
+        const result = await this.request("GET", "/api/agent/list-vaults");
+        return JSON.stringify(result);
+    }
+    // ─── Note operations ───────────────────────────────────────────────────────
+    async listNotes(params) {
+        const result = await this.request("POST", "/api/agent/list-notes", params);
+        return JSON.stringify(result);
+    }
+    async readNote(noteId) {
+        const result = await this.request("POST", "/api/agent/read-note", { noteId });
+        return JSON.stringify(result);
+    }
+    async readNotes(noteIds) {
+        const result = await this.request("POST", "/api/agent/read-notes", { noteIds });
+        return JSON.stringify(result);
+    }
+    async searchNotes(params) {
+        const result = await this.request("POST", "/api/agent/search-notes", params);
+        return JSON.stringify(result);
+    }
+    async createNote(params) {
+        const result = await this.request("POST", "/api/agent/create-note", params);
+        return JSON.stringify(result);
+    }
+    async updateNote(params) {
+        const result = await this.request("POST", "/api/agent/update-note", params);
+        return JSON.stringify(result);
+    }
+    async deleteNote(noteId) {
+        const result = await this.request("POST", "/api/agent/delete-note", { noteId });
+        return JSON.stringify(result);
+    }
+    async semanticSearch(params) {
+        const result = await this.request("POST", "/api/agent/semantic-search", params);
+        return JSON.stringify(result);
+    }
+    async searchAndRead(params) {
+        const result = await this.request("POST", "/api/agent/search-and-read", params);
+        return JSON.stringify(result);
+    }
+    // ─── Folder operations ──────────────────────────────────────────────────
+    async listFolders(params) {
+        const result = await this.request("POST", "/api/agent/list-folders", params);
+        return JSON.stringify(result);
+    }
+    async createFolder(params) {
+        const result = await this.request("POST", "/api/agent/create-folder", params);
+        return JSON.stringify(result);
+    }
+    async moveNote(params) {
+        const result = await this.request("POST", "/api/agent/move-note", params);
+        return JSON.stringify(result);
+    }
+    // ─── Vault operations (create) ────────────────────────────────────────────
+    async createVault(params) {
+        const result = await this.request("POST", "/api/agent/create-vault", params);
+        return JSON.stringify(result);
+    }
+    // ─── Task operations ─────────────────────────────────────────────────────
+    async createTask(params) {
+        const result = await this.request("POST", "/api/agent/create-task", params);
+        return JSON.stringify(result);
+    }
+    async updateTask(params) {
+        const result = await this.request("POST", "/api/agent/update-task", params);
+        return JSON.stringify(result);
+    }
+    async listTasks(params) {
+        const result = await this.request("POST", "/api/agent/list-tasks", params);
+        return JSON.stringify(result);
+    }
+    // ─── Knowledge link operations ──────────────────────────────────────────
+    async getLinks(params) {
+        const result = await this.request("POST", "/api/agent/get-links", params);
+        return JSON.stringify(result);
+    }
+    async addLink(params) {
+        const result = await this.request("POST", "/api/agent/add-link", params);
+        return JSON.stringify(result);
+    }
+    async removeLink(linkId) {
+        const result = await this.request("POST", "/api/agent/remove-link", { linkId });
+        return JSON.stringify(result);
+    }
+    // ─── Graph exploration ─────────────────────────────────────────────────
+    async exploreGraph(params) {
+        const result = await this.request("POST", "/api/agent/explore-graph", params);
+        return JSON.stringify(result);
+    }
+    // ─── Turn ingestion ────────────────────────────────────────────────────
+    async ingestTurn(params) {
+        const result = await this.request("POST", "/api/agent/ingest-turn", params);
+        return JSON.stringify(result);
+    }
+    // ─── Settings operations ──────────────────────────────────────────────
+    async getSettings(vaultId) {
+        const result = await this.request("POST", "/api/agent/get-settings", vaultId ? { vaultId } : {});
+        return JSON.stringify(result);
+    }
+    async updateSettings(params) {
+        const result = await this.request("POST", "/api/agent/update-settings", params);
+        return JSON.stringify(result);
+    }
+    // ─── Session tracking ──────────────────────────────────────────────────
+    /**
+     * Record a tool call in the agent_sessions table. Fire-and-forget —
+     * errors are swallowed so tracking never blocks tool execution.
+     */
+    async trackSession(params) {
+        try {
+            await this.request("POST", "/api/agent/session-track", params);
+        }
+        catch {
+            // Fire-and-forget — never fail the tool call because of tracking
+        }
+    }
+    // ─── Agent messaging ─────────────────────────────────────────────────────
+    async sendMessage(params) {
+        const result = await this.request("POST", "/api/agent/send-message", params);
+        return JSON.stringify(result);
+    }
+    async ackMessage(messageId) {
+        const result = await this.request("POST", "/api/agent/ack-message", { messageId });
+        return JSON.stringify(result);
+    }
+    async readMessages(params) {
+        const result = await this.request("POST", "/api/agent/read-messages", params);
+        return JSON.stringify(result);
+    }
+    async getPendingMessages(params) {
+        const result = await this.request("POST", "/api/agent/pending-messages", params);
+        return JSON.stringify(result);
+    }
+    async readDocument(params) {
+        const result = await this.request("POST", "/api/agent/read-document", params);
+        return JSON.stringify(result);
+    }
+    async readDocs(params) {
+        const result = await this.request("POST", "/api/agent/read-docs", params);
+        return JSON.stringify(result);
+    }
+    async updateDocument(params) {
+        const result = await this.request("POST", "/api/agent/update-document", params);
+        return JSON.stringify(result);
+    }
+}

package/dist/gateway-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway-client.js","sourceRoot":"","sources":["../src/gateway-client.ts"],"names":[],"mappings":"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"}

package/dist/gateway-init.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Gateway mode initialization for the MCP server.
+ *
+ * When EXOVAULT_AGENT_KEY is set (via env var or config.json),
+ * the MCP server routes all operations through the HTTP gateway
+ * instead of connecting directly to Supabase.
+ */
+import { type McpConfig } from "./auth.js";
+import { GatewayClient } from "./gateway-client.js";
+export interface GatewayMode {
+    mode: "gateway";
+    client: GatewayClient;
+    agentLabel?: string;
+    defaultVaultId?: string;
+    allowedVaultIds?: string[];
+    allowGlobalMemoryWrite: boolean;
+    /** Per-vault scope preset overrides. Key = vaultId, value = preset or null (inherit). */
+    vaultScopePresets?: Record<string, string | null>;
+}
+/**
+ * Resolves the agent key and API URL from config + env vars.
+ * Returns null if gateway mode is not configured.
+ */
+export declare function resolveGatewayConfig(config: McpConfig): {
+    agentKey: string;
+    apiUrl: string;
+} | null;
+/**
+ * Initializes the MCP server in gateway mode.
+ * Creates a GatewayClient and validates the connection via /api/agent/info.
+ */
+export declare function initializeGateway(): Promise<GatewayMode>;

package/dist/gateway-init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway-init.d.ts","sourceRoot":"","sources":["../src/gateway-init.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAc,KAAK,SAAS,EAAE,MAAM,WAAW,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,aAAa,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,sBAAsB,EAAE,OAAO,CAAC;IAChC,yFAAyF;IACzF,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;CACnD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG;IACvD,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,IAAI,CAQP;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,WAAW,CAAC,CA+D9D"}

package/dist/gateway-init.js

@@ -0,0 +1,71 @@
+/**
+ * Gateway mode initialization for the MCP server.
+ *
+ * When EXOVAULT_AGENT_KEY is set (via env var or config.json),
+ * the MCP server routes all operations through the HTTP gateway
+ * instead of connecting directly to Supabase.
+ */
+import { randomUUID } from "node:crypto";
+import { readConfig } from "./auth.js";
+import { GatewayClient } from "./gateway-client.js";
+/**
+ * Resolves the agent key and API URL from config + env vars.
+ * Returns null if gateway mode is not configured.
+ */
+export function resolveGatewayConfig(config) {
+    const agentKey = process.env.EXOVAULT_AGENT_KEY ?? config.agentKey;
+    if (!agentKey)
+        return null;
+    const apiUrl = process.env.EXOVAULT_API_URL ?? config.apiUrl ?? "https://exovault.co";
+    return { agentKey, apiUrl };
+}
+/**
+ * Initializes the MCP server in gateway mode.
+ * Creates a GatewayClient and validates the connection via /api/agent/info.
+ */
+export async function initializeGateway() {
+    const config = await readConfig();
+    const resolved = resolveGatewayConfig(config);
+    if (!resolved) {
+        throw new Error("Gateway mode requires EXOVAULT_AGENT_KEY env var or agentKey in config.json");
+    }
+    const sessionRunId = randomUUID();
+    const client = new GatewayClient(resolved.apiUrl, resolved.agentKey, sessionRunId);
+    process.stderr.write(`[exovault-mcp] Session run ID: ${sessionRunId}\n`);
+    // Validate the connection
+    const info = await client.info();
+    process.stderr.write(`[exovault-mcp] Gateway mode: connected to ${resolved.apiUrl} as integration ${info.integrationId}\n`);
+    // Determine default vault: allowed vaults > config override > info.vaultId
+    const allowedVaultIds = info.allowedVaultIds ?? undefined;
+    let defaultVaultId;
+    if (info.restrictToVault && allowedVaultIds?.length) {
+        // For vault-restricted agents, always default to the first allowed vault
+        defaultVaultId = allowedVaultIds[0];
+    }
+    else if (config.defaultVaultId) {
+        defaultVaultId = config.defaultVaultId;
+    }
+    else if (info.vaultId) {
+        defaultVaultId = info.vaultId;
+    }
+    // Validate: config override must be in allowed set for restricted agents
+    if (defaultVaultId &&
+        info.restrictToVault &&
+        allowedVaultIds?.length &&
+        !allowedVaultIds.includes(defaultVaultId)) {
+        process.stderr.write(`[exovault-mcp] Warning: defaultVaultId ${defaultVaultId} not in allowed vaults, using ${allowedVaultIds[0]}\n`);
+        defaultVaultId = allowedVaultIds[0];
+    }
+    if (allowedVaultIds && allowedVaultIds.length > 1) {
+        process.stderr.write(`[exovault-mcp] Multi-vault access: ${allowedVaultIds.length} vaults allowed. Default vault: ${defaultVaultId ?? "none"}.\n`);
+    }
+    return {
+        mode: "gateway",
+        client,
+        agentLabel: info.label,
+        defaultVaultId,
+        allowedVaultIds,
+        allowGlobalMemoryWrite: config.allowGlobalMemoryWrite === true,
+        vaultScopePresets: info.vaultScopePresets ?? undefined,
+    };
+}

package/dist/gateway-init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway-init.js","sourceRoot":"","sources":["../src/gateway-init.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}