videoclaw 3.0.0-alpha.1

package/dist/video/assemble/types.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Shared types for the `vclaw video assemble` post-execution stage.
+ *
+ * Sub-slice 3a establishes only the structural surface. The actual
+ * TTS / PDF / title-card / slide-animation / music / stitch logic lands
+ * in sub-slices 3b–3h. No video/audio I/O lives here yet.
+ */
+import type { VideoProjectWorkspace } from '../workspace.js';
+import type { AssembleMediaQcReport } from './media-qc.js';
+export interface AssembleInput {
+    workspace: VideoProjectWorkspace;
+    /** Path to the brand-profile.json for the active presenter (Slice 2 output). */
+    brandProfilePath?: string;
+    /** Optional override of FFmpeg path. Defaults to `ffmpeg` on PATH. */
+    ffmpegBin?: string;
+    /** Dry run produces the report but skips actual generation. */
+    dryRun?: boolean;
+    /**
+     * Clip-stitch mode. When set, the body segments are the per-scene rendered
+     * clips `vclaw video execute` downloads to `outputs/scene-<i>.mp4` (NOT
+     * animated slides). Each clip's native audio (incl. omni-flash voice) is
+     * kept; the background-music bed is the only optional extra layer; no TTS
+     * narration and no dialogue/sfx auto-layers are added.
+     */
+    fromRenderedClips?: boolean;
+}
+export interface AssembleManifestEntry {
+    kind: 'narration' | 'music' | 'title-card' | 'slide-animation' | 'rendered-clip' | 'final-video';
+    path: string;
+    durationMs: number;
+    sceneIndex?: number;
+    sizeBytes: number;
+    generator: string;
+}
+export interface AssembleResult {
+    status: 'complete' | 'partial' | 'dry-run';
+    outputPath: string;
+    manifest: AssembleManifestEntry[];
+    events: string[];
+    warnings: string[];
+    qc?: AssembleMediaQcReport;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/video/assemble/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/video/assemble/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAE3D,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,qBAAqB,CAAC;IACjC,gFAAgF;IAChF,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;;;OAMG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,WAAW,GAAG,OAAO,GAAG,YAAY,GAAG,iBAAiB,GAAG,eAAe,GAAG,aAAa,CAAC;IACjG,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,SAAS,CAAC;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,qBAAqB,EAAE,CAAC;IAClC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,EAAE,CAAC,EAAE,qBAAqB,CAAC;CAC5B"}

package/dist/video/assemble/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/video/assemble/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/video/assemble/types.ts"],"names":[],"mappings":""}

package/dist/video/assemble/upscale.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Gated, opt-in Topaz Video AI upscale planner for the assemble stage (WS9).
+ *
+ * This module is a PURE planner: `topazUpscalePlan` decides whether an upscale
+ * pass should run and, if so, builds the exact CLI command — but it NEVER spawns
+ * a process. The actual shell-out is a separate thin wrapper that runs only when
+ * `plan.run` is true, so the gate stays fully unit-testable and offline.
+ *
+ * The pass is opt-in via two knobs (both must be satisfied to run):
+ *  - enabled: the operator opted in (env flag VCLAW_TOPAZ_UPSCALE=1).
+ *  - cliPath: the Topaz CLI is installed / located (env path VCLAW_TOPAZ_CLI).
+ * When `enabled`/`cliPath` are omitted the planner falls back to those env vars,
+ * so a project without the flag set behaves as a no-op (run:false).
+ */
+/** Topaz CLI gate inputs. Explicit fields win over the env fallbacks. */
+export interface TopazUpscaleOptions {
+    /** Whether the operator opted in. Falls back to VCLAW_TOPAZ_UPSCALE === '1'. */
+    enabled?: boolean;
+    /** Path to the Topaz CLI binary. Falls back to VCLAW_TOPAZ_CLI. */
+    cliPath?: string;
+    /** Upscale factor (default 2). */
+    scale?: number;
+    /** Topaz model name (default 'prob-4'). */
+    model?: string;
+}
+/** The planner output. `run` gates the (separate) shell-out. */
+export interface TopazUpscalePlan {
+    /** True iff an upscale pass should actually run. */
+    run: boolean;
+    /** When run is false, why (so callers can log/skip clearly). */
+    reason?: string;
+    /** The CLI command to execute when run is true; `[]` when run is false. */
+    command: string[];
+}
+/**
+ * Plan a Topaz upscale pass for `input` -> `output`. PURE — never spawns.
+ *
+ * Resolution order for the two gate knobs: explicit option > env var. The pass
+ * runs only when it is BOTH enabled AND the CLI path is known; otherwise it
+ * returns `run:false` with a `reason` and an empty `command`.
+ */
+export declare function topazUpscalePlan(input: string, output: string, opts?: TopazUpscaleOptions): TopazUpscalePlan;
+//# sourceMappingURL=upscale.d.ts.map

package/dist/video/assemble/upscale.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upscale.d.ts","sourceRoot":"","sources":["../../../src/video/assemble/upscale.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,yEAAyE;AACzE,MAAM,WAAW,mBAAmB;IAClC,gFAAgF;IAChF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,gEAAgE;AAChE,MAAM,WAAW,gBAAgB;IAC/B,oDAAoD;IACpD,GAAG,EAAE,OAAO,CAAC;IACb,gEAAgE;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2EAA2E;IAC3E,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,mBAAwB,GAC7B,gBAAgB,CA+BlB"}

package/dist/video/assemble/upscale.js

@@ -0,0 +1,52 @@
+/**
+ * Gated, opt-in Topaz Video AI upscale planner for the assemble stage (WS9).
+ *
+ * This module is a PURE planner: `topazUpscalePlan` decides whether an upscale
+ * pass should run and, if so, builds the exact CLI command — but it NEVER spawns
+ * a process. The actual shell-out is a separate thin wrapper that runs only when
+ * `plan.run` is true, so the gate stays fully unit-testable and offline.
+ *
+ * The pass is opt-in via two knobs (both must be satisfied to run):
+ *  - enabled: the operator opted in (env flag VCLAW_TOPAZ_UPSCALE=1).
+ *  - cliPath: the Topaz CLI is installed / located (env path VCLAW_TOPAZ_CLI).
+ * When `enabled`/`cliPath` are omitted the planner falls back to those env vars,
+ * so a project without the flag set behaves as a no-op (run:false).
+ */
+/**
+ * Plan a Topaz upscale pass for `input` -> `output`. PURE — never spawns.
+ *
+ * Resolution order for the two gate knobs: explicit option > env var. The pass
+ * runs only when it is BOTH enabled AND the CLI path is known; otherwise it
+ * returns `run:false` with a `reason` and an empty `command`.
+ */
+export function topazUpscalePlan(input, output, opts = {}) {
+    const enabled = opts.enabled ?? process.env.VCLAW_TOPAZ_UPSCALE === '1';
+    const cliPath = opts.cliPath ?? process.env.VCLAW_TOPAZ_CLI;
+    if (!enabled) {
+        return { run: false, reason: 'Topaz upscale not enabled (VCLAW_TOPAZ_UPSCALE!=1)', command: [] };
+    }
+    if (!cliPath) {
+        return {
+            run: false,
+            reason: 'Topaz CLI not installed (VCLAW_TOPAZ_CLI absent)',
+            command: [],
+        };
+    }
+    const scale = opts.scale ?? 2;
+    const model = opts.model ?? 'prob-4';
+    return {
+        run: true,
+        command: [
+            cliPath,
+            '-i',
+            input,
+            '-o',
+            output,
+            '--scale',
+            String(scale),
+            '--model',
+            model,
+        ],
+    };
+}
+//# sourceMappingURL=upscale.js.map

package/dist/video/assemble/upscale.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upscale.js","sourceRoot":"","sources":["../../../src/video/assemble/upscale.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAwBH;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAAa,EACb,MAAc,EACd,OAA4B,EAAE;IAE9B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,mBAAmB,KAAK,GAAG,CAAC;IACxE,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;IAE5D,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,oDAAoD,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IACnG,CAAC;IACD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO;YACL,GAAG,EAAE,KAAK;YACV,MAAM,EAAE,kDAAkD;YAC1D,OAAO,EAAE,EAAE;SACZ,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC;IAC9B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,QAAQ,CAAC;IACrC,OAAO;QACL,GAAG,EAAE,IAAI;QACT,OAAO,EAAE;YACP,OAAO;YACP,IAAI;YACJ,KAAK;YACL,IAAI;YACJ,MAAM;YACN,SAAS;YACT,MAAM,CAAC,KAAK,CAAC;YACb,SAAS;YACT,KAAK;SACN;KACF,CAAC;AACJ,CAAC"}

package/dist/video/asset-spec.d.ts

@@ -0,0 +1,15 @@
+export interface ParsedAssetSpec {
+    id: string;
+    kind: 'image' | 'video' | 'audio' | 'subtitle' | 'other';
+    path: string;
+    sceneIndex?: number;
+    backend?: string;
+}
+/**
+ * Parse a `--asset kind:path[:sceneIndex][:backend]` spec. The path may be a
+ * local file path OR a URL / `Asset://` URI whose internal colons must survive.
+ * Local paths keep the original positional split (byte-identical behavior);
+ * scheme paths peel the trailing `:sceneIndex[:backend]` from the end instead.
+ */
+export declare function parseAssetSpec(raw: string): ParsedAssetSpec;
+//# sourceMappingURL=asset-spec.d.ts.map

package/dist/video/asset-spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-spec.d.ts","sourceRoot":"","sources":["../../src/video/asset-spec.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,GAAG,OAAO,CAAC;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAUD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CA8B3D"}

package/dist/video/asset-spec.js

@@ -0,0 +1,43 @@
+const ALLOWED_KINDS = new Set(['image', 'video', 'audio', 'subtitle', 'other']);
+// A URI/URL scheme prefix (http://, https://, Asset://, gobananas://, gs://, s3://, …)
+// — its internal `://` and any `:port` would be shredded by a naive split(':').
+const SCHEME_RE = /^[a-zA-Z][a-zA-Z0-9+.\-]*:\/\//;
+// For a scheme path, peel an optional trailing `:sceneIndex[:backend]` from the END
+// so the URL (which may itself contain colons) is preserved intact.
+const TRAILING_RE = /^(.*?)(?::(\d+)(?::([^:]+))?)?$/;
+/**
+ * Parse a `--asset kind:path[:sceneIndex][:backend]` spec. The path may be a
+ * local file path OR a URL / `Asset://` URI whose internal colons must survive.
+ * Local paths keep the original positional split (byte-identical behavior);
+ * scheme paths peel the trailing `:sceneIndex[:backend]` from the end instead.
+ */
+export function parseAssetSpec(raw) {
+    const firstColon = raw.indexOf(':');
+    const kindRaw = firstColon >= 0 ? raw.slice(0, firstColon) : '';
+    const remainder = firstColon >= 0 ? raw.slice(firstColon + 1) : '';
+    if (!kindRaw || !remainder) {
+        throw new Error(`Invalid --asset value: "${raw}". Expected kind:path[:sceneIndex][:backend]`);
+    }
+    let path;
+    let sceneIndexRaw;
+    let backend;
+    if (SCHEME_RE.test(remainder)) {
+        const match = TRAILING_RE.exec(remainder);
+        path = match?.[1] ?? remainder;
+        sceneIndexRaw = match?.[2];
+        backend = match?.[3];
+    }
+    else {
+        [path, sceneIndexRaw, backend] = remainder.split(':');
+    }
+    const kind = (ALLOWED_KINDS.has(kindRaw) ? kindRaw : 'other');
+    const sceneIndex = sceneIndexRaw !== undefined && sceneIndexRaw !== '' ? Number(sceneIndexRaw) : undefined;
+    return {
+        id: `${kind}-${path}`,
+        kind,
+        path,
+        ...(Number.isFinite(sceneIndex) ? { sceneIndex } : {}),
+        ...(backend ? { backend } : {}),
+    };
+}
+//# sourceMappingURL=asset-spec.js.map

package/dist/video/asset-spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-spec.js","sourceRoot":"","sources":["../../src/video/asset-spec.ts"],"names":[],"mappings":"AAQA,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;AAChF,uFAAuF;AACvF,gFAAgF;AAChF,MAAM,SAAS,GAAG,gCAAgC,CAAC;AACnD,oFAAoF;AACpF,oEAAoE;AACpE,MAAM,WAAW,GAAG,iCAAiC,CAAC;AAEtD;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,MAAM,UAAU,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACpC,MAAM,OAAO,GAAG,UAAU,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAChE,MAAM,SAAS,GAAG,UAAU,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACnE,IAAI,CAAC,OAAO,IAAI,CAAC,SAAS,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,2BAA2B,GAAG,8CAA8C,CAAC,CAAC;IAChG,CAAC;IAED,IAAI,IAAY,CAAC;IACjB,IAAI,aAAiC,CAAC;IACtC,IAAI,OAA2B,CAAC;IAEhC,IAAI,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9B,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC1C,IAAI,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC;QAC/B,aAAa,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;QAC3B,OAAO,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;IACvB,CAAC;SAAM,CAAC;QACN,CAAC,IAAI,EAAE,aAAa,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACxD,CAAC;IAED,MAAM,IAAI,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAA4B,CAAC;IACzF,MAAM,UAAU,GAAG,aAAa,KAAK,SAAS,IAAI,aAAa,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3G,OAAO;QACL,EAAE,EAAE,GAAG,IAAI,IAAI,IAAI,EAAE;QACrB,IAAI;QACJ,IAAI;QACJ,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtD,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAChC,CAAC;AACJ,CAAC"}

package/dist/video/asset-tag-lookup.d.ts

@@ -0,0 +1,31 @@
+import type { AssetTagLookup } from './prompt-rules.js';
+/**
+ * Build the name -> AssetTagEntry map for resolveAssetTags. Keys are lowercased.
+ * descriptor = description ?? name; referencePath = Asset:// URI (seedance) else
+ * the first referenceAssets image. environmentsByName (#3) is merged when present.
+ * Pure — the caller does the I/O (characters.json + seedance-assets.json).
+ *
+ * `assetUriOnly` (set on the seedance-direct route): a character's referencePath
+ * comes ONLY from its Asset:// URI — never the raw `referenceAssets[0]` portrait.
+ * A raw local portrait both fails seedance submit (the API needs a hosted URL /
+ * Asset:// URI) and trips the real-person content filter, so an @Name tag for an
+ * unregistered character contributes its descriptor text but no reference. The
+ * environment entries are unaffected (they carry already-hosted plate refs).
+ *
+ * `voicesByName` (#4): registered voice clones (the blank-video-with-audio trick).
+ * Merged LAST so an explicit @VoiceName tag resolves to the voice clip; a voice
+ * entry's referencePath is the blank-video clip, which the seedance transport
+ * classifies into `reference_videos` (the voice-locking reference). Absent → no-op.
+ */
+export declare function buildAssetTagLookup(input: {
+    characters: Array<{
+        name: string;
+        description?: string;
+        referenceAssets?: string[];
+    }>;
+    assetUriByName: Map<string, string>;
+    assetUriOnly?: boolean;
+    environmentsByName?: AssetTagLookup;
+    voicesByName?: AssetTagLookup;
+}): AssetTagLookup;
+//# sourceMappingURL=asset-tag-lookup.d.ts.map

package/dist/video/asset-tag-lookup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-tag-lookup.d.ts","sourceRoot":"","sources":["../../src/video/asset-tag-lookup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEvE;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IACzC,UAAU,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IACtF,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,kBAAkB,CAAC,EAAE,cAAc,CAAC;IACpC,YAAY,CAAC,EAAE,cAAc,CAAC;CAC/B,GAAG,cAAc,CAwBjB"}

package/dist/video/asset-tag-lookup.js

@@ -0,0 +1,45 @@
+/**
+ * Build the name -> AssetTagEntry map for resolveAssetTags. Keys are lowercased.
+ * descriptor = description ?? name; referencePath = Asset:// URI (seedance) else
+ * the first referenceAssets image. environmentsByName (#3) is merged when present.
+ * Pure — the caller does the I/O (characters.json + seedance-assets.json).
+ *
+ * `assetUriOnly` (set on the seedance-direct route): a character's referencePath
+ * comes ONLY from its Asset:// URI — never the raw `referenceAssets[0]` portrait.
+ * A raw local portrait both fails seedance submit (the API needs a hosted URL /
+ * Asset:// URI) and trips the real-person content filter, so an @Name tag for an
+ * unregistered character contributes its descriptor text but no reference. The
+ * environment entries are unaffected (they carry already-hosted plate refs).
+ *
+ * `voicesByName` (#4): registered voice clones (the blank-video-with-audio trick).
+ * Merged LAST so an explicit @VoiceName tag resolves to the voice clip; a voice
+ * entry's referencePath is the blank-video clip, which the seedance transport
+ * classifies into `reference_videos` (the voice-locking reference). Absent → no-op.
+ */
+export function buildAssetTagLookup(input) {
+    const lookup = new Map();
+    for (const character of input.characters) {
+        if (!character.name)
+            continue;
+        const referencePath = input.assetUriOnly
+            ? input.assetUriByName.get(character.name)
+            : input.assetUriByName.get(character.name) ?? character.referenceAssets?.[0];
+        const entry = {
+            descriptor: character.description ?? character.name,
+            ...(referencePath ? { referencePath } : {}),
+        };
+        lookup.set(character.name.toLowerCase(), entry);
+    }
+    if (input.environmentsByName) {
+        for (const [name, entry] of input.environmentsByName) {
+            lookup.set(name.toLowerCase(), entry);
+        }
+    }
+    if (input.voicesByName) {
+        for (const [name, entry] of input.voicesByName) {
+            lookup.set(name.toLowerCase(), entry);
+        }
+    }
+    return lookup;
+}
+//# sourceMappingURL=asset-tag-lookup.js.map

package/dist/video/asset-tag-lookup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-tag-lookup.js","sourceRoot":"","sources":["../../src/video/asset-tag-lookup.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAMnC;IACC,MAAM,MAAM,GAAmB,IAAI,GAAG,EAAE,CAAC;IACzC,KAAK,MAAM,SAAS,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;QACzC,IAAI,CAAC,SAAS,CAAC,IAAI;YAAE,SAAS;QAC9B,MAAM,aAAa,GAAG,KAAK,CAAC,YAAY;YACtC,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC;YAC1C,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,CAAC;QAC/E,MAAM,KAAK,GAAkB;YAC3B,UAAU,EAAE,SAAS,CAAC,WAAW,IAAI,SAAS,CAAC,IAAI;YACnD,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC5C,CAAC;QACF,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,KAAK,CAAC,CAAC;IAClD,CAAC;IACD,IAAI,KAAK,CAAC,kBAAkB,EAAE,CAAC;QAC7B,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,KAAK,CAAC,kBAAkB,EAAE,CAAC;YACrD,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,KAAK,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;IACD,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC;QACvB,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC;YAC/C,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,KAAK,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/video/atomic-write.d.ts

@@ -0,0 +1,2 @@
+export declare function writeTextFileAtomic(path: string, content: string): Promise<void>;
+//# sourceMappingURL=atomic-write.d.ts.map

package/dist/video/atomic-write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atomic-write.d.ts","sourceRoot":"","sources":["../../src/video/atomic-write.ts"],"names":[],"mappings":"AAEA,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAItF"}

package/dist/video/atomic-write.js

@@ -0,0 +1,7 @@
+import { rename, writeFile } from 'node:fs/promises';
+export async function writeTextFileAtomic(path, content) {
+    const tempPath = `${path}.${process.pid}.${Date.now()}.${Math.random().toString(36).slice(2)}.tmp`;
+    await writeFile(tempPath, content);
+    await rename(tempPath, path);
+}
+//# sourceMappingURL=atomic-write.js.map

package/dist/video/atomic-write.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"atomic-write.js","sourceRoot":"","sources":["../../src/video/atomic-write.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAErD,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,IAAY,EAAE,OAAe;IACrE,MAAM,QAAQ,GAAG,GAAG,IAAI,IAAI,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;IACnG,MAAM,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACnC,MAAM,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;AAC/B,CAAC"}

package/dist/video/audio-platform/native-elevenlabs-sfx.d.ts

@@ -0,0 +1,29 @@
+/**
+ * SCAFFOLD: ElevenLabs Sound Effects request/response per docs at
+ * https://elevenlabs.io/docs/api-reference/sound-generation; verify against a
+ * real ELEVENLABS_API_KEY before treating this as production-ready.
+ *
+ * ElevenLabs SFX backend — wraps the ElevenLabs Sound Generation endpoint:
+ *   POST https://api.elevenlabs.io/v1/sound-generation
+ *   Header: xi-api-key: <ELEVENLABS_API_KEY>
+ *   Body (JSON): { text, duration_seconds?, prompt_influence? }
+ *   Response: audio/mpeg bytes (mp3)
+ *
+ * The API honors a requested `duration_seconds` (0.5–22 s) and a
+ * `prompt_influence` scalar (0–1, default 0.3). This backend:
+ *   - Resolves the API key from `input.env?.ELEVENLABS_API_KEY ?? process.env.ELEVENLABS_API_KEY`.
+ *   - Writes the returned mp3 bytes to `outputPath`.
+ *   - Returns `durationMs` derived from the requested `durationSec * 1000`
+ *     (default 2 000 ms). The API honors the requested duration so this is
+ *     a reliable estimate without requiring an ffprobe call.
+ *   - On dry-run: creates the output directory and writes a zero-byte
+ *     placeholder mp3; does NOT touch the network.
+ *   - On non-2xx or empty response body: throws VclawError('music_gen_failed')
+ *     (reusing the existing error code avoids touching the errors catalog).
+ *
+ * Availability: `ELEVENLABS_API_KEY` must be set and non-empty (in env or
+ * process.env). The backend is inert without the key.
+ */
+import type { SfxBackend } from './types.js';
+export declare const elevenLabsSfx: SfxBackend;
+//# sourceMappingURL=native-elevenlabs-sfx.d.ts.map

package/dist/video/audio-platform/native-elevenlabs-sfx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-elevenlabs-sfx.d.ts","sourceRoot":"","sources":["../../../src/video/audio-platform/native-elevenlabs-sfx.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAKH,OAAO,KAAK,EAAE,UAAU,EAA6B,MAAM,YAAY,CAAC;AAiBxE,eAAO,MAAM,aAAa,EAAE,UAgF3B,CAAC"}

package/dist/video/audio-platform/native-elevenlabs-sfx.js

@@ -0,0 +1,95 @@
+/**
+ * SCAFFOLD: ElevenLabs Sound Effects request/response per docs at
+ * https://elevenlabs.io/docs/api-reference/sound-generation; verify against a
+ * real ELEVENLABS_API_KEY before treating this as production-ready.
+ *
+ * ElevenLabs SFX backend — wraps the ElevenLabs Sound Generation endpoint:
+ *   POST https://api.elevenlabs.io/v1/sound-generation
+ *   Header: xi-api-key: <ELEVENLABS_API_KEY>
+ *   Body (JSON): { text, duration_seconds?, prompt_influence? }
+ *   Response: audio/mpeg bytes (mp3)
+ *
+ * The API honors a requested `duration_seconds` (0.5–22 s) and a
+ * `prompt_influence` scalar (0–1, default 0.3). This backend:
+ *   - Resolves the API key from `input.env?.ELEVENLABS_API_KEY ?? process.env.ELEVENLABS_API_KEY`.
+ *   - Writes the returned mp3 bytes to `outputPath`.
+ *   - Returns `durationMs` derived from the requested `durationSec * 1000`
+ *     (default 2 000 ms). The API honors the requested duration so this is
+ *     a reliable estimate without requiring an ffprobe call.
+ *   - On dry-run: creates the output directory and writes a zero-byte
+ *     placeholder mp3; does NOT touch the network.
+ *   - On non-2xx or empty response body: throws VclawError('music_gen_failed')
+ *     (reusing the existing error code avoids touching the errors catalog).
+ *
+ * Availability: `ELEVENLABS_API_KEY` must be set and non-empty (in env or
+ * process.env). The backend is inert without the key.
+ */
+import { mkdir, writeFile } from 'node:fs/promises';
+import { dirname } from 'node:path';
+import { VclawError } from '../errors.js';
+const ELEVENLABS_SFX_URL = 'https://api.elevenlabs.io/v1/sound-generation';
+/** Default duration when neither the caller nor the API provides one. */
+const DEFAULT_DURATION_SEC = 2;
+/**
+ * Resolve the ElevenLabs API key from a caller-supplied env object or
+ * process.env, preferring the caller-supplied env so library callers that
+ * cannot mutate process.env can still authenticate.
+ */
+function resolveApiKey(env) {
+    const key = env?.ELEVENLABS_API_KEY ?? process.env.ELEVENLABS_API_KEY;
+    return key && key.trim() !== '' ? key.trim() : undefined;
+}
+export const elevenLabsSfx = {
+    id: 'elevenlabs-sfx',
+    kind: 'sfx',
+    displayName: 'ElevenLabs Sound Effects',
+    requiredEnv: ['ELEVENLABS_API_KEY'],
+    requiresVertex: false,
+    summary: 'Sound-effect generation via the ElevenLabs Sound Generation API. Returns an mp3 of the requested duration (0.5–22 s). Requires ELEVENLABS_API_KEY.',
+    async generate(input) {
+        if (!input.text || !input.text.trim()) {
+            throw new VclawError('music_gen_failed', 'ElevenLabs SFX: cannot generate a sound effect from empty text.', { backendId: 'elevenlabs-sfx' });
+        }
+        const durationSec = input.durationSec ?? DEFAULT_DURATION_SEC;
+        const durationMs = Math.round(durationSec * 1000);
+        // Dry-run: create directory + write zero-byte placeholder; no network.
+        if (input.dryRun) {
+            await mkdir(dirname(input.outputPath), { recursive: true });
+            await writeFile(input.outputPath, new Uint8Array(0));
+            return { path: input.outputPath, durationMs, backendId: 'elevenlabs-sfx' };
+        }
+        const apiKey = resolveApiKey(input.env);
+        if (!apiKey) {
+            throw new VclawError('music_gen_failed', 'ElevenLabs SFX: ELEVENLABS_API_KEY is not set. Export it before generating sound effects.', { backendId: 'elevenlabs-sfx', envVar: 'ELEVENLABS_API_KEY' });
+        }
+        const doFetch = input.fetcher ?? fetch;
+        const requestBody = {
+            text: input.text.trim(),
+            duration_seconds: durationSec,
+        };
+        if (input.promptInfluence !== undefined) {
+            requestBody.prompt_influence = input.promptInfluence;
+        }
+        const response = await doFetch(ELEVENLABS_SFX_URL, {
+            method: 'POST',
+            headers: {
+                'xi-api-key': apiKey,
+                'Content-Type': 'application/json',
+                Accept: 'audio/mpeg',
+            },
+            body: JSON.stringify(requestBody),
+        });
+        if (!response.ok) {
+            const body = await response.text().catch(() => '');
+            throw new VclawError('music_gen_failed', `ElevenLabs SFX request failed with HTTP ${response.status}.`, { backendId: 'elevenlabs-sfx', status: response.status, body: body.slice(0, 500) });
+        }
+        const bytes = new Uint8Array(await response.arrayBuffer());
+        if (bytes.length === 0) {
+            throw new VclawError('music_gen_failed', 'ElevenLabs SFX returned an empty audio payload.', { backendId: 'elevenlabs-sfx' });
+        }
+        await mkdir(dirname(input.outputPath), { recursive: true });
+        await writeFile(input.outputPath, bytes);
+        return { path: input.outputPath, durationMs, backendId: 'elevenlabs-sfx' };
+    },
+};
+//# sourceMappingURL=native-elevenlabs-sfx.js.map

package/dist/video/audio-platform/native-elevenlabs-sfx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-elevenlabs-sfx.js","sourceRoot":"","sources":["../../../src/video/audio-platform/native-elevenlabs-sfx.ts"],"names":[],"mappings":"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"}

package/dist/video/audio-platform/native-elevenlabs-tts.d.ts

@@ -0,0 +1,30 @@
+/**
+ * ElevenLabs TTS narration backend — wraps the ElevenLabs Text-to-Speech endpoint:
+ *   POST https://api.elevenlabs.io/v1/text-to-speech/{voice_id}
+ *   Header: xi-api-key: <ELEVENLABS_API_KEY>
+ *   Body (JSON): { text, model_id }
+ *   Response: audio/mpeg bytes (mp3)
+ *
+ * This exists so `vclaw video narrate` has a working backend that does NOT
+ * depend on the Gemini `generativelanguage` API being enabled on the key's GCP
+ * project (the gemini-tts backend 403s when it isn't). It is the fallback /
+ * alternative TTS path, selected explicitly via `--backend elevenlabs-tts`.
+ *
+ * This backend:
+ *   - Resolves the API key from `input.env?.ELEVENLABS_API_KEY ?? process.env.ELEVENLABS_API_KEY`.
+ *   - Treats `input.voice` as an ElevenLabs **voice_id** (defaults to "Rachel"),
+ *     and uses the `eleven_multilingual_v2` model.
+ *   - Writes the returned mp3 bytes to `outputPath`.
+ *   - Returns `durationMs` ESTIMATED from text length (~14 chars/sec). ElevenLabs
+ *     returns compressed mp3 with no duration field, and we avoid a spawn
+ *     (ffprobe) to keep this backend pure + offline-testable. Callers that need
+ *     exact timing (e.g. narration-fit) probe the written file themselves.
+ *   - On dry-run: creates the output directory and writes a zero-byte
+ *     placeholder mp3; does NOT touch the network.
+ *   - On missing key / non-2xx / empty body: throws VclawError('tts_failed').
+ *
+ * Availability (registry): `ELEVENLABS_API_KEY` set and non-empty.
+ */
+import type { TtsBackend } from './types.js';
+export declare const elevenLabsTts: TtsBackend;
+//# sourceMappingURL=native-elevenlabs-tts.d.ts.map

package/dist/video/audio-platform/native-elevenlabs-tts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-elevenlabs-tts.d.ts","sourceRoot":"","sources":["../../../src/video/audio-platform/native-elevenlabs-tts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAKH,OAAO,KAAK,EAAE,UAAU,EAA6B,MAAM,YAAY,CAAC;AAkBxE,eAAO,MAAM,aAAa,EAAE,UAqE3B,CAAC"}

package/dist/video/audio-platform/native-elevenlabs-tts.js

@@ -0,0 +1,95 @@
+/**
+ * ElevenLabs TTS narration backend — wraps the ElevenLabs Text-to-Speech endpoint:
+ *   POST https://api.elevenlabs.io/v1/text-to-speech/{voice_id}
+ *   Header: xi-api-key: <ELEVENLABS_API_KEY>
+ *   Body (JSON): { text, model_id }
+ *   Response: audio/mpeg bytes (mp3)
+ *
+ * This exists so `vclaw video narrate` has a working backend that does NOT
+ * depend on the Gemini `generativelanguage` API being enabled on the key's GCP
+ * project (the gemini-tts backend 403s when it isn't). It is the fallback /
+ * alternative TTS path, selected explicitly via `--backend elevenlabs-tts`.
+ *
+ * This backend:
+ *   - Resolves the API key from `input.env?.ELEVENLABS_API_KEY ?? process.env.ELEVENLABS_API_KEY`.
+ *   - Treats `input.voice` as an ElevenLabs **voice_id** (defaults to "Rachel"),
+ *     and uses the `eleven_multilingual_v2` model.
+ *   - Writes the returned mp3 bytes to `outputPath`.
+ *   - Returns `durationMs` ESTIMATED from text length (~14 chars/sec). ElevenLabs
+ *     returns compressed mp3 with no duration field, and we avoid a spawn
+ *     (ffprobe) to keep this backend pure + offline-testable. Callers that need
+ *     exact timing (e.g. narration-fit) probe the written file themselves.
+ *   - On dry-run: creates the output directory and writes a zero-byte
+ *     placeholder mp3; does NOT touch the network.
+ *   - On missing key / non-2xx / empty body: throws VclawError('tts_failed').
+ *
+ * Availability (registry): `ELEVENLABS_API_KEY` set and non-empty.
+ */
+import { mkdir, writeFile } from 'node:fs/promises';
+import { dirname } from 'node:path';
+import { VclawError } from '../errors.js';
+const ELEVENLABS_TTS_BASE_URL = 'https://api.elevenlabs.io/v1/text-to-speech';
+const TTS_MODEL = 'eleven_multilingual_v2';
+/** Stable default ElevenLabs voice ("Rachel") when the caller passes no voice. */
+const DEFAULT_VOICE_ID = '21m00Tcm4TlvDq8ikWAM';
+/** Chars-per-second heuristic for duration estimation (~14 cps speech). */
+const CHARS_PER_SEC = 14;
+function resolveApiKey(env) {
+    const key = env?.ELEVENLABS_API_KEY ?? process.env.ELEVENLABS_API_KEY;
+    return key && key.trim() !== '' ? key.trim() : undefined;
+}
+function estimateDurationMs(text) {
+    return Math.round((Math.max(1, text.trim().length / CHARS_PER_SEC)) * 1000);
+}
+export const elevenLabsTts = {
+    id: 'elevenlabs-tts',
+    kind: 'tts',
+    outputExtension: 'mp3',
+    displayName: 'ElevenLabs TTS (eleven_multilingual_v2)',
+    requiredEnv: ['ELEVENLABS_API_KEY'],
+    requiresVertex: false,
+    summary: 'Single-speaker text-to-speech via the ElevenLabs API (eleven_multilingual_v2). Returns mp3. `--voice` is an ElevenLabs voice_id (default "Rachel"). Requires ELEVENLABS_API_KEY. A Gemini-free alternative to gemini-tts.',
+    async generate(input) {
+        if (!input.text || !input.text.trim()) {
+            throw new VclawError('tts_failed', 'Cannot synthesize narration from empty text.', {
+                backendId: 'elevenlabs-tts',
+            });
+        }
+        const durationMs = estimateDurationMs(input.text);
+        // Dry-run: create directory + write zero-byte placeholder; no network.
+        if (input.dryRun) {
+            await mkdir(dirname(input.outputPath), { recursive: true });
+            await writeFile(input.outputPath, new Uint8Array(0));
+            return { path: input.outputPath, durationMs, backendId: 'elevenlabs-tts' };
+        }
+        const apiKey = resolveApiKey(input.env);
+        if (!apiKey) {
+            throw new VclawError('tts_failed', 'ElevenLabs TTS: ELEVENLABS_API_KEY is not set. Export it before generating narration.', { backendId: 'elevenlabs-tts', envVar: 'ELEVENLABS_API_KEY' });
+        }
+        const voiceId = input.voice && input.voice.trim() ? input.voice.trim() : DEFAULT_VOICE_ID;
+        const doFetch = input.fetcher ?? fetch;
+        const response = await doFetch(`${ELEVENLABS_TTS_BASE_URL}/${encodeURIComponent(voiceId)}`, {
+            method: 'POST',
+            headers: {
+                'xi-api-key': apiKey,
+                'Content-Type': 'application/json',
+                Accept: 'audio/mpeg',
+            },
+            body: JSON.stringify({ text: input.text.trim(), model_id: TTS_MODEL }),
+        });
+        if (!response.ok) {
+            const body = await response.text().catch(() => '');
+            throw new VclawError('tts_failed', `ElevenLabs TTS request failed with HTTP ${response.status}.`, { backendId: 'elevenlabs-tts', status: response.status, body: body.slice(0, 500) });
+        }
+        const bytes = new Uint8Array(await response.arrayBuffer());
+        if (bytes.length === 0) {
+            throw new VclawError('tts_failed', 'ElevenLabs TTS returned an empty audio payload.', {
+                backendId: 'elevenlabs-tts',
+            });
+        }
+        await mkdir(dirname(input.outputPath), { recursive: true });
+        await writeFile(input.outputPath, bytes);
+        return { path: input.outputPath, durationMs, backendId: 'elevenlabs-tts' };
+    },
+};
+//# sourceMappingURL=native-elevenlabs-tts.js.map

package/dist/video/audio-platform/native-elevenlabs-tts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-elevenlabs-tts.js","sourceRoot":"","sources":["../../../src/video/audio-platform/native-elevenlabs-tts.ts"],"names":[],"mappings":"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"}