# Agent creation economics — outcome pricing

Creating and previewing are free. Creation, revisions, editing, the watermarked 540p RULIAD PREVIEW export, the preview link and the review link are free for every account. The clean master (full-quality playback, download, send to Vibe) is unlocked per ad; one unlock covers every version and re-export. The customer buys it in Ruliad (https://theruliad.ai/pricing): Single Ad $19, 5-Ad Pack $49, 10-Ad Pack $99, 50-Ad Pack $299, or a monthly subscription 25% off (opt-in; unused ads expire each period). On AD_EXPORT_PAYMENT_REQUIRED, give the customer the unlock link (get_ad_downloads or Ruliad's Unlock button) and keep working. Never ask for payment to create, preview or edit. An assistant never purchases funds, charges a card or changes billing settings.

Create for free. Free-creation continuity, creative reviews, source and likeness permissions, internal QA allocations and provider safeguards: the shared core (/agent-guides/core-v1.md), which every module requires.

# Editor read and edit checkpoints

Version: 2026-11-13.1. Load before editor read-before-edit requests, a Production QC hold or an explicit-hold failure, or calling any ad done, review-ready, exported or recorded. Required: core.

For a read-before-edit task, keep the requests coherent. If you tell MAIN “do not change anything yet,” complete that read-only exchange first, check the actual returned number, then send the already-authorized exact edit and save as a separate message. Do not put a current no-change hold and a conditional mutation in the same message. A blocked_by_explicit_hold result is a failed action: retain it, resolve the conflicting instruction within the customer’s actual authorization, and never repeat the same blocked request or substitute a manual slider edit. MAIN must explain what was read and what did not run. If the customer’s actual hold remains in force, report that boundary; do not lift it yourself. An unobstructed exact edit request can read, mutate, verify and save in one normal tool loop. This procedure does not grant new authority or prove playback.

## Verify before you call it done

- **The cut is the deliverable.** Before review, export or recording, confirm the Video Editor timeline plays the adopted Production (Step 4) take for every shot. Play the timeline and check each clip's media, or compare each shot's adopted take (MAIN `listShotTakes`; MCP `get_ad_production`) with the clip on the timeline (`get_ad_project`). A Step 4 card saying "Take N adopted" does not guarantee the timeline follows it (a timeline-sync fix is in progress). If a clip differs, bind it to the adopted take (MAIN `useShotTake`, MCP `adopt_ad_production` with the job that made that take, or ask the MAIN agent), then play again to confirm.
- **Check every take** for: talent identity; wardrobe matching the keyframe and the other shots; location matching the keyframe; photoreal rendering with no sketch, illustrated, painterly or CG regions (a sketch keyframe can leak its drawing style into the video, and the continuity check "Take matches" does not catch this yet); the complete spoken line in the transcript ("Voice passed" alone is not proof).
- **Take history.** A new take may auto-adopt; a take that failed its voice check shows "Not used". Re-check which take is adopted after any agent action; agents have reverted adoption.
- **End cards.** Default: the Omni in-frame end card on the closing shot, lettering verified by OCR. When the closing shot already carries in-frame lettering, remove any overlay end-card clip on the End Card (CTA) track. An overlay must never cover the talent's face. Read inspector warnings and adapt.
- **Dialogue fit.** A spoken shot needs 0.3 s lead-in + words / 2.3 per second + 0.3 s tail. When the voice check says a shot needs more time and no other shot can give it, shorten the line or rebalance shot lengths (Step 4 shot editor: Shot length, Apply) before regenerating.
- **No early demo or export.** Never record a demo or export until a frame-by-frame and transcript check of the full cut passes.

## Known failure modes and fixes

- `SPEND_BUDGET_PENDING` or `USD_OPERATOR_BUDGET_*`: an old operator execution budget on the account blocks creation. Owner-only billing decision; report it and stop the blocked operation.
- `CREATION_AUTHORITY_MISSING` after a billing-mode change: the job was approved under the old mode. It needs re-approval or a fix; report it.
- `PROVIDER_USAGE_INVALID`: provider rate limit (429) plus a usage-parse failure. Regenerate the shot.
- "Selected reference … unavailable or ambiguous": remove the stale reference in Edit inputs, click SAVE PROJECT, regenerate.
- `EDITORIAL_MODEL_LOGICAL_LIMIT`: edit review recovers by itself. Wait.
- MAIN agent shows "Waiting for model response" for minutes: the model is slow. Do not re-send. Afterwards verify its claimed changes by playback.
- Media players go blank or show "Format error" after about 10 minutes: media stream grants expire after 10 minutes. Reload the page (a fix is in progress).

## QC holds: what Ruliad checks, repairs and holds
Ruliad checks every generated take, then the assembled cut, before it calls a production review-ready: the complete line in the right voice; keyframe continuity (talent, wardrobe, location, photoreal rendering); talent likeness; no burned-in captions; product fidelity part by part (closure, shape, colour, label and logo, extra or missing parts; one bad part in one frame fails the shot and shots of the same product must agree); physical plausibility (nothing floats, defies gravity, passes through a solid or morphs); and direction adherence (an off-frame action stays off screen, a directed object appears in its directed state).

Automatic repair comes first. A failing take gets one automatic retake with prompts rewritten from the findings; while it runs the job shows progress (retrying is progress). Do not resubmit, revise or report a failure during that retake.

A hold names its reason. If the retake also fails, only that shot is held and the other shots continue. Read the hold in Production (the shot card shows the held take and the reason) or through MCP in `get_ad_production` or `wait_for_ad_job` (`shots[].error` with `code`, `message` and `humanAction`, plus `humanActions`, `continuityFindings` and `repairs`); `get_ad_take_qc` returns the per-take receipts. The message starts with the failing dimension, for example "Held: physical plausibility (…)", "Held: direction adherence (…)" or "Held: product fidelity (closure colour …)".
- PRODUCTION_CONTINUITY_MISMATCH (take QC: continuity, likeness, product parts, physics, direction): retake with `revise_ad_shot`, or keep with `accept_ad_held_take` (in the app, Accept this take on the shot card).
- PRODUCTION_FINAL_MASTER_HOLD (the final-master review of the assembled cut, for example "Held: a person talks with no voice"): `revise_ad_shot`, or `accept_ad_held_take`.
- PRODUCTION_VOICE_QC_NEEDS_REVIEW (shot state needs_review; the speech check is unsure, for example a misheard numeral): `accept_ad_held_take`, or `revise_ad_shot`. A good changed take can also be kept with Script Supervisor Keep take · update script to the heard line.
- PRODUCTION_ONSCREEN_TEXT_MISMATCH (a burned-in caption survived the retake): `revise_ad_shot`, or `accept_ad_held_take`.
- timingHold on the shot with timingFix on the job (the line does not fit the shot): `apply_ad_timing_fix` with the `fixHash` when `timingFix.ok`; no customer input is needed.
- A held storyboard keyframe (the photoreal keyframe does not match its board): Keep keyframe or reject it in the app, or `review_ad_storyboard_shot`.
For any other code follow the shot's humanActions entry; if no tool performs it, give the customer the Production link (`openInRuliad.production`).

Explain a hold to the customer: name the shot by number and what it shows, quote the reason in plain words, say Ruliad already retook it once automatically and what the retake tried to fix, say the rest of the ad is unaffected, and offer the two choices: retake (ideally with a concrete change such as a clearer direction, an extra reference or a do-not-include list) or keep it as generated. For a product-fidelity hold recommend the retake. When only physics or direction failed, the message also says the product itself matches its reference.

Rules: a shot-scoped hold is yours to resolve within the authorized task while the rest of the board keeps running, except that keeping a take as generated is the customer's choice: never accept a held take on the customer's behalf. Never mute on-camera speech to clear a voice hold. Never call an ad done, review-ready or ready to export while a shot is held. After the choice, wait for review_ready (`wait_for_ad_job`), then adopt the production (`adopt_ad_production`).
