@scitrera/memorylayer-mcp-server 0.0.3 → 0.0.4

package/dist/src/server.js

@@ -0,0 +1,249 @@
+/**
+ * MCP server implementation for MemoryLayer.ai
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
+import { readFileSync, writeFileSync, mkdirSync, existsSync, renameSync } from "fs";
+import { join, dirname } from "path";
+import { fileURLToPath } from "node:url";
+import { tmpdir } from "os";
+// ESM-compatible version reading (require() is not available in ESM)
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const PACKAGE_VERSION = JSON.parse(readFileSync(join(__dirname, "..", "..", "package.json"), "utf-8")).version;
+import { MCPToolHandlers } from "./handlers.js";
+import { DEFAULT_PROFILE, getToolsForProfile, isToolEnabled, } from "./tools.js";
+import { SessionManager } from "./session.js";
+/**
+ * Format an error for display, handling various error types.
+ * Prevents "[object Object]" from appearing in error messages.
+ */
+function formatError(error) {
+    // Standard Error object - check for details (e.g., MemoryLayerError from SDK)
+    if (error instanceof Error) {
+        const errWithDetails = error;
+        if (errWithDetails.details) {
+            const details = typeof errWithDetails.details === 'string'
+                ? errWithDetails.details
+                : JSON.stringify(errWithDetails.details);
+            return `${error.message}: ${details}`;
+        }
+        return error.message;
+    }
+    // String error
+    if (typeof error === 'string') {
+        return error;
+    }
+    // Object with common error properties
+    if (error && typeof error === 'object') {
+        const errorObj = error;
+        // Check for common error message properties
+        if (typeof errorObj.message === 'string') {
+            return errorObj.message;
+        }
+        if (typeof errorObj.error === 'string') {
+            return errorObj.error;
+        }
+        if (typeof errorObj.detail === 'string') {
+            return errorObj.detail;
+        }
+        // API error response with nested error object
+        if (errorObj.error && typeof errorObj.error === 'object') {
+            const nestedError = errorObj.error;
+            if (typeof nestedError.message === 'string') {
+                return nestedError.message;
+            }
+            if (typeof nestedError.detail === 'string') {
+                return nestedError.detail;
+            }
+        }
+        // Fallback: stringify the object
+        try {
+            return JSON.stringify(error);
+        }
+        catch {
+            return 'Unknown error (could not serialize)';
+        }
+    }
+    // Fallback for other types
+    return String(error);
+}
+export class MCPServer {
+    server;
+    handlers;
+    sessionManager;
+    toolProfile;
+    autoStartSession;
+    constructor(client, options = {}) {
+        // Determine tool profile (env var > option > legacy options > default)
+        const envProfile = process.env.MEMORYLAYER_TOOL_PROFILE;
+        if (envProfile && !["cc", "full", "minimal"].includes(envProfile)) {
+            console.error(`Invalid MEMORYLAYER_TOOL_PROFILE: "${envProfile}", using default "${DEFAULT_PROFILE}"`);
+        }
+        const validEnvProfile = envProfile && ["cc", "full", "minimal"].includes(envProfile) ? envProfile : undefined;
+        // Handle legacy options for backwards compatibility
+        let legacyProfile;
+        if (options.extendedTools === true) {
+            console.error("Warning: extendedTools option is deprecated, use toolProfile: 'full' instead");
+            legacyProfile = "full";
+        }
+        this.toolProfile = validEnvProfile ?? options.toolProfile ?? legacyProfile ?? DEFAULT_PROFILE;
+        // Session mode is always enabled (session tools controlled by profile)
+        const sessionModeEnabled = true;
+        // Auto-start session: enabled by default
+        // Can be disabled via env var MEMORYLAYER_AUTO_START_SESSION=false
+        const envAutoStart = process.env.MEMORYLAYER_AUTO_START_SESSION;
+        const envAutoStartDisabled = envAutoStart?.toLowerCase() === 'false' || envAutoStart === '0';
+        this.autoStartSession = options.autoStartSession ?? !envAutoStartDisabled;
+        this.sessionManager = new SessionManager({ enabled: sessionModeEnabled });
+        this.server = new Server({
+            name: "memorylayer",
+            version: PACKAGE_VERSION,
+        }, {
+            capabilities: {
+                tools: {}
+            }
+        });
+        this.handlers = new MCPToolHandlers(client, this.sessionManager);
+        this.setupHandlers();
+        console.error(`MemoryLayer MCP server initialized with profile: "${this.toolProfile}"`);
+    }
+    setupHandlers() {
+        // List tools based on the configured profile
+        this.server.setRequestHandler(ListToolsRequestSchema, async () => {
+            const profileTools = getToolsForProfile(this.toolProfile);
+            const tools = profileTools.map(toolDef => ({
+                name: toolDef.name,
+                description: toolDef.description,
+                inputSchema: toolDef.inputSchema
+            }));
+            return { tools };
+        });
+        // Handle tool invocations
+        this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
+            const { name, arguments: args } = request.params;
+            try {
+                // Check if tool is enabled for current profile
+                if (!isToolEnabled(name, this.toolProfile)) {
+                    const errorMsg = `Tool "${name}" is not available in profile "${this.toolProfile}". Use MEMORYLAYER_TOOL_PROFILE=full to enable all tools.`;
+                    console.error(errorMsg);
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: JSON.stringify({ error: errorMsg, profile: this.toolProfile })
+                            }
+                        ],
+                        isError: true
+                    };
+                }
+                // Route to appropriate handler
+                const handlerMethodName = name.replace(/_([a-z])/g, (_, letter) => letter.toUpperCase());
+                const handlerMethod = `handle${handlerMethodName.charAt(0).toUpperCase()}${handlerMethodName.slice(1)}`;
+                if (!(handlerMethod in this.handlers)) {
+                    const errorMsg = `Unknown tool: ${name}`;
+                    console.error(errorMsg);
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: JSON.stringify({ error: errorMsg })
+                            }
+                        ]
+                    };
+                }
+                // Call the handler
+                const handler = this.handlers[handlerMethod];
+                const result = await handler.call(this.handlers, args || {});
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: result
+                        }
+                    ]
+                };
+            }
+            catch (error) {
+                const errorMsg = formatError(error);
+                console.error(`Tool execution failed for ${name}:`, errorMsg);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({
+                                success: false,
+                                error: errorMsg
+                            }, null, 2)
+                        }
+                    ],
+                    isError: true
+                };
+            }
+        });
+    }
+    async run() {
+        console.error("Starting MemoryLayer MCP server on stdio transport");
+        const transport = new StdioServerTransport();
+        await this.server.connect(transport);
+        console.error("MCP server running");
+        // Auto-start session if enabled
+        if (this.autoStartSession) {
+            try {
+                const result = await this.handlers.handleMemorySessionStart({});
+                console.error("Session auto-started:", result);
+                // Write session handoff file for hook to adopt
+                const session = this.sessionManager.currentSession;
+                if (session?.serverSessionId) {
+                    this.writeSessionHandoff(session.serverSessionId, session.workspaceId);
+                }
+            }
+            catch (error) {
+                console.error("Failed to auto-start session:", error instanceof Error ? error.message : error);
+            }
+        }
+    }
+    /**
+     * Write session handoff file for hook to adopt the MCP-created session
+     */
+    writeSessionHandoff(sessionId, workspaceId) {
+        try {
+            const handoffDir = join(tmpdir(), "memorylayer");
+            const handoffFile = join(handoffDir, `session-${process.ppid}.json`);
+            if (!existsSync(handoffDir)) {
+                mkdirSync(handoffDir, { recursive: true });
+            }
+            const handoff = {
+                sessionId,
+                workspaceId,
+                pid: process.pid,
+                createdAt: new Date().toISOString()
+            };
+            // Write atomically: tmp file then rename
+            const tmpFile = handoffFile + ".tmp";
+            writeFileSync(tmpFile, JSON.stringify(handoff));
+            renameSync(tmpFile, handoffFile);
+            console.error(`Session handoff written: ${handoffFile}`);
+        }
+        catch (error) {
+            console.error("Failed to write session handoff:", error instanceof Error ? error.message : error);
+        }
+    }
+    getManifest() {
+        const profileTools = getToolsForProfile(this.toolProfile);
+        return {
+            name: "memorylayer",
+            version: PACKAGE_VERSION,
+            description: "MemoryLayer.ai - Memory infrastructure for LLM-powered agents",
+            homepage: "https://memorylayer.ai",
+            toolProfile: this.toolProfile,
+            capabilities: {
+                tools: profileTools.map(t => t.name)
+            }
+        };
+    }
+}
+export async function createServer(client, options = {}) {
+    return new MCPServer(client, options);
+}
+//# sourceMappingURL=server.js.map

package/dist/src/server.js.map

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

package/dist/src/session.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Session state management for MCP server.
+ *
+ * Each MCP server instance (spawned per Claude Code window) maintains
+ * a single session. This provides working memory that persists across
+ * tool calls within a Claude Code session.
+ */
+export interface WorkingMemoryEntry {
+    key: string;
+    value: unknown;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export interface SessionState {
+    id: string;
+    workspaceId: string;
+    createdAt: Date;
+    workingMemory: Map<string, WorkingMemoryEntry>;
+    /** Whether this session has been committed to long-term storage */
+    committed: boolean;
+    /** Server-side session ID (from MemoryLayer API) */
+    serverSessionId?: string;
+}
+export interface SessionConfig {
+    /** Enable session tracking (default: true) */
+    enabled: boolean;
+    /** Auto-create session on first tool call (default: true) */
+    autoCreate: boolean;
+    /** Session TTL in seconds for server-side session (default: 3600) */
+    ttlSeconds: number;
+}
+export declare class SessionManager {
+    private session;
+    private config;
+    constructor(config?: Partial<SessionConfig>);
+    get isEnabled(): boolean;
+    get hasActiveSession(): boolean;
+    get currentSession(): SessionState | null;
+    /**
+     * Start a new session. Replaces any existing session.
+     */
+    startSession(workspaceId: string, serverSessionId?: string): SessionState;
+    /**
+     * End the current session.
+     */
+    endSession(): SessionState | null;
+    /**
+     * Mark session as committed.
+     */
+    markCommitted(): void;
+    /**
+     * Get all working memory entries.
+     */
+    getAllWorkingMemory(): WorkingMemoryEntry[];
+    /**
+     * Clear all working memory.
+     */
+    clearWorkingMemory(): void;
+    /**
+     * Get session summary for briefing.
+     */
+    getSessionSummary(): Record<string, unknown>;
+    /**
+     * Get TTL config for server-side session creation.
+     */
+    getTtlSeconds(): number;
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/src/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/session.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,IAAI,CAAC;IAChB,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAC/C,mEAAmE;IACnE,SAAS,EAAE,OAAO,CAAC;IACnB,oDAAoD;IACpD,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,8CAA8C;IAC9C,OAAO,EAAE,OAAO,CAAC;IACjB,6DAA6D;IAC7D,UAAU,EAAE,OAAO,CAAC;IACpB,qEAAqE;IACrE,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,MAAM,CAAgB;gBAElB,MAAM,GAAE,OAAO,CAAC,aAAa,CAAM;IAQ/C,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,IAAI,gBAAgB,IAAI,OAAO,CAE9B;IAED,IAAI,cAAc,IAAI,YAAY,GAAG,IAAI,CAExC;IAED;;OAEG;IACH,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,YAAY;IAgBzE;;OAEG;IACH,UAAU,IAAI,YAAY,GAAG,IAAI;IASjC;;OAEG;IACH,aAAa,IAAI,IAAI;IAMrB;;OAEG;IACH,mBAAmB,IAAI,kBAAkB,EAAE;IAO3C;;OAEG;IACH,kBAAkB,IAAI,IAAI;IAI1B;;OAEG;IACH,iBAAiB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAkB5C;;OAEG;IACH,aAAa,IAAI,MAAM;CAGxB"}

package/dist/src/session.js

@@ -0,0 +1,103 @@
+/**
+ * Session state management for MCP server.
+ *
+ * Each MCP server instance (spawned per Claude Code window) maintains
+ * a single session. This provides working memory that persists across
+ * tool calls within a Claude Code session.
+ */
+export class SessionManager {
+    session = null;
+    config;
+    constructor(config = {}) {
+        this.config = {
+            enabled: config.enabled ?? true,
+            autoCreate: config.autoCreate ?? true,
+            ttlSeconds: config.ttlSeconds ?? 3600,
+        };
+    }
+    get isEnabled() {
+        return this.config.enabled;
+    }
+    get hasActiveSession() {
+        return this.session !== null;
+    }
+    get currentSession() {
+        return this.session;
+    }
+    /**
+     * Start a new session. Replaces any existing session.
+     */
+    startSession(workspaceId, serverSessionId) {
+        const sessionId = `local_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
+        this.session = {
+            id: sessionId,
+            workspaceId,
+            createdAt: new Date(),
+            workingMemory: new Map(),
+            committed: false,
+            serverSessionId,
+        };
+        console.error(`Session started: ${sessionId} (workspace: ${workspaceId})`);
+        return this.session;
+    }
+    /**
+     * End the current session.
+     */
+    endSession() {
+        const session = this.session;
+        if (session) {
+            console.error(`Session ended: ${session.id}`);
+        }
+        this.session = null;
+        return session;
+    }
+    /**
+     * Mark session as committed.
+     */
+    markCommitted() {
+        if (this.session) {
+            this.session.committed = true;
+        }
+    }
+    /**
+     * Get all working memory entries.
+     */
+    getAllWorkingMemory() {
+        if (!this.session) {
+            return [];
+        }
+        return Array.from(this.session.workingMemory.values());
+    }
+    /**
+     * Clear all working memory.
+     */
+    clearWorkingMemory() {
+        this.session?.workingMemory.clear();
+    }
+    /**
+     * Get session summary for briefing.
+     */
+    getSessionSummary() {
+        if (!this.session) {
+            return {
+                active: false,
+            };
+        }
+        return {
+            active: true,
+            id: this.session.id,
+            workspaceId: this.session.workspaceId,
+            createdAt: this.session.createdAt.toISOString(),
+            workingMemoryCount: this.session.workingMemory.size,
+            committed: this.session.committed,
+            serverSessionId: this.session.serverSessionId,
+        };
+    }
+    /**
+     * Get TTL config for server-side session creation.
+     */
+    getTtlSeconds() {
+        return this.config.ttlSeconds;
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/src/session.js.map

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