[Neural Link] Feature: Tool find_instances

Goal: Enable discovery of any Neo instance (StateProviders, Stores, Managers, etc.) by property matching using the global Instance Manager.

Specification:

1. Tool Name: find_instances
2. Service: src/ai/client/InstanceService.mjs
3. Logic:
   • Use Neo.manager.Instance.find(selector) to retrieve matches.
   • This leverages the existing Neo.collection.Base finding logic (exact match on properties).
4. Parameters:
   • selector (Required, Object): Key-value pairs to match (e.g., { className: 'Neo.state.Provider' }).
   • returnProperties (Optional, Array): List of specific properties to extract.
5. Return Format:
   • Default: Returns instance.toJSON() for each match.
   • With returnProperties: Returns a lean summary object:

             {
       "instances": [
         {
           "id": "neo-provider-1",
           "className": "Neo.state.Provider",
           "properties": {
             "someProp": "someValue"
           }
         }
       ]
     }

6. Implementation Details:
   • Reuse this.safeSerialize() from the base Service class for property values.
   • Unlike query_component, this tool is flat (global search) and does not support rootId or hierarchical down() lookups.

Comparison with query_component:

• query_component: Focused on UI hierarchy, supports rootId, traverses down(), returns components.
• find_instances: Focused on abstract architecture (Stores, Providers), global scope, returns instances.