Enhance: query_component with returnProperties (#8326)

Author: tobiu

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

@@ -1288,6 +1288,11 @@ components:
         rootId:
           type: string
           description: Optional ID of a component to search within (scoped search).
+        returnProperties:
+          type: array
+          items:
+            type: string
+          description: "Optional list of properties to return. If provided, returns a lean response (id, className, properties) instead of the full component serialization."
         sessionId:
           type: string
           description: The target App Worker Session ID

src/ai/client/ComponentService.mjs

@@ -154,9 +154,10 @@ class ComponentService extends Service {
      * @param {Object} params
      * @param {String} [params.rootId]
      * @param {Object} params.selector
+     * @param {String[]} [params.returnProperties]
      * @returns {Object}
      */
-    queryComponent({rootId, selector}) {
+    queryComponent({rootId, selector, returnProperties}) {
         let matches = [];
 
         if (rootId) {
@@ -171,9 +172,24 @@ class ComponentService extends Service {
             matches = matches ? [matches] : []
         }
 
-        return {
-            components: matches.map(c => c.toJSON())
-        }
+        const components = matches.map(c => {
+            if (returnProperties && Array.isArray(returnProperties) && returnProperties.length > 0) {
+                const props = {};
+                returnProperties.forEach(prop => {
+                    props[prop] = this.safeSerialize(c[prop])
+                });
+
+                return {
+                    className : c.className,
+                    id        : c.id,
+                    properties: props
+                }
+            }
+
+            return c.toJSON()
+        });
+
+        return {components}
     }
 
     /**