Enhance: Instance Tools Batch Operations (#8325)

Author: tobiu

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

@@ -97,13 +97,13 @@ paths:
                   tree:
                     type: object
 
-  /instance/property/get:
+  /instance/properties/get:
     post:
-      summary: Get Instance Property
-      operationId: get_instance_property
+      summary: Get Instance Properties
+      operationId: get_instance_properties
       x-pass-as-object: true
       description: |
-        Retrieves a property from a specific instance by its ID.
+        Retrieves properties from a specific instance by its ID.
 
         **When to Use:**
         To inspect the current state of any Neo instance (e.g., Component, Store, Controller, Manager).
@@ -113,14 +113,14 @@ paths:
         content:
           application/json:
             schema:
-              $ref: '#/components/schemas/GetInstancePropertyRequest'
+              $ref: '#/components/schemas/GetInstancePropertiesRequest'
       responses:
         '200':
-          description: The value of the property
+          description: The values of the properties
           content:
             application/json:
               schema:
-                description: The property value
+                description: The property values
         '400':
           description: Invalid request body
           content:
@@ -892,13 +892,13 @@ paths:
                     chrome:
                       type: object
 
-  /instance/property/set:
+  /instance/properties/set:
     post:
-      summary: Set Instance Property
-      operationId: set_instance_property
+      summary: Set Instance Properties
+      operationId: set_instance_properties
       x-pass-as-object: true
       description: |
-        Sets a property on a specific instance by its ID.
+        Sets properties on a specific instance by its ID.
 
         **When to Use:**
         To modify the runtime state of an instance (e.g., change component text, update store filter).
@@ -908,10 +908,10 @@ paths:
         content:
           application/json:
             schema:
-              $ref: '#/components/schemas/SetInstancePropertyRequest'
+              $ref: '#/components/schemas/SetInstancePropertiesRequest'
       responses:
         '200':
-          description: Property set successfully
+          description: Properties set successfully
         '400':
           description: Invalid request body
           content:
@@ -1208,18 +1208,20 @@ components:
         uptime:
           type: number
 
-    GetInstancePropertyRequest:
+    GetInstancePropertiesRequest:
       type: object
       required:
         - id
-        - property
+        - properties
       properties:
         id:
           type: string
           description: The instance ID
-        property:
-          type: string
-          description: The property name to retrieve
+        properties:
+          type: array
+          items:
+            type: string
+          description: List of property names to retrieve
         sessionId:
           type: string
           description: The target App Worker Session ID
@@ -1349,21 +1351,18 @@ components:
           type: string
           description: The target App Worker Session ID
 
-    SetInstancePropertyRequest:
+    SetInstancePropertiesRequest:
       type: object
       required:
         - id
-        - property
-        - value
+        - properties
       properties:
         id:
           type: string
           description: The instance ID
-        property:
-          type: string
-          description: The property name to set
-        value:
-          description: The value to set
+        properties:
+          type: object
+          description: Key-value pairs of properties to set
         sessionId:
           type: string
           description: The target App Worker Session ID

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

@@ -26,34 +26,32 @@ class InstanceService extends Base {
     }
 
     /**
-     * Retrieves a property from a specific instance by its ID.
+     * Retrieves properties from a specific instance by its ID.
      * @param {Object} opts
      * @param {String} opts.sessionId
      * @param {String} opts.id
-     * @param {String} opts.property
+     * @param {String[]} opts.properties
      * @returns {Promise<Object>}
      */
-    async getInstanceProperty({sessionId, id, property}) {
-        return await ConnectionService.call(sessionId, 'get_instance_property', {
+    async getInstanceProperties({sessionId, id, properties}) {
+        return await ConnectionService.call(sessionId, 'get_instance_properties', {
             id,
-            property
+            properties
         })
     }
 
     /**
-     * Sets a property on a specific instance by its ID.
+     * Sets properties on a specific instance by its ID.
      * @param {Object} opts
      * @param {String} opts.sessionId
      * @param {String} opts.id
-     * @param {String} opts.property
-     * @param {*}      opts.value
+     * @param {Object} opts.properties
      * @returns {Promise<Object>}
      */
-    async setInstanceProperty({sessionId, id, property, value}) {
-        return await ConnectionService.call(sessionId, 'set_instance_property', {
+    async setInstanceProperties({sessionId, id, properties}) {
+        return await ConnectionService.call(sessionId, 'set_instance_properties', {
             id,
-            property,
-            value
+            properties
         })
     }
 }

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

@@ -22,7 +22,7 @@ const serviceMapping = {
     get_dom_event_summary        : RuntimeService    .getDomEventSummary        .bind(RuntimeService),
     get_dom_rect                 : ComponentService  .getDomRect                .bind(ComponentService),
     get_drag_state               : InteractionService.getDragState              .bind(InteractionService),
-    get_instance_property        : InstanceService   .getInstanceProperty       .bind(InstanceService),
+    get_instance_properties      : InstanceService   .getInstanceProperties     .bind(InstanceService),
     get_method_source            : RuntimeService    .getMethodSource           .bind(RuntimeService),
     get_namespace_tree           : RuntimeService    .getNamespaceTree          .bind(RuntimeService),
     get_record                   : DataService       .getRecord                 .bind(DataService),
@@ -42,7 +42,7 @@ const serviceMapping = {
     patch_code                   : RuntimeService    .patchCode                 .bind(RuntimeService),
     query_component              : ComponentService  .queryComponent            .bind(ComponentService),
     reload_page                  : RuntimeService    .reloadPage                .bind(RuntimeService),
-    set_instance_property        : InstanceService   .setInstanceProperty       .bind(InstanceService),
+    set_instance_properties      : InstanceService   .setInstanceProperties     .bind(InstanceService),
     set_route                    : RuntimeService    .setRoute                  .bind(RuntimeService),
     simulate_event               : InteractionService.simulateEvent             .bind(InteractionService)
 };

src/ai/Client.mjs

@@ -97,8 +97,8 @@ class Client extends Base {
             query_component       : component,
             set_component         : component,
 
-            get_instance          : instance,
-            set_instance          : instance,
+            get_instance_properties: instance,
+            set_instance_properties: instance,
 
             get_record            : data,
             inspect_state_provider: data,

src/ai/client/InstanceService.mjs

@@ -15,36 +15,43 @@ class InstanceService extends Service {
     }
 
     /**
+     * Retrieves properties from a specific instance by its ID.
      * @param {Object} params
      * @param {String} params.id
-     * @param {String} params.property
+     * @param {String[]} params.properties
      * @returns {Object}
      */
-    getInstanceProperty({id, property}) {
-        const instance = Neo.get(id);
+    getInstanceProperties({id, properties}) {
+        const
+            instance = Neo.get(id),
+            result   = {};
 
         if (!instance) {
             throw new Error(`Instance not found: ${id}`)
         }
 
-        return {value: this.safeSerialize(instance[property])}
+        properties.forEach(property => {
+            result[property] = this.safeSerialize(instance[property])
+        });
+
+        return {properties: result}
     }
 
     /**
+     * Sets properties on a specific instance by its ID.
      * @param {Object} params
      * @param {String} params.id
-     * @param {String} params.property
-     * @param {*}      params.value
+     * @param {Object} params.properties
      * @returns {Object}
      */
-    setInstanceProperty({id, property, value}) {
+    setInstanceProperties({id, properties}) {
         const instance = Neo.get(id);
 
         if (!instance) {
             throw new Error(`Instance not found: ${id}`)
         }
 
-        instance[property] = value;
+        instance.set(properties);
 
         return {success: true}
     }