Module reference 

Generic ID reference protocol for config objects.

Any config field that references another object uses the {{...}} syntax:

Pattern	Meaning
{{type.name}}	Qualified reference, recreate
{{%type.name%}}	Qualified reference, no recreation if exists
{{name}}	Unqualified (unique resolve), recreate
{{%name%}}	Unqualified (unique resolve), no recreation
{{#system_id#}}	Literal system ID, no recreation

Resolution rules

• Qualified: look up name in the specified type namespace (e.g., agent_profile → [[agent.profile.instances]])
• Unqualified: search all namespaces; must resolve uniquely or error
• % delimiters: skip creation if an object with matching description already exists. If multiple matches, use the one with the latest creation date.
• No %: always create a new instance
• # delimiters: literal system ID (already exists in external system)

Namespaces

Qualified prefix	Config section
agent_profile	[[agent.profile.instances]]
provider	[[provider.instances]]
sub_agent	[[sub_agents.instances]]

Enums

ConfigRef

A parsed config object reference.

Functions

parse_config_ref

Parse a string that may contain a {{...}} reference pattern.