motionvector.dev

music_wait_for

SAFETY: read-only, changes nothing. Blocks until the requested event happens or timeoutMs elapses, whichever comes first — use this instead of polling music_get_state in a loop. take_completed: a human "Try alone" round finished scoring (resolves with the take). finger_count_stable: the chord hand's held finger count settled on a new value (resolves with {count}), guitar only. hit: any instrument note sounded (resolves with the hit). chord_changed: the guitar's selected chord/frets changed (resolves with {instrument, chord}), guitar only. pedal_toggled: a pedal was switched on or off (resolves with {id, label, on}), guitar/keys only. Returns {timedOut: true} instead if nothing happened in time — that is a normal result, not an error.

Page: /air-instruments/

Input schema

{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "event"
  ],
  "properties": {
    "event": {
      "enum": [
        "take_completed",
        "finger_count_stable",
        "hit",
        "chord_changed",
        "pedal_toggled"
      ],
      "description": "Which event to wait for: take_completed, finger_count_stable, hit, chord_changed, or pedal_toggled. Required."
    },
    "timeoutMs": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20000,
      "description": "Milliseconds to wait before giving up, 1-20000. Optional — defaults to 5000."
    }
  }
}