Skip to main content

H.1.7: Component Metadata Registry

Unified metadata registry that consolidates all component metadata sources:

  • framework-registry.json (component definitions)
  • capability-registry.json (capability taxonomy)
  • component-activation-status.json (activation state)
  • component-indexer SQLite database (FTS search, capabilities)
  • agent-cards/*.json (A2A protocol metadata)

Provides a single API for querying component metadata with caching, versioning, and integration with the discovery service.

Usage: python3 scripts/core/component_metadata_registry.py --stats python3 scripts/core/component_metadata_registry.py --get agent/orchestrator python3 scripts/core/component_metadata_registry.py --list agents python3 scripts/core/component_metadata_registry.py --search "security" python3 scripts/core/component_metadata_registry.py --capabilities agent/orchestrator python3 scripts/core/component_metadata_registry.py --refresh # Reload from sources

File: component_metadata_registry.py

Classes

ComponentType

Component types in the framework.

ComponentStatus

Component operational status.

ActivationState

Component activation state.

LLMBinding

LLM configuration for a component.

CapabilityInfo

Capability information for a component.

ComponentMetadata

Unified component metadata.

ComponentMetadataRegistry

Unified component metadata registry.

Functions

main()

No description

from_dict(cls, data)

No description

to_dict()

Convert to dictionary for serialization.

load()

Load metadata from all sources.

get(component_id)

Get component metadata by ID.

get_by_name(name, component_type)

Get component by name (searches all types if type not specified).

list_by_type(component_type, activated_only)

List all components of a given type.

list_by_capability(capability)

List all components with a given capability.

search(query, component_type)

Search components by query string.

get_capabilities(component_id)

Get all capabilities for a component.

get_relationships(component_id)

Get all relationships for a component.

get_capability_taxonomy()

Get the capability taxonomy.

get_stats()

Get registry statistics.

refresh()

Reload metadata from all sources.

export_to_json(output_path)

Export registry to JSON file.

Usage

python component_metadata_registry.py