apiVersion: cognitive-agent/v1alpha1
kind: CapabilityCatalog
metadata:
  id: climate-capabilities
  name: Climate capabilities
  version: 1.0.0
spec:
  domain: climate
  capabilities:
    - name: climate.set_power
      description: Turn HVAC power on or off for the requested cabin zone.
      target_devices: [hvac]
      target_scopes: [driver, passenger, front_row, rear_row, rear_left, rear_right, vehicle]
      parameters:
        - name: state
          type: string
          required: true
          allowed_values: ["on", "off"]
          description: Absolute HVAC power state.
      risk_level: low
      confirmation_policy: on_ambiguity
    - name: climate.set_temperature
      description: Set an absolute HVAC temperature from 18 to 32 degrees Celsius.
      target_devices: [hvac]
      target_scopes: [driver, passenger, front_row, rear_row, rear_left, rear_right, vehicle]
      parameters:
        - name: temperature_c
          type: number
          unit: celsius
          minimum: 18
          maximum: 32
          required: true
          description: Absolute requested temperature in degrees Celsius.
      risk_level: medium
      confirmation_policy: on_ambiguity
    - name: climate.set_fan_level
      description: Set whole-cabin airflow to an absolute integer level from 0 to 7.
      target_devices: [hvac]
      target_scopes: [vehicle]
      parameters:
        - name: level
          type: integer
          minimum: 0
          maximum: 7
          required: true
          description: Absolute fan level, where 0 is off and 7 is maximum.
      risk_level: low
      confirmation_policy: on_ambiguity
    - name: climate.set_ac
      description: Turn the air-conditioning compressor request on or off.
      target_devices: [hvac]
      target_scopes: [vehicle]
      parameters:
        - name: state
          type: string
          required: true
          allowed_values: ["on", "off"]
          description: Absolute compressor request state.
      risk_level: low
      confirmation_policy: on_ambiguity
    - name: climate.set_cycle_mode
      description: Select internal or external cabin air circulation.
      target_devices: [hvac]
      target_scopes: [vehicle]
      parameters:
        - name: mode
          type: string
          required: true
          allowed_values: [internal, external]
          description: Absolute circulation mode.
      risk_level: low
      confirmation_policy: on_ambiguity
    - name: climate.set_outlet_mode
      description: Select a whole-cabin vehicle CAN airflow mode; face and feet remain valid zone-level virtual controls.
      target_devices: [hvac]
      target_scopes: [driver, passenger, rear_left, rear_right, vehicle]
      parameters:
        - name: mode
          type: string
          required: true
          allowed_values: [face, face_feet, feet, feet_defrost, defrost, face_feet_defrost, face_defrost]
          description: Absolute outlet direction.
      risk_level: low
      confirmation_policy: on_ambiguity
    - name: climate.set_front_defrost
      description: Turn front windshield defrost on or off.
      target_devices: [hvac]
      target_scopes: [vehicle]
      parameters:
        - name: state
          type: string
          required: true
          allowed_values: ["on", "off"]
          description: Absolute front defrost state.
      risk_level: medium
      confirmation_policy: on_ambiguity
    - name: climate.set_control_mode
      description: Select manual or automatic HVAC control through the verified vehicle CAN command.
      target_devices: [hvac]
      target_scopes: [vehicle]
      parameters:
        - name: mode
          type: string
          required: true
          allowed_values: [manual, auto]
          description: Absolute HVAC control strategy.
      risk_level: low
      confirmation_policy: on_ambiguity