apiVersion: cognitive-agent/v1alpha1
kind: CapabilityCatalog
metadata:
  id: ambient-light-capabilities
  name: Ambient light capabilities
  version: 1.0.0
spec:
  domain: ambient_light
  capabilities:
    - name: ambient_light.set_power
      description: Turn the vehicle ambient-light system on or off.
      target_devices: [ambient_light]
      target_scopes: [vehicle]
      parameters:
        - name: state
          type: string
          required: true
          allowed_values: ["on", "off"]
          description: Absolute ambient-light power state.
      risk_level: low
      confirmation_policy: on_ambiguity
    - name: ambient_light.set_illumination
      description: Set exact 24-bit RGB color and brightness for the cabin ambient light.
      target_devices: [ambient_light]
      target_scopes: [vehicle]
      parameters:
        - name: color_hex
          type: string
          required: true
          description: RGB color encoded as #RRGGBB; infer a suitable color for semantic requests.
        - name: brightness_pct
          type: integer
          unit: percent
          minimum: 0
          maximum: 100
          required: true
          description: Absolute brightness percentage.
      risk_level: low
      confirmation_policy: on_ambiguity
    - name: ambient_light.set_mode
      description: Select a matrix-defined ambient-light scene mode.
      target_devices: [ambient_light]
      target_scopes: [vehicle]
      parameters:
        - name: mode
          type: string
          required: true
          allowed_values: [camping, rest, cinema, meditation, romantic, "off", "on"]
          description: Absolute scene mode.
      risk_level: low
      confirmation_policy: on_ambiguity