overlay: 1.0.0
info:
  title: CCA catalog agent-facing enrichment
  version: 1.0.0
  description: Non-breaking descriptions for clients using the catalog OpenAPI.
extends: https://services.datasourceapi.com/openapi.json
actions:
  - target: $.info
    update:
      x-cca-agent-guidance: Treat service metadata as discovery information. Follow each service's authoritative OpenAPI and verify status and freshness before use.
  - target: $.paths['/api/v1/services'].get
    update:
      x-cca-agent-guidance: Filter narrowly by capability or kind before retrieving one full service record.
  - target: $.components.schemas.Service.properties.agentReadiness
    update:
      description: Evidence-based readiness indicator; it is not a guarantee that every upstream operation is safe for autonomous use.
