Preview Product Spot
preview_product_spotPreviews a product-spot assembly from existing project items, revalidating item IDs and reporting host readback before applying to explicit empty tracks.
Instructions
Preview a product-spot assembly from existing project items. The eventual apply is limited to explicit empty tracks, revalidates item IDs, and reports host readback without claiming visual delivery verification.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"sequence_id": "<sequence_id>",
"asset_item_ids": "<asset_item_ids>"
},
"name": "preview_product_spot"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sequence_id | Yes | Exact ID of an existing empty destination sequence. It must be active at apply time. | |
| motion_style | No | Scale-motion style for product and brand spots; defaults to alternate. | |
| asset_item_ids | Yes | Exact existing project-item node IDs in playback order; external media paths are deliberately not imported by this workflow. | |
| transition_name | No | Transition name; defaults to Cross Dissolve. Use none to disable transitions. | |
| audio_track_index | No | Empty destination audio track index, default 0. | |
| video_track_index | No | Empty destination video track index, default 0. | |
| expected_cep_target | No | Optional reviewed CEP sequence/clip identity and exact tick ranges. Checked before every generated command; UXP refuses this CEP-only guard. | |
| clip_duration_seconds | No | Planned spacing between asset starts; defaults to 5 seconds for a motion demo and 4 seconds for spots. | |
| expected_project_path | No | Optional absolute saved-project path. Every generated CEP command refuses before its body when the active project differs or is unsaved. UXP commands refuse this CEP-only guard; local-only tools do not inspect Premiere. Omit to keep existing behavior. | |
| transition_duration_seconds | No | Transition duration, default 0.75 seconds for demos and 0.5 seconds for spots. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | Whether the tool completed successfully. | |
| data | No | Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it. | |
| tool | Yes | The registered MCP tool name. | |
| error | No | Failure detail when ok is false. | |
| receipt | No | Versioned common mutation receipt; success never implies rendered verification. | |
| idempotency | No | Present when idempotency_key deduplicated this call: replayed is true when the original outcome was returned instead of running again. |