video_workflow_plan
Validate a video workflow spec and generate a no-render dry-run plan with operation graph, source info, output intents, and warnings.
Instructions
Produce a no-render plan for an agent workflow job-spec.
Validates the spec first (fail-closed) and then builds a dry-run plan
artifact WITHOUT rendering any media: the ordered operation graph, per-source
ffprobe results (duration/resolution/codec) and sha256 content hashes where
the source file exists, declared output intents, a variant-expansion summary,
tool + FFmpeg versions, and warnings for runtime concerns that are not
structural errors (e.g. a source file that does not exist yet). The only file
written is the optional plan JSON at save_plan; paths inside the artifact
are workspace-relative.
Pass variant to plan a single named batch variant: the plan reflects that
variant's EFFECTIVE (post-override) steps and auto-named output paths and
records workflow.variant. An unknown variant or malformed override fails
closed (invalid_workflow_variant).
Returns the plan artifact on success. On a structurally invalid spec it fails
closed with a specific error code (same codes as video_workflow_validate).
Args: spec_path: Absolute path to the workflow job-spec JSON file. save_plan: Optional path to write the plan artifact as JSON. variant: Optional declared variant id to plan its effective steps.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| variant | No | ||
| save_plan | No | ||
| spec_path | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||