Music Intelligence

Call analyze_music when the user asks to analyze music or no cache exists. It runs the installed local Beat This + CLAP models, waits for completion, and never downloads models; use force:true only for an explicit reanalysis request.
Call inspect_music when only the existing cache is needed.
Before cutting video, call music_edit_plan and show its bounded cut/target summary. Before placing photos, call music_image_plan and show its bounded placement summary. Prefer timing:auto; choose sparse, medium, or dense from the requested pace.
Only after the plan is accepted, call sync_cuts_to_music or sync_images_to_music with the returned analysisRef. Each tool recomputes the plan, rejects stale analysis, and applies its changes as one undo step.
If required model packs are missing, report the returned install guidance (Settings path + missing pack names), then ask whether to proceed with a detect_beats fallback for pure beat timing (BPM + beat frames only, no CLAP tags/sections/energy), or wait until the user installs the packs and retry analyze_music after installation.
Never request, return, quote, summarize, or place the CLAP embedding in model context. Use tags, sections, confidence, and the opaque analysisRef only.

Preconditions

Analysis is opt-in and on-device. The media-pool asset must already have a cache for its current sourceRevision.
rhythm-lite supplies Beat This rhythm data; music-semantics-lite supplies CLAP tags and the private similarity vector.
An Agent call must never install a pack, download a model, decode media, or start inference. Direct the user to Settings and the media-card analysis action when the cache is unavailable.