apiVersion: cognitive-agent/v1alpha1
kind: CapabilityCatalog
metadata:
  id: seat-capabilities
  name: Seat capabilities
  version: 1.2.0
spec:
  domain: seat
  capabilities:
    - name: seat.set_ventilation
      description: >-
        Move air through one seat surface to reduce local occupant heat and moisture; this does not
        control general cabin airflow. Turn it on or off for the driver or front passenger seat.
      target_devices:
        - seat
      target_scopes:
        - driver
        - passenger
      parameters:
        - name: state
          type: string
          required: true
          description: Requested binary ventilation state.
          allowed_values:
            - "on"
            - "off"
        - name: level
          type: integer
          required: false
          description: Desired 1-3 comfort level; simulated until a level command signal is supplied.
          allowed_values:
            - 1
            - 2
            - 3
      risk_level: medium
      confirmation_policy: on_ambiguity
    - name: seat.set_heating
      description: >-
        Warm one seat surface for local occupant thermal comfort. Turn it on or off for the driver
        or front passenger seat.
      target_devices:
        - seat
      target_scopes:
        - driver
        - passenger
      parameters:
        - name: state
          type: string
          required: true
          description: Requested binary heating state.
          allowed_values:
            - "on"
            - "off"
        - name: level
          type: integer
          required: false
          description: Desired 1-3 comfort level; simulated until a level command signal is supplied.
          allowed_values:
            - 1
            - 2
            - 3
      risk_level: medium
      confirmation_policy: on_ambiguity
    - name: seat.set_longitudinal_position
      description: >-
        Set one front seat's fore-aft rail position. position_pct is an absolute target: 0 is the
        rearmost mechanical limit and 100 is the forwardmost limit. Resolve relative requests such
        as "move back a little" against the current position supplied in runtime state. For a
        vehicle-specific physical relative request, distance_mm may be supplied and the runtime
        converts it to an absolute position_pct before CAN compilation.
      target_devices:
        - seat_longitudinal_motor
      target_scopes:
        - driver
        - passenger
      parameters:
        - name: position_pct
          type: integer
          unit: percent
          required: false
          minimum: 0
          maximum: 100
          description: Absolute normalized fore-aft target.
        - name: distance_mm
          type: number
          unit: mm
          required: false
          minimum: 0
          maximum: 215
          description: Relative physical fore-aft movement resolved against current position and vehicle calibration.
      risk_level: high
      confirmation_policy: on_ambiguity
    - name: seat.set_cushion_tilt
      description: >-
        Set the seat-cushion pitch for one front seat. position_pct is absolute: 0 places the front
        edge at its lowest limit and 100 raises the front edge to its highest tilt limit.
      target_devices:
        - seat_cushion_tilt_motor
      target_scopes:
        - driver
        - passenger
      parameters:
        - name: position_pct
          type: integer
          unit: percent
          required: true
          minimum: 0
          maximum: 100
          description: Absolute normalized cushion front-edge height target.
      risk_level: high
      confirmation_policy: on_ambiguity
    - name: seat.set_backrest_recline
      description: >-
        Set the backrest recline of one front seat. Use either position_pct or angle_deg.
        position_pct is absolute: 0 is the most upright limit and 100 is the most reclined limit.
        angle_deg is the included angle between the seat-cushion surface and backrest centreline,
        from 95 to 163 degrees for the selected Denza N7 profile. "Backrest backward" means a
        larger value. For relative physical angle requests, angle_delta_deg may be supplied and the
        runtime converts it to an absolute position_pct before CAN compilation.
      target_devices:
        - seat_backrest_motor
      target_scopes:
        - driver
        - passenger
      parameters:
        - name: position_pct
          type: integer
          unit: percent
          required: false
          minimum: 0
          maximum: 100
          description: Absolute normalized backrest-recline target.
        - name: angle_deg
          type: number
          unit: degree
          required: false
          minimum: 95
          maximum: 163
          description: Exact included angle between the cushion surface and backrest centreline.
        - name: angle_delta_deg
          type: number
          unit: degree
          required: false
          minimum: 0
          maximum: 68
          description: Relative backrest angle movement resolved against current posture and vehicle calibration.
      risk_level: high
      confirmation_policy: on_ambiguity
    - name: seat.set_legrest_height
      description: >-
        Raise or lower one front seat's powered leg rest. Use either position_pct or angle_deg.
        position_pct is absolute: 0 is fully lowered and 100 is fully raised. angle_deg is the
        included angle between the cushion surface and leg-rest surface, from 95 to 173 degrees for
        the selected Denza N7 profile. For relative physical angle requests, angle_delta_deg may be
        supplied and the runtime converts it to an absolute position_pct before CAN compilation. This
        axis does not change leg-rest extension.
      target_devices:
        - seat_legrest_lift_motor
      target_scopes:
        - driver
        - passenger
      parameters:
        - name: position_pct
          type: integer
          unit: percent
          required: false
          minimum: 0
          maximum: 100
          description: Absolute normalized leg-rest lift target.
        - name: angle_deg
          type: number
          unit: degree
          required: false
          minimum: 95
          maximum: 173
          description: Exact included angle between the cushion surface and leg-rest surface.
        - name: angle_delta_deg
          type: number
          unit: degree
          required: false
          minimum: 0
          maximum: 78
          description: Relative leg-rest lift angle movement resolved against current posture and vehicle calibration.
      risk_level: high
      confirmation_policy: on_ambiguity
    - name: seat.set_legrest_extension
      description: >-
        Extend or retract one front seat's powered leg rest. position_pct is absolute: 0 is fully
        retracted and 100 is fully extended. This axis does not change leg-rest height.
      target_devices:
        - seat_legrest_extension_motor
      target_scopes:
        - driver
        - passenger
      parameters:
        - name: position_pct
          type: integer
          unit: percent
          required: true
          minimum: 0
          maximum: 100
          description: Absolute normalized leg-rest extension target.
      risk_level: high
      confirmation_policy: on_ambiguity
    - name: seat.save_posture_preset
      description: >-
        Save the current five-axis posture of one front seat as a conversation-owned named preset.
        This is a control-plane operation and does not emit a CAN command. Use only when the user
        explicitly asks to save, remember or overwrite the current posture.
      target_devices:
        - seat_preset_store
      target_scopes:
        - driver
        - passenger
      parameters:
        - name: preset_name
          type: string
          required: true
          description: User-visible name of the posture preset to create or overwrite.
      risk_level: low
      confirmation_policy: on_ambiguity
    - name: seat.apply_posture_preset
      description: >-
        Apply a previously saved five-axis posture preset to one front seat. The runtime expands
        the stored FunctionPreset into the registered motion capabilities before CAN compilation.
        Use this capability only when the named preset exists in runtime conversation context.
      target_devices:
        - seat_preset_store
      target_scopes:
        - driver
        - passenger
      parameters:
        - name: preset_name
          type: string
          required: true
          description: Exact user-visible name of an existing posture preset.
      risk_level: high
      confirmation_policy: on_ambiguity