apiVersion: cognitive-agent/v1alpha1
kind: CapabilityCatalog
metadata:
  id: roof-capabilities
  name: Roof capabilities
  version: 1.0.0
spec:
  domain: roof
  capabilities:
    - name: roof.set_shade_motion
      description: Open, close, half-open, or stop the panoramic roof shade through vehicle CAN.
      target_devices: [roof_shade]
      target_scopes: [vehicle]
      parameters:
        - name: motion
          type: string
          required: true
          allowed_values: [open, close, half, stop]
          description: Explicit shade motion command.
      risk_level: high
      confirmation_policy: on_ambiguity
    - name: roof.set_shade_position
      description: Set the rear panoramic roof shade to an absolute position, 0 closed and 100 open.
      target_devices: [roof_shade]
      target_scopes: [vehicle]
      parameters:
        - name: position_pct
          type: integer
          unit: percent
          minimum: 0
          maximum: 100
          required: true
          description: Absolute shade opening percentage.
      risk_level: high
      confirmation_policy: on_ambiguity
    - name: roof.set_transmittance
      description: Set dimming canopy light transmittance, 0 darkest and 100 clearest.
      target_devices: [roof_glass]
      target_scopes: [vehicle]
      parameters:
        - name: transmittance_pct
          type: integer
          unit: percent
          minimum: 0
          maximum: 100
          required: true
          description: Absolute smart-glass transmittance percentage.
      risk_level: medium
      confirmation_policy: on_ambiguity
    - name: roof.set_automatic_dimming
      description: Turn automatic canopy dimming on or off.
      target_devices: [roof_glass]
      target_scopes: [vehicle]
      parameters:
        - name: state
          type: string
          required: true
          allowed_values: ["on", "off"]
          description: Absolute automatic dimming state.
      risk_level: low
      confirmation_policy: on_ambiguity