@engramprotocol/mcp-server 0.10.1 → 0.10.2

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

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

package/dist/cli.js

@@ -0,0 +1,120 @@
+#!/usr/bin/env node
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const server_1 = require("./server");
+function parseArgs(argv) {
+    const out = {};
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        if (a === '--help' || a === '-h') {
+            out.help = true;
+            continue;
+        }
+        if (a === '--url') {
+            out.url = argv[++i];
+            continue;
+        }
+        if (a === '--token') {
+            out.token = argv[++i];
+            continue;
+        }
+        if (a === '--name') {
+            out.name = argv[++i];
+            continue;
+        }
+    }
+    return out;
+}
+function printHelpAndExit(code) {
+    const msg = `eml-mcp-server — MCP wrapper for the EML HTTP API
+
+Usage:
+  eml-mcp-server --url <api-url> --token <bearer> [--name <client-name>]
+
+Args:
+  --url     EML_API_URL      EML API URL (e.g. http://localhost:3117)
+  --token   EML_API_TOKEN    Bearer token (eml_<prefix><secret>)
+  --name    EML_CLIENT_NAME  Client name in server logs (default: eml-mcp-server)
+  --help
+
+Example — Claude Code MCP config:
+  {
+    "mcpServers": {
+      "engramprotocol": {
+        "command": "npx",
+        "args": ["-y", "@engramprotocol/mcp-server"],
+        "env": {
+          "EML_API_URL": "https://api.engramprotocol.io",
+          "EML_API_TOKEN": "eml_..."
+        }
+      }
+    }
+  }
+`;
+    process.stderr.write(msg);
+    process.exit(code);
+}
+async function main() {
+    const argv = process.argv.slice(2);
+    // Dispatch: setup-mode vs server-mode
+    if (argv[0] === 'setup') {
+        const { runSetup } = await Promise.resolve().then(() => __importStar(require('./setup/index.js')));
+        await runSetup(argv.slice(1));
+        return;
+    }
+    // Server-mode (default)
+    const args = parseArgs(argv);
+    if (args.help)
+        printHelpAndExit(0);
+    const url = args.url ?? process.env.EML_API_URL;
+    const token = args.token ?? process.env.EML_API_TOKEN;
+    const clientName = args.name ?? process.env.EML_CLIENT_NAME ?? 'eml-mcp-server';
+    if (!url || !token) {
+        process.stderr.write('Error: --url + --token (or EML_API_URL + EML_API_TOKEN) are required.\n\n');
+        printHelpAndExit(1);
+    }
+    try {
+        await (0, server_1.startMcpServer)({ url, token, clientName });
+        process.stderr.write(`[eml-mcp-server] connected, stdio-transport ready (${clientName} → ${url})\n`);
+    }
+    catch (err) {
+        const e = err;
+        process.stderr.write(`[eml-mcp-server] startup failed: ${e.message}\n`);
+        process.exit(1);
+    }
+}
+main();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/http-client.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Thin fetch wrapper for the EML HTTP API (v0.9-PROPOSAL §6.2).
+ *
+ * Deliberately lives without an `@engramprotocol/core` dependency — the MCP
+ * server ships as a small npm package (`@engramprotocol/mcp-server`) that
+ * only needs the SDK + zod + this file.
+ *
+ * Error handling: all failures throw `EmlApiError`. Tools catch it in the
+ * handler and map to an `isError: true` result (see v0.9-PROPOSAL §6.4
+ * "Error handling — two channels").
+ */
+export interface HttpClientOptions {
+    url: string;
+    token: string;
+    timeoutMs?: number;
+}
+export declare class EmlApiError extends Error {
+    status: number;
+    body: unknown;
+    constructor(status: number, body: unknown, message: string);
+}
+export declare class HttpClient {
+    private readonly baseUrl;
+    private readonly headers;
+    private readonly timeoutMs;
+    constructor(opts: HttpClientOptions);
+    get(path: string, query?: Record<string, string | number | undefined>): Promise<unknown>;
+    post(path: string, body?: unknown): Promise<unknown>;
+    put(path: string, body?: unknown): Promise<unknown>;
+    private buildPath;
+    private request;
+}
+//# sourceMappingURL=http-client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"http-client.d.ts","sourceRoot":"","sources":["../src/http-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,qBAAa,WAAY,SAAQ,KAAK;IAE3B,MAAM,EAAE,MAAM;IACd,IAAI,EAAE,OAAO;gBADb,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,EACpB,OAAO,EAAE,MAAM;CAKlB;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAChD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAQ;gBAEtB,IAAI,EAAE,iBAAiB;IAS7B,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAIxF,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAIpD,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAIzD,OAAO,CAAC,SAAS;YAUH,OAAO;CA+BtB"}

package/dist/http-client.js

@@ -0,0 +1,106 @@
+"use strict";
+/**
+ * Thin fetch wrapper for the EML HTTP API (v0.9-PROPOSAL §6.2).
+ *
+ * Deliberately lives without an `@engramprotocol/core` dependency — the MCP
+ * server ships as a small npm package (`@engramprotocol/mcp-server`) that
+ * only needs the SDK + zod + this file.
+ *
+ * Error handling: all failures throw `EmlApiError`. Tools catch it in the
+ * handler and map to an `isError: true` result (see v0.9-PROPOSAL §6.4
+ * "Error handling — two channels").
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpClient = exports.EmlApiError = void 0;
+class EmlApiError extends Error {
+    status;
+    body;
+    constructor(status, body, message) {
+        super(message);
+        this.status = status;
+        this.body = body;
+        this.name = 'EmlApiError';
+    }
+}
+exports.EmlApiError = EmlApiError;
+class HttpClient {
+    baseUrl;
+    headers;
+    timeoutMs;
+    constructor(opts) {
+        this.baseUrl = opts.url.replace(/\/+$/, '');
+        this.headers = {
+            'Authorization': `Bearer ${opts.token}`,
+            'Content-Type': 'application/json',
+        };
+        this.timeoutMs = opts.timeoutMs ?? 30_000;
+    }
+    async get(path, query) {
+        return this.request('GET', this.buildPath(path, query));
+    }
+    async post(path, body) {
+        return this.request('POST', path, body);
+    }
+    async put(path, body) {
+        return this.request('PUT', path, body);
+    }
+    buildPath(path, query) {
+        if (!query)
+            return path;
+        const params = [];
+        for (const [k, v] of Object.entries(query)) {
+            if (v === undefined || v === null)
+                continue;
+            params.push(`${encodeURIComponent(k)}=${encodeURIComponent(String(v))}`);
+        }
+        return params.length ? `${path}?${params.join('&')}` : path;
+    }
+    async request(method, path, body) {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.timeoutMs);
+        try {
+            const res = await fetch(`${this.baseUrl}${path}`, {
+                method,
+                headers: this.headers,
+                body: body !== undefined ? JSON.stringify(body) : undefined,
+                signal: controller.signal,
+            });
+            const text = await res.text();
+            let parsed = null;
+            if (text) {
+                try {
+                    parsed = JSON.parse(text);
+                }
+                catch {
+                    parsed = text;
+                }
+            }
+            if (!res.ok) {
+                const msg = extractErrorMessage(parsed) ?? `HTTP ${res.status}`;
+                throw new EmlApiError(res.status, parsed, `${method} ${path} → ${res.status}: ${msg}`);
+            }
+            return parsed;
+        }
+        catch (err) {
+            if (err instanceof EmlApiError)
+                throw err;
+            const e = err;
+            if (e.name === 'AbortError') {
+                throw new EmlApiError(0, null, `${method} ${path} timed out after ${this.timeoutMs}ms`);
+            }
+            throw new EmlApiError(0, null, `${method} ${path} failed: ${e.message}`);
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+}
+exports.HttpClient = HttpClient;
+function extractErrorMessage(body) {
+    if (body && typeof body === 'object' && 'error' in body) {
+        const e = body.error;
+        return typeof e === 'string' ? e : JSON.stringify(e);
+    }
+    return null;
+}
+//# sourceMappingURL=http-client.js.map

package/dist/http-client.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,18 @@
+/**
+ * MCP server setup (v0.9-PROPOSAL §6).
+ *
+ * Single-mode HTTP client (no embedded SQLite). Self-host uses the same
+ * invocation, just with `--url http://localhost:3117`.
+ *
+ * Stdio transport: local process spawned by Claude Code's MCP config.
+ * Capabilities: tools only (static, listChanged=false). Resources/prompts
+ * are v0.9.x polish.
+ */
+export interface McpServerOptions {
+    url: string;
+    token: string;
+    clientName?: string;
+    serverVersion?: string;
+}
+export declare function startMcpServer(opts: McpServerOptions): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAKA;;;;;;;;;GASG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAY1E"}

package/dist/server.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startMcpServer = startMcpServer;
+const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const http_client_1 = require("./http-client");
+const tools_1 = require("./tools");
+async function startMcpServer(opts) {
+    const httpClient = new http_client_1.HttpClient({ url: opts.url, token: opts.token });
+    const server = new mcp_js_1.McpServer({
+        name: opts.clientName ?? 'eml-mcp-server',
+        version: opts.serverVersion ?? '0.9.0',
+    });
+    (0, tools_1.registerAllTools)(server, httpClient);
+    const transport = new stdio_js_1.StdioServerTransport();
+    await server.connect(transport);
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":";;AAuBA,wCAYC;AAnCD,oEAAmE;AACnE,wEAAgF;AAChF,+CAA0C;AAC1C,mCAA0C;AAoBnC,KAAK,UAAU,cAAc,CAAC,IAAsB;IACzD,MAAM,UAAU,GAAG,IAAI,wBAAU,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAA;IAEvE,MAAM,MAAM,GAAG,IAAI,kBAAS,CAAC;QAC3B,IAAI,EAAE,IAAI,CAAC,UAAU,IAAI,gBAAgB;QACzC,OAAO,EAAE,IAAI,CAAC,aAAa,IAAI,OAAO;KACvC,CAAC,CAAA;IAEF,IAAA,wBAAgB,EAAC,MAAM,EAAE,UAAU,CAAC,CAAA;IAEpC,MAAM,SAAS,GAAG,IAAI,+BAAoB,EAAE,CAAA;IAC5C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;AACjC,CAAC"}

package/dist/setup/_helpers.d.ts

@@ -0,0 +1,71 @@
+export declare const HOME_DIR: string;
+export declare const EML_DIR: string;
+export declare const EML_CONFIG: string;
+export declare const EML_HOOKS_DIR: string;
+export declare const CLAUDE_DIR: string;
+export declare const CLAUDE_JSON: string;
+export declare const CLAUDE_SETTINGS: string;
+export declare const MANAGED_BY_MARKER = "engramprotocol-setup";
+export declare const MCP_SERVER_NAME = "engramprotocol";
+/** Resolve the package's own root (where templates/ lives). Works from dist/. */
+export declare function pkgRoot(): string;
+export declare function pkgVersion(): string;
+export declare function templatesDir(): string;
+export declare function promptText(question: string): Promise<string>;
+export declare function promptConfirm(question: string, defaultYes?: boolean): Promise<boolean>;
+export interface EmlConfig {
+    EML_URL?: string;
+    EML_API_TOKEN?: string;
+    EML_CLIENT_VERSION?: string;
+}
+export declare function readConfig(): EmlConfig | null;
+export declare function writeConfig(cfg: EmlConfig): void;
+export type SettingsJson = Record<string, any>;
+export declare function readSettings(): SettingsJson;
+export declare function backupSettings(): string;
+export declare function writeSettings(settings: SettingsJson): void;
+/** Add a permission entry to settings.permissions.allow if not already present. */
+export declare function mergePermission(settings: SettingsJson, entry: string): boolean;
+/** Remove permission entries matching the predicate. Returns count removed. */
+export declare function removePermissions(settings: SettingsJson, predicate: (entry: string) => boolean): number;
+export interface HookEntry {
+    hooks: Array<{
+        type: string;
+        command: string;
+    }>;
+    matcher?: string;
+}
+/** Add a command-hook to settings.hooks.<event>[] if no existing entry references the same command. */
+export declare function mergeHookCommand(settings: SettingsJson, event: string, command: string): boolean;
+/** Remove hook entries whose command starts with the given prefix (e.g. `$HOME/.eml/hooks/`). Returns count removed. */
+export declare function removeHooksByCommandPrefix(settings: SettingsJson, prefix: string): number;
+export declare function claudeCli(args: string[]): {
+    stdout: string;
+    stderr: string;
+    status: number;
+};
+export declare function claudeCliExists(): boolean;
+/** Unauthenticated reachability check — "is the server alive?". */
+export declare function verifyHealth(url: string): Promise<{
+    ok: boolean;
+    status?: number;
+    error?: string;
+}>;
+/** Authenticated round-trip — "does this token work?". Uses GET /stats (lightweight, auth-required). */
+export declare function verifyToken(url: string, token: string): Promise<{
+    ok: boolean;
+    status?: number;
+    error?: string;
+}>;
+export interface HookTemplate {
+    filename: string;
+    event: string;
+}
+export declare const HOOK_TEMPLATES: HookTemplate[];
+export declare function readTemplate(filename: string): string;
+export declare function hasMarker(content: string): boolean;
+export declare function installTemplate(filename: string): {
+    installedPath: string;
+    alreadyExisted: boolean;
+};
+//# sourceMappingURL=_helpers.d.ts.map

package/dist/setup/_helpers.d.ts.map

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