Subdivide

Use this when the user needs to create and play click tracks for musicians practicing tempo changes, recording sessions, or live performances. Build entire tracks with multiple sections (fixed tempos) and smooth transitions (gradual tempo changes). Includes interactive playback controls with play/stop buttons, real-time progress tracking, and visual progress bar. Supports complex time signatures (3/4, 5/8, 7/8, etc.), subdivisions (triplets, sixteenths), custom beat patterns, and tempo ramps from 10-400 BPM. If the Subdivide app from the sidebar or a click track is open and on screen (its context has a session id and does not say it is off screen), show the track there with track.show instead. Do not use for simple single-tempo metronomes - use metronome.create instead.

track.create

Use this when the user needs a simple, single-tempo metronome for practice or keeping time. Supports tempo control (BPM), complex time signatures (4/4, 6/8, 7/8, etc.), subdivisions (triplets, sixteenths), and advanced beat patterns with accents and muting. The user can adjust every setting directly in the widget afterwards. If a Subdivide metronome or the Subdivide app is open and on screen (its context has a session id and does not say it is off screen), change it with metronome.update instead of calling this. Do not use for tracks with tempo changes or multiple sections - use track.create instead.

metronome.create

Used by the Subdivide app when it goes off screen or closes, so the model shows new things in new widgets.

session.leave

Used by the Subdivide app to share the click track it shows and get its link.

share.trackLink

Used by the Subdivide app to save what it shows.

session.save

Show a click track in an open Subdivide app instead of creating a new widget. Use this when the user wants a click track and the Subdivide app is open and on screen (its context has a session id and does not say it is off screen), for example in the sidebar app: pass that session id and the track, defined as for track.create. If no Subdivide app is on screen, use track.create (this tool refuses a change the user would not see).

track.show

Open Subdivide.

app.launch

Change the metronome in an open Subdivide app (inline, in the side panel, or the sidebar app) instead of creating a new one. Use this whenever the user asks to change a metronome that is open or shown on the app's home: pass the session id from the app's context and only the fields that change (send the full measure array when changing beats or accents). The app updates right away, even while playing. Only for an app on screen: when its context says it is off screen, use metronome.create (this tool refuses a change the user would not see).

metronome.update

Used by the Subdivide app to wait for changes to what it shows.

session.wait