schema_version: 1
id: key_combo
kind: primitive
marker_or_action: action
version: 1

intent:
  fr: enfoncer un raccourci clavier

executor_kind: key_combo

parameters_schema:
  keys:
    type: list[str]
    required_unless: [gesture_id]
    description: liste de touches normalisees
    constraints:
      min_length: 1
  gesture_id:
    type: str
    required_unless: [keys]
    description: reference vers un Gesture du catalogue
    constraints:
      regex: "^[a-z][a-z0-9_]*$"
  context_guard:
    type: dict
    required: false
    description: precondition d'ecran avant envoi
  expected_effect:
    type: str
    required: false
    description: effet observable attendu par la competence appelante

failure_message_template:
  intention: enfoncer le raccourci clavier attendu
  attendu: la fenetre active doit reagir au raccourci
  vu: "{observed_human_state}"
  demande: confirmer que la fenetre attendue est bien au premier plan, ou indiquer un autre raccourci

notes:
  - "La primitive ne controle pas le focus. La competence appelante doit le garantir via precondition."
  - "Utiliser keys ou gesture_id, pas les deux."
  - "Le raccourci s'envoie tel quel. Pas de retry ni fallback dans la primitive."

created_at: "2026-05-28T10:25:00+02:00"