exovault 1.0.0

package/dist/gateway-client.js

@@ -0,0 +1,242 @@
+/**
+ * ExoVault gateway client for the unified proxy + MCP server.
+ *
+ * Two method styles:
+ * - proxy*() methods return parsed objects (used by proxy pipeline)
+ * - All other methods return JSON strings (used by MCP tool handlers)
+ */
+export class GatewayError extends Error {
+    status;
+    constructor(message, status) {
+        super(message);
+        this.status = status;
+        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;
+    constructor(baseUrl, apiKey) {
+        this.baseUrl = baseUrl.replace(/\/$/, "");
+        this.apiKey = apiKey;
+    }
+    async request(method, path, body) {
+        const url = `${this.baseUrl}${path}`;
+        const headers = {
+            Authorization: `Bearer ${this.apiKey}`,
+        };
+        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 errorMsg;
+                    try {
+                        const errorBody = await response.json();
+                        errorMsg = errorBody.error ?? `Gateway returned ${response.status}`;
+                    }
+                    catch {
+                        errorMsg = `Gateway returned ${response.status}`;
+                    }
+                    throw new GatewayError(errorMsg, response.status);
+                }
+                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;
+    }
+    /** Generic POST that returns JSON string. Used by most MCP tools. */
+    async postJson(path, body) {
+        const result = await this.request("POST", path, body);
+        return JSON.stringify(result, null, 2);
+    }
+    // ═══════════════════════════════════════════════════════════════════════════
+    // Info (shared — returns parsed object)
+    // ═══════════════════════════════════════════════════════════════════════════
+    async info() {
+        return this.request("GET", "/api/agent/info");
+    }
+    // ═══════════════════════════════════════════════════════════════════════════
+    // Proxy pipeline methods — return PARSED objects for direct use
+    // ═══════════════════════════════════════════════════════════════════════════
+    async proxySessionStart(params) {
+        return this.request("POST", "/api/agent/session-start", params ?? {});
+    }
+    async proxySearchMemories(params) {
+        return this.request("POST", "/api/agent/search-memories", {
+            ...params,
+            compact: true,
+        });
+    }
+    async proxyFetchPendingMessages(params) {
+        return this.request("POST", "/api/agent/pending-messages", params ?? { limit: 5 });
+    }
+    async proxyIngestTurn(params) {
+        return this.request("POST", "/api/agent/ingest-turn", {
+            ...params,
+            // Proxy captures full conversations — flag ALL turns for extraction.
+            // Signal-based filtering is for MCP mode where agents trigger selectively.
+            signalThreshold: 0,
+        });
+    }
+    // ═══════════════════════════════════════════════════════════════════════════
+    // MCP tool methods — return JSON STRINGS for tool responses
+    // ═══════════════════════════════════════════════════════════════════════════
+    // ─── Memory ───────────────────────────────────────────────────────────────
+    async writeMemory(params) {
+        return this.postJson("/api/agent/write-memory", params);
+    }
+    async searchMemories(params) {
+        return this.postJson("/api/agent/search-memories", params);
+    }
+    async readMemories(memoryIds) {
+        return this.postJson("/api/agent/read-memories", { memoryIds });
+    }
+    async updateMemory(params) {
+        return this.postJson("/api/agent/update-memory", params);
+    }
+    async archiveMemory(memoryId, archived) {
+        return this.postJson("/api/agent/archive-memory", { memoryId, archived: archived ?? true });
+    }
+    async getRelatedMemories(memoryId, limit) {
+        return this.postJson("/api/agent/get-related-memories", { memoryId, limit });
+    }
+    async cleanupMemories(params) {
+        return this.postJson("/api/agent/cleanup-memories", params);
+    }
+    // ─── Notes ────────────────────────────────────────────────────────────────
+    async listNotes(params) {
+        return this.postJson("/api/agent/list-notes", params);
+    }
+    async readNote(noteId) {
+        return this.postJson("/api/agent/read-note", { noteId });
+    }
+    async readNotes(noteIds) {
+        return this.postJson("/api/agent/read-notes", { noteIds });
+    }
+    async searchNotes(params) {
+        return this.postJson("/api/agent/search-notes", params);
+    }
+    async createNote(params) {
+        return this.postJson("/api/agent/create-note", params);
+    }
+    async updateNote(params) {
+        return this.postJson("/api/agent/update-note", params);
+    }
+    async deleteNote(noteId) {
+        return this.postJson("/api/agent/delete-note", { noteId });
+    }
+    // ─── Search ───────────────────────────────────────────────────────────────
+    async semanticSearch(params) {
+        return this.postJson("/api/agent/semantic-search", params);
+    }
+    async searchAndRead(params) {
+        return this.postJson("/api/agent/search-and-read", params);
+    }
+    // ─── Tasks ────────────────────────────────────────────────────────────────
+    async createTask(params) {
+        return this.postJson("/api/agent/create-task", params);
+    }
+    async updateTask(params) {
+        return this.postJson("/api/agent/update-task", params);
+    }
+    async listTasks(params) {
+        return this.postJson("/api/agent/list-tasks", params);
+    }
+    async createPlanTasks(params) {
+        return this.postJson("/api/agent/create-plan-tasks", params);
+    }
+    // ─── Vaults ───────────────────────────────────────────────────────────────
+    async listVaults() {
+        const result = await this.request("GET", "/api/agent/list-vaults");
+        return JSON.stringify(result, null, 2);
+    }
+    async createVault(params) {
+        return this.postJson("/api/agent/create-vault", params);
+    }
+    // ─── Knowledge Links ──────────────────────────────────────────────────────
+    async getLinks(params) {
+        return this.postJson("/api/agent/get-links", params);
+    }
+    async addLink(params) {
+        return this.postJson("/api/agent/add-link", params);
+    }
+    async removeLink(linkId) {
+        return this.postJson("/api/agent/remove-link", { linkId });
+    }
+    // ─── System / Composite ───────────────────────────────────────────────────
+    async sessionStart(params) {
+        return this.postJson("/api/agent/session-start", params);
+    }
+    async contextCheckpoint(params) {
+        return this.postJson("/api/agent/context-checkpoint", params);
+    }
+    async listActiveAgents(sinceDays, limit) {
+        return this.postJson("/api/agent/list-active-agents", { sinceDays, limit });
+    }
+    async ingestTurn(params) {
+        return this.postJson("/api/agent/ingest-turn", params);
+    }
+    async updateDocument(params) {
+        return this.postJson("/api/agent/update-document", params);
+    }
+    // ═══════════════════════════════════════════════════════════════════════════
+    // Pipeline event logging — fire-and-forget, errors swallowed
+    // ═══════════════════════════════════════════════════════════════════════════
+    /**
+     * Log a pipeline event for proxy observability.
+     * Fire-and-forget — errors are swallowed so logging never blocks.
+     */
+    logPipelineEvent(event) {
+        this.request("POST", "/api/agent/pipeline-event", event).catch(() => { });
+    }
+    // ═══════════════════════════════════════════════════════════════════════════
+    // Session tracking — fire-and-forget, errors swallowed
+    // ═══════════════════════════════════════════════════════════════════════════
+    /**
+     * Record a tool call / event in the agent_sessions table.
+     * Fire-and-forget — errors are swallowed so tracking never blocks.
+     */
+    async trackSession(params) {
+        try {
+            await this.request("POST", "/api/agent/session-track", params);
+        }
+        catch {
+            // Fire-and-forget — never fail the caller
+        }
+    }
+}

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/index.d.ts

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+/**
+ * ExoVault — unified proxy + MCP server CLI.
+ *
+ * Usage:
+ *   exovault connect <key>    One-time setup (writes MCP + proxy configs)
+ *   exovault start            Start the proxy + MCP server
+ *   exovault setup            (backward compat alias for old proxy setup)
+ */
+export {};

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC"}

package/dist/index.js

@@ -0,0 +1,60 @@
+#!/usr/bin/env node
+/**
+ * ExoVault — unified proxy + MCP server CLI.
+ *
+ * Usage:
+ *   exovault connect <key>    One-time setup (writes MCP + proxy configs)
+ *   exovault start            Start the proxy + MCP server
+ *   exovault setup            (backward compat alias for old proxy setup)
+ */
+const command = process.argv[2];
+async function main() {
+    if (command === "connect") {
+        const { runConnect } = await import("./connect.js");
+        await runConnect();
+    }
+    else if (command === "setup") {
+        // Backward compat alias
+        const { runSetup } = await import("./setup.js");
+        await runSetup();
+    }
+    else if (command === "start" || !command) {
+        const { loadConfig } = await import("./config.js");
+        const { startServer } = await import("./server.js");
+        try {
+            const config = loadConfig();
+            await startServer(config);
+        }
+        catch (error) {
+            console.error("Failed to start:", error instanceof Error ? error.message : error);
+            process.exit(1);
+        }
+    }
+    else if (command === "--help" || command === "-h") {
+        printHelp();
+    }
+    else {
+        console.error(`Unknown command: ${command}\n`);
+        printHelp();
+        process.exit(1);
+    }
+}
+function printHelp() {
+    console.log("ExoVault — proxy + MCP server for durable agent memory");
+    console.log();
+    console.log("Usage:");
+    console.log("  exovault connect <key>   One-time setup (validates key, writes configs)");
+    console.log("  exovault start           Start the proxy + MCP server");
+    console.log("  exovault setup           Legacy setup (backward compat)");
+    console.log("  exovault --help          Show this help");
+    console.log();
+    console.log("Quickstart:");
+    console.log("  npx exovault connect exv_abc123");
+    console.log("  npx exovault start");
+    console.log("  export ANTHROPIC_BASE_URL=http://localhost:4100");
+}
+main().catch((err) => {
+    console.error(err);
+    process.exit(1);
+});
+export {};

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;GAOG;AAIH,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAEhC,KAAK,UAAU,IAAI;IACjB,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,CAAC;QACpD,MAAM,UAAU,EAAE,CAAC;IACrB,CAAC;SAAM,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;QAC/B,wBAAwB;QACxB,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;QAChD,MAAM,QAAQ,EAAE,CAAC;IACnB,CAAC;SAAM,IAAI,OAAO,KAAK,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC;QAC3C,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;QACnD,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;QAEpD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;YAC5B,MAAM,WAAW,CAAC,MAAM,CAAC,CAAC;QAC5B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,kBAAkB,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YAClF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;SAAM,IAAI,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACpD,SAAS,EAAE,CAAC;IACd,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,KAAK,CAAC,oBAAoB,OAAO,IAAI,CAAC,CAAC;QAC/C,SAAS,EAAE,CAAC;QACZ,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,SAAS,SAAS;IAChB,OAAO,CAAC,GAAG,CAAC,wDAAwD,CAAC,CAAC;IACtE,OAAO,CAAC,GAAG,EAAE,CAAC;IACd,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACtB,OAAO,CAAC,GAAG,CAAC,2EAA2E,CAAC,CAAC;IACzF,OAAO,CAAC,GAAG,CAAC,yDAAyD,CAAC,CAAC;IACvE,OAAO,CAAC,GAAG,CAAC,2DAA2D,CAAC,CAAC;IACzE,OAAO,CAAC,GAAG,CAAC,2CAA2C,CAAC,CAAC;IACzD,OAAO,CAAC,GAAG,EAAE,CAAC;IACd,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IAC3B,OAAO,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;IACjD,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;IACpC,OAAO,CAAC,GAAG,CAAC,mDAAmD,CAAC,CAAC;AACnE,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/mcp/helpers.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Shared helpers for MCP tool registration in the unified proxy.
+ */
+import { z } from "zod";
+/** MCP SDK AnySchema type — required for Zod v4 compatibility. */
+type AnySchema = import("@modelcontextprotocol/sdk/server/zod-compat.js").AnySchema;
+/** Cast Zod v4 schemas to AnySchema for MCP SDK registerTool. */
+export declare const s: <T extends z.ZodType>(schema: T) => AnySchema;
+/**
+ * Wrap a string-returning handler into an MCP CallToolResult handler with error catching.
+ *
+ * Return type is `any` because the MCP SDK's registerTool overloads have varying
+ * handler signatures (with/without inputSchema, extra arg). The Zod schemas on each
+ * tool provide the real input validation; this wrapper just handles response formatting.
+ */
+export declare function wrapToolHandler(fn: (args: Record<string, unknown>) => Promise<string>): any;
+/** Valid memory types for Zod schemas. */
+export declare const MEMORY_TYPES: readonly ["fact", "skill", "preference", "constraint", "task", "episodic", "correction"];
+export declare const memoryTypeEnum: z.ZodEnum<{
+    fact: "fact";
+    skill: "skill";
+    preference: "preference";
+    constraint: "constraint";
+    task: "task";
+    episodic: "episodic";
+    correction: "correction";
+}>;
+/** Task status enum for Zod schemas. */
+export declare const taskStatusEnum: z.ZodEnum<{
+    done: "done";
+    backlog: "backlog";
+    todo: "todo";
+    in_progress: "in_progress";
+    blocked: "blocked";
+}>;
+/** Relation types for related memories. */
+export declare const relationTypeEnum: z.ZodEnum<{
+    derived_from: "derived_from";
+    contradicts: "contradicts";
+    refines: "refines";
+    part_of: "part_of";
+    supersedes: "supersedes";
+}>;
+/** Knowledge link relation types. */
+export declare const linkRelationTypeEnum: z.ZodEnum<{
+    derived_from: "derived_from";
+    contradicts: "contradicts";
+    refines: "refines";
+    part_of: "part_of";
+    supersedes: "supersedes";
+    wiki_link: "wiki_link";
+    source_of: "source_of";
+    references: "references";
+    manual: "manual";
+}>;
+export {};

package/dist/mcp/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/mcp/helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,kEAAkE;AAClE,KAAK,SAAS,GAAG,OAAO,gDAAgD,EAAE,SAAS,CAAC;AAEpF,iEAAiE;AACjE,eAAO,MAAM,CAAC,GAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,KAAG,SACnB,CAAC;AAEjC;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,EAAE,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,GAErD,GAAG,CAUL;AAED,0CAA0C;AAC1C,eAAO,MAAM,YAAY,0FAA2F,CAAC;AACrH,eAAO,MAAM,cAAc;;;;;;;;EAAuB,CAAC;AAEnD,wCAAwC;AACxC,eAAO,MAAM,cAAc;;;;;;EAAgE,CAAC;AAE5F,2CAA2C;AAC3C,eAAO,MAAM,gBAAgB;;;;;;EAA8E,CAAC;AAE5G,qCAAqC;AACrC,eAAO,MAAM,oBAAoB;;;;;;;;;;EAG/B,CAAC"}

package/dist/mcp/helpers.js

@@ -0,0 +1,37 @@
+/**
+ * Shared helpers for MCP tool registration in the unified proxy.
+ */
+import { z } from "zod";
+/** Cast Zod v4 schemas to AnySchema for MCP SDK registerTool. */
+export const s = (schema) => schema;
+/**
+ * Wrap a string-returning handler into an MCP CallToolResult handler with error catching.
+ *
+ * Return type is `any` because the MCP SDK's registerTool overloads have varying
+ * handler signatures (with/without inputSchema, extra arg). The Zod schemas on each
+ * tool provide the real input validation; this wrapper just handles response formatting.
+ */
+export function wrapToolHandler(fn) {
+    return async (args) => {
+        try {
+            const result = await fn(args ?? {});
+            return { content: [{ type: "text", text: result }] };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return { content: [{ type: "text", text: `Error: ${message}` }], isError: true };
+        }
+    };
+}
+/** Valid memory types for Zod schemas. */
+export const MEMORY_TYPES = ["fact", "skill", "preference", "constraint", "task", "episodic", "correction"];
+export const memoryTypeEnum = z.enum(MEMORY_TYPES);
+/** Task status enum for Zod schemas. */
+export const taskStatusEnum = z.enum(["backlog", "todo", "in_progress", "done", "blocked"]);
+/** Relation types for related memories. */
+export const relationTypeEnum = z.enum(["derived_from", "contradicts", "refines", "part_of", "supersedes"]);
+/** Knowledge link relation types. */
+export const linkRelationTypeEnum = z.enum([
+    "wiki_link", "derived_from", "contradicts", "refines",
+    "part_of", "supersedes", "source_of", "references", "manual",
+]);

package/dist/mcp/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/mcp/helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,iEAAiE;AACjE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAsB,MAAS,EAAa,EAAE,CAC7D,MAA8B,CAAC;AAEjC;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAC7B,EAAsD;IAGtD,OAAO,KAAK,EAAE,IAA6B,EAAE,EAAE;QAC7C,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;YACpC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;QAChE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,OAAO,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC5F,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED,0CAA0C;AAC1C,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,YAAY,CAAU,CAAC;AACrH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;AAEnD,wCAAwC;AACxC,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;AAE5F,2CAA2C;AAC3C,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,cAAc,EAAE,aAAa,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC;AAE5G,qCAAqC;AACrC,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,IAAI,CAAC;IACzC,WAAW,EAAE,cAAc,EAAE,aAAa,EAAE,SAAS;IACrD,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ;CAC7D,CAAC,CAAC"}

package/dist/mcp/register.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Register all ExoVault MCP tools on an McpServer instance.
+ *
+ * Gateway-only: every tool handler calls the GatewayClient directly.
+ * Session tracking: each tool call fires a fire-and-forget trackSession()
+ * to populate the agent_sessions table for the dashboard.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { GatewayClient } from "../gateway-client.js";
+export declare function registerAllTools(server: McpServer, gateway: GatewayClient, agentRunId?: string): void;

package/dist/mcp/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../src/mcp/register.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAU1D,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,aAAa,EACtB,UAAU,CAAC,EAAE,MAAM,GAClB,IAAI,CA+WN"}