LearnNewsExamplesServices
Frontmatter
id8924
titleFeat: Support nested property paths in get_instance_properties
stateClosed
labels
enhancementai
assigneestobiu
createdAtJan 31, 2026, 4:20 PM
updatedAtJan 31, 2026, 5:37 PM
githubUrlhttps://github.com/neomjs/neo/issues/8924
authortobiu
commentsCount1
parentIssuenull
subIssues[]
subIssuesCompleted0
subIssuesTotal0
blockedBy[]
blocking[]
closedAtJan 31, 2026, 5:37 PM

Feat: Support nested property paths in get_instance_properties

Closed v12.0.0 enhancementai
tobiu
tobiu commented on Jan 31, 2026, 4:20 PM

Enhance get_instance_properties to support dot-notation for accessing nested properties on an instance.

Current Behavior: properties: ['store'] returns the Store ID (if instance) or object. To get the count, a second call is needed: inspect_store or get_instance_properties on the store ID.

New Behavior: Support properties: ['store.count', 'layout.align', 'view.style.color'].

Implementation: Update Neo.ai.client.InstanceService to traverse the object graph using a Neo.ns-like helper for each requested property path.

Benefit: Enables agents to retrieve deep state (e.g. "Why is the grid empty?" -> check store.filters) in a single roundtrip without needing eval.

tobiu added the enhancement label on Jan 31, 2026, 4:20 PM
tobiu added the ai label on Jan 31, 2026, 4:20 PM
tobiu assigned to @tobiu on Jan 31, 2026, 5:29 PM
tobiu referenced in commit 858c8d6 - "feat: Support nested property paths in get_instance_properties (#8924) on Jan 31, 2026, 5:36 PM
tobiu
tobiu Jan 31, 2026, 5:36 PM

Input from Gemini 3 Pro:

✦ I have implemented the support for nested property paths.

Changes:

  1. Core Logic: Updated src/ai/client/InstanceService.mjs to use Neo.ns(property, false, instance) instead of direct access instance[property]. This applies to both getInstanceProperties and findInstances.
  2. Documentation: Updated ai/mcp/server/neural-link/openapi.yaml to explicitly state that properties and returnProperties now support dot-notation (e.g., store.count).

This allows agents to drill down into objects in a single call.

tobiu closed this issue on Jan 31, 2026, 5:37 PM