exovault 1.0.0

package/dist/config.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Configuration loader for the ExoVault proxy.
+ *
+ * Priority: env vars > config file > defaults.
+ * Config file at ~/.exovault-proxy/config.json is optional (created by setup).
+ */
+import type { ProxyConfig } from "./types/config.js";
+export declare function loadConfig(): ProxyConfig;

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AA4BrD,wBAAgB,UAAU,IAAI,WAAW,CAoCxC"}

package/dist/config.js

@@ -0,0 +1,53 @@
+/**
+ * Configuration loader for the ExoVault proxy.
+ *
+ * Priority: env vars > config file > defaults.
+ * Config file at ~/.exovault-proxy/config.json is optional (created by setup).
+ */
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+const CONFIG_DIR = join(homedir(), ".exovault");
+const LEGACY_CONFIG_DIR = join(homedir(), ".exovault-proxy");
+const CONFIG_FILE = join(CONFIG_DIR, "config.json");
+const LEGACY_CONFIG_FILE = join(LEGACY_CONFIG_DIR, "config.json");
+function readConfigFile() {
+    // Try new location first, fall back to legacy
+    for (const path of [CONFIG_FILE, LEGACY_CONFIG_FILE]) {
+        try {
+            const content = readFileSync(path, "utf-8");
+            return JSON.parse(content);
+        }
+        catch {
+            // Try next path
+        }
+    }
+    return {};
+}
+export function loadConfig() {
+    const file = readConfigFile();
+    const agentKey = process.env.EXOVAULT_AGENT_KEY ??
+        file.agentKey;
+    if (!agentKey) {
+        throw new Error("Missing EXOVAULT_AGENT_KEY. Run `npx exovault connect <key>` or set the environment variable.");
+    }
+    const apiUrl = process.env.EXOVAULT_API_URL ??
+        file.apiUrl ??
+        "https://exovault.co";
+    // Bind to localhost only by default — opt in to 0.0.0.0 via config
+    const host = process.env.EXOVAULT_PROXY_HOST ??
+        file.host ??
+        "127.0.0.1";
+    const rawPort = process.env.EXOVAULT_PROXY_PORT ? parseInt(process.env.EXOVAULT_PROXY_PORT, 10) : NaN;
+    const port = (!isNaN(rawPort) && rawPort > 0 && rawPort < 65536) ? rawPort : (file.port ?? 4100);
+    const upstreamBaseUrl = process.env.ANTHROPIC_UPSTREAM_URL ??
+        file.upstreamBaseUrl ??
+        "https://api.anthropic.com";
+    // Warn if upstream URL is not HTTPS (and not localhost)
+    if (upstreamBaseUrl.startsWith("http://") && !upstreamBaseUrl.includes("localhost") && !upstreamBaseUrl.includes("127.0.0.1")) {
+        console.warn("[exovault] WARNING: upstream URL uses HTTP — API keys will be sent in plaintext!");
+    }
+    const rawMaxChars = process.env.EXOVAULT_MAX_INJECTION_CHARS ? parseInt(process.env.EXOVAULT_MAX_INJECTION_CHARS, 10) : NaN;
+    const maxInjectionChars = (!isNaN(rawMaxChars) && rawMaxChars > 0) ? rawMaxChars : (file.maxInjectionChars ?? 2000);
+    return { agentKey, apiUrl, host, port, upstreamBaseUrl, maxInjectionChars };
+}

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAGlC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,WAAW,CAAC,CAAC;AAChD,MAAM,iBAAiB,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,iBAAiB,CAAC,CAAC;AAC7D,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;AACpD,MAAM,kBAAkB,GAAG,IAAI,CAAC,iBAAiB,EAAE,aAAa,CAAC,CAAC;AAUlE,SAAS,cAAc;IACrB,8CAA8C;IAC9C,KAAK,MAAM,IAAI,IAAI,CAAC,WAAW,EAAE,kBAAkB,CAAC,EAAE,CAAC;QACrD,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAC5C,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAe,CAAC;QAC3C,CAAC;QAAC,MAAM,CAAC;YACP,gBAAgB;QAClB,CAAC;IACH,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,MAAM,IAAI,GAAG,cAAc,EAAE,CAAC;IAE9B,MAAM,QAAQ,GACZ,OAAO,CAAC,GAAG,CAAC,kBAAkB;QAC9B,IAAI,CAAC,QAAQ,CAAC;IAEhB,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CACb,+FAA+F,CAChG,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GACV,OAAO,CAAC,GAAG,CAAC,gBAAgB;QAC5B,IAAI,CAAC,MAAM;QACX,sBAAsB,CAAC;IAEzB,MAAM,IAAI,GACR,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC7F,IAAI,CAAC,IAAI;QACT,IAAI,CAAC;IAEP,MAAM,eAAe,GACnB,OAAO,CAAC,GAAG,CAAC,sBAAsB;QAClC,IAAI,CAAC,eAAe;QACpB,2BAA2B,CAAC;IAE9B,MAAM,iBAAiB,GACrB,CAAC,OAAO,CAAC,GAAG,CAAC,4BAA4B;QACvC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,4BAA4B,EAAE,EAAE,CAAC;QACxD,CAAC,CAAC,SAAS,CAAC;QACd,IAAI,CAAC,iBAAiB;QACtB,IAAI,CAAC;IAEP,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,EAAE,iBAAiB,EAAE,CAAC;AACxE,CAAC"}

package/dist/connect.d.ts

@@ -0,0 +1,32 @@
+/**
+ * `exovault connect <key>` — one-time setup for the unified proxy + MCP server.
+ *
+ * 1. Validates the agent key
+ * 2. Auto-detects agent type (Claude Code, Cursor, or Custom)
+ * 3. Writes proxy config to ~/.exovault/config.json
+ * 4. Writes MCP config to the agent's config location
+ * 5. Prints next-steps instructions
+ */
+export type AgentType = "claude-code" | "cursor" | "custom";
+/**
+ * Detect agent type by checking for known config directories.
+ * @param home - Home directory path
+ * @param exists - File existence checker (injectable for testing)
+ */
+export declare function detectAgentType(home: string, exists?: (path: string) => boolean): AgentType;
+/**
+ * Build the MCP config object for a given agent type.
+ * Returns null for custom agents (they use env vars instead).
+ */
+export declare function buildMcpConfig(agentType: AgentType, port: number): {
+    mcpServers: Record<string, Record<string, unknown>>;
+} | null;
+/**
+ * Merge new MCP config into an existing config file, preserving other entries.
+ */
+export declare function mergeMcpConfig(existing: Record<string, unknown>, newConfig: {
+    mcpServers: Record<string, Record<string, unknown>>;
+}): Record<string, unknown> & {
+    mcpServers: Record<string, unknown>;
+};
+export declare function runConnect(): Promise<void>;

package/dist/connect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect.d.ts","sourceRoot":"","sources":["../src/connect.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AASH,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAO5D;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,MAAM,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAoB,GAC7C,SAAS,CAIX;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE,MAAM,GACX;IAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;CAAE,GAAG,IAAI,CAoBhE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,SAAS,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;CAAE,GACjE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CASnE;AAID,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAwHhD"}

package/dist/connect.js

@@ -0,0 +1,224 @@
+/**
+ * `exovault connect <key>` — one-time setup for the unified proxy + MCP server.
+ *
+ * 1. Validates the agent key
+ * 2. Auto-detects agent type (Claude Code, Cursor, or Custom)
+ * 3. Writes proxy config to ~/.exovault/config.json
+ * 4. Writes MCP config to the agent's config location
+ * 5. Prints next-steps instructions
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { mkdir, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { homedir } from "node:os";
+import { parseArgs } from "node:util";
+import { GatewayClient } from "./gateway-client.js";
+const DEFAULT_PORT = 4100;
+const DEFAULT_API_URL = "https://exovault.co";
+// ─── Pure functions (testable) ───────────────────────────────────────────────
+/**
+ * Detect agent type by checking for known config directories.
+ * @param home - Home directory path
+ * @param exists - File existence checker (injectable for testing)
+ */
+export function detectAgentType(home, exists = existsSync) {
+    if (exists(join(home, ".claude")))
+        return "claude-code";
+    if (exists(join(home, ".cursor")))
+        return "cursor";
+    return "custom";
+}
+/**
+ * Build the MCP config object for a given agent type.
+ * Returns null for custom agents (they use env vars instead).
+ */
+export function buildMcpConfig(agentType, port) {
+    const mcpUrl = `http://localhost:${port}/mcp`;
+    if (agentType === "claude-code") {
+        return {
+            mcpServers: {
+                "exo-vault": { type: "http", url: mcpUrl },
+            },
+        };
+    }
+    if (agentType === "cursor") {
+        return {
+            mcpServers: {
+                "exo-vault": { url: mcpUrl },
+            },
+        };
+    }
+    return null;
+}
+/**
+ * Merge new MCP config into an existing config file, preserving other entries.
+ */
+export function mergeMcpConfig(existing, newConfig) {
+    const existingServers = (existing.mcpServers ?? {});
+    return {
+        ...existing,
+        mcpServers: {
+            ...existingServers,
+            ...newConfig.mcpServers,
+        },
+    };
+}
+// ─── CLI command ─────────────────────────────────────────────────────────────
+export async function runConnect() {
+    let agentKey;
+    let apiUrl;
+    let agentFlag;
+    try {
+        const { values, positionals } = parseArgs({
+            options: {
+                "agent-key": { type: "string" },
+                agent: { type: "string" },
+                "api-url": { type: "string" },
+                help: { type: "boolean", short: "h" },
+            },
+            strict: false,
+            allowPositionals: true,
+            args: process.argv.slice(3), // skip "node", "index.js", "connect"
+        });
+        if (values.help) {
+            printConnectUsage();
+            process.exit(0);
+        }
+        // Agent key: positional or --agent-key flag
+        agentKey = positionals[0] ?? values["agent-key"];
+        apiUrl = values["api-url"];
+        agentFlag = values.agent;
+    }
+    catch {
+        console.error("Error: Invalid arguments.\n");
+        printConnectUsage();
+        process.exit(1);
+    }
+    if (!agentKey) {
+        console.error("Error: Agent key is required.\n");
+        printConnectUsage();
+        process.exit(1);
+    }
+    const baseUrl = apiUrl ?? DEFAULT_API_URL;
+    const port = DEFAULT_PORT;
+    const home = homedir();
+    console.log("╔═══════════════════════════════════════════════╗");
+    console.log("║   ExoVault — Connect                          ║");
+    console.log("╚═══════════════════════════════════════════════╝");
+    console.log();
+    // ── Step 1: Validate agent key ──
+    console.log("Validating agent key...");
+    const gateway = new GatewayClient(baseUrl, agentKey);
+    try {
+        const info = await gateway.info();
+        console.log(`  Agent type: ${info.agentType}`);
+        console.log(`  Scopes: ${info.scopes.join(", ")}`);
+        if (info.vaultId) {
+            console.log(`  Vault-restricted: ${info.vaultId}`);
+        }
+        console.log();
+    }
+    catch (err) {
+        console.error("Agent key validation failed:", err instanceof Error ? err.message : err);
+        process.exit(1);
+    }
+    // ── Step 2: Detect agent type ──
+    const agentType = agentFlag ?? detectAgentType(home);
+    console.log(`Detected agent: ${agentType}`);
+    // ── Step 3: Write proxy config ──
+    const configDir = join(home, ".exovault");
+    const configFile = join(configDir, "config.json");
+    await mkdir(configDir, { recursive: true, mode: 0o700 });
+    const proxyConfig = { agentKey, apiUrl: baseUrl, port };
+    await writeFile(configFile, JSON.stringify(proxyConfig, null, 2), {
+        encoding: "utf-8",
+        mode: 0o600,
+    });
+    console.log(`Proxy config written to: ${configFile}`);
+    // ── Step 4: Write MCP config ──
+    const mcpConfig = buildMcpConfig(agentType, port);
+    if (mcpConfig) {
+        const mcpConfigPath = getMcpConfigPath(agentType);
+        // Read existing config to merge
+        let existing = {};
+        try {
+            const raw = readFileSync(mcpConfigPath, "utf-8");
+            existing = JSON.parse(raw);
+        }
+        catch {
+            // File doesn't exist or is invalid — start fresh
+        }
+        const merged = mergeMcpConfig(existing, mcpConfig);
+        // Ensure parent directory exists for cursor
+        if (agentType === "cursor") {
+            await mkdir(join(process.cwd(), ".cursor"), { recursive: true });
+        }
+        await writeFile(mcpConfigPath, JSON.stringify(merged, null, 2), {
+            encoding: "utf-8",
+        });
+        console.log(`MCP config written to: ${mcpConfigPath}`);
+    }
+    // ── Step 5: Print instructions ──
+    console.log();
+    console.log("╔═══════════════════════════════════════════════╗");
+    console.log("║   ExoVault Connected!                         ║");
+    console.log("╚═══════════════════════════════════════════════╝");
+    console.log();
+    if (agentType === "custom") {
+        printCustomInstructions(port);
+    }
+    else {
+        printAgentInstructions(agentType, port);
+    }
+}
+function getMcpConfigPath(agentType) {
+    const cwd = process.cwd();
+    if (agentType === "claude-code")
+        return join(cwd, ".mcp.json");
+    if (agentType === "cursor")
+        return join(cwd, ".cursor", "mcp.json");
+    return ""; // custom — no file
+}
+function printAgentInstructions(agentType, port) {
+    console.log("  Next steps:");
+    console.log(`    1. Start ExoVault:  npx exovault start`);
+    console.log(`    2. Set your environment:`);
+    console.log(`       export ANTHROPIC_BASE_URL=http://localhost:${port}`);
+    console.log();
+    if (agentType === "claude-code") {
+        console.log("    3. Open Claude Code — you're all set!");
+    }
+    else if (agentType === "cursor") {
+        console.log("    3. Open Cursor — you're all set!");
+    }
+    console.log();
+    console.log("  Your agent gets:");
+    console.log("    Active tools  — search, write, read memories via MCP");
+    console.log("    Auto-capture  — conversations stored automatically via proxy");
+    console.log();
+}
+function printCustomInstructions(port) {
+    console.log("  Set your environment:");
+    console.log(`    export ANTHROPIC_BASE_URL=http://localhost:${port}`);
+    console.log();
+    console.log("  MCP endpoint:");
+    console.log(`    http://localhost:${port}/mcp`);
+    console.log();
+    console.log("  Start ExoVault:");
+    console.log("    npx exovault start");
+    console.log();
+}
+function printConnectUsage() {
+    console.log("Usage:");
+    console.log("  exovault connect <agent-key> [options]");
+    console.log();
+    console.log("Options:");
+    console.log("  --agent <type>    Agent type: claude-code, cursor, custom (auto-detected if omitted)");
+    console.log("  --api-url <url>   ExoVault API URL (default: https://exovault.co)");
+    console.log("  -h, --help        Show this help");
+    console.log();
+    console.log("Examples:");
+    console.log("  exovault connect exv_abc123");
+    console.log("  exovault connect exv_abc123 --agent cursor");
+    console.log("  exovault connect exv_abc123 --api-url http://localhost:3000");
+}

package/dist/connect.js.map

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

package/dist/gateway-client.d.ts

@@ -0,0 +1,104 @@
+/**
+ * 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)
+ */
+import type { AgentInfo, MemoryHit, PendingMessage, SessionStartResponse } from "./types/config.js";
+export declare class GatewayError extends Error {
+    status: number;
+    constructor(message: string, status: number);
+}
+export declare class GatewayClient {
+    private baseUrl;
+    private apiKey;
+    constructor(baseUrl: string, apiKey: string);
+    private request;
+    /** Generic POST that returns JSON string. Used by most MCP tools. */
+    private postJson;
+    info(): Promise<AgentInfo>;
+    proxySessionStart(params?: {
+        vaultId?: string;
+        query?: string;
+        mode?: string;
+    }): Promise<SessionStartResponse>;
+    proxySearchMemories(params: {
+        query: string;
+        topK?: number;
+        threshold?: number;
+        vaultId?: string;
+    }): Promise<{
+        memories: MemoryHit[];
+    }>;
+    proxyFetchPendingMessages(params?: {
+        limit?: number;
+        vaultId?: string;
+    }): Promise<{
+        messages: PendingMessage[];
+        total: number;
+    }>;
+    proxyIngestTurn(params: {
+        content: string;
+        role: "user" | "assistant";
+        agentId?: string;
+        agentRunId?: string;
+        vaultId?: string;
+    }): Promise<{
+        turnId: string;
+    }>;
+    writeMemory(params: Record<string, unknown>): Promise<string>;
+    searchMemories(params: Record<string, unknown>): Promise<string>;
+    readMemories(memoryIds: string[]): Promise<string>;
+    updateMemory(params: Record<string, unknown>): Promise<string>;
+    archiveMemory(memoryId: string, archived?: boolean): Promise<string>;
+    getRelatedMemories(memoryId: string, limit?: number): Promise<string>;
+    cleanupMemories(params: Record<string, unknown>): Promise<string>;
+    listNotes(params: Record<string, unknown>): Promise<string>;
+    readNote(noteId: string): Promise<string>;
+    readNotes(noteIds: string[]): Promise<string>;
+    searchNotes(params: Record<string, unknown>): Promise<string>;
+    createNote(params: Record<string, unknown>): Promise<string>;
+    updateNote(params: Record<string, unknown>): Promise<string>;
+    deleteNote(noteId: string): Promise<string>;
+    semanticSearch(params: Record<string, unknown>): Promise<string>;
+    searchAndRead(params: Record<string, unknown>): Promise<string>;
+    createTask(params: Record<string, unknown>): Promise<string>;
+    updateTask(params: Record<string, unknown>): Promise<string>;
+    listTasks(params: Record<string, unknown>): Promise<string>;
+    createPlanTasks(params: Record<string, unknown>): Promise<string>;
+    listVaults(): Promise<string>;
+    createVault(params: Record<string, unknown>): Promise<string>;
+    getLinks(params: Record<string, unknown>): Promise<string>;
+    addLink(params: Record<string, unknown>): Promise<string>;
+    removeLink(linkId: string): Promise<string>;
+    sessionStart(params: Record<string, unknown>): Promise<string>;
+    contextCheckpoint(params: Record<string, unknown>): Promise<string>;
+    listActiveAgents(sinceDays?: number, limit?: number): Promise<string>;
+    ingestTurn(params: Record<string, unknown>): Promise<string>;
+    updateDocument(params: Record<string, unknown>): Promise<string>;
+    /**
+     * Log a pipeline event for proxy observability.
+     * Fire-and-forget — errors are swallowed so logging never blocks.
+     */
+    logPipelineEvent(event: {
+        eventType: string;
+        payload: Record<string, unknown>;
+        sessionId?: string;
+        durationMs?: number;
+    }): void;
+    /**
+     * Record a tool call / event in the agent_sessions table.
+     * Fire-and-forget — errors are swallowed so tracking never blocks.
+     */
+    trackSession(params: {
+        toolName: string;
+        agentRunId: string;
+        agentId?: string;
+        agentType?: string;
+        modelId?: string;
+        vaultId?: string;
+        inputSummary?: string;
+        outputSummary?: string;
+    }): Promise<void>;
+}

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

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