Refactor Memory Core tools: consolidate database backup tools (Issue #8320)

Author: tobiu

.github/.sync-metadata.json

@@ -1,6 +1,6 @@
 {
-  "lastSync": "2026-01-04T17:16:54.488Z",
-  "releasesLastFetched": "2026-01-04T17:16:54.935Z",
+  "lastSync": "2026-01-04T17:50:00.414Z",
+  "releasesLastFetched": "2026-01-04T17:50:00.937Z",
   "pushFailures": [],
   "issues": {
     "3789": {
@@ -14238,8 +14238,8 @@
       "state": "OPEN",
       "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-8315.md",
       "closedAt": null,
-      "updatedAt": "2026-01-04T16:23:49Z",
-      "contentHash": "fad05cae91e25a5f6096a4a7819341ade411bdd4a912441a2ee5037a54f18be7"
+      "updatedAt": "2026-01-04T17:18:33Z",
+      "contentHash": "0aae9a79e108b73ed596d37c7619c4499b024c263d60e6ec75efa25b2f4a6ecc"
     },
     "8316": {
       "state": "CLOSED",
@@ -14263,11 +14263,18 @@
       "contentHash": "545b17314ab7a1dfc42f95ea444c16a7d4b76ba576b15b16aef6d036f03685f0"
     },
     "8319": {
-      "state": "OPEN",
+      "state": "CLOSED",
       "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-8319.md",
+      "closedAt": "2026-01-04T17:45:51Z",
+      "updatedAt": "2026-01-04T17:45:51Z",
+      "contentHash": "b0d3935311f590d87b70a95f429d715064fca94e8680e3ad14ff9d94ce0f7094"
+    },
+    "8320": {
+      "state": "OPEN",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-8320.md",
       "closedAt": null,
-      "updatedAt": "2026-01-04T16:24:21Z",
-      "contentHash": "328b4c7494c87b0e5063869d493398ec4915ac327b1778db0ee2a6d19c949db6"
+      "updatedAt": "2026-01-04T17:49:51Z",
+      "contentHash": "b6c20c34da4821f962e8036ff3103e2ae7fe43a508d6abb74ecfb5488a655bd0"
     }
   },
   "releases": {

.github/ISSUE/issue-8315.md

@@ -7,9 +7,10 @@ labels:
   - epic
   - ai
   - refactoring
-assignees: []
+assignees:
+  - tobiu
 createdAt: '2026-01-04T16:23:49Z'
-updatedAt: '2026-01-04T16:23:49Z'
+updatedAt: '2026-01-04T17:18:33Z'
 githubUrl: 'https://github.com/neomjs/neo/issues/8315'
 author: tobiu
 commentsCount: 0
@@ -18,9 +19,10 @@ subIssues:
   - '[x] 8316 MCP: Optimize Memory Core Tool Count'
   - '[x] 8317 MCP: Optimize Knowledge Base Tool Count'
   - '[x] 8318 MCP: Optimize GitHub Workflow Tool Count'
-  - '[ ] 8319 MCP: Optimize Neural Link Tool Count'
-subIssuesCompleted: 3
-subIssuesTotal: 4
+  - '[x] 8319 MCP: Optimize Neural Link Tool Count'
+  - '[ ] 8320 MCP: Optimize Memory Core Database Backup Tools'
+subIssuesCompleted: 4
+subIssuesTotal: 5
 blockedBy: []
 blocking: []
 ---
@@ -61,4 +63,7 @@ Reduce the total number of MCP tools by consolidating redundant or complementary
 - 2026-01-04 @tobiu added sub-issue #8317
 - 2026-01-04 @tobiu added sub-issue #8318
 - 2026-01-04 @tobiu added sub-issue #8319
+- 2026-01-04 @tobiu assigned to @tobiu
+- 2026-01-04 @tobiu cross-referenced by #8320
+- 2026-01-04 @tobiu added sub-issue #8320
 

.github/ISSUE/issue-8319.md

@@ -1,22 +1,24 @@
 ---
 id: 8319
 title: 'MCP: Optimize Neural Link Tool Count'
-state: OPEN
+state: CLOSED
 labels:
   - ai
   - refactoring
-assignees: []
+assignees:
+  - tobiu
 createdAt: '2026-01-04T16:24:21Z'
-updatedAt: '2026-01-04T16:24:21Z'
+updatedAt: '2026-01-04T17:45:51Z'
 githubUrl: 'https://github.com/neomjs/neo/issues/8319'
 author: tobiu
-commentsCount: 0
+commentsCount: 1
 parentIssue: 8315
 subIssues: []
 subIssuesCompleted: 0
 subIssuesTotal: 0
 blockedBy: []
 blocking: []
+closedAt: '2026-01-04T17:45:51Z'
 ---
 # MCP: Optimize Neural Link Tool Count
 
@@ -25,9 +27,31 @@ Part of Epic #8315.
 2. Consolidate `get_vdom_tree`, `get_vnode_tree`, and `get_vdom_vnode` into `inspect_component_render_tree` (type: 'vdom' | 'vnode' | 'both').
 3. Consolidate `get_neo_config` and `set_neo_config` into `manage_neo_config` (action: 'get' | 'set').
 
+## Comments
+
+### @tobiu - 2026-01-04 17:45
+
+**Input from neo-agent:**
+
+> ◆ I have completed the consolidation of Neural Link tools as requested.
+> - `manage_connection` now handles both start and stop actions.
+> - `inspect_component_render_tree` consolidates VDOM and VNode inspection.
+> - `manage_neo_config` unifies configuration management.
+> 
+> This completes the last sub-task for Epic #8315. All tool consolidation goals have been met.
+
 ## Activity Log
 
 - 2026-01-04 @tobiu added the `ai` label
 - 2026-01-04 @tobiu added the `refactoring` label
 - 2026-01-04 @tobiu added parent issue #8315
+- 2026-01-04 @tobiu assigned to @tobiu
+- 2026-01-04 @tobiu referenced in commit `9e77ead` - "Refactor Neural Link tools to reduce MCP tool count (Issue #8319)
+
+- Consolidated start/stop_ws_server into manage_connection
+
+- Consolidated get_vdom/vnode_tree into inspect_component_render_tree
+
+- Consolidated get/set_neo_config into manage_neo_config"
+- 2026-01-04 @tobiu closed this issue
 

ai/mcp/server/memory-core/openapi.yaml

@@ -394,94 +394,69 @@ paths:
               schema:
                 $ref: '#/components/schemas/ErrorResponse'
 
-  /db/export:
-    get:
-      summary: Export Database
-      operationId: export_database
-      x-pass-as-object: true
-      x-annotations:
-        readOnlyHint: true
-      description: |
-        Exports the entire memory database (both memories and summaries) to a JSONL file.
-
-        **When to Use:**
-        For creating backups or migrating memory data between environments.
-      tags: [Database]
-      parameters:
-        - name: include
-          in: query
-          required: false
-          description: Which collections to export
-          schema:
-            type: array
-            items:
-              type: string
-              enum: [memories, summaries]
-            default: [memories, summaries]
-          style: form
-          explode: false
-      responses:
-        '200':
-          description: Database exported successfully
-          content:
-            application/x-jsonlines:
-              schema:
-                type: string
-                format: binary
-        '503':
-          description: Cannot connect to database
-          content:
-            application/json:
-              schema:
-                $ref: '#/components/schemas/ErrorResponse'
-
-  /db/import:
+  /db/backup/manage:
     post:
-      summary: Import Database
-      operationId: import_database
+      summary: Manage Database Backup
+      operationId: manage_database_backup
       x-pass-as-object: true
       description: |
-        Imports a previously exported JSONL file back into the database.
+        Manages database backups (import/export).
 
         **When to Use:**
-        To restore a backup or migrate memory from another environment.
+        - **Export:** For creating backups or migrating memory data between environments.
+        - **Import:** To restore a backup or migrate memory from another environment.
       tags: [Database]
       requestBody:
         required: true
         content:
           multipart/form-data:
             schema:
               type: object
+              required:
+                - action
               properties:
+                action:
+                  type: string
+                  enum: [import, export]
+                  description: The action to perform.
+                include:
+                  type: array
+                  items:
+                    type: string
+                    enum: [memories, summaries]
+                  default: [memories, summaries]
+                  description: (Export only) Which collections to export.
                 file:
                   type: string
                   format: binary
-                  description: The JSONL backup file to import
+                  description: (Import only) The JSONL backup file to import.
                 mode:
                   type: string
                   enum: [merge, replace]
                   default: merge
                   description: |
+                    (Import only) Import mode.
                     - merge: Add new records, skip existing IDs
                     - replace: Clear existing data and import
                 reEmbed:
                   type: boolean
                   default: false
                   description: |
-                    If true, ignores stored embeddings and generates new ones using the current model.
-                    Crucial for model migration (e.g., to gemini-embedding-001).
-                    NOTE: This is a slow operation due to rate limiting (batching).
-              required:
-                - file
+                    (Import only) If true, ignores stored embeddings and generates new ones.
       responses:
         '200':
-          description: Import completed successfully
+          description: Operation completed successfully
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/ImportResponse'
+                oneOf:
+                  - $ref: '#/components/schemas/ImportResponse'
+                  - type: object
+                    properties:
+                      message:
+                        type: string
         '400':
-          description: Invalid file or request format
+          description: Invalid request
           content:
             application/json:
               schema:

ai/mcp/server/memory-core/services/DatabaseService.mjs

@@ -42,7 +42,7 @@ class DatabaseService extends Base {
      */
     async #exportCollection(collection, backupPath, filePrefix) {
         logger.log(`Fetching all documents from "${collection.name}"...`);
-        
+
         // 1. Get total count first
         const count = await collection.count();
         if (count === 0) {
@@ -60,10 +60,10 @@ class DatabaseService extends Base {
         // 2. Paginated Fetch
         const limit = 2000; // Safe batch size
         let offset  = 0;
-        
+
         while (offset < count) {
             logger.log(`Fetching batch: ${offset} to ${Math.min(offset + limit, count)} of ${count}`);
-            
+
             const batch = await collection.get({
                 include: ["documents", "embeddings", "metadatas"],
                 limit  : limit,
@@ -222,6 +222,23 @@ class DatabaseService extends Base {
             };
         }
     }
+
+    /**
+     * Manages database backups (import/export).
+     * @param {Object} options
+     * @param {String} options.action   The action to perform: 'import' or 'export'.
+     * @param {Object} [options.config] Additional options for the action.
+     * @returns {Promise<Object>}
+     */
+    async manageDatabaseBackup({action, ...config}) {
+        if (action === 'export') {
+            return this.exportDatabase(config);
+        } else if (action === 'import') {
+            return this.importDatabase(config);
+        } else {
+            throw new Error(`Unknown action: ${action}`);
+        }
+    }
 }
 
 export default Neo.setupClass(DatabaseService);

ai/mcp/server/memory-core/services/toolService.mjs

@@ -13,17 +13,16 @@ const __dirname       = path.dirname(__filename);
 const openApiFilePath = path.join(__dirname, '../openapi.yaml');
 
 const serviceMapping = {
-    add_memory          : MemoryService           .addMemory         .bind(MemoryService),
-    delete_all_summaries: SummaryService          .deleteAllSummaries.bind(SummaryService),
-    export_database     : DatabaseService         .exportDatabase    .bind(DatabaseService),
-    get_all_summaries   : SummaryService          .listSummaries     .bind(SummaryService),
-    get_session_memories: MemoryService           .listMemories      .bind(MemoryService),
-    healthcheck         : HealthService           .healthcheck       .bind(HealthService),
-    import_database     : DatabaseService         .importDatabase    .bind(DatabaseService),
-    manage_database     : DatabaseLifecycleService.manageDatabase    .bind(DatabaseLifecycleService),
-    query_raw_memories  : MemoryService           .queryMemories     .bind(MemoryService),
-    query_summaries     : SummaryService          .querySummaries    .bind(SummaryService),
-    summarize_sessions  : SessionService          .summarizeSessions .bind(SessionService)
+    add_memory            : MemoryService           .addMemory           .bind(MemoryService),
+    delete_all_summaries  : SummaryService          .deleteAllSummaries  .bind(SummaryService),
+    get_all_summaries     : SummaryService          .listSummaries       .bind(SummaryService),
+    get_session_memories  : MemoryService           .listMemories        .bind(MemoryService),
+    healthcheck           : HealthService           .healthcheck         .bind(HealthService),
+    manage_database       : DatabaseLifecycleService.manageDatabase      .bind(DatabaseLifecycleService),
+    manage_database_backup: DatabaseService         .manageDatabaseBackup.bind(DatabaseService),
+    query_raw_memories    : MemoryService           .queryMemories       .bind(MemoryService),
+    query_summaries       : SummaryService          .querySummaries      .bind(SummaryService),
+    summarize_sessions    : SessionService          .summarizeSessions   .bind(SessionService)
 };
 
 const toolService = Neo.create(ToolService, {