Inspect Film Editorial Workflow
inspect_film_editorial_workflowValidates a revision-bound editorial manifest against captured source and timeline IDs, building coverage, notes, VFX, story, change-impact and turnover data locally without host edits or exports.
Instructions
Validate a revision-bound film editorial manifest against captured source and timeline identities. Build complete declared coverage review groups, independent picture/audio preferences, screening-note exceptions, story dependencies, VFX state, change impact and a department turnover manifest. Local inspection only: no host edits, exports, automatic creative decisions or verified host claims.
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": {
"project_id": "<project_id>",
"expected_context_revision": "<expected_context_revision>",
"expected_source_revision": "<expected_source_revision>",
"expected_timeline_revision": "<expected_timeline_revision>",
"script_revision": "<script_revision>",
"profile": "<profile>",
"scenes": "<scenes>",
"sources": "<sources>",
"coverage": "<coverage>",
"occurrences": "<occurrences>",
"notes": "<notes>",
"vfx": "<vfx>",
"storyCards": "<storyCards>",
"turnover": "<turnover>",
"viewing": "<viewing>"
},
"name": "inspect_film_editorial_workflow"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| vfx | Yes | Independent creative and delivery states; reconciled deliveries require a receipt. | |
| notes | Yes | Version-bound screening notes. Stale notes remain unresolved; frames are never guessed onto a new cut. | |
| scenes | Yes | Expected script scenes, including those without coverage. | |
| profile | Yes | Custom review preferences; overlap is a review-only source handle in each source timebase. | |
| sources | Yes | Declared source inventory tied to captured source evidence; technical values require host verification. | |
| viewing | Yes | Explicit output viewing profile; rendered-output checks remain required. | |
| coverage | Yes | Many-to-many source-range to scene graph. Preferences never remove unselected coverage. | |
| previous | No | Optional previously saved occurrence snapshot for change impact. Caller supplied, not an authenticated host receipt. | |
| turnover | Yes | Requested turnover settings; handles use each source timebase. This tool creates a manifest, never an export. | |
| project_id | Yes | Captured project-context ID. | |
| storyCards | Yes | Reorderable story fragments and explicit dependency graph. | |
| occurrences | Yes | Explicit source/timeline occurrences, separate from source coverage; retimes block automatic handoff. | |
| idempotency_key | No | Optional client-chosen key (1-128 chars of A-Z a-z 0-9 . _ : -) for this intended edit. Pass a fresh key per edit and reuse it only when retrying that same edit, for example after a client-side timeout. A repeat with the same tool, key and arguments is not run again: while the first call is running it fails with IDEMPOTENCY_IN_PROGRESS (poll get_last_operations); after it finished it returns the original outcome marked replayed. A definite failure with nothing applied (receipt outcome not_applied) may be retried with the same key. Reusing a key with different arguments fails with IDEMPOTENCY_KEY_REUSED. Scoped to this MCP session (the stdio server process, or the HTTP server process when Streamable HTTP is stateless per request) and held in memory only (200 keys, 1 hour); it does not survive a restart or reconnect. Read-only invocations are never deduplicated. | |
| script_revision | Yes | Human-supplied script revision for scene and line identities. | |
| 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_source_revision | Yes | Exact captured source revision. | |
| expected_context_revision | Yes | Exact captured context revision; stale requests fail. | |
| expected_timeline_revision | Yes | Exact captured timeline revision. |
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. |