write_clip_evolution
Write evolving automation envelopes into Session clips and optionally extend MIDI loops over many bars, shaping volume, pan, sends, or device parameters with musical curves.
Instructions
Make a Session clip evolve over many bars: optionally extend it to bars
(a MIDI loop is tiled, e.g. 4 -> 64 bars), then write one automation
envelope per lane with a musical curve. Copied to the Arrangement (e.g.
by build_arrangement), the envelopes become the track's automation there.
Each lane: {"mixer_parameter": "volume" | "panning" | "send:N"} or {"device_index": d, "parameter_index": p}, plus "start", "end" (in the parameter's units, see get_device_parameters: min/max/display), "shape" (linear, exp, log, s_curve, swell, sine, triangle, steps, random_walk, hold), optional "cycles" (sine/triangle), "steps" (steps), "power" (exp/log curvature, default 2.5), "from_bar"/"to_bar" to limit the curve to part of the clip (the value holds outside), "seed".
Example, a 64-bar techno build: filter cutoff exp from 0.3 to 0.9, reverb send swell, hats volume in 8 steps.
Parameters:
track_index / clip_index: Session clip
lanes: Curves to write (see above)
bars: Extend the clip to this many bars first (MIDI clips; 4/4)
resolution: Envelope step in beats (1 = a point per beat)
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": {
"track_index": "<track_index>",
"clip_index": "<clip_index>",
"lanes": "<lanes>"
},
"name": "write_clip_evolution"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| bars | No | ||
| lanes | Yes | ||
| clip_index | Yes | ||
| resolution | No | ||
| track_index | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |