Skip to main content
Glama

Edit score

edit_score
Destructive

Apply one reversible score edit. Invalid IDs and stale edits are refused. A pitch edit with request_id can use an older revision of a notation-played score without repeats when its bars and dependencies are unchanged. Re-engraving and whole-score rhythm edits replace note IDs. No credits.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "score_id": "<score_id>",
      "revision": "<revision>",
      "operation": "<operation>"
    },
    "name": "edit_score"
  }
}

Input Schema

NameRequiredDescriptionDefault
revisionYes
score_idYes
operationYesGive one action (? optional): entry: create_tuplet {note_id,actual 2..9,normal?}; rewrite_tuplet {note_id,pattern:three_equal|long_short|short_long|one_note|one_rest OR written_quarters (written before 3:2)} keeps its span; one_note needs a first attack and rests; replace_note {note_id,pitch|null,spelling?} keeps its slot; remove_tuplet {note_id} expands into following rests; paste_notes {source_note_ids,target_note_id} copies a whole span or a chord/rest to another slot in the same triplet, keeping target rhythm; set_tie {note_ids:[start,end],enabled}; set_slur {note_ids:[start,end],enabled}; reflow_layout {}. notes: set_pitch {note_ids,pitch,spelling?} (nearest octave if omitted: B4 -> C5, not C4; respect direction and say the pitch written); transpose {note_ids,semitones}; set_duration {note_ids,quarters} (one note, tied pair or chord); move_notes {note_ids,quarters ±} (any notes of one part, each in its voice); time: shift_time {measure,onset? quarters from bar start|note_id,quarters ±,part_id?,staff?} shifts later attacks; negative removes beats before the point and empty tail bars. voices: set_voice {note_ids,voice 1..4 on their staff}; set_tie also between voices; set_beam {note_ids,beam join|break|none|auto}; set_stem {note_ids,stem up|down|flip|auto}; set_visibility {note_ids (rests)|measures,staff?,visible}. batch {operations:[...up to 30 of the note, time, voice and bar edits]}: one version, all or none. delete_notes {note_ids} turns sounding notes into rests and clears selected rest symbols, moving no later note; set_staff {note_ids|select,staff 1 upper|2 lower,clef? if asked}; add_chord_tone {note_id,pitch,spelling?,velocity?}; fill_rest {rest_id,pitch,quarters?,velocity?,spelling?}. sound: set_velocity {note_ids,velocity 1..127}; set_dynamic {note_id,mark ppp..fff|sf|sfz|fp,velocity?}; set_timbre {part_id,program,part_name?}; delete_part {part_id} (not the last part); share_staff {part_ids 2..4 adjacent,shared} (合谱). writing: set_key {part_id?,fifths,mode} (respells without repitching); set_clef {part_id?,staff?,clef,measures?} (no measures: the whole staff; "4": from bar 4 to the staff's next clef change; "4-6": those bars only); set_harmony_position {part_id,measure,index from 0,quarters from bar start}; engraving {title?,composer?,transcriber?,labels?:compact|full|none,page_size?:a4|letter} (paper reflows pages and PDF); rebeam {}; reengrave {key?,program?,staff_split?,voices?,grid?,line?:single} (from recording; IDs can change). page layout, all views: layout {bars_per_system? 1..32,system_breaks? ["bar"],page_breaks? ["bar"],staff_size? 50..150 %,staff_spacing? 0..48,system_spacing? 0..48,lyric_spacing? -1..5 mm,reset?:true}; null resets one field. Only breaks in edited MusicXML are read. TAB: set_tablature {part_id?,view off|both|tab,tuning?,capo?,strings?}; set_string {note_ids,string|null}; set_fret {note_ids,string,fret}; set_chord_frets {note_id,frets} top TAB line first (0 open, null leaves string alone); set_chord_tie {note_ids:[start,end],enabled} one ID from each matching adjacent chord. marks (saved score marks; kind words|rehearsal|metronome|dynamic|hairpin|fermata|octave (8va|8vb|15ma|15mb, note_id through end_note_id)): add_mark {kind,note_id|part_id+measure+quarters,text?,value?,end_note_id?,placement?}; update_mark {mark_id,kind?,text?,value?,placement?,offset_y? (fermata height in tenths; +10 up one space, 0 resets)}; move_mark {mark_id,note_id?,end_note_id?}; delete_mark {mark_id}. whole score: transpose_score {interval as M2, -m3 or P8}; set_meter {beats,beat_type,pickup_quarters?}; scale_note_values {factor:2|0.5}; rewrite_rhythm {bpm,beats,beat_type,downbeat? second a bar starts: bars start there} (steady recording); rebeat {bpm,beats,beat_type,downbeat seconds,swing? 0.5..0.75} (wrong tracked piano beat); rebar_pickup {quarters}; set_pickup {enabled} (marks a short first bar, moves no barline); pad_measure {part_id,measure}; repair_bindings {}; undo {}; redo {}. bars (every part; numbers as printed): insert_measures {before "bar"|null=at end,count? 1..16}; delete_measures {from,to?}. recording alignment: set_recording_alignment {measure_id,visit?:1,anchors:[[zero-based quarter beats within bar,recording seconds],...]} (2..64 increasing points; [] clears). Only for comparison/listening.
request_idNoA stable ID (16 to 80 letters, digits or hyphens); send the same one again after an unclear response. For pitch edits with 1 to 64 note IDs or chord edits at the current revision.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • changedInput schema / properties / operation / description
      Previous value: -"For a fermata, update_mark {mark_id,offset_y} adjusts printed height in tenths (+10 = one staff space up; 0 resets); notes and playback stay.\nOne object naming its action. Actions and their fields (? optional):\nentry: create_tuplet {note_id,actual 2..9,normal?}; replace_note {note_id,pitch|null,spelling?} (keeps exact slot); remove_tuplet {note_id} (needs following rests); paste_notes {source_note_ids,target_note_id} (complete groups, one part); set_tie {note_ids:[start,end],enabled} (adjacent equal pitches); set_slur {note_ids:[start,end],enabled} (printed); reflow_layout {}.\nnotes: set_pitch {note_ids,pitch,spelling?} (a pitch named without its octave, \"make it C\", is the one nearest the note's current pitch: B4 -> C5, not C4; in the direction asked if any; say the pitch written); transpose {note_ids,semitones}; set_duration {note_ids,quarters} (one note, tied pair or chord); move_notes {note_ids,quarters ±} (any notes of one part, each in its voice);\ntime: shift_time {measure,onset? quarters from bar start|note_id,quarters ±,part_id?,staff?} moves everything struck from that point on later or earlier (a late or early entry: one call, not note by note); earlier removes the beats just before the point and bars at the end it leaves empty.\nvoices: set_voice {note_ids,voice 1..4 on their staff}; set_tie also between voices; set_beam {note_ids,beam join|break|none|auto}; set_stem {note_ids,stem up|down|flip|auto}; set_visibility {note_ids (rests)|measures,staff?,visible}.\nbatch {operations:[...up to 30 of the note, time, voice and bar edits]}: one version, all or none.\ndelete_notes {note_ids} turns sounding notes into rests and clears selected rest symbols, moving no later note; set_staff {note_ids|select,staff 1 upper|2 lower,clef? if asked} (hands); add_chord_tone {note_id,pitch,spelling?,velocity?}; fill_rest {rest_id,pitch,quarters?,velocity?,spelling?}.\nsound: set_velocity {note_ids,velocity 1..127}; set_dynamic {note_id,mark ppp..fff|sf|sfz|fp,velocity?}; set_timbre {part_id,program,part_name?}; delete_part {part_id} (not the last part); share_staff {part_ids 2..4 adjacent,shared} (合谱).\nwriting: set_key {part_id?,fifths,mode} (respells the notes the key holds; pitches stay); set_clef {part_id?,staff?,clef,measures?} (no measures: the whole staff; \"4\": from bar 4 to the staff's next clef change; \"4-6\": those bars only); set_harmony_position {part_id,measure,index from 0,quarters from bar start};\nengraving {title?,composer?,transcriber?,labels?:compact|full|none,page_size?:a4|letter} (paper size reflows pages and PDF, keeps notes, may not fit one page); rebeam {}; reengrave {key?,program?,staff_split?,voices?,grid?,line?:single} (writes the notes again from the recording: rhythm spelling, voices and note IDs can change; not for page layout).\npage layout (every view, jianpu and PDF; notes and playback stay): layout {bars_per_system? 1..32, system_breaks? [\"bar\"] (start a line), page_breaks? [\"bar\"] (start a page), staff_size? 50..150 (%), staff_spacing? 0..48, system_spacing? 0..48 (default 8), lyric_spacing? -1..5 (mm lower), reset?:true}; null resets one field. The overview's layout lists each page's lines; check pages with review_score. MusicXML <print>/<scaling> are not read, except breaks in edited MusicXML.\nTAB: set_tablature {part_id?,view off|both|tab,tuning?,capo?,strings?}; set_string {note_ids,string|null} (1 = the top line); set_fret {note_ids,string,fret}.\nmarks (saved score marks; kind words|rehearsal|metronome|dynamic|hairpin|fermata|octave (8va|8vb|15ma|15mb, note_id through end_note_id)): add_mark {kind,note_id|part_id+measure+quarters,text?,value?,end_note_id?,placement?}; update_mark {mark_id,kind?,text?,value?,placement?}; move_mark {mark_id,note_id?,end_note_id?}; delete_mark {mark_id}.\nwhole score: transpose_score {interval as M2, -m3 or P8}; set_meter {beats,beat_type,pickup_quarters?}; scale_note_values {factor:2|0.5}; rewrite_rhythm {bpm,beats,beat_type,downbeat? second a bar starts: bars start there} (steady recording); rebeat {bpm,beats,beat_type,downbeat seconds,swing? 0.5..0.75} (wrong tracked piano beat);\nrebar_pickup {quarters}; set_pickup {enabled} (marks a short first bar, moves no barline); pad_measure {part_id,measure}; repair_bindings {}; undo {}; redo {}.\nbars (every part; numbers as printed): insert_measures {before \"bar\"|null=at end,count? 1..16}; delete_measures {from,to?}.\nrecording alignment: set_recording_alignment {measure_id,visit?:1,anchors:[[zero-based quarter beats within bar,recording seconds],...]} (2..64 increasing points; [] clears). This affects comparison/listening, not written music or ordinary score playback."New value: +"Give one action (? optional):\nentry: create_tuplet {note_id,actual 2..9,normal?}; rewrite_tuplet {note_id,pattern:three_equal|long_short|short_long|one_note|one_rest OR written_quarters (written before 3:2)} keeps its span; one_note needs a first attack and rests; replace_note {note_id,pitch|null,spelling?} keeps its slot; remove_tuplet {note_id} expands into following rests; paste_notes {source_note_ids,target_note_id} copies a whole span or a chord/rest to another slot in the same triplet, keeping target rhythm; set_tie {note_ids:[start,end],enabled}; set_slur {note_ids:[start,end],enabled}; reflow_layout {}.\nnotes: set_pitch {note_ids,pitch,spelling?} (nearest octave if omitted: B4 -> C5, not C4; respect direction and say the pitch written); transpose {note_ids,semitones}; set_duration {note_ids,quarters} (one note, tied pair or chord); move_notes {note_ids,quarters ±} (any notes of one part, each in its voice);\ntime: shift_time {measure,onset? quarters from bar start|note_id,quarters ±,part_id?,staff?} shifts later attacks; negative removes beats before the point and empty tail bars.\nvoices: set_voice {note_ids,voice 1..4 on their staff}; set_tie also between voices; set_beam {note_ids,beam join|break|none|auto}; set_stem {note_ids,stem up|down|flip|auto}; set_visibility {note_ids (rests)|measures,staff?,visible}.\nbatch {operations:[...up to 30 of the note, time, voice and bar edits]}: one version, all or none.\ndelete_notes {note_ids} turns sounding notes into rests and clears selected rest symbols, moving no later note; set_staff {note_ids|select,staff 1 upper|2 lower,clef? if asked}; add_chord_tone {note_id,pitch,spelling?,velocity?}; fill_rest {rest_id,pitch,quarters?,velocity?,spelling?}.\nsound: set_velocity {note_ids,velocity 1..127}; set_dynamic {note_id,mark ppp..fff|sf|sfz|fp,velocity?}; set_timbre {part_id,program,part_name?}; delete_part {part_id} (not the last part); share_staff {part_ids 2..4 adjacent,shared} (合谱).\nwriting: set_key {part_id?,fifths,mode} (respells without repitching); set_clef {part_id?,staff?,clef,measures?} (no measures: the whole staff; \"4\": from bar 4 to the staff's next clef change; \"4-6\": those bars only); set_harmony_position {part_id,measure,index from 0,quarters from bar start};\nengraving {title?,composer?,transcriber?,labels?:compact|full|none,page_size?:a4|letter} (paper reflows pages and PDF); rebeam {}; reengrave {key?,program?,staff_split?,voices?,grid?,line?:single} (from recording; IDs can change).\npage layout, all views: layout {bars_per_system? 1..32,system_breaks? [\"bar\"],page_breaks? [\"bar\"],staff_size? 50..150 %,staff_spacing? 0..48,system_spacing? 0..48,lyric_spacing? -1..5 mm,reset?:true}; null resets one field. Only breaks in edited MusicXML are read.\nTAB: set_tablature {part_id?,view off|both|tab,tuning?,capo?,strings?}; set_string {note_ids,string|null}; set_fret {note_ids,string,fret}; set_chord_frets {note_id,frets} top TAB line first (0 open, null leaves string alone); set_chord_tie {note_ids:[start,end],enabled} one ID from each matching adjacent chord.\nmarks (saved score marks; kind words|rehearsal|metronome|dynamic|hairpin|fermata|octave (8va|8vb|15ma|15mb, note_id through end_note_id)): add_mark {kind,note_id|part_id+measure+quarters,text?,value?,end_note_id?,placement?}; update_mark {mark_id,kind?,text?,value?,placement?,offset_y? (fermata height in tenths; +10 up one space, 0 resets)}; move_mark {mark_id,note_id?,end_note_id?}; delete_mark {mark_id}.\nwhole score: transpose_score {interval as M2, -m3 or P8}; set_meter {beats,beat_type,pickup_quarters?}; scale_note_values {factor:2|0.5}; rewrite_rhythm {bpm,beats,beat_type,downbeat? second a bar starts: bars start there} (steady recording); rebeat {bpm,beats,beat_type,downbeat seconds,swing? 0.5..0.75} (wrong tracked piano beat);\nrebar_pickup {quarters}; set_pickup {enabled} (marks a short first bar, moves no barline); pad_measure {part_id,measure}; repair_bindings {}; undo {}; redo {}.\nbars (every part; numbers as printed): insert_measures {before \"bar\"|null=at end,count? 1..16}; delete_measures {from,to?}.\nrecording alignment: set_recording_alignment {measure_id,visit?:1,anchors:[[zero-based quarter beats within bar,recording seconds],...]} (2..64 increasing points; [] clears). Only for comparison/listening."
    • addedInput schema / properties / request_id
      Added value: +{
      +  "description": "A stable ID (16 to 80 letters, digits or hyphens); send the same one again after an unclear response. For pitch edits with 1 to 64 note IDs or chord edits at the current revision.",
      +  "type": "string"
      +}
  2. Changed1 schema field changed
    • changedInput schema / properties / operation / description
      Previous value: -"For a fermata, update_mark {mark_id,offset_y} adjusts printed height in tenths (+10 = one staff space up; 0 resets); notes and playback stay unchanged.\nOne object naming its action. Actions and their fields (? optional):\nentry: create_tuplet {note_id,actual 2..9,normal?}; replace_note {note_id,pitch|null,spelling?} (keeps exact slot); remove_tuplet {note_id} (needs following rests); paste_notes {source_note_ids,target_note_id} (complete groups, one part); set_tie {note_ids:[start,end],enabled} (adjacent equal pitches, held sound); set_slur {note_ids:[start,end],enabled} (printed); reflow_layout {}.\nnotes: set_pitch {note_ids,pitch,spelling?} (a pitch named without its octave, \"make it C\", is the one nearest the note's current pitch: B4 -> C5, not C4; in the direction asked if any; say the pitch written); transpose {note_ids,semitones}; set_duration {note_ids,quarters} (one note, tied pair or chord); move_notes {note_ids,quarters ±} (any notes of one part, each in its voice);\ntime: shift_time {measure,onset? quarters from bar start|note_id,quarters ±,part_id?,staff?} moves everything struck from that point on later or earlier (a late or early entry: one call, not note by note); earlier removes the beats just before the point and bars at the end it leaves empty.\nvoices: set_voice {note_ids,voice 1..4 on their staff}; set_tie also between voices; set_beam {note_ids,beam join|break|none|auto}; set_stem {note_ids,stem up|down|flip|auto}; set_visibility {note_ids (rests)|measures,staff?,visible}.\nbatch {operations:[...up to 30 of the note, time, voice and bar edits]}: one version, all or none.\ndelete_notes {note_ids} replaces sounding notes with rests and clears selected rest symbols without shifting later notes; set_staff {note_ids|select,staff 1 upper|2 lower,clef? if asked} (hands); add_chord_tone {note_id,pitch,spelling?,velocity?}; fill_rest {rest_id,pitch,quarters?,velocity?,spelling?}.\nsound: set_velocity {note_ids,velocity 1..127}; set_dynamic {note_id,mark ppp..fff|sf|sfz|fp,velocity?}; set_timbre {part_id,program,part_name?}.\nwriting: set_key {part_id?,fifths,mode} (respells the notes the key holds; pitches stay); set_clef {part_id?,staff?,clef,measures?} (no measures: the whole staff; \"4\": from bar 4 to the staff's next clef change; \"4-6\": those bars only); set_harmony_position {part_id,measure,index from 0,quarters from bar start};\nengraving {title?,composer?,transcriber?,labels?:compact|full|none,page_size?:a4|letter} (paper size reflows this score and its PDF, preserves notes, does not guarantee one page); rebeam {}; reengrave {key?,program?,staff_split?,voices?,grid?,line?:single} (writes the notes again from the recording: rhythm spelling, voices and note IDs can change; not for page layout).\npage layout (pages, PDF and panel; notes and playback stay): layout {bars_per_system? 1..32, system_breaks? [\"bar\"] (start a line), page_breaks? [\"bar\"] (start a page), staff_size? 50..150 (% of default; smaller fits more per page), staff_spacing? 0..48, system_spacing? 0..48 (default 8), reset?:true}; null resets one field. The overview's layout lists each page's lines; check pages with review_score. MusicXML <print>/<scaling> are not read, except breaks in edited MusicXML.\nTAB: set_tablature {part_id?,view off|both|tab,tuning?,capo?,strings?}; set_string {note_ids,string|null} (1 = the top line); set_fret {note_ids,string,fret}.\nmarks (saved score marks; kind words|rehearsal|metronome|dynamic|hairpin|fermata|octave (8va|8vb|15ma|15mb, note_id through end_note_id)): add_mark {kind,note_id|part_id+measure+quarters,text?,value?,end_note_id?,placement?}; update_mark {mark_id,kind?,text?,value?,placement?}; move_mark {mark_id,note_id?,end_note_id?}; delete_mark {mark_id}.\nwhole score: transpose_score {interval as M2, -m3 or P8}; set_meter {beats,beat_type,pickup_quarters?}; scale_note_values {factor:2|0.5}; rewrite_rhythm {bpm,beats,beat_type,downbeat? second a bar starts: bars start there} (steady recording); rebeat {bpm,beats,beat_type,downbeat seconds,swing? 0.5..0.75} (wrong tracked piano beat);\nrebar_pickup {quarters}; set_pickup {enabled} (marks a short first bar, moves no barline); pad_measure {part_id,measure}; repair_bindings {}; undo {}; redo {}.\nbars (every part; numbers as printed): insert_measures {before \"bar\"|null=at end,count? 1..16}; delete_measures {from,to?}.\nrecording alignment: set_recording_alignment {measure_id,visit?:1,anchors:[[zero-based quarter beats within bar,recording seconds],...]} (2..64 increasing points; [] clears). This affects comparison/listening, not written music or ordinary score playback."New value: +"For a fermata, update_mark {mark_id,offset_y} adjusts printed height in tenths (+10 = one staff space up; 0 resets); notes and playback stay.\nOne object naming its action. Actions and their fields (? optional):\nentry: create_tuplet {note_id,actual 2..9,normal?}; replace_note {note_id,pitch|null,spelling?} (keeps exact slot); remove_tuplet {note_id} (needs following rests); paste_notes {source_note_ids,target_note_id} (complete groups, one part); set_tie {note_ids:[start,end],enabled} (adjacent equal pitches); set_slur {note_ids:[start,end],enabled} (printed); reflow_layout {}.\nnotes: set_pitch {note_ids,pitch,spelling?} (a pitch named without its octave, \"make it C\", is the one nearest the note's current pitch: B4 -> C5, not C4; in the direction asked if any; say the pitch written); transpose {note_ids,semitones}; set_duration {note_ids,quarters} (one note, tied pair or chord); move_notes {note_ids,quarters ±} (any notes of one part, each in its voice);\ntime: shift_time {measure,onset? quarters from bar start|note_id,quarters ±,part_id?,staff?} moves everything struck from that point on later or earlier (a late or early entry: one call, not note by note); earlier removes the beats just before the point and bars at the end it leaves empty.\nvoices: set_voice {note_ids,voice 1..4 on their staff}; set_tie also between voices; set_beam {note_ids,beam join|break|none|auto}; set_stem {note_ids,stem up|down|flip|auto}; set_visibility {note_ids (rests)|measures,staff?,visible}.\nbatch {operations:[...up to 30 of the note, time, voice and bar edits]}: one version, all or none.\ndelete_notes {note_ids} turns sounding notes into rests and clears selected rest symbols, moving no later note; set_staff {note_ids|select,staff 1 upper|2 lower,clef? if asked} (hands); add_chord_tone {note_id,pitch,spelling?,velocity?}; fill_rest {rest_id,pitch,quarters?,velocity?,spelling?}.\nsound: set_velocity {note_ids,velocity 1..127}; set_dynamic {note_id,mark ppp..fff|sf|sfz|fp,velocity?}; set_timbre {part_id,program,part_name?}; delete_part {part_id} (not the last part); share_staff {part_ids 2..4 adjacent,shared} (合谱).\nwriting: set_key {part_id?,fifths,mode} (respells the notes the key holds; pitches stay); set_clef {part_id?,staff?,clef,measures?} (no measures: the whole staff; \"4\": from bar 4 to the staff's next clef change; \"4-6\": those bars only); set_harmony_position {part_id,measure,index from 0,quarters from bar start};\nengraving {title?,composer?,transcriber?,labels?:compact|full|none,page_size?:a4|letter} (paper size reflows pages and PDF, keeps notes, may not fit one page); rebeam {}; reengrave {key?,program?,staff_split?,voices?,grid?,line?:single} (writes the notes again from the recording: rhythm spelling, voices and note IDs can change; not for page layout).\npage layout (every view, jianpu and PDF; notes and playback stay): layout {bars_per_system? 1..32, system_breaks? [\"bar\"] (start a line), page_breaks? [\"bar\"] (start a page), staff_size? 50..150 (%), staff_spacing? 0..48, system_spacing? 0..48 (default 8), lyric_spacing? -1..5 (mm lower), reset?:true}; null resets one field. The overview's layout lists each page's lines; check pages with review_score. MusicXML <print>/<scaling> are not read, except breaks in edited MusicXML.\nTAB: set_tablature {part_id?,view off|both|tab,tuning?,capo?,strings?}; set_string {note_ids,string|null} (1 = the top line); set_fret {note_ids,string,fret}.\nmarks (saved score marks; kind words|rehearsal|metronome|dynamic|hairpin|fermata|octave (8va|8vb|15ma|15mb, note_id through end_note_id)): add_mark {kind,note_id|part_id+measure+quarters,text?,value?,end_note_id?,placement?}; update_mark {mark_id,kind?,text?,value?,placement?}; move_mark {mark_id,note_id?,end_note_id?}; delete_mark {mark_id}.\nwhole score: transpose_score {interval as M2, -m3 or P8}; set_meter {beats,beat_type,pickup_quarters?}; scale_note_values {factor:2|0.5}; rewrite_rhythm {bpm,beats,beat_type,downbeat? second a bar starts: bars start there} (steady recording); rebeat {bpm,beats,beat_type,downbeat seconds,swing? 0.5..0.75} (wrong tracked piano beat);\nrebar_pickup {quarters}; set_pickup {enabled} (marks a short first bar, moves no barline); pad_measure {part_id,measure}; repair_bindings {}; undo {}; redo {}.\nbars (every part; numbers as printed): insert_measures {before \"bar\"|null=at end,count? 1..16}; delete_measures {from,to?}.\nrecording alignment: set_recording_alignment {measure_id,visit?:1,anchors:[[zero-based quarter beats within bar,recording seconds],...]} (2..64 increasing points; [] clears). This affects comparison/listening, not written music or ordinary score playback."
  3. Changed1 schema field changed
    • changedInput schema / properties / operation / description
      Previous value: -"For a fermata, update_mark {mark_id,offset_y} adjusts printed height in tenths (+10 = one staff space up; 0 resets); notes and playback stay unchanged.\nOne object naming its action. Actions and their fields (? optional):\nentry: create_tuplet {note_id,actual 2..9,normal?}; replace_note {note_id,pitch|null,spelling?} (keeps exact slot); remove_tuplet {note_id} (needs following rests); paste_notes {source_note_ids,target_note_id} (complete groups, one part); set_tie {note_ids:[start,end],enabled} (adjacent equal pitches, held sound); set_slur {note_ids:[start,end],enabled} (printed); reflow_layout {}.\nnotes: set_pitch {note_ids,pitch,spelling?} (a pitch named without its octave, \"make it C\", is the one nearest the note's current pitch: B4 -> C5, not C4; in the direction asked if any; say the pitch written); transpose {note_ids,semitones}; set_duration {note_ids,quarters} (one note, tied pair or chord); move_notes {note_ids,quarters ±} (any notes of one part, each in its voice);\ntime: shift_time {measure,onset? quarters from bar start|note_id,quarters ±,part_id?,staff?} moves everything struck from that point on later or earlier (a late or early entry: one call, not note by note); earlier removes the beats just before the point and bars at the end it leaves empty.\nvoices: set_voice {note_ids,voice 1..4 on their staff}; set_tie also between voices; set_beam {note_ids,beam join|break|none|auto}; set_stem {note_ids,stem up|down|flip|auto}; set_visibility {note_ids (rests)|measures,staff?,visible}.\nbatch {operations:[...up to 30 of the note, time, voice and bar edits]}: one version, all or none.\ndelete_notes {note_ids} replaces sounding notes with rests and clears selected rest symbols without shifting later notes; set_staff {note_ids|select,staff 1 upper|2 lower,clef? if asked} (hands); add_chord_tone {note_id,pitch,spelling?,velocity?}; fill_rest {rest_id,pitch,quarters?,velocity?,spelling?}.\nsound: set_velocity {note_ids,velocity 1..127}; set_dynamic {note_id,mark ppp..fff|sf|sfz|fp,velocity?}; set_timbre {part_id,program,part_name?}.\nwriting: set_key {part_id?,fifths,mode} (respells the notes the key holds; pitches stay); set_clef {part_id?,staff?,clef,measures?} (no measures: the whole staff; \"4\": from bar 4 to the staff's next clef change; \"4-6\": those bars only); set_harmony_position {part_id,measure,index from 0,quarters from bar start};\nengraving {title?,composer?,transcriber?,labels?:compact|full|none,page_size?:a4|letter} (paper size reflows this score and its PDF, preserves notes, does not guarantee one page); rebeam {}; reengrave {key?,program?,staff_split?,voices?,grid?,line?:single} (writes the notes again from the recording: rhythm spelling, voices and note IDs can change; not for page layout).\npage layout (pages, PDF and panel; notes and playback stay): layout {bars_per_system? 1..32, system_breaks? [\"bar\"] (start a line), page_breaks? [\"bar\"] (start a page), staff_size? 50..150 (% of default; smaller fits more per page), staff_spacing? 0..48, system_spacing? 0..48 (default 8), reset?:true}; null resets one field. The overview's layout lists each page's lines; check pages with review_score. MusicXML <print>/<scaling> are not read, except breaks in edited MusicXML.\nTAB: set_tablature {part_id?,view off|both|tab,tuning?,capo?,strings?}; set_string {note_ids,string|null} (1 = the top line); set_fret {note_ids,string,fret}.\nmarks (saved score marks; kind words|rehearsal|metronome|dynamic|hairpin|fermata|octave (8va|8vb|15ma|15mb, note_id through end_note_id)): add_mark {kind,note_id|part_id+measure+quarters,text?,value?,end_note_id?,placement?}; update_mark {mark_id,kind?,text?,value?,placement?}; move_mark {mark_id,note_id?,end_note_id?}; delete_mark {mark_id}.\nwhole score: transpose_score {interval}; set_meter {beats,beat_type,pickup_quarters?}; scale_note_values {factor:2|0.5}; rewrite_rhythm {bpm,beats,beat_type,downbeat? second a bar starts: bars start there} (steady recording); rebeat {bpm,beats,beat_type,downbeat seconds,swing? 0.5..0.75} (wrong tracked piano beat);\nrebar_pickup {quarters}; set_pickup {enabled} (marks a short first bar, moves no barline); pad_measure {part_id,measure}; repair_bindings {}; undo {}; redo {}.\nbars (every part; numbers as printed): insert_measures {before \"bar\"|null=at end,count? 1..16}; delete_measures {from,to?}.\nrecording alignment: set_recording_alignment {measure_id,visit?:1,anchors:[[zero-based quarter beats within bar,recording seconds],...]} (2..64 increasing points; [] clears). This affects comparison/listening, not written music or ordinary score playback."New value: +"For a fermata, update_mark {mark_id,offset_y} adjusts printed height in tenths (+10 = one staff space up; 0 resets); notes and playback stay unchanged.\nOne object naming its action. Actions and their fields (? optional):\nentry: create_tuplet {note_id,actual 2..9,normal?}; replace_note {note_id,pitch|null,spelling?} (keeps exact slot); remove_tuplet {note_id} (needs following rests); paste_notes {source_note_ids,target_note_id} (complete groups, one part); set_tie {note_ids:[start,end],enabled} (adjacent equal pitches, held sound); set_slur {note_ids:[start,end],enabled} (printed); reflow_layout {}.\nnotes: set_pitch {note_ids,pitch,spelling?} (a pitch named without its octave, \"make it C\", is the one nearest the note's current pitch: B4 -> C5, not C4; in the direction asked if any; say the pitch written); transpose {note_ids,semitones}; set_duration {note_ids,quarters} (one note, tied pair or chord); move_notes {note_ids,quarters ±} (any notes of one part, each in its voice);\ntime: shift_time {measure,onset? quarters from bar start|note_id,quarters ±,part_id?,staff?} moves everything struck from that point on later or earlier (a late or early entry: one call, not note by note); earlier removes the beats just before the point and bars at the end it leaves empty.\nvoices: set_voice {note_ids,voice 1..4 on their staff}; set_tie also between voices; set_beam {note_ids,beam join|break|none|auto}; set_stem {note_ids,stem up|down|flip|auto}; set_visibility {note_ids (rests)|measures,staff?,visible}.\nbatch {operations:[...up to 30 of the note, time, voice and bar edits]}: one version, all or none.\ndelete_notes {note_ids} replaces sounding notes with rests and clears selected rest symbols without shifting later notes; set_staff {note_ids|select,staff 1 upper|2 lower,clef? if asked} (hands); add_chord_tone {note_id,pitch,spelling?,velocity?}; fill_rest {rest_id,pitch,quarters?,velocity?,spelling?}.\nsound: set_velocity {note_ids,velocity 1..127}; set_dynamic {note_id,mark ppp..fff|sf|sfz|fp,velocity?}; set_timbre {part_id,program,part_name?}.\nwriting: set_key {part_id?,fifths,mode} (respells the notes the key holds; pitches stay); set_clef {part_id?,staff?,clef,measures?} (no measures: the whole staff; \"4\": from bar 4 to the staff's next clef change; \"4-6\": those bars only); set_harmony_position {part_id,measure,index from 0,quarters from bar start};\nengraving {title?,composer?,transcriber?,labels?:compact|full|none,page_size?:a4|letter} (paper size reflows this score and its PDF, preserves notes, does not guarantee one page); rebeam {}; reengrave {key?,program?,staff_split?,voices?,grid?,line?:single} (writes the notes again from the recording: rhythm spelling, voices and note IDs can change; not for page layout).\npage layout (pages, PDF and panel; notes and playback stay): layout {bars_per_system? 1..32, system_breaks? [\"bar\"] (start a line), page_breaks? [\"bar\"] (start a page), staff_size? 50..150 (% of default; smaller fits more per page), staff_spacing? 0..48, system_spacing? 0..48 (default 8), reset?:true}; null resets one field. The overview's layout lists each page's lines; check pages with review_score. MusicXML <print>/<scaling> are not read, except breaks in edited MusicXML.\nTAB: set_tablature {part_id?,view off|both|tab,tuning?,capo?,strings?}; set_string {note_ids,string|null} (1 = the top line); set_fret {note_ids,string,fret}.\nmarks (saved score marks; kind words|rehearsal|metronome|dynamic|hairpin|fermata|octave (8va|8vb|15ma|15mb, note_id through end_note_id)): add_mark {kind,note_id|part_id+measure+quarters,text?,value?,end_note_id?,placement?}; update_mark {mark_id,kind?,text?,value?,placement?}; move_mark {mark_id,note_id?,end_note_id?}; delete_mark {mark_id}.\nwhole score: transpose_score {interval as M2, -m3 or P8}; set_meter {beats,beat_type,pickup_quarters?}; scale_note_values {factor:2|0.5}; rewrite_rhythm {bpm,beats,beat_type,downbeat? second a bar starts: bars start there} (steady recording); rebeat {bpm,beats,beat_type,downbeat seconds,swing? 0.5..0.75} (wrong tracked piano beat);\nrebar_pickup {quarters}; set_pickup {enabled} (marks a short first bar, moves no barline); pad_measure {part_id,measure}; repair_bindings {}; undo {}; redo {}.\nbars (every part; numbers as printed): insert_measures {before \"bar\"|null=at end,count? 1..16}; delete_measures {from,to?}.\nrecording alignment: set_recording_alignment {measure_id,visit?:1,anchors:[[zero-based quarter beats within bar,recording seconds],...]} (2..64 increasing points; [] clears). This affects comparison/listening, not written music or ordinary score playback."
  4. Changed1 schema field changed
    • changedInput schema / properties / operation / description
      Previous value: -"For a fermata, update_mark {mark_id,offset_y} adjusts printed height in tenths (+10 = one staff space up; 0 resets); notes and playback stay unchanged.\nOne object naming its action. Actions and their fields (? optional):\nentry: create_tuplet {note_id,actual 2..9,normal?}; replace_note {note_id,pitch|null,spelling?} (keeps exact slot); remove_tuplet {note_id} (needs following rests); paste_notes {source_note_ids,target_note_id} (complete groups, one part); set_tie {note_ids:[start,end],enabled} (adjacent equal pitches, held sound); set_slur {note_ids:[start,end],enabled} (printed); reflow_layout {}.\nnotes: set_pitch {note_ids,pitch,spelling?}; transpose {note_ids,semitones}; set_duration {note_ids,quarters} (one note, tied pair or chord); move_notes {note_ids,quarters ±} (any notes of one part, each in its voice);\ntime: shift_time {measure,onset? quarters from bar start|note_id,quarters ±,part_id?,staff?} moves everything struck from that point on later or earlier (a late or early entry: one call, not note by note); earlier removes the beats just before the point and bars at the end it leaves empty.\nvoices: set_voice {note_ids,voice 1..4 on their staff}; set_tie {note_ids:[start,end],enabled} also between voices; set_beam {note_ids,beam join|break|none|auto}; set_stem {note_ids,stem up|down|flip|auto}; set_visibility {note_ids (rests)|measures,staff?,visible}.\nbatch {operations:[...up to 30 of the note, time, voice and bar edits]}: one version, all or none.\ndelete_notes {note_ids} replaces sounding notes with rests and clears selected rest symbols without shifting later notes; set_staff {note_ids|select,staff 1 upper|2 lower,clef? if asked} (hands); add_chord_tone {note_id,pitch,spelling?,velocity?}; fill_rest {rest_id,pitch,quarters?,velocity?,spelling?}.\nsound: set_velocity {note_ids,velocity 1..127}; set_dynamic {note_id,mark ppp..fff|sf|sfz|fp,velocity?}; set_timbre {part_id,program,part_name?}.\nwriting: set_key {part_id?,fifths,mode} (respells the notes the key holds; pitches stay); set_clef {part_id?,staff?,clef,measures?} (no measures: the whole staff; \"4\": from bar 4 to the staff's next clef change; \"4-6\": those bars only); set_harmony_position {part_id,measure,index from 0,quarters from bar start};\nengraving {title?,composer?,transcriber?,labels?:compact|full|none,page_size?:a4|letter} (paper size reflows this score and its PDF, preserves notes, does not guarantee one page); rebeam {}; reengrave {key?,program?,staff_split?,voices?,grid?,line?:single} (writes the notes again from the recording: rhythm spelling, voices and note IDs can change; not for page layout).\npage layout (pages, PDF and panel; notes and playback stay): layout {bars_per_system? 1..32, system_breaks? [\"bar\"] (start a line), page_breaks? [\"bar\"] (start a page), staff_size? 50..150 (% of default; smaller fits more per page), staff_spacing? 0..48, system_spacing? 0..48 (default 8), reset?:true}; null resets one field. The overview's layout lists each page's lines; check pages with review_score. MusicXML <print>/<scaling> are not read, except breaks in edited MusicXML.\nTAB: set_tablature {part_id?,view off|both|tab,tuning?,capo?,strings?}; set_string {note_ids,string|null}; set_fret {note_ids,string,fret}.\nmarks (saved score marks; kind words|rehearsal|metronome|dynamic|hairpin|fermata|octave (8va|8vb|15ma|15mb, note_id through end_note_id)): add_mark {kind,note_id|part_id+measure+quarters,text?,value?,end_note_id?,placement?}; update_mark {mark_id,kind?,text?,value?,placement?}; move_mark {mark_id,note_id?,end_note_id?}; delete_mark {mark_id}.\nwhole score: transpose_score {interval}; set_meter {beats,beat_type,pickup_quarters?}; scale_note_values {factor:2|0.5}; rewrite_rhythm {bpm,beats,beat_type,downbeat? second a bar starts: bars start there} (steady recording); rebeat {bpm,beats,beat_type,downbeat seconds,swing? 0.5..0.75} (wrong tracked piano beat);\nrebar_pickup {quarters}; set_pickup {enabled} (marks a short first bar, moves no barline); pad_measure {part_id,measure}; repair_bindings {}; undo {}; redo {}.\nbars (every part; numbers as printed): insert_measures {before \"bar\"|null=at end,count? 1..16}; delete_measures {from,to?}.\nrecording alignment: set_recording_alignment {measure_id,visit?:1,anchors:[[zero-based quarter beats within bar,recording seconds],...]} (2..64 increasing points; [] clears). This affects comparison/listening, not written music or ordinary score playback."New value: +"For a fermata, update_mark {mark_id,offset_y} adjusts printed height in tenths (+10 = one staff space up; 0 resets); notes and playback stay unchanged.\nOne object naming its action. Actions and their fields (? optional):\nentry: create_tuplet {note_id,actual 2..9,normal?}; replace_note {note_id,pitch|null,spelling?} (keeps exact slot); remove_tuplet {note_id} (needs following rests); paste_notes {source_note_ids,target_note_id} (complete groups, one part); set_tie {note_ids:[start,end],enabled} (adjacent equal pitches, held sound); set_slur {note_ids:[start,end],enabled} (printed); reflow_layout {}.\nnotes: set_pitch {note_ids,pitch,spelling?} (a pitch named without its octave, \"make it C\", is the one nearest the note's current pitch: B4 -> C5, not C4; in the direction asked if any; say the pitch written); transpose {note_ids,semitones}; set_duration {note_ids,quarters} (one note, tied pair or chord); move_notes {note_ids,quarters ±} (any notes of one part, each in its voice);\ntime: shift_time {measure,onset? quarters from bar start|note_id,quarters ±,part_id?,staff?} moves everything struck from that point on later or earlier (a late or early entry: one call, not note by note); earlier removes the beats just before the point and bars at the end it leaves empty.\nvoices: set_voice {note_ids,voice 1..4 on their staff}; set_tie also between voices; set_beam {note_ids,beam join|break|none|auto}; set_stem {note_ids,stem up|down|flip|auto}; set_visibility {note_ids (rests)|measures,staff?,visible}.\nbatch {operations:[...up to 30 of the note, time, voice and bar edits]}: one version, all or none.\ndelete_notes {note_ids} replaces sounding notes with rests and clears selected rest symbols without shifting later notes; set_staff {note_ids|select,staff 1 upper|2 lower,clef? if asked} (hands); add_chord_tone {note_id,pitch,spelling?,velocity?}; fill_rest {rest_id,pitch,quarters?,velocity?,spelling?}.\nsound: set_velocity {note_ids,velocity 1..127}; set_dynamic {note_id,mark ppp..fff|sf|sfz|fp,velocity?}; set_timbre {part_id,program,part_name?}.\nwriting: set_key {part_id?,fifths,mode} (respells the notes the key holds; pitches stay); set_clef {part_id?,staff?,clef,measures?} (no measures: the whole staff; \"4\": from bar 4 to the staff's next clef change; \"4-6\": those bars only); set_harmony_position {part_id,measure,index from 0,quarters from bar start};\nengraving {title?,composer?,transcriber?,labels?:compact|full|none,page_size?:a4|letter} (paper size reflows this score and its PDF, preserves notes, does not guarantee one page); rebeam {}; reengrave {key?,program?,staff_split?,voices?,grid?,line?:single} (writes the notes again from the recording: rhythm spelling, voices and note IDs can change; not for page layout).\npage layout (pages, PDF and panel; notes and playback stay): layout {bars_per_system? 1..32, system_breaks? [\"bar\"] (start a line), page_breaks? [\"bar\"] (start a page), staff_size? 50..150 (% of default; smaller fits more per page), staff_spacing? 0..48, system_spacing? 0..48 (default 8), reset?:true}; null resets one field. The overview's layout lists each page's lines; check pages with review_score. MusicXML <print>/<scaling> are not read, except breaks in edited MusicXML.\nTAB: set_tablature {part_id?,view off|both|tab,tuning?,capo?,strings?}; set_string {note_ids,string|null} (1 = the top line); set_fret {note_ids,string,fret}.\nmarks (saved score marks; kind words|rehearsal|metronome|dynamic|hairpin|fermata|octave (8va|8vb|15ma|15mb, note_id through end_note_id)): add_mark {kind,note_id|part_id+measure+quarters,text?,value?,end_note_id?,placement?}; update_mark {mark_id,kind?,text?,value?,placement?}; move_mark {mark_id,note_id?,end_note_id?}; delete_mark {mark_id}.\nwhole score: transpose_score {interval}; set_meter {beats,beat_type,pickup_quarters?}; scale_note_values {factor:2|0.5}; rewrite_rhythm {bpm,beats,beat_type,downbeat? second a bar starts: bars start there} (steady recording); rebeat {bpm,beats,beat_type,downbeat seconds,swing? 0.5..0.75} (wrong tracked piano beat);\nrebar_pickup {quarters}; set_pickup {enabled} (marks a short first bar, moves no barline); pad_measure {part_id,measure}; repair_bindings {}; undo {}; redo {}.\nbars (every part; numbers as printed): insert_measures {before \"bar\"|null=at end,count? 1..16}; delete_measures {from,to?}.\nrecording alignment: set_recording_alignment {measure_id,visit?:1,anchors:[[zero-based quarter beats within bar,recording seconds],...]} (2..64 increasing points; [] clears). This affects comparison/listening, not written music or ordinary score playback."
  5. Changed1 schema field changed
    • changedInput schema / properties / operation / description
      Previous value: -"For a fermata, update_mark {mark_id,offset_y} adjusts printed height in tenths (+10 = one staff space up; 0 resets); notes and playback stay unchanged.\nOne object naming its action. Actions and their fields (? optional):\nentry: create_tuplet {note_id,actual 2..9,normal?}; replace_note {note_id,pitch|null,spelling?} (keeps exact slot); remove_tuplet {note_id} (needs following rests); paste_notes {source_note_ids,target_note_id} (complete groups, one part); set_tie {note_ids:[start,end],enabled} (adjacent equal pitches, held sound); set_slur {note_ids:[start,end],enabled} (printed); reflow_layout {}.\nnotes: set_pitch {note_ids,pitch,spelling?}; transpose {note_ids,semitones}; set_duration {note_ids,quarters}; move_notes {note_ids,quarters ±} (each: one note, tied pair or chord);\ndelete_notes {note_ids} replaces sounding notes with rests and clears selected rest symbols without shifting later notes; set_staff {note_ids|select,staff 1 upper|2 lower,clef? if asked} (hands); add_chord_tone {note_id,pitch,spelling?,velocity?}; fill_rest {rest_id,pitch,quarters?,velocity?,spelling?}.\nsound: set_velocity {note_ids,velocity 1..127}; set_dynamic {note_id,mark ppp..fff|sf|sfz|fp,velocity?}; set_timbre {part_id,program,part_name?}.\nwriting: set_key {part_id?,fifths,mode} (respells the notes the key holds; pitches stay); set_clef {part_id?,staff?,clef,measures?} (no measures: the whole staff; \"4\": from bar 4 to the staff's next clef change; \"4-6\": those bars only); set_harmony_position {part_id,measure,index from 0,quarters from bar start};\nengraving {title?,composer?,transcriber?,labels?:compact|full|none,page_size?:a4|letter} (paper size reflows this score and its PDF, preserves notes, does not guarantee one page); rebeam {}; reengrave {key?,program?,staff_split?,voices?,grid?,line?:single} (writes the notes again from the recording: rhythm spelling, voices and note IDs can change; not for page layout).\npage layout (pages, PDF and panel; notes and playback stay): layout {bars_per_system? 1..32, system_breaks? [\"bar\"] (start a line), page_breaks? [\"bar\"] (start a page), staff_size? 50..150 (% of default; smaller fits more per page), staff_spacing? 0..48, system_spacing? 0..48 (default 8), reset?:true}; null resets one field. The overview's layout lists each page's lines; check pages with review_score. MusicXML <print>/<scaling> are not read, except breaks in edited MusicXML.\nTAB: set_tablature {part_id?,view off|both|tab,tuning?,capo?,strings?}; set_string {note_ids,string|null}; set_fret {note_ids,string,fret}.\nmarks (saved score marks; kind words|rehearsal|metronome|dynamic|hairpin|fermata|octave (8va|8vb|15ma|15mb, note_id through end_note_id)): add_mark {kind,note_id|part_id+measure+quarters,text?,value?,end_note_id?,placement?}; update_mark {mark_id,kind?,text?,value?,placement?}; move_mark {mark_id,note_id?,end_note_id?}; delete_mark {mark_id}.\nwhole score: transpose_score {interval}; set_meter {beats,beat_type,pickup_quarters?}; scale_note_values {factor:2|0.5}; rewrite_rhythm {bpm,beats,beat_type,downbeat? second a bar starts: bars start there} (steady recording); rebeat {bpm,beats,beat_type,downbeat seconds,swing? 0.5..0.75} (wrong tracked piano beat);\nrebar_pickup {quarters}; set_pickup {enabled} (marks a short first bar, moves no barline); pad_measure {part_id,measure}; repair_bindings {}; undo {}; redo {}.\nbars (every part; numbers as printed): insert_measures {before \"bar\"|null=at end,count? 1..16}; delete_measures {from,to?}.\nrecording alignment: set_recording_alignment {measure_id,visit?:1,anchors:[[zero-based quarter beats within bar,recording seconds],...]} (2..64 increasing points; [] clears). This affects comparison/listening, not written music or ordinary score playback."New value: +"For a fermata, update_mark {mark_id,offset_y} adjusts printed height in tenths (+10 = one staff space up; 0 resets); notes and playback stay unchanged.\nOne object naming its action. Actions and their fields (? optional):\nentry: create_tuplet {note_id,actual 2..9,normal?}; replace_note {note_id,pitch|null,spelling?} (keeps exact slot); remove_tuplet {note_id} (needs following rests); paste_notes {source_note_ids,target_note_id} (complete groups, one part); set_tie {note_ids:[start,end],enabled} (adjacent equal pitches, held sound); set_slur {note_ids:[start,end],enabled} (printed); reflow_layout {}.\nnotes: set_pitch {note_ids,pitch,spelling?}; transpose {note_ids,semitones}; set_duration {note_ids,quarters} (one note, tied pair or chord); move_notes {note_ids,quarters ±} (any notes of one part, each in its voice);\ntime: shift_time {measure,onset? quarters from bar start|note_id,quarters ±,part_id?,staff?} moves everything struck from that point on later or earlier (a late or early entry: one call, not note by note); earlier removes the beats just before the point and bars at the end it leaves empty.\nvoices: set_voice {note_ids,voice 1..4 on their staff}; set_tie {note_ids:[start,end],enabled} also between voices; set_beam {note_ids,beam join|break|none|auto}; set_stem {note_ids,stem up|down|flip|auto}; set_visibility {note_ids (rests)|measures,staff?,visible}.\nbatch {operations:[...up to 30 of the note, time, voice and bar edits]}: one version, all or none.\ndelete_notes {note_ids} replaces sounding notes with rests and clears selected rest symbols without shifting later notes; set_staff {note_ids|select,staff 1 upper|2 lower,clef? if asked} (hands); add_chord_tone {note_id,pitch,spelling?,velocity?}; fill_rest {rest_id,pitch,quarters?,velocity?,spelling?}.\nsound: set_velocity {note_ids,velocity 1..127}; set_dynamic {note_id,mark ppp..fff|sf|sfz|fp,velocity?}; set_timbre {part_id,program,part_name?}.\nwriting: set_key {part_id?,fifths,mode} (respells the notes the key holds; pitches stay); set_clef {part_id?,staff?,clef,measures?} (no measures: the whole staff; \"4\": from bar 4 to the staff's next clef change; \"4-6\": those bars only); set_harmony_position {part_id,measure,index from 0,quarters from bar start};\nengraving {title?,composer?,transcriber?,labels?:compact|full|none,page_size?:a4|letter} (paper size reflows this score and its PDF, preserves notes, does not guarantee one page); rebeam {}; reengrave {key?,program?,staff_split?,voices?,grid?,line?:single} (writes the notes again from the recording: rhythm spelling, voices and note IDs can change; not for page layout).\npage layout (pages, PDF and panel; notes and playback stay): layout {bars_per_system? 1..32, system_breaks? [\"bar\"] (start a line), page_breaks? [\"bar\"] (start a page), staff_size? 50..150 (% of default; smaller fits more per page), staff_spacing? 0..48, system_spacing? 0..48 (default 8), reset?:true}; null resets one field. The overview's layout lists each page's lines; check pages with review_score. MusicXML <print>/<scaling> are not read, except breaks in edited MusicXML.\nTAB: set_tablature {part_id?,view off|both|tab,tuning?,capo?,strings?}; set_string {note_ids,string|null}; set_fret {note_ids,string,fret}.\nmarks (saved score marks; kind words|rehearsal|metronome|dynamic|hairpin|fermata|octave (8va|8vb|15ma|15mb, note_id through end_note_id)): add_mark {kind,note_id|part_id+measure+quarters,text?,value?,end_note_id?,placement?}; update_mark {mark_id,kind?,text?,value?,placement?}; move_mark {mark_id,note_id?,end_note_id?}; delete_mark {mark_id}.\nwhole score: transpose_score {interval}; set_meter {beats,beat_type,pickup_quarters?}; scale_note_values {factor:2|0.5}; rewrite_rhythm {bpm,beats,beat_type,downbeat? second a bar starts: bars start there} (steady recording); rebeat {bpm,beats,beat_type,downbeat seconds,swing? 0.5..0.75} (wrong tracked piano beat);\nrebar_pickup {quarters}; set_pickup {enabled} (marks a short first bar, moves no barline); pad_measure {part_id,measure}; repair_bindings {}; undo {}; redo {}.\nbars (every part; numbers as printed): insert_measures {before \"bar\"|null=at end,count? 1..16}; delete_measures {from,to?}.\nrecording alignment: set_recording_alignment {measure_id,visit?:1,anchors:[[zero-based quarter beats within bar,recording seconds],...]} (2..64 increasing points; [] clears). This affects comparison/listening, not written music or ordinary score playback."
  6. Changed1 schema field changed
    • changedInput schema / properties / operation / description
      Previous value: -"One object naming its action. Actions and their fields (? optional):\nentry: create_tuplet {note_id,actual 2..9,normal?}; replace_note {note_id,pitch|null,spelling?} (keeps exact slot); remove_tuplet {note_id} (needs following rests); paste_notes {source_note_ids,target_note_id} (complete groups, one part); set_tie {note_ids:[start,end],enabled} (adjacent equal pitches, held sound); set_slur {note_ids:[start,end],enabled} (printed); reflow_layout {}.\nnotes: set_pitch {note_ids,pitch,spelling?}; transpose {note_ids,semitones}; set_duration {note_ids,quarters}; move_notes {note_ids,quarters ±} (each: one note, tied pair or chord);\ndelete_notes {note_ids}; set_staff {note_ids|select,staff 1 upper|2 lower,clef? if asked} (hands); add_chord_tone {note_id,pitch,spelling?,velocity?}; fill_rest {rest_id,pitch,quarters?,velocity?,spelling?}.\nsound: set_velocity {note_ids,velocity 1..127}; set_dynamic {note_id,mark ppp..fff|sf|sfz|fp,velocity?}; set_timbre {part_id,program,part_name?}.\nwriting: set_key {part_id?,fifths,mode} (respells the notes the key holds; pitches stay); set_clef {part_id?,staff?,clef,measures?} (no measures: the whole staff; \"4\": from bar 4 to the staff's next clef change; \"4-6\": those bars only); set_harmony_position {part_id,measure,index from 0,quarters from bar start};\nengraving {title?,composer?,transcriber?,labels?:compact|full|none,page_size?:a4|letter} (paper size reflows this score and its PDF, preserves notes, does not guarantee one page); rebeam {}; reengrave {key?,program?,staff_split?,voices?,grid?,line?:single} (writes the notes again from the recording: rhythm spelling, voices and note IDs can change; not for page layout).\npage layout (pages, PDF and panel; notes and playback stay): layout {bars_per_system? 1..32, system_breaks? [\"bar\"] (start a line), page_breaks? [\"bar\"] (start a page), staff_size? 50..150 (% of default; smaller fits more per page), staff_spacing? 0..48, system_spacing? 0..48 (default 8), reset?:true}; null resets one field. The overview's layout lists each page's lines; check pages with review_score. MusicXML <print>/<scaling> are not read, except breaks in edited MusicXML.\nTAB: set_tablature {part_id?,view off|both|tab,tuning?,capo?,strings?}; set_string {note_ids,string|null}; set_fret {note_ids,string,fret}.\nmarks (saved score marks; kind words|rehearsal|metronome|dynamic|hairpin|fermata|octave (8va|8vb|15ma|15mb, note_id through end_note_id)): add_mark {kind,note_id|part_id+measure+quarters,text?,value?,end_note_id?,placement?}; update_mark {mark_id,kind?,text?,value?,placement?}; move_mark {mark_id,note_id?,end_note_id?}; delete_mark {mark_id}.\nwhole score: transpose_score {interval}; set_meter {beats,beat_type,pickup_quarters?}; scale_note_values {factor:2|0.5}; rewrite_rhythm {bpm,beats,beat_type,downbeat? second a bar starts: bars start there} (steady recording); rebeat {bpm,beats,beat_type,downbeat seconds,swing? 0.5..0.75} (wrong tracked piano beat);\nrebar_pickup {quarters}; set_pickup {enabled} (marks a short first bar, moves no barline); pad_measure {part_id,measure}; repair_bindings {}; undo {}; redo {}.\nbars (every part; numbers as printed): insert_measures {before \"bar\"|null=at end,count? 1..16}; delete_measures {from,to?}.\nrecording alignment: set_recording_alignment {measure_id,visit?:1,anchors:[[zero-based quarter beats within bar,recording seconds],...]} (2..64 increasing points; [] clears). This affects comparison/listening, not written music or ordinary score playback."New value: +"For a fermata, update_mark {mark_id,offset_y} adjusts printed height in tenths (+10 = one staff space up; 0 resets); notes and playback stay unchanged.\nOne object naming its action. Actions and their fields (? optional):\nentry: create_tuplet {note_id,actual 2..9,normal?}; replace_note {note_id,pitch|null,spelling?} (keeps exact slot); remove_tuplet {note_id} (needs following rests); paste_notes {source_note_ids,target_note_id} (complete groups, one part); set_tie {note_ids:[start,end],enabled} (adjacent equal pitches, held sound); set_slur {note_ids:[start,end],enabled} (printed); reflow_layout {}.\nnotes: set_pitch {note_ids,pitch,spelling?}; transpose {note_ids,semitones}; set_duration {note_ids,quarters}; move_notes {note_ids,quarters ±} (each: one note, tied pair or chord);\ndelete_notes {note_ids} replaces sounding notes with rests and clears selected rest symbols without shifting later notes; set_staff {note_ids|select,staff 1 upper|2 lower,clef? if asked} (hands); add_chord_tone {note_id,pitch,spelling?,velocity?}; fill_rest {rest_id,pitch,quarters?,velocity?,spelling?}.\nsound: set_velocity {note_ids,velocity 1..127}; set_dynamic {note_id,mark ppp..fff|sf|sfz|fp,velocity?}; set_timbre {part_id,program,part_name?}.\nwriting: set_key {part_id?,fifths,mode} (respells the notes the key holds; pitches stay); set_clef {part_id?,staff?,clef,measures?} (no measures: the whole staff; \"4\": from bar 4 to the staff's next clef change; \"4-6\": those bars only); set_harmony_position {part_id,measure,index from 0,quarters from bar start};\nengraving {title?,composer?,transcriber?,labels?:compact|full|none,page_size?:a4|letter} (paper size reflows this score and its PDF, preserves notes, does not guarantee one page); rebeam {}; reengrave {key?,program?,staff_split?,voices?,grid?,line?:single} (writes the notes again from the recording: rhythm spelling, voices and note IDs can change; not for page layout).\npage layout (pages, PDF and panel; notes and playback stay): layout {bars_per_system? 1..32, system_breaks? [\"bar\"] (start a line), page_breaks? [\"bar\"] (start a page), staff_size? 50..150 (% of default; smaller fits more per page), staff_spacing? 0..48, system_spacing? 0..48 (default 8), reset?:true}; null resets one field. The overview's layout lists each page's lines; check pages with review_score. MusicXML <print>/<scaling> are not read, except breaks in edited MusicXML.\nTAB: set_tablature {part_id?,view off|both|tab,tuning?,capo?,strings?}; set_string {note_ids,string|null}; set_fret {note_ids,string,fret}.\nmarks (saved score marks; kind words|rehearsal|metronome|dynamic|hairpin|fermata|octave (8va|8vb|15ma|15mb, note_id through end_note_id)): add_mark {kind,note_id|part_id+measure+quarters,text?,value?,end_note_id?,placement?}; update_mark {mark_id,kind?,text?,value?,placement?}; move_mark {mark_id,note_id?,end_note_id?}; delete_mark {mark_id}.\nwhole score: transpose_score {interval}; set_meter {beats,beat_type,pickup_quarters?}; scale_note_values {factor:2|0.5}; rewrite_rhythm {bpm,beats,beat_type,downbeat? second a bar starts: bars start there} (steady recording); rebeat {bpm,beats,beat_type,downbeat seconds,swing? 0.5..0.75} (wrong tracked piano beat);\nrebar_pickup {quarters}; set_pickup {enabled} (marks a short first bar, moves no barline); pad_measure {part_id,measure}; repair_bindings {}; undo {}; redo {}.\nbars (every part; numbers as printed): insert_measures {before \"bar\"|null=at end,count? 1..16}; delete_measures {from,to?}.\nrecording alignment: set_recording_alignment {measure_id,visit?:1,anchors:[[zero-based quarter beats within bar,recording seconds],...]} (2..64 increasing points; [] clears). This affects comparison/listening, not written music or ordinary score playback."
  7. Changed1 schema field changed
    • changedInput schema / properties / operation / description
      Previous value: -"One object naming its action. Actions and their fields (? optional):\nentry: create_tuplet {note_id,actual 2..9,normal?}; replace_note {note_id,pitch|null,spelling?} (keeps exact slot); remove_tuplet {note_id} (needs following rests); paste_notes {source_note_ids,target_note_id} (complete groups, one part); set_tie {note_ids:[start,end],enabled} (adjacent equal pitches, held sound); set_slur {note_ids:[start,end],enabled} (printed); reflow_layout {}.\nnotes: set_pitch {note_ids,pitch,spelling?}; transpose {note_ids,semitones}; set_duration {note_ids,quarters}; move_notes {note_ids,quarters ±} (each: one note, tied pair or chord);\ndelete_notes {note_ids}; set_staff {note_ids|select,staff 1 upper|2 lower,clef? if asked} (hands); add_chord_tone {note_id,pitch,spelling?,velocity?}; fill_rest {rest_id,pitch,quarters?,velocity?,spelling?}.\nsound: set_velocity {note_ids,velocity 1..127}; set_dynamic {note_id,mark ppp..fff|sf|sfz|fp,velocity?}; set_timbre {part_id,program,part_name?}.\nwriting: set_key {part_id?,fifths,mode} (respells the notes the key holds; pitches stay); set_clef {part_id?,staff?,clef,measures?} (no measures: the whole staff; \"4\": from bar 4 to the staff's next clef change; \"4-6\": those bars only); set_harmony_position {part_id,measure,index from 0,quarters from bar start};\nengraving {title?,composer?,transcriber?,labels?:compact|full|none,page_size?:a4|letter} (paper size reflows this score and its PDF, preserves notes, does not guarantee one page); rebeam {}; reengrave {key?,program?,staff_split?,voices?,grid?,line?:single}.\nTAB: set_tablature {part_id?,view off|both|tab,tuning?,capo?,strings?}; set_string {note_ids,string|null}; set_fret {note_ids,string,fret}.\nmarks (saved score marks; kind words|rehearsal|metronome|dynamic|hairpin|fermata|octave (8va|8vb|15ma|15mb, note_id through end_note_id)): add_mark {kind,note_id|part_id+measure+quarters,text?,value?,end_note_id?,placement?}; update_mark {mark_id,kind?,text?,value?,placement?}; move_mark {mark_id,note_id?,end_note_id?}; delete_mark {mark_id}.\nwhole score: transpose_score {interval}; set_meter {beats,beat_type,pickup_quarters?}; scale_note_values {factor:2|0.5}; rewrite_rhythm {bpm,beats,beat_type,downbeat? second a bar starts: bars start there} (steady recording); rebeat {bpm,beats,beat_type,downbeat seconds,swing? 0.5..0.75} (wrong tracked piano beat);\nrebar_pickup {quarters}; set_pickup {enabled} (marks a short first bar, moves no barline); pad_measure {part_id,measure}; repair_bindings {}; undo {}; redo {}.\nbars (every part; numbers as printed): insert_measures {before \"bar\"|null=at end,count? 1..16}; delete_measures {from,to?}.\nrecording alignment: set_recording_alignment {measure_id,visit?:1,anchors:[[zero-based quarter beats within bar,recording seconds],...]} (2..64 increasing points; [] clears). This affects comparison/listening, not written music or ordinary score playback."New value: +"One object naming its action. Actions and their fields (? optional):\nentry: create_tuplet {note_id,actual 2..9,normal?}; replace_note {note_id,pitch|null,spelling?} (keeps exact slot); remove_tuplet {note_id} (needs following rests); paste_notes {source_note_ids,target_note_id} (complete groups, one part); set_tie {note_ids:[start,end],enabled} (adjacent equal pitches, held sound); set_slur {note_ids:[start,end],enabled} (printed); reflow_layout {}.\nnotes: set_pitch {note_ids,pitch,spelling?}; transpose {note_ids,semitones}; set_duration {note_ids,quarters}; move_notes {note_ids,quarters ±} (each: one note, tied pair or chord);\ndelete_notes {note_ids}; set_staff {note_ids|select,staff 1 upper|2 lower,clef? if asked} (hands); add_chord_tone {note_id,pitch,spelling?,velocity?}; fill_rest {rest_id,pitch,quarters?,velocity?,spelling?}.\nsound: set_velocity {note_ids,velocity 1..127}; set_dynamic {note_id,mark ppp..fff|sf|sfz|fp,velocity?}; set_timbre {part_id,program,part_name?}.\nwriting: set_key {part_id?,fifths,mode} (respells the notes the key holds; pitches stay); set_clef {part_id?,staff?,clef,measures?} (no measures: the whole staff; \"4\": from bar 4 to the staff's next clef change; \"4-6\": those bars only); set_harmony_position {part_id,measure,index from 0,quarters from bar start};\nengraving {title?,composer?,transcriber?,labels?:compact|full|none,page_size?:a4|letter} (paper size reflows this score and its PDF, preserves notes, does not guarantee one page); rebeam {}; reengrave {key?,program?,staff_split?,voices?,grid?,line?:single} (writes the notes again from the recording: rhythm spelling, voices and note IDs can change; not for page layout).\npage layout (pages, PDF and panel; notes and playback stay): layout {bars_per_system? 1..32, system_breaks? [\"bar\"] (start a line), page_breaks? [\"bar\"] (start a page), staff_size? 50..150 (% of default; smaller fits more per page), staff_spacing? 0..48, system_spacing? 0..48 (default 8), reset?:true}; null resets one field. The overview's layout lists each page's lines; check pages with review_score. MusicXML <print>/<scaling> are not read, except breaks in edited MusicXML.\nTAB: set_tablature {part_id?,view off|both|tab,tuning?,capo?,strings?}; set_string {note_ids,string|null}; set_fret {note_ids,string,fret}.\nmarks (saved score marks; kind words|rehearsal|metronome|dynamic|hairpin|fermata|octave (8va|8vb|15ma|15mb, note_id through end_note_id)): add_mark {kind,note_id|part_id+measure+quarters,text?,value?,end_note_id?,placement?}; update_mark {mark_id,kind?,text?,value?,placement?}; move_mark {mark_id,note_id?,end_note_id?}; delete_mark {mark_id}.\nwhole score: transpose_score {interval}; set_meter {beats,beat_type,pickup_quarters?}; scale_note_values {factor:2|0.5}; rewrite_rhythm {bpm,beats,beat_type,downbeat? second a bar starts: bars start there} (steady recording); rebeat {bpm,beats,beat_type,downbeat seconds,swing? 0.5..0.75} (wrong tracked piano beat);\nrebar_pickup {quarters}; set_pickup {enabled} (marks a short first bar, moves no barline); pad_measure {part_id,measure}; repair_bindings {}; undo {}; redo {}.\nbars (every part; numbers as printed): insert_measures {before \"bar\"|null=at end,count? 1..16}; delete_measures {from,to?}.\nrecording alignment: set_recording_alignment {measure_id,visit?:1,anchors:[[zero-based quarter beats within bar,recording seconds],...]} (2..64 increasing points; [] clears). This affects comparison/listening, not written music or ordinary score playback."
  8. Changed1 schema field changed
    • changedInput schema / properties / operation / description
      Previous value: -"One object naming its action. Actions and their fields (? optional):\nentry: create_tuplet {note_id,actual 2..9,normal?}; replace_note {note_id,pitch|null,spelling?} (keeps exact slot); remove_tuplet {note_id} (needs following rests); paste_notes {source_note_ids,target_note_id} (complete groups, one part); set_tie {note_ids:[start,end],enabled} (adjacent equal pitches, held sound); set_slur {note_ids:[start,end],enabled} (printed); reflow_layout {}.\nnotes: set_pitch {note_ids,pitch,spelling?}; transpose {note_ids,semitones}; set_duration {note_ids,quarters}; move_notes {note_ids,quarters ±} (each: one note, tied pair or chord);\ndelete_notes {note_ids}; set_staff {note_ids|select,staff 1 upper|2 lower,clef? if asked} (hands); add_chord_tone {note_id,pitch,spelling?,velocity?}; fill_rest {rest_id,pitch,quarters?,velocity?,spelling?}.\nsound: set_velocity {note_ids,velocity 1..127}; set_dynamic {note_id,mark ppp..fff|sf|sfz|fp,velocity?}; set_timbre {part_id,program,part_name?}.\nwriting: set_key {part_id?,fifths,mode} (respells the notes the key holds; pitches stay); set_clef {part_id?,staff?,clef,measures?} (no measures: the whole staff; \"4\": from bar 4 to the staff's next clef change; \"4-6\": those bars only); set_harmony_position {part_id,measure,index from 0,quarters from bar start};\nengraving {title,composer,transcriber,labels:compact|full|none}; rebeam {}; reengrave {key?,program?,staff_split?,voices?,grid?,line?:single}.\nTAB: set_tablature {part_id?,view off|both|tab,tuning?,capo?,strings?}; set_string {note_ids,string|null}; set_fret {note_ids,string,fret}.\nmarks (saved score marks; kind words|rehearsal|metronome|dynamic|hairpin|fermata): add_mark {kind,note_id|part_id+measure+quarters,text?,value?,end_note_id?,placement?}; update_mark {mark_id,kind?,text?,value?,placement?}; move_mark {mark_id,note_id?,end_note_id?}; delete_mark {mark_id}.\nwhole score: transpose_score {interval}; set_meter {beats,beat_type,pickup_quarters?}; scale_note_values {factor:2|0.5}; rewrite_rhythm {bpm,beats,beat_type,downbeat? second a bar starts: bars start there} (steady recording); rebeat {bpm,beats,beat_type,downbeat seconds,swing? 0.5..0.75} (wrong tracked piano beat);\nrebar_pickup {quarters}; set_pickup {enabled} (marks a short first bar, moves no barline); pad_measure {part_id,measure}; repair_bindings {}; undo {}; redo {}.\nbars (every part; numbers as printed): insert_measures {before \"bar\"|null=at end,count? 1..16}; delete_measures {from,to?}.\nrecording alignment: set_recording_alignment {measure_id,visit?:1,anchors:[[zero-based quarter beats within bar,recording seconds],...]} (2..64 increasing points; [] clears). This affects comparison/listening, not written music or ordinary score playback."New value: +"One object naming its action. Actions and their fields (? optional):\nentry: create_tuplet {note_id,actual 2..9,normal?}; replace_note {note_id,pitch|null,spelling?} (keeps exact slot); remove_tuplet {note_id} (needs following rests); paste_notes {source_note_ids,target_note_id} (complete groups, one part); set_tie {note_ids:[start,end],enabled} (adjacent equal pitches, held sound); set_slur {note_ids:[start,end],enabled} (printed); reflow_layout {}.\nnotes: set_pitch {note_ids,pitch,spelling?}; transpose {note_ids,semitones}; set_duration {note_ids,quarters}; move_notes {note_ids,quarters ±} (each: one note, tied pair or chord);\ndelete_notes {note_ids}; set_staff {note_ids|select,staff 1 upper|2 lower,clef? if asked} (hands); add_chord_tone {note_id,pitch,spelling?,velocity?}; fill_rest {rest_id,pitch,quarters?,velocity?,spelling?}.\nsound: set_velocity {note_ids,velocity 1..127}; set_dynamic {note_id,mark ppp..fff|sf|sfz|fp,velocity?}; set_timbre {part_id,program,part_name?}.\nwriting: set_key {part_id?,fifths,mode} (respells the notes the key holds; pitches stay); set_clef {part_id?,staff?,clef,measures?} (no measures: the whole staff; \"4\": from bar 4 to the staff's next clef change; \"4-6\": those bars only); set_harmony_position {part_id,measure,index from 0,quarters from bar start};\nengraving {title?,composer?,transcriber?,labels?:compact|full|none,page_size?:a4|letter} (paper size reflows this score and its PDF, preserves notes, does not guarantee one page); rebeam {}; reengrave {key?,program?,staff_split?,voices?,grid?,line?:single}.\nTAB: set_tablature {part_id?,view off|both|tab,tuning?,capo?,strings?}; set_string {note_ids,string|null}; set_fret {note_ids,string,fret}.\nmarks (saved score marks; kind words|rehearsal|metronome|dynamic|hairpin|fermata|octave (8va|8vb|15ma|15mb, note_id through end_note_id)): add_mark {kind,note_id|part_id+measure+quarters,text?,value?,end_note_id?,placement?}; update_mark {mark_id,kind?,text?,value?,placement?}; move_mark {mark_id,note_id?,end_note_id?}; delete_mark {mark_id}.\nwhole score: transpose_score {interval}; set_meter {beats,beat_type,pickup_quarters?}; scale_note_values {factor:2|0.5}; rewrite_rhythm {bpm,beats,beat_type,downbeat? second a bar starts: bars start there} (steady recording); rebeat {bpm,beats,beat_type,downbeat seconds,swing? 0.5..0.75} (wrong tracked piano beat);\nrebar_pickup {quarters}; set_pickup {enabled} (marks a short first bar, moves no barline); pad_measure {part_id,measure}; repair_bindings {}; undo {}; redo {}.\nbars (every part; numbers as printed): insert_measures {before \"bar\"|null=at end,count? 1..16}; delete_measures {from,to?}.\nrecording alignment: set_recording_alignment {measure_id,visit?:1,anchors:[[zero-based quarter beats within bar,recording seconds],...]} (2..64 increasing points; [] clears). This affects comparison/listening, not written music or ordinary score playback."
  9. Changed1 schema field changed
    • changedInput schema / properties / operation / description
      Previous value: -"One object naming its action. Actions and their fields (? optional):\nnotes: set_pitch {note_ids,pitch,spelling?}; transpose {note_ids,semitones}; set_duration {note_ids,quarters}; move_notes {note_ids,quarters ±} (each: one note, tied pair or chord);\ndelete_notes {note_ids}; set_staff {note_ids|select,staff 1 upper|2 lower,clef? if asked} (hands); add_chord_tone {note_id,pitch,spelling?,velocity?}; fill_rest {rest_id,pitch,quarters?,velocity?,spelling?}.\nsound: set_velocity {note_ids,velocity 1..127}; set_dynamic {note_id,mark ppp..fff|sf|sfz|fp,velocity?}; set_timbre {part_id,program,part_name?}.\nwriting: set_key {part_id?,fifths,mode} (respells the notes the key holds; pitches stay); set_clef {part_id?,staff?,clef,measures?} (no measures: the whole staff; \"4\": from bar 4 to the staff's next clef change; \"4-6\": those bars only); set_harmony_position {part_id,measure,index from 0,quarters from bar start};\nengraving {title,composer,transcriber,labels:compact|full|none}; rebeam {}; reengrave {key?,program?,staff_split?,voices?,grid?,line?:single}.\nTAB: set_tablature {part_id?,view off|both|tab,tuning?,capo?,strings?}; set_string {note_ids,string|null}; set_fret {note_ids,string,fret}.\nmarks (saved score marks; kind words|rehearsal|metronome|dynamic|hairpin|fermata): add_mark {kind,note_id|part_id+measure+quarters,text?,value?,end_note_id?,placement?}; update_mark {mark_id,kind?,text?,value?,placement?}; move_mark {mark_id,note_id?,end_note_id?}; delete_mark {mark_id}.\nwhole score: transpose_score {interval}; set_meter {beats,beat_type,pickup_quarters?}; scale_note_values {factor:2|0.5}; rewrite_rhythm {bpm,beats,beat_type,downbeat? second a bar starts: bars start there} (steady recording); rebeat {bpm,beats,beat_type,downbeat seconds,swing? 0.5..0.75} (wrong tracked piano beat);\nrebar_pickup {quarters}; set_pickup {enabled} (marks a short first bar, moves no barline); pad_measure {part_id,measure}; repair_bindings {}; undo {}; redo {}.\nbars (every part; numbers as printed): insert_measures {before \"bar\"|null=at end,count? 1..16}; delete_measures {from,to?}."New value: +"One object naming its action. Actions and their fields (? optional):\nentry: create_tuplet {note_id,actual 2..9,normal?}; replace_note {note_id,pitch|null,spelling?} (keeps exact slot); remove_tuplet {note_id} (needs following rests); paste_notes {source_note_ids,target_note_id} (complete groups, one part); set_tie {note_ids:[start,end],enabled} (adjacent equal pitches, held sound); set_slur {note_ids:[start,end],enabled} (printed); reflow_layout {}.\nnotes: set_pitch {note_ids,pitch,spelling?}; transpose {note_ids,semitones}; set_duration {note_ids,quarters}; move_notes {note_ids,quarters ±} (each: one note, tied pair or chord);\ndelete_notes {note_ids}; set_staff {note_ids|select,staff 1 upper|2 lower,clef? if asked} (hands); add_chord_tone {note_id,pitch,spelling?,velocity?}; fill_rest {rest_id,pitch,quarters?,velocity?,spelling?}.\nsound: set_velocity {note_ids,velocity 1..127}; set_dynamic {note_id,mark ppp..fff|sf|sfz|fp,velocity?}; set_timbre {part_id,program,part_name?}.\nwriting: set_key {part_id?,fifths,mode} (respells the notes the key holds; pitches stay); set_clef {part_id?,staff?,clef,measures?} (no measures: the whole staff; \"4\": from bar 4 to the staff's next clef change; \"4-6\": those bars only); set_harmony_position {part_id,measure,index from 0,quarters from bar start};\nengraving {title,composer,transcriber,labels:compact|full|none}; rebeam {}; reengrave {key?,program?,staff_split?,voices?,grid?,line?:single}.\nTAB: set_tablature {part_id?,view off|both|tab,tuning?,capo?,strings?}; set_string {note_ids,string|null}; set_fret {note_ids,string,fret}.\nmarks (saved score marks; kind words|rehearsal|metronome|dynamic|hairpin|fermata): add_mark {kind,note_id|part_id+measure+quarters,text?,value?,end_note_id?,placement?}; update_mark {mark_id,kind?,text?,value?,placement?}; move_mark {mark_id,note_id?,end_note_id?}; delete_mark {mark_id}.\nwhole score: transpose_score {interval}; set_meter {beats,beat_type,pickup_quarters?}; scale_note_values {factor:2|0.5}; rewrite_rhythm {bpm,beats,beat_type,downbeat? second a bar starts: bars start there} (steady recording); rebeat {bpm,beats,beat_type,downbeat seconds,swing? 0.5..0.75} (wrong tracked piano beat);\nrebar_pickup {quarters}; set_pickup {enabled} (marks a short first bar, moves no barline); pad_measure {part_id,measure}; repair_bindings {}; undo {}; redo {}.\nbars (every part; numbers as printed): insert_measures {before \"bar\"|null=at end,count? 1..16}; delete_measures {from,to?}.\nrecording alignment: set_recording_alignment {measure_id,visit?:1,anchors:[[zero-based quarter beats within bar,recording seconds],...]} (2..64 increasing points; [] clears). This affects comparison/listening, not written music or ordinary score playback."
  10. Changed1 schema field changed
    • changedInput schema / properties / operation / description
      Previous value: -"One object naming its action. Actions and their fields (? optional):\nnotes: set_pitch {note_ids,pitch,spelling?}; transpose {note_ids,semitones}; set_duration {note_ids,quarters}; move_notes {note_ids,quarters ±};\ndelete_notes {note_ids}; set_staff {note_ids|select,staff 1 upper|2 lower,clef? if asked} (hands); add_chord_tone {note_id,pitch,spelling?,velocity?}; fill_rest {rest_id,pitch,quarters?,velocity?,spelling?}.\nsound: set_velocity {note_ids,velocity 1..127}; set_dynamic {note_id,mark ppp..fff|sf|sfz|fp,velocity?}; set_timbre {part_id,program,part_name?}.\nwriting: set_key {part_id?,fifths,mode}; set_clef {part_id?,staff?,clef,measures? \"4-6\" for those bars only}; set_harmony_position {part_id,measure,index from 0,quarters from bar start};\nengraving {title,composer,transcriber,labels:compact|full|none}; rebeam {}; reengrave {key?,program?,staff_split?,voices?,grid?,line?:single}.\nTAB: set_tablature {part_id?,view off|both|tab,tuning?,capo?,strings?}; set_string {note_ids,string|null}; set_fret {note_ids,string,fret}.\nmarks (saved score marks; kind words|rehearsal|metronome|dynamic|hairpin|fermata): add_mark {kind,note_id|part_id+measure+quarters,text?,value?,end_note_id?,placement?}; update_mark {mark_id,kind?,text?,value?,placement?}; move_mark {mark_id,note_id?,end_note_id?}; delete_mark {mark_id}.\nwhole score: transpose_score {interval}; set_meter {beats,beat_type,pickup_quarters?}; scale_note_values {factor:2|0.5}; rewrite_rhythm {bpm,beats,beat_type} (steady recording); rebeat {bpm,beats,beat_type,downbeat seconds,swing? 0.5..0.75} (wrong tracked piano beat);\nrebar_pickup {quarters}; set_pickup {enabled} (marks a short first bar, moves no barline); pad_measure {part_id,measure}; repair_bindings {}; undo {}; redo {}.\nbars (every part; numbers as printed): insert_measures {before \"bar\"|null=at end,count? 1..16}; delete_measures {from,to?}."New value: +"One object naming its action. Actions and their fields (? optional):\nnotes: set_pitch {note_ids,pitch,spelling?}; transpose {note_ids,semitones}; set_duration {note_ids,quarters}; move_notes {note_ids,quarters ±} (each: one note, tied pair or chord);\ndelete_notes {note_ids}; set_staff {note_ids|select,staff 1 upper|2 lower,clef? if asked} (hands); add_chord_tone {note_id,pitch,spelling?,velocity?}; fill_rest {rest_id,pitch,quarters?,velocity?,spelling?}.\nsound: set_velocity {note_ids,velocity 1..127}; set_dynamic {note_id,mark ppp..fff|sf|sfz|fp,velocity?}; set_timbre {part_id,program,part_name?}.\nwriting: set_key {part_id?,fifths,mode} (respells the notes the key holds; pitches stay); set_clef {part_id?,staff?,clef,measures?} (no measures: the whole staff; \"4\": from bar 4 to the staff's next clef change; \"4-6\": those bars only); set_harmony_position {part_id,measure,index from 0,quarters from bar start};\nengraving {title,composer,transcriber,labels:compact|full|none}; rebeam {}; reengrave {key?,program?,staff_split?,voices?,grid?,line?:single}.\nTAB: set_tablature {part_id?,view off|both|tab,tuning?,capo?,strings?}; set_string {note_ids,string|null}; set_fret {note_ids,string,fret}.\nmarks (saved score marks; kind words|rehearsal|metronome|dynamic|hairpin|fermata): add_mark {kind,note_id|part_id+measure+quarters,text?,value?,end_note_id?,placement?}; update_mark {mark_id,kind?,text?,value?,placement?}; move_mark {mark_id,note_id?,end_note_id?}; delete_mark {mark_id}.\nwhole score: transpose_score {interval}; set_meter {beats,beat_type,pickup_quarters?}; scale_note_values {factor:2|0.5}; rewrite_rhythm {bpm,beats,beat_type,downbeat? second a bar starts: bars start there} (steady recording); rebeat {bpm,beats,beat_type,downbeat seconds,swing? 0.5..0.75} (wrong tracked piano beat);\nrebar_pickup {quarters}; set_pickup {enabled} (marks a short first bar, moves no barline); pad_measure {part_id,measure}; repair_bindings {}; undo {}; redo {}.\nbars (every part; numbers as printed): insert_measures {before \"bar\"|null=at end,count? 1..16}; delete_measures {from,to?}."
  11. Changed1 schema field changed
    • changedInput schema / properties / operation / description
      Previous value: -"One object naming its action. Actions and their fields (? optional):\nnotes: set_pitch {note_ids,pitch,spelling?}; transpose {note_ids,semitones}; set_duration {note_ids,quarters};\ndelete_notes {note_ids}; set_staff {note_ids|select,staff 1 upper|2 lower,clef? if asked} (hands); add_chord_tone {note_id,pitch,spelling?,velocity?}; fill_rest {rest_id,pitch,quarters?,velocity?,spelling?}.\nsound: set_velocity {note_ids,velocity 1..127}; set_dynamic {note_id,mark ppp..fff|sf|sfz|fp,velocity?}; set_timbre {part_id,program,part_name?}.\nwriting: set_key {part_id?,fifths,mode}; set_clef {part_id?,staff?,clef}; set_harmony_position {part_id,measure,index from 0,quarters from bar start};\nengraving {title,composer,transcriber,labels:compact|full|none}; rebeam {}; reengrave {key?,program?,staff_split?,voices?,grid?,line?:single}.\nTAB: set_tablature {part_id?,view off|both|tab,tuning?,capo?,strings?}; set_string {note_ids,string|null}; set_fret {note_ids,string,fret}.\nmarks (saved score marks; kind words|rehearsal|metronome|dynamic|hairpin|fermata): add_mark {kind,note_id|part_id+measure+quarters,text?,value?,end_note_id?,placement?}; update_mark {mark_id,kind?,text?,value?,placement?}; move_mark {mark_id,note_id?,end_note_id?}; delete_mark {mark_id}.\nwhole score: transpose_score {interval}; set_meter {beats,beat_type,pickup_quarters?}; scale_note_values {factor:2|0.5}; rewrite_rhythm {bpm,beats,beat_type} (steady recording); rebeat {bpm,beats,beat_type,downbeat seconds,swing? 0.5..0.75} (wrong tracked piano beat);\nrebar_pickup {quarters}; set_pickup {enabled}; pad_measure {part_id,measure}; repair_bindings {}; undo {}; redo {}."New value: +"One object naming its action. Actions and their fields (? optional):\nnotes: set_pitch {note_ids,pitch,spelling?}; transpose {note_ids,semitones}; set_duration {note_ids,quarters}; move_notes {note_ids,quarters ±};\ndelete_notes {note_ids}; set_staff {note_ids|select,staff 1 upper|2 lower,clef? if asked} (hands); add_chord_tone {note_id,pitch,spelling?,velocity?}; fill_rest {rest_id,pitch,quarters?,velocity?,spelling?}.\nsound: set_velocity {note_ids,velocity 1..127}; set_dynamic {note_id,mark ppp..fff|sf|sfz|fp,velocity?}; set_timbre {part_id,program,part_name?}.\nwriting: set_key {part_id?,fifths,mode}; set_clef {part_id?,staff?,clef,measures? \"4-6\" for those bars only}; set_harmony_position {part_id,measure,index from 0,quarters from bar start};\nengraving {title,composer,transcriber,labels:compact|full|none}; rebeam {}; reengrave {key?,program?,staff_split?,voices?,grid?,line?:single}.\nTAB: set_tablature {part_id?,view off|both|tab,tuning?,capo?,strings?}; set_string {note_ids,string|null}; set_fret {note_ids,string,fret}.\nmarks (saved score marks; kind words|rehearsal|metronome|dynamic|hairpin|fermata): add_mark {kind,note_id|part_id+measure+quarters,text?,value?,end_note_id?,placement?}; update_mark {mark_id,kind?,text?,value?,placement?}; move_mark {mark_id,note_id?,end_note_id?}; delete_mark {mark_id}.\nwhole score: transpose_score {interval}; set_meter {beats,beat_type,pickup_quarters?}; scale_note_values {factor:2|0.5}; rewrite_rhythm {bpm,beats,beat_type} (steady recording); rebeat {bpm,beats,beat_type,downbeat seconds,swing? 0.5..0.75} (wrong tracked piano beat);\nrebar_pickup {quarters}; set_pickup {enabled} (marks a short first bar, moves no barline); pad_measure {part_id,measure}; repair_bindings {}; undo {}; redo {}.\nbars (every part; numbers as printed): insert_measures {before \"bar\"|null=at end,count? 1..16}; delete_measures {from,to?}."
  12. First observed

TDQS

A3.8/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Beyond the annotations, the description adds meaningful behavior: stale edits are refused, request_id can permit an older revision for certain pitch edits, and re-engraving or whole-score rhythm edits replace note IDs. It also states 'No credits,' but does not fully explain the practical scope of 'destructive' changes or how undo interacts with the edit.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is front-loaded with the core action and follows with relevant constraints rather than repeating schema details. It is compact overall, though the sentence about older revisions and notation-played scores is dense and requires careful parsing.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a complex destructive editing tool, the description covers the most important behavioral caveats: refusal of stale edits, conditional request_id handling, and note ID replacement after certain edits. It is reasonably complete alongside the detailed operation schema and annotations, though it could say more about preview/apply workflows or undo expectations.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

With only 50% schema description coverage, the description compensates by explaining stale-revision refusal and the special request_id behavior for pitch edits against older revisions. The schema itself provides extensive operation details, and score_id is self-explanatory, though revision semantics could be slightly clearer.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description gives a specific verb and resource: 'Apply one reversible score edit.' It is clear what the tool does, but it does not explicitly distinguish itself from sibling tools such as preview_score_edit, apply_score_preview, or save_score_edits.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Usage is implied by 'Apply one reversible score edit,' and the description notes refusal conditions for invalid IDs and stale edits. However, it gives no explicit guidance on when to use this tool versus previewing, validating, saving, or applying a preview through sibling tools.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources