motionvector.dev

music_get_state

SAFETY: read-only, changes nothing. Call this first, and again before giving advice or building a proposal, to see the actual current state of the page. Takes no arguments. Returns an object with: schemaVersion (2), capabilities (instruments supported and the guitar catalogue/tuning/capo/event bounds), revision (an integer that increments on every human or applied-agent change — pass the current value as baseRevision on music_propose_exercise), view, phase (player state machine), instrument (drums/keys/guitar), sound, bpm, exercise (the open lesson/exercise object, or null if none is open), catalog (this instrument's note names and indices), input, audioReady (whether Web Audio is already running), lastCompletedTake (the most recent completed human "Try alone" round, or null until one finishes — never a demo or partial round), pendingProposal (an escrowed proposal awaiting the human's Apply, or null), canUndoExercise (whether Undo agent exercise is available), limits (plain-text notes on what this tool never exposes), and live — the player right now: hands ({count, tracking: live/paused/off}), chordHand (guitar only: {fingers, chord, mode}, null off-guitar), instrument, pedals (guitar only: [{id, label, on, foot}]), latency ({handToSoundMs: {p50, p95, n}}), lastHits (last 8 {instrument, note|pad, source, atMs}), controller ({lastAction, lastCode, atMs, mapVersion} — the last action any programmable keypad drove through the input router, or all null before the first press), phonePedals ({connected}) when available, and round ({active, lesson, hitsCounted, hitsExpected, startedAtMs}) — while round.active is true, music_open_lesson and music_play (other than mode "stop") return a refusal instead of acting, so check it before calling either. Call this before every proposal, and read live.chordHand.fingers or live.hands after a music_focus to check whether the player is actually holding the count or chord you asked for — do not assume a focus call was followed. Guitar c…

Page: /air-instruments/

Input schema

No input properties (empty object).

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}