Verbs
All terms live in the bdm: namespace; the canonical id of initialized is bdm:initialized.
| Verb | Layer | Object types | Description |
|---|---|---|---|
| initialized | lifecycle | RuntimeInstance | RuntimeInstance record minted; instrument loaded; engine ready. Nothing shown yet. |
| started | lifecycle | RuntimeInstance | First content actually shown to the participant; starts the experiential clock. |
| paused | lifecycle | RuntimeInstance | RuntimeInstance suspended (extended visibility loss, idle threshold, or explicit pause). |
| resumed | lifecycle | RuntimeInstance | RuntimeInstance continued after a pause. Carries bdm:pause_duration. |
| completed | lifecycle | RuntimeInstance | All required content done. Distinct from submitted. |
| submitted | lifecycle | RuntimeInstance | Data left the engine (POST to Orchestrator acknowledged). |
| abandoned | lifecycle | RuntimeInstance | RuntimeInstance ended without completion. Carries bdm:abandon_reason. |
| presented | presentation | Screen, Panel, Stimulus, Option, Feedback, ConsentForm | Something became perceivable (rendered or played). Typically the response-time anchor for Stimulus/Option. |
| clicked | interaction | Option, UIComponent | Pointer click (mouse, tap, stylus); the lowest-level click event. |
| drag_and_dropped | interaction | Option, UIComponent | A drag-and-drop gesture completed. Carries bdm:drag_source and bdm:drop_target. |
| key_pressed | interaction | UIComponent, Stimulus | A single key event. Carries bdm:key and bdm:key_code. |
| typed | interaction | UIComponent | A text input was committed (debounced). Carries bdm:typed_text and bdm:key_sequence. |
| selected | interaction | Option, UIComponent | Discrete option selected (radio, checkbox, dropdown). |
| deselected | interaction | Option, UIComponent | Discrete option deselected (e.g. checkbox unchecked). |
| adjusted | interaction | UIComponent | A continuous-value control was set (slider, spinner, dial). Carries bdm:current_value. |
| got_focus | interaction | UIComponent, Window | Focus gained by an input control or by the runtime window/tab. |
| lost_focus | interaction | UIComponent, Window | Focus lost. Window-level loss may (by threshold) lead to bdm:paused. |
| consented | interaction | Consent | The agent committed to consent. Carries bdm:consent_text_hash and bdm:consent_scope. |
| trial_started | system | Trial | A trial began. Carries bdm:trial_index and (when applicable) bdm:block_index / bdm:block_type. |
| trial_ended | system | Trial | Trial finalised; a Response (trial) row is created. Carries the canonical response_*, response_time, correct/score, and bdm:response_id. Exactly one per trial. |
| state_changed | system | Timer, Scorer, LocaleSwitch | A software-internal state change not tied to a presentation (timer, scorer, locale switch). |
| recording_started | recording | Recording | A continuous-data recording opened. Carries bdm:source and bdm:sample_rate. |
| recording_ended | recording | Recording | A recording closed and was stored. Carries bdm:recording_url, bdm:recording_sha256, bdm:duration. |
| navigated | navigation | Screen | Participant moved between Screens. Carries bdm:from_screen_id and bdm:to_screen_id. |