apiVersion: cognitive-agent/v1alpha1
kind: CapabilityCatalog
metadata:
  id: outlet-native-can-capabilities
  name: Air outlet native CAN capabilities
  version: 1.0.0
spec:
  domain: outlet
  capabilities:
    - name: outlet.set_switch_state
      description: Open or close one front motorized air outlet using the byte-exact head-unit CAN FD request observed on the vehicle.
      target_devices: [motorized_air_outlet]
      target_scopes: [driver_left, driver_right, passenger_left, passenger_right]
      parameters:
        - name: state
          type: string
          required: true
          allowed_values: [open, close]
          description: Explicit switch state for exactly one air outlet.
      risk_level: medium
      confirmation_policy: on_ambiguity
    - name: outlet.set_position_percent
      description: Set both axes of one calibrated front air outlet using normalized percentages through vehicle CAN FD.
      target_devices: [motorized_air_outlet]
      target_scopes: [driver_left, driver_right, passenger_left, passenger_right]
      parameters:
        - {name: horizontal_pct, type: integer, unit: percent, minimum: 0, maximum: 100, required: true, description: Left-to-right target.}
        - {name: vertical_pct, type: integer, unit: percent, minimum: 0, maximum: 100, required: true, description: Down-to-up target.}
      risk_level: medium
      confirmation_policy: on_ambiguity
    - name: outlet.set_calibrated_position
      description: Set both raw calibrated axes of one front air outlet.
      target_devices: [motorized_air_outlet]
      target_scopes: [driver_left, driver_right, passenger_left, passenger_right]
      parameters:
        - {name: horizontal_value, type: integer, minimum: -128, maximum: 126, required: true, description: Calibrated left-to-right coordinate.}
        - {name: vertical_value, type: integer, minimum: -128, maximum: 126, required: true, description: Calibrated down-to-up coordinate.}
      risk_level: medium
      confirmation_policy: on_ambiguity