@aicopycoders/exodus 2026.9.2000-beta.2 → 2026.9.2000-beta.21

package/dist/commands/workflow.d.ts

@@ -34,14 +34,60 @@ export interface WorkflowEdge {
     targetHandle: string;
 }
 export type WorkflowTriggerEvent = "winner-promoted";
+export interface ImageRigLineOverride {
+    count?: number;
+    aspects?: string[];
+    adType?: string;
+    style?: string;
+    memeFormat?: string;
+    steering?: string;
+    copyPin?: string;
+}
+export interface ImageRigPlanOverride {
+    lines?: unknown[];
+    steering?: string;
+    defaultAspects?: string[];
+    defaultStyle?: string;
+    model?: string;
+    confirmLargeRun?: boolean;
+}
+export interface ImageRigNodeOverride {
+    plan?: ImageRigPlanOverride;
+    lines?: Record<string, ImageRigLineOverride>;
+    confirmLargeRun?: boolean;
+    model?: string;
+}
+export type ImageRigOverrides = Record<string, ImageRigNodeOverride>;
+export interface VoiceRequest {
+    who: string;
+    choice: {
+        kind: "pin";
+        voiceId: string;
+        label?: string;
+    } | {
+        kind: "clear";
+    };
+}
+export type TriggerVoiceMap = Record<string, string | {
+    voiceId: string;
+    label?: string;
+} | null>;
 export type WorkflowTrigger = {
     type: "event";
     event: WorkflowTriggerEvent;
     enabled: boolean;
+    imageRigOverrides?: ImageRigOverrides;
+    voices?: VoiceRequest[];
 } | {
     type: "cron";
     cron: string;
     enabled: boolean;
+    imageRigOverrides?: ImageRigOverrides;
+    voices?: VoiceRequest[];
+};
+type WithoutVoices<T> = T extends unknown ? Omit<T, "voices"> : never;
+export type WorkflowContractTrigger = WithoutVoices<WorkflowTrigger> & {
+    voices?: TriggerVoiceMap;
 };
 export interface WorkflowContractJson {
     contract: "exodus-workflow";
@@ -51,7 +97,7 @@ export interface WorkflowContractJson {
     name: string;
     description?: string;
     slots?: WorkflowSlot[];
-    triggers?: WorkflowTrigger[];
+    triggers?: WorkflowContractTrigger[];
     nodes: WorkflowNode[];
     edges: WorkflowEdge[];
 }
@@ -363,7 +409,7 @@ export interface RunFormatProvenance {
     };
     specVersion: string | null;
 }
-export type VoicePath = "sts-revoice" | "lipsync-retarget" | "native-prompt" | "omni-audio-ids" | "gemini-direct";
+export type VoicePath = "sts-revoice" | "lipsync-retarget" | "native-prompt" | "omni-audio-ids" | "gemini-direct" | "voice-first";
 export type RunVoiceProvenance = {
     source: "show";
     path: VoicePath;
@@ -414,6 +460,7 @@ export interface WorkflowRun {
     pauseAhead?: {
         nodeId: string;
         after: "frames" | "storyboard";
+        selfApproves?: true;
     };
 }
 export declare function pauseAheadLine(ahead: NonNullable<WorkflowRun["pauseAhead"]>): string;
@@ -530,12 +577,13 @@ export declare function parseVersionFlag(flags: Record<string, string | boolean>
 export declare function versionsFlow(workflowRef: string, opts: {
     json: boolean;
 }, deps: WorkflowRunDeps, channel?: Channel): Promise<FlowResult>;
-export declare function triggerExpect(t: WorkflowTrigger): {
+type AnyTrigger = WorkflowTrigger | WorkflowContractTrigger;
+export declare function triggerExpect(t: AnyTrigger): {
     type: string;
     event?: string;
     cron?: string;
 };
-export declare function formatTriggers(triggers: WorkflowTrigger[]): string;
+export declare function formatTriggers(triggers: AnyTrigger[]): string;
 export declare function triggersListFlow(workflowRef: string, opts: {
     json: boolean;
 }, deps: WorkflowRunDeps): Promise<FlowResult>;
@@ -546,6 +594,7 @@ export declare function triggersFireFlow(workflowRef: string, opts: {
     n?: number;
     text?: string;
     imageRigOverrides?: Record<string, unknown>;
+    voices?: VoiceMap;
     wait: boolean;
     json: boolean;
     onProgressLine?: (line: string) => void;

package/dist/commands/workflow.js

@@ -10,7 +10,7 @@ import { runDisplayName, runHeadingWord, runTypeWord } from "../lib/runNames.js"
 import { workflowToYaml, parseWorkflowText } from "../lib/workflowText.js";
 import { missingRouteLine } from "../lib/route-support.js";
 import { getChannel } from "../lib/channel.js";
-import { asVideoRun, classifyRun, resolveStopAtPark, reviewUrl, stopLines, } from "./video.js";
+import { asVideoRun, classifyRun, resolveStopAtPark, reviewUrl, scenePrefix, stopLines, } from "./video.js";
 export const helpText = `
 exodus workflow — List, describe, run, inspect, import, and export saved workflows
 
@@ -32,7 +32,7 @@ Usage:
   exodus workflow triggers <workflowId|name> [--json]
   exodus workflow triggers <workflowId|name> enable <n> [--json]
   exodus workflow triggers <workflowId|name> disable <n> [--json]
-  exodus workflow triggers <workflowId|name> fire [<n>] [--text "..."] [--rig-overrides <json|@file>] [--wait] [--json]
+  exodus workflow triggers <workflowId|name> fire [<n>] [--text "..."] [--rig-overrides <json|@file>] [--voices <json|@voices.json>] [--wait] [--json]
   exodus workflow inbox [--json]
   exodus workflow checkpoint <runId> [show] [--json]
   exodus workflow checkpoint <runId> edit <n> [--text "..." | --file <path> | (stdin)] [--json]
@@ -84,9 +84,9 @@ Flags:
                          before anything runs, and the error names it. On
                          "triggers fire" it REPLACES the schedule's own
                          overrides for that one test fire.
-  --voices <json>        (run) Give the ad's characters their voices at the
-                         moment the run starts, instead of at the storyboard
-                         review. Keyed by the names the SCRIPT uses for its
+  --voices <json>        (run, triggers fire) Give the ad's characters their
+                         voices at the moment the run starts, instead of at the
+                         storyboard review. Keyed by the names the SCRIPT uses for its
                          speakers ("HOST 1") — the planner's character ids
                          (C1, C2) do not exist yet when a run starts. Takes a
                          JSON object, or @path to a .json file holding one:
@@ -103,6 +103,14 @@ Flags:
                          <run>" at the storyboard review instead. Voice ids
                          belong to the brand's own folder — never put them in a
                          shared workflow or template.
+                         A schedule can carry the same map in its YAML
+                         ("voices:" beside the schedule), so a weekly ad arrives
+                         already voiced. On "triggers fire" this flag REPLACES
+                         the schedule's own voices for that one test fire. A
+                         schedule whose voice has been deleted, or whose
+                         ElevenLabs key is missing or refused, does not start at
+                         all: it leaves a failed run saying which speaker and
+                         what to fix, and spends nothing.
   --voice-treatment <v>  (run) Say HOW this run makes its voices. Two kinds of
                          answer. A name on its own picks a way of working that
                          uses voices you already have:
@@ -279,7 +287,9 @@ Notes:
   panel in the app); anything you name that isn't there stops the launch and the
   message says which key was wrong. A trigger can carry the same payload in its
   YAML ("imageRigOverrides:" beside its schedule), so a Monday schedule and a
-  Friday one can fire the same workflow at different sizes.
+  Friday one can fire the same workflow at different sizes. A trigger can carry
+  "voices:" the same way — the same map "workflow run --voices" takes — so a run
+  that starts on a schedule arrives at the storyboard already voiced.
   "workflow run --voices" hands a video run its voices at the start, so a brand
   that always uses the same hosts stops choosing them by hand on every run. The
   file is keyed by the names the script uses for its speakers, because that is
@@ -368,6 +378,9 @@ export function formatRulesLine(provenance) {
     return `Format rules: ${rigName}${version}${where}.${borrowed}`;
 }
 export function pauseAheadLine(ahead) {
+    if (ahead.after === "frames" && ahead.selfApproves) {
+        return "When the frames are ready, the app checks the storyboard and approves it itself if the checks pass, then goes on to the voices and clips. It only stops for your approval if a check finds a problem. The reference, cast and scene pictures are made first (a few cents each).";
+    }
     return ahead.after === "frames"
         ? "This run will pause for your approval once the frames are ready. The reference, cast and scene pictures are made first (a few cents each). Nothing bigger is spent until you approve."
         : "This run will pause for your approval once the storyboard is written. Nothing is spent on pictures, voices or clips until you approve.";
@@ -1372,6 +1385,43 @@ function planArtifactFile(artifact) {
         url,
     };
 }
+function artifactFileSuffixes(artifacts) {
+    const sceneBearing = artifacts.some((a) => typeof a.sceneIndex === "number" || a.final === true);
+    if (!sceneBearing) {
+        return artifacts.map((_, i) => ({
+            suffix: i === 0 ? "" : `-${i + 1}`,
+            renamed: false,
+        }));
+    }
+    const taken = new Set();
+    let fullCount = 0;
+    return artifacts.map((a, i) => {
+        let suffix;
+        if (typeof a.sceneIndex === "number") {
+            suffix = `-${scenePrefix(a.sceneIndex)}`;
+        }
+        else if (a.final === true) {
+            suffix = "-final";
+        }
+        else if (a.type === "audio") {
+            fullCount += 1;
+            suffix = fullCount === 1 ? "-full" : `-full-${fullCount}`;
+        }
+        else {
+            suffix = i === 0 ? "" : `-${i + 1}`;
+        }
+        if (taken.has(suffix)) {
+            let fallback = `${suffix}-${i + 1}`;
+            while (taken.has(fallback))
+                fallback = `${fallback}-${i + 1}`;
+            suffix = fallback;
+            taken.add(suffix);
+            return { suffix, renamed: true };
+        }
+        taken.add(suffix);
+        return { suffix, renamed: false };
+    });
+}
 export async function saveDeliveries(run, dir, deps) {
     const paths = [];
     if (!run.isTerminal) {
@@ -1406,9 +1456,10 @@ export async function saveDeliveries(run, dir, deps) {
             lines.push(`  skipped  ${delivery.label} (${delivery.key}) — ${why}`);
             continue;
         }
+        const suffixes = artifactFileSuffixes(delivery.artifacts);
         for (let i = 0; i < delivery.artifacts.length; i++) {
             const plan = planArtifactFile(delivery.artifacts[i]);
-            const suffix = i === 0 ? "" : `-${i + 1}`;
+            const { suffix, renamed } = suffixes[i];
             if (plan.kind === "none") {
                 lines.push(`  skipped  ${delivery.label} (${delivery.key})${suffix} — ${plan.reason}`);
                 continue;
@@ -1419,7 +1470,7 @@ export async function saveDeliveries(run, dir, deps) {
                     deps.writeFile(file, plan.body);
                 else
                     await downloadToFile(plan.url, file);
-                lines.push(`  wrote    ${file}`);
+                lines.push(`  wrote    ${file}${renamed ? " — renamed to avoid a collision" : ""}`);
                 paths.push(file);
             }
             catch (e) {
@@ -2040,6 +2091,7 @@ function videoParkStop(raw) {
 async function waitForRun(runId, opts, deps) {
     const seen = new Map();
     let pausedNotified = false;
+    let autoRedoNotified;
     const landOnPark = opts.landOnPark;
     const isLandingPark = (raw) => (landOnPark !== undefined && raw["pauseReason"] === landOnPark.pauseReason) ||
         videoParkStop(raw) !== undefined;
@@ -2057,7 +2109,15 @@ async function waitForRun(runId, opts, deps) {
                 return;
             const parked = isParkedSnapshot(raw);
             const isLanding = isLandingPark(raw);
-            if (parked && !pausedNotified && !isLanding) {
+            const autoRedo = parked ? classifyRun(asVideoRun(raw)) : undefined;
+            if (autoRedo?.at === "running" && autoRedo.autoRedoScenes) {
+                const line = `  ${stopLines(autoRedo, runId, "")[0]}`;
+                if (line !== autoRedoNotified) {
+                    autoRedoNotified = line;
+                    opts.onProgressLine(line);
+                }
+            }
+            else if (parked && !pausedNotified && !isLanding) {
                 pausedNotified = true;
                 const dashboardUrl = deps.dashboardUrl ?? getDashboardUrl();
                 const pauseReason = raw["pauseReason"];
@@ -2065,7 +2125,9 @@ async function waitForRun(runId, opts, deps) {
                     opts.onProgressLine(line);
                 }
             }
-            const parkedNodeId = gateParkedNodeId(raw["status"], raw["pauseReason"], raw["pausedNodeId"]);
+            const parkedNodeId = autoRedo?.at === "running"
+                ? undefined
+                : gateParkedNodeId(raw["status"], raw["pauseReason"], raw["pausedNodeId"]);
             const nodes = Array.isArray(raw["nodes"]) ? raw["nodes"] : [];
             for (const node of nodes) {
                 const isParked = parkedNodeId !== undefined && node.nodeId === parkedNodeId;
@@ -2450,6 +2512,7 @@ export async function triggersFireFlow(workflowRef, opts, deps) {
         ...(opts.imageRigOverrides
             ? { imageRigOverrides: opts.imageRigOverrides }
             : {}),
+        ...(opts.voices ? { voices: opts.voices } : {}),
     });
     if (!res.ok)
         return triggerErrorResult(res, verb, opts.json);
@@ -3313,8 +3376,10 @@ export async function run(flags, occurrences) {
                 }
             }
             let fireOverrides;
+            let fireVoices;
             try {
                 fireOverrides = parseRigOverridesFlag(occurrences, defaultDeps.readFile);
+                fireVoices = parseVoicesFlag(occurrences, defaultDeps.readFile);
             }
             catch (e) {
                 console.error(`Error: ${e instanceof Error ? e.message : String(e)}`);
@@ -3324,6 +3389,7 @@ export async function run(flags, occurrences) {
                 n,
                 text: flagString(flags, "text"),
                 imageRigOverrides: fireOverrides,
+                voices: fireVoices,
                 wait: flags["wait"] === true,
                 json,
                 onProgressLine: (line) => console.log(line),

package/dist/lib/helperLedgerBase.d.ts

@@ -0,0 +1,3 @@
+export declare const HELPER_LEDGER_BASE = 900000;
+export declare const SET_OPTION_LEDGER_BASE = 920000;
+export declare const CAST_OPTION_LEDGER_BASE = 960000;

package/dist/lib/helperLedgerBase.js

@@ -0,0 +1,3 @@
+export const HELPER_LEDGER_BASE = 900000;
+export const SET_OPTION_LEDGER_BASE = 920000;
+export const CAST_OPTION_LEDGER_BASE = 960000;

package/dist/lib/meta-ads.d.ts

@@ -22,6 +22,7 @@ export interface AdWindowStats {
     spend?: number | null;
     spendDisplay?: string | null;
     impressions?: number | null;
+    reach?: number | null;
     clicks?: number | null;
     currency?: string | null;
 }

package/package.json

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