premiere-pro-mcp
MCP server for Adobe Premiere Pro with 434 core AI video editing tools, a guarded After Effects MOGRT studio, and a capability-aware UXP bridge for supported Premiere workflows.
npm · fingerprint bca6f8cc8e1a1f80b09812ce · repository · RSS
432tools
7recorded versions
45dtracked
changed 1d ago
What changed
Changed 2026-10-17 10:32 UTC
4 descriptions rewritten, 2 schema or annotation changes with the description left byte-identical.
--- pinned/freeze_frame +++ observed/freeze_frame { "annotations": { "destructiveHint": false, - "description": "Create a freeze frame from a clip at a specific time. Exports the frame and imports it back as a still image.", + "description": "Create a freeze frame from a clip at a specific time. Exports the frame, imports it back as a still image, and sets the still's Out mark to duration_seconds so add_to_timeline places it at that length (snapped to the still's frame grid, then to the sequence frame). It does not place the still on the timeline.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, - "description": "Duration of the freeze frame on the timeline (default: 2)", + "description": "Length of the imported still in seconds, written as its Out mark and read back (default: 2, at most 3600).", "type": "number" }, "expected_cep_target": {
--- pinned/inspect_timeline_snapshot +++ observed/inspect_timeline_snapshot { "annotations": { "destructiveHint": false, - "description": "Inspect one exact CEP sequence into version1 canonical snapshot preserving raw tick strings, source/link identities, bounded clips and explicit unknown fields. Host missing lock/effect/transition/marker state remains incomplete; this inspection never implies atomic host state. Re-query from zero after change or truncation.", + "description": "Inspect one exact CEP sequence into version1 canonical snapshot preserving raw tick strings, source/link identities, bounded clips and explicit unknown fields. Track targeted/muted come from the documented track DOM; sync_locked comes from the experimental QE DOM only when this is the active sequence and stays null otherwise. Host missing lock/effect/transition/marker state remains incomplete; this inspection never implies atomic host state. Re-query from zero after change or truncation.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false,
--- pinned/overwrite_clip +++ observed/overwrite_clip { "annotations": { "destructiveHint": false, - "description": "Overwrite a project item onto validated timeline tracks and verify a new source placement at the requested time", + "description": "Overwrite a project item onto validated timeline tracks and verify a new source placement at the requested time. Every video/audio stream the item actually has must land on the requested tracks; a picture-only or sound-only placement (for example 5.1 audio that does not fit a stereo track) is committed_unverified, not verified.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false,
--- pinned/overwrite_from_source +++ observed/overwrite_from_source { "annotations": { "destructiveHint": false, - "description": "Overwrite the clip from the Source Monitor at the playhead position (overwrite edit — replaces existing clips) and verify a new placement on the requested tracks.", + "description": "Overwrite the clip from the Source Monitor at the playhead position (overwrite edit — replaces existing clips) and verify a new placement on the requested tracks. Every video/audio stream the Source Monitor item actually has must land on those tracks; a picture-only or sound-only placement is committed_unverified, not verified.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false,
--- pinned/ripple_remove_timeline_ranges +++ observed/ripple_remove_timeline_ranges { "annotations": { "destructiveHint": false, - "description": "Sequence name or ID; defaults to active sequence.", + "description": "Sequence name or ID; defaults to the active sequence. It must be the active sequence, because the edit runs through QE; another sequence is refused without changes.", "type": "string" } },
--- pinned/save_workflow_checkpoint +++ observed/save_workflow_checkpoint { "annotations": { "destructiveHint": false, - "description": "Strict version1 checkpoint with project_id, sequence_id, snapshot_revision, backup_reference/null, sequence_checkpoint_reference/null, operations[{operation_id,tool,state,receipt_digest/null}].", + "description": "Strict checkpoint: schema_version 1, project_id, sequence_id, snapshot_revision, backup_reference/null, sequence_checkpoint_reference/null, operations[{operation_id,tool,state,receipt_digest/null}]. No other fields.", "type": "object" }, "expected_cep_target": {
Changed 2026-10-12 15:08 UTC
4 descriptions rewritten, 387 schema or annotation changes with the description left byte-identical, 41 tools added.
+ tool added: acknowledge_operation_recovery
--- pinned/add_adjustment_layer +++ observed/add_adjustment_layer { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "track_index": { "description": "Video track index (default: 0)", "type": "number" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/add_audio_keyframes +++ observed/add_audio_keyframes { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "keyframes": { "description": "Array of keyframe objects with time_seconds and level_db", "items": { + "additionalProperties": false, "properties": { "level_db": { "description": "Audio level in dB (maximum +15 dB)", + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/add_custom_metadata_field +++ observed/add_custom_metadata_field { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "field_label": { "description": "Display label for the field", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/add_keyframe +++ observed/add_keyframe { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "node_id": { "description": "Node ID of the clip", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/add_marker +++ observed/add_marker { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "name": { "description": "Name/label for the marker", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/add_marker_to_project_item +++ observed/add_marker_to_project_item { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "item_id": { "description": "Node ID or name of the project item", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/add_markers_batch +++ observed/add_markers_batch { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "markers": { "description": "Markers to create, in any order; they are sorted by time before writing.", "items": { + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/add_text_overlay +++ observed/add_text_overlay { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "start_seconds": { "description": "Start time in seconds (default: 0)", "type": "number" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/add_title +++ observed/add_title { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "lines": { "description": "Text for each of the template's text fields in order (see list_stock_titles). Specify exactly one of text or lines.", "items": { + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/add_to_render_queue +++ observed/add_to_render_queue { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "output_path": { "description": "Full output file path", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/add_to_timeline +++ observed/add_to_timeline { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "item_id": { "description": "Node ID or name of the project item to add", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/add_to_timeline_batch +++ observed/add_to_timeline_batch { "annotations": { "destructiveHint": false, + }, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" } }, "required": [ + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/add_track +++ observed/add_track { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "track_type": { "description": "Type of track to add", "enum": [ + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/add_tracks +++ observed/add_tracks { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "video_tracks": { "description": "Number of video tracks to add (default: 0)", "type": "number" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/add_transition +++ observed/add_transition { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "track_index": { "description": "Video track index (0-based)", "type": "number" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/add_transition_to_clip +++ observed/add_transition_to_clip { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "node_id": { "description": "Node ID of the clip", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/adjust_audio_levels +++ observed/adjust_audio_levels { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "level_db": { "description": "Audio level in dB (0 = unity, negative = quieter, positive = louder)", "type": "number" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/analyze_dialogue_edit_candidates +++ observed/analyze_dialogue_edit_candidates { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "filler_words": { "description": "Exact normalized filler words or phrases to flag for review.", "items": { + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/analyze_loudness +++ observed/analyze_loudness { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "max_true_peak_dbfs": { "description": "Optional maximum acceptable true peak in dBFS (commonly -1 or -2)", "type": "number" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/analyze_video_interlacing +++ observed/analyze_video_interlacing { "annotations": { "destructiveHint": false, + "analysis_revision": { + "description": "Optional project/timeline revision to isolate otherwise-identical analysis inputs.", + "maxLength": 128, + "type": "string" + }, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "media_path": { "description": "Existing local video file", "type": "string" + }, + "use_cache": { + "description": "Opt in to bounded process-memory caching keyed by source path/identity, media content SHA-256, exact options, revision, and analysis version. Files over 256 MiB analyze uncached. Default false.", + "type": "boolean" } }, "required": [ + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/analyze_video_qc +++ observed/analyze_video_qc { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "media_path": { "description": "Path to an existing local video file", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/apply_after_effects_render_handoff +++ observed/apply_after_effects_render_handoff { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "preview_token": { "description": "One-time ten-minute token from preview_after_effects_render_handoff.", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/apply_audio_effect +++ observed/apply_audio_effect { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "node_id": { "description": "Node ID of the clip", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/apply_edit_plan +++ observed/apply_edit_plan { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "plan": { + "additionalProperties": false, "description": "An edit plan: { sequence_id?, operations: [...] } with up to 100 insert_clip and remove_clip operations. Operations run in order, and each one's times refer to the timeline as the operations before it left it.", "properties": { "operations": { + "additionalProperties": false, "properties": { "allow_large_ripple": { "description": "ripple remove_clip: allow execution above large_ripple_threshold after the read-only mover estimate", + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/apply_effect +++ observed/apply_effect { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "node_id": { "description": "Node ID of the clip to apply the effect to", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
+ tool added: apply_extended_edit_plan
--- pinned/apply_lut +++ observed/apply_lut { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "lut_path": { "description": "Full path to the .cube or .3dl LUT file", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/apply_mogrt_premiere_handoff +++ observed/apply_mogrt_premiere_handoff { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "preview_token": { "description": "One-time token returned by preview_mogrt_premiere_handoff.", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
+ tool added: apply_scene_review_workflow
--- pinned/apply_spot_workflow_plan +++ observed/apply_spot_workflow_plan { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "plan": { "description": "Exact plan returned by a preview_*_spot tool", "type": "object" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
+ tool added: apply_stacked_camera_edit
--- pinned/attach_custom_property +++ observed/attach_custom_property { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "property_id": { "description": "Unique identifier for the custom property", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/audit_timeline_health +++ observed/audit_timeline_health { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, "expected_duration_seconds": { "description": "Optional target duration; clips past it and trailing gaps before it are flagged.", "maximum": 86400, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "flash_frame_max_frames": { "description": "Clips lasting this many frames or fewer are flagged as flash frames (default 3).", "maximum": 12, + "additionalProperties": false, "description": "Sequence snapshot to audit.", "properties": { "audioTracks": { + "additionalProperties": false, "description": "One track with its clips. Accepts type/index/clips or raw mediaType/trackIndex/items keys.", "properties": { "clips": { + "additionalProperties": false, "description": "One timeline clip. Accepts the normalized keys below or raw get_sequence_structure / inspect_sequence_structure_uxp keys (nodeId, startSeconds, endSeconds, inPointSeconds, outPointSeconds, enabled, speed, sourceProjectItemId).", "properties": { "disabled": { + "additionalProperties": false, "description": "One track with its clips. Accepts type/index/clips or raw mediaType/trackIndex/items keys.", "properties": { "clips": { + "additionalProperties": false, "description": "One timeline clip. Accepts the normalized keys below or raw get_sequence_structure / inspect_sequence_structure_uxp keys (nodeId, startSeconds, endSeconds, inPointSeconds, outPointSeconds, enabled, speed, sourceProjectItemId).", "properties": { "disabled": { + "additionalProperties": false, "description": "One track with its clips. Accepts type/index/clips or raw mediaType/trackIndex/items keys.", "properties": { "clips": { + "additionalProperties": false, "description": "One timeline clip. Accepts the normalized keys below or raw get_sequence_structure / inspect_sequence_structure_uxp keys (nodeId, startSeconds, endSeconds, inPointSeconds, outPointSeconds, enabled, speed, sourceProjectItemId).", "properties": { "disabled": { + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/auto_reframe_sequence +++ observed/auto_reframe_sequence { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "motion_preset": { "description": "Premiere Auto Reframe motion preset (default: default)", "enum": [ + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/batch_add_transitions +++ observed/batch_add_transitions { "annotations": { - "destructiveHint": false, + "destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "track_index": { "description": "Video track index (0-based, default: 0)", "type": "number" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/batch_apply_effect +++ observed/batch_apply_effect { "annotations": { - "destructiveHint": false, + "destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "target": { "description": "Which clips to apply to: selected clips, all on a track, or all in sequence", "enum": [ + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/batch_enable_disable +++ observed/batch_enable_disable { "annotations": { - "destructiveHint": false, + "destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "target": { "description": "Which clips to affect", "enum": [ + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/batch_rename_clips +++ observed/batch_rename_clips { "annotations": { - "destructiveHint": false, + "destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "pattern": { "description": "Name pattern. Use {n} for a sequential number, ## for a zero-padded two-digit sequence number, and {name} for the original name (e.g., 'Scene_##', '{name}_v2')", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
+ tool added: bind_media_provenance
--- pinned/build_caption_artifact +++ observed/build_caption_artifact { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "format": { "description": "Artifact format. SRT uses HH:MM:SS,mmm; VTT starts with WEBVTT and uses HH:MM:SS.mmm.", "enum": [ + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
+ tool added: build_edit_review_evidence
+ tool added: build_project_handoff_manifest
+ tool added: can_execute
+ tool added: cancel_workflow_job
--- pinned/capture_frame +++ observed/capture_frame { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "time_seconds": { "description": "Time position in seconds to capture. Uses current playhead if omitted.", "type": "number" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/check_caption_safe_zone +++ observed/check_caption_safe_zone { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "frame": { "additionalProperties": false, "description": "Output frame size in pixels; used for orientation checks and pixel readback.", + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/check_offline_media +++ observed/check_offline_media { "annotations": { "destructiveHint": false, + "additionalProperties": false, + "properties": { + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + } + }, "type": "object" }, "name": "check_offline_media", + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/clear_item_in_out +++ observed/clear_item_in_out { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "item_id": { "description": "Node ID or name of the project item", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/clear_sequence_in_out +++ observed/clear_sequence_in_out { "annotations": { "destructiveHint": false, + }, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" } }, "type": "object" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/close_all_source_clips +++ observed/close_all_source_clips { "annotations": { "destructiveHint": true, + "additionalProperties": false, + "properties": { + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + } + }, "type": "object" }, "name": "close_all_source_clips", + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/close_project +++ observed/close_project { "annotations": { "destructiveHint": true, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "project_path": { "description": "Path of the open project to close (default: the active project)", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/close_sequence +++ observed/close_sequence { "annotations": { "destructiveHint": true, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "sequence_id": { "description": "Sequence name or ID. Uses active sequence if omitted.", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/close_source_monitor +++ observed/close_source_monitor { "annotations": { "destructiveHint": true, + "additionalProperties": false, + "properties": { + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + } + }, "type": "object" }, "name": "close_source_monitor", + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/color_correct +++ observed/color_correct { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "exposure": { "description": "Exposure adjustment (-4.0 to 4.0)", "type": "number" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/compare_cmx3600_edls +++ observed/compare_cmx3600_edls { "annotations": { "destructiveHint": false, + }, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" } }, "required": [ + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/compute_mask_fit_motion +++ observed/compute_mask_fit_motion { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "fit_axis": { "description": "Fit the subject's height to placement top/bottom (default) or its width to placement left/right.", "enum": [ + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/consolidate_and_transfer +++ observed/consolidate_and_transfer { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "include_all_sequences": { "description": "Include all sequences (default: true). If false, only active sequence is used.", "type": "boolean" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/consolidate_duplicates +++ observed/consolidate_duplicates { "annotations": { "destructiveHint": false, + "additionalProperties": false, + "properties": { + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + } + }, "type": "object" }, "name": "consolidate_duplicates", + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
+ tool added: convert_timeline_time
--- pinned/copy_effect_values +++ observed/copy_effect_values { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "source_node_id": { "description": "Node ID of the source clip", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/copy_effects_between_clips +++ observed/copy_effects_between_clips { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "source_node_id": { "description": "Node ID of the source clip to copy effects from", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/create_bars_and_tone +++ observed/create_bars_and_tone { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "height": { "description": "Frame height in pixels (default: 1080)", "type": "number" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/create_bin +++ observed/create_bin { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "name": { "description": "Name of the new bin", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/create_caption_track +++ observed/create_caption_track { "annotations": { "destructiveHint": false, - "description": "Import an already reviewed caption artifact into the active sequence, or create a local lecture-caption timing and review workflow plan. Import reports structural success only when the host exposes a caption-track readback; the planning action never contacts Premiere or changes an artifact.", + "description": "Import an already reviewed caption artifact into the active sequence, or create a local lecture-caption timing and review workflow plan. Import rejects unsupported formats before host dispatch and reports structural success only when valid count readback shows exactly one new caption track. Unreadable or unexpected results preserve committed_unverified diagnostics; inspect before retrying. The planning action never contacts Premiere or changes an artifact.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, + "enum": [ + "608", + "708", + "subtitle", + "teletext", + "ebu", + "op42", + "op47" + ], "type": "string" }, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "item_id": { "description": "For action import, the node ID or name of the imported caption project item (for example, an SRT file). Omit for plan_lecture_workflow.", "maxLength": 512, + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/create_context_edit_plan +++ observed/create_context_edit_plan { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "intent": { "description": "Editing goal, such as finding the strongest budget explanation for a rough cut", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/create_editorial_context_pack +++ observed/create_editorial_context_pack { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "intent": { "description": "The editorial question used to retrieve and compact local evidence.", "maxLength": 1000, + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/create_editorial_plan +++ observed/create_editorial_plan { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "intent": { "description": "The editorial goal used to retrieve relevant local evidence.", "maxLength": 1000, + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/create_mogrt_batch +++ observed/create_mogrt_batch { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "preview_token": { "description": "One-time token returned by preview_mogrt_batch.", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/create_mogrt_recipe +++ observed/create_mogrt_recipe { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "preview_token": { "description": "One-time token returned by preview_mogrt_recipe; it expires after 10 minutes.", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/create_project +++ observed/create_project { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "path": { "description": "Full file path for the new .prproj file", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/create_project_backup +++ observed/create_project_backup { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "project_path": { "description": "Absolute or working-directory-relative path to an existing .prproj file", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/create_sequence +++ observed/create_sequence { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "name": { "description": "Name for the new sequence", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/create_sequence_checkpoint +++ observed/create_sequence_checkpoint { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "include_snapshot": { "description": "Return the original sequence's structural snapshot for later diff_sequence_snapshots calls (default true).", "type": "boolean" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/create_sequence_from_clips +++ observed/create_sequence_from_clips { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "item_ids": { "description": "Array of project item names or node IDs to include in order", "items": { + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/create_sequence_from_preset +++ observed/create_sequence_from_preset { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "name": { "description": "Name for the new sequence", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/create_smart_bin +++ observed/create_smart_bin { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "name": { "description": "Name for the smart bin", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/create_subclip +++ observed/create_subclip { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "in_seconds": { "description": "In-point in seconds", "type": "number" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/create_subsequence +++ observed/create_subsequence { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "ignore_track_targeting": { "description": "Whether to ignore track targeting (default: false)", "type": "boolean" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/crop_clip +++ observed/crop_clip { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "left": { "description": "Percent cropped from the left edge.", "maximum": 100, + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/delete_bin +++ observed/delete_bin { "annotations": { "destructiveHint": true, + }, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" } }, "required": [ + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/delete_marker +++ observed/delete_marker { "annotations": { "destructiveHint": true, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "node_id": { "description": "Optional clip node ID (deletes from sequence if omitted). Premiere 25.2.3 timeline clips have no marker collection, so this refuses there.", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/delete_multiple_project_items +++ observed/delete_multiple_project_items { "annotations": { "destructiveHint": true, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "item_ids": { "description": "Array of node IDs or names of items to delete", "items": { + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/delete_preview_files +++ observed/delete_preview_files { "annotations": { "destructiveHint": true, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "media_type": { "description": "Type of preview files to delete: 'video', 'audio', or 'all' (default: 'all')", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/delete_project_item +++ observed/delete_project_item { "annotations": { "destructiveHint": true, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "item_id": { "description": "Node ID or name of the project item to delete", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/delete_sequence +++ observed/delete_sequence { "annotations": { "destructiveHint": true, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "sequence_id": { "description": "Sequence name or ID to delete", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/delete_track +++ observed/delete_track { "annotations": { "destructiveHint": true, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "force": { "description": "Also delete a track that holds clips, removing those clips (default: false)", "type": "boolean" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/deselect_all_clips +++ observed/deselect_all_clips { "annotations": { "destructiveHint": false, + "additionalProperties": false, + "properties": { + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + } + }, "type": "object" }, "name": "deselect_all_clips", + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/detach_proxy +++ observed/detach_proxy { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "item_id": { "description": "Node ID or name of the project item", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/detect_active_picture_bounds +++ observed/detect_active_picture_bounds { "annotations": { "destructiveHint": false, + "analysis_revision": { + "description": "Optional project/timeline revision to isolate otherwise-identical analysis inputs.", + "maxLength": 128, + "type": "string" + }, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "limit": { "description": "Cropdetect black threshold from 0 through 255 (default: 24)", "type": "integer" + }, + "use_cache": { + "description": "Opt in to bounded process-memory caching keyed by source path/identity, media content SHA-256, exact options, revision, and analysis version. Files over 256 MiB analyze uncached. Default false.", + "type": "boolean" } }, "required": [ + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/detect_audio_transients +++ observed/detect_audio_transients { "annotations": { "destructiveHint": false, + "analysis_revision": { + "description": "Optional project/timeline revision to isolate otherwise-identical analysis inputs.", + "maxLength": 128, + "type": "string" + }, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "maximum_events": { "description": "Maximum returned candidates from 1 through 1000 (default: 200)", "type": "integer" + }, + "use_cache": { + "description": "Opt in to bounded process-memory caching keyed by source path/identity, media content SHA-256, exact options, revision, and analysis version. Files over 256 MiB analyze uncached. Default false.", + "type": "boolean" } }, "required": [ + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/detect_beats +++ observed/detect_beats { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "max_beats": { "description": "Maximum beat times returned (default: 500).", "maximum": 2000, + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/detect_motion_peaks +++ observed/detect_motion_peaks { "annotations": { "destructiveHint": false, + "analysis_revision": { + "description": "Optional project/timeline revision to isolate otherwise-identical analysis inputs.", + "maxLength": 128, + "type": "string" + }, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "maximum_events": { "description": "Maximum returned candidates from 1 through 1000 (default: 200)", "type": "integer" + }, + "use_cache": { + "description": "Opt in to bounded process-memory caching keyed by source path/identity, media content SHA-256, exact options, revision, and analysis version. Files over 256 MiB analyze uncached. Default false.", + "type": "boolean" } }, "required": [ + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/detect_repeated_takes +++ observed/detect_repeated_takes { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "frame_rate": { "description": "Timebase used to snap ranges to whole frames; defaults to 30.", "maximum": 240, + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/detect_scene_edits +++ observed/detect_scene_edits { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "mode": { "description": "How Premiere should materialize detected edits on the current native selection.", "enum": [ + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/detect_silence +++ observed/detect_silence { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "media_path": { "description": "Absolute path to the media file to analyse. Provide this or project_item_id.", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/detect_source_scene_changes +++ observed/detect_source_scene_changes { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "maximum_events": { "description": "Maximum returned changes (default: 500; maximum: 2000)", "type": "number" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/diff_sequence_snapshots +++ observed/diff_sequence_snapshots { "annotations": { "destructiveHint": false, + "additionalProperties": false, "description": "Later sequence snapshot.", "properties": { "audioTracks": { + "additionalProperties": false, "description": "One track with its clips. Accepts type/index/clips or raw mediaType/trackIndex/items keys.", "properties": { "clips": { + "additionalProperties": false, "description": "One timeline clip. Accepts the normalized keys below or raw get_sequence_structure / inspect_sequence_structure_uxp keys (nodeId, startSeconds, endSeconds, inPointSeconds, outPointSeconds, enabled, speed, sourceProjectItemId).", "properties": { "disabled": { + "additionalProperties": false, "description": "One track with its clips. Accepts type/index/clips or raw mediaType/trackIndex/items keys.", "properties": { "clips": { + "additionalProperties": false, "description": "One timeline clip. Accepts the normalized keys below or raw get_sequence_structure / inspect_sequence_structure_uxp keys (nodeId, startSeconds, endSeconds, inPointSeconds, outPointSeconds, enabled, speed, sourceProjectItemId).", "properties": { "disabled": { + "additionalProperties": false, "description": "One track with its clips. Accepts type/index/clips or raw mediaType/trackIndex/items keys.", "properties": { "clips": { + "additionalProperties": false, "description": "One timeline clip. Accepts the normalized keys below or raw get_sequence_structure / inspect_sequence_structure_uxp keys (nodeId, startSeconds, endSeconds, inPointSeconds, outPointSeconds, enabled, speed, sourceProjectItemId).", "properties": { "disabled": { + "additionalProperties": false, "description": "Earlier sequence snapshot.", "properties": { "audioTracks": { + "additionalProperties": false, "description": "One track with its clips. Accepts type/index/clips or raw mediaType/trackIndex/items keys.", "properties": { "clips": { + "additionalProperties": false, "description": "One timeline clip. Accepts the normalized keys below or raw get_sequence_structure / inspect_sequence_structure_uxp keys (nodeId, startSeconds, endSeconds, inPointSeconds, outPointSeconds, enabled, speed, sourceProjectItemId).", "properties": { "disabled": { + "additionalProperties": false, "description": "One track with its clips. Accepts type/index/clips or raw mediaType/trackIndex/items keys.", "properties": { "clips": { + "additionalProperties": false, "description": "One timeline clip. Accepts the normalized keys below or raw get_sequence_structure / inspect_sequence_structure_uxp keys (nodeId, startSeconds, endSeconds, inPointSeconds, outPointSeconds, enabled, speed, sourceProjectItemId).", "properties": { "disabled": { + "additionalProperties": false, "description": "One track with its clips. Accepts type/index/clips or raw mediaType/trackIndex/items keys.", "properties": { "clips": { + "additionalProperties": false, "description": "One timeline clip. Accepts the normalized keys below or raw get_sequence_structure / inspect_sequence_structure_uxp keys (nodeId, startSeconds, endSeconds, inPointSeconds, outPointSeconds, enabled, speed, sourceProjectItemId).", "properties": { "disabled": { + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "frame_rate": { "description": "Frame rate override for frame math and timecodes (1..240). Defaults to the snapshot frame rate or 30.", "maximum": 240, + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/duplicate_clip +++ observed/duplicate_clip { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "node_id": { "description": "Node ID of the clip to duplicate", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/duplicate_sequence +++ observed/duplicate_sequence { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "sequence_id": { "description": "Sequence name or ID to duplicate", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/enable_disable_clip +++ observed/enable_disable_clip { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "node_id": { "description": "Node ID of the clip", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/encode_file +++ observed/encode_file { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "in_seconds": { "description": "Optional start time in seconds", "type": "number" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/encode_project_item +++ observed/encode_project_item { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "item_id": { "description": "Node ID or name of the project item to encode", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/enqueue_after_effects_render +++ observed/enqueue_after_effects_render { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "preview_token": { "description": "One-time token returned by preview_after_effects_render.", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/export_aaf +++ observed/export_aaf { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "explode_to_mono": { "description": "Explode multichannel audio to mono (default: false)", "type": "boolean" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
+ tool added: export_and_verify
--- pinned/export_as_fcp_xml +++ observed/export_as_fcp_xml { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "output_path": { "description": "Full output file path (e.g., '/Users/me/export.xml')", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/export_as_project +++ observed/export_as_project { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "output_path": { "description": "Full path for the exported .prproj file", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
+ tool added: export_facility_metadata_table
--- pinned/export_frame +++ observed/export_frame { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "output_path": { "description": "Full output file path (e.g., '/Users/me/frame.png'). Extension determines format.", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/export_omf +++ observed/export_omf { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "handle_frames": { "description": "Handle length in frames when trimming (default: 1000)", "type": "number" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
+ tool added: export_review_markers
--- pinned/export_sequence +++ observed/export_sequence { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "output_path": { "description": "Full output file path (e.g., '/Users/me/exports/video.mp4')", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/export_sequence_clip_review_frames +++ observed/export_sequence_clip_review_frames { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "limit": { "description": "Maximum clips to sample (default: 20; maximum: 50)", "type": "number" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/export_sequence_edl +++ observed/export_sequence_edl { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "frame_rate": { "description": "Override the CMX timecode rate; defaults to the sequence rate (23.976 is written as 24).", "enum": [ + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/export_sequence_marker_review_frames +++ observed/export_sequence_marker_review_frames { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "limit": { "description": "Maximum chronological marker frames to export (default: 12; minimum: 1; maximum: 24).", "type": "number" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/export_sequence_review_frames +++ observed/export_sequence_review_frames { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "frame_count": { "description": "Number of evenly spaced frames to export (default: 6; minimum: 2; maximum: 24)", "type": "number" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/extract_selection +++ observed/extract_selection { "annotations": { "destructiveHint": false, + "additionalProperties": false, + "properties": { + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + } + }, "type": "object" }, "name": "extract_selection", + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/find_items_by_media_path +++ observed/find_items_by_media_path { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "path_search": { "description": "Partial file path to search for", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/find_project_item_by_name +++ observed/find_project_item_by_name { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "name": { "description": "Name of the project item to find", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/freeze_frame +++ observed/freeze_frame { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "output_path": { "description": "Full path for the exported frame (e.g., /path/to/freeze.png)", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/generate_media_contact_sheet +++ observed/generate_media_contact_sheet { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "media_path": { "description": "Existing local video file", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/get_active_sequence +++ observed/get_active_sequence { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "start_seconds": { "description": "Optional inclusive window start; returns overlapping items.", "minimum": 0, + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/get_advanced_feature_support +++ observed/get_advanced_feature_support { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "frameio_entitled": { "description": "Whether the operator has confirmed Frame.io account/project access", "type": "boolean" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/get_all_project_paths +++ observed/get_all_project_paths { "annotations": { "destructiveHint": false, + "additionalProperties": false, + "properties": { + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + } + }, "type": "object" }, "name": "get_all_project_paths", + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/get_av_feature_support +++ observed/get_av_feature_support { "annotations": { "destructiveHint": false, + "additionalProperties": false, + "properties": { + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + } + }, "type": "object" }, "name": "get_av_feature_support", + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/get_bin_contents +++ observed/get_bin_contents { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "limit": { "description": "Maximum direct children to return. Pair with recursive false for the smallest bounded response.", "maximum": 500, + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/get_bridge_telemetry +++ observed/get_bridge_telemetry { "annotations": { "destructiveHint": false, + "additionalProperties": false, + "properties": { + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + } + }, "type": "object" }, "name": "get_bridge_telemetry", + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/get_capabilities +++ observed/get_capabilities { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "tool_limit": { "description": "Maximum tool catalog entries to return. Omit with tool_offset to preserve the complete legacy response.", "maximum": 128, + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/get_caption_style_guidance +++ observed/get_caption_style_guidance { "annotations": { "destructiveHint": false, - "description": "Returns caption style presets (clean, bold_pop, karaoke, podcast, lecture) with font, position, and styling recommendations, plus Premiere UI steps for applying styles. Read-only guidance; NEVER modifies caption tracks. Use build_caption_artifact for SRT/VTT timing, then import via create_caption_track and apply styles manually in Premiere's UI.", + "description": "Read-only caption style guidance: a preset (clean, bold_pop, karaoke, podcast, lecture) and/or a custom_style spec (font, size, fill, up to 3 strokes, shadow, zone, offsets) turned into Premiere 2024+ Properties-panel steps that save a reusable whole-track Track Style. NEVER modifies caption tracks; Premiere has no caption style API.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, + "custom_style": { + "additionalProperties": false, + "description": "Optional caption look to translate into concrete Premiere UI steps. Every field is optional; at least one is required. Values are documentation only and are never applied.", + "properties": { + "fill_color": { + "description": "Text fill colour as #RRGGBB.", + "pattern": "^#[0-9A-Fa-f]{6}$", + "type": "string" + }, + "font_family": { + "description": "Font family name as shown in Premiere, e.g. Source Han Sans TW.", + "maxLength": 128, + "minLength": 1, + "type": "string" + }, + "font_size_px": { + "description": "Font size in Premiere's caption units (pixels).", + "maximum": 400, + "minimum": 8, + "type": "integer" + }, + "font_weight": { + "description": "Font weight or style name, e.g. Heavy or Bold.", + "maxLength": 64, + "minLength": 1, + "type": "string" + }, + "offset_x_px": { + "description": "Horizontal position offset from the zone in pixels.", + "maximum": 2000, + "minimum": -2000, + "type": "integer" + }, + "offset_y_px": { + "description": "Vertical position offset from the zone in pixels; negative moves up.", + "maximum": 2000, + "minimum": -2000, + "type": "integer" + }, + "shadow": { + "additionalProperties": false, + "description": "Drop shadow; omitted fields use the listed defaults.", + "properties": { + "angle": { + "description": "Shadow angle in degrees (default 135).", + "maximum": 360, + "minimum": 0, + "type": "number" + }, + "blur": { + "description": "Shadow blur (default 40).", + "maximum": 100, + "minimum": 0, + "type": "number" + }, + "color": { + "description": "Shadow colour as #RRGGBB (default #000000).", + "pattern": "^#[0-9A-Fa-f]{6}$", + "type": "string" + }, + "distance": { + "description": "Shadow distance (default 7).", + "maximum": 200, + "minimum": 0, + "type": "number" + }, + "opacity": { + "description": "Shadow opacity percent (default 75).", + "maximum": 100, + "minimum": 0, + "type": "number" + }, + "size": { + "description": "Shadow size (default 0).", + "maximum": 100, + "minimum": 0, + "type": "number" + } + }, + "type": "object" + }, + "strokes": { + "description": "Up to three strokes in Premiere's Stroke list order; each stroke after the first is added with + next to Stroke. Layered outer strokes need increasing widths.", + "items": { + "additionalProperties": false, + "description": "One stroke.", + "properties": { + "color": { + "description": "Stroke colour as #RRGGBB.", + "pattern": "^#[0-9A-Fa-f]{6}$", + "type": "string" + }, + "placement": { + "description": "Stroke placement (default outer).", + "enum": [ + "outer", + "inner", + "center" + ], + "type": "string" + }, + "width_px": { + "description": "Stroke width.", + "maximum": 100, + "minimum": 0, + "type": "number" + } + }, + "required": [ + "color", + "width_px" + ], + "type": "object" + }, + "maxItems": 3, + "type": "array" + }, + "track_style_name": { + "description": "Name for the saved Track Style (default Caption Track Style).", + "maxLength": 80, + "minLength": 1, + "type": "string" + }, + "zone": { + "description": "Caption region in Premiere's Align and Transform zone grid.", + "enum": [ + "top_left", + "top_center", + "top_right", + "middle_left", + "middle_center", + "middle_right", + "bottom_left", + "bottom_center", + "bottom_right" + ], + "type": "string" + } + }, + "type": "object" + }, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "preset": { - "description": "Style preset to describe (default clean).", + "description": "Style preset to describe (default clean when custom_style is omitted).", "enum": [ "clean", "bold_pop", + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/get_clip_adjustment_layer +++ observed/get_clip_adjustment_layer { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "node_id": { "description": "Node ID of the clip", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/get_clip_at_playhead +++ observed/get_clip_at_playhead { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "track_type": { "description": "Track type to check (default: both)", "enum": [ + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/get_clip_at_position +++ observed/get_clip_at_position { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "time_seconds": { "description": "Time position in seconds", "type": "number" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/get_clip_links +++ observed/get_clip_links { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "node_id": { "description": "Node ID of the clip", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/get_clip_markers +++ observed/get_clip_markers { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "item_id": { "description": "Node ID or name of the project item", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/get_clip_properties +++ observed/get_clip_properties { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "node_id": { "description": "The node ID of the clip", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/get_clip_speed +++ observed/get_clip_speed { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "node_id": { "description": "Node ID of the clip", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/get_clip_volume +++ observed/get_clip_volume { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "node_id": { "description": "Node ID of the audio clip", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/get_color_label +++ observed/get_color_label { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "item_id": { "description": "Node ID or name of the project item", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/get_color_space +++ observed/get_color_space { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "item_id": { "description": "Node ID or name of the project item", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/get_duplicate_media +++ observed/get_duplicate_media { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "limit": { "description": "Maximum duplicate media groups (a group matches contains when any item name matches) entries to return (1-500, default 100).", "maximum": 500, + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/get_effect_properties +++ observed/get_effect_properties { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "node_id": { "description": "Node ID of the clip", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/get_encoder_presets +++ observed/get_encoder_presets { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "format": { "description": "Filter by container/format (e.g. 'H.264', 'mp4', 'QuickTime', 'WAV') or preset name (e.g. 'ProRes', 'Proxy'). Presets whose format matches come first. Omit to list all.", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/get_export_file_extension +++ observed/get_export_file_extension { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "preset_path": { "description": "Full path to the export preset file (.epr)", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/get_footage_interpretation +++ observed/get_footage_interpretation { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "item_id": { "description": "Node ID or name of the project item", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/get_full_clip_info +++ observed/get_full_clip_info { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "node_id": { "description": "Node ID of the clip on the timeline", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/get_full_project_overview +++ observed/get_full_project_overview { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "include_bin_tree": { "description": "Include the recursive bin tree (default: true). Set false to return project statistics and sequences only.", "type": "boolean" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/get_full_sequence_info +++ observed/get_full_sequence_info { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "sequence_id": { "description": "Sequence name or ID. Uses active sequence if omitted.", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/get_graphics_white_luminance +++ observed/get_graphics_white_luminance { "annotations": { "destructiveHint": false, + "additionalProperties": false, + "properties": { + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + } + }, "type": "object" }, "name": "get_graphics_white_luminance", + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/get_insertion_bin +++ observed/get_insertion_bin { "annotations": { "destructiveHint": false, + "additionalProperties": false, + "properties": { + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + } + }, "type": "object" }, "name": "get_insertion_bin", + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/get_item_info +++ observed/get_item_info { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "item_id": { "description": "Node ID or name of the project item", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/get_keyframes +++ observed/get_keyframes { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "node_id": { "description": "Node ID of the clip", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/get_linked_items +++ observed/get_linked_items { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "node_id": { "description": "Node ID of the clip", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/get_metadata +++ observed/get_metadata { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "include_media_path": { "description": "Opt in to the full source media path, which can identify the local user and folders; default false.", "type": "boolean" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/get_mogrt_component +++ observed/get_mogrt_component { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "expected_values": { "additionalProperties": { "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/get_next_edit_point +++ observed/get_next_edit_point { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "track_type": { "description": "Track type to check (default: both)", "enum": [ + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/get_offline_media +++ observed/get_offline_media { "annotations": { "destructiveHint": false, + "additionalProperties": false, + "properties": { + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + } + }, "type": "object" }, "name": "get_offline_media", + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
+ tool added: get_operation_performance
--- pinned/get_playhead_position +++ observed/get_playhead_position { "annotations": { "destructiveHint": false, + "additionalProperties": false, + "properties": { + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + } + }, "type": "object" }, "name": "get_playhead_position", + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/get_premiere_state +++ observed/get_premiere_state { "annotations": { "destructiveHint": false, + "additionalProperties": false, + "properties": { + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + } + }, "type": "object" }, "name": "get_premiere_state", + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/get_project_info +++ observed/get_project_info { "annotations": { "destructiveHint": false, + "additionalProperties": false, + "properties": { + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + } + }, "type": "object" }, "name": "get_project_info", + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/get_project_item_info +++ observed/get_project_item_info { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "item_id": { "description": "Node ID or name of the project item", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/get_project_panel_metadata +++ observed/get_project_panel_metadata { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "max_chars": { "description": "Maximum characters of metadata XML to return (256-200000, default 20000). Longer XML is cut at this length and reported with truncated: true and totalChars.", "maximum": 200000, + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/get_project_scratch_disks +++ observed/get_project_scratch_disks { "annotations": { "destructiveHint": false, + "additionalProperties": false, + "properties": { + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + } + }, "type": "object" }, "name": "get_project_scratch_disks", + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/get_qe_clip_info +++ observed/get_qe_clip_info { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "track_index": { "description": "Track index (0-based)", "type": "number" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/get_render_queue_status +++ observed/get_render_queue_status { "annotations": { "destructiveHint": false, + "additionalProperties": false, + "properties": { + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + } + }, "type": "object" }, "name": "get_render_queue_status", + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/get_selected_clips +++ observed/get_selected_clips { "annotations": { "destructiveHint": false, + "additionalProperties": false, + "properties": { + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + } + }, "type": "object" }, "name": "get_selected_clips", + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/get_sequence_count +++ observed/get_sequence_count { "annotations": { "destructiveHint": false, + "additionalProperties": false, + "properties": { + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + } + }, "type": "object" }, "name": "get_sequence_count", + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/get_sequence_in_out_points +++ observed/get_sequence_in_out_points { "annotations": { "destructiveHint": false, + "additionalProperties": false, + "properties": { + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + } + }, "type": "object" }, "name": "get_sequence_in_out_points", + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/get_sequence_markers_by_type +++ observed/get_sequence_markers_by_type { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "marker_type": { "description": "Type of marker to filter", "enum": [ + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/get_sequence_settings +++ observed/get_sequence_settings { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "sequence_id": { "description": "Sequence ID or name. Uses active sequence if omitted.", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/get_sequence_structure +++ observed/get_sequence_structure { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "sequence_id": { "description": "Sequence name or ID. Uses active sequence if omitted.", "maxLength": 512, + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/get_source_monitor_info +++ observed/get_source_monitor_info { "annotations": { "destructiveHint": false, + "additionalProperties": false, + "properties": { + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + } + }, "type": "object" }, "name": "get_source_monitor_info", + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/get_source_monitor_position +++ observed/get_source_monitor_position { "annotations": { "destructiveHint": false, + "additionalProperties": false, + "properties": { + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + } + }, "type": "object" }, "name": "get_source_monitor_position", + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/get_target_tracks +++ observed/get_target_tracks { "annotations": { "destructiveHint": false, + "additionalProperties": false, + "properties": { + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + } + }, "type": "object" }, "name": "get_target_tracks", + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/get_timeline_gaps +++ observed/get_timeline_gaps { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "min_gap_seconds": { "description": "Minimum gap duration in seconds to report (default: 0.04 = ~1 frame at 24fps)", "type": "number" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/get_timeline_summary +++ observed/get_timeline_summary { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "sequence_id": { "description": "Sequence name or ID. Uses active sequence if omitted.", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/get_total_clip_count +++ observed/get_total_clip_count { "annotations": { "destructiveHint": false, + "additionalProperties": false, + "properties": { + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + } + }, "type": "object" }, "name": "get_total_clip_count", + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/get_track_info +++ observed/get_track_info { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "track_index": { "description": "Track index (0-based)", "type": "number" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/get_unused_media +++ observed/get_unused_media { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "limit": { "description": "Maximum unused project items entries to return (1-500, default 100).", "maximum": 500, + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/get_used_media_report +++ observed/get_used_media_report { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "sequence_id": { "description": "Sequence name or ID. Uses active sequence if omitted.", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/get_value_at_time +++ observed/get_value_at_time { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "node_id": { "description": "Node ID of the clip", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/get_version_info +++ observed/get_version_info { "annotations": { "destructiveHint": false, + "additionalProperties": false, + "properties": { + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + } + }, "type": "object" }, "name": "get_version_info", + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/get_work_area +++ observed/get_work_area { "annotations": { "destructiveHint": false, + "additionalProperties": false, + "properties": { + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + } + }, "type": "object" }, "name": "get_work_area", + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/get_workspaces +++ observed/get_workspaces { "annotations": { "destructiveHint": false, + "additionalProperties": false, + "properties": { + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + } + }, "type": "object" }, "name": "get_workspaces", + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/get_xmp_metadata +++ observed/get_xmp_metadata { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "include_raw": { "description": "Opt in to raw XMP instead of parsed fields (maximum 256 Ki characters). Requires include_sensitive true; default false.", "type": "boolean" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/has_proxy +++ observed/has_proxy { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "item_id": { "description": "Node ID or name of the project item", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/import_ae_comps +++ observed/import_ae_comps { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "target_bin": { "description": "Target bin name or node ID (optional)", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/import_edl +++ observed/import_edl { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "file_path": { "description": "Absolute path to the CMX 3600 .edl file that was requested for import.", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/import_fcp_xml +++ observed/import_fcp_xml { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "mode": { "description": "new_project (default) opens the XML as a new project saved at project_path. into_open_project imports it into the open project.", "enum": [ + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/import_folder +++ observed/import_folder { "annotations": { "destructiveHint": false, - "description": "Import the media files directly inside a folder and read the destination tree back. Reports observed new media items; unreadable or unmatched imports are committed_unverified.", + "description": "Import the media files directly inside a folder and read the destination tree back. Refuses an unreadable baseline before importing. Reports observed new media items; unreadable or unmatched imports are committed_unverified. Host errors retain partial-change diagnostics; inspect the destination before retrying.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "folder_path": { "description": "Path to the folder to import", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/import_image_sequence +++ observed/import_image_sequence { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "first_file_path": { "description": "Full path to the first image in the sequence (e.g., /path/to/frame_001.png)", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/import_media +++ observed/import_media { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "file_paths": { "description": "Array of file paths to import", "items": { + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/import_mogrt +++ observed/import_mogrt { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "mogrt_path": { "description": "Full path to the .mogrt file", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/import_mogrt_from_library +++ observed/import_mogrt_from_library { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "library_name": { "description": "Name of the Adobe Creative Cloud Library that contains the MOGRT", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/import_sequences +++ observed/import_sequences { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "project_path": { "description": "Full path to the source .prproj file", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/insert_from_source +++ observed/insert_from_source { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "scope": { "description": "Which tracks shift: 'sync_locked' (default) matches Premiere's insert and keeps sync-locked tracks in sync; 'target_tracks' ripples only the named pair and WILL desync other tracks.", "enum": [ + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/inspect_after_effects_render_templates +++ observed/inspect_after_effects_render_templates { "annotations": { "destructiveHint": false, - "properties": {}, + "properties": { + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + } + }, "type": "object" }, "name": "inspect_after_effects_render_templates", + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/inspect_after_effects_template_source +++ observed/inspect_after_effects_template_source { "annotations": { "destructiveHint": false, + }, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" } }, "type": "object" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/inspect_cmx3600_edl +++ observed/inspect_cmx3600_edl { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "path": { "description": "Existing local .edl file", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/inspect_dom_object +++ observed/inspect_dom_object { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "max_depth": { "description": "Max depth for nested inspection (default: 1, max: 3)", "type": "number" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/inspect_edit_readiness +++ observed/inspect_edit_readiness { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "gap_tolerance_seconds": { "description": "Ignore smaller gaps caused by time rounding (default: 0.001)", "type": "number" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/inspect_fcpxml_interchange +++ observed/inspect_fcpxml_interchange { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "path": { "description": "Existing local .fcpxml or .xml file", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/inspect_film_editorial_workflow +++ observed/inspect_film_editorial_workflow { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, "expected_context_revision": { "description": "Exact captured context revision; stale requests fail.", "maxLength": 512, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "expected_source_revision": { "description": "Exact captured source revision.", "maxLength": 512, + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
+ tool added: inspect_interchange_artifact
+ tool added: inspect_interchange_loss_report
--- pinned/inspect_media_streams +++ observed/inspect_media_streams { "annotations": { "destructiveHint": false, + "analysis_revision": { + "description": "Optional project/timeline revision to isolate otherwise-identical analysis inputs.", + "maxLength": 128, + "type": "string" + }, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "media_path": { "description": "Existing local media file", "type": "string" + }, + "use_cache": { + "description": "Opt in to bounded process-memory caching keyed by source path/identity, media content SHA-256, exact options, revision, and analysis version. Files over 256 MiB analyze uncached. Default false.", + "type": "boolean" } }, "required": [ + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/inspect_mogrt_library +++ observed/inspect_mogrt_library { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "library_directory": { "description": "Existing workspace-contained local library root.", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
+ tool added: inspect_operation_recovery
+ tool added: inspect_otio_interchange
--- pinned/inspect_project_item_av_metadata +++ observed/inspect_project_item_av_metadata { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "item_id": { "description": "Project item node ID or exact name", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/inspect_project_recovery +++ observed/inspect_project_recovery { "annotations": { "destructiveHint": false, + "additionalProperties": false, + "properties": { + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + } + }, "type": "object" }, "name": "inspect_project_recovery", + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
+ tool added: inspect_rendered_video_scopes
--- pinned/inspect_sequence_av_settings +++ observed/inspect_sequence_av_settings { "annotations": { "destructiveHint": false, + "additionalProperties": false, + "properties": { + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + } + }, "type": "object" }, "name": "inspect_sequence_av_settings", + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/inspect_sequence_review_report +++ observed/inspect_sequence_review_report { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "include_marker_comments": { "description": "Include marker comments. Defaults to false because comments can contain private editorial notes.", "type": "boolean" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/inspect_stabilizer_status +++ observed/inspect_stabilizer_status { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "node_id": { "description": "Optional clip node ID. Omit to inspect every video clip in the active sequence.", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
+ tool added: inspect_timeline_snapshot
+ tool added: inspect_workflow_checkpoint
+ tool added: inspect_workflow_job
--- pinned/invert_selection +++ observed/invert_selection { "annotations": { "destructiveHint": false, + "additionalProperties": false, + "properties": { + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + } + }, "type": "object" }, "name": "invert_selection", + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/is_work_area_enabled +++ observed/is_work_area_enabled { "annotations": { "destructiveHint": false, - "properties": {}, + "properties": { + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + } + }, "type": "object" }, "name": "is_work_area_enabled", + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/lift_selection +++ observed/lift_selection { "annotations": { "destructiveHint": false, + "additionalProperties": false, + "properties": { + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + } + }, "type": "object" }, "name": "lift_selection", + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/link_selection +++ observed/link_selection { "annotations": { "destructiveHint": false, + "additionalProperties": false, + "properties": { + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + } + }, "type": "object" }, "name": "link_selection", + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/list_available_audio_effects +++ observed/list_available_audio_effects { "annotations": { "destructiveHint": false, + "additionalProperties": false, + "properties": { + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + } + }, "type": "object" }, "name": "list_available_audio_effects", + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/list_available_audio_transitions +++ observed/list_available_audio_transitions { "annotations": { "destructiveHint": false, + "additionalProperties": false, + "properties": { + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + } + }, "type": "object" }, "name": "list_available_audio_transitions", + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/list_available_effects +++ observed/list_available_effects { "annotations": { "destructiveHint": false, + "additionalProperties": false, + "properties": { + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + } + }, "type": "object" }, "name": "list_available_effects", + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/list_available_transitions +++ observed/list_available_transitions { "annotations": { "destructiveHint": false, + "additionalProperties": false, + "properties": { + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + } + }, "type": "object" }, "name": "list_available_transitions", + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/list_clip_effects +++ observed/list_clip_effects { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "node_id": { "description": "Node ID of the clip to inspect", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/list_markers +++ observed/list_markers { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "node_id": { "description": "Optional clip node ID to list clip markers instead of sequence markers", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/list_project_items +++ observed/list_project_items { "annotations": { "destructiveHint": false, + }, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" } }, "type": "object" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/list_sequence_checkpoints +++ observed/list_sequence_checkpoints { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "sequence_id": { "description": "Only list checkpoints of this sequence (ID or name).", "maxLength": 512, + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/list_sequence_tracks +++ observed/list_sequence_tracks { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "sequence_id": { "description": "Sequence ID or name. Uses active sequence if omitted.", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/list_sequences +++ observed/list_sequences { "annotations": { "destructiveHint": false, + "additionalProperties": false, + "properties": { + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + } + }, "type": "object" }, "name": "list_sequences", + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/list_stock_titles +++ observed/list_stock_titles { "annotations": { "destructiveHint": false, + }, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" } }, "type": "object" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/lock_track +++ observed/lock_track { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "locked": { "description": "True to lock, false to unlock", "type": "boolean" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/manage_media_watch +++ observed/manage_media_watch { "annotations": { - "destructiveHint": false, + "destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "recursive": { "description": "Monitor contained subdirectories; defaults to false.", "type": "boolean" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/manage_project_context +++ observed/manage_project_context { "annotations": { "destructiveHint": true, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "project_id": { "description": "Project context ID returned by capture; optional for status to list projects", "type": "string" + "additionalProperties": false, "properties": { "end_seconds": { "type": "number" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/manage_proxies +++ observed/manage_proxies { "annotations": { - "destructiveHint": false, + "destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "item_id": { "description": "Node ID or name of the project item", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
+ tool added: map_keyframe_time_domain
--- pinned/map_source_ranges_to_timeline +++ observed/map_source_ranges_to_timeline { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "media_path": { "description": "Exact media path returned by Premiere to match. Provide this or source_project_item_id.", "type": "string" + "additionalProperties": false, "properties": { "end_seconds": { "description": "Exclusive end in source-media seconds; must exceed start_seconds.", + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
+ tool added: map_word_timeline_occurrences
--- pinned/match_frame +++ observed/match_frame { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "track_index": { "description": "Track index (default: 0)", "type": "number" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/move_clip +++ observed/move_clip { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "new_start_seconds": { "description": "New start time in seconds", "type": "number" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/move_clip_to_track +++ observed/move_clip_to_track { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "node_id": { "description": "Node ID of the clip", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/move_item_to_bin +++ observed/move_item_to_bin { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "item_id": { "description": "Node ID or name of the item to move", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/move_items_to_bin +++ observed/move_items_to_bin { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "item_ids": { "description": "Array of node IDs or names of items to move", "items": { + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/move_playhead_to_edit +++ observed/move_playhead_to_edit { "annotations": { "destructiveHint": false, + }, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" } }, "type": "object" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/multiple_undo +++ observed/multiple_undo { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "expected_undo_stack_index": { "description": "Required safety guard: the undoStackIndex a tool result reported right after the call you want to reverse. The step is refused, with nothing changed, when Premiere's undo-stack position differs from it. The guard compares the position only; matching position cannot prove which action is on top.", "type": "number" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/mute_track +++ observed/mute_track { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "muted": { "description": "True to mute, false to unmute", "type": "boolean" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/navigate_playhead +++ observed/navigate_playhead { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "frames": { "description": "Frames to step for step_forward/step_backward (default 1).", "maximum": 10000, + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/nest_clips +++ observed/nest_clips { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "name": { "description": "Name for the nested sequence", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/normalize_loudness_file +++ observed/normalize_loudness_file { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "input_path": { "description": "Existing local audio or video file", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/open_in_source +++ observed/open_in_source { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "item_id": { "description": "Node ID or name of the project item to open", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/open_project +++ observed/open_project { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "path": { "description": "Full file path to the .prproj file", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/overwrite_clip +++ observed/overwrite_clip { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "item_id": { "description": "Node ID or name of the project item to add", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/overwrite_from_source +++ observed/overwrite_from_source { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "video_track_index": { "description": "Target video track index (default: 0)", "type": "number" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/paste_clip_attributes +++ observed/paste_clip_attributes { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "source_node_id": { "description": "Node ID of the source timeline clip in the active sequence whose attributes are copied", "maxLength": 512, + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/ping +++ observed/ping { "annotations": { "destructiveHint": false, + "additionalProperties": false, + "properties": { + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + } + }, "type": "object" }, "name": "ping", + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/plan_active_speaker_reframe +++ observed/plan_active_speaker_reframe { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "frame_rate": { "description": "Sequence frame rate used to snap times to frames; defaults to 30.", "maximum": 240, + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
+ tool added: plan_audio_post_turnover
--- pinned/plan_beat_montage +++ observed/plan_beat_montage { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "frame_rate": { "description": "Sequence frame rate used to snap shot boundaries; defaults to 30.", "maximum": 240, + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/plan_chapter_markers +++ observed/plan_chapter_markers { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "frame_rate": { "description": "Frame rate used to snap start/end frames; defaults to 30.", "maximum": 240, + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/plan_client_notes_checklist +++ observed/plan_client_notes_checklist { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "fixed_marker_color": { "description": "Color index used when marker_color_mode is fixed (default 3 = orange).", "maximum": 7, + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/plan_cross_app_workflow +++ observed/plan_cross_app_workflow { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "workflow": { "description": "Supported After Effects to Premiere handoff to plan.", "enum": [ + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/plan_emphasis_zoom_keyframes +++ observed/plan_emphasis_zoom_keyframes { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "frame": { "additionalProperties": false, "description": "Sequence frame size in pixels; defaults to 1080x1920.", + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/plan_filler_word_removal +++ observed/plan_filler_word_removal { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "filler_words": { "description": "Filler words or multi-word phrases to remove (matched as consecutive normalized tokens). Defaults to: um, uh, er, ah, hmm, you know, i mean, sort of, kind of. 'like' is only removed when listed explicitly.", "items": { + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
+ tool added: plan_media_synchronization
--- pinned/plan_multicam_angle_switches +++ observed/plan_multicam_angle_switches { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "frame_rate": { "description": "Sequence frame rate for snapping cut points; defaults to 30.", "maximum": 240, + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
+ tool added: plan_music_remix
--- pinned/plan_pause_tightening +++ observed/plan_pause_tightening { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "frame_rate": { "description": "Timebase used to snap ranges to whole frames; defaults to 30.", "maximum": 240, + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/plan_platform_delivery_matrix +++ observed/plan_platform_delivery_matrix { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "export_preset_hint": { "description": "Optional export preset name to echo into the export step.", "maxLength": 256, + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/plan_reaction_captions +++ observed/plan_reaction_captions { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "frame_rate": { "description": "Sequence frame rate used to snap times to frames; defaults to 30.", "maximum": 240, + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
+ tool added: plan_scene_segments
--- pinned/plan_short_export_folder +++ observed/plan_short_export_folder { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "export_root": { "description": "Absolute Shorts export root, for example the ALL Shorts or Cafe Exports folder.", "maxLength": 4096, + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/plan_short_subscribe_cta +++ observed/plan_short_subscribe_cta { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "frame_rate": { "description": "Sequence frame rate used to snap times to frames; defaults to 30.", "maximum": 240, + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/plan_shot_match +++ observed/plan_shot_match { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "reference_media_path": { "description": "Existing local reference video file", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/plan_silence_review_markers +++ observed/plan_silence_review_markers { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "max_candidates": { "description": "Maximum candidate ranges to return (default: 50, maximum: 200).", "type": "number" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/plan_speaker_checkerboard +++ observed/plan_speaker_checkerboard { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "frame_rate": { "description": "Sequence frame rate used to snap times to frames; defaults to 30.", "maximum": 240, + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/plan_word_mute_ranges +++ observed/plan_word_mute_ranges { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "frame_rate": { "description": "Timebase used to snap ranges to whole frames; defaults to 30.", "maximum": 240, + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/play_source_monitor +++ observed/play_source_monitor { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "speed": { "description": "Playback speed (1.0 = normal, 2.0 = 2x, -1.0 = reverse). Default: 1.0", "type": "number" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/play_timeline +++ observed/play_timeline { "annotations": { "destructiveHint": false, + "additionalProperties": false, + "properties": { + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + } + }, "type": "object" }, "name": "play_timeline", + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
+ tool added: predict_timeline_edit
+ tool added: prepare_transcript_workflow
--- pinned/preview_after_effects_render +++ observed/preview_after_effects_render { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "output_module_template": { "description": "Exact After Effects output-module template name.", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/preview_after_effects_render_handoff +++ observed/preview_after_effects_render_handoff { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "output_path": { "description": "Existing completed .mov, .mp4, .mxf, .avi or .wav render; image sequences are not supported.", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/preview_brand_spot +++ observed/preview_brand_spot { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "mogrt_path": { "description": "Optional absolute .mogrt path, which must be inside approved_workspace_path.", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/preview_edit_plan +++ observed/preview_edit_plan { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "plan": { + "additionalProperties": false, "description": "An edit plan: { sequence_id?, operations: [...] } with up to 100 insert_clip and remove_clip operations. Operations run in order, and each one's times refer to the timeline as the operations before it left it.", "properties": { "operations": { + "additionalProperties": false, "properties": { "allow_large_ripple": { "description": "ripple remove_clip: allow execution above large_ripple_threshold after the read-only mover estimate", + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/preview_editorial_plan +++ observed/preview_editorial_plan { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "plan": { "description": "Unchanged plan returned by create_editorial_plan from this running server instance.", "type": "object" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
+ tool added: preview_extended_edit_plan
+ tool added: preview_facility_metadata_intake
--- pinned/preview_mogrt_batch +++ observed/preview_mogrt_batch { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "output_directory": { "description": "Existing workspace-contained directory for every batch artifact.", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/preview_mogrt_library_publish +++ observed/preview_mogrt_library_publish { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "library_directory": { "description": "Existing workspace-contained local library root.", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/preview_mogrt_premiere_handoff +++ observed/preview_mogrt_premiere_handoff { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "mogrt_path": { "description": "Existing workspace-contained MOGRT artifact.", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/preview_mogrt_recipe +++ observed/preview_mogrt_recipe { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "frame_rate": { "description": "Composition frame rate; defaults to 30.", "enum": [ + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/preview_motion_graphics_demo +++ observed/preview_motion_graphics_demo { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "sequence_id": { "description": "Exact ID of an existing empty destination sequence. It must be active at apply time.", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
+ tool added: preview_otio_snapshot_export
--- pinned/preview_product_spot +++ observed/preview_product_spot { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "motion_style": { "description": "Scale-motion style for product and brand spots; defaults to alternate.", "enum": [ + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/preview_project_intake +++ observed/preview_project_intake { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "include_paths": { "description": "Include observed media paths in findings. Defaults to false; hashes are returned instead.", "type": "boolean" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
+ tool added: preview_scene_review_workflow
+ tool added: preview_stacked_camera_edit
--- pinned/preview_watched_media_import +++ observed/preview_watched_media_import { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "include_paths": { "description": "Explicitly disclose contained paths for selected imports; defaults to false.", "type": "boolean" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/preview_workflow_recipe +++ observed/preview_workflow_recipe { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "provided_inputs": { "description": "Names of inputs already available to the caller; values are intentionally not persisted in the recipe preview.", "items": { + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/publish_mogrt_to_library +++ observed/publish_mogrt_to_library { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "preview_token": { "description": "One-time token returned by preview_mogrt_library_publish.", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/rank_short_form_candidates +++ observed/rank_short_form_candidates { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "frame_rate": { "description": "Frame rate used to snap start/end frames; defaults to 30.", "maximum": 240, + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/razor_all_tracks +++ observed/razor_all_tracks { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "time_seconds": { "description": "Time to razor at in seconds (uses playhead position if omitted)", "type": "number" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/read_sequence_captions +++ observed/read_sequence_captions { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "sequence_id": { "description": "Sequence ID or name. Defaults to the active sequence.", "maxLength": 512, + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/read_video_scopes +++ observed/read_video_scopes { "annotations": { "destructiveHint": false, + "analysis_revision": { + "description": "Optional project/timeline revision to isolate otherwise-identical analysis inputs.", + "maxLength": 128, + "type": "string" + }, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "media_path": { "description": "Existing local video file", "type": "string" + }, + "use_cache": { + "description": "Opt in to bounded process-memory caching keyed by source path/identity, media content SHA-256, exact options, revision, and analysis version. Files over 256 MiB analyze uncached. Default false.", + "type": "boolean" } }, "required": [ + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/redo +++ observed/redo { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "expected_undo_stack_index": { "description": "Required safety guard: the undoStackIndexAfter reported by the undo you want to redo. The step is refused, with nothing changed, when Premiere's undo-stack position differs from it. The guard compares the position only; matching position cannot prove which action is on top.", "type": "number" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/refresh_media +++ observed/refresh_media { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "item_id": { "description": "Node ID or name of the item to refresh", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/relink_media +++ observed/relink_media { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "item_id": { "description": "Node ID or name of the item to relink", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/remove_all_effects +++ observed/remove_all_effects { "annotations": { "destructiveHint": true, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "node_id": { "description": "Node ID of the clip", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/remove_effect +++ observed/remove_effect { "annotations": { "destructiveHint": true, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "node_id": { "description": "Node ID of the clip", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/remove_effect_by_name +++ observed/remove_effect_by_name { "annotations": { "destructiveHint": true, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "node_id": { "description": "Node ID of the clip", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/remove_from_timeline +++ observed/remove_from_timeline { "annotations": { "destructiveHint": true, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "include_linked": { "description": "Also remove the clip's linked audio/video partners (default: true). A ripple removal always includes them, since closing the gap on one side only would desync the timeline.", "type": "boolean" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/remove_keyframe +++ observed/remove_keyframe { "annotations": { "destructiveHint": true, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "node_id": { "description": "Node ID of the clip", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/remove_keyframe_range +++ observed/remove_keyframe_range { "annotations": { "destructiveHint": true, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "node_id": { "description": "Node ID of the clip", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/remove_selected_clips +++ observed/remove_selected_clips { "annotations": { "destructiveHint": true, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "ripple": { "description": "Ripple removal is unsupported and refused before editing. Default: false", "type": "boolean" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/rename_bin +++ observed/rename_bin { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "new_name": { "description": "New name for the bin", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/rename_clip +++ observed/rename_clip { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "new_name": { "description": "New name for the clip", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/rename_project_item +++ observed/rename_project_item { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "item_id": { "description": "Node ID or name of the project item", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/rename_track +++ observed/rename_track { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "name": { "description": "New track name", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/replace_clip +++ observed/replace_clip { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "new_item_id": { "description": "Node ID or name of the new project item to replace with", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/replace_clip_media +++ observed/replace_clip_media { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "new_item_id": { "description": "Node ID or name of the new source project item", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/reverse_clip +++ observed/reverse_clip { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "node_id": { "description": "Node ID of the clip", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/review_broll_placements +++ observed/review_broll_placements { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "expected_review_revision": { "description": "Revision from the initial review; required when selecting or rejecting entries. A changed input requires a new review.", "pattern": "^sha256:[a-f0-9]{64}$", + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/review_dialogue_candidates +++ observed/review_dialogue_candidates { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "expected_review_revision": { "description": "Revision from the initial review; required when selecting or rejecting entries. A changed input requires a new review.", "pattern": "^sha256:[a-f0-9]{64}$", + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/review_quote_paper_edit +++ observed/review_quote_paper_edit { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "expected_review_revision": { "description": "Revision from the initial review; required when selecting or rejecting entries. A changed input requires a new review.", "pattern": "^sha256:[a-f0-9]{64}$", + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/review_sync_evidence +++ observed/review_sync_evidence { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "expected_review_revision": { "description": "Revision from the initial review; required when selecting or rejecting entries. A changed input requires a new review.", "pattern": "^sha256:[a-f0-9]{64}$", + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/review_text_changes +++ observed/review_text_changes { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "expected_review_revision": { "description": "Revision from the initial review; required when selecting or rejecting entries. A changed input requires a new review.", "pattern": "^sha256:[a-f0-9]{64}$", + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/ripple_delete +++ observed/ripple_delete { "annotations": { "destructiveHint": true, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "large_ripple_threshold": { "description": "Mover count above which ripple_delete refuses unless allow_large_ripple is true (default: 400).", "maximum": 5000, + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/ripple_remove_timeline_ranges +++ observed/ripple_remove_timeline_ranges { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "range_content": { "description": "Delete clips fully inside each removed range.", "enum": [ + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/roll_edit +++ observed/roll_edit { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "include_linked": { "description": "Also apply the edit to the clip's linked audio/video partners so picture and sound stay in sync (default: true).", "type": "boolean" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/save_project +++ observed/save_project { "annotations": { "destructiveHint": false, + "additionalProperties": false, + "properties": { + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + } + }, "type": "object" }, "name": "save_project", + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/save_project_as +++ observed/save_project_as { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "path": { "description": "Full file path to save the project to (e.g., '/Users/me/projects/MyProject.prproj')", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
+ tool added: save_workflow_checkpoint
--- pinned/scene_edit_detection +++ observed/scene_edit_detection { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "sensitivity": { "description": "Scene-detection sensitivity (default: MediumSensitivity)", "enum": [ + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/search_project_context +++ observed/search_project_context { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "kinds": { "description": "Optional context-kind filter", "items": { + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/search_project_items +++ observed/search_project_items { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "extension": { "description": "Filter by file extension (e.g., 'mp4', 'wav', 'png'). Without dot.", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/search_workflow_recipes +++ observed/search_workflow_recipes { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "query": { "description": "Optional case-insensitive title, description, tag, or ID query.", "maxLength": 256, + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/select_all_clips +++ observed/select_all_clips { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "track_index": { "description": "Specific track index (optional, selects all tracks if omitted)", "type": "number" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/select_clips_by_color +++ observed/select_clips_by_color { "annotations": { "destructiveHint": false, + }, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" } }, "required": [ + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/select_clips_by_name +++ observed/select_clips_by_name { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "name": { "description": "Clip name to search for (case-insensitive substring match)", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/select_clips_by_pattern +++ observed/select_clips_by_pattern { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "include_disabled": { "description": "Include disabled clips as candidates (default true).", "type": "boolean" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/select_clips_in_range +++ observed/select_clips_in_range { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "start_seconds": { "description": "Start of selection range in seconds", "type": "number" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/select_disabled_clips +++ observed/select_disabled_clips { "annotations": { "destructiveHint": false, + "additionalProperties": false, + "properties": { + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + } + }, "type": "object" }, "name": "select_disabled_clips", + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/select_item +++ observed/select_item { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "item_id": { "description": "Node ID or name of the project item to select", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/set_active_sequence +++ observed/set_active_sequence { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "sequence_id": { "description": "Sequence name or ID to make active", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/set_all_tracks_targeted +++ observed/set_all_tracks_targeted { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "targeted": { "description": "Whether to target (true) or untarget (false) all tracks", "type": "boolean" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/set_anti_alias_quality +++ observed/set_anti_alias_quality { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "node_id": { "description": "Node ID of the clip", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/set_blend_mode +++ observed/set_blend_mode { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "node_id": { "description": "Node ID of the video clip", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/set_clip_anchor_point +++ observed/set_clip_anchor_point { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "node_id": { "description": "Node ID of the clip", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/set_clip_duration +++ observed/set_clip_duration { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "include_linked": { "description": "Also apply the edit to the clip's linked audio/video partners, as Premiere does with linked selection (default: true).", "type": "boolean" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/set_clip_opacity +++ observed/set_clip_opacity { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "node_id": { "description": "Node ID of the clip", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/set_clip_pan +++ observed/set_clip_pan { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "node_id": { "description": "Node ID of the audio clip", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/set_clip_position +++ observed/set_clip_position { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "node_id": { "description": "Node ID of the clip", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/set_clip_properties +++ observed/set_clip_properties { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "node_id": { "description": "Node ID of the clip", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/set_clip_properties_batch +++ observed/set_clip_properties_batch { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "items": { "description": "Each item changes one or more supported opacity, Motion scale, position, or rotation values.", "items": { + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/set_clip_rotation +++ observed/set_clip_rotation { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "node_id": { "description": "Node ID of the clip", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/set_clip_scale +++ observed/set_clip_scale { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "node_id": { "description": "Node ID of the clip", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/set_clip_selection +++ observed/set_clip_selection { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "node_id": { "description": "Node ID of the clip", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/set_clip_speed_qe +++ observed/set_clip_speed_qe { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "node_id": { "description": "Node ID of the clip", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/set_clip_start_time +++ observed/set_clip_start_time { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "item_id": { "description": "Node ID or name of the project item", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/set_clip_volume +++ observed/set_clip_volume { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "node_id": { "description": "Node ID of the audio clip", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/set_clips_volume +++ observed/set_clips_volume { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "track_index": { "description": "Audio track index (0-based)", "type": "number" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/set_color_label +++ observed/set_color_label { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "item_id": { "description": "Node ID or name of the project item", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/set_color_value +++ observed/set_color_value { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "green": { "description": "Green (0-255)", "type": "number" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/set_effect_property +++ observed/set_effect_property { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "node_id": { "description": "Node ID of the clip", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/set_footage_interpretation +++ observed/set_footage_interpretation { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "field_type": { "description": "Field order of interlaced footage: 0 = progressive, 1 = upper field first, 2 = lower field first", "type": "integer" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/set_frame_blend +++ observed/set_frame_blend { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "node_id": { "description": "Node ID of the clip", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/set_graphics_white_luminance +++ observed/set_graphics_white_luminance { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "luminance": { "description": "White luminance value in nits", "type": "number" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/set_item_in_out +++ observed/set_item_in_out { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "in_seconds": { "description": "In point in seconds", "type": "number" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/set_keyframe_interpolation +++ observed/set_keyframe_interpolation { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "interpolation": { "description": "Interpolation type", "enum": [ + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/set_metadata +++ observed/set_metadata { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "expected_value": { "description": "Optional compare-and-set guard for field_name writes.", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/set_offline +++ observed/set_offline { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "item_id": { "description": "Node ID or name of the project item", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/set_override_frame_rate +++ observed/set_override_frame_rate { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "frame_rate": { "description": "Frame rate to set (e.g., 23.976, 24, 29.97, 30, 60)", "type": "number" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/set_override_pixel_aspect_ratio +++ observed/set_override_pixel_aspect_ratio { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "item_id": { "description": "Node ID or name of the project item", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/set_playhead_position +++ observed/set_playhead_position { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "time_seconds": { "description": "Time position in seconds to move the playhead to (0 to the sequence end)", "type": "number" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/set_poster_frame +++ observed/set_poster_frame { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "item_id": { "description": "Node ID or name of the project item", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/set_project_item_audio_channel_mapping +++ observed/set_project_item_audio_channel_mapping { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "item_id": { "description": "Project item node ID or exact name", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/set_project_panel_metadata +++ observed/set_project_panel_metadata { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "metadata_xml": { "description": "XML string containing the project panel metadata configuration", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/set_project_scratch_disk +++ observed/set_project_scratch_disk { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "save_and_verify": { "description": "Save the project afterwards and confirm the saved scratch-disk settings (default: false). Premiere has no scratch-disk getter, so without this the result is unverified.", "type": "boolean" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/set_scale_to_frame_size +++ observed/set_scale_to_frame_size { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "item_id": { "description": "Timeline clip node ID in the active sequence, or project item node ID or name", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/set_scale_width_height +++ observed/set_scale_width_height { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "node_id": { "description": "Node ID of the clip", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/set_scratch_disk_path +++ observed/set_scratch_disk_path { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "path": { "description": "Absolute path of an existing folder, or \"SameAsProject\"", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/set_sequence_audio_settings +++ observed/set_sequence_audio_settings { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "sample_rate": { "description": "Audio sample rate (e.g., 44100, 48000, 96000)", "type": "number" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/set_sequence_display_format +++ observed/set_sequence_display_format { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "video_display_format": { "description": "Video: 100=24 Timecode, 101=25 Timecode, 102=29.97 Drop-frame, 103=29.97 Non-drop-frame, 104=30 Timecode, 105=50 Timecode, 106=59.94 Drop-frame, 107=59.94 Non-drop-frame, 108=60 Timecode, 109=Frames, 110=23.976 Timecode, 111=Feet+Frames 16mm, 112=Feet+Frames 35mm, 113=48 Timecode. 0-13 are accepted as 100-113.", "type": "number" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/set_sequence_field_type +++ observed/set_sequence_field_type { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "field_type": { "description": "0=No Fields (Progressive), 1=Upper Field First, 2=Lower Field First", "type": "number" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/set_sequence_frame_rate +++ observed/set_sequence_frame_rate { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "frame_rate": { "description": "New frame rate (e.g., 23.976, 24, 25, 29.97, 30, 50, 59.94, 60)", "maximum": 240, + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/set_sequence_in_out_points +++ observed/set_sequence_in_out_points { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "in_seconds": { "description": "In-point in seconds (0 or later)", "type": "number" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/set_sequence_pixel_aspect_ratio +++ observed/set_sequence_pixel_aspect_ratio { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "ratio": { "description": "Pixel aspect ratio string (for example '1.0' for square pixels or '1.4222' for 16:9 DV).", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/set_sequence_resolution +++ observed/set_sequence_resolution { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "height": { "description": "Height in pixels", "type": "number" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/set_sequence_settings +++ observed/set_sequence_settings { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "height": { "description": "Frame height in pixels", "type": "number" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/set_source_in_out +++ observed/set_source_in_out { "annotations": { "destructiveHint": false, - "additionalProperties": false, "anyOf": [ { "required": [ + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "in_seconds": { "description": "In point in seconds. Provide this, out_seconds, or both.", "minimum": 0, + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/set_start_time +++ observed/set_start_time { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "item_id": { "description": "Node ID or name of the project item", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/set_target_track +++ observed/set_target_track { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "targeted": { "description": "Whether to target (true) or untarget (false) the track", "type": "boolean" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/set_time_interpolation +++ observed/set_time_interpolation { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "interpolation_type": { "description": "0 = Frame Sampling, 1 = Frame Blending, 2 = Optical Flow", "type": "number" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/set_transcode_on_ingest +++ observed/set_transcode_on_ingest { "annotations": { "destructiveHint": false, + }, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" } }, "required": [ + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/set_uniform_scale +++ observed/set_uniform_scale { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "node_id": { "description": "Node ID of the clip", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/set_work_area +++ observed/set_work_area { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "in_seconds": { "description": "Work area in-point in seconds", "type": "number" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/set_workspace +++ observed/set_workspace { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "name": { "description": "Name of the workspace to activate (use get_workspaces to see available options)", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/set_xmp_metadata +++ observed/set_xmp_metadata { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "item_id": { "description": "Node ID or name of the project item", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/set_zero_point +++ observed/set_zero_point { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "sequence_id": { "description": "Sequence name or ID. Uses active sequence if omitted.", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/setup_ducking +++ observed/setup_ducking { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "fade_seconds": { "description": "Fade length on each side of a window in seconds (defaults to 0.2).", "exclusiveMinimum": 0, + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/slide_edit +++ observed/slide_edit { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "include_linked": { "description": "Also apply the edit to the clip's linked audio/video partners so picture and sound stay in sync (default: true).", "type": "boolean" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/slip_edit +++ observed/slip_edit { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "include_linked": { "description": "Also apply the edit to the clip's linked audio/video partners so picture and sound stay in sync (default: true).", "type": "boolean" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/speed_change +++ observed/speed_change { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "node_id": { "description": "Node ID of the clip", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/split_clip +++ observed/split_clip { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "time_seconds": { "description": "Timeline time in seconds where clips on the selected track will split", "minimum": 0, + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/stabilize_clip +++ observed/stabilize_clip { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "method": { "description": "Stabilization method (default: 'Subspace Warp')", "enum": [ + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/start_batch_encode +++ observed/start_batch_encode { "annotations": { "destructiveHint": false, + "additionalProperties": false, + "properties": { + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + } + }, "type": "object" }, "name": "start_batch_encode", + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
+ tool added: start_local_analysis_job
--- pinned/stop_playback +++ observed/stop_playback { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "target": { "description": "What to stop. Default \"timeline\". \"source\" is refused because no documented API stops only the Source Monitor.", "enum": [ + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/toggle_track_visibility +++ observed/toggle_track_visibility { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "track_index": { "description": "Video track index (0-based)", "type": "number" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/trim_clip +++ observed/trim_clip { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "include_linked": { "description": "Also apply the edit to the clip's linked audio/video partners, as Premiere does with linked selection (default: true).", "type": "boolean" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/undo +++ observed/undo { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "expected_undo_stack_index": { "description": "Required safety guard: the undoStackIndex a tool result reported right after the call you want to reverse. The step is refused, with nothing changed, when Premiere's undo-stack position differs from it. The guard compares the position only; matching position cannot prove which action is on top.", "type": "number" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/unlink_selection +++ observed/unlink_selection { "annotations": { "destructiveHint": false, + "additionalProperties": false, + "properties": { + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + } + }, "type": "object" }, "name": "unlink_selection", + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/unnest_sequence +++ observed/unnest_sequence { "annotations": { "destructiveHint": false, - "description": "Unnest a nested sequence clip, replacing it with the nested sequence's clips at their exact source in/out and timeline positions. Refuses without changing anything when the nest is trimmed, retimed, linked to a partner clip, or when the destination range is occupied or locked. Re-reads every placed clip and reports failure with Undo guidance if any start or source range differs. Nested clips are re-placed from their project items, so effects, keyframes, and transitions inside the nest are not carried over.", + "description": "Unnest a nested sequence clip, replacing it with the nested sequence's clips at their exact source in/out and timeline positions. Refuses without changing anything when the nest is trimmed, retimed, linked to a partner clip, contains items that also carry the other media type (Premiere's Track.overwriteClip would place that media on the matching track and overwrite the clips there), or when the destination range is occupied or locked. Re-reads every placed clip and reports failure with Undo guidance if any start or source range differs. Nested clips are re-placed from their project items, so effects, keyframes, and transitions inside the nest are not carried over.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "node_id": { "description": "Node ID of the nested sequence clip on the timeline to unnest", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/update_marker +++ observed/update_marker { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "name": { "description": "New name", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/validate_cmx3600_edl +++ observed/validate_cmx3600_edl { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "frame_rate": { "description": "CMX timecode rate: 24, 25, 29.97, 30, 50, 59.94, or 60 (default: 24)", "type": "number" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/validate_export_preset +++ observed/validate_export_preset { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "preset_path": { "description": "Full path to an Adobe Media Encoder export preset (.epr)", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/validate_mogrt_brand_kit +++ observed/validate_mogrt_brand_kit { "annotations": { "destructiveHint": false, + }, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" } }, "required": [ + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/validate_platform_publish_package +++ observed/validate_platform_publish_package { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "file_size_bytes": { "description": "Rendered file size in bytes.", "maximum": 10000000000000, + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/validate_project_for_export +++ observed/validate_project_for_export { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "gap_limit": { "description": "Maximum per-track gaps to return when per_track_gaps is true (default 200).", "maximum": 2000, + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/verify_after_effects_connection +++ observed/verify_after_effects_connection { "annotations": { "destructiveHint": false, - "properties": {}, + "properties": { + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + } + }, "type": "object" }, "name": "verify_after_effects_connection", + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
+ tool added: verify_caption_render_evidence
--- pinned/verify_delivery_conformance +++ observed/verify_delivery_conformance { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "frame_rate": { "description": "Expected frames per second; rational ffprobe rates are compared numerically", "type": "number" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/verify_delivery_file +++ observed/verify_delivery_file { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, "expected_checksum": { "description": "Optional expected hexadecimal checksum to compare", "type": "string" + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "expected_size_bytes": { "description": "Optional exact expected file size in bytes", "type": "number" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/verify_fcpxml_media_references +++ observed/verify_fcpxml_media_references { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "path": { "description": "Existing local .fcpxml or .xml file", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/verify_mogrt_artifact +++ observed/verify_mogrt_artifact { "annotations": { "destructiveHint": false, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, "mogrt_path": { "description": "Absolute .mogrt artifact path inside approved_workspace_path.", "type": "string" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
--- pinned/verify_premiere_connection +++ observed/verify_premiere_connection { "annotations": { "destructiveHint": false, + }, + "expected_cep_target": { + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "sequence_id" + ] + }, + { + "required": [ + "source_item" + ] + } + ], + "description": "Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard.", + "properties": { + "backend": { + "const": "cep", + "description": "Backend namespace for these IDs.", + "type": "string" + }, + "clip": { + "additionalProperties": false, + "description": "Optional exact reviewed timeline clip.", + "properties": { + "effect": { + "additionalProperties": false, + "description": "Reviewed effect and parameter identity checked before mutation.", + "properties": { + "display_name": { + "description": "Optional exact host display name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "match_name": { + "description": "Effect match name from host inspection.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "parameter_index": { + "description": "Inspected zero-based parameter index.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "parameter_name": { + "description": "Exact inspected parameter name.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "match_name", + "parameter_index", + "parameter_name" + ], + "type": "object" + }, + "end_ticks": { + "description": "Exact expected exclusive timeline end ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "in_ticks": { + "description": "Exact expected source In ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "node_id": { + "description": "Stable CEP node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "out_ticks": { + "description": "Exact expected exclusive source Out ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "project_item_id": { + "description": "Expected source project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "start_ticks": { + "description": "Exact expected timeline start ticks.", + "pattern": "^-?\\d{1,30}$", + "type": "string" + }, + "track_index": { + "description": "Expected zero-based track index; identity still checked.", + "maximum": 255, + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Expected media track group.", + "enum": [ + "video", + "audio" + ], + "type": "string" + } + }, + "required": [ + "node_id", + "track_type", + "track_index" + ], + "type": "object" + }, + "project_document_id": { + "description": "Exact Premiere project document ID observed during review.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "sequence_id": { + "description": "Stable expected active sequence ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + }, + "source_item": { + "additionalProperties": false, + "description": "Reviewed source identity for a source-only operation.", + "properties": { + "media_path": { + "description": "Optional exact source-media path.", + "maxLength": 4096, + "minLength": 1, + "type": "string" + }, + "node_id": { + "description": "Exact project-item node ID.", + "maxLength": 512, + "minLength": 1, + "type": "string" + } + }, + "required": [ + "node_id" + ], + "type": "object" + } + }, + "required": [ + "backend" + ], + "type": "object" + }, + "expected_project_path": { + "description": "Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior.", + "maxLength": 4096, + "minLength": 1, + "type": "string" } }, "type": "object" + "receipt": { + "additionalProperties": true, + "description": "Versioned common mutation receipt; success never implies rendered verification.", + "type": "object" + }, "tool": { "description": "The registered MCP tool name.", "minLength": 1,
+ tool added: verify_temporal_render_artifact
+ tool added: verify_timeline_postconditions
+ tool added: wait_workflow_job
Changed 2026-10-09 13:04 UTC
16 descriptions rewritten.
--- pinned/add_title +++ observed/add_title { "annotations": { "destructiveHint": false, - "description": "Add an on-screen title from plain text using a stock Essential Graphics template that ships with Premiere (default: Basic Title). Pass text for one line, or lines to fill the template's text fields in order (for example a lower third's name and role). Premiere-built templates (kind 'premiere') get the text baked into a verified copy before import, because Premiere exposes no writable text for them (textVerification 'template_verified'; confirm the render with export_frame). The baked copy path is returned as templateFile and saved under the application support premiere-pro-mcp/titles folder (macOS: ~/Library/Application Support/premiere-pro-mcp/titles). Do not delete copies automatically; remove one manually only after confirming no project references it. After Effects-built templates (kind 'after_effects') are imported and their text fields written by position and read back from Premiere (textVerification 'verified', 'mismatch', 'missing_property', or 'committed_unverified'). The graphic is trimmed to duration_seconds and its length read back. Use list_stock_titles to see templates, their kind, and how many lines each takes.", + "description": "Add an on-screen title from plain text using a stock Essential Graphics template that ships with Premiere (default: Basic Title). Pass text for one line, or lines to fill the template's text fields in order (for example a lower third's name and role). Premiere-built templates (kind 'premiere') get the text baked into a verified copy before import, because Premiere exposes no writable text for them (textVerification 'template_verified'; confirm the render with export_frame). The baked copy path is returned as templateFile and saved under the application support premiere-pro-mcp/titles folder (macOS: ~/Library/Application Support/premiere-pro-mcp/titles). The cache keeps the newest 50 baked copies by modification time; export or copy templates elsewhere if a project needs older copies retained. After Effects-built templates (kind 'after_effects') are imported and their text fields written by position and read back from Premiere (textVerification 'verified', 'mismatch', 'missing_property', or 'committed_unverified'). The graphic is trimmed to duration_seconds and its length read back. Use list_stock_titles to see templates, their kind, and how many lines each takes.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false,
--- pinned/clear_item_in_out +++ observed/clear_item_in_out { "annotations": { "destructiveHint": false, - "description": "Clear in and/or out points on a project item (reset to full duration).", + "description": "Clear in and/or out points on a project item (reset to full duration). Still-image Out is independently verified only when its own duration is readable; otherwise the result explains that limit.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false,
--- pinned/create_sequence_from_clips +++ observed/create_sequence_from_clips { "annotations": { "destructiveHint": false, - "description": "Create a new sequence by automatically placing project items in order", + "description": "Create a new sequence from project items, then verify its registered identity, name and source-item placements. clipCount reports observed track items; requestedClipCount reports requested source items.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false,
--- pinned/create_smart_bin +++ observed/create_smart_bin { "annotations": { "destructiveHint": false, - "description": "Create a smart bin (search bin) in the project panel", + "description": "Create a smart bin (search bin) and inspect its new identity and name. The stored search query has no getter, so creation reports committed_unverified with identity verification separately.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false,
--- pinned/create_subclip +++ observed/create_subclip { "annotations": { "destructiveHint": false, - "description": "Create a subclip from a project item with in/out points", + "description": "Create a subclip from a project item with in/out points. Returns the new item's nodeId and reads its stored range back from Premiere project metadata: outcome verified when the observed in/out seconds are within one media frame of the request, otherwise committed_unverified.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false,
--- pinned/detach_proxy +++ observed/detach_proxy { "annotations": { "destructiveHint": false, - "description": "Detach/remove the proxy from a project item", + "description": "Detach/remove the proxy from a project item and read hasProxy back; unavailable readback reports committed_unverified.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false,
--- pinned/import_folder +++ observed/import_folder { "annotations": { "destructiveHint": false, - "description": "Import an entire folder of media into the project", + "description": "Import the media files directly inside a folder and read the destination tree back. Reports observed new media items; unreadable or unmatched imports are committed_unverified.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false,
--- pinned/manage_proxies +++ observed/manage_proxies { "annotations": { "destructiveHint": false, - "description": "Create, attach, or toggle proxies for a project item. Note: 'create' only requests a proxy encode from Adobe Media Encoder and returns an unverified handoff. Independently verify the AME queue or output file before calling this tool again with action 'attach' and proxy_path set to the output_path you passed here. Optional start_batch requests processing of every ready AME queue job, including unrelated jobs. There is no single-call create-and-attach in Premiere's ExtendScript API.", + "description": "Create or attach proxies for a project item, or set Premiere's proxy display. 'toggle' is application-wide, not per item: it changes app.getEnableProxies()/setEnableProxies() for every sequence and monitor, and item_id is only checked to exist. Pass enabled: true or false to set a known state; omitting enabled flips the current state, so two calls undo each other. The result reports previousEnabled and proxiesEnabled read back from Premiere. Note: 'create' only requests a proxy encode from Adobe Media Encoder and returns an unverified handoff. Independently verify the AME queue or output file before calling this tool again with action 'attach' and proxy_path set to the output_path you passed here. Optional start_batch requests processing of every ready AME queue job, including unrelated jobs. There is no single-call create-and-attach in Premiere's ExtendScript API.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, + "enabled": { + "description": "For 'toggle' only: sets the application-wide proxy display to this state (true shows proxies, false shows full-resolution media) and verifies it by reading app.getEnableProxies() back. Omit to flip the current state, which is discouraged because the outcome depends on a state you have not read.", + "type": "boolean" + }, "item_id": { "description": "Node ID or name of the project item", "type": "string"
--- pinned/remove_selected_clips +++ observed/remove_selected_clips { "annotations": { "destructiveHint": true, - "description": "Remove all currently selected clips from the timeline.", + "description": "Remove all currently selected clips and verify their absence. Ripple requests are refused because the CEP removal call cannot reliably close gaps; use a guarded ripple-range tool instead.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, - "description": "If true, close the gap after removing (ripple delete). Default: false", + "description": "Ripple removal is unsupported and refused before editing. Default: false", "type": "boolean" } },
--- pinned/select_clips_by_color +++ observed/select_clips_by_color { "annotations": { "destructiveHint": false, - "description": "Select all clips whose source project item has a specific color label.", + "description": "Select clips by their source project item color label. CEP exposes no timeline track-item label getter, so timeline-specific labels cannot be matched.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false,
--- pinned/set_clip_selection +++ observed/set_clip_selection { "annotations": { "destructiveHint": false, - "description": "Select or deselect a clip in the active sequence", + "description": "Select or deselect a clip in the active sequence and read its selection state back.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false,
--- pinned/set_clip_start_time +++ observed/set_clip_start_time { "annotations": { "destructiveHint": false, - "description": "Set the start time (timecode offset) of a project item. This shifts where timecode begins for the source media.", + "description": "Alias of set_start_time: set and verify the source project item start timecode offset.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false,
--- pinned/set_effect_property +++ observed/set_effect_property { "annotations": { "destructiveHint": false, - "description": "Set one effect property. Duplicate names require property_index from get_effect_properties. Colour values use [alpha, red, green, blue] and the lossless colour API; keyframed colour writes are refused.", + "description": "Set one effect property. Duplicate names require property_index from get_effect_properties. Colour values use [alpha, red, green, blue] and the lossless colour API; keyframed writes are refused. Readback reports verified, failed or committed_unverified; unreadable values are never reported as applied.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false,
--- pinned/set_sequence_display_format +++ observed/set_sequence_display_format { "annotations": { "destructiveHint": false, - "description": "Set the timecode display format for the active sequence.", + "description": "Set the timecode display format for the active sequence and read it back. Uses Premiere's display codes (video 100-113, audio 200-201); the older 0-11 and 0-1 values are mapped onto them.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, - "description": "Audio: 0=Audio Samples, 1=Milliseconds", + "description": "Audio: 200=Audio Samples, 201=Milliseconds. 0 and 1 are accepted as 200 and 201.", "type": "number" }, "video_display_format": { - "description": "Video: 0=24 Timecode, 1=25 Timecode, 2=29.97 Drop-frame, 3=29.97 Non-drop-frame, 4=30 Timecode, 5=50 Timecode, 6=59.94 Drop-frame, 7=59.94 Non-drop-frame, 8=60 Timecode, 9=Frames, 10=Feet+Frames 16mm, 11=Feet+Frames 35mm", + "description": "Video: 100=24 Timecode, 101=25 Timecode, 102=29.97 Drop-frame, 103=29.97 Non-drop-frame, 104=30 Timecode, 105=50 Timecode, 106=59.94 Drop-frame, 107=59.94 Non-drop-frame, 108=60 Timecode, 109=Frames, 110=23.976 Timecode, 111=Feet+Frames 16mm, 112=Feet+Frames 35mm, 113=48 Timecode. 0-13 are accepted as 100-113.", "type": "number" } },
--- pinned/set_sequence_frame_rate +++ observed/set_sequence_frame_rate { "annotations": { "destructiveHint": false, - "description": "Change the frame rate of the active sequence.", + "description": "Change the frame rate of the active sequence and verify it. Premiere re-snaps every clip to the new frame grid, so clips off that grid move by up to a frame; the result lists them (clipsMoved, movedClips) and changing back does not restore them.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false,
--- pinned/stabilize_clip +++ observed/stabilize_clip { "annotations": { "destructiveHint": false, - "description": "Apply the Warp Stabilizer effect to a clip for video stabilization. Uses QE DOM.", + "description": "Apply Warp Stabilizer using the experimental QE DOM. Verifies component addition and readable parameter values, never analysis completion. Numeric or unreadable Method popup values remain unverified because no documented label mapping is available.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false,
Changed 2026-10-08 13:16 UTC
11 descriptions rewritten, 1 schema or annotation change with the description left byte-identical.
--- pinned/add_transition +++ observed/add_transition { "annotations": { "destructiveHint": false, - "description": "Time position in seconds of the cut point where the transition should be placed", + "description": "Time position in seconds of the cut point where the transition should be placed. Snapped to the sequence frame grid and matched to the nearest clip edge within half a frame.", "type": "number" }, "duration_seconds": {
--- pinned/clear_sequence_in_out +++ observed/clear_sequence_in_out { "annotations": { "destructiveHint": false, - "description": "Clear the in and/or out points on the active sequence.", + "description": "Clear the in and/or out points on the active sequence so they read back as unset, and leave the other point unchanged.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false,
--- pinned/extract_selection +++ observed/extract_selection { "annotations": { "destructiveHint": false, - "description": "EXPERIMENTAL (undocumented QE DOM: extract()). Extract (remove and close the gap) the content between the sequence in/out points on every targeted, unlocked track, then verify each targeted track lost exactly the range and its later clips moved up by the range. Requires sequence in/out marks that do not span the whole sequence. Premiere can also change untargeted tracks (for example the linked audio of targeted video, or sync-locked tracks); those are not verified but are listed in otherTracksChanged.", + "description": "EXPERIMENTAL (undocumented QE DOM: extract()). Extract (remove and close the gap) the content between the sequence in/out points on every targeted, unlocked track, then verify each targeted track lost exactly the range and its later clips moved up by the range. Marks that Premiere stored just off a frame are first re-written on that exact frame through QE (marksRewritten). Requires sequence in/out marks that do not span the whole sequence. Premiere can also change untargeted tracks (for example the linked audio of targeted video, or sync-locked tracks); those are not verified but are listed in otherTracksChanged.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object"
--- pinned/lift_selection +++ observed/lift_selection { "annotations": { "destructiveHint": false, - "description": "EXPERIMENTAL (undocumented QE DOM: the sequence lift command, exposed as left() on 25.2). Lift (remove without closing the gap) the content between the sequence in/out points on every targeted, unlocked track, then verify the range is empty on those tracks and nothing else on them moved. Requires sequence in/out marks that do not span the whole sequence. Untargeted tracks are not verified; any that changed are listed in otherTracksChanged.", + "description": "EXPERIMENTAL (undocumented QE DOM: the sequence lift command, exposed as left() on 25.2). Lift (remove without closing the gap) the content between the sequence in/out points on every targeted, unlocked track, then verify the range is empty on those tracks and nothing else on them moved. Marks that Premiere stored just off a frame are first re-written on that exact frame through QE (marksRewritten). Requires sequence in/out marks that do not span the whole sequence. Untargeted tracks are not verified; any that changed are listed in otherTracksChanged.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object"
--- pinned/link_selection +++ observed/link_selection { "annotations": { "destructiveHint": false, - "description": "Link the currently selected video and audio clips in the active sequence", + "description": "Link the currently selected video and audio clips in the active sequence, then read the links back. Needs at least two selected clips; verified only when every selected clip is linked to every other.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object"
--- pinned/replace_clip +++ observed/replace_clip { "annotations": { "destructiveHint": false, - "description": "Replace one timeline clip with a different project item on the same track, keeping the exact timeline start and end. The replacement plays from its own In mark for the original clip's duration; neighbouring clips do not ripple, and a linked partner clip on another track is left in place. Refuses without changing anything when the track is locked. Reads the track back: verified when the new clip covers the same span, committed_unverified when the span holds but the source In point cannot be confirmed, otherwise failure with Undo guidance.", + "description": "Replace one timeline clip with a different project item on the same track, keeping the exact timeline start and end. The replacement plays from its own In mark for the original clip's duration; neighbouring clips do not ripple, and a linked partner clip on another track is left in place. The replacement must carry only the track's media type (for example a still or video-only item on a video track): Premiere's overwrite would also place an item's other media on another track. Checks the replacement accepts the source range before removing anything. Refuses without changing anything when the track is locked. Reads the track back: verified when the new clip covers the same span, committed_unverified when the span holds but the source In point cannot be confirmed, otherwise failure with Undo guidance.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false,
--- pinned/set_frame_blend +++ observed/set_frame_blend { "annotations": { "destructiveHint": false, - "description": "Enable or disable frame blending on a clip. Uses QE DOM.", + "description": "Request frame blending on a clip through QE DOM. Premiere exposes no frame-blend readback, so the result is committed_unverified and must be checked in Effect Controls.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false,
--- pinned/set_item_in_out +++ observed/set_item_in_out { "annotations": { "destructiveHint": false, - "description": "Set in and/or out points on a project item in the project panel (marks source range for editing).", + "description": "Set in and/or out points on a project item in the project panel (marks source range for editing). Premiere snaps video marks to the media's own frame grid, so a mark is verified within one media frame and the result reports requested and applied seconds.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false,
--- pinned/set_time_interpolation +++ observed/set_time_interpolation { "annotations": { "destructiveHint": false, - "description": "Set time interpolation type for a clip (Frame Sampling, Frame Blending, Optical Flow). Uses QE DOM.", + "description": "Request time interpolation for a clip (Frame Sampling, Frame Blending, Optical Flow) through QE DOM. Premiere exposes no interpolation readback, so the result is committed_unverified and must be checked in Effect Controls.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false,
--- pinned/set_work_area +++ observed/set_work_area { "annotations": { "destructiveHint": false, - "description": "Set the work area (bar) in and out points", + "description": "Set and verify the work-area points, turning the bar on first through the public Sequence API when it is off. Fails when Premiere leaves the points unchanged (26.5.2 ignores these CEP writes; use the UXP set_work_area there) and turns the bar back off if this call turned it on. Unreadable or partial writes report committed_unverified.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false,
--- pinned/set_zero_point +++ observed/set_zero_point { "annotations": { "destructiveHint": false, - "description": "Set the starting timecode (zero point) of a sequence", + "description": "Set the starting timecode (zero point) of a sequence and read it back. The value is snapped to the sequence frame grid; for drop-frame 29.97, 01;00;00;00 is 3599.9964 s, and for non-drop 29.97 it is 3603.6 s.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, - "description": "Start time in seconds for the timecode origin", + "description": "Start time in seconds for the timecode origin (0 or more)", "type": "number" } },
--- pinned/unlink_selection +++ observed/unlink_selection { "annotations": { "destructiveHint": false, - "description": "Unlink the currently selected video and audio clips in the active sequence", + "description": "Unlink the currently selected video and audio clips in the active sequence, then read the links back. Premiere only unlinks when every clip of a linked group is selected, so a selection missing a linked partner is refused before anything changes.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object"
Changed 2026-10-07 13:08 UTC
16 descriptions rewritten, 10 schema or annotation changes with the description left byte-identical, 7 tools added.
--- pinned/add_keyframe +++ observed/add_keyframe { "annotations": { "destructiveHint": false, + "property_index": { + "description": "Optional property index from get_effect_properties; required when property_name is duplicated.", + "minimum": 0, + "type": "integer" + }, "property_name": { "description": "Display name of the property", "type": "string"
--- pinned/add_title +++ observed/add_title { "annotations": { "destructiveHint": false, - "description": "Add an on-screen title from plain text using a stock Essential Graphics template that ships with Premiere (default: Basic Title). Pass text for one line, or lines to fill the template's text fields in order (for example a lower third's name and role). Premiere-built templates (kind 'premiere') get the text baked into a verified copy of the template before import, because Premiere exposes no writable text for them (textVerification 'template_verified'; confirm the render with export_frame). After Effects-built templates (kind 'after_effects') are imported and their text fields written by position and read back from Premiere (textVerification 'verified', 'mismatch', 'missing_property', or 'committed_unverified'). The graphic is trimmed to duration_seconds and its length read back. Use list_stock_titles to see templates, their kind, and how many lines each takes.", + "description": "Add an on-screen title from plain text using a stock Essential Graphics template that ships with Premiere (default: Basic Title). Pass text for one line, or lines to fill the template's text fields in order (for example a lower third's name and role). Premiere-built templates (kind 'premiere') get the text baked into a verified copy before import, because Premiere exposes no writable text for them (textVerification 'template_verified'; confirm the render with export_frame). The baked copy path is returned as templateFile and saved under the application support premiere-pro-mcp/titles folder (macOS: ~/Library/Application Support/premiere-pro-mcp/titles). Do not delete copies automatically; remove one manually only after confirming no project references it. After Effects-built templates (kind 'after_effects') are imported and their text fields written by position and read back from Premiere (textVerification 'verified', 'mismatch', 'missing_property', or 'committed_unverified'). The graphic is trimmed to duration_seconds and its length read back. Use list_stock_titles to see templates, their kind, and how many lines each takes.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false,
--- pinned/capture_frame +++ observed/capture_frame { "annotations": { "destructiveHint": false, - "description": "Capture the current frame and return it as inline image data for the LLM to see. This supports still-image review only; QE capture may differ from actual video exports and cannot verify temporal animation.", + "description": "Capture the current frame and return it as inline image data for the LLM to see. This supports still-image review only. The PNG keeps the sequence's transparency (hasAlpha); transparent areas may display as white or a checkerboard rather than the black a video render shows.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false,
--- pinned/copy_effect_values +++ observed/copy_effect_values { "annotations": { "destructiveHint": false, - "description": "Copy verified scalar effect-property values from one effect to the matching effect on another clip. Both clips must already have the same effect applied. Legacy CEP deliberately refuses Blend Mode because Premiere can corrupt its enum value on cross-clip writes.", + "description": "Copy verified scalar and colour effect-property values from one effect to the matching effect on another clip. Both clips must already have the same effect applied. Properties are matched by position, then by unique display name, because effects such as Lumetri Color repeat names across sections. Legacy CEP deliberately refuses Blend Mode because Premiere can corrupt its enum value on cross-clip writes.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false,
--- pinned/copy_effects_between_clips +++ observed/copy_effects_between_clips { "annotations": { "destructiveHint": false, - "description": "Copy all effects (or a specific effect) from one clip to another. Does not copy intrinsic properties like Motion/Opacity unless specified.", + "description": "Copy all effects (or a specific effect) from one clip to another, including parameter values and keyframes, and read every written value back. A missing effect is added through the experimental legacy QE DOM; when the target already has that effect, its values are updated instead of stacking a second default-valued instance. Intrinsic components such as Motion and Opacity are skipped unless named. Uses the same component matching and per-property receipts as paste_clip_attributes.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false,
--- pinned/export_as_fcp_xml +++ observed/export_as_fcp_xml { "annotations": { "destructiveHint": false, - "description": "Export the active sequence as a Final Cut Pro XML file. Fails when Premiere writes no file or leaves a pre-existing output unchanged.", + "description": "Export the active sequence as a Final Cut Pro XML file. Sequences with effects FCP XML cannot represent can make Premiere show a Translation Report modal after writing the XML; dismiss it in Premiere before any queued command can run. Detects the written XML and fresh report if the modal blocks the host. Default wait is 60 minutes for long sequences.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, + }, + "timeout_minutes": { + "description": "Maximum wait for the host (default: 60 minutes for long sequences).", + "maximum": 240, + "minimum": 1, + "type": "number" } }, "required": [
--- pinned/export_frame +++ observed/export_frame { "annotations": { "destructiveHint": false, - "description": "Export a file-verified still image. QE frame capture may not evaluate keyframed animation like an actual video export; it does not verify temporal curves or playback.", + "description": "Export a file-verified still image. PNG stills keep the sequence's transparency (straight alpha, reported as hasAlpha); composite them over black before measuring brightness or comparing with a video render. A single still does not verify motion over time, playback or audio.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false,
--- pinned/export_omf +++ observed/export_omf { "annotations": { "destructiveHint": false, - "description": "Export the active sequence as an OMF file (Open Media Framework, for audio post-production)", + "description": "Export the active sequence as an OMF file (Open Media Framework, for audio post-production). Long sequences can use a longer wait (default 60 minutes); if Premiere writes the file but times out, the receipt includes its size as committed_unverified.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, + "timeout_minutes": { + "description": "Maximum wait for Premiere to write the OMF (default: 60 minutes for long sequences).", + "maximum": 240, + "minimum": 1, + "type": "number" + }, "trim_audio_files": { "description": "Trim audio to used range plus handles (default: true)", "type": "boolean"
--- pinned/export_sequence_edl +++ observed/export_sequence_edl { "annotations": { "destructiveHint": false, - "description": "Generate a CMX 3600 EDL for one video or audio track of a sequence from Premiere timeline readback (cuts, reels, source/record timecode, M2 lines for retimed clips), self-validate it, and return it inline or write it inside an approved workspace. Premiere is only read; this is not a Premiere-native export.", + "description": "Generate a CMX 3600 EDL for one video or audio track of a sequence from Premiere timeline readback (cuts, reels, source/record timecode, M2 lines for retimed clips), self-validate it, and return it inline or write it inside an approved workspace. Premiere is only read; this is not a Premiere-native export. Long sequences can use a longer timeout (default 30 minutes).", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, + "timeout_minutes": { + "description": "Maximum wait for Premiere timeline readback (default: 30 minutes).", + "maximum": 240, + "minimum": 1, + "type": "number" + }, "title": { "description": "TITLE line (default: the sequence name).", "maxLength": 70,
--- pinned/export_sequence_review_frames +++ observed/export_sequence_review_frames { "annotations": { "destructiveHint": false, - "description": "Export 2-24 evenly spaced, file-verified frames from an active-sequence range in one bridge round trip for visual review. Still capture does not verify temporal animation, playback, audio, or editorial quality; QE frames can differ from actual video exports.", + "description": "Export 2-24 evenly spaced, file-verified frames from an active-sequence range in one bridge round trip for visual review. Still capture does not verify temporal animation, playback, audio, or editorial quality; PNG frames keep the sequence's transparency (straight alpha), so composite them over black before comparing with a video export.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false,
--- pinned/get_encoder_presets +++ observed/get_encoder_presets { "annotations": { "destructiveHint": false, + }, + "limit": { + "description": "Maximum presets to return, applied after the filter and ordering. Omit to return all; the result's total is the unpaged count.", + "type": "integer" + }, + "offset": { + "description": "Number of presets to skip before returning, for paging with limit. Default 0.", + "type": "integer" } }, "type": "object"
--- pinned/get_keyframes +++ observed/get_keyframes { "annotations": { "destructiveHint": false, + "property_index": { + "description": "Optional property index from get_effect_properties; required when property_name is duplicated.", + "minimum": 0, + "type": "integer" + }, "property_name": { "description": "Display name of the property", "type": "string"
--- pinned/get_metadata +++ observed/get_metadata { "annotations": { "destructiveHint": false, - "description": "Get metadata for a project item. Use parse_fields to return named XMP/project fields instead of raw XML. Project metadata XML and file/clip XMP are separate packets; disable either when identity/path is enough. Prefer inspect_project_panel_metadata_uxp item_columns or manage_metadata_uxp inspect_fields for visible columns. This is not the premiere://project/metadata resource. GPS and serials are omitted from parse_fields unless include_sensitive is true.", + "description": "Get metadata for a project item. Returns bounded parsed fields by default; GPS, serials, and personal contact/author fields are omitted. Raw packets require explicit include_project_metadata/include_xmp_metadata and include_sensitive true. Media paths require include_media_path true. Project metadata XML and file/clip XMP are separate packets; disable either when identity/path is enough. Prefer inspect_project_panel_metadata_uxp item_columns or manage_metadata_uxp inspect_fields for visible columns. This is not the premiere://project/metadata resource. GPS and serials are omitted from parse_fields unless include_sensitive is true.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, + "include_media_path": { + "description": "Opt in to the full source media path, which can identify the local user and folders; default false.", + "type": "boolean" + }, "include_project_metadata": { - "description": "Include the potentially large Project Metadata XML payload (default: true unless parse_fields is true).", + "description": "Opt in to raw Project Metadata XML (maximum 256 Ki characters). Requires include_sensitive true; default false. Set false to skip reading this packet entirely.", "type": "boolean" }, "include_sensitive": { - "description": "When parse_fields is true, include GPS, serials, and similar EXIF. Default false.", + "description": "Opt in to sensitive GPS, serial, author, and contact fields. Required for any raw packet; default false.", "type": "boolean" }, "include_xmp_metadata": { - "description": "Include the potentially large XMP XML payload (default: true unless parse_fields is true).", + "description": "Opt in to raw XMP XML (maximum 256 Ki characters). Requires include_sensitive true; default false. Set false to skip reading this packet entirely.", "type": "boolean" }, "item_id": { - "description": "Parse project metadata and XMP into named fields (default false). When true, raw XML is omitted unless include_project_metadata or include_xmp_metadata is explicitly true.", + "description": "Parse project metadata and XMP into named fields (default true). Set false for identity-only or explicitly requested raw packets.", "type": "boolean" } },
--- pinned/get_value_at_time +++ observed/get_value_at_time { "annotations": { "destructiveHint": false, + "property_index": { + "description": "Optional property index from get_effect_properties; required when property_name is duplicated.", + "minimum": 0, + "type": "integer" + }, "property_name": { "description": "Display name of the property", "type": "string"
--- pinned/get_xmp_metadata +++ observed/get_xmp_metadata { "annotations": { "destructiveHint": false, - "description": "Get the raw file/clip XMP packet for a project item (Dublin Core, EXIF, IPTC, xmpDM, and other namespaces). Distinct from Premiere-private project metadata. Omit GPS and camera serials from user-facing reports unless requested.", + "description": "Inspect bounded file/clip XMP fields with GPS, serials, author and contact data omitted by default. Raw XMP requires include_raw and include_sensitive true; it can disclose personal data to the connected client. Distinct from Premiere-private project metadata.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, + "include_raw": { + "description": "Opt in to raw XMP instead of parsed fields (maximum 256 Ki characters). Requires include_sensitive true; default false.", + "type": "boolean" + }, + "include_sensitive": { + "description": "Opt in to GPS, serial, author and contact fields; required for raw XMP; default false.", + "type": "boolean" + }, "item_id": { "description": "Node ID or name of the project item", "type": "string"
--- pinned/import_fcp_xml +++ observed/import_fcp_xml { "annotations": { "destructiveHint": false, - "description": "Open a Final Cut Pro XML file as a new Premiere project. app.openFCPXML(path, projPath) requires a destination project path; it does not merge the XML into the currently open project. verified is true only when that destination exists as a file and Premiere has that exact path open.", + "description": "Import a Final Cut Pro XML file. Default mode new_project opens it as a new Premiere project: app.openFCPXML(path, projPath) requires a destination project path, and verified is true only when that destination exists as a file and Premiere has that exact path open. Mode into_open_project instead imports the XML into the currently open project with project.importFiles and succeeds only when the sequence count grew; the XML also brings its own clips, which can duplicate existing items.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, + "mode": { + "description": "new_project (default) opens the XML as a new project saved at project_path. into_open_project imports it into the open project.", + "enum": [ + "new_project", + "into_open_project" + ], + "type": "string" + }, "path": { "description": "Full path to the FCP XML file to read", "type": "string" - "description": "Full path of the new .prproj file Premiere should create for the imported timeline. Required: app.openFCPXML takes both a source and a destination path.", + "description": "Full path of the new .prproj file Premiere should create for the imported timeline. Required in new_project mode (app.openFCPXML takes both a source and a destination path); ignored in into_open_project mode.", "type": "string" + }, + "target_bin": { + "description": "into_open_project mode only: bin name or node ID to import into. Defaults to the project root.", + "type": "string" } }, "required": [ - "path", - "project_path" + "path" ], "type": "object" },
--- pinned/import_folder +++ observed/import_folder { "annotations": { "destructiveHint": false, + }, + "target_bin": { + "description": "Optional bin name or node ID to import into. Defaults to the project root.", + "type": "string" } }, "required": [
--- pinned/list_markers +++ observed/list_markers { "annotations": { "destructiveHint": false, - "description": "List markers on the active sequence, or on a source project item that exposes a marker collection. A timeline-clip node_id returns a clean error instead of a raw TypeError.", + "description": "List markers on the active sequence, or on a source project item that exposes a marker collection, including marker GUID and color when readable. A timeline-clip node_id returns a clean error instead of a raw TypeError.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false,
+ tool added: map_source_ranges_to_timeline
--- pinned/plan_filler_word_removal +++ observed/plan_filler_word_removal { "annotations": { "destructiveHint": false, - "description": "Plan word-level filler removal (um, uh, you know...) from a revision-bound word timeline. Returns frame-snapped removal and keep ranges plus apply routes. Local-only; never changes Premiere.", + "description": "Plan word-level filler removal (um, uh, you know...) from a revision-bound word timeline. Hesitation-sound removal requires a transcript that preserves disfluencies, such as Premiere transcription or verbatim ASR; Whisper's default output omits them. Returns frame-snapped removal and keep ranges plus apply routes. Local-only; never changes Premiere.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false,
--- pinned/remove_keyframe +++ observed/remove_keyframe { "annotations": { "destructiveHint": true, + "property_index": { + "description": "Optional property index from get_effect_properties; required when property_name is duplicated.", + "minimum": 0, + "type": "integer" + }, "property_name": { "description": "Display name of the property", "type": "string"
--- pinned/remove_keyframe_range +++ observed/remove_keyframe_range { "annotations": { "destructiveHint": true, + "property_index": { + "description": "Optional property index from get_effect_properties; required when property_name is duplicated.", + "minimum": 0, + "type": "integer" + }, "property_name": { "description": "Display name of the property", "type": "string"
+ tool added: review_broll_placements
+ tool added: review_dialogue_candidates
+ tool added: review_quote_paper_edit
+ tool added: review_sync_evidence
+ tool added: review_text_changes
+ tool added: ripple_remove_timeline_ranges
--- pinned/set_color_value +++ observed/set_color_value { "annotations": { "destructiveHint": false, + "property_index": { + "description": "Optional exact property index from get_effect_properties; required if the name is repeated.", + "minimum": 0, + "type": "integer" + }, "property_name": { - "description": "Name of the color property", + "description": "Name of the color property; duplicate names require property_index from get_effect_properties.", "type": "string" }, "red": {
--- pinned/set_effect_property +++ observed/set_effect_property { "annotations": { "destructiveHint": false, - "description": "Set the value of a specific effect property on a clip. Accepts scalar, boolean, string, array-shaped vector values (for example Motion > Position as [x, y]), and MOGRT JSON objects or strings, and verifies the readback component by component.", + "description": "Set one effect property. Duplicate names require property_index from get_effect_properties. Colour values use [alpha, red, green, blue] and the lossless colour API; keyframed colour writes are refused.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, + "property_index": { + "description": "Optional property index from get_effect_properties; required when property_name is duplicated.", + "minimum": 0, + "type": "integer" + }, "property_name": { - "description": "Display name of the property (e.g., 'Scale', 'Position', 'Opacity')", + "description": "Display name of the property; duplicate names require property_index.", "type": "string" }, "value": {
--- pinned/set_footage_interpretation +++ observed/set_footage_interpretation { "annotations": { "destructiveHint": false, + "field_type": { + "description": "Field order of interlaced footage: 0 = progressive, 1 = upper field first, 2 = lower field first", + "type": "integer" + }, "frame_rate": { "description": "Override frame rate", "type": "number"
--- pinned/set_keyframe_interpolation +++ observed/set_keyframe_interpolation { "annotations": { "destructiveHint": false, - "description": "Set the interpolation type of an existing keyframe (Linear, Hold, or Bezier). Premiere exposes no interpolation readback, so a write is reported as committed_unverified. Stored curves do not establish rendering; A 26.5.2 Windows capture report shows identical modes; 25.2.3 macOS evidence distinguishes a QE still-capture artifact from correctly rendered video curves.", + "description": "Set the interpolation type of an existing keyframe (Linear, Hold, or Bezier). Premiere exposes no interpolation readback, so a write is reported as committed_unverified. Stored curves do not establish rendering; verify with a short video export, or with PNG stills composited over black (they carry straight alpha).", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, + "property_index": { + "description": "Optional property index from get_effect_properties; required when property_name is duplicated.", + "minimum": 0, + "type": "integer" + }, "property_name": { "description": "Display name of the property", "type": "string"
--- pinned/validate_project_for_export +++ observed/validate_project_for_export { "annotations": { "destructiveHint": false, + "gap_limit": { + "description": "Maximum per-track gaps to return when per_track_gaps is true (default 200).", + "maximum": 2000, + "minimum": 1, + "type": "integer" + }, + "gap_offset": { + "description": "Zero-based offset into the optional per-track gap list (default 0).", + "minimum": 0, + "type": "integer" + }, "output_path": { "description": "Optional intended delivery path; its parent folder is checked.", "maxLength": 4096, + "per_track_gaps": { + "description": "Include the per-track gap list in a bounded page (default false); composite black/dead-air checks remain available without it.", + "type": "boolean" + }, "preset_path": { "description": "Optional .epr preset path to check.", "maxLength": 4096,
Changed 2026-10-05 14:18 UTC
140 descriptions rewritten, 186 schema or annotation changes with the description left byte-identical, 58 tools added.
--- pinned/add_adjustment_layer +++ observed/add_adjustment_layer { "annotations": { "destructiveHint": false, - "description": "Add an adjustment layer to the active sequence via QE DOM. The layer is added at the playhead position on the specified track.", + "description": "EXPERIMENTAL (QE DOM): add an adjustment layer at the playhead on the specified track. Refuses when the host lacks the QE APIs; verifies a new public TrackItem using isAdjustmentLayer and placement readback.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "track_index": { "description": "Video track index (default: 0)", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/add_audio_keyframes +++ observed/add_audio_keyframes { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "keyframes": { "description": "Array of keyframe objects with time_seconds and level_db", - "additionalProperties": {}, "properties": { "level_db": { - "description": "Audio level in dB", + "description": "Audio level in dB (maximum +15 dB)", + "maximum": 15, "type": "number" }, "time_seconds": { + "minimum": 0, "type": "number" } }, + "minItems": 1, "type": "array" }, "node_id": { - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/add_custom_metadata_field +++ observed/add_custom_metadata_field { "annotations": { "destructiveHint": false, - "description": "Add a custom metadata field to the project's metadata schema. This creates a schema/column definition only; it does not set a per-item value. Use set_metadata with complete Project Metadata XML and readback to update a value.", + "description": "Add a custom metadata field to the project's metadata schema. This creates a schema/column definition only; it does not set a per-item value. Use set_metadata field_name/value or complete Project Metadata XML with readback to update a value.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "field_label": { "description": "Display label for the field", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/add_keyframe +++ observed/add_keyframe { "annotations": { "destructiveHint": false, - "description": "Add and read back a keyframe on an effect property. This verifies stored parameter data only; render/playback verification remains host-dependent.", + "description": "Add and read back a keyframe on an effect property. The receipt warns when its time is outside the clip's visible range. This verifies stored parameter data only; render/playback verification remains host-dependent.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "effect_name": { "description": "Display name of the effect", - "description": "Time in seconds relative to clip start where to add keyframe", + "description": "Seconds from the clip's start on the timeline (0 is the clip's first frame) where to add the keyframe", "type": "number" }, "value": { - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/add_marker +++ observed/add_marker { "annotations": { "destructiveHint": false, - "description": "Add a marker to the active sequence or a clip", + "description": "Add a marker to the active sequence or a clip and read its name, comments, color and duration back. EXPERIMENTAL (QE DOM): the receipt reports undoStackIndex movement, which does not prove QE can reverse the marker. Every marker attempt protects an engine undo boundary; undoTracked:false means the marker did not observably advance the QE index.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "color": { "description": "Marker color index (0=Green, 1=Red, 2=Purple, 3=Orange, 4=Yellow, 5=White, 6=Blue, 7=Cyan)", - "description": "Optional clip node ID to add marker to clip instead of sequence", + "description": "Optional clip node ID to add the marker to that clip instead of the sequence. Premiere 25.2.3 timeline clips have no marker collection, so this refuses there and names the source time to use with add_marker_to_project_item.", "type": "string" }, "time_seconds": { - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/add_marker_to_project_item +++ observed/add_marker_to_project_item { "annotations": { "destructiveHint": false, - "description": "Add a marker to a project item (source clip marker).", + "description": "Add a marker to a project item (source clip marker). EXPERIMENTAL QE: records an observed marker boundary for guarded Undo/Redo; crossing it is refused by default, and unreadable history records unknown protection. This boundary does not verify native marker reversal.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "color_index": { "description": "Color label index (0-7)", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
+ tool added: add_markers_batch
--- pinned/add_text_overlay +++ observed/add_text_overlay { "annotations": { "destructiveHint": false, - "description": "Unavailable: Premiere does not expose a supported scripting API to create caption clips directly from raw text. Import an .srt/.vtt and use create_caption_track, or use a MOGRT/PNG overlay for title graphics.", + "description": "Unavailable: Premiere does not expose a supported scripting API to create caption clips directly from raw text. For on-screen titles from plain text use add_title; for captions import an .srt/.vtt and use create_caption_track.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "caption_format": { "description": "Caption format (default: subtitle)", + "subtitle", "608", "708", - "subtitle", "teletext" ], "type": "string" - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
+ tool added: add_title
--- pinned/add_to_render_queue +++ observed/add_to_render_queue { "annotations": { "destructiveHint": false, - "description": "Request an Adobe Media Encoder render-queue handoff for the active sequence. Verify queue presence or the output file independently.", + "description": "Request an Adobe Media Encoder render-queue handoff for the active sequence. Requires a saved project and an .epr preset_path. Same as Project presets are refused before Premiere is contacted because AME encodes from a scratch project copy. Optional start_batch requests processing of every ready AME queue job, including unrelated jobs.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "output_path": { "description": "Full output file path", - "description": "Path to an AME preset file (.epr)", + "description": "Required path to an AME preset file (.epr). Omitting this raises an Illegal Parameter error on current Premiere hosts.", "type": "string" + }, + "start_batch": { + "description": "Opt in to start the entire ready Adobe Media Encoder queue after this handoff, including unrelated jobs. Default false (enqueue only). A successful call does not verify that any render started or completed.", + "type": "boolean" } }, "required": [ - "output_path" + "output_path", + "preset_path" ], "type": "object" }, - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/add_to_timeline +++ observed/add_to_timeline { "annotations": { "destructiveHint": false, - "description": "Insert a project item at a timeline position and verify Premiere added no unexpected same-track fragments.", + "description": "Insert a project item at a timeline position. Experimental: if a target clip spans that point, QE razors it before insertion to attempt to preserve its tail; both target and sync-locked track changes are read back. A host may still displace a tail, in which case the edit is reported as committed_unverified. Pass scope 'target_tracks' to ripple only the named pair (this will desync other tracks).", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "audio_track_index": { "description": "Audio track index for the audio portion (default: 0)", + "scope": { + "description": "Which tracks shift: 'sync_locked' (default) matches Premiere's insert; 'target_tracks' ripples only the named pair and WILL desync other tracks.", + "enum": [ + "sync_locked", + "target_tracks" + ], + "type": "string" + }, "start_seconds": { "description": "Start time in seconds on the timeline (default: 0)", "type": "number" - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/add_to_timeline_batch +++ observed/add_to_timeline_batch { "annotations": { "destructiveHint": false, - "description": "Insert up to 32 project items in one validated CEP request. All items and target tracks are preflighted before the first insertion; every requested placement is read back, and the tool fails closed if Premiere cannot verify one.", + "description": "Insert up to 32 project items with insert-edit semantics in one validated CEP request. Experimental QE sync-lock handling may ripple or split earlier placements. The tool preflights items and tracks, then verifies every placement again in the final sequence; changed placements return committed_unverified with their observed final positions.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "clips": { "description": "Ordered placements. They use the same insert-edit semantics as add_to_timeline; later placements must not share a target video-track start time.", - "additionalProperties": {}, + "additionalProperties": false, "properties": { "audio_track_index": { "description": "Audio target for linked source audio (defaults to 0).", - "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, + "maxLength": 512, + "minLength": 1, "type": "string" }, "start_seconds": { - "maximum": 9007199254740991, "minimum": 0, "type": "integer" } + "maxItems": 32, + "minItems": 1, "type": "array" } }, - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/add_track +++ observed/add_track { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "count": { "description": "Number of tracks to add (default: 1)", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/add_tracks +++ observed/add_tracks { "annotations": { "destructiveHint": false, - "description": "Add video and/or audio tracks through QE and verify the active sequence gained the exact requested counts", + "description": "Add video and/or audio tracks through QE, verify the active sequence gained the exact requested counts, and report explicitly when QE inserted the new tracks at index 0 and shifted every existing track up.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "audio_51_tracks": { "description": "Number of 5.1 audio tracks to add (default: 0)", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/add_transition +++ observed/add_transition { "annotations": { "destructiveHint": false, - "description": "Add a video transition between two clips at a cut point. Uses QE DOM.", + "description": "EXPERIMENTAL (undocumented QE DOM): Add a video transition between two clips at a cut point. Reads the transition back from the sequence track.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "cut_point_seconds": { "description": "Time position in seconds of the cut point where the transition should be placed", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/add_transition_to_clip +++ observed/add_transition_to_clip { "annotations": { "destructiveHint": false, - "description": "Add a transition to a specific clip's start or end", + "description": "EXPERIMENTAL (undocumented QE DOM): Add a transition to a specific video clip's start, end, or both edges, then read back the requested placement.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "duration_seconds": { "description": "Duration of the transition in seconds (default: 1.0)", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/adjust_audio_levels +++ observed/adjust_audio_levels { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "level_db": { "description": "Audio level in dB (0 = unity, negative = quieter, positive = louder)", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
+ tool added: analyze_dialogue_edit_candidates
--- pinned/analyze_loudness +++ observed/analyze_loudness { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "max_true_peak_dbfs": { "description": "Optional maximum acceptable true peak in dBFS (commonly -1 or -2)", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/analyze_video_interlacing +++ observed/analyze_video_interlacing { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "media_path": { "description": "Existing local video file", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/analyze_video_qc +++ observed/analyze_video_qc { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "media_path": { "description": "Path to an existing local video file", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
+ tool added: apply_after_effects_render_handoff
--- pinned/apply_audio_effect +++ observed/apply_audio_effect { "annotations": { "destructiveHint": false, - "description": "Apply an audio effect to a clip. Uses QE catalog lookup, with an exact-name QE probe when enumeration is empty.", + "description": "Apply an audio effect to a clip. Experimental QE catalog lookup includes an exact-name probe when enumeration is empty. A component-list readback does not verify rendered audio.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "effect_name": { "description": "Name of the audio effect", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/apply_edit_plan +++ observed/apply_edit_plan { "annotations": { "destructiveHint": false, - "description": "Apply a previously previewed compound edit after revalidating every target. Requires the edit capability and exact preview confirmation token.", + "description": "Apply a previously previewed compound edit after revalidating stable project, sequence and target identities before activation or mutation. Requires the edit capability and exact preview confirmation token; changed targets require a fresh preview. Ripple plans require the reviewed sequence to be active for the read-only QE sync-lock preflight.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "confirmation_token": { "description": "Exact token returned by preview_edit_plan", - "additionalProperties": {}, - "description": "An edit plan containing insert_clip and remove_clip operations (maximum 100)", - "propertyNames": { - "type": "string" + "description": "An edit plan: { sequence_id?, operations: [...] } with up to 100 insert_clip and remove_clip operations. Operations run in order, and each one's times refer to the timeline as the operations before it left it.", + "properties": { + "operations": { + "items": { + "properties": { + "allow_large_ripple": { + "description": "ripple remove_clip: allow execution above large_ripple_threshold after the read-only mover estimate", + "type": "boolean" + }, + "audio_track_index": { + "description": "insert_clip: audio track (default 0)", + "minimum": 0, + "type": "integer" + }, + "include_linked": { + "description": "remove_clip without ripple: also remove linked audio/video partners (default true)", + "type": "boolean" + }, + "item_id": { + "description": "insert_clip: project item node ID or name", + "type": "string" + }, + "large_ripple_threshold": { + "description": "ripple remove_clip: refuse above this mover count unless allow_large_ripple is true (default 400)", + "maximum": 5000, + "minimum": 1, + "type": "integer" + }, + "node_id": { + "description": "remove_clip: timeline clip node ID", + "type": "string" + }, + "ripple": { + "description": "remove_clip: close the gap with a verified sync-locked ripple delete (always takes linked partners)", + "type": "boolean" + }, + "start_seconds": { + "description": "insert_clip: timeline insert time in seconds (insert edit, sync-locked tracks shift)", + "minimum": 0, + "type": "number" + }, + "type": { + "enum": [ + "insert_clip", + "remove_clip" + ], + "type": "string" + }, + "video_track_index": { + "description": "insert_clip: video track (default 0)", + "minimum": 0, + "type": "integer" + } + }, + "required": [ + "type" + ], + "type": "object" + }, + "maxItems": 100, + "minItems": 1, + "type": "array" + }, + "sequence_id": { + "description": "Sequence name or ID to edit (activated first); defaults to the active sequence", + "type": "string" + } }, + "required": [ + "operations" + ], "type": "object" } }, - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/apply_effect +++ observed/apply_effect { "annotations": { "destructiveHint": false, - "description": "Apply a video effect to a clip. Uses QE DOM catalog lookup, with an exact-name QE probe when Premiere's catalog enumeration is empty.", + "description": "Apply a video effect to a clip. Experimental QE DOM catalog lookup includes an exact-name probe when enumeration is empty. A component-list readback does not verify rendered pixels.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "effect_name": { "description": "Name of the effect (e.g., 'Gaussian Blur', 'Lumetri Color')", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/apply_lut +++ observed/apply_lut { "annotations": { "destructiveHint": false, - "description": "Apply a LUT file to a clip via Lumetri Color", + "description": "Unavailable on the CEP backend: Premiere's scripting API cannot load a LUT file into Lumetri Color. Its Input LUT and Look parameters are menu indexes over a curated set of bundled looks, and writing a file path to the LUT asset parameters is accepted but not rendered (seen on Premiere Pro 25.2.3, macOS, by comparing exported frames with the same LUT applied by ffmpeg; other builds were not tested). Fails before changing the clip. Apply the LUT in Lumetri Color > Creative > Look (Browse...) instead.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "lut_path": { "description": "Full path to the .cube or .3dl LUT file", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
+ tool added: apply_mogrt_premiere_handoff
--- pinned/apply_spot_workflow_plan +++ observed/apply_spot_workflow_plan { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "confirmation_token": { "description": "Exact token returned by the corresponding preview tool.", - "additionalProperties": {}, "description": "Exact plan returned by a preview_*_spot tool", - "propertyNames": { - "type": "string" - }, "type": "object" } }, - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/attach_custom_property +++ observed/attach_custom_property { "annotations": { "destructiveHint": false, - "description": "Attach a custom property (key/value pair) to the active sequence", + "description": "Attach a custom property (key/value pair) to the active sequence and confirm it against the sequence project item's XMP packet. Reports failure when the property never lands in XMP.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "property_id": { "description": "Unique identifier for the custom property", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
+ tool added: audit_timeline_health
--- pinned/auto_reframe_sequence +++ observed/auto_reframe_sequence { "annotations": { "destructiveHint": false, - "description": "Auto-reframe a sequence for a different aspect ratio", + "description": "Auto-reframe a sequence into a new sequence of target_width x target_height. Premiere derives the new sequence from the source height (a 1080p source at 9:16 comes out 607x1080), so the tool then sets the requested frame size and verifies it; the Auto Reframe effect refits to the new size.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "motion_preset": { "description": "Premiere Auto Reframe motion preset (default: default)", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/batch_add_transitions +++ observed/batch_add_transitions { "annotations": { "destructiveHint": false, - "description": "Add the same transition to all cut points on a track", + "description": "EXPERIMENTAL (undocumented QE DOM): Add the same video transition at each eligible cut point on a track and report per-cut readback.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "duration_seconds": { "description": "Duration of each transition in seconds (default: 1.0)", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/batch_apply_effect +++ observed/batch_apply_effect { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "effect_name": { "description": "Display name of the effect to apply (e.g., 'Gaussian Blur', 'Lumetri Color')", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/batch_enable_disable +++ observed/batch_enable_disable { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "enabled": { "description": "true to enable, false to disable", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/batch_rename_clips +++ observed/batch_rename_clips { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "pattern": { "description": "Name pattern. Use {n} for a sequential number, ## for a zero-padded two-digit sequence number, and {name} for the original name (e.g., 'Scene_##', '{name}_v2')", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
+ tool added: build_caption_artifact
--- pinned/capture_frame +++ observed/capture_frame { "annotations": { "destructiveHint": false, - "description": "Capture the current frame and return it as inline image data for the LLM to see. This lets the AI visually inspect the current state of the timeline.", + "description": "Capture the current frame and return it as inline image data for the LLM to see. This supports still-image review only; QE capture may differ from actual video exports and cannot verify temporal animation.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "time_seconds": { "description": "Time position in seconds to capture. Uses current playhead if omitted.", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
+ tool added: check_caption_safe_zone
--- pinned/check_offline_media +++ observed/check_offline_media { "annotations": { "destructiveHint": false, - "properties": {}, "type": "object" }, "name": "check_offline_media", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/clear_item_in_out +++ observed/clear_item_in_out { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "clear_in": { "description": "Clear the in point (default: true)", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/clear_sequence_in_out +++ observed/clear_sequence_in_out { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "clear_in": { "description": "Clear in point (default: true)", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/close_all_source_clips +++ observed/close_all_source_clips { "annotations": { "destructiveHint": true, - "properties": {}, "type": "object" }, "name": "close_all_source_clips", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/close_project +++ observed/close_project { "annotations": { "destructiveHint": true, - "description": "Close the current Premiere Pro project", + "description": "Close an open Premiere Pro project: the active one, or the open project at project_path. Verifies it is no longer open and reports which project is active afterwards.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { + "project_path": { + "description": "Path of the open project to close (default: the active project)", + "type": "string" + }, "save_first": { "description": "Whether to save before closing (default: true)", "type": "boolean" - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/close_sequence +++ observed/close_sequence { "annotations": { "destructiveHint": true, - "description": "Close a sequence tab in the timeline", + "description": "Request closing a sequence timeline tab. Premiere exposes no open-tab enumeration, so dispatch is requested_unverified; the sequence stays in the project.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "sequence_id": { "description": "Sequence name or ID. Uses active sequence if omitted.", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/close_source_monitor +++ observed/close_source_monitor { "annotations": { "destructiveHint": true, - "description": "Close the clip currently open in the Source Monitor.", + "description": "Close the clip currently showing in the Source Monitor. Premiere then shows the previously opened clip, if any; the result names it.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", - "properties": {}, "type": "object" }, "name": "close_source_monitor", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/color_correct +++ observed/color_correct { "annotations": { "destructiveHint": false, - "description": "Apply basic color correction to a clip using Lumetri Color", + "description": "Apply basic color correction through experimental QE Lumetri insertion. Requires Lumetri component and requested property readback; rendered output is not verified.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "blacks": { "description": "Blacks adjustment (-100 to 100)", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/compare_cmx3600_edls +++ observed/compare_cmx3600_edls { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "after_path": { "description": "Existing revised .edl file", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
+ tool added: compute_mask_fit_motion
--- pinned/consolidate_and_transfer +++ observed/consolidate_and_transfer { "annotations": { "destructiveHint": false, - "description": "Consolidate, copy, or transcode project media using the Project Manager. Reports success only after a new destination folder contains a copied Premiere project.", + "description": "Collect (copy) or transcode project media into a new project with Premiere's Project Manager. Premiere writes a Copied_<project> folder inside destination_path (created if missing); success is reported only after that folder holds the copied .prproj, with the copied files listed.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "convert_ae_comps": { "description": "Convert After Effects compositions (default: false)", - "description": "Copy media to a new location (default: true)", + "description": "Must be true (the default): Premiere's scripted Project Manager always collects media into the destination.", "type": "boolean" }, "destination_path": { - "description": "Transcode media during copy (default: false)", + "description": "Transcode media to match the sequence instead of copying it (default: false)", "type": "boolean" } }, - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/consolidate_duplicates +++ observed/consolidate_duplicates { "annotations": { "destructiveHint": false, - "properties": {}, "type": "object" }, "name": "consolidate_duplicates", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/copy_effect_values +++ observed/copy_effect_values { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "effect_name": { "description": "Display name of the effect to copy values for", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/copy_effects_between_clips +++ observed/copy_effects_between_clips { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "effect_name": { "description": "Specific effect display name to copy (copies all non-intrinsic effects if omitted)", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/create_bars_and_tone +++ observed/create_bars_and_tone { "annotations": { "destructiveHint": false, - "description": "Create a Bars and Tone synthetic media item in the project (useful for leader/calibration)", + "description": "Create a Bars and Tone synthetic media item in the project (useful for leader/calibration). Returns the created item's name, nodeId, and treePath, found by reading the project back.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "audio_sample_rate": { "description": "Audio sample rate in Hz (default: 48000)", + "bin_id": { + "description": "Optional destination bin: node ID, slash-separated bin path from the project root, or bin name. The bin is resolved before anything is created; the item is moved there and its location read back.", + "type": "string" + }, "height": { "description": "Frame height in pixels (default: 1080)", "type": "number" - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/create_bin +++ observed/create_bin { "annotations": { "destructiveHint": false, - "description": "Create a new bin (folder) in the project panel", + "description": "Create a new bin (folder) in the project panel, optionally nested inside an existing bin. Reads the project back: verified is true only when the new bin is a direct child of the requested parent; otherwise the result reports outcome committed_unverified.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "name": { "description": "Name of the new bin", - "description": "Optional parent bin name or node ID. Creates in root if omitted.", + "description": "Optional parent bin node ID, slash-separated bin path, or exact bin name. Alias of parent_bin_id that also accepts a path or name.", "type": "string" + }, + "parent_bin_id": { + "description": "Optional node ID of the existing parent bin (searched recursively through nested bins). Creates in the project root if both parent_bin_id and parent_bin are omitted.", + "type": "string" } }, "required": [ - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/create_caption_track +++ observed/create_caption_track { "annotations": { "destructiveHint": false, - "description": "Create a caption/subtitle track in the active sequence from an imported caption file (e.g., .srt, .vtt). Reports structural success only when the host exposes a caption-track readback; otherwise reports an unverified accepted request.", + "description": "Import an already reviewed caption artifact into the active sequence, or create a local lecture-caption timing and review workflow plan. Import reports structural success only when the host exposes a caption-track readback; the planning action never contacts Premiere or changes an artifact.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { + "action": { + "default": "import", + "description": "Use import (the default) to create a Premiere caption track, or plan_lecture_workflow for a read-only SRT/VTT timing and review plan.", + "enum": [ + "import", + "plan_lecture_workflow" + ], + "type": "string" + }, + "allow_proportional_scaling": { + "description": "For plan_lecture_workflow, explicitly permit a bounded timing-scale preview when the artifact end does not match target_duration_seconds. This still never rewrites a caption artifact.", + "type": "boolean" + }, + "artifact_format": { + "description": "For plan_lecture_workflow, the syntax of caption_content. VTT content must include its WEBVTT header.", + "enum": [ + "srt", + "vtt" + ], + "type": "string" + }, + "caption_content": { + "description": "For plan_lecture_workflow, the caller-owned SRT or VTT content to parse locally. The returned plan contains no caption text and does not write this artifact.", + "maxLength": 750000, + "minLength": 1, + "type": "string" + }, "caption_format": { - "description": "Caption format: 'subtitle' (default), '608', '708', 'teletext', 'ebu', 'op42', 'op47'", + "description": "For action import, Premiere caption format: subtitle (default), 608, 708, teletext, ebu, op42, or op47.", "type": "string" }, "item_id": { - "description": "Node ID or name of the imported caption project item (e.g., an .srt file)", + "description": "For action import, the node ID or name of the imported caption project item (for example, an SRT file). Omit for plan_lecture_workflow.", + "maxLength": 512, "type": "string" }, + "observed_offset_seconds": { + "description": "For plan_lecture_workflow, an editor-observed constant offset in seconds. Positive means captions currently appear later than intended; the preview proposes the inverse shift when safe.", + "maximum": 86400, + "minimum": -86400, + "type": "number" + }, "start_seconds": { - "description": "Offset in seconds from the start of the sequence (default: 0)", + "description": "For action import, offset in seconds from the start of the sequence (default: 0).", + "maximum": 604800, + "minimum": 0, "type": "number" + }, + "target_duration_seconds": { + "description": "For plan_lecture_workflow, optional intended sequence duration. A mismatch requires review unless proportional scaling is explicitly authorized.", + "maximum": 604800, + "minimum": 0.001, + "type": "number" + }, + "timing_tolerance_seconds": { + "description": "For plan_lecture_workflow, tolerance used to classify an offset or duration mismatch (default: 0.25 seconds).", + "maximum": 10, + "minimum": 0.001, + "type": "number" } }, - "required": [ - "item_id" - ], "type": "object" }, "name": "create_caption_track", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/create_context_edit_plan +++ observed/create_context_edit_plan { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "intent": { "description": "Editing goal, such as finding the strongest budget explanation for a rough cut", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/create_editorial_context_pack +++ observed/create_editorial_context_pack { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "intent": { "description": "The editorial question used to retrieve and compact local evidence.", + "maxLength": 1000, + "minLength": 1, "type": "string" }, "kinds": { - "type": "array" + "maxItems": 8, + "minItems": 1, + "type": "array", + "uniqueItems": true }, "max_characters": { + "default": 12000, "description": "Strict maximum length of the Markdown reading view.", "maximum": 24000, "minimum": 1024, + "default": 12, "description": "Maximum matching evidence entries to include.", "maximum": 50, "minimum": 1, + "maxLength": 512, + "minLength": 1, "type": "string" }, "sequence_id": { + "maxLength": 512, + "minLength": 1, "type": "string" } }, - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/create_editorial_plan +++ observed/create_editorial_plan { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "intent": { "description": "The editorial goal used to retrieve relevant local evidence.", + "maxLength": 1000, + "minLength": 1, "type": "string" }, "max_candidates": { - "additionalProperties": {}, + "additionalProperties": false, "properties": { "color_index": { "maximum": 14, + "maxLength": 512, + "minLength": 1, "type": "string" }, + "maxItems": 64, + "minItems": 1, "type": "array" }, "name": { + "maxLength": 255, + "minLength": 1, "type": "string" } }, + "maxItems": 16, "type": "array" }, "platform_targets": { - "additionalProperties": {}, + "additionalProperties": false, "properties": { "height": { "maximum": 8192, + "maxLength": 64, + "minLength": 1, "type": "string" }, "sequence_name": { + "maxLength": 255, + "minLength": 1, "type": "string" }, "width": { + "maxItems": 8, + "minItems": 1, "type": "array" }, "project_id": { + "maxLength": 512, + "minLength": 1, "type": "string" }, "sequence_id": { + "maxLength": 128, + "minLength": 1, "type": "string" }, "workflow": { - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
+ tool added: create_mogrt_batch
+ tool added: create_mogrt_recipe
--- pinned/create_project +++ observed/create_project { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "path": { "description": "Full file path for the new .prproj file", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/create_project_backup +++ observed/create_project_backup { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "project_path": { "description": "Absolute or working-directory-relative path to an existing .prproj file", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/create_sequence +++ observed/create_sequence { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "name": { "description": "Name for the new sequence", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
+ tool added: create_sequence_checkpoint
--- pinned/create_sequence_from_clips +++ observed/create_sequence_from_clips { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "item_ids": { "description": "Array of project item names or node IDs to include in order", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/create_sequence_from_preset +++ observed/create_sequence_from_preset { "annotations": { "destructiveHint": false, - "description": "Create a new sequence from a specific preset file (.sqpreset)", + "description": "EXPERIMENTAL (undocumented QE DOM): create a new sequence from a specific preset file (.sqpreset) using qe.project.newSequence. Reports success only after a new sequence ID appears in the project collection; a same-name sequence that was already active is not treated as created.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "name": { "description": "Name for the new sequence", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/create_smart_bin +++ observed/create_smart_bin { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "name": { "description": "Name for the smart bin", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/create_subclip +++ observed/create_subclip { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "in_seconds": { "description": "In-point in seconds", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/create_subsequence +++ observed/create_subsequence { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "ignore_track_targeting": { "description": "Whether to ignore track targeting (default: false)", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/crop_clip +++ observed/crop_clip { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "bottom": { "description": "Percent cropped from the bottom edge.", + "maxLength": 512, + "minLength": 1, "type": "string" }, "right": { - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/delete_bin +++ observed/delete_bin { "annotations": { "destructiveHint": true, + "additionalProperties": false, "properties": { "bin_id": { "description": "Name or node ID of the bin to delete", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/delete_marker +++ observed/delete_marker { "annotations": { "destructiveHint": true, - "description": "Delete a marker at a specific time position", + "description": "Delete a marker at a specific time position. EXPERIMENTAL (QE DOM): the receipt reports undoStackIndex movement, which does not prove QE can reverse the marker. Every marker attempt protects an engine undo boundary; undoTracked:false means the marker did not observably advance the QE index.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "node_id": { - "description": "Optional clip node ID (deletes from sequence if omitted)", + "description": "Optional clip node ID (deletes from sequence if omitted). Premiere 25.2.3 timeline clips have no marker collection, so this refuses there.", "type": "string" }, "time_seconds": { - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/delete_multiple_project_items +++ observed/delete_multiple_project_items { "annotations": { "destructiveHint": true, - "description": "Delete multiple project items at once from the project panel.", + "description": "Delete several project items (bins, sequences, clips or files) and read back that each is gone. Every item is checked before any is deleted. organize_project_items_uxp with action 'remove' (authenticated UXP bridge) is the preferred, documented route; this CEP fallback deletes clips and files through a temporary bin, which cannot be undone here. Items (or bins whose contents are) used on a timeline are refused unless confirm_remove_from_sequences is true.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { + "confirm_remove_from_sequences": { + "description": "Delete even when an item (or something inside a bin) is used in a sequence, which also removes those timeline clips (default: false).", + "type": "boolean" + }, "item_ids": { "description": "Array of node IDs or names of items to delete", "items": { - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/delete_preview_files +++ observed/delete_preview_files { "annotations": { "destructiveHint": true, + "additionalProperties": false, "properties": { "media_type": { "description": "Type of preview files to delete: 'video', 'audio', or 'all' (default: 'all')", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/delete_project_item +++ observed/delete_project_item { "annotations": { "destructiveHint": true, - "description": "Delete a project item (clip, bin, etc.) from the project panel. This removes it from the project but does not affect timeline instances.", + "description": "Delete a project item (bin, sequence, clip or file) from the project panel and read back that it is gone. organize_project_items_uxp with action 'remove' (authenticated UXP bridge) is the preferred, documented route. This CEP fallback deletes a clip or file by moving it into a temporary bin and deleting that bin, which cannot be undone here. Deleting media also removes its clips from every sequence, so an item (or a bin whose contents are) used on a timeline is refused unless confirm_remove_from_sequences is true.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { + "confirm_remove_from_sequences": { + "description": "Delete even when the item (or something inside the bin) is used in a sequence, which also removes those timeline clips (default: false).", + "type": "boolean" + }, "item_id": { "description": "Node ID or name of the project item to delete", "type": "string" - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/delete_sequence +++ observed/delete_sequence { "annotations": { "destructiveHint": true, + "additionalProperties": false, "properties": { "sequence_id": { "description": "Sequence name or ID to delete", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/delete_track +++ observed/delete_track { "annotations": { "destructiveHint": true, - "description": "Delete a video or audio track from the active sequence", + "description": "EXPERIMENTAL (undocumented QE DOM: removeVideoTrack/removeAudioTrack). Delete a video or audio track from the active sequence through QE and verify that exactly that track was removed (the remaining tracks keep their clips, custom names and lock/mute state in order). Refuses a track that still holds clips unless force is true.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { + "force": { + "description": "Also delete a track that holds clips, removing those clips (default: false)", + "type": "boolean" + }, "track_index": { "description": "Index of the track to delete (0-based)", "type": "number" - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/deselect_all_clips +++ observed/deselect_all_clips { "annotations": { "destructiveHint": false, - "properties": {}, "type": "object" }, "name": "deselect_all_clips", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/detach_proxy +++ observed/detach_proxy { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "item_id": { "description": "Node ID or name of the project item", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/detect_active_picture_bounds +++ observed/detect_active_picture_bounds { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "limit": { "description": "Cropdetect black threshold from 0 through 255 (default: 24)", - "maximum": 9007199254740991, - "minimum": -9007199254740991, "type": "integer" }, "media_path": { - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/detect_audio_transients +++ observed/detect_audio_transients { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "maximum_events": { "description": "Maximum returned candidates from 1 through 1000 (default: 200)", - "maximum": 9007199254740991, - "minimum": -9007199254740991, "type": "integer" }, "media_path": { - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/detect_beats +++ observed/detect_beats { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "max_beats": { "description": "Maximum beat times returned (default: 500).", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/detect_motion_peaks +++ observed/detect_motion_peaks { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "maximum_events": { "description": "Maximum returned candidates from 1 through 1000 (default: 200)", - "maximum": 9007199254740991, - "minimum": -9007199254740991, "type": "integer" }, "media_path": { - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
+ tool added: detect_repeated_takes
--- pinned/detect_scene_edits +++ observed/detect_scene_edits { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "confirm_non_undoable": { "description": "Must be true because the host operation mutates the project and is not claimed undoable.", + "pattern": "^[A-Za-z0-9._:-]{1,128}$", "type": "string" } }, - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/detect_silence +++ observed/detect_silence { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "media_path": { "description": "Absolute path to the media file to analyse. Provide this or project_item_id.", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/detect_source_scene_changes +++ observed/detect_source_scene_changes { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "maximum_events": { "description": "Maximum returned changes (default: 500; maximum: 2000)", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
+ tool added: diff_sequence_snapshots
--- pinned/duplicate_clip +++ observed/duplicate_clip { "annotations": { "destructiveHint": false, - "description": "Duplicate a clip on the timeline (copy to same position on next available track)", + "description": "EXPERIMENTAL: Duplicate a timeline clip, with its linked audio/video partner, onto the first tracks above it that are empty for the clip's time range. The copy keeps the clip's source in point and visible duration, is placed with an overwrite edit (nothing ripples), and is read back. A post-write mismatch is committed_unverified; inspect the timeline or use Undo. Fails without changes when no free track is available; add one with add_tracks.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "node_id": { "description": "Node ID of the clip to duplicate", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/duplicate_sequence +++ observed/duplicate_sequence { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "sequence_id": { "description": "Sequence name or ID to duplicate", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/enable_disable_clip +++ observed/enable_disable_clip { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "enabled": { "description": "Set to true to enable, false to disable", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/encode_file +++ observed/encode_file { "annotations": { "destructiveHint": false, - "description": "Request an Adobe Media Encoder encode for an external file. The returned job ID is an unverified handoff; verify queue presence or the output file independently.", + "description": "Request an Adobe Media Encoder encode for an external file. Requires a saved project. The returned job ID is an unverified handoff; verify queue presence or the output file independently. Optional start_batch requests processing of every ready AME queue job, including unrelated jobs.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "in_seconds": { "description": "Optional start time in seconds", + }, + "start_batch": { + "description": "Opt in to start the entire ready Adobe Media Encoder queue after this handoff, including unrelated jobs. Default false (enqueue only). A successful call does not verify that any render started or completed.", + "type": "boolean" } }, "required": [ - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/encode_project_item +++ observed/encode_project_item { "annotations": { "destructiveHint": false, - "description": "Request an Adobe Media Encoder encode for a project item. The returned job ID is an unverified handoff; verify queue presence or the output file independently.", + "description": "Request an Adobe Media Encoder encode for a project item. Requires a saved project. The returned job ID is an unverified handoff; verify queue presence or the output file independently. Optional start_batch requests processing of every ready AME queue job, including unrelated jobs.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "item_id": { "description": "Node ID or name of the project item to encode", + }, + "start_batch": { + "description": "Opt in to start the entire ready Adobe Media Encoder queue after this handoff, including unrelated jobs. Default false (enqueue only). A successful call does not verify that any render started or completed.", + "type": "boolean" } }, "required": [ - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
+ tool added: enqueue_after_effects_render
--- pinned/export_aaf +++ observed/export_aaf { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "bits_per_sample": { "description": "Audio bit depth (default: 16)", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/export_as_fcp_xml +++ observed/export_as_fcp_xml { "annotations": { "destructiveHint": false, - "description": "Export the active sequence as a Final Cut Pro XML file", + "description": "Export the active sequence as a Final Cut Pro XML file. Fails when Premiere writes no file or leaves a pre-existing output unchanged.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "output_path": { "description": "Full output file path (e.g., '/Users/me/export.xml')", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/export_as_project +++ observed/export_as_project { "annotations": { "destructiveHint": false, - "description": "Export a sequence as a standalone Premiere Pro project file", + "description": "Export a sequence as a standalone Premiere Pro project file. Fails when Premiere writes no file or leaves a pre-existing output unchanged.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "output_path": { "description": "Full path for the exported .prproj file", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/export_frame +++ observed/export_frame { "annotations": { "destructiveHint": false, - "description": "Export the current frame as an image file", + "description": "Export a file-verified still image. QE frame capture may not evaluate keyframed animation like an actual video export; it does not verify temporal curves or playback.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "output_path": { "description": "Full output file path (e.g., '/Users/me/frame.png'). Extension determines format.", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/export_omf +++ observed/export_omf { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "audio_encapsulated": { "description": "Embed audio in OMF (true) or reference external files (false). Default: true", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/export_sequence +++ observed/export_sequence { "annotations": { "destructiveHint": false, - "description": "Export the active sequence using Adobe Media Encoder", + "description": "Export the active sequence directly (Premiere renders it; blocks until done) with an Adobe Media Encoder preset. The output extension must match what the preset writes (an H.264 preset in AME's QuickTime folder writes .mov); a missing extension is added. Refuses an output_path that already exists unless overwrite is true. Fails if Premiere rejects the render, and verifies a non-empty file was written (for an overwrite, that the file changed). range 'work_area' fails closed unless the work area is enabled and covers only part of the sequence — otherwise Premiere would encode the entire timeline.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "output_path": { "description": "Full output file path (e.g., '/Users/me/exports/video.mp4')", + "overwrite": { + "description": "Replace a file that already exists at output_path (default: false, which refuses the export). The replacement is only reported as written when the file's size or modification time changes.", + "type": "boolean" + }, "preset_path": { - "description": "Path to an AME preset file (.epr). Uses default H.264 if omitted.", + "description": "Path to an AME preset file (.epr). Uses the default H.264 (MP4) Match Source preset if omitted.", "type": "string" }, + "range": { + "description": "What to render: the entire sequence (default), the sequence in/out range (set_sequence_in_out_points), or the work area. work_area requires an enabled work area around part of the sequence; unset or full-sequence work areas are refused instead of encoding everything. Set and read back a valid work area where the host supports it, or use in_to_out for a ranged export.", + "enum": [ + "entire", + "in_to_out", + "work_area" + ], + "type": "string" + }, + "timeout_minutes": { + "description": "How long to wait for the render (default: 15; long sequences such as full podcast episodes may need more)", + "maximum": 240, + "minimum": 1, + "type": "number" + }, "work_area_only": { - "description": "Export only the work area (default: false, exports entire sequence)", + "description": "Deprecated alias for range: 'work_area'", "type": "boolean" } }, - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/export_sequence_clip_review_frames +++ observed/export_sequence_clip_review_frames { "annotations": { "destructiveHint": false, - "description": "Export one file-verified composite frame at the midpoint of each clip on a chosen video track in one bridge request. Read-only in Premiere; it does not mute tracks or claim visual quality.", + "description": "Export one file-verified still frame at the midpoint of each clip on a chosen video track in one bridge request. Read-only in Premiere; it does not mute tracks or claim visual quality.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "limit": { "description": "Maximum clips to sample (default: 20; maximum: 50)", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
+ tool added: export_sequence_edl
--- pinned/export_sequence_marker_review_frames +++ observed/export_sequence_marker_review_frames { "annotations": { "destructiveHint": false, - "description": "Export up to 24 file-verified composite frames at active-sequence marker positions in one bridge request for marker-driven review. It reads markers and writes image files only; it does not add, update, or remove Premiere markers.", + "description": "Export up to 24 file-verified still frames at active-sequence marker positions in one bridge request for marker-driven review. It reads markers and writes image files only; it does not add, update, or remove Premiere markers.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "end_seconds": { "description": "Optional positive exclusive upper bound for marker positions in seconds.", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/export_sequence_review_frames +++ observed/export_sequence_review_frames { "annotations": { "destructiveHint": false, - "description": "Export 2-24 evenly spaced, file-verified frames from an active-sequence range in one bridge round trip for visual review. This samples rendered output; it does not prove playback, audio, or editorial quality.", + "description": "Export 2-24 evenly spaced, file-verified frames from an active-sequence range in one bridge round trip for visual review. Still capture does not verify temporal animation, playback, audio, or editorial quality; QE frames can differ from actual video exports.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "end_seconds": { "description": "Optional positive range end in seconds (default: sequence end)", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/extract_selection +++ observed/extract_selection { "annotations": { "destructiveHint": false, - "description": "Extract (remove and close gap) the content between sequence in/out points.", + "description": "EXPERIMENTAL (undocumented QE DOM: extract()). Extract (remove and close the gap) the content between the sequence in/out points on every targeted, unlocked track, then verify each targeted track lost exactly the range and its later clips moved up by the range. Requires sequence in/out marks that do not span the whole sequence. Premiere can also change untargeted tracks (for example the linked audio of targeted video, or sync-locked tracks); those are not verified but are listed in otherTracksChanged.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", - "properties": {}, "type": "object" }, "name": "extract_selection", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/find_items_by_media_path +++ observed/find_items_by_media_path { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "path_search": { "description": "Partial file path to search for", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/find_project_item_by_name +++ observed/find_project_item_by_name { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "name": { "description": "Name of the project item to find", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/freeze_frame +++ observed/freeze_frame { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "duration_seconds": { "description": "Duration of the freeze frame on the timeline (default: 2)", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/generate_media_contact_sheet +++ observed/generate_media_contact_sheet { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "columns": { "description": "Grid columns from 2 through 8 (default: 4)", - "maximum": 9007199254740991, - "minimum": -9007199254740991, "type": "integer" }, "media_path": { - "maximum": 9007199254740991, - "minimum": -9007199254740991, "type": "integer" }, "thumbnail_width": { - "maximum": 9007199254740991, - "minimum": -9007199254740991, "type": "integer" } }, - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/get_active_sequence +++ observed/get_active_sequence { "annotations": { "destructiveHint": false, - "description": "Get detailed information about the currently active sequence", + "description": "Get bounded, paged information about the currently active sequence (50 clips by default). Follow pagination.nextOffset for more", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", - "properties": {}, + "additionalProperties": false, + "properties": { + "clip_limit": { + "description": "Page size (default: 50, maximum: 200). Payload budget may shorten a page. Inspect nextOffset.", + "maximum": 200, + "minimum": 1, + "type": "integer" + }, + "clip_offset": { + "description": "Offset into matching clips (matching gaps for get_timeline_gaps), video before audio (default: 0).", + "minimum": 0, + "type": "integer" + }, + "end_seconds": { + "description": "Optional exclusive window end; must exceed start_seconds.", + "minimum": 0, + "type": "number" + }, + "start_seconds": { + "description": "Optional inclusive window start; returns overlapping items.", + "minimum": 0, + "type": "number" + }, + "track_index": { + "description": "Optional zero-based track index within each selected type.", + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Track type to page (default: both). Track counts remain available.", + "enum": [ + "video", + "audio", + "both" + ], + "type": "string" + } + }, "type": "object" }, "name": "get_active_sequence", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/get_advanced_feature_support +++ observed/get_advanced_feature_support { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "backend": { "description": "Backend being evaluated (default: cep, the current production MCP transport)", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/get_all_project_paths +++ observed/get_all_project_paths { "annotations": { "destructiveHint": false, - "properties": {}, "type": "object" }, "name": "get_all_project_paths", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/get_av_feature_support +++ observed/get_av_feature_support { "annotations": { "destructiveHint": false, - "properties": {}, "type": "object" }, "name": "get_av_feature_support", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/get_bin_contents +++ observed/get_bin_contents { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "bin_id": { - "description": "Bin name, node ID, or path (e.g., 'Footage', 'Footage/Raw')", + "description": "Bin name, node ID, or path (e.g., 'Footage', 'Footage/Raw'); '/' or 'root' for the project root", "type": "string" }, "limit": { - "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/get_bridge_telemetry +++ observed/get_bridge_telemetry { "annotations": { "destructiveHint": false, - "properties": {}, "type": "object" }, "name": "get_bridge_telemetry", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/get_capabilities +++ observed/get_capabilities { "annotations": { "destructiveHint": false, - "description": "Report Windows/macOS support, Premiere Pro backend coverage, enabled authority, and whether live host verification is still required. Use tool_names or tool_offset/tool_limit to return a bounded tool catalog.", + "description": "Discover Premiere operations and report backend coverage, authority, and verification requirements. Use tool_query with task keywords (for example transcript, captions, or review frames) for ranked, bounded matches available in this session. Use tool_names for exact lookups or tool_offset/tool_limit for paging. Discovery never grants authority or proves a live host is ready.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { + "available_only": { + "description": "Filter to tools registered under this session's authority and tool packs. Defaults to true for tool_query, false otherwise. Set false to diagnose unavailable matches; this does not enable them.", + "type": "boolean" + }, "tool_limit": { "description": "Maximum tool catalog entries to return. Omit with tool_offset to preserve the complete legacy response.", "maximum": 128, + "maxLength": 256, + "minLength": 1, "type": "string" }, - "type": "array" + "maxItems": 128, + "minItems": 1, + "type": "array", + "uniqueItems": true }, "tool_offset": { "description": "Zero-based offset into the filtered tool catalog. Pair with tool_limit for an explicitly sized page.", - "maximum": 9007199254740991, "minimum": 0, "type": "integer" + }, + "tool_query": { + "description": "Optional case-insensitive keywords matched against tool names and descriptions. Exact names rank first. Search defaults to 20 results with descriptions and session availability; page with tool_offset/tool_limit.", + "maxLength": 256, + "minLength": 1, + "pattern": "\\S", + "type": "string" } }, "type": "object" - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
+ tool added: get_caption_style_guidance
--- pinned/get_clip_adjustment_layer +++ observed/get_clip_adjustment_layer { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "node_id": { "description": "Node ID of the clip", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/get_clip_at_playhead +++ observed/get_clip_at_playhead { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "track_type": { "description": "Track type to check (default: both)", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/get_clip_at_position +++ observed/get_clip_at_position { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "time_seconds": { "description": "Time position in seconds", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/get_clip_links +++ observed/get_clip_links { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "node_id": { "description": "Node ID of the clip", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/get_clip_markers +++ observed/get_clip_markers { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "item_id": { "description": "Node ID or name of the project item", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/get_clip_properties +++ observed/get_clip_properties { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "node_id": { "description": "The node ID of the clip", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/get_clip_speed +++ observed/get_clip_speed { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "node_id": { "description": "Node ID of the clip", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/get_clip_volume +++ observed/get_clip_volume { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "node_id": { "description": "Node ID of the audio clip", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/get_color_label +++ observed/get_color_label { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "item_id": { "description": "Node ID or name of the project item", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/get_color_space +++ observed/get_color_space { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "item_id": { "description": "Node ID or name of the project item", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/get_duplicate_media +++ observed/get_duplicate_media { "annotations": { "destructiveHint": false, - "description": "Find project items that reference the same source media file. Useful for consolidation.", + "description": "Find project items that reference the same source media file. Useful for consolidation. After Effects compositions imported from the same .aep/.aepx are only grouped when their comp names also match. Groups are paged (default 100) and can be filtered by a case-insensitive item-name substring; follow nextOffset while truncated is true.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", - "properties": {}, + "additionalProperties": false, + "properties": { + "contains": { + "description": "Optional case-insensitive substring matched against project item names before paging. Omit or pass an empty string to include every entry.", + "maxLength": 256, + "type": "string" + }, + "limit": { + "description": "Maximum duplicate media groups (a group matches contains when any item name matches) entries to return (1-500, default 100).", + "maximum": 500, + "minimum": 1, + "type": "integer" + }, + "offset": { + "description": "Zero-based index of the first duplicate media groups (a group matches contains when any item name matches) entry to return (default 0). Pass the previous response's nextOffset to read the next page.", + "minimum": 0, + "type": "integer" + } + }, "type": "object" }, "name": "get_duplicate_media", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/get_effect_properties +++ observed/get_effect_properties { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "effect_name": { "description": "Display name of the effect (e.g., 'Motion', 'Opacity', 'Lumetri Color')", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/get_encoder_presets +++ observed/get_encoder_presets { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "format": { - "description": "Filter to presets whose name or format bucket matches this (e.g. 'H.264', 'ProRes', 'Proxy'). Omit to list all.", + "description": "Filter by container/format (e.g. 'H.264', 'mp4', 'QuickTime', 'WAV') or preset name (e.g. 'ProRes', 'Proxy'). Presets whose format matches come first. Omit to list all.", "type": "string" } }, - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/get_export_file_extension +++ observed/get_export_file_extension { "annotations": { "destructiveHint": false, - "description": "Get the file extension that would be used when exporting the active sequence with a given preset", + "description": "Get the export file extension from Premiere. If Premiere returns none, infer it only for an existing .epr in a recognized Adobe Media Encoder format folder; that fallback is marked unconfirmed and should be checked before delivery.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "preset_path": { "description": "Full path to the export preset file (.epr)", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/get_footage_interpretation +++ observed/get_footage_interpretation { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "item_id": { "description": "Node ID or name of the project item", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/get_full_clip_info +++ observed/get_full_clip_info { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "node_id": { "description": "Node ID of the clip on the timeline", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/get_full_project_overview +++ observed/get_full_project_overview { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "include_bin_tree": { "description": "Include the recursive bin tree (default: true). Set false to return project statistics and sequences only.", - "maximum": 9007199254740991, "minimum": 0, "type": "integer" } - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/get_full_sequence_info +++ observed/get_full_sequence_info { "annotations": { "destructiveHint": false, - "description": "Get exhaustive information about a sequence: settings, all tracks with lock/mute/target state, all clips with positions/effects/speed/enabled state, all markers, transitions, in/out points, and work area.", + "description": "Get bounded information about a sequence (50 clips by default; follow pagination.nextOffset; markers and transitions capped at 50 per collection): settings, all tracks with lock/mute/target state, paged clips with positions/effects/speed/enabled state, bounded markers, transitions, in/out points, and work area.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { + "clip_limit": { + "description": "Page size (default: 50, maximum: 200). Payload budget may shorten a page. Inspect nextOffset.", + "maximum": 200, + "minimum": 1, + "type": "integer" + }, + "clip_offset": { + "description": "Offset into matching clips (matching gaps for get_timeline_gaps), video before audio (default: 0).", + "minimum": 0, + "type": "integer" + }, + "end_seconds": { + "description": "Optional exclusive window end; must exceed start_seconds.", + "minimum": 0, + "type": "number" + }, "sequence_id": { "description": "Sequence name or ID. Uses active sequence if omitted.", "type": "string" + }, + "start_seconds": { + "description": "Optional inclusive window start; returns overlapping items.", + "minimum": 0, + "type": "number" + }, + "track_index": { + "description": "Optional zero-based track index within each selected type.", + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Track type to page (default: both). Track counts remain available.", + "enum": [ + "video", + "audio", + "both" + ], + "type": "string" } }, "type": "object" - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/get_graphics_white_luminance +++ observed/get_graphics_white_luminance { "annotations": { "destructiveHint": false, - "properties": {}, "type": "object" }, "name": "get_graphics_white_luminance", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/get_insertion_bin +++ observed/get_insertion_bin { "annotations": { "destructiveHint": false, - "properties": {}, "type": "object" }, "name": "get_insertion_bin", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/get_item_info +++ observed/get_item_info { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "item_id": { "description": "Node ID or name of the project item", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/get_keyframes +++ observed/get_keyframes { "annotations": { "destructiveHint": false, - "description": "Get all keyframes for a specific effect property on a clip", + "description": "Get all keyframes for a specific effect property on a clip. Each key's time is in seconds from the clip's start; mediaSeconds is Premiere's stored media time.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "effect_name": { "description": "Display name of the effect", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/get_linked_items +++ observed/get_linked_items { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "node_id": { "description": "Node ID of the clip", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/get_metadata +++ observed/get_metadata { "annotations": { "destructiveHint": false, - "description": "Get metadata for a project item. Disable either XML payload when a bounded identity/path response is sufficient.", + "description": "Get metadata for a project item. Use parse_fields to return named XMP/project fields instead of raw XML. Project metadata XML and file/clip XMP are separate packets; disable either when identity/path is enough. Prefer inspect_project_panel_metadata_uxp item_columns or manage_metadata_uxp inspect_fields for visible columns. This is not the premiere://project/metadata resource. GPS and serials are omitted from parse_fields unless include_sensitive is true.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "include_project_metadata": { - "description": "Include the potentially large Project Metadata XML payload (default: true). Set false for a bounded identity/path response.", + "description": "Include the potentially large Project Metadata XML payload (default: true unless parse_fields is true).", "type": "boolean" }, + "include_sensitive": { + "description": "When parse_fields is true, include GPS, serials, and similar EXIF. Default false.", + "type": "boolean" + }, "include_xmp_metadata": { - "description": "Include the potentially large XMP XML payload (default: true). Set false for a bounded identity/path response.", + "description": "Include the potentially large XMP XML payload (default: true unless parse_fields is true).", "type": "boolean" }, "item_id": { + }, + "parse_fields": { + "description": "Parse project metadata and XMP into named fields (default false). When true, raw XML is omitted unless include_project_metadata or include_xmp_metadata is explicitly true.", + "type": "boolean" } }, "required": [ - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/get_mogrt_component +++ observed/get_mogrt_component { "annotations": { "destructiveHint": false, - "description": "Get MOGRT (Motion Graphics Template) component parameters from a clip", + "description": "Get MOGRT (Motion Graphics Template) component parameters from a clip. Each parameter includes textValue (visible text extracted from textEditValue when present). Pass expected_values to audit text controls such as Headline; the result flags verified, mismatch, or missing_property per field. Reads the stored property, not the Essential Graphics panel display, which Premiere can show stale (host UI behavior this tool cannot refresh).", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { + "expected_values": { + "additionalProperties": { + "type": "string" + }, + "description": "Optional read-only audit map of MOGRT text parameter display names to the text each should contain (for example { \"Headline\": \"Chapter 3\" }). Result audit.status is verified, mismatch, or missing_property.", + "type": "object" + }, "node_id": { "description": "Node ID of the MOGRT clip on the timeline", "type": "string" - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/get_next_edit_point +++ observed/get_next_edit_point { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "direction": { "description": "Direction to search (default: next)", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/get_offline_media +++ observed/get_offline_media { "annotations": { "destructiveHint": false, - "properties": {}, "type": "object" }, "name": "get_offline_media", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/get_playhead_position +++ observed/get_playhead_position { "annotations": { "destructiveHint": false, - "properties": {}, "type": "object" }, "name": "get_playhead_position", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/get_premiere_state +++ observed/get_premiere_state { "annotations": { "destructiveHint": false, - "properties": {}, "type": "object" }, "name": "get_premiere_state", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/get_project_info +++ observed/get_project_info { "annotations": { "destructiveHint": false, - "properties": {}, "type": "object" }, "name": "get_project_info", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/get_project_item_info +++ observed/get_project_item_info { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "item_id": { "description": "Node ID or name of the project item", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/get_project_panel_metadata +++ observed/get_project_panel_metadata { "annotations": { "destructiveHint": false, - "description": "Get the current project panel metadata/column configuration as XML", + "description": "Get the current Project-panel column layout as XML. This is schema/layout configuration, not per-item Scene/Shot/Take values; use inspect_project_panel_metadata_uxp item_columns or get_metadata for those. Output is capped by max_chars (default 20000); when truncated is true the XML is incomplete and must not be passed to set_project_panel_metadata.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", - "properties": {}, + "additionalProperties": false, + "properties": { + "max_chars": { + "description": "Maximum characters of metadata XML to return (256-200000, default 20000). Longer XML is cut at this length and reported with truncated: true and totalChars.", + "maximum": 200000, + "minimum": 256, + "type": "integer" + } + }, "type": "object" }, "name": "get_project_panel_metadata", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/get_project_scratch_disks +++ observed/get_project_scratch_disks { "annotations": { "destructiveHint": false, - "description": "Get the current scratch disk paths for the project.", + "description": "Get the project's scratch disk locations (captured media, previews, auto-save, Motion Graphics template media, and more). Premiere's scripting API has no scratch-disk getter, so the settings are read from the saved .prproj file; unsaved changes are not reflected. 'SameAsProject' resolves to the project's folder.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", - "properties": {}, "type": "object" }, "name": "get_project_scratch_disks", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/get_qe_clip_info +++ observed/get_qe_clip_info { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "clip_index": { "description": "Clip index on the track (0-based)", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/get_render_queue_status +++ observed/get_render_queue_status { "annotations": { "destructiveHint": false, - "description": "Get the current status of the Adobe Media Encoder render queue", + "description": "Report the Adobe Media Encoder queue running state, or fail closed with a named capability error when this Premiere build exposes no queue-status method on app.encoder.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", - "properties": {}, "type": "object" }, "name": "get_render_queue_status", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/get_selected_clips +++ observed/get_selected_clips { "annotations": { "destructiveHint": false, - "properties": {}, "type": "object" }, "name": "get_selected_clips", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/get_sequence_count +++ observed/get_sequence_count { "annotations": { "destructiveHint": false, - "properties": {}, "type": "object" }, "name": "get_sequence_count", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/get_sequence_in_out_points +++ observed/get_sequence_in_out_points { "annotations": { "destructiveHint": false, - "properties": {}, "type": "object" }, "name": "get_sequence_in_out_points", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/get_sequence_markers_by_type +++ observed/get_sequence_markers_by_type { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "marker_type": { "description": "Type of marker to filter", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/get_sequence_settings +++ observed/get_sequence_settings { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "sequence_id": { "description": "Sequence ID or name. Uses active sequence if omitted.", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/get_sequence_structure +++ observed/get_sequence_structure { "annotations": { "destructiveHint": false, - "description": "Get a complete structural overview of the active sequence: all tracks, all clips with positions, gaps, and clip metadata. Essential for understanding timeline state before making edits.", + "description": "Get a bounded structural page of the active sequence (50 clips by default; follow pagination.nextOffset): all track counts, paged clips with positions, gaps, and clip metadata. Essential for understanding timeline state before making edits.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { + "clip_limit": { + "description": "Page size (default: 50, maximum: 200). Payload budget may shorten a page. Inspect nextOffset.", + "maximum": 200, + "minimum": 1, + "type": "integer" + }, + "clip_offset": { + "description": "Offset into matching clips (matching gaps for get_timeline_gaps), video before audio (default: 0).", + "minimum": 0, + "type": "integer" + }, + "end_seconds": { + "description": "Optional exclusive window end; must exceed start_seconds.", + "minimum": 0, + "type": "number" + }, "sequence_id": { "description": "Sequence name or ID. Uses active sequence if omitted.", + "maxLength": 512, + "minLength": 1, "type": "string" + }, + "start_seconds": { + "description": "Optional inclusive window start; returns overlapping items.", + "minimum": 0, + "type": "number" + }, + "track_index": { + "description": "Optional zero-based track index within each selected type.", + "minimum": 0, + "type": "integer" + }, + "track_type": { + "description": "Track type to page (default: both). Track counts remain available.", + "enum": [ + "video", + "audio", + "both" + ], + "type": "string" } }, "type": "object" - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/get_source_monitor_info +++ observed/get_source_monitor_info { "annotations": { "destructiveHint": false, - "properties": {}, "type": "object" }, "name": "get_source_monitor_info", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/get_source_monitor_position +++ observed/get_source_monitor_position { "annotations": { "destructiveHint": false, - "properties": {}, "type": "object" }, "name": "get_source_monitor_position", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/get_target_tracks +++ observed/get_target_tracks { "annotations": { "destructiveHint": false, - "description": "Get which tracks are currently targeted for editing.", + "description": "Get which tracks are currently targeted for editing. Premiere allows several video or audio tracks to be targeted at the same time; every targeted track is listed. Tracks whose state cannot be read are listed under unreadable.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", - "properties": {}, "type": "object" }, "name": "get_target_tracks", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/get_timeline_gaps +++ observed/get_timeline_gaps { "annotations": { "destructiveHint": false, - "description": "Find all gaps (empty spaces) on the timeline between clips. Useful for identifying where content is missing or where clips can be tightened.", + "description": "Find a bounded page of gaps (50 by default; follow pagination.nextOffset) on the timeline between clips. Useful for identifying where content is missing or where clips can be tightened.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { + "clip_limit": { + "description": "Page size (default: 50, maximum: 200). Payload budget may shorten a page. Inspect nextOffset.", + "maximum": 200, + "minimum": 1, + "type": "integer" + }, + "clip_offset": { + "description": "Offset into matching clips (matching gaps for get_timeline_gaps), video before audio (default: 0).", + "minimum": 0, + "type": "integer" + }, + "end_seconds": { + "description": "Optional exclusive window end; must exceed start_seconds.", + "minimum": 0, + "type": "number" + }, "min_gap_seconds": { "description": "Minimum gap duration in seconds to report (default: 0.04 = ~1 frame at 24fps)", "type": "number" + "start_seconds": { + "description": "Optional inclusive window start; returns overlapping items.", + "minimum": 0, + "type": "number" + }, + "track_index": { + "description": "Optional zero-based track index within each selected type.", + "minimum": 0, + "type": "integer" + }, "track_type": { "description": "Which track type to analyze (default: both)", "enum": [ - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/get_timeline_summary +++ observed/get_timeline_summary { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "sequence_id": { "description": "Sequence name or ID. Uses active sequence if omitted.", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/get_total_clip_count +++ observed/get_total_clip_count { "annotations": { "destructiveHint": false, - "properties": {}, "type": "object" }, "name": "get_total_clip_count", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/get_track_info +++ observed/get_track_info { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "track_index": { "description": "Track index (0-based)", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/get_unused_media +++ observed/get_unused_media { "annotations": { "destructiveHint": false, - "description": "Find all project items that are NOT used in any sequence. Useful for cleaning up projects.", + "description": "Find project items that are NOT used in any sequence. Useful for cleaning up projects. Results are paged (default 100 items) and can be filtered by a case-insensitive name substring; follow nextOffset while truncated is true.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", - "properties": {}, + "additionalProperties": false, + "properties": { + "contains": { + "description": "Optional case-insensitive substring matched against project item names before paging. Omit or pass an empty string to include every entry.", + "maxLength": 256, + "type": "string" + }, + "limit": { + "description": "Maximum unused project items entries to return (1-500, default 100).", + "maximum": 500, + "minimum": 1, + "type": "integer" + }, + "offset": { + "description": "Zero-based index of the first unused project items entry to return (default 0). Pass the previous response's nextOffset to read the next page.", + "minimum": 0, + "type": "integer" + } + }, "type": "object" }, "name": "get_unused_media", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/get_used_media_report +++ observed/get_used_media_report { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "sequence_id": { "description": "Sequence name or ID. Uses active sequence if omitted.", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/get_value_at_time +++ observed/get_value_at_time { "annotations": { "destructiveHint": false, - "description": "Get the interpolated value of an effect property at a specific time", + "description": "Get the interpolated value of an effect property at a time, in seconds from the clip's start", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "effect_name": { "description": "Display name of the effect", - "description": "Time in seconds to query the value at", + "description": "Seconds from the clip's start on the timeline (0 is the clip's first frame) to read the value at", "type": "number" } }, - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/get_version_info +++ observed/get_version_info { "annotations": { "destructiveHint": false, - "properties": {}, "type": "object" }, "name": "get_version_info", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/get_work_area +++ observed/get_work_area { "annotations": { "destructiveHint": false, - "properties": {}, "type": "object" }, "name": "get_work_area", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/get_workspaces +++ observed/get_workspaces { "annotations": { "destructiveHint": false, - "properties": {}, "type": "object" }, "name": "get_workspaces", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/get_xmp_metadata +++ observed/get_xmp_metadata { "annotations": { "destructiveHint": false, - "description": "Get the raw XMP metadata for a project item (includes EXIF, IPTC, Dublin Core, etc.)", + "description": "Get the raw file/clip XMP packet for a project item (Dublin Core, EXIF, IPTC, xmpDM, and other namespaces). Distinct from Premiere-private project metadata. Omit GPS and camera serials from user-facing reports unless requested.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "item_id": { "description": "Node ID or name of the project item", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/has_proxy +++ observed/has_proxy { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "item_id": { "description": "Node ID or name of the project item", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/import_ae_comps +++ observed/import_ae_comps { "annotations": { "destructiveHint": false, - "description": "Import After Effects compositions from an .aep file", + "description": "Import After Effects compositions from an .aep file, failing closed when the file does not exist or when the target bin gains no items.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "ae_project_path": { "description": "Full path to the .aep file", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/import_edl +++ observed/import_edl { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "file_path": { "description": "Absolute path to the CMX 3600 .edl file that was requested for import.", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/import_fcp_xml +++ observed/import_fcp_xml { "annotations": { "destructiveHint": false, - "description": "Import a Final Cut Pro XML file into the current project", + "description": "Open a Final Cut Pro XML file as a new Premiere project. app.openFCPXML(path, projPath) requires a destination project path; it does not merge the XML into the currently open project. verified is true only when that destination exists as a file and Premiere has that exact path open.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "path": { - "description": "Full path to the FCP XML file", + "description": "Full path to the FCP XML file to read", "type": "string" + }, + "project_path": { + "description": "Full path of the new .prproj file Premiere should create for the imported timeline. Required: app.openFCPXML takes both a source and a destination path.", + "type": "string" } }, "required": [ - "path" + "path", + "project_path" ], "type": "object" }, - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/import_folder +++ observed/import_folder { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "folder_path": { "description": "Path to the folder to import", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/import_image_sequence +++ observed/import_image_sequence { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "first_file_path": { "description": "Full path to the first image in the sequence (e.g., /path/to/frame_001.png)", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/import_media +++ observed/import_media { "annotations": { "destructiveHint": false, - "description": "Import media files into the project", + "description": "Import media files into the project and confirm a new project item for each file", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "file_paths": { "description": "Array of file paths to import", + "minLength": 1, "type": "string" }, + "minItems": 1, "type": "array" }, "suppress_ui": { - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/import_mogrt +++ observed/import_mogrt { "annotations": { "destructiveHint": false, - "description": "Import a Motion Graphics Template (.mogrt) file and add it to the timeline", + "description": "Import a Motion Graphics Template (.mogrt) file and add it to the timeline. Pass text_values (for example { \"Headline\": \"...\" }) to write each text control explicitly after insertion and verify it by readback, so a template default or stale value is never left in place silently.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "duration_seconds": { - "description": "Duration in seconds (default: 5)", + "description": "Duration in seconds (default: 5). Applied after import by moving the graphic's end and read back; a duration that would overlap the next clip on the track is not applied.", "type": "number" }, "mogrt_path": { + "text_values": { + "additionalProperties": { + "type": "string" + }, + "description": "Optional map of MOGRT text parameter display names to the exact text to write (for example { \"Headline\": \"Chapter 3\" }). Each value is written explicitly after import and read back; the result reports verified, mismatch, missing_property, or committed_unverified per field.", + "type": "object" + }, "track_index": { "description": "Video track index (default: 0)", "type": "number" - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/import_mogrt_from_library +++ observed/import_mogrt_from_library { "annotations": { "destructiveHint": false, - "description": "Import a MOGRT from a named Adobe Creative Cloud Library.", + "description": "Request importing a MOGRT from a named Adobe Creative Cloud Library. Library contents cannot be enumerated through CEP; host acceptance is committed_unverified, and rendered appearance must be checked in Premiere.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "library_name": { "description": "Name of the Adobe Creative Cloud Library that contains the MOGRT", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/import_sequences +++ observed/import_sequences { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "project_path": { "description": "Full path to the source .prproj file", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/insert_from_source +++ observed/insert_from_source { "annotations": { "destructiveHint": false, - "description": "Insert the clip from the Source Monitor at the playhead position (insert edit — shifts existing clips).", + "description": "Insert the clip from the Source Monitor at the playhead (insert edit). Experimental: a target clip spanning the playhead is QE-razored before insertion to attempt to preserve its split tail. By default the tool also razors and shifts every QE sync-locked track, then reads the placement and target tails back; a displaced tail is reported as committed_unverified. Pass scope 'target_tracks' to ripple only the named pair (this will desync other tracks).", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "audio_track_index": { "description": "Target audio track index (default: 0)", + "scope": { + "description": "Which tracks shift: 'sync_locked' (default) matches Premiere's insert and keeps sync-locked tracks in sync; 'target_tracks' ripples only the named pair and WILL desync other tracks.", + "enum": [ + "sync_locked", + "target_tracks" + ], + "type": "string" + }, "video_track_index": { "description": "Target video track index (default: 0)", "type": "number" - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
+ tool added: inspect_after_effects_render_templates
+ tool added: inspect_after_effects_template_source
--- pinned/inspect_cmx3600_edl +++ observed/inspect_cmx3600_edl { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "path": { "description": "Existing local .edl file", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/inspect_dom_object +++ observed/inspect_dom_object { "annotations": { "destructiveHint": false, - "description": "Inspect a Premiere Pro DOM object and list its properties, methods, and values. Useful for exploring the API and debugging.\n\nExamples:\n- \"app.project\" → project properties\n- \"app.project.activeSequence\" → sequence properties\n- \"app.project.activeSequence.videoTracks[0].clips[0]\" → first clip on V1\n- \"app.project.activeSequence.videoTracks[0].clips[0].components[0]\" → first component of a clip", + "description": "Inspect a Premiere Pro DOM object and list its properties, methods, and values. Useful for exploring the API and debugging. object_path must be a property path starting with app or qe (identifiers and numeric indexes only). Function calls, operators, and statements are rejected; use evaluate_expression with unsafe-script for those.\n\nExamples:\n- \"app.project\" → project properties\n- \"app.project.activeSequence\" → sequence properties\n- \"app.project.activeSequence.videoTracks[0].clips[0]\" → first clip on V1\n- \"app.project.activeSequence.videoTracks[0].clips[0].components[0]\" → first component of a clip", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "max_depth": { "description": "Max depth for nested inspection (default: 1, max: 3)", - "description": "Dot-path to the DOM object to inspect (e.g., 'app.project.activeSequence')", + "description": "Property path starting with app or qe (e.g. 'app.project.activeSequence.videoTracks[0]'). Function calls and statements are rejected.", + "maxLength": 512, + "minLength": 1, "type": "string" } }, - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/inspect_edit_readiness +++ observed/inspect_edit_readiness { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "gap_tolerance_seconds": { "description": "Ignore smaller gaps caused by time rounding (default: 0.001)", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/inspect_fcpxml_interchange +++ observed/inspect_fcpxml_interchange { "annotations": { "destructiveHint": false, - "description": "Inspect a local FCPXML document's root version, sequence/clip counts, bounded asset declarations, and text-only parser warnings before deliberate Premiere import.", + "description": "Inspect a local FCPXML or FCP7 XML (xmeml, what Premiere's export_as_fcp_xml writes) document: format, version, sequence/clip counts, bounded media declarations, and text-only parser warnings, before deliberate Premiere import.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "path": { "description": "Existing local .fcpxml or .xml file", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
+ tool added: inspect_film_editorial_workflow
--- pinned/inspect_media_streams +++ observed/inspect_media_streams { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "media_path": { "description": "Existing local media file", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
+ tool added: inspect_mogrt_library
--- pinned/inspect_project_item_av_metadata +++ observed/inspect_project_item_av_metadata { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "item_id": { "description": "Project item node ID or exact name", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/inspect_project_recovery +++ observed/inspect_project_recovery { "annotations": { "destructiveHint": false, - "properties": {}, "type": "object" }, "name": "inspect_project_recovery", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/inspect_sequence_av_settings +++ observed/inspect_sequence_av_settings { "annotations": { "destructiveHint": false, - "properties": {}, "type": "object" }, "name": "inspect_sequence_av_settings", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/inspect_sequence_review_report +++ observed/inspect_sequence_review_report { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "include_marker_comments": { "description": "Include marker comments. Defaults to false because comments can contain private editorial notes.", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/inspect_stabilizer_status +++ observed/inspect_stabilizer_status { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "node_id": { "description": "Optional clip node ID. Omit to inspect every video clip in the active sequence.", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/invert_selection +++ observed/invert_selection { "annotations": { "destructiveHint": false, - "properties": {}, "type": "object" }, "name": "invert_selection", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/is_work_area_enabled +++ observed/is_work_area_enabled { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": {}, "type": "object" }, - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/lift_selection +++ observed/lift_selection { "annotations": { "destructiveHint": false, - "description": "Lift (remove without closing gap) the content between sequence in/out points or selected clips.", + "description": "EXPERIMENTAL (undocumented QE DOM: the sequence lift command, exposed as left() on 25.2). Lift (remove without closing the gap) the content between the sequence in/out points on every targeted, unlocked track, then verify the range is empty on those tracks and nothing else on them moved. Requires sequence in/out marks that do not span the whole sequence. Untargeted tracks are not verified; any that changed are listed in otherTracksChanged.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", - "properties": {}, "type": "object" }, "name": "lift_selection", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/link_selection +++ observed/link_selection { "annotations": { "destructiveHint": false, - "properties": {}, "type": "object" }, "name": "link_selection", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/list_available_audio_effects +++ observed/list_available_audio_effects { "annotations": { "destructiveHint": false, - "properties": {}, "type": "object" }, "name": "list_available_audio_effects", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/list_available_audio_transitions +++ observed/list_available_audio_transitions { "annotations": { "destructiveHint": false, - "description": "List all available audio transitions. Uses QE DOM and reports an unavailable or empty legacy catalog as an error rather than an assumed usable list.", + "description": "EXPERIMENTAL (undocumented QE DOM): List audio transitions. Reports an unavailable or empty legacy catalog as an error rather than an assumed usable list.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", - "properties": {}, "type": "object" }, "name": "list_available_audio_transitions", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/list_available_effects +++ observed/list_available_effects { "annotations": { "destructiveHint": false, - "properties": {}, "type": "object" }, "name": "list_available_effects", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/list_available_transitions +++ observed/list_available_transitions { "annotations": { "destructiveHint": false, - "description": "List all available video transitions. Uses QE DOM. Returns a hint set on PPro 2026 where the transition registry list is empty even though by-name lookup works.", + "description": "EXPERIMENTAL (undocumented QE DOM): List video transitions. Returns a built-in hint set on PPro 2026 where the registry list is empty even though by-name lookup works; the hint set is not exhaustive.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", - "properties": {}, "type": "object" }, "name": "list_available_transitions", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/list_clip_effects +++ observed/list_clip_effects { "annotations": { "destructiveHint": false, - "description": "List all effects/components on a clip with their properties and current values. Essential for debugging effect issues.", + "description": "List effects/components exposed by the clip's standard DOM collection, with properties and current values. Some hosts omit QE-applied effects from this collection; absence here does not prove an effect is absent. get_effect_properties uses the same collection. Inspect Premiere's Effect Controls UI when complete QE effect presence must be confirmed.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "node_id": { "description": "Node ID of the clip to inspect", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/list_markers +++ observed/list_markers { "annotations": { "destructiveHint": false, - "description": "List all markers on the active sequence or a specific clip", + "description": "List markers on the active sequence, or on a source project item that exposes a marker collection. A timeline-clip node_id returns a clean error instead of a raw TypeError.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "node_id": { "description": "Optional clip node ID to list clip markers instead of sequence markers", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/list_project_items +++ observed/list_project_items { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "bin_path": { "description": "Optional bin path to list items from (e.g., 'Footage/Raw'). Lists root items if omitted.", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
+ tool added: list_sequence_checkpoints
--- pinned/list_sequence_tracks +++ observed/list_sequence_tracks { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "sequence_id": { "description": "Sequence ID or name. Uses active sequence if omitted.", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/list_sequences +++ observed/list_sequences { "annotations": { "destructiveHint": false, - "properties": {}, "type": "object" }, "name": "list_sequences", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
+ tool added: list_stock_titles
--- pinned/lock_track +++ observed/lock_track { "annotations": { "destructiveHint": false, - "description": "Lock or unlock a video track", + "description": "Set a video track's lock state and read it back to verify the change.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "locked": { "description": "True to lock, false to unlock", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
+ tool added: manage_media_watch
--- pinned/manage_project_context +++ observed/manage_project_context { "annotations": { "destructiveHint": true, - "description": "Capture, enrich, inspect, or clear a durable local Premiere project-context index. Capture stores bounded active-sequence/source metadata; enrich adds transcripts, shots, audio observations, or notes without re-analyzing unchanged sources. Never include secrets or unrelated customer data.", + "description": "Capture, enrich, import revision-bound editorial evidence, inspect, or clear a durable local Premiere project-context index. Capture stores bounded active-sequence/source metadata; local enrichment and evidence import add caller-approved transcripts, speaker labels, shots, audio observations, notes, or opaque frame references without re-analyzing media. Never include secrets or unrelated customer data.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "action": { - "description": "Capture active context, enrich it, inspect status, or clear one local project index", + "description": "Capture active context, enrich it, import revision-bound editorial evidence, inspect status, or clear one local project index.", "enum": [ "capture", "enrich", + "import_evidence", "status", "clear" ], + "evidence": { + "description": "For import_evidence, up to 512 caller-approved records with strict source/timeline revision guards. The server does not read referenced frame files, invoke analysis, or contact a provider.", + "items": { + "additionalProperties": false, + "properties": { + "end_seconds": { + "description": "Optional end in seconds at or after start_seconds.", + "minimum": 0, + "type": "number" + }, + "frame_reference_id": { + "description": "For frame_reference, an opaque fixture or review-frame identifier, never a native file path or URL.", + "maxLength": 256, + "type": "string" + }, + "id": { + "description": "Optional stable evidence ID for deterministic replacement.", + "maxLength": 256, + "type": "string" + }, + "keywords": { + "description": "Optional local search keywords.", + "items": { + "description": "One local search keyword.", + "maxLength": 256, + "type": "string" + }, + "maxItems": 64, + "type": "array" + }, + "metadata": { + "description": "Optional small scalar metadata. Credential-like and path-like keys are discarded before local storage.", + "type": "object" + }, + "name": { + "description": "Optional bounded display name for the local evidence record.", + "maxLength": 512, + "type": "string" + }, + "sequence_id": { + "description": "Optional captured sequence ID. Requires the exact current timeline_revision.", + "maxLength": 512, + "type": "string" + }, + "source_id": { + "description": "Optional captured source ID. Requires the exact current source_revision.", + "maxLength": 512, + "type": "string" + }, + "source_revision": { + "description": "Required exact source revision whenever source_id is supplied.", + "maxLength": 256, + "type": "string" + }, + "speaker_label": { + "description": "For transcript_passage or speaker_label, an editor-supplied speaker label. It is not inferred by this server.", + "maxLength": 160, + "type": "string" + }, + "start_seconds": { + "description": "Optional non-negative source or sequence start in seconds.", + "minimum": 0, + "type": "number" + }, + "text": { + "description": "Caller-approved local evidence text. Required except for speaker_label and frame_reference, which can derive a bounded local note.", + "maxLength": 20000, + "type": "string" + }, + "timeline_item_id": { + "description": "Optional captured timeline item ID. Requires the exact current timeline_revision.", + "maxLength": 512, + "type": "string" + }, + "timeline_revision": { + "description": "Required exact timeline revision whenever sequence_id or timeline_item_id is supplied.", + "maxLength": 256, + "type": "string" + }, + "track_index": { + "description": "Optional recorded track index when the evidence is tied to a timeline item.", + "minimum": 0, + "type": "number" + }, + "track_type": { + "description": "Optional recorded track type when the evidence is tied to a timeline item.", + "enum": [ + "video", + "audio" + ], + "type": "string" + }, + "type": { + "description": "Evidence shape: transcript passage, speaker label, shot log, audio observation, operator note, or an opaque frame reference.", + "enum": [ + "transcript_passage", + "speaker_label", + "shot_log", + "audio_observation", + "operator_note", + "frame_reference" + ], + "type": "string" + } + }, + "required": [ + "type" + ], + "type": "object" + }, + "type": "array" + }, "project_id": { "description": "Project context ID returned by capture; optional for status to list projects", "type": "string" - "additionalProperties": {}, "properties": { "end_seconds": { "type": "number" - "additionalProperties": {}, "description": "Small scalar metadata object; path and credential-like keys are discarded", - "propertyNames": { - "type": "string" - }, "type": "object" }, "name": { - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/manage_proxies +++ observed/manage_proxies { "annotations": { "destructiveHint": false, - "description": "Create, attach, or toggle proxies for a project item. Note: 'create' only requests a proxy encode from Adobe Media Encoder and returns an unverified handoff. Independently verify the AME queue or output file before calling this tool again with action 'attach' and proxy_path set to the output_path you passed here. There is no single-call create-and-attach in Premiere's ExtendScript API.", + "description": "Create, attach, or toggle proxies for a project item. Note: 'create' only requests a proxy encode from Adobe Media Encoder and returns an unverified handoff. Independently verify the AME queue or output file before calling this tool again with action 'attach' and proxy_path set to the output_path you passed here. Optional start_batch requests processing of every ready AME queue job, including unrelated jobs. There is no single-call create-and-attach in Premiere's ExtendScript API.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "action": { "description": "Action to perform on proxies", - "description": "Path to a proxy ingest preset (.epr) for 'create'. If omitted, the first preset found in Premiere's IngestPresets/Proxy folder is used.", + "description": "Path to a proxy ingest preset (.epr) for 'create'. If omitted, the server lists Premiere's IngestPresets/Proxy presets and AME H.264 system presets, skips every preset whose output destination is Same as Project (Adobe's shipped proxy presets are), and uses the first remaining one. Fails with a clear error when none qualify.", "type": "string" }, "proxy_path": { + }, + "start_batch": { + "description": "Opt in to start the entire ready Adobe Media Encoder queue after this handoff, including unrelated jobs. Default false (enqueue only). A successful call does not verify that any render started or completed.", + "type": "boolean" } }, "required": [ - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/match_frame +++ observed/match_frame { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "track_index": { "description": "Track index (default: 0)", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/move_clip +++ observed/move_clip { "annotations": { "destructiveHint": false, - "description": "Move a clip to a new position on the timeline", + "description": "EXPERIMENTAL (undocumented QE DOM for track changes): Move a clip to a new position on the timeline; optional track moves use Premiere's QE API and may not work on every version.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "new_start_seconds": { "description": "New start time in seconds", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/move_clip_to_track +++ observed/move_clip_to_track { "annotations": { "destructiveHint": false, - "description": "Move a clip to a different track. Uses QE DOM.", + "description": "Move a clip to a different track of the same type, keeping its start, duration, and source in/out. EXPERIMENTAL: uses the undocumented QE DOM moveToTrack. Refuses without changing anything when the origin or destination track is locked or the destination range is occupied. Reads the timeline back: verified only when the clip is on the destination track with the same span and source range and is gone from the origin track; committed_unverified when the source range cannot be read; otherwise failure with Undo guidance.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "node_id": { "description": "Node ID of the clip", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/move_item_to_bin +++ observed/move_item_to_bin { "annotations": { "destructiveHint": false, - "description": "Move a project item to a different bin", + "description": "Move a project item to a different bin and confirm where it landed", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "item_id": { "description": "Node ID or name of the item to move", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/move_items_to_bin +++ observed/move_items_to_bin { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "item_ids": { "description": "Array of node IDs or names of items to move", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/move_playhead_to_edit +++ observed/move_playhead_to_edit { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "direction": { "description": "Direction (default: next)", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/multiple_undo +++ observed/multiple_undo { "annotations": { "destructiveHint": false, - "description": "Unavailable: Premiere exposes no supported, observable undo-stack API for multiple scripted undo steps.", + "description": "EXPERIMENTAL (undocumented QE DOM: qe.project.undo / undoStackIndex). Undo several Premiere project actions through QE, checking each step against Premiere's undo-stack position (stackVerified; the timeline itself is not read back) and reporting how many were undone. Only actions Premiere records are undoable: QE edits such as razor, insert, lift and extract report undoSteps (and undoStackIndex) in their results; pass that undoSteps as count to reverse exactly that call. A marker receipt with undoTracked:false recorded no undo step: calling Undo for it would reverse an earlier action. Only CEP tool results carry undoSteps; UXP tools and workflows that send several commands are not counted. Always pass expected_undo_stack_index to check the stack position, but matching position alone does not prove which action is on top. Observed marker boundaries refuse the entire request before any step unless acknowledge_untracked_markers:true explicitly permits prior non-marker actions. The barrier persists through server/helper reloads while the CEP engine remains alive; it cannot account for marker writes before observation, after an engine reset, or through UXP, the manual UI, or other clients. Matching the QE index verifies stack position only.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { + "acknowledge_untracked_markers": { + "description": "Explicitly acknowledge that QE steps reverse or restore prior non-marker actions, because marker reversal is not verified. Default false; marker boundaries refuse the entire request before any step.", + "type": "boolean" + }, "count": { "description": "Number of undo steps (default: 1)", "type": "number" + }, + "expected_undo_stack_index": { + "description": "Required safety guard: the undoStackIndex a tool result reported right after the call you want to reverse. The step is refused, with nothing changed, when Premiere's undo-stack position differs from it. The guard compares the position only; matching position cannot prove which action is on top.", + "type": "number" } }, + "required": [ + "expected_undo_stack_index" + ], "type": "object" }, "name": "multiple_undo", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/mute_track +++ observed/mute_track { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "muted": { "description": "True to mute, false to unmute", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
+ tool added: navigate_playhead
--- pinned/nest_clips +++ observed/nest_clips { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "name": { "description": "Name for the nested sequence", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/normalize_loudness_file +++ observed/normalize_loudness_file { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "input_path": { "description": "Existing local audio or video file", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/open_in_source +++ observed/open_in_source { "annotations": { "destructiveHint": false, - "description": "Open a project item in the Source Monitor for preview and trimming.", + "description": "Open a project item in the Source Monitor for preview and trimming, and confirm it is the clip now showing.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "item_id": { "description": "Node ID or name of the project item to open", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/open_project +++ observed/open_project { "annotations": { "destructiveHint": false, - "description": "Open a Premiere Pro project file", + "description": "Open a Premiere Pro project file and make it the active project, verifying it is open. Other open projects stay open.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "path": { "description": "Full file path to the .prproj file", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/overwrite_clip +++ observed/overwrite_clip { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "audio_track_index": { "description": "Audio track index (0-based, default: 0)", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/overwrite_from_source +++ observed/overwrite_from_source { "annotations": { "destructiveHint": false, - "description": "Overwrite the clip from the Source Monitor at the playhead position (overwrite edit — replaces existing clips).", + "description": "Overwrite the clip from the Source Monitor at the playhead position (overwrite edit — replaces existing clips) and verify a new placement on the requested tracks.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "audio_track_index": { "description": "Target audio track index (default: 0)", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
+ tool added: paste_clip_attributes
--- pinned/ping +++ observed/ping { "annotations": { "destructiveHint": false, - "properties": {}, "type": "object" }, "name": "ping", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
+ tool added: plan_active_speaker_reframe
+ tool added: plan_beat_montage
+ tool added: plan_chapter_markers
+ tool added: plan_client_notes_checklist
+ tool added: plan_cross_app_workflow
+ tool added: plan_emphasis_zoom_keyframes
+ tool added: plan_filler_word_removal
+ tool added: plan_multicam_angle_switches
+ tool added: plan_pause_tightening
+ tool added: plan_platform_delivery_matrix
+ tool added: plan_reaction_captions
+ tool added: plan_short_export_folder
+ tool added: plan_short_subscribe_cta
--- pinned/plan_shot_match +++ observed/plan_shot_match { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "reference_media_path": { "description": "Existing local reference video file", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/plan_silence_review_markers +++ observed/plan_silence_review_markers { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "max_candidates": { "description": "Maximum candidate ranges to return (default: 50, maximum: 200).", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
+ tool added: plan_speaker_checkerboard
+ tool added: plan_word_mute_ranges
--- pinned/play_source_monitor +++ observed/play_source_monitor { "annotations": { "destructiveHint": false, - "description": "Request playback of the clip in the Source Monitor. The legacy API does not provide a same-call position readback, so movement is not reported as verified.", + "description": "Request playback of the clip in the Source Monitor. Fails when no clip is loaded. The legacy API does not provide a same-call position readback, so movement is not reported as verified.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "speed": { "description": "Playback speed (1.0 = normal, 2.0 = 2x, -1.0 = reverse). Default: 1.0", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/play_timeline +++ observed/play_timeline { "annotations": { "destructiveHint": false, - "properties": {}, "type": "object" }, "name": "play_timeline", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
+ tool added: preview_after_effects_render
+ tool added: preview_after_effects_render_handoff
--- pinned/preview_brand_spot +++ observed/preview_brand_spot { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "approved_workspace_path": { "description": "Operator-approved root containing mogrt_path; required whenever mogrt_path is supplied.", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/preview_edit_plan +++ observed/preview_edit_plan { "annotations": { "destructiveHint": false, - "description": "Validate and preview a compound timeline edit without changing Premiere. Returns a confirmation token required by apply_edit_plan.", + "description": "Inspect sequence, project item, clip and requested track targets before previewing a compound timeline edit without changing Premiere. Returns a single-use confirmation token bound to stable project, sequence and target identities; it expires after 30 minutes and is required by apply_edit_plan.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "plan": { - "additionalProperties": {}, - "description": "An edit plan containing insert_clip and remove_clip operations (maximum 100)", - "propertyNames": { - "type": "string" + "description": "An edit plan: { sequence_id?, operations: [...] } with up to 100 insert_clip and remove_clip operations. Operations run in order, and each one's times refer to the timeline as the operations before it left it.", + "properties": { + "operations": { + "items": { + "properties": { + "allow_large_ripple": { + "description": "ripple remove_clip: allow execution above large_ripple_threshold after the read-only mover estimate", + "type": "boolean" + }, + "audio_track_index": { + "description": "insert_clip: audio track (default 0)", + "minimum": 0, + "type": "integer" + }, + "include_linked": { + "description": "remove_clip without ripple: also remove linked audio/video partners (default true)", + "type": "boolean" + }, + "item_id": { + "description": "insert_clip: project item node ID or name", + "type": "string" + }, + "large_ripple_threshold": { + "description": "ripple remove_clip: refuse above this mover count unless allow_large_ripple is true (default 400)", + "maximum": 5000, + "minimum": 1, + "type": "integer" + }, + "node_id": { + "description": "remove_clip: timeline clip node ID", + "type": "string" + }, + "ripple": { + "description": "remove_clip: close the gap with a verified sync-locked ripple delete (always takes linked partners)", + "type": "boolean" + }, + "start_seconds": { + "description": "insert_clip: timeline insert time in seconds (insert edit, sync-locked tracks shift)", + "minimum": 0, + "type": "number" + }, + "type": { + "enum": [ + "insert_clip", + "remove_clip" + ], + "type": "string" + }, + "video_track_index": { + "description": "insert_clip: video track (default 0)", + "minimum": 0, + "type": "integer" + } + }, + "required": [ + "type" + ], + "type": "object" + }, + "maxItems": 100, + "minItems": 1, + "type": "array" + }, + "sequence_id": { + "description": "Sequence name or ID to edit (activated first); defaults to the active sequence", + "type": "string" + } }, + "required": [ + "operations" + ], "type": "object" } }, - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/preview_editorial_plan +++ observed/preview_editorial_plan { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "plan": { - "additionalProperties": {}, "description": "Unchanged plan returned by create_editorial_plan from this running server instance.", - "propertyNames": { - "type": "string" - }, "type": "object" } }, - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
+ tool added: preview_mogrt_batch
+ tool added: preview_mogrt_library_publish
+ tool added: preview_mogrt_premiere_handoff
+ tool added: preview_mogrt_recipe
--- pinned/preview_motion_graphics_demo +++ observed/preview_motion_graphics_demo { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "asset_item_ids": { "description": "Exact existing project-item node IDs in playback order; external media paths are deliberately not imported by this workflow.", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/preview_product_spot +++ observed/preview_product_spot { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "asset_item_ids": { "description": "Exact existing project-item node IDs in playback order; external media paths are deliberately not imported by this workflow.", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/preview_project_intake +++ observed/preview_project_intake { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "include_paths": { "description": "Include observed media paths in findings. Defaults to false; hashes are returned instead.", - "additionalProperties": {}, "description": "Versioned facility policy. Unknown fields and unsafe matching expressions are rejected by the intake engine.", - "propertyNames": { - "type": "string" - }, "type": "object" } }, - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
+ tool added: preview_watched_media_import
+ tool added: preview_workflow_recipe
+ tool added: publish_mogrt_to_library
+ tool added: rank_short_form_candidates
--- pinned/razor_all_tracks +++ observed/razor_all_tracks { "annotations": { "destructiveHint": false, - "description": "Razor (split) all clips at the playhead position across all tracks, or at a specific time.", + "description": "Razor (split) all clips at the playhead position across all tracks, or at a specific time. A read-only preflight counts eligible track cuts; the host wait scales by that count (400 ms per cut plus 30 seconds headroom, capped at 15 minutes).", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "time_seconds": { "description": "Time to razor at in seconds (uses playhead position if omitted)", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/read_sequence_captions +++ observed/read_sequence_captions { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "sequence_id": { "description": "Sequence ID or name. Defaults to the active sequence.", + "maxLength": 512, + "minLength": 1, "type": "string" } }, - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/read_video_scopes +++ observed/read_video_scopes { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "media_path": { "description": "Existing local video file", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/redo +++ observed/redo { "annotations": { "destructiveHint": false, - "description": "Redo the last undone action in Premiere Pro.", + "description": "EXPERIMENTAL (undocumented QE DOM: qe.project.redo / undoStackIndex). Redo the most recently undone Premiere project action(s) through QE, checked step by step against Premiere's undo-stack position (stackVerified; the timeline itself is not read back). To restore a tool call undone with undo, pass the same count. Observed marker boundaries refuse before any step; acknowledge_untracked_markers:true permits prior non-marker actions, without proving marker reversal.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", - "properties": {}, + "additionalProperties": false, + "properties": { + "acknowledge_untracked_markers": { + "description": "Explicitly acknowledge that QE steps reverse or restore prior non-marker actions, because marker reversal is not verified. Default false; marker boundaries refuse the entire request before any step.", + "type": "boolean" + }, + "count": { + "description": "Number of redo steps (default: 1)", + "type": "number" + }, + "expected_undo_stack_index": { + "description": "Required safety guard: the undoStackIndexAfter reported by the undo you want to redo. The step is refused, with nothing changed, when Premiere's undo-stack position differs from it. The guard compares the position only; matching position cannot prove which action is on top.", + "type": "number" + } + }, + "required": [ + "expected_undo_stack_index" + ], "type": "object" }, "name": "redo", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/refresh_media +++ observed/refresh_media { "annotations": { "destructiveHint": false, - "description": "Refresh a project item to pick up changes to the source file", + "description": "Refresh a project item to pick up changes to the source file. The interpreted frame rate is read before and after; if the refresh leaves an implausible rate (seen on stills, e.g. 29.97 becoming 2.75e-8), the previous rate is restored and read back. Reports frameRateBefore, frameRateAfter and repaired.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "item_id": { "description": "Node ID or name of the item to refresh", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/relink_media +++ observed/relink_media { "annotations": { "destructiveHint": false, - "description": "Relink an offline media item to a new file path", + "description": "Legacy CEP relink can block Premiere indefinitely, even for an existing file on Premiere 26.5.2. Prefer relink_offline_media_uxp, which checks capability and reads the result back. This CEP route refuses by default; allow_unsafe_cep_relink must be explicitly true to attempt it, and its result is never reported as verified.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { + "allow_unsafe_cep_relink": { + "description": "Explicitly permit the legacy CEP changeMediaPath call. It can wedge Premiere even when the target file exists; prefer relink_offline_media_uxp.", + "type": "boolean" + }, "item_id": { "description": "Node ID or name of the item to relink", "type": "string" - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/remove_all_effects +++ observed/remove_all_effects { "annotations": { "destructiveHint": true, - "description": "Remove ALL effects from a clip. Uses QE DOM.", + "description": "Remove every effect from a clip, keeping its built-in components (Opacity, Motion, Volume, Channel Volume, Panner), and verify the result. EXPERIMENTAL: when Premiere has no Component.remove() (25.2), it removes through the undocumented QE DOM's targeted qeClip.getComponentAt(i).remove(). Every matching component's removal path is checked before any is removed; it returns a capability error, with nothing changed, when neither path is available.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "node_id": { "description": "Node ID of the clip", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/remove_effect +++ observed/remove_effect { "annotations": { "destructiveHint": true, - "description": "Remove an effect from a clip by its index or name. Returns a capability error when the host cannot remove an individual component.", + "description": "Remove one effect from a clip by its index or name (the last instance when names repeat) and verify the clip's components afterwards. Built-in components (Opacity, Motion, Volume, Channel Volume, Panner) cannot be removed. EXPERIMENTAL: when Premiere has no Component.remove() (25.2), it removes through the undocumented QE DOM's targeted qeClip.getComponentAt(i).remove(). Every matching component's removal path is checked before any is removed; it returns a capability error, with nothing changed, when neither path is available.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "effect_index": { "description": "Index of the effect to remove (0-based). Use get_clip_properties to see effects list.", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/remove_effect_by_name +++ observed/remove_effect_by_name { "annotations": { "destructiveHint": true, - "description": "Remove all instances of a specific effect from a clip by display name. Returns a capability error when the host cannot remove individual components.", + "description": "Remove all instances of a specific effect from a clip by display name and verify the clip's components afterwards. EXPERIMENTAL: when Premiere has no Component.remove() (25.2), it removes through the undocumented QE DOM's targeted qeClip.getComponentAt(i).remove(). Every matching component's removal path is checked before any is removed; it returns a capability error, with nothing changed, when neither path is available.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "effect_name": { "description": "Display name of the effect to remove", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/remove_from_timeline +++ observed/remove_from_timeline { "annotations": { "destructiveHint": true, - "description": "Remove a clip from the timeline", + "description": "Remove a clip from the timeline. By default its linked audio/video partners go with it, as with Premiere's Clear on a linked clip. With ripple: true the gap is closed through the same explicit, verified ripple delete as ripple_delete (Premiere's own ripple flag does nothing on current builds), shifting sync-locked tracks so audio stays in sync.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { + "allow_large_ripple": { + "description": "Allow a ripple above large_ripple_threshold after its read-only mover estimate.", + "type": "boolean" + }, + "include_linked": { + "description": "Also remove the clip's linked audio/video partners (default: true). A ripple removal always includes them, since closing the gap on one side only would desync the timeline.", + "type": "boolean" + }, + "large_ripple_threshold": { + "description": "Mover count above which ripple removal refuses unless allow_large_ripple is true (default: 400).", + "maximum": 5000, + "minimum": 1, + "type": "integer" + }, "node_id": { "description": "Node ID of the clip to remove", "type": "string" - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/remove_keyframe +++ observed/remove_keyframe { "annotations": { "destructiveHint": true, - "description": "Remove a keyframe at a specific time from an effect property", + "description": "Remove the keyframe at a time from an effect property and read the remaining keys back. Refuses, changing nothing, when no key is within 0.01s of that time.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "effect_name": { "description": "Display name of the effect", - "description": "Time in seconds of the keyframe to remove", + "description": "Seconds from the clip's start on the timeline (0 is the clip's first frame) of the keyframe to remove", "type": "number" } }, - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/remove_keyframe_range +++ observed/remove_keyframe_range { "annotations": { "destructiveHint": true, - "description": "Remove all keyframes in a time range from an effect property", + "description": "Remove every keyframe in a time range (inclusive) from an effect property and read the remaining keys back. Refuses, changing nothing, when the range holds no key.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "effect_name": { "description": "Display name of the effect", - "description": "End of the range in seconds", + "description": "End of the range, in seconds from the clip's start; must not be before start_seconds", "type": "number" }, "node_id": { - "description": "Start of the range in seconds", + "description": "Start of the range: seconds from the clip's start on the timeline (0 is the clip's first frame)", "type": "number" } }, - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/remove_selected_clips +++ observed/remove_selected_clips { "annotations": { "destructiveHint": true, + "additionalProperties": false, "properties": { "ripple": { "description": "If true, close the gap after removing (ripple delete). Default: false", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/rename_bin +++ observed/rename_bin { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "bin_id": { "description": "Name or node ID of the bin to rename", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/rename_clip +++ observed/rename_clip { "annotations": { "destructiveHint": false, - "description": "Rename a clip on the timeline. Uses QE DOM.", + "description": "Rename a clip on the timeline and verify the new name.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "new_name": { "description": "New name for the clip", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/rename_project_item +++ observed/rename_project_item { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "item_id": { "description": "Node ID or name of the project item", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/rename_track +++ observed/rename_track { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "name": { "description": "New track name", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/replace_clip +++ observed/replace_clip { "annotations": { "destructiveHint": false, - "description": "Replace a clip on the timeline with a different project item, preserving position and duration", + "description": "Replace one timeline clip with a different project item on the same track, keeping the exact timeline start and end. The replacement plays from its own In mark for the original clip's duration; neighbouring clips do not ripple, and a linked partner clip on another track is left in place. Refuses without changing anything when the track is locked. Reads the track back: verified when the new clip covers the same span, committed_unverified when the span holds but the source In point cannot be confirmed, otherwise failure with Undo guidance.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "new_item_id": { "description": "Node ID or name of the new project item to replace with", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/replace_clip_media +++ observed/replace_clip_media { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "clip_node_id": { "description": "Node ID of the timeline clip to replace media on", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/reverse_clip +++ observed/reverse_clip { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "node_id": { "description": "Node ID of the clip", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/ripple_delete +++ observed/ripple_delete { "annotations": { "destructiveHint": true, - "description": "Ripple delete a clip (removes clip and closes the gap). Uses QE DOM.", + "description": "Remove a clip and close the gap it leaves, shifting later clips earlier on the clip's own track and on every sync-locked track so audio stays in sync. With the default scope the clip's linked audio/video partners are removed with it and their tracks close up too, even when not sync-locked; with scope 'own_track' the partners stay in place (reported as linkedPartnersKept). Premiere's QE rippleDelete() and the DOM's rippleEdit flag are both non-functional on 26.x, so this is done explicitly and verified. Refuses without changing anything if a clip on a participating track straddles the ripple point or sits inside the range being closed.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { + "allow_large_ripple": { + "description": "Allow a ripple above large_ripple_threshold after its preflight estimate.", + "type": "boolean" + }, + "dry_run": { + "description": "Validate and report the shift plan without changing the timeline (default: false)", + "type": "boolean" + }, + "large_ripple_threshold": { + "description": "Mover count above which ripple_delete refuses unless allow_large_ripple is true (default: 400).", + "maximum": 5000, + "minimum": 1, + "type": "integer" + }, "node_id": { "description": "Node ID of the clip to ripple delete", "type": "string" + }, + "range_content": { + "description": "What to do about other clips on participating tracks that sit entirely inside the time range being closed (the usual case in a multicam-style sequence with aligned clips). With scope 'sync_locked' the clip's own linked audio/video partners are always removed with it, as in Premiere; with 'own_track' they are kept. 'refuse' (default) changes nothing and reports them; 'delete' also removes them, i.e. lifts that whole time segment out of every participating track and closes up. 'delete' is destructive across tracks -- the removed clips are listed in the result.", + "enum": [ + "refuse", + "delete" + ], + "type": "string" + }, + "scope": { + "description": "Which tracks shift: 'sync_locked' (default) shifts the clip's track plus every sync-locked track, matching Premiere's ripple behaviour; 'own_track' shifts only the clip's own track and WILL desync other tracks.", + "enum": [ + "sync_locked", + "own_track" + ], + "type": "string" } }, "required": [ - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/roll_edit +++ observed/roll_edit { "annotations": { "destructiveHint": false, - "description": "Perform a verified roll edit at the outgoing cut of a clip using the public timeline DOM.", + "description": "Perform a verified roll edit at the outgoing cut of a clip using the public timeline DOM, moving both visible edges and their source in/out points and verifying all four. Linked audio/video partners get the same edit by default (include_linked); every clip is checked before any is changed. Requires readable finite media and ffprobe duration evidence for every edited source; refuses unknown duration, stills, and nonunit/reversed speed before mutation.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { + "include_linked": { + "description": "Also apply the edit to the clip's linked audio/video partners so picture and sound stay in sync (default: true).", + "type": "boolean" + }, "node_id": { "description": "Node ID of the clip", "type": "string" - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/save_project +++ observed/save_project { "annotations": { "destructiveHint": false, - "description": "Save the current Premiere Pro project", + "description": "Save the current Premiere Pro project to its existing path. Fails when the project has never been saved (use save_project_as) or when Premiere writes no non-empty file. Fresh disk metadata verifies a save; unchanged or unreadable metadata reports committed_unverified.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", - "properties": {}, "type": "object" }, "name": "save_project", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/save_project_as +++ observed/save_project_as { "annotations": { "destructiveHint": false, - "description": "Save the current project to a new location", + "description": "Save the current project to a new .prproj path. Premiere then has the NEW copy open and closes the original, so later edits go to the copy; the result reports both paths. Fails when Premiere writes no file or leaves a pre-existing path unchanged. Use open_project to return to the original.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "path": { "description": "Full file path to save the project to (e.g., '/Users/me/projects/MyProject.prproj')", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/scene_edit_detection +++ observed/scene_edit_detection { "annotations": { "destructiveHint": false, - "description": "Perform scene edit detection on the selected clips in the active sequence. Defaults to creating markers rather than cutting.", + "description": "Perform Premiere's scene edit detection on the selected clips in the active sequence (it analyses the footage and can take minutes on long clips). CreateMarkers (default) puts Segmentation markers on the selected clips' source project items (shared by every sequence that uses them), removes duplicates this run created (markers that were already there are never deleted), and reports each detected cut in source and timeline seconds; it is verified only when at least one new marker was added. ApplyCuts razors the selected clips and verifies the clip count grew. EXPERIMENTAL QE: CreateMarkers records an observed marker boundary for guarded Undo/Redo; crossing it is refused by default, and unreadable history records unknown protection. This boundary does not verify native marker reversal.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "action": { "description": "Create markers (default) or apply cuts to the selected clips", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/search_project_context +++ observed/search_project_context { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "kinds": { "description": "Optional context-kind filter", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/search_project_items +++ observed/search_project_items { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "color_label": { "description": "Filter by color label index (0-15)", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
+ tool added: search_workflow_recipes
--- pinned/select_all_clips +++ observed/select_all_clips { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "track_index": { "description": "Specific track index (optional, selects all tracks if omitted)", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/select_clips_by_color +++ observed/select_clips_by_color { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "color_index": { "description": "Label color index (0=Violet, 1=Iris, 2=Caribbean, 3=Lavender, 4=Cerulean, 5=Forest, 6=Rose, 7=Mango, 8=Purple, 9=Blue, 10=Teal, 11=Magenta, 12=Tan, 13=Green, 14=Brown, 15=Yellow)", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/select_clips_by_name +++ observed/select_clips_by_name { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "add_to_selection": { "description": "If true, add to existing selection instead of replacing it (default: false)", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
+ tool added: select_clips_by_pattern
--- pinned/select_clips_in_range +++ observed/select_clips_in_range { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "end_seconds": { "description": "End of selection range in seconds", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/select_disabled_clips +++ observed/select_disabled_clips { "annotations": { "destructiveHint": false, - "properties": {}, "type": "object" }, "name": "select_disabled_clips", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/select_item +++ observed/select_item { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "item_id": { "description": "Node ID or name of the project item to select", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/set_active_sequence +++ observed/set_active_sequence { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "sequence_id": { "description": "Sequence name or ID to make active", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/set_all_tracks_targeted +++ observed/set_all_tracks_targeted { "annotations": { "destructiveHint": false, - "description": "Set all tracks targeted or untargeted. Useful before insert/overwrite edits.", + "description": "Set all tracks targeted or untargeted. Useful before insert/overwrite edits. Reads back every affected track and reports verified only when all match the requested state.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "targeted": { "description": "Whether to target (true) or untarget (false) all tracks", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/set_anti_alias_quality +++ observed/set_anti_alias_quality { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "enabled": { "description": "Enable (true) or disable (false) anti-aliasing", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/set_blend_mode +++ observed/set_blend_mode { "annotations": { "destructiveHint": false, - "description": "Set the blend mode on a video clip. Uses the Opacity effect's Blend Mode property.", + "description": "Set a video clip's blend mode through its Opacity effect and read the stored mode back. Premiere stores the mode as an index into its modes in alphabetical order, with Subtract and Divide last (mapped on Premiere 25.2.3 by rendering every index over a known background).", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "blend_mode": { "description": "Blend mode name", - "Normal", - "Dissolve", - "Darken", - "Multiply", + "Color", "Color Burn", - "Linear Burn", + "Color Dodge", + "Darken", "Darker Color", + "Difference", + "Dissolve", + "Exclusion", + "Hard Light", + "Hard Mix", + "Hue", "Lighten", - "Screen", - "Color Dodge", - "Linear Dodge", "Lighter Color", + "Linear Burn", + "Linear Dodge", + "Linear Light", + "Luminosity", + "Multiply", + "Normal", "Overlay", + "Pin Light", + "Saturation", + "Screen", "Soft Light", - "Hard Light", "Vivid Light", - "Linear Light", - "Pin Light", - "Hard Mix", - "Difference", - "Exclusion", "Subtract", - "Divide", - "Hue", - "Saturation", - "Color", - "Luminosity" + "Divide" ], "type": "string" }, - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/set_clip_anchor_point +++ observed/set_clip_anchor_point { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "node_id": { "description": "Node ID of the clip", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
+ tool added: set_clip_duration
--- pinned/set_clip_opacity +++ observed/set_clip_opacity { "annotations": { "destructiveHint": false, - "description": "Set the opacity of a video clip (0-100).", + "description": "Set the opacity of a video clip (0-100) using English or measured Spanish built-in names, then read it back.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "node_id": { "description": "Node ID of the clip", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/set_clip_pan +++ observed/set_clip_pan { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "node_id": { "description": "Node ID of the audio clip", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/set_clip_position +++ observed/set_clip_position { "annotations": { "destructiveHint": false, - "description": "Set the Position property on a video clip's Motion effect. Values are in pixels.", + "description": "Set the Position property on a video clip's Motion effect using English or measured Spanish built-in names, then read it back. Values are in pixels.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "node_id": { "description": "Node ID of the clip", - "description": "X position in pixels", + "description": "X position in sequence pixels (converted to Premiere's normalized Position when the host stores it that way)", "type": "number" }, "y": { - "description": "Y position in pixels", + "description": "Y position in sequence pixels (converted to Premiere's normalized Position when the host stores it that way)", "type": "number" } }, - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/set_clip_properties +++ observed/set_clip_properties { "annotations": { "destructiveHint": false, - "description": "Set supported clip properties (opacity, scale, position, rotation). Clip speed is unsupported and fails before mutation.", + "description": "Set supported clip properties (opacity, scale, position, rotation) and read each requested value back. Clip speed is unsupported and fails before mutation; use set_clip_duration to change a clip's timeline length.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "node_id": { "description": "Node ID of the clip", + "maximum": 100, + "minimum": 0, "type": "number" }, "position_x": { - "description": "Horizontal position", + "description": "Horizontal position in sequence pixels", "type": "number" }, "position_y": { - "description": "Vertical position", + "description": "Vertical position in sequence pixels", "type": "number" }, "rotation": { - "description": "Scale percentage (100 = original size)", + "description": "Scale percentage (0-10000; 100 = original size)", + "maximum": 10000, + "minimum": 0, "type": "number" }, "speed": { - "description": "Unsupported by Premiere's public scripting APIs. Supplying this returns an actionable error without mutating the clip.", + "description": "Unsupported by Premiere's documented scripting APIs. Supplying this returns an actionable error without mutating the clip; use set_clip_duration to change timeline length.", "type": "number" } }, - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/set_clip_properties_batch +++ observed/set_clip_properties_batch { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "items": { "description": "Each item changes one or more supported opacity, Motion scale, position, or rotation values.", - "additionalProperties": {}, + "additionalProperties": false, "properties": { "node_id": { "description": "Timeline clip node ID.", + "maxLength": 512, + "minLength": 1, "type": "string" }, "opacity": { + "exclusiveMinimum": 0, "type": "number" }, "speed": { + "maxItems": 16, + "minItems": 1, "type": "array" } }, - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/set_clip_rotation +++ observed/set_clip_rotation { "annotations": { "destructiveHint": false, - "description": "Set the Rotation property on a video clip's Motion effect.", + "description": "Set the Rotation property on a video clip's Motion effect using English or measured Spanish built-in names, then read it back.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "degrees": { "description": "Rotation in degrees (0-360, can exceed for multiple rotations)", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/set_clip_scale +++ observed/set_clip_scale { "annotations": { "destructiveHint": false, - "description": "Set the Scale property on a video clip's Motion effect.", + "description": "Scale a video clip evenly through its Motion effect using English or measured Spanish built-in names, and read the result back. With Uniform Scale off, both Scale (height) and Scale Width are set, so the picture is not stretched; use set_scale_width_height for different values.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "node_id": { "description": "Node ID of the clip", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/set_clip_selection +++ observed/set_clip_selection { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "node_id": { "description": "Node ID of the clip", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/set_clip_speed_qe +++ observed/set_clip_speed_qe { "annotations": { "destructiveHint": false, - "description": "Unavailable: Premiere does not expose a supported scripting API for changing a timeline clip's speed.", + "description": "Unavailable: Premiere's documented ExtendScript and UXP APIs have no setter for a timeline clip's speed (only getters), and the undocumented QE setSpeed is deliberately not used. Always fails before mutation. To change how long a clip runs on the timeline, use set_clip_duration.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "node_id": { "description": "Node ID of the clip", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/set_clip_start_time +++ observed/set_clip_start_time { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "item_id": { "description": "Node ID or name of the project item", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/set_clip_volume +++ observed/set_clip_volume { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "node_id": { "description": "Node ID of the audio clip", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/set_clips_volume +++ observed/set_clips_volume { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "clip_indices": { "description": "Optional clip indices on that track. Omit to apply to all clips.", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/set_color_label +++ observed/set_color_label { "annotations": { "destructiveHint": false, - "description": "Set the color label on a project item or clip", + "description": "Set the color label on a project item or clip and read it back", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "color_index": { "description": "Label color index (0=Violet, 1=Iris, 2=Caribbean, 3=Lavender, 4=Cerulean, 5=Forest, 6=Rose, 7=Mango, 8=Purple, 9=Blue, 10=Teal, 11=Magenta, 12=Tan, 13=Green, 14=Brown, 15=Yellow)", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/set_color_value +++ observed/set_color_value { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "alpha": { "description": "Alpha (0-255)", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/set_effect_property +++ observed/set_effect_property { "annotations": { "destructiveHint": false, - "description": "Set the value of a specific effect property on a clip", + "description": "Set the value of a specific effect property on a clip. Accepts scalar, boolean, string, array-shaped vector values (for example Motion > Position as [x, y]), and MOGRT JSON objects or strings, and verifies the readback component by component.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "effect_name": { "description": "Display name of the effect (e.g., 'Motion', 'Opacity')", - "description": "Number or string value to set. Use the exact JSON string reported for a MOGRT text or graphic parameter." + "additionalProperties": true, + "description": "Value to set. Use a number for scalar properties, an array of numbers for vector properties such as Motion > Position or Anchor Point ([x, y]), a boolean for checkbox properties, the exact JSON string reported for a MOGRT text or graphic parameter, or that same JSON object if the client parsed it.", + "items": { + "type": "number" + }, + "maxItems": 4, + "maxLength": 8192, + "minItems": 1, + "type": [ + "number", + "string", + "boolean", + "array", + "object" + ] } }, "required": [ - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/set_footage_interpretation +++ observed/set_footage_interpretation { "annotations": { "destructiveHint": false, - "description": "Set footage interpretation settings for a project item", + "description": "Set footage interpretation settings for a project item and read them back, including fields that were not meant to change", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "frame_rate": { "description": "Override frame rate", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/set_frame_blend +++ observed/set_frame_blend { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "enabled": { "description": "True to enable frame blending, false to disable", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/set_graphics_white_luminance +++ observed/set_graphics_white_luminance { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "luminance": { "description": "White luminance value in nits", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/set_item_in_out +++ observed/set_item_in_out { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "in_seconds": { "description": "In point in seconds", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/set_keyframe_interpolation +++ observed/set_keyframe_interpolation { "annotations": { "destructiveHint": false, - "description": "Set the interpolation type of a keyframe (Linear, Hold, or Bezier)", + "description": "Set the interpolation type of an existing keyframe (Linear, Hold, or Bezier). Premiere exposes no interpolation readback, so a write is reported as committed_unverified. Stored curves do not establish rendering; A 26.5.2 Windows capture report shows identical modes; 25.2.3 macOS evidence distinguishes a QE still-capture artifact from correctly rendered video curves.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "effect_name": { "description": "Display name of the effect", - "description": "Time in seconds of the keyframe", + "description": "Seconds from the clip's start on the timeline (0 is the clip's first frame) of the keyframe", "type": "number" } }, - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/set_metadata +++ observed/set_metadata { "annotations": { "destructiveHint": false, - "description": "Replace project metadata XML on a project item and verify the exact readback. Partial field/value writes are intentionally rejected because Premiere requires a complete Project Metadata XML payload.", + "description": "Update project metadata on a project item. Supply complete metadata_xml plus updated_fields, or field_name and value to read-modify-write one XMP/project property through AdobeXMPScript with field readback. The project packet (default) stays in the project; packet 'xmp' is written by Premiere into the source media file on disk and requires the filesystem capability.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { + "expected_value": { + "description": "Optional compare-and-set guard for field_name writes.", + "type": "string" + }, "field_name": { - "description": "Legacy partial-write argument. It is no longer executed because it cannot form a valid Project Metadata XML payload; use metadata_xml and updated_fields instead.", + "description": "Named field to update (for example Column.Intrinsic.LogNote). Used with value; cannot be combined with metadata_xml.", "type": "string" }, + "field_namespace": { + "description": "XMP namespace URI or alias (premiere, dc, xmp, exif). Default premiere for project packet; required for xmp.", + "type": "string" + }, "item_id": { "description": "Node ID or name of the project item", "type": "string" + "packet": { + "description": "Packet for field_name writes. Default project (Premiere-private metadata).", + "enum": [ + "project", + "xmp" + ], + "type": "string" + }, "updated_fields": { "description": "Exact Project Metadata field paths changed in metadata_xml (for example, Column.Intrinsic.Description).", "items": { + "minItems": 1, "type": "array" }, "value": { - "description": "Legacy partial-write argument. It is no longer executed; read projectMetadata first, update the complete XML, then supply metadata_xml and updated_fields.", + "description": "Replacement value for field_name. Maximum 4096 characters.", "type": "string" } }, - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/set_offline +++ observed/set_offline { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "item_id": { "description": "Node ID or name of the project item", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/set_override_frame_rate +++ observed/set_override_frame_rate { "annotations": { "destructiveHint": false, - "description": "Override the frame rate of a project item (useful for image sequences or misinterpreted media)", + "description": "Override the frame rate of a project item (useful for image sequences or misinterpreted media) and read it back", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "frame_rate": { "description": "Frame rate to set (e.g., 23.976, 24, 29.97, 30, 60)", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/set_override_pixel_aspect_ratio +++ observed/set_override_pixel_aspect_ratio { "annotations": { "destructiveHint": false, - "description": "Override the pixel aspect ratio of a project item", + "description": "Override the pixel aspect ratio of a project item and read it back", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "denominator": { "description": "PAR denominator (e.g., 1 for square pixels)", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/set_playhead_position +++ observed/set_playhead_position { "annotations": { "destructiveHint": false, - "description": "Set the playhead (CTI) position in the active sequence", + "description": "Set the playhead (CTI) position, clamp it to the active sequence's end, and read the stored position back.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "time_seconds": { - "description": "Time position in seconds to move the playhead to", + "description": "Time position in seconds to move the playhead to (0 to the sequence end)", "type": "number" } }, - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/set_poster_frame +++ observed/set_poster_frame { "annotations": { "destructiveHint": false, - "description": "Set the poster frame (thumbnail) for a project item at a specific time.", + "description": "Unavailable: Premiere's scripting API cannot set a project item's poster frame. Fails without changing the item; set it in the Project panel (Shift+P).", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "item_id": { "description": "Node ID or name of the project item", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/set_project_item_audio_channel_mapping +++ observed/set_project_item_audio_channel_mapping { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "channel_index": { "description": "Zero-based output channel index to configure", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/set_project_panel_metadata +++ observed/set_project_panel_metadata { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "metadata_xml": { "description": "XML string containing the project panel metadata configuration", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/set_project_scratch_disk +++ observed/set_project_scratch_disk { "annotations": { "destructiveHint": false, - "description": "Set the project's scratch disk paths for captured video, audio, and previews.", + "description": "Set the project's scratch disks for captured video, captured audio, video previews and audio previews in one call. Each path must be an existing folder or \"SameAsProject\"; any rejected path fails the call.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "audio_previews": { "description": "Path for audio previews", + "save_and_verify": { + "description": "Save the project afterwards and confirm the saved scratch-disk settings (default: false). Premiere has no scratch-disk getter, so without this the result is unverified.", + "type": "boolean" + }, "video_previews": { "description": "Path for video previews", "type": "string" - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/set_scale_to_frame_size +++ observed/set_scale_to_frame_size { "annotations": { "destructiveHint": false, - "description": "Enable 'Scale to Frame Size' on a project item so it fills the sequence frame", + "description": "Enable 'Scale to Frame Size' so media fills the sequence frame. Accepts a timeline clip node ID (active sequence, same IDs as get_clip_properties) or a project item node ID or name. A timeline clip is resolved first and its source project item is updated through ProjectItem.setScaleToFrameSize(). ExtendScript exposes no getter for this flag, so the result is committed_unverified unless the timeline clip's Motion > Scale reads back changed (verified). Check with get_clip_properties.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "item_id": { - "description": "Node ID or name of the project item", + "description": "Timeline clip node ID in the active sequence, or project item node ID or name", "type": "string" } }, - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/set_scale_width_height +++ observed/set_scale_width_height { "annotations": { "destructiveHint": false, - "description": "Set independent Scale Width and Scale Height on a clip (requires Uniform Scale to be OFF).", + "description": "Set independent width and height scale on a clip. Turns Uniform Scale off, writes Motion > Scale Width (width) and Motion > Scale (which Premiere uses as the height once Uniform Scale is off), then reads all three back. Fails when a value does not read back.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "node_id": { "description": "Node ID of the clip", - "description": "Scale height percentage", + "description": "Scale height percentage (0-10000). Written to Motion > Scale, which is the height when Uniform Scale is off.", "type": "number" }, "scale_width": { - "description": "Scale width percentage", + "description": "Scale width percentage (0-10000)", "type": "number" } }, - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/set_scratch_disk_path +++ observed/set_scratch_disk_path { "annotations": { "destructiveHint": false, - "description": "Set the scratch disk path for a specific media type", + "description": "Set one project scratch disk (captured media, previews, auto-save, CC Libraries or Motion Graphics template media) to an existing folder or \"SameAsProject\", using Premiere's ScratchDiskType constants.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "path": { - "description": "Full directory path for the scratch disk", + "description": "Absolute path of an existing folder, or \"SameAsProject\"", "type": "string" }, + "save_and_verify": { + "description": "Save the project afterwards and confirm the saved scratch-disk settings (default: false). Premiere has no scratch-disk getter, so without this the result is unverified.", + "type": "boolean" + }, "scratch_disk_type": { - "description": "Type: 'capturedVideo', 'capturedAudio', 'videoPreview', 'audioPreview', 'autoSave', 'ccLibraries'", + "description": "Which scratch disk to set", + "enum": [ + "capturedVideo", + "capturedAudio", + "videoPreview", + "audioPreview", + "autoSave", + "ccLibraries", + "motionGraphicsTemplateMedia" + ], "type": "string" } }, - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/set_sequence_audio_settings +++ observed/set_sequence_audio_settings { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "channel_type": { "description": "Channel type: 0=Mono, 1=Stereo, 2=5.1, 3=Multichannel", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/set_sequence_display_format +++ observed/set_sequence_display_format { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "audio_display_format": { "description": "Audio: 0=Audio Samples, 1=Milliseconds", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/set_sequence_field_type +++ observed/set_sequence_field_type { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "field_type": { "description": "0=No Fields (Progressive), 1=Upper Field First, 2=Lower Field First", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/set_sequence_frame_rate +++ observed/set_sequence_frame_rate { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "frame_rate": { "description": "New frame rate (e.g., 23.976, 24, 25, 29.97, 30, 50, 59.94, 60)", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/set_sequence_in_out_points +++ observed/set_sequence_in_out_points { "annotations": { "destructiveHint": false, - "description": "Set the sequence in and out points (for export range, etc.)", + "description": "Set the sequence in and out points (for an export range, etc.) and read them back. out_seconds must be after in_seconds and not past the sequence end.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "in_seconds": { - "description": "In-point in seconds", + "description": "In-point in seconds (0 or later)", "type": "number" }, "out_seconds": { - "description": "Out-point in seconds", + "description": "Out-point in seconds; after in_seconds and not past the sequence end", "type": "number" } }, - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/set_sequence_pixel_aspect_ratio +++ observed/set_sequence_pixel_aspect_ratio { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "ratio": { "description": "Pixel aspect ratio string (for example '1.0' for square pixels or '1.4222' for 16:9 DV).", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/set_sequence_resolution +++ observed/set_sequence_resolution { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "height": { "description": "Height in pixels", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/set_sequence_settings +++ observed/set_sequence_settings { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "height": { "description": "Frame height in pixels", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/set_source_in_out +++ observed/set_source_in_out { "annotations": { "destructiveHint": false, + "additionalProperties": false, + "anyOf": [ + { + "required": [ + "in_seconds" + ] + }, + { + "required": [ + "out_seconds" + ] + } + ], "properties": { "in_seconds": { - "description": "In point in seconds (optional)", + "description": "In point in seconds. Provide this, out_seconds, or both.", + "minimum": 0, "type": "number" }, "out_seconds": { - "description": "Out point in seconds (optional)", + "description": "Out point in seconds. Provide this, in_seconds, or both.", + "minimum": 0, "type": "number" } }, - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/set_start_time +++ observed/set_start_time { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "item_id": { "description": "Node ID or name of the project item", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/set_target_track +++ observed/set_target_track { "annotations": { "destructiveHint": false, - "description": "Set a track as targeted (active for insert/overwrite edits). Only one video and one audio track can be targeted at a time.", + "description": "Target or untarget one video or audio track for source-patched insert/overwrite edits. Premiere allows several tracks of a type to be targeted at once, so by default (exclusive=true) targeting a track also untargets every other track of the same type. Reads back every track of that type and reports verified only when the readback matches the requested state; otherwise committed_unverified or an error.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { + "exclusive": { + "description": "When targeting (targeted=true), also untarget every other track of the same type so only this track is targeted (default: true). Ignored when targeted=false.", + "type": "boolean" + }, "targeted": { "description": "Whether to target (true) or untarget (false) the track", "type": "boolean" - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/set_time_interpolation +++ observed/set_time_interpolation { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "interpolation_type": { "description": "0 = Frame Sampling, 1 = Frame Blending, 2 = Optical Flow", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/set_transcode_on_ingest +++ observed/set_transcode_on_ingest { "annotations": { "destructiveHint": false, - "description": "Enable or disable transcoding on ingest for the project", + "description": "Request enabling or disabling project transcoding on ingest. Premiere exposes no getter for independent verification, so dispatch is reported as requested_unverified.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "enabled": { "description": "True to enable transcode on ingest, false to disable", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/set_uniform_scale +++ observed/set_uniform_scale { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "node_id": { "description": "Node ID of the clip", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/set_work_area +++ observed/set_work_area { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "in_seconds": { "description": "Work area in-point in seconds", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/set_workspace +++ observed/set_workspace { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "name": { "description": "Name of the workspace to activate (use get_workspaces to see available options)", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/set_xmp_metadata +++ observed/set_xmp_metadata { "annotations": { "destructiveHint": false, - "description": "Merge a raw XMP XML patch into a project item's existing XMP metadata without removing unrelated fields.", + "description": "Merge a raw XMP XML patch into a project item's existing XMP metadata without removing unrelated fields. WARNING: Premiere writes XMP into the source media file on disk (the file's metadata block and modification time change; picture and sound are untouched). Requires the filesystem capability.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "item_id": { "description": "Node ID or name of the project item", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/set_zero_point +++ observed/set_zero_point { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "sequence_id": { "description": "Sequence name or ID. Uses active sequence if omitted.", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/setup_ducking +++ observed/setup_ducking { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "base_db": { - "description": "Normal clip level in dB (defaults to 0).", + "description": "Normal clip level in dB (defaults to 0; maximum +15 dB).", "type": "number" }, "ducking_windows": { - "additionalProperties": {}, + "additionalProperties": false, "properties": { "ducked_db": { - "description": "Level during the window, in dB.", + "description": "Level during the window, in dB (maximum +15 dB).", "type": "number" }, "end_seconds": { + "maxItems": 32, + "minItems": 0, "type": "array" }, "fade_seconds": { + "exclusiveMinimum": 0, "type": "number" }, "node_id": { + "maxLength": 512, + "minLength": 1, "type": "string" } }, - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/slide_edit +++ observed/slide_edit { "annotations": { "destructiveHint": false, - "description": "Perform a verified slide edit on a clip using adjacent clips from the public timeline DOM.", + "description": "Perform a verified slide edit on a clip using adjacent clips from the public timeline DOM. Linked audio/video partners get the same edit by default (include_linked); every clip is checked before any is changed. Requires readable finite media and ffprobe duration evidence for every edited source; refuses unknown duration, stills, and nonunit/reversed speed before mutation.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { + "include_linked": { + "description": "Also apply the edit to the clip's linked audio/video partners so picture and sound stay in sync (default: true).", + "type": "boolean" + }, "node_id": { "description": "Node ID of the clip", "type": "string" - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/slip_edit +++ observed/slip_edit { "annotations": { "destructiveHint": false, - "description": "Perform a verified slip edit on a clip using public source in/out properties.", + "description": "Perform a verified slip edit on a clip using public source in/out properties. Requires accessible physical media duration from ffprobe; unknown duration or linked partners using different source files refuse before mutation. Linked audio/video partners get the same edit by default (include_linked); every clip is checked before any is changed.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { + "include_linked": { + "description": "Also apply the edit to the clip's linked audio/video partners so picture and sound stay in sync (default: true).", + "type": "boolean" + }, "node_id": { "description": "Node ID of the clip", "type": "string" - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/speed_change +++ observed/speed_change { "annotations": { "destructiveHint": false, - "description": "Unavailable: Premiere does not expose a supported scripting API for changing a timeline clip's speed.", + "description": "Unavailable: Premiere's documented ExtendScript and UXP APIs have no setter for a timeline clip's speed (only getters), and the undocumented QE setSpeed is deliberately not used. Always fails before mutation. To change how long a clip runs on the timeline, use set_clip_duration.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "node_id": { "description": "Node ID of the clip", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/split_clip +++ observed/split_clip { "annotations": { "destructiveHint": false, - "description": "Split every clip on one track that spans a timeline time, then verify both resulting boundaries. Requires QE DOM; effect-keyframe redistribution remains unverified.", + "description": "EXPERIMENTAL (undocumented QE DOM): Split every clip on one track that spans a timeline time, then verify both resulting boundaries. Effect-keyframe redistribution remains unverified.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "time_seconds": { "description": "Timeline time in seconds where clips on the selected track will split", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/stabilize_clip +++ observed/stabilize_clip { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "method": { "description": "Stabilization method (default: 'Subspace Warp')", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/start_batch_encode +++ observed/start_batch_encode { "annotations": { "destructiveHint": false, - "properties": {}, "type": "object" }, "name": "start_batch_encode", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/stop_playback +++ observed/stop_playback { "annotations": { "destructiveHint": false, - "description": "Request that active-sequence timeline playback stop through QE. The legacy API does not provide a same-call playhead readback, so stopped state is not reported as verified.", + "description": "Request that active-sequence timeline playback stop through QE. The legacy API does not provide a same-call playhead readback, so stopped state is not reported as verified. Only the timeline can be stopped: Premiere's scripting APIs have no documented call that stops the Source Monitor alone, so target \"source\" returns an error instead of stopping the timeline.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", - "properties": {}, + "additionalProperties": false, + "properties": { + "target": { + "description": "What to stop. Default \"timeline\". \"source\" is refused because no documented API stops only the Source Monitor.", + "enum": [ + "timeline", + "source" + ], + "type": "string" + } + }, "type": "object" }, "name": "stop_playback", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/toggle_track_visibility +++ observed/toggle_track_visibility { "annotations": { "destructiveHint": false, - "description": "Toggle a video track's visibility (eye icon)", + "description": "Set video track visibility using Premiere's track mute state (eye icon) and read the mute state back. Premiere's scripting API exposes mute, not a separate video visibility setter.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "track_index": { "description": "Video track index (0-based)", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/trim_clip +++ observed/trim_clip { "annotations": { "destructiveHint": false, - "description": "Trim exactly one source in/out point and verify the corresponding visible timeline edge. Refuses retimed clips and, by default, trims that would leave effect keyframes outside the visible clip.", + "description": "Trim exactly one source in/out point and verify the corresponding visible timeline edge. Requires accessible physical media duration from ffprobe; unknown duration or linked partners using different source files refuse before mutation. Refuses retimed clips, extensions that would overlap the neighbouring clip on the same track, and, by default, trims that would leave effect keyframes outside the visible clip. Linked audio/video partners get the same trim by default (include_linked), applied as the same offset from each partner's own source point so a J/L cut or slipped audio stays in sync; every clip is checked before any is changed. To set a clip's timeline length or extend a still image, use set_clip_duration.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { + "include_linked": { + "description": "Also apply the edit to the clip's linked audio/video partners, as Premiere does with linked selection (default: true).", + "type": "boolean" + }, "keyframe_policy": { "description": "How to handle effect keyframes beyond the trimmed visible range: reject (default) leaves the timeline unchanged; preserve explicitly keeps them and reports their count.", "enum": [ - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/undo +++ observed/undo { "annotations": { "destructiveHint": false, - "description": "Undo the last action in Premiere Pro", + "description": "EXPERIMENTAL (undocumented QE DOM: qe.project.undo / undoStackIndex). Undo the most recent Premiere project action(s) through QE, checked step by step against Premiere's undo-stack position (stackVerified; the timeline itself is not read back). Undo history is project-wide. Only actions Premiere records are undoable: QE edits such as razor, insert, lift and extract report undoSteps (and undoStackIndex) in their results; pass that undoSteps as count to reverse exactly that call. A marker receipt with undoTracked:false recorded no undo step: calling Undo for it would reverse an earlier action. Only CEP tool results carry undoSteps; UXP tools and workflows that send several commands are not counted. Always pass expected_undo_stack_index to check the stack position, but matching position alone does not prove which action is on top. Observed marker boundaries refuse the entire request before any step unless acknowledge_untracked_markers:true explicitly permits prior non-marker actions. The barrier persists through server/helper reloads while the CEP engine remains alive; it cannot account for marker writes before observation, after an engine reset, or through UXP, the manual UI, or other clients. Matching the QE index verifies stack position only.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { + "acknowledge_untracked_markers": { + "description": "Explicitly acknowledge that QE steps reverse or restore prior non-marker actions, because marker reversal is not verified. Default false; marker boundaries refuse the entire request before any step.", + "type": "boolean" + }, "count": { "description": "Number of times to undo (default: 1)", "type": "number" + }, + "expected_undo_stack_index": { + "description": "Required safety guard: the undoStackIndex a tool result reported right after the call you want to reverse. The step is refused, with nothing changed, when Premiere's undo-stack position differs from it. The guard compares the position only; matching position cannot prove which action is on top.", + "type": "number" } }, + "required": [ + "expected_undo_stack_index" + ], "type": "object" }, "name": "undo", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/unlink_selection +++ observed/unlink_selection { "annotations": { "destructiveHint": false, - "properties": {}, "type": "object" }, "name": "unlink_selection", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/unnest_sequence +++ observed/unnest_sequence { "annotations": { "destructiveHint": false, - "description": "Unnest a nested sequence on the timeline, replacing it with the contents of the nested sequence", + "description": "Unnest a nested sequence clip, replacing it with the nested sequence's clips at their exact source in/out and timeline positions. Refuses without changing anything when the nest is trimmed, retimed, linked to a partner clip, or when the destination range is occupied or locked. Re-reads every placed clip and reports failure with Undo guidance if any start or source range differs. Nested clips are re-placed from their project items, so effects, keyframes, and transitions inside the nest are not carried over.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "node_id": { "description": "Node ID of the nested sequence clip on the timeline to unnest", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/update_marker +++ observed/update_marker { "annotations": { "destructiveHint": false, - "description": "Update an existing marker's properties", + "description": "Update the name, comments or color of the sequence marker at a time and read them back. EXPERIMENTAL (QE DOM): the receipt reports undoStackIndex movement, which does not prove QE can reverse the marker. Every marker attempt protects an engine undo boundary; undoTracked:false means the marker did not observably advance the QE index.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "color": { - "description": "New color index", + "description": "New color index (0=Green, 1=Red, 2=Purple, 3=Orange, 4=Yellow, 5=White, 6=Blue, 7=Cyan)", "type": "number" }, "comments": { - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/validate_cmx3600_edl +++ observed/validate_cmx3600_edl { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "frame_rate": { "description": "CMX timecode rate: 24, 25, 29.97, 30, 50, 59.94, or 60 (default: 24)", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/validate_export_preset +++ observed/validate_export_preset { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "preset_path": { "description": "Full path to an Adobe Media Encoder export preset (.epr)", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
+ tool added: validate_mogrt_brand_kit
+ tool added: validate_platform_publish_package
--- pinned/validate_project_for_export +++ observed/validate_project_for_export { "annotations": { "destructiveHint": false, - "description": "Run a non-mutating export readiness audit for an active or named sequence. It reports blocking offline media, empty timelines, inaccessible preset/output paths, duration, and optional timeline gaps without queuing an export.", + "description": "Run a non-mutating export preflight for an active or named sequence. It reports blocking offline media, empty timelines, inaccessible preset/output paths, duration, and optional timeline gaps without queuing an export. readyForExport means these preflight checks passed; it does not test exporter initialization, encoder availability, or whether the host can render. Require an actual output file from export_sequence and verify_delivery_file before claiming delivery.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "check_gaps": { "description": "Report gaps on populated tracks as warnings (defaults to true).", + "maxLength": 4096, + "minLength": 1, "type": "string" }, "preset_path": { + "maxLength": 4096, + "minLength": 1, "type": "string" }, "require_non_empty_timeline": { + "maxLength": 512, + "minLength": 1, "type": "string" } }, - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
+ tool added: verify_after_effects_connection
--- pinned/verify_delivery_conformance +++ observed/verify_delivery_conformance { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "allowed_container_names": { "description": "Allowed ffprobe demuxer-family aliases, such as mov or mp4. This cannot distinguish exact subtypes when ffprobe reports a shared alias family.", - "maximum": 9007199254740991, - "minimum": -9007199254740991, "type": "integer" }, "audio_codec": { - "maximum": 9007199254740991, - "minimum": -9007199254740991, "type": "integer" }, "duration_seconds": { - "maximum": 9007199254740991, - "minimum": -9007199254740991, "type": "integer" }, "loudness_tolerance_lu": { - "maximum": 9007199254740991, - "minimum": -9007199254740991, "type": "integer" } }, - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/verify_delivery_file +++ observed/verify_delivery_file { "annotations": { "destructiveHint": false, + "additionalProperties": false, "properties": { "checksum_algorithm": { "description": "Checksum algorithm (default: sha256)", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
--- pinned/verify_fcpxml_media_references +++ observed/verify_fcpxml_media_references { "annotations": { "destructiveHint": false, - "description": "Verify FCPXML file:// media references only inside caller-approved existing roots. References outside those roots are never statted or exposed as local paths.", + "description": "Verify the file:// media references of an FCPXML or FCP7 XML (xmeml) document, only inside caller-approved existing roots. References outside those roots are never statted or exposed as local paths.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, "properties": { "allowed_roots": { "description": "One to sixteen existing absolute roots that may be inspected", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
+ tool added: verify_mogrt_artifact
--- pinned/verify_premiere_connection +++ observed/verify_premiere_connection { "annotations": { "destructiveHint": false, - "idempotentHint": false, + "idempotentHint": true, "openWorldHint": false, - "readOnlyHint": false, + "readOnlyHint": true, "title": "Verify Premiere Connection" }, "description": "Run a safe, read-only first-run check. It proves that this MCP server, the selected Premiere bridge, an active project, and an active sequence are connected without returning project names, paths, or media details.", + "additionalProperties": false, "properties": { "backend": { "description": "Bridge to check. Defaults to CEP. This check never falls back to a different bridge.", - "description": "Tool-specific result data when ok is true." + "description": "Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it." }, "error": { "description": "Failure detail when ok is false.",
Current tools
Show all 432 tool fingerprints
acknowledge_operation_recovery
add_adjustment_layer
add_audio_keyframes
add_custom_metadata_field
add_keyframe
add_marker
add_marker_to_project_item
add_markers_batch
add_text_overlay
add_title
add_to_render_queue
add_to_timeline
add_to_timeline_batch
add_track
add_tracks
add_transition
add_transition_to_clip
adjust_audio_levels
analyze_dialogue_edit_candidates
analyze_loudness
analyze_video_interlacing
analyze_video_qc
apply_after_effects_render_handoff
apply_audio_effect
apply_edit_plan
apply_effect
apply_extended_edit_plan
apply_lut
apply_mogrt_premiere_handoff
apply_scene_review_workflow
apply_spot_workflow_plan
apply_stacked_camera_edit
attach_custom_property
audit_timeline_health
auto_reframe_sequence
batch_add_transitions
batch_apply_effect
batch_enable_disable
batch_rename_clips
bind_media_provenance
build_caption_artifact
build_edit_review_evidence
build_project_handoff_manifest
can_execute
cancel_workflow_job
capture_frame
check_caption_safe_zone
check_offline_media
clear_item_in_out
clear_sequence_in_out
close_all_source_clips
close_project
close_sequence
close_source_monitor
color_correct
compare_cmx3600_edls
compute_mask_fit_motion
consolidate_and_transfer
consolidate_duplicates
convert_timeline_time
copy_effect_values
copy_effects_between_clips
create_bars_and_tone
create_bin
create_caption_track
create_context_edit_plan
create_editorial_context_pack
create_editorial_plan
create_mogrt_batch
create_mogrt_recipe
create_project
create_project_backup
create_sequence
create_sequence_checkpoint
create_sequence_from_clips
create_sequence_from_preset
create_smart_bin
create_subclip
create_subsequence
crop_clip
delete_bin
delete_marker
delete_multiple_project_items
delete_preview_files
delete_project_item
delete_sequence
delete_track
deselect_all_clips
detach_proxy
detect_active_picture_bounds
detect_audio_transients
detect_beats
detect_motion_peaks
detect_repeated_takes
detect_scene_edits
detect_silence
detect_source_scene_changes
diff_sequence_snapshots
duplicate_clip
duplicate_sequence
enable_disable_clip
encode_file
encode_project_item
enqueue_after_effects_render
export_aaf
export_and_verify
export_as_fcp_xml
export_as_project
export_facility_metadata_table
export_frame
export_omf
export_review_markers
export_sequence
export_sequence_clip_review_frames
export_sequence_edl
export_sequence_marker_review_frames
export_sequence_review_frames
extract_selection
find_items_by_media_path
find_project_item_by_name
freeze_frame
generate_media_contact_sheet
get_active_sequence
get_advanced_feature_support
get_all_project_paths
get_av_feature_support
get_bin_contents
get_bridge_telemetry
get_capabilities
get_caption_style_guidance
get_clip_adjustment_layer
get_clip_at_playhead
get_clip_at_position
get_clip_links
get_clip_markers
get_clip_properties
get_clip_speed
get_clip_volume
get_color_label
get_color_space
get_duplicate_media
get_effect_properties
get_encoder_presets
get_export_file_extension
get_footage_interpretation
get_full_clip_info
get_full_project_overview
get_full_sequence_info
get_graphics_white_luminance
get_insertion_bin
get_item_info
get_keyframes
get_linked_items
get_metadata
get_mogrt_component
get_next_edit_point
get_offline_media
get_operation_performance
get_playhead_position
get_premiere_state
get_project_info
get_project_item_info
get_project_panel_metadata
get_project_scratch_disks
get_qe_clip_info
get_render_queue_status
get_selected_clips
get_sequence_count
get_sequence_in_out_points
get_sequence_markers_by_type
get_sequence_settings
get_sequence_structure
get_source_monitor_info
get_source_monitor_position
get_target_tracks
get_timeline_gaps
get_timeline_summary
get_total_clip_count
get_track_info
get_unused_media
get_used_media_report
get_value_at_time
get_version_info
get_work_area
get_workspaces
get_xmp_metadata
has_proxy
import_ae_comps
import_edl
import_fcp_xml
import_folder
import_image_sequence
import_media
import_mogrt
import_mogrt_from_library
import_sequences
insert_from_source
inspect_after_effects_render_templates
inspect_after_effects_template_source
inspect_cmx3600_edl
inspect_dom_object
inspect_edit_readiness
inspect_fcpxml_interchange
inspect_film_editorial_workflow
inspect_interchange_artifact
inspect_interchange_loss_report
inspect_media_streams
inspect_mogrt_library
inspect_operation_recovery
inspect_otio_interchange
inspect_project_item_av_metadata
inspect_project_recovery
inspect_rendered_video_scopes
inspect_sequence_av_settings
inspect_sequence_review_report
inspect_stabilizer_status
inspect_timeline_snapshot
inspect_workflow_checkpoint
inspect_workflow_job
invert_selection
is_work_area_enabled
lift_selection
link_selection
list_available_audio_effects
list_available_audio_transitions
list_available_effects
list_available_transitions
list_clip_effects
list_markers
list_project_items
list_sequence_checkpoints
list_sequence_tracks
list_sequences
list_stock_titles
lock_track
manage_media_watch
manage_project_context
manage_proxies
map_keyframe_time_domain
map_source_ranges_to_timeline
map_word_timeline_occurrences
match_frame
move_clip
move_clip_to_track
move_item_to_bin
move_items_to_bin
move_playhead_to_edit
multiple_undo
mute_track
navigate_playhead
nest_clips
normalize_loudness_file
open_in_source
open_project
overwrite_clip
overwrite_from_source
paste_clip_attributes
ping
plan_active_speaker_reframe
plan_audio_post_turnover
plan_beat_montage
plan_chapter_markers
plan_client_notes_checklist
plan_cross_app_workflow
plan_emphasis_zoom_keyframes
plan_filler_word_removal
plan_media_synchronization
plan_multicam_angle_switches
plan_music_remix
plan_pause_tightening
plan_platform_delivery_matrix
plan_reaction_captions
plan_scene_segments
plan_short_export_folder
plan_short_subscribe_cta
plan_shot_match
plan_silence_review_markers
plan_speaker_checkerboard
plan_word_mute_ranges
play_source_monitor
play_timeline
predict_timeline_edit
prepare_transcript_workflow
preview_after_effects_render
preview_after_effects_render_handoff
preview_brand_spot
preview_edit_plan
preview_editorial_plan
preview_extended_edit_plan
preview_facility_metadata_intake
preview_mogrt_batch
preview_mogrt_library_publish
preview_mogrt_premiere_handoff
preview_mogrt_recipe
preview_motion_graphics_demo
preview_otio_snapshot_export
preview_product_spot
preview_project_intake
preview_scene_review_workflow
preview_stacked_camera_edit
preview_watched_media_import
preview_workflow_recipe
publish_mogrt_to_library
rank_short_form_candidates
razor_all_tracks
read_sequence_captions
read_video_scopes
redo
refresh_media
relink_media
remove_all_effects
remove_effect
remove_effect_by_name
remove_from_timeline
remove_keyframe
remove_keyframe_range
remove_selected_clips
rename_bin
rename_clip
rename_project_item
rename_track
replace_clip
replace_clip_media
reverse_clip
review_broll_placements
review_dialogue_candidates
review_quote_paper_edit
review_sync_evidence
review_text_changes
ripple_delete
ripple_remove_timeline_ranges
roll_edit
save_project
save_project_as
save_workflow_checkpoint
scene_edit_detection
search_project_context
search_project_items
search_workflow_recipes
select_all_clips
select_clips_by_color
select_clips_by_name
select_clips_by_pattern
select_clips_in_range
select_disabled_clips
select_item
set_active_sequence
set_all_tracks_targeted
set_anti_alias_quality
set_blend_mode
set_clip_anchor_point
set_clip_duration
set_clip_opacity
set_clip_pan
set_clip_position
set_clip_properties
set_clip_properties_batch
set_clip_rotation
set_clip_scale
set_clip_selection
set_clip_speed_qe
set_clip_start_time
set_clip_volume
set_clips_volume
set_color_label
set_color_value
set_effect_property
set_footage_interpretation
set_frame_blend
set_graphics_white_luminance
set_item_in_out
set_keyframe_interpolation
set_metadata
set_offline
set_override_frame_rate
set_override_pixel_aspect_ratio
set_playhead_position
set_poster_frame
set_project_item_audio_channel_mapping
set_project_panel_metadata
set_project_scratch_disk
set_scale_to_frame_size
set_scale_width_height
set_scratch_disk_path
set_sequence_audio_settings
set_sequence_display_format
set_sequence_field_type
set_sequence_frame_rate
set_sequence_in_out_points
set_sequence_pixel_aspect_ratio
set_sequence_resolution
set_sequence_settings
set_source_in_out
set_start_time
set_target_track
set_time_interpolation
set_transcode_on_ingest
set_uniform_scale
set_work_area
set_workspace
set_xmp_metadata
set_zero_point
setup_ducking
slide_edit
slip_edit
speed_change
split_clip
stabilize_clip
start_batch_encode
start_local_analysis_job
stop_playback
toggle_track_visibility
trim_clip
undo
unlink_selection
unnest_sequence
update_marker
validate_cmx3600_edl
validate_export_preset
validate_mogrt_brand_kit
validate_platform_publish_package
validate_project_for_export
verify_after_effects_connection
verify_caption_render_evidence
verify_delivery_conformance
verify_delivery_file
verify_fcpxml_media_references
verify_mogrt_artifact
verify_premiere_connection
verify_temporal_render_artifact
verify_timeline_postconditions
wait_workflow_job
Watch this server yourself
If you run this server, put the proxy in front of it. It pins these exact fingerprints on first connect and stops the session if they move.
npx -y mcp-pin@0.2.3 -- <your premiere-pro-mcp command>
Or subscribe to this page's RSS feed to be told when it changes.
Badge
The badge states one fact about time and nothing else. It never claims a server is safe.
[](https://mcp-pin.gautamkhosla.com/servers/97f12f9fbaac803a.html)