Review Broll Placements
review_broll_placementsReviews caller-proposed owned-footage B-roll placements against matched quotes, reasons, alternatives, and revisions, then records explicit approvals or rejections and blocks overlapping approved picks.
Instructions
Review caller-proposed owned-footage B-roll picks with matched quote, reason, alternatives, source/sequence revisions and explicit decisions. Reject overlapping approved placements. Does not infer visual content, search stock, inspect track occupancy or insert clips.
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": {
"placements": "<placements>"
},
"name": "review_broll_placements"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| placements | Yes | Caller-proposed video-only B-roll placements with captured revisions. | |
| rejected_ids | No | Explicitly rejected entry IDs. Unselected entries remain pending. | |
| selected_ids | No | Explicitly approved entry IDs. Omit for an initial review; an empty array approves nothing. | |
| 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. | |
| 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. | |
| expected_review_revision | No | Revision from the initial review; required when selecting or rejecting entries. A changed input requires a new review. |
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. |