feat(ai): Implement Get Record Tool (#8195)

- Add `get_record` tool to Neural Link MCP.
- Update `Neo.ai.Client` to handle `get_record` requests with optional store scoping.
- Implement ambiguity check for records existing in multiple stores.
- Import `Neo.manager.Store` in Client for robust store access.

Author: tobiu

ai/mcp/server/neural-link/openapi.yaml

@@ -252,6 +252,31 @@ paths:
                     count:
                       type: integer
 
+  /data/record/get:
+    post:
+      summary: Get Record
+      operationId: get_record
+      x-pass-as-object: true
+      description: |
+        Retrieves a specific data record.
+
+        **When to Use:**
+        To inspect the full data of a single record.
+      tags: [Data]
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/GetRecordRequest'
+      responses:
+        '200':
+          description: Record data
+          content:
+            application/json:
+              schema:
+                type: object
+
   /drag/state:
     post:
       summary: Get Drag State
@@ -622,6 +647,21 @@ components:
           type: string
           description: The target App Worker Session ID
 
+    GetRecordRequest:
+      type: object
+      required:
+        - recordId
+      properties:
+        recordId:
+          type: string
+          description: The ID of the record to retrieve
+        storeId:
+          type: string
+          description: Optional Store ID to scope the search
+        sessionId:
+          type: string
+          description: The target App Worker Session ID
+
     ErrorResponse:
       type: object
       properties:

ai/mcp/server/neural-link/services/DataService.mjs

@@ -45,6 +45,18 @@ class DataService extends Base {
     async listStores({sessionId}) {
         return await ConnectionService.call(sessionId, 'list_stores', {});
     }
+
+    /**
+     * Retrieves a specific record.
+     * @param {Object} opts The options object.
+     * @param {String} opts.recordId The ID of the record.
+     * @param {String} [opts.storeId] Optional Store ID.
+     * @param {String} [opts.sessionId] The target session ID.
+     * @returns {Promise<Object>} The record data.
+     */
+    async getRecord({recordId, storeId, sessionId}) {
+        return await ConnectionService.call(sessionId, 'get_record', {recordId, storeId});
+    }
 }
 
 export default Neo.setupClass(DataService);

ai/mcp/server/neural-link/services/toolService.mjs

@@ -16,6 +16,7 @@ const serviceMapping = {
     get_component_property: ComponentService.getComponentProperty.bind(ComponentService),
     get_component_tree    : ComponentService.getComponentTree.bind(ComponentService),
     get_drag_state        : InteractionService.getDragState.bind(InteractionService),
+    get_record            : DataService.getRecord.bind(DataService),
     get_vdom_tree         : ComponentService.getVdomTree.bind(ComponentService),
     get_vnode_tree        : ComponentService.getVnodeTree.bind(ComponentService),
     get_window_topology   : RuntimeService.getWindowTopology.bind(RuntimeService),

src/ai/Client.mjs

@@ -1,6 +1,7 @@
 import Base            from '../core/Base.mjs';
 import ClassSystemUtil from '../util/ClassSystem.mjs';
 import Socket          from '../data/connection/WebSocket.mjs';
+import StoreManager    from '../manager/Store.mjs';
 
 /**
  * The AI Client establishes a WebSocket connection to the Neural Link MCP Server.
@@ -266,6 +267,32 @@ class Client extends Base {
                 if (!component) throw new Error('Root component not found');
                 return {vnode: component.vnode};
 
+            case 'get_record':
+                let {recordId, storeId} = params,
+                    record;
+
+                if (storeId) {
+                    const store = Neo.get(storeId);
+                    if (!store) throw new Error(`Store not found: ${storeId}`);
+                    record = store.get(recordId)
+                } else {
+                    const matches = [];
+                    StoreManager.items.forEach(store => {
+                        const rec = store.get(recordId);
+                        if (rec) matches.push(rec)
+                    });
+
+                    if (matches.length > 1) {
+                        throw new Error(`Multiple records found with ID ${recordId}. Please specify storeId.`)
+                    } else if (matches.length === 1) {
+                        record = matches[0]
+                    }
+                }
+
+                if (!record) throw new Error(`Record not found: ${recordId}`);
+
+                return record.toJSON();
+
             case 'get_window_info':
                 const windowManager = Neo.manager?.Window;
 
@@ -307,11 +334,8 @@ class Client extends Base {
                 };
 
             case 'list_stores':
-                const storeManager = Neo.manager?.Store;
-                if (!storeManager) return {stores: []};
-
                 return {
-                    stores: storeManager.items.map(s => ({
+                    stores: StoreManager.items.map(s => ({
                         id      : s.id,
                         model   : s.model?.className || 'N/A',
                         count   : s.count,