[Daniel Botros (danielbotros)]

RSDK-14642 — PR 1/5 of the Composable APIs server-side work (epic RSDK-14329). Stacked on #6521.

The in-process engine that makes a composite resolvable and advertised on one machine. It consumes the graph machinery from #6520 (the single-node model + compositeByAPI index) and wires it into the robot's resolution, dependency, lifecycle, and advertisement paths. Three files:

local_robot.go — resolution, dependencies, lifecycle

• Resolution. ResourceByName splits on whether the lookup carries an API. An API-qualified lookup goes to FindBySimpleNameAndAPI, which fetches the graph node and unwraps it to that API's sub-resource (SubresourceForAPI) — so an in-process consumer that type-asserts sees the real typed instance, not the multi-API wrapper. An api-less (bare SimpleName) lookup goes to resourceBySimpleName → resolveSimpleNameMatch: a local composite is already one graph node, so it returns that whole multi-API handle; a remote composite arrives as one per-API sub-client node per co-equal API, so it assembles a MultiAPIResource view over those sub-clients. A genuine same-name collision across distinct resources still errors — the dedup only ever collapses one composite.
• Dependencies. A composite dependency is keyed in a dependent's Dependencies under each of its co-equal API names (coequalAPIsOf reports the set — from APIsOf for a modular composite, or the node's model for a builtin one), so a consumer resolves it by whichever API it expects. The weak-dependency matcher scan likewise runs per served API and stores the unwrapped sub under each, so a weak-dep consumer (e.g. data capture) gets a typed sub rather than the wrapper.
• Lifecycle. StopAll dedups on the raw pre-unwrap node, so a composite advertised under N actuator APIs is stopped exactly once.
• Status. MachineStatus fills cloud metadata for a remote composite's non-canonical API rows (findRemoteMetadataByName).

resource_manager.go — advertisement, in-place reconfigure

AllNonCollidingResourceNames expands each composite to its per-API names for advertisement (ExpandCompositeNames), and updateRemoteResourceNames exempts a remote composite's own co-equal siblings from the collision check (same-remote exemption), so a composite isn't torn down as a self-collision.

A model-only reconfigure swaps a resource in place (gNode.SwapResource) and keeps the same graph node, bypassing the set/rename paths that maintain compositeByAPI — so after a composite changed models its co-equal index would still point at the old API set and the new non-canonical APIs would stop resolving. ReindexComposite (added to resource.Graph in #6520's helper) is now called right after the in-place swap, re-running the index so the composite resolves under its current co-equal APIs.

robot.go

ResourceFromRobot unwraps via resource.AsType, so <pkg>.FromProvider(robot, name) returns the typed sub of a composite; the LocalRobot.FindBySimpleNameAndAPI interface doc states that unwrap contract.

Testing

robot/impl/multiapi_composite_test.go — in-process + remote end-to-end suite: api-less + per-API resolution with close-once, dependency aliasing, genuine simple-name collision handling (local and remote, incl. cross-API), remote composites (direct, prefixed, nested — one table-driven test), in-process typed lookup (the MultiAPIResource unwrap), StopAll dedup, and frame-system membership. TestCompositeModelReconfigureReindexes covers the in-place model-reconfigure case end to end: a resource reconfigured from a single-API model to a composite model resolves under its new co-equal API. A graph-level unit test for ReindexComposite lives in #6520's resource_graph_test.go.

🤖 Generated with Claude Code