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

intent:
  fr: attendre qu'un etat d'ecran attendu soit atteint

executor_kind: wait_state

parameters_schema:
  expected_state:
    type: dict
    required: true
    description: criteres d'etat attendu sous forme de mapping non vide; plusieurs cles representent un AND implicite
  timeout_ms:
    type: int
    required: false
    default: 5000
    description: timeout maximal d'attente en millisecondes
    constraints:
      min: 100
      max: 60000
  poll_interval_ms:
    type: int
    required: false
    default: 250
    description: intervalle de polling en millisecondes
    constraints:
      min: 50
      max: 5000
  evidence_required:
    type: str
    required: false
    default: window_or_process
    description: niveau de preuve requis pour considerer l'etat atteint
    constraints:
      enum: [window_or_process, uia, ocr, screenshot_diff]

failure_message_template:
  intention: attendre que la fenetre ou le contenu cible apparaisse
  attendu: la fenetre ou le contenu cible doit etre visible dans le delai
  vu: "{observed_human_state}"
  demande: me montrer la fenetre ou le contenu cible, ou m'indiquer un autre marqueur visible

notes:
  - "La primitive ne fait pas l'action qui declenche l'etat. Elle attend qu'un etat survienne apres une action precedente."
  - "expected_state accepte notamment window_title_in, window_title_matches, window_title_contains, process_active, uia_anchor_present, ocr_contains et any_of."
  - "Plusieurs cles representent un AND implicite. any_of permet un OR explicite entre sous-mappings."
  - "evidence_required=window_or_process suffit pour la majorite des cas. uia, ocr et screenshot_diff sont des renforcements supervised."
  - "Aucune coordonnee ecran absolue dans expected_state."

created_at: "2026-05-28T16:35:00+02:00"