Add new PTSL commands (PT 2025.06+): Import/Spot/CreateAudioClips/BounceTrack#2
Draft
Shimagon wants to merge 1 commit into
Draft
Add new PTSL commands (PT 2025.06+): Import/Spot/CreateAudioClips/BounceTrack#2Shimagon wants to merge 1 commit into
Shimagon wants to merge 1 commit into
Conversation
…ByID, CreateAudioClips, BounceTrack Adds command IDs for 4 new PTSL operations available in Pro Tools 2025.06+: - ImportAudioToClipList (123) → TRACK_STRUCTURE: import WAV/AIFF directly into the session Clip List without dialog friction. - SpotClipsByID (124) → TRACK_STRUCTURE: place clips on a track at a given timecode, by clip ID. - CreateAudioClips (127) → TRACK_STRUCTURE: create audio clips from audio files (companion to SpotClipsByID for stem-based workflows). - BounceTrack (134) → EXPORT: render a single track to a file (per-track stem export). Scope is intentionally minimal — only the enum and permission map are touched. The corresponding high-level MCP tools (e.g. bounce_track) and the streaming event-subscription commands (SubscribeToEvents, PollEvents, UnsubscribeFromEvents) will be sent in follow-up PRs so each can be reviewed independently.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
TL;DR
Adds 4 new PTSL command IDs that became available in Pro Tools 2025.06+ to
src/grpc/commands.ts— enum entries plus their permission-group mappings. Nothing else.What's added
ImportAudioToClipListTRACK_STRUCTURESpotClipsByIDTRACK_STRUCTURECreateAudioClipsTRACK_STRUCTURESpotClipsByID)BounceTrackEXPORTThe three
TRACK_STRUCTUREcommands together unlock a programmatic "drop pre-rendered stems onto tracks at known timecodes" workflow, which is the bottleneck for any AI-assisted arrangement tooling on top of PTSL.BounceTrackis grouped underEXPORTbecause it writes a new audio file to disk; it should be gated by the sameALLOW_WRITES=exportflag asExportMix/ExportClipsAsFiles.Scope discipline
This PR is intentionally enum-only. The following are deferred to separate follow-up PRs so each can be reviewed independently:
bounce_trackMCP tool wrapper (UX layer — name, args, error messages, ALLOW_WRITES gate test).SubscribeToEvents(132),PollEvents(135),UnsubscribeFromEvents(136) — these need streaming RPC plumbing and asubscribe_events/poll_events/unsubscribe_eventsMCP tool surface, which deserves its own review.session_id/ file paths from surfaced PTSL errors) flagged in Critical: state-mutating commands wrongly classified as READ_ONLY (ALLOW_WRITES bypass) #1 as out-of-scope.This PR also has zero overlap with #1 (the
READ_ONLY_COMMANDSbypass fix); they touch different lines and can be merged in either order.Verification
npm install && npm run build(tsc) passes cleanly on this branch.ImportAudioToClipList/SpotClipsByID/CreateAudioClipsmutate session structure (clip references in the.ptx), so they belong withCreateNewTracksunderTRACK_STRUCTURE.BounceTrackwrites a file to disk, so it belongs withExportMix/ExportClipsAsFilesunderEXPORT.PTSL.protoshipped with Pro Tools 2025.06;command_idnumbers themselves are not copyrighted.Marked draft because the maintainer may prefer a different grouping for
ImportAudioToClipList(arguments could be made for a newIMPORTgroup, or forCLIPBOARD) — happy to rename / regroup before merge. Also waiting to confirm the maintainer wants the events-tool work as a separate follow-up vs. bundled.