record_session_arrangement
Record Session clip and scene choices into an empty Arrangement tail after existing clips, then start and verify Arrangement record/playback.
Instructions
Record Session clip/scene choices into an empty Arrangement tail after all existing clips. Requires stopped playback, playhead already at a native bar start aligned with the global launch grid, all explicit/implicit arms off, loop/punch/automation arm/Session recording off and supported count-in. Sets and verifies the insert marker at startBeats, then starts global Arrangement record/playback; leaves that marker at the start. Native display ticks request both stopped at endBeats or 300 seconds while scope remains owned, even after client disconnect. Tempo/meter and Session choices may change; track/arm/insert-marker/recording control changes relinquish cleanup. Retains partial clips and endpoint overhang; no exact timing, rendered audio, input or gesture-automation proof. Updated bridge; all profile.
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": {
"expectedStateVersion": "<expectedStateVersion>",
"startBeats": "<startBeats>",
"endBeats": "<endBeats>"
},
"name": "record_session_arrangement"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dryRun | No | False executes with token and hash. | |
| endBeats | Yes | Requested stop beat; increasing span at most 512 beats and 300 seconds at current tempo. | |
| planHash | No | Plan hash. | |
| startBeats | Yes | Prepared playhead in quarter-note song beats, at or after every existing Arrangement clip end. | |
| confirmationToken | No | Single-use plan token. | |
| expectedStateVersion | Yes | Observed stateVersion. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||