Duplicate a musical part
Retrieve duplicate-musical-part through get_producer_workflow or its MCP prompt when a whole-track alternative is useful. Resolve the exact track or Group and musical purpose first. Reuse an existing identified alternative when appropriate and preserve the original and preferred manual edits.
Plan duplicate_session_object with targetType: "track", exact targetId, an optional name and fresh expectedStateVersion. Explicit names must contain 1 to 128 characters without controls; omission retains the source name. Review trackCopyContext.sourceTracks, both views' clip inventory, device trees, counts, content fingerprints and planned insertion. A Group copy includes its complete subtree, including nested Groups, and appears after that subtree. A child copy remains in its existing parent. Only the new root is renamed.
The updated bridge binds native owners, complete stored notes and exposed audio/timing, processing, mixer/send parameters, hierarchy and surrounding controls. It rechecks at undo entry, duplicates once and names a new root only after locating an exact insertion that retains every original owner in order. Stopped transport, recording and count-in, settled launches and explicitly and implicitly unarmed, unsoloed sources without live-input monitoring are required. Do not silently stop a performance, disarm or reroute an original to bypass refusal.
Limits, including the projected copy, are 256 tracks including Groups, 64 Returns, 1024 scenes, 4096 Session slots plus Arrangement clips, 16384 stored MIDI notes, 512 devices and 32768 device parameters. Audio clips support 4096 warp markers each. Complete reads and comparable native identities are required; content is not sampled or truncated.
Read duplicateRequested, nativeReturned, nameApplied, copiesLocated, createdTracks, copyVerified, originalMaterialPreserved, copyMaterialMatches, copyOwnersDistinct, hierarchyVerified, controlsPreserved, renumberedTrackNames, readbackPending, observed, error and observationError separately. A native return does not establish a verified copy. Exceptions can leave new tracks present. Partial results remain without automatic rollback or replay. Lost Song access retains dispatch facts with unknown observations; a different Song cannot certify the result.
Later callbacks require two matching observations within three attempts without repeating duplication. New native owners must be distinct. Copy comparison allows new note IDs while requiring all other stored note properties to match; original note IDs remain bound. Native Group parents and retained selected routing fields are checked. Only exact index-derived numbered-label changes are recognized. Available routing choices can naturally grow as copies appear.
Track IDs and numbered labels shift. Refresh the inventory and independently inspect all created members and originals, clips in both views, device values, hierarchy and routing. Child names can repeat. The copy inherits source mute and routing state: mute only identified new members through fresh plans for quiet preparation and inspect sends and sidechains. Muting a Group root does not prove every copied contribution is isolated or silent. Resolve further copy-only routing/send changes within scope before an authorized audition.
Hidden plug-in state, full automation envelopes, modulation relationships, frozen-render assets and external file bytes are not verified or backed up. These checks do not establish audio equivalence or independent downstream processing. Editing, playback, destructive conversion and saving retain their own requested scope.