@aicopycoders/exodus 2026.10.1200-beta.1 → 2026.10.1200

package/assets/skills/exodus-video/SKILL.md

@@ -38,6 +38,37 @@ storyboard itself when its checks pass (see "What costs money"). The full line i
 note cannot contain a colon. "The script file" shows the right form and the
 wrong one.
 
+**The kinds of ad.** `--conceit` takes one of the kinds the server offers. The
+server's list is the truth, and nothing prints it on request. Pass a key it
+doesn't offer and the refusal names every key it does: `video start --conceit
+must be one of …`. Nothing is spent on a refused start. Today the server offers
+15 formats and then Custom:
+
+| Key | Kind |
+|---|---|
+| `podcast` | Podcast |
+| `ugc` | UGC talking head |
+| `stage` | Speaking on stage |
+| `street` | Street interview |
+| `personification` | Personification |
+| `news-broadcast` | News Broadcast |
+| `court-tv` | Court TV |
+| `soap-opera` | Soap Opera |
+| `storytime` | Storytime While Doing a Task |
+| `customer-service-call` | Customer Service Call |
+| `debate-circle` | Debate Circle |
+| `talk-show-panel` | Talk Show Panel |
+| `infomercial` | Infomercial |
+| `dating-show` | Dating Show |
+| `game-show` | Game Show |
+| `custom` | Custom |
+
+Custom builds the ad from the script itself. A script with no `CAST:` runs as a
+voice-over, and a script with people runs as a scene. Voice-over and Scene are
+not on the menu by name; Custom is the way to them. A narrator-only script fits
+Custom alone. If the refusal lists different keys from this table, the server
+is right and this table is stale.
+
 The Rig box on that workflow is where the run's Conceit and Style come from.
 Conceit is the family plus Wrapper, Narrator Person, and Delivery. Style is the
 look. Narrated Story is the voice-over family and Acted Story is the dialogue
@@ -368,6 +399,78 @@ Do not use a long dash in words a character says, or in words shown on screen.
 Synthesised speech reads a long dash oddly, and so does burned-in text. A spoken
 line stays `NAME: what they say`.
 
+### Directing a line
+
+A spoken line can carry two kinds of note. Neither is required.
+
+- **How the line is said goes in parentheses.** The voice acts it out.
+- **What happens on camera goes in square brackets.** The storyboard plans the
+  shot around it.
+
+```
+MIA: (whispering, excited) I can't believe this actually worked.
+MIA: [holds the jar up to the camera] This is the one.
+MIA: [leans in] (quietly) Don't tell my sister.
+```
+
+A note may sit anywhere on the line. It comes out of the spoken words, so the
+voice never says it. Several notes of one kind on a line are joined. Notes work
+on `CTA:` lines and on narrator lines too. They do not work on `CAST:` lines,
+where anything in brackets is just part of the description.
+
+How the voice uses a delivery note. By default a run records each line first,
+on the Eleven v4 voices, which take the note as a short cue in front of the
+line. The cue is the note's first clause, at most six words. A full stop,
+colon, semicolon, question mark, exclamation mark, or a dash with a space on
+each side ends the clause. A comma does not, so `whispering, excited` reaches
+the voice whole. Keep the note short and put the part that matters first. Put
+one delivery note on a line: two are joined with a semicolon, so the voice
+hears only the first.
+
+Right.
+
+```
+MIA: (whispering, excited) I can't believe this actually worked.
+```
+
+Wrong.
+
+```
+MIA: (She is whispering. She can barely contain how excited she is) I can't believe this actually worked.
+```
+
+The wrong note reaches the voice as `[she is whispering]`. The excitement is
+lost.
+
+In a narrated scene the whole narration is read as one part, so it takes one
+cue: the note on the first narrator line in that scene.
+
+What the reader refuses, with the code `malformed-direction`:
+
+- an empty note, `()` or `[]`
+- a square bracket that is never closed, or a stray `]`
+- a line with no spoken words left once the notes come out
+
+An unclosed `(` is not refused. It is read as ordinary words, and the voice
+says it. Check every `(` has its `)`.
+
+Both ways in read the file the same way: `exodus video start --script` and
+`exodus workflow run --input <field>=@script.txt`. The second holds only when
+the script goes straight from a Brief into the Storyboard. In a workflow where a
+bot writes or rewrites the script first, the notes are not read this way, and
+the bot may drop them or leave them in the spoken words.
+
+With `--voice native` (admins only) the video model speaks the lines itself and
+nothing is recorded first, so the six-word cue above does not apply.
+
+**A line with no note still gets a natural read.** A note is the surest way to
+get a particular delivery. The storyboard planner may add a note of its own to
+a line you left plain. A note you wrote always wins over the planner's.
+
+When you help the user write or tidy a script, suggest a delivery note where
+the tone carries the ad: the hook, the turn, the CTA. Do not put a note on every
+line. A note on every line reads as a script nobody trusted.
+
 **How many speakers you may have depends on the rig.** Three by default. A rig
 that carries saved format rules sets its own number: an ensemble rig seats more,
 a talking-head rig seats one. Over the number, the launch refuses before

package/dist/commands/video.d.ts

@@ -79,9 +79,11 @@ export type ArtifactSubset = {
     type: "image";
     imageUrl?: string;
     storageId?: string;
-    anchor?: "set-plate" | "product-sheet" | "filled-plate";
+    anchor?: "set-plate" | "product-sheet" | "filled-plate" | "product-plate" | "layout-plate";
     holds?: string[];
     lid?: "closed";
+    camera?: string;
+    view?: "side" | "back" | "three-quarter";
 } | {
     type: "video";
     sceneIndex?: number;
@@ -158,6 +160,7 @@ export interface PullCastLockMember {
     identityRefs?: Array<{
         storageId?: string;
         imageUrl?: string;
+        view?: string;
     }>;
 }
 export interface PullCastLock {
@@ -363,6 +366,11 @@ export interface ManifestCastRef {
     voiceId: string | null;
     voiceLabel: string | null;
     voiceDescription: string | null;
+    views?: ManifestCastView[];
+}
+export interface ManifestCastView {
+    view: string;
+    file: string | null;
 }
 export type MusicBedState = "on" | "off" | "unknown";
 export interface RunVideoChoice {
@@ -409,6 +417,7 @@ export interface RunShots {
     pacing?: string;
 }
 export declare const CAST_LEDGER_BASE: number;
+export declare const CAST_VIEW_LEDGER_BASE: number;
 export declare function musicBedState(run: VideoRun): MusicBedState;
 export interface PullPlan {
     downloads: PullDownload[];

package/dist/commands/video.js

@@ -639,6 +639,7 @@ export function planFailureLines(node, runId) {
 }
 export const MUSIC_HEARD_CODE = "music-heard";
 export const CAST_LEDGER_BASE = HELPER_LEDGER_BASE + 10000;
+export const CAST_VIEW_LEDGER_BASE = CAST_LEDGER_BASE + 1000;
 export function musicBedState(run) {
     if (run.musicBed === undefined)
         return "unknown";
@@ -737,9 +738,25 @@ function castVoicePins(artifact) {
     }
     return pins;
 }
+function lockViews(member, viewRows) {
+    return (member.identityRefs ?? []).flatMap((ref) => {
+        if (!ref.view)
+            return [];
+        const row = viewRows.find(({ artifact: art }) => art?.type !== "image"
+            ? false
+            : art.storageId
+                ? art.storageId === ref.storageId
+                : !!art.imageUrl && art.imageUrl === ref.imageUrl);
+        const url = (row?.artifact?.type === "image" ? row.artifact.imageUrl : undefined) ?? ref.imageUrl;
+        return url ? [{ view: ref.view, url }] : [];
+    });
+}
 function planCastRefs(run, items, pins) {
     const ledger = reservedCastFrames(items);
-    const ledgerRows = [...ledger.entries()].sort(([a], [b]) => a - b);
+    const isViewRow = ([sceneIndex, row]) => sceneIndex >= CAST_VIEW_LEDGER_BASE || (row.artifact?.type === "image" && row.artifact.view !== undefined);
+    const sorted = [...ledger.entries()].sort(([a], [b]) => a - b);
+    const ledgerRows = sorted.filter((r) => !isViewRow(r));
+    const viewRows = sorted.filter(isViewRow).map(([, row]) => row);
     const locked = run.castLock?.cast;
     const rows = [];
     if (locked !== undefined && locked.length > 0) {
@@ -765,6 +782,7 @@ function planCastRefs(run, items, pins) {
                 status: item?.status ?? (url ? "done" : "missing"),
                 error: item?.error ?? null,
                 stem: `cast-${member.characterId}`,
+                views: lockViews(member, viewRows),
             });
         }
         for (const [sceneIndex, item] of ledgerRows) {
@@ -780,6 +798,7 @@ function planCastRefs(run, items, pins) {
                 status: item.status,
                 error: item.error ?? null,
                 stem: `cast-ref-${String(sceneIndex - CAST_LEDGER_BASE).padStart(2, "0")}`,
+                views: [],
             });
         }
     }
@@ -794,6 +813,7 @@ function planCastRefs(run, items, pins) {
                 status: item.status,
                 error: item.error ?? null,
                 stem: `cast-ref-${String(sceneIndex - CAST_LEDGER_BASE).padStart(2, "0")}`,
+                views: [],
             });
         }
     }
@@ -802,6 +822,7 @@ function planCastRefs(run, items, pins) {
     for (const row of rows) {
         const file = row.url ? `${row.stem}.${extFor(row.url, "image")}` : null;
         const pin = row.characterId ? pins.get(row.characterId) : undefined;
+        const views = row.views.map((v) => ({ view: v.view, file: `${row.stem}-${v.view}.${extFor(v.url, "image")}`, url: v.url }));
         cast.push({
             characterId: row.characterId,
             name: row.name,
@@ -811,9 +832,12 @@ function planCastRefs(run, items, pins) {
             voiceId: pin?.voiceId ?? null,
             voiceLabel: pin?.voiceLabel ?? null,
             voiceDescription: pin?.voiceDescription ?? null,
+            ...(views.length ? { views: views.map(({ view, file: viewFile }) => ({ view, file: viewFile })) } : {}),
         });
         if (file && row.url)
             downloads.push({ file, url: row.url });
+        for (const v of views)
+            downloads.push({ file: v.file, url: v.url });
     }
     return { cast, downloads };
 }
@@ -1105,6 +1129,10 @@ export function markPullFailure(manifest, failure) {
     for (const ref of manifest.cast) {
         if (ref.file === failure.file)
             ref.file = null;
+        for (const view of ref.views ?? []) {
+            if (view.file === failure.file)
+                view.file = null;
+        }
     }
     if (manifest.narration?.file === failure.file)
         manifest.narration = null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aicopycoders/exodus",
-  "version": "2026.10.1200-beta.1",
+  "version": "2026.10.1200",
   "description": "CLI + Claude Code skills for the Copycoders Exodus ad pipeline",
   "repository": {
     "type": "git",