Component Catalog

Every interactive component in the app — exercises and agent tools.

Exercises

Major Scales

scales-major

Practice major scales ascending and descending with proper fingering.

key: C, G, D, A, E, B, F#, Db, Ab, Eb, Bb, F

Minor Scales

scales-minor

Practice minor scales. Natural uses the same fingering descending. Harmonic raises the 7th. Melodic raises 6th and 7th ascending, natural descending.

key: A, E, B, F#, C#, G#, D, G, C, F, Bb, Eb
type: natural, harmonic, melodic

Chords

chords

Play a chord (all notes simultaneously). Any octave accepted. Tests chord knowledge and voicing.

key: C, G, D, A, E, B, F#, Db, Ab, Eb, Bb, F
quality: major, minor

Major Arpeggios

arpeggios-major

Play major arpeggio (root, 3rd, 5th, octave) ascending and descending.

key: C, G, D, A, E, B, F#, Db, Ab, Eb, Bb, F

Chromatic Scale

chromatic-scale

Play every semitone ascending and descending. Great for finger evenness.

startNote: C, F, G

Five-Finger Pattern

five-finger-pattern

Play the first 5 notes of a major scale up and down. Builds basic finger independence.

key: C, G, D, A, E, B, F#, Db, Ab, Eb, Bb, F

Rhythm Tapping

rhythm-tapping

Tap any MIDI key in a rhythmic pattern with a metronome. Tests timing accuracy — no pitch required.

pattern: quarter, eighth, dotted-quarter, syncopated
bpm: 60, 72, 80, 96, 108, 120

Intervals

intervalsRunner only

Play the note at a given interval above a starting note. Tests interval knowledge — any octave accepted.

difficulty: easy, medium, hard
startNote: C, F, G, D, A

Cadence Patterns

cadenceRunner only

Play a chord progression in sequence. Tests functional harmony and chord transitions.

key: C, G, F, D, A, Bb, Eb
progression: I-V-I, I-IV-V-I, I-V-vi-IV, ii-V-I

Sight Reading

sight-reading

Read and play randomly generated note sequences at sight.

difficulty: easy, medium

Agent Tools

Tools available to the onboarding agent. Not directly launchable — used during AI-guided assessment.

launch_exercise

Agent-only

Launch a piano exercise for the student to play on their MIDI keyboard. Results return automatically when they finish.

exerciseId(scales-major, scales-minor, chords, arpeggios-major, chromatic-scale, five-finger-pattern, rhythm-tapping, intervals, cadence, sight-reading)
params
instructionBrief instruction shown before the exercise

ask_question

Agent-only

Ask the student a multiple-choice question. For knowledge questions, include correctIndex. For survey/preference questions (e.g. "describe your experience"), omit correctIndex.

question
options
correctIndex0-based index of correct answer. Omit for survey/preference questions where there is no right answer.
facetWhich skill dimension this question assesses

launch_exercise_set

Agent-only

Launch 2-6 exercises the student plays one after another. Use instead of multiple launch_exercise calls for focused batches (warmups, testing across keys, progressive difficulty). Returns per-exercise breakdown.

exercises
instructionOverall instruction shown at the top

complete_assessment

Agent-only

Call when confident enough in the assessment. Ends the conversation.

overallLevel
dimensions
strengths
weaknesses
recommendedBpm
startingMilestoneId
summary