apiVersion: cognitive-agent/v1alpha1
kind: CapabilityCatalog
metadata:
  id: seat-capabilities
  name: Seat capabilities
  version: 1.4.0
spec:
  domain: seat
  capabilities:
    - name: seat.set_ventilation
      description: >-
        Move air through the front-passenger seat surface to reduce local occupant heat and
        moisture; this does not control general cabin airflow. The current seat domain controls
        the front-passenger seat only.
      target_devices:
        - seat
      target_scopes:
        - 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-5 comfort level; levels 4-5 require the vehicle native-CAN backend.
          allowed_values:
            - 1
            - 2
            - 3
            - 4
            - 5
      risk_level: medium
      confirmation_policy: on_ambiguity
    - name: seat.set_heating
      description: >-
        Warm the front-passenger seat surface for local occupant thermal comfort. The current seat
        domain controls the front-passenger seat only.
      target_devices:
        - seat
      target_scopes:
        - 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-5 comfort level; levels 4-5 require the vehicle native-CAN backend.
          allowed_values:
            - 1
            - 2
            - 3
            - 4
            - 5
      risk_level: medium
      confirmation_policy: on_ambiguity
    - name: seat.set_longitudinal_position
      description: >-
        Set the front-passenger seat's fore-aft rail position. For the selected Denza N7 profile, position_pct
        is an absolute target: 0 is the forwardmost mechanical limit and 100 is the rearmost limit.
        Resolve relative requests such as "move back a little" against the current position supplied
        in runtime state: forward decreases the value and backward increases it. 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:
        - 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 front-passenger seat-cushion pitch. For the selected Denza N7 profile,
        position_pct is absolute: 0 places the front edge at its highest limit and 100 lowers the
        front edge to its lowest tilt limit.
      target_devices:
        - seat_cushion_tilt_motor
      target_scopes:
        - 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 front-passenger backrest recline. 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:
        - 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 the front-passenger 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 167 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:
        - 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: 167
          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 the front-passenger 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:
        - 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.start_dynamic_mode
      description: >-
        Start a firmware-owned cyclic four-axis trajectory on the front-passenger seat.
        Mode 1 is the short-travel rocking-horse pitch cycle; mode 2 is the long-travel
        dynamic cradle. Both use four-axis target rendezvous, repeat until explicitly
        stopped, and stop automatically when the firmware-enforced ten-minute runtime
        limit expires. A target phase faults safely if it cannot finish within its limit.
      target_devices:
        - seat_motion_controller
      target_scopes:
        - passenger
      parameters:
        - name: mode_id
          type: integer
          required: true
          description: Native dynamic mode identifier implemented by Seat_Controller_demo.
          allowed_values:
            - 1
            - 2
      risk_level: high
      confirmation_policy: on_ambiguity
    - name: seat.stop_dynamic_mode
      description: >-
        Stop whichever firmware-owned dynamic trajectory is currently running on the
        front-passenger seat. Use for natural-language stop, close, cancel, or end requests.
      target_devices:
        - seat_motion_controller
      target_scopes:
        - passenger
      parameters: []
      risk_level: low
      confirmation_policy: never
    - name: seat.save_posture_preset
      description: >-
        Save the current five-axis posture of the front-passenger 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:
        - 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 the front-passenger 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:
        - 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