@synth-coder/memhub 0.1.0

package/dist/src/server/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Server exports
+ */
+export * from './mcp-server.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/server/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/server/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,iBAAiB,CAAC"}

package/dist/src/server/index.js

@@ -0,0 +1,5 @@
+/**
+ * Server exports
+ */
+export * from './mcp-server.js';
+//# sourceMappingURL=index.js.map

package/dist/src/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/server/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,iBAAiB,CAAC"}

package/dist/src/server/mcp-server.d.ts

@@ -0,0 +1,80 @@
+/**
+ * MCP Server - Model Context Protocol server implementation
+ * Communicates via stdio
+ */
+/**
+ * MCP Server implementation
+ */
+export declare class McpServer {
+    private readonly memoryService;
+    constructor();
+    /**
+     * Starts the MCP server and begins listening for requests on stdin
+     */
+    start(): void;
+    /**
+     * Handles an incoming JSON-RPC message
+     *
+     * @param message - The JSON-RPC message string
+     */
+    private handleMessage;
+    /**
+     * Handles a specific method call
+     *
+     * @param method - The method name
+     * @param params - The method parameters
+     * @returns The method result
+     */
+    private handleMethod;
+    /**
+     * Handles the initialize method
+     *
+     * @param params - Initialize parameters
+     * @returns Initialize result
+     */
+    private handleInitialize;
+    /**
+     * Handles tool calls
+     *
+     * @param request - Tool call request
+     * @returns Tool call result
+     */
+    private handleToolCall;
+    /**
+     * Handles errors and sends appropriate error response
+     *
+     * @param id - Request ID
+     * @param error - The error that occurred
+     */
+    private handleError;
+    /**
+     * Sends a JSON-RPC response
+     *
+     * @param id - Request ID
+     * @param result - Response result
+     */
+    private sendResponse;
+    /**
+     * Sends a JSON-RPC error
+     *
+     * @param id - Request ID
+     * @param code - Error code
+     * @param message - Error message
+     * @param data - Additional error data
+     */
+    private sendError;
+    /**
+     * Sends a message to stdout
+     *
+     * @param message - The message to send
+     */
+    private sendMessage;
+    /**
+     * Logs a message
+     *
+     * @param level - Log level
+     * @param message - Log message
+     */
+    private log;
+}
+//# sourceMappingURL=mcp-server.d.ts.map

package/dist/src/server/mcp-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../../../src/server/mcp-server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAyCH;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;;IAO9C;;OAEG;IACH,KAAK,IAAI,IAAI;IAqCb;;;;OAIG;YACW,aAAa;IAgC3B;;;;;;OAMG;YACW,YAAY;IAkC1B;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB;IAgBxB;;;;;OAKG;YACW,cAAc;IAoD5B;;;;;OAKG;IACH,OAAO,CAAC,WAAW;IAkBnB;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IASpB;;;;;;;OAOG;IACH,OAAO,CAAC,SAAS;IAqBjB;;;;OAIG;IACH,OAAO,CAAC,WAAW;IAKnB;;;;;OAKG;IACH,OAAO,CAAC,GAAG;CAQZ"}

package/dist/src/server/mcp-server.js

@@ -0,0 +1,263 @@
+/**
+ * MCP Server - Model Context Protocol server implementation
+ * Communicates via stdio
+ */
+import { readFileSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { MCP_PROTOCOL_VERSION, SERVER_INFO, TOOL_DEFINITIONS, MCP_METHODS, ERROR_CODES, } from '../contracts/mcp.js';
+import { ErrorCode } from '../contracts/types.js';
+import { MemoryService, ServiceError } from '../services/memory-service.js';
+import { MemoryLoadInputSchema, MemoryUpdateInputV2Schema, } from '../contracts/schemas.js';
+// Get package version
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const packageJson = JSON.parse(readFileSync(join(__dirname, '../../package.json'), 'utf-8'));
+/**
+ * MCP Server implementation
+ */
+export class McpServer {
+    memoryService;
+    constructor() {
+        const storagePath = process.env.MEMHUB_STORAGE_PATH || './memories';
+        this.memoryService = new MemoryService({ storagePath });
+    }
+    /**
+     * Starts the MCP server and begins listening for requests on stdin
+     */
+    start() {
+        this.log('info', 'MemHub MCP Server starting...');
+        process.stdin.setEncoding('utf-8');
+        let buffer = '';
+        process.stdin.on('data', (chunk) => {
+            buffer += chunk;
+            // Process complete lines (JSON-RPC messages)
+            const lines = buffer.split('\n');
+            buffer = lines.pop() || ''; // Keep incomplete line in buffer
+            for (const line of lines) {
+                if (line.trim()) {
+                    void this.handleMessage(line.trim());
+                }
+            }
+        });
+        process.stdin.on('end', () => {
+            this.log('info', 'Stdin closed, shutting down...');
+            process.exit(0);
+        });
+        process.on('SIGINT', () => {
+            this.log('info', 'Received SIGINT, shutting down...');
+            process.exit(0);
+        });
+        process.on('SIGTERM', () => {
+            this.log('info', 'Received SIGTERM, shutting down...');
+            process.exit(0);
+        });
+    }
+    /**
+     * Handles an incoming JSON-RPC message
+     *
+     * @param message - The JSON-RPC message string
+     */
+    async handleMessage(message) {
+        let request = null;
+        try {
+            request = JSON.parse(message);
+        }
+        catch {
+            this.sendError(null, ERROR_CODES.PARSE_ERROR, 'Parse error: Invalid JSON');
+            return;
+        }
+        // Validate JSON-RPC request
+        if (request.jsonrpc !== '2.0' || !request.method) {
+            this.sendError(request.id ?? null, ERROR_CODES.INVALID_REQUEST, 'Invalid Request');
+            return;
+        }
+        try {
+            const result = await this.handleMethod(request.method, request.params);
+            // Send response (only for requests with id, not notifications)
+            if (request.id !== undefined) {
+                this.sendResponse(request.id, result);
+            }
+        }
+        catch (error) {
+            this.handleError(request.id ?? null, error);
+        }
+    }
+    /**
+     * Handles a specific method call
+     *
+     * @param method - The method name
+     * @param params - The method parameters
+     * @returns The method result
+     */
+    async handleMethod(method, params) {
+        switch (method) {
+            case MCP_METHODS.INITIALIZE:
+                return this.handleInitialize(params);
+            case MCP_METHODS.INITIALIZED:
+                // Notification, no response needed
+                this.log('info', 'Client initialized');
+                return null;
+            case MCP_METHODS.SHUTDOWN:
+                return null;
+            case MCP_METHODS.EXIT:
+                process.exit(0);
+                return null;
+            case MCP_METHODS.TOOLS_LIST:
+                return { tools: TOOL_DEFINITIONS };
+            case MCP_METHODS.TOOLS_CALL:
+                return this.handleToolCall(params);
+            default:
+                throw new ServiceError(`Method not found: ${method}`, ErrorCode.METHOD_NOT_FOUND);
+        }
+    }
+    /**
+     * Handles the initialize method
+     *
+     * @param params - Initialize parameters
+     * @returns Initialize result
+     */
+    handleInitialize(params) {
+        this.log('info', `Client initializing: ${params.clientInfo.name} v${params.clientInfo.version}`);
+        return {
+            protocolVersion: MCP_PROTOCOL_VERSION,
+            capabilities: {
+                tools: { listChanged: false },
+                logging: {},
+            },
+            serverInfo: {
+                name: SERVER_INFO.name,
+                version: packageJson.version || SERVER_INFO.version,
+            },
+        };
+    }
+    /**
+     * Handles tool calls
+     *
+     * @param request - Tool call request
+     * @returns Tool call result
+     */
+    async handleToolCall(request) {
+        const { name, arguments: args } = request;
+        try {
+            let result;
+            switch (name) {
+                case 'memory_load': {
+                    const input = MemoryLoadInputSchema.parse(args ?? {});
+                    result = await this.memoryService.memoryLoad(input);
+                    break;
+                }
+                case 'memory_update': {
+                    const input = MemoryUpdateInputV2Schema.parse(args ?? {});
+                    result = await this.memoryService.memoryUpdate(input);
+                    break;
+                }
+                default:
+                    throw new ServiceError(`Unknown tool: ${name}`, ErrorCode.METHOD_NOT_FOUND);
+            }
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(result, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            if (error instanceof ServiceError) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({ error: error.message }, null, 2),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            // Re-throw for generic error handling
+            throw error;
+        }
+    }
+    /**
+     * Handles errors and sends appropriate error response
+     *
+     * @param id - Request ID
+     * @param error - The error that occurred
+     */
+    handleError(id, error) {
+        if (error instanceof ServiceError) {
+            this.sendError(id, error.code, error.message, error.data);
+        }
+        else if (error instanceof Error && error.name === 'ZodError') {
+            this.sendError(id, ERROR_CODES.INVALID_PARAMS, `Invalid parameters: ${error.message}`);
+        }
+        else {
+            this.sendError(id, ERROR_CODES.INTERNAL_ERROR, `Internal error: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    /**
+     * Sends a JSON-RPC response
+     *
+     * @param id - Request ID
+     * @param result - Response result
+     */
+    sendResponse(id, result) {
+        const response = {
+            jsonrpc: '2.0',
+            id,
+            result,
+        };
+        this.sendMessage(response);
+    }
+    /**
+     * Sends a JSON-RPC error
+     *
+     * @param id - Request ID
+     * @param code - Error code
+     * @param message - Error message
+     * @param data - Additional error data
+     */
+    sendError(id, code, message, data) {
+        const error = {
+            code,
+            message,
+            data,
+        };
+        const response = {
+            jsonrpc: '2.0',
+            id: id ?? null,
+            error,
+        };
+        this.sendMessage(response);
+    }
+    /**
+     * Sends a message to stdout
+     *
+     * @param message - The message to send
+     */
+    sendMessage(message) {
+        const json = JSON.stringify(message);
+        process.stdout.write(json + '\n');
+    }
+    /**
+     * Logs a message
+     *
+     * @param level - Log level
+     * @param message - Log message
+     */
+    log(level, message) {
+        const logLevel = process.env.MEMHUB_LOG_LEVEL || 'info';
+        const levels = { debug: 0, info: 1, warn: 2, error: 3 };
+        if (levels[level] >= levels[logLevel]) {
+            console.error(`[${level.toUpperCase()}] ${message}`);
+        }
+    }
+}
+// Start server if this file is run directly
+if (import.meta.url === `file://${process.argv[1]}`) {
+    const server = new McpServer();
+    server.start();
+}
+//# sourceMappingURL=mcp-server.js.map

package/dist/src/server/mcp-server.js.map

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

package/dist/src/services/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Services exports
+ */
+export * from './memory-service.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/services/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,qBAAqB,CAAC"}

package/dist/src/services/index.js

@@ -0,0 +1,5 @@
+/**
+ * Services exports
+ */
+export * from './memory-service.js';
+//# sourceMappingURL=index.js.map

package/dist/src/services/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/services/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,qBAAqB,CAAC"}

package/dist/src/services/memory-service.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Memory Service - Business logic for memory operations
+ */
+import type { Memory, CreateMemoryInput, ReadMemoryInput, UpdateMemoryInput, DeleteMemoryInput, ListMemoryInput, SearchMemoryInput, CreateResult, UpdateResult, DeleteResult, ListResult, SearchResult, GetCategoriesOutput, GetTagsOutput, MemoryLoadInput, MemoryUpdateInput, MemoryLoadOutput, MemoryUpdateOutput } from '../contracts/types.js';
+import { ErrorCode } from '../contracts/types.js';
+/**
+ * Custom error for service operations
+ */
+export declare class ServiceError extends Error {
+    readonly code: ErrorCode;
+    readonly data?: Record<string, unknown> | undefined;
+    constructor(message: string, code: ErrorCode, data?: Record<string, unknown> | undefined);
+}
+/**
+ * Memory service configuration
+ */
+export interface MemoryServiceConfig {
+    storagePath: string;
+}
+/**
+ * Memory service implementation
+ */
+export declare class MemoryService {
+    private readonly storage;
+    constructor(config: MemoryServiceConfig);
+    /**
+     * Creates a new memory entry
+     *
+     * @param input - Create memory input
+     * @returns Create result with ID, file path, and memory object
+     * @throws ServiceError if creation fails
+     */
+    create(input: CreateMemoryInput): Promise<CreateResult>;
+    /**
+     * Reads a memory by ID
+     *
+     * @param input - Read memory input
+     * @returns Memory object
+     * @throws ServiceError if memory not found
+     */
+    read(input: ReadMemoryInput): Promise<{
+        memory: Memory;
+    }>;
+    /**
+     * Updates an existing memory
+     *
+     * @param input - Update memory input
+     * @returns Updated memory object
+     * @throws ServiceError if memory not found
+     */
+    update(input: UpdateMemoryInput): Promise<UpdateResult>;
+    /**
+     * Deletes a memory by ID
+     *
+     * @param input - Delete memory input
+     * @returns Delete result
+     * @throws ServiceError if memory not found
+     */
+    delete(input: DeleteMemoryInput): Promise<DeleteResult>;
+    /**
+     * Lists memories with filtering and pagination
+     *
+     * @param input - List memory input
+     * @returns List result with memories, total count, and hasMore flag
+     */
+    list(input: ListMemoryInput): Promise<ListResult>;
+    /**
+     * Searches memories by query
+     *
+     * @param input - Search memory input
+     * @returns Search results with scores and matches
+     */
+    search(input: SearchMemoryInput): Promise<{
+        results: SearchResult[];
+        total: number;
+    }>;
+    /**
+     * memory_load unified read API (STM-first)
+     */
+    memoryLoad(input: MemoryLoadInput): Promise<MemoryLoadOutput>;
+    /**
+     * memory_update unified write API (append/upsert)
+     */
+    memoryUpdate(input: MemoryUpdateInput): Promise<MemoryUpdateOutput>;
+    /**
+     * Gets all unique categories
+     *
+     * @returns Array of category names
+     */
+    getCategories(): Promise<GetCategoriesOutput>;
+    /**
+     * Gets all unique tags
+     *
+     * @returns Array of tag names
+     */
+    getTags(): Promise<GetTagsOutput>;
+    /**
+     * Extracts ID from file content
+     *
+     * @param content - File content
+     * @returns ID string
+     */
+    private extractIdFromContent;
+}
+//# sourceMappingURL=memory-service.d.ts.map

package/dist/src/services/memory-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-service.d.ts","sourceRoot":"","sources":["../../../src/services/memory-service.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EACV,MAAM,EACN,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,mBAAmB,EACnB,aAAa,EAGb,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EACnB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAGlD;;GAEG;AACH,qBAAa,YAAa,SAAQ,KAAK;aAGnB,IAAI,EAAE,SAAS;aACf,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBAF9C,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,SAAS,EACf,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA;CAKjD;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;gBAE9B,MAAM,EAAE,mBAAmB;IAIvC;;;;;;OAMG;IACG,MAAM,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC;IA8B7D;;;;;;OAMG;IACG,IAAI,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAe/D;;;;;;OAMG;IACG,MAAM,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC;IAqC7D;;;;;;OAMG;IACG,MAAM,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC;IAkB7D;;;;;OAKG;IACG,IAAI,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC;IAiFvD;;;;;OAKG;IACG,MAAM,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,YAAY,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAgG3F;;OAEG;IACG,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA0CnE;;OAEG;IACG,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAwDzE;;;;OAIG;IACG,aAAa,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAoBnD;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,aAAa,CAAC;IAsBvC;;;;;OAKG;IACH,OAAO,CAAC,oBAAoB;CAO7B"}