@synth-coder/memhub 0.1.0

package/dist/src/contracts/mcp.js

@@ -0,0 +1,112 @@
+/**
+ * MCP (Model Context Protocol) specific types and constants
+ * Defines the protocol structures for stdio-based communication
+ */
+// ============================================================================
+// MCP Protocol Version
+// ============================================================================
+/** Current MCP protocol version */
+export const MCP_PROTOCOL_VERSION = '2024-11-05';
+/** Server information */
+export const SERVER_INFO = {
+    name: 'memhub',
+    version: '0.1.0',
+};
+// ============================================================================
+// MCP Tool List
+// ============================================================================
+/** All available tool names */
+export const TOOL_NAMES = ['memory_load', 'memory_update'];
+/** Tool definitions for MCP server */
+export const TOOL_DEFINITIONS = [
+    {
+        name: 'memory_load',
+        description: 'STM first step. Call at the first turn after receiving user prompt to load short-term memory context for this session/task.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'string', description: 'Optional memory id for direct fetch' },
+                sessionId: {
+                    type: 'string',
+                    description: 'Optional session UUID to load current CLI/task context',
+                },
+                date: { type: 'string', description: 'Optional date filter (YYYY-MM-DD)' },
+                query: { type: 'string', description: 'Optional text query for relevant context' },
+                category: { type: 'string' },
+                tags: { type: 'array', items: { type: 'string' } },
+                limit: { type: 'number', description: 'Max results, default 20' },
+                scope: {
+                    type: 'string',
+                    enum: ['stm', 'all'],
+                    description: 'stm for short-term context window; all for broader retrieval',
+                },
+            },
+            additionalProperties: false,
+        },
+    },
+    {
+        name: 'memory_update',
+        description: 'STM write-back step. Call at the final turn to append/upsert new decisions, preferences, task-state changes, and key outputs.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'string', description: 'Optional id. Present = update existing record' },
+                sessionId: { type: 'string', description: 'Session UUID. Auto-created if omitted' },
+                mode: { type: 'string', enum: ['append', 'upsert'], description: 'Default append' },
+                entryType: {
+                    type: 'string',
+                    enum: ['decision', 'preference', 'knowledge', 'todo', 'state_change'],
+                },
+                title: { type: 'string', description: 'Optional title' },
+                content: { type: 'string', description: 'Required memory body' },
+                tags: { type: 'array', items: { type: 'string' } },
+                category: { type: 'string' },
+                importance: { type: 'number' },
+            },
+            required: ['content'],
+            additionalProperties: false,
+        },
+    },
+];
+// ============================================================================
+// MCP Methods
+// ============================================================================
+/** All MCP method names */
+export const MCP_METHODS = {
+    // Lifecycle
+    INITIALIZE: 'initialize',
+    INITIALIZED: 'notifications/initialized',
+    SHUTDOWN: 'shutdown',
+    EXIT: 'exit',
+    // Tools
+    TOOLS_LIST: 'tools/list',
+    TOOLS_CALL: 'tools/call',
+    // Logging
+    LOGGING_MESSAGE: 'notifications/message',
+    // Progress
+    PROGRESS: 'notifications/progress',
+};
+// ============================================================================
+// Error Codes (Standard MCP + Custom)
+// ============================================================================
+/** Standard JSON-RPC error codes */
+export const JSONRPC_ERROR_CODES = {
+    PARSE_ERROR: -32700,
+    INVALID_REQUEST: -32600,
+    METHOD_NOT_FOUND: -32601,
+    INVALID_PARAMS: -32602,
+    INTERNAL_ERROR: -32603,
+};
+/** MemHub custom error codes */
+export const MEMHUB_ERROR_CODES = {
+    NOT_FOUND: -32001,
+    STORAGE_ERROR: -32002,
+    VALIDATION_ERROR: -32003,
+    DUPLICATE_ERROR: -32004,
+};
+/** Combined error codes */
+export const ERROR_CODES = {
+    ...JSONRPC_ERROR_CODES,
+    ...MEMHUB_ERROR_CODES,
+};
+//# sourceMappingURL=mcp.js.map

package/dist/src/contracts/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../../src/contracts/mcp.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,+EAA+E;AAC/E,uBAAuB;AACvB,+EAA+E;AAE/E,mCAAmC;AACnC,MAAM,CAAC,MAAM,oBAAoB,GAAG,YAAY,CAAC;AAEjD,yBAAyB;AACzB,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,IAAI,EAAE,QAAQ;IACd,OAAO,EAAE,OAAO;CACR,CAAC;AAgIX,+EAA+E;AAC/E,gBAAgB;AAChB,+EAA+E;AAE/E,+BAA+B;AAC/B,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,aAAa,EAAE,eAAe,CAAU,CAAC;AAKpE,sCAAsC;AACtC,MAAM,CAAC,MAAM,gBAAgB,GAAoB;IAC/C;QACE,IAAI,EAAE,aAAa;QACnB,WAAW,EACT,6HAA6H;QAC/H,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,qCAAqC,EAAE;gBAC1E,SAAS,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,wDAAwD;iBACtE;gBACD,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mCAAmC,EAAE;gBAC1E,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0CAA0C,EAAE;gBAClF,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBAC5B,IAAI,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;gBAClD,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yBAAyB,EAAE;gBACjE,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC;oBACpB,WAAW,EAAE,8DAA8D;iBAC5E;aACF;YACD,oBAAoB,EAAE,KAAK;SAC5B;KACF;IACD;QACE,IAAI,EAAE,eAAe;QACrB,WAAW,EACT,+HAA+H;QACjI,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,+CAA+C,EAAE;gBACpF,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uCAAuC,EAAE;gBACnF,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,WAAW,EAAE,gBAAgB,EAAE;gBACnF,SAAS,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,EAAE,cAAc,CAAC;iBACtE;gBACD,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gBAAgB,EAAE;gBACxD,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,sBAAsB,EAAE;gBAChE,IAAI,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;gBAClD,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBAC5B,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;aAC/B;YACD,QAAQ,EAAE,CAAC,SAAS,CAAC;YACrB,oBAAoB,EAAE,KAAK;SAC5B;KACF;CACO,CAAC;AAEX,+EAA+E;AAC/E,cAAc;AACd,+EAA+E;AAE/E,2BAA2B;AAC3B,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,YAAY;IACZ,UAAU,EAAE,YAAY;IACxB,WAAW,EAAE,2BAA2B;IACxC,QAAQ,EAAE,UAAU;IACpB,IAAI,EAAE,MAAM;IAEZ,QAAQ;IACR,UAAU,EAAE,YAAY;IACxB,UAAU,EAAE,YAAY;IAExB,UAAU;IACV,eAAe,EAAE,uBAAuB;IAExC,WAAW;IACX,QAAQ,EAAE,wBAAwB;CAC1B,CAAC;AAEX,+EAA+E;AAC/E,sCAAsC;AACtC,+EAA+E;AAE/E,oCAAoC;AACpC,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,WAAW,EAAE,CAAC,KAAK;IACnB,eAAe,EAAE,CAAC,KAAK;IACvB,gBAAgB,EAAE,CAAC,KAAK;IACxB,cAAc,EAAE,CAAC,KAAK;IACtB,cAAc,EAAE,CAAC,KAAK;CACd,CAAC;AAEX,gCAAgC;AAChC,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,SAAS,EAAE,CAAC,KAAK;IACjB,aAAa,EAAE,CAAC,KAAK;IACrB,gBAAgB,EAAE,CAAC,KAAK;IACxB,eAAe,EAAE,CAAC,KAAK;CACf,CAAC;AAEX,2BAA2B;AAC3B,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,GAAG,mBAAmB;IACtB,GAAG,kBAAkB;CACb,CAAC"}