videoclaw 3.0.0-alpha.1

package/dist/video/motion-overlay/slice.js

@@ -0,0 +1,88 @@
+/**
+ * Pure take-slicing.
+ *
+ * Omni Flash has a hard ~10s-per-clip limit, so a longer talking-head video is
+ * sliced into takes ≤ maxTakeSeconds, cutting only at sentence (segment)
+ * boundaries — never mid-segment — so the joined reel reads cleanly.
+ *
+ * Algorithm (ported from the source skill, Step 5):
+ *  1. Iterate transcript segments, accumulating into the current take while
+ *     `segment.end - takeStart <= max`.
+ *  2. When the next segment would overrun `max`, close the current take at the
+ *     last accumulated segment's end and start a fresh take at that segment.
+ *  3. Edge case: a single segment whose own duration exceeds `max` becomes its
+ *     own take with a HARD CUT at exactly `takeStart + max` (the only place a
+ *     cut lands mid-segment — unavoidable when one breath runs > max).
+ *
+ * Pure: no I/O. Deterministic for a given transcript + max.
+ */
+const EPSILON = 1e-9;
+/**
+ * Group transcript segments into takes ≤ maxTakeSeconds at sentence boundaries.
+ *
+ * @param transcript segments with absolute start/end seconds (must be ordered).
+ * @param maxTakeSeconds Omni hard limit per clip (must be > 0).
+ * @returns ordered `TakeSplit[]` with absolute start/end + the segment indices
+ *          each take covers. Empty transcript → `[]`.
+ */
+export function planSplits(transcript, maxTakeSeconds) {
+    if (!(maxTakeSeconds > 0)) {
+        throw new Error(`planSplits: maxTakeSeconds must be > 0, got ${maxTakeSeconds}`);
+    }
+    const segments = transcript.segments;
+    if (segments.length === 0) {
+        return [];
+    }
+    const splits = [];
+    let takeStart = null;
+    let takeEnd = 0;
+    let segmentIndices = [];
+    const closeTake = (end) => {
+        if (takeStart === null) {
+            return;
+        }
+        splits.push({
+            index: splits.length,
+            start: takeStart,
+            end,
+            segmentIndices,
+        });
+        takeStart = null;
+        segmentIndices = [];
+    };
+    for (let i = 0; i < segments.length; i++) {
+        const seg = segments[i];
+        if (takeStart === null) {
+            // Start a new take at this segment.
+            const segDuration = seg.end - seg.start;
+            if (segDuration > maxTakeSeconds + EPSILON) {
+                // A single segment longer than the cap: it must stand alone with a
+                // HARD CUT at exactly start + max (the one place we cut mid-segment).
+                splits.push({
+                    index: splits.length,
+                    start: seg.start,
+                    end: seg.start + maxTakeSeconds,
+                    segmentIndices: [i],
+                });
+                continue;
+            }
+            takeStart = seg.start;
+            takeEnd = seg.end;
+            segmentIndices = [i];
+            continue;
+        }
+        // We have an open take; would adding this segment overrun the cap?
+        if (seg.end - takeStart <= maxTakeSeconds + EPSILON) {
+            takeEnd = seg.end;
+            segmentIndices.push(i);
+            continue;
+        }
+        // Overrun: close the current take, then re-process this segment as the
+        // start of a fresh take (handles the oversized-segment edge case too).
+        closeTake(takeEnd);
+        i -= 1;
+    }
+    closeTake(takeEnd);
+    return splits;
+}
+//# sourceMappingURL=slice.js.map

package/dist/video/motion-overlay/slice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slice.js","sourceRoot":"","sources":["../../../src/video/motion-overlay/slice.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,MAAM,OAAO,GAAG,IAAI,CAAC;AAErB;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CAAC,UAAsB,EAAE,cAAsB;IACvE,IAAI,CAAC,CAAC,cAAc,GAAG,CAAC,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,+CAA+C,cAAc,EAAE,CAAC,CAAC;IACnF,CAAC;IACD,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAC;IACrC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,MAAM,GAAgB,EAAE,CAAC;IAC/B,IAAI,SAAS,GAAkB,IAAI,CAAC;IACpC,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,cAAc,GAAa,EAAE,CAAC;IAElC,MAAM,SAAS,GAAG,CAAC,GAAW,EAAQ,EAAE;QACtC,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;YACvB,OAAO;QACT,CAAC;QACD,MAAM,CAAC,IAAI,CAAC;YACV,KAAK,EAAE,MAAM,CAAC,MAAM;YACpB,KAAK,EAAE,SAAS;YAChB,GAAG;YACH,cAAc;SACf,CAAC,CAAC;QACH,SAAS,GAAG,IAAI,CAAC;QACjB,cAAc,GAAG,EAAE,CAAC;IACtB,CAAC,CAAC;IAEF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACzC,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QAExB,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;YACvB,oCAAoC;YACpC,MAAM,WAAW,GAAG,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC;YACxC,IAAI,WAAW,GAAG,cAAc,GAAG,OAAO,EAAE,CAAC;gBAC3C,mEAAmE;gBACnE,sEAAsE;gBACtE,MAAM,CAAC,IAAI,CAAC;oBACV,KAAK,EAAE,MAAM,CAAC,MAAM;oBACpB,KAAK,EAAE,GAAG,CAAC,KAAK;oBAChB,GAAG,EAAE,GAAG,CAAC,KAAK,GAAG,cAAc;oBAC/B,cAAc,EAAE,CAAC,CAAC,CAAC;iBACpB,CAAC,CAAC;gBACH,SAAS;YACX,CAAC;YACD,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC;YACtB,OAAO,GAAG,GAAG,CAAC,GAAG,CAAC;YAClB,cAAc,GAAG,CAAC,CAAC,CAAC,CAAC;YACrB,SAAS;QACX,CAAC;QAED,mEAAmE;QACnE,IAAI,GAAG,CAAC,GAAG,GAAG,SAAS,IAAI,cAAc,GAAG,OAAO,EAAE,CAAC;YACpD,OAAO,GAAG,GAAG,CAAC,GAAG,CAAC;YAClB,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACvB,SAAS;QACX,CAAC;QAED,uEAAuE;QACvE,uEAAuE;QACvE,SAAS,CAAC,OAAO,CAAC,CAAC;QACnB,CAAC,IAAI,CAAC,CAAC;IACT,CAAC;IAED,SAAS,CAAC,OAAO,CAAC,CAAC;IACnB,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/video/motion-overlay/transcribe.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Gemini STT for motion-overlay.
+ *
+ * `transcribeAudio` turns an audio file into a `Transcript` (segment-level
+ * start/end/text) via the Gemini API, reusing the `gemini-key-pool` round-robin
+ * + retry plumbing. The transport is injectable (`deps.fetcher`) so tests never
+ * touch the network; a `deps.transcriber` override replaces the whole live path.
+ *
+ * The `--transcript <path>` operator override is handled by `loadTranscript`,
+ * which loads + validates a bring-your-own transcript JSON of the same shape.
+ *
+ * Side-effect: reads the audio file + calls the Gemini API. Kept thin — the
+ * shaping/validation is pure and unit-testable.
+ */
+import type { Transcript } from './types.js';
+/** A pluggable transcriber. Tests inject this to avoid the live Gemini path. */
+export type TranscriberFn = (audioPath: string, language: string) => Promise<Transcript>;
+export interface TranscribeDeps {
+    /** Replace the whole live transcription path (highest precedence). */
+    transcriber?: TranscriberFn;
+    /** Inject a fetch for the live Gemini path (used when no transcriber given). */
+    fetcher?: typeof fetch;
+    /** Override the Gemini endpoint (falls back to env then the default). */
+    endpoint?: string;
+}
+/**
+ * Validate + normalize an unknown value into a `Transcript`. Throws on any shape
+ * violation. Pure — shared by the live path and the `--transcript` loader so the
+ * contract is enforced in exactly one place.
+ */
+export declare function validateTranscript(value: unknown, source?: string): Transcript;
+/**
+ * Load + validate a bring-your-own transcript JSON (`--transcript <path>`).
+ * Throws on a missing/unreadable file or a shape violation.
+ */
+export declare function loadTranscript(path: string): Promise<Transcript>;
+/**
+ * Transcribe an audio file into a `Transcript`.
+ *
+ * Precedence:
+ *  1. `deps.transcriber` — full override (tests inject this; no network).
+ *  2. live Gemini STT via `fetchGeminiWithPool` (uses `deps.fetcher` if given).
+ *
+ * @param audioPath path to the extracted audio clip.
+ * @param language requested language hint ("auto" lets Gemini detect); the
+ *   returned transcript's `language` reflects the model's detection.
+ */
+export declare function transcribeAudio(audioPath: string, language: string, deps?: TranscribeDeps): Promise<Transcript>;
+//# sourceMappingURL=transcribe.d.ts.map

package/dist/video/motion-overlay/transcribe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcribe.d.ts","sourceRoot":"","sources":["../../../src/video/motion-overlay/transcribe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAqB,MAAM,YAAY,CAAC;AAiBhE,gFAAgF;AAChF,MAAM,MAAM,aAAa,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;AAEzF,MAAM,WAAW,cAAc;IAC7B,sEAAsE;IACtE,WAAW,CAAC,EAAE,aAAa,CAAC;IAC5B,gFAAgF;IAChF,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;IACvB,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAkCD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,SAAe,GAAG,UAAU,CA4BpF;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CActE;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,eAAe,CACnC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,cAAmB,GACxB,OAAO,CAAC,UAAU,CAAC,CA6DrB"}

package/dist/video/motion-overlay/transcribe.js

@@ -0,0 +1,180 @@
+/**
+ * Gemini STT for motion-overlay.
+ *
+ * `transcribeAudio` turns an audio file into a `Transcript` (segment-level
+ * start/end/text) via the Gemini API, reusing the `gemini-key-pool` round-robin
+ * + retry plumbing. The transport is injectable (`deps.fetcher`) so tests never
+ * touch the network; a `deps.transcriber` override replaces the whole live path.
+ *
+ * The `--transcript <path>` operator override is handled by `loadTranscript`,
+ * which loads + validates a bring-your-own transcript JSON of the same shape.
+ *
+ * Side-effect: reads the audio file + calls the Gemini API. Kept thin — the
+ * shaping/validation is pure and unit-testable.
+ */
+import { readFile } from 'node:fs/promises';
+import { extname } from 'node:path';
+import { fetchGeminiWithPool } from '../gemini-key-pool.js';
+const DEFAULT_STT_ENDPOINT = 'https://generativelanguage.googleapis.com/v1beta/models/gemini-3.5-flash:generateContent';
+const STT_PROMPT = `You transcribe a single short spoken-word audio clip into timed segments.
+
+Return ONLY valid JSON with this exact shape (no markdown fences):
+{ "language": "<bcp-47 code>", "segments": [ { "start": <seconds>, "end": <seconds>, "text": "<sentence>" } ] }
+
+Rules:
+- One segment per spoken sentence or natural breath group.
+- start/end are absolute seconds from the clip's 0:00, increasing, non-overlapping.
+- text is the spoken words verbatim, no speaker labels, no timestamps inside the text.
+- language is the detected spoken language as a BCP-47 code (e.g. "en", "pt", "es").
+- Do not invent content; transcribe only what is spoken.`;
+/** Map an audio file extension to a Gemini inlineData mime type. */
+function audioMimeType(audioPath) {
+    switch (extname(audioPath).toLowerCase()) {
+        case '.mp3':
+            return 'audio/mp3';
+        case '.aac':
+            return 'audio/aac';
+        case '.m4a':
+            return 'audio/mp4';
+        case '.flac':
+            return 'audio/flac';
+        case '.ogg':
+            return 'audio/ogg';
+        case '.wav':
+        default:
+            return 'audio/wav';
+    }
+}
+/** Pull the joined text parts out of a Gemini generateContent response. */
+function parseGeminiText(payload) {
+    const candidates = payload.candidates;
+    const text = candidates?.[0]?.content?.parts
+        ?.map((part) => part.text ?? '')
+        .join('\n')
+        .trim();
+    if (!text) {
+        throw new Error('Gemini STT response did not contain text output.');
+    }
+    return text;
+}
+/**
+ * Validate + normalize an unknown value into a `Transcript`. Throws on any shape
+ * violation. Pure — shared by the live path and the `--transcript` loader so the
+ * contract is enforced in exactly one place.
+ */
+export function validateTranscript(value, source = 'transcript') {
+    if (!value || typeof value !== 'object') {
+        throw new Error(`${source}: expected an object with { language, segments }.`);
+    }
+    const obj = value;
+    if (typeof obj.language !== 'string' || obj.language.trim() === '') {
+        throw new Error(`${source}: "language" must be a non-empty string.`);
+    }
+    if (!Array.isArray(obj.segments)) {
+        throw new Error(`${source}: "segments" must be an array.`);
+    }
+    const segments = obj.segments.map((raw, i) => {
+        if (!raw || typeof raw !== 'object') {
+            throw new Error(`${source}: segment ${i} is not an object.`);
+        }
+        const seg = raw;
+        if (typeof seg.start !== 'number' || !Number.isFinite(seg.start) || seg.start < 0) {
+            throw new Error(`${source}: segment ${i} "start" must be a finite, non-negative number.`);
+        }
+        if (typeof seg.end !== 'number' || !Number.isFinite(seg.end) || seg.end < seg.start) {
+            throw new Error(`${source}: segment ${i} "end" must be a finite number >= start.`);
+        }
+        if (typeof seg.text !== 'string') {
+            throw new Error(`${source}: segment ${i} "text" must be a string.`);
+        }
+        return { start: seg.start, end: seg.end, text: seg.text };
+    });
+    return { language: obj.language.trim(), segments };
+}
+/**
+ * Load + validate a bring-your-own transcript JSON (`--transcript <path>`).
+ * Throws on a missing/unreadable file or a shape violation.
+ */
+export async function loadTranscript(path) {
+    let raw;
+    try {
+        raw = await readFile(path, 'utf-8');
+    }
+    catch (err) {
+        throw new Error(`--transcript file not readable: ${path} (${err.message})`);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (err) {
+        throw new Error(`--transcript file is not valid JSON: ${path} (${err.message})`);
+    }
+    return validateTranscript(parsed, `--transcript ${path}`);
+}
+/**
+ * Transcribe an audio file into a `Transcript`.
+ *
+ * Precedence:
+ *  1. `deps.transcriber` — full override (tests inject this; no network).
+ *  2. live Gemini STT via `fetchGeminiWithPool` (uses `deps.fetcher` if given).
+ *
+ * @param audioPath path to the extracted audio clip.
+ * @param language requested language hint ("auto" lets Gemini detect); the
+ *   returned transcript's `language` reflects the model's detection.
+ */
+export async function transcribeAudio(audioPath, language, deps = {}) {
+    if (deps.transcriber) {
+        return deps.transcriber(audioPath, language);
+    }
+    const endpoint = deps.endpoint ?? process.env.VCLAW_GEMINI_API_ENDPOINT ?? DEFAULT_STT_ENDPOINT;
+    const audioBytes = await readFile(audioPath);
+    const audioData = audioBytes.toString('base64');
+    const mimeType = audioMimeType(audioPath);
+    const languageHint = language && language.toLowerCase() !== 'auto'
+        ? `\nThe spoken language is "${language}"; transcribe in that language.`
+        : '';
+    const response = await fetchGeminiWithPool((key) => `${endpoint}${endpoint.includes('?') ? '&' : '?'}key=${encodeURIComponent(key)}`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json', Connection: 'close' },
+        body: JSON.stringify({
+            contents: [
+                {
+                    parts: [
+                        { inlineData: { mimeType, data: audioData } },
+                        { text: `${STT_PROMPT}${languageHint}` },
+                    ],
+                },
+            ],
+            generationConfig: {
+                temperature: 0,
+                maxOutputTokens: 2048,
+                responseMimeType: 'application/json',
+            },
+        }),
+    }, {
+        ...(deps.fetcher ? { fetcher: deps.fetcher } : {}),
+        onRetry: (label, status) => {
+            process.stderr.write(`[motion-overlay/stt] ${label} returned HTTP ${status}; rotating key\n`);
+        },
+    });
+    if (!response.ok) {
+        throw new Error(`Gemini STT request failed with HTTP ${response.status}`);
+    }
+    const payload = await response.json();
+    const text = parseGeminiText(payload);
+    const cleaned = text
+        .replace(/^```json\s*/i, '')
+        .replace(/^```\s*/i, '')
+        .replace(/\s*```$/i, '')
+        .trim();
+    let parsed;
+    try {
+        parsed = JSON.parse(cleaned);
+    }
+    catch (err) {
+        throw new Error(`Gemini STT returned unparseable JSON: ${err.message}`);
+    }
+    return validateTranscript(parsed, 'Gemini STT');
+}
+//# sourceMappingURL=transcribe.js.map

package/dist/video/motion-overlay/transcribe.js.map

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

package/dist/video/motion-overlay/types.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Motion-overlay shared type contract.
+ *
+ * This is the binding contract for the whole `motion-overlay/` module family.
+ * Every pure module (slice, analyze-reel, motion-style, compose-prompt, plan)
+ * and every side-effect module (transcribe, ingest, write, preview, execute,
+ * avatar-host) speaks these types. Keep it in lockstep with
+ * `schemas/video/artifacts/motion-overlay-plan.schema.json` and the design/plan
+ * specs under `docs/superpowers/specs/`.
+ */
+export type MotionLayout = 'split' | 'overlay' | 'motion-only' | 'avatar-host';
+export type MotionStyleId = 'apple-clean' | 'editorial-dark' | 'knowledge-tool';
+export type ReelAnatomy = 'hook' | 'contextualize' | 'burst' | 'breath' | 'cta';
+export interface TranscriptSegment {
+    start: number;
+    end: number;
+    text: string;
+}
+export interface Transcript {
+    language: string;
+    segments: TranscriptSegment[];
+}
+export interface TakeSplit {
+    index: number;
+    start: number;
+    end: number;
+    segmentIndices: number[];
+}
+export type AnchorKind = 'number' | 'verb' | 'entity' | 'keyword';
+export interface AnchorWord {
+    word: string;
+    kind: AnchorKind;
+    relativeTime: number;
+}
+export interface TakePause {
+    start: number;
+    end: number;
+}
+export interface TakeAnalysis {
+    index: number;
+    anatomy: ReelAnatomy;
+    anchorWords: AnchorWord[];
+    pauses: TakePause[];
+}
+export interface ResolvedStyle {
+    id: MotionStyleId;
+    accent: string;
+    visualBlock: string;
+    motionBlock: string;
+}
+export interface FrameObservations {
+    speakerSide?: 'left' | 'right' | 'center';
+    notes: string[];
+}
+export interface MotionTake {
+    index: number;
+    start: number;
+    end: number;
+    durationSeconds: number;
+    file: string;
+    promptFile: string;
+    anatomy: ReelAnatomy;
+    prompt: string;
+}
+export interface MotionOverlayPlan {
+    schemaVersion: 1;
+    input: {
+        path: string;
+        durationSeconds: number;
+        width: number;
+        height: number;
+        aspect: '16:9' | '9:16' | '1:1' | string;
+    };
+    layout: MotionLayout;
+    style: MotionStyleId;
+    accent: string;
+    language: string;
+    workdir: string;
+    takes: MotionTake[];
+    generatedAt?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/video/motion-overlay/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/video/motion-overlay/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,SAAS,GAAG,aAAa,GAAG,aAAa,CAAC;AAC/E,MAAM,MAAM,aAAa,GAAG,aAAa,GAAG,gBAAgB,GAAG,gBAAgB,CAAC;AAChF,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,eAAe,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;AAEhF,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACd;AACD,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,iBAAiB,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;AAClE,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB;AACD,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AACD,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,WAAW,CAAC;IACrB,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,MAAM,EAAE,SAAS,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,aAAa,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC1C,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,WAAW,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,CAAC,CAAC;IACjB,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,eAAe,EAAE,MAAM,CAAC;QACxB,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC;KAC1C,CAAC;IACF,MAAM,EAAE,YAAY,CAAC;IACrB,KAAK,EAAE,aAAa,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB"}

package/dist/video/motion-overlay/types.js

@@ -0,0 +1,12 @@
+/**
+ * Motion-overlay shared type contract.
+ *
+ * This is the binding contract for the whole `motion-overlay/` module family.
+ * Every pure module (slice, analyze-reel, motion-style, compose-prompt, plan)
+ * and every side-effect module (transcribe, ingest, write, preview, execute,
+ * avatar-host) speaks these types. Keep it in lockstep with
+ * `schemas/video/artifacts/motion-overlay-plan.schema.json` and the design/plan
+ * specs under `docs/superpowers/specs/`.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/video/motion-overlay/types.js.map

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

package/dist/video/motion-overlay/v2v-transport.d.ts

@@ -0,0 +1,37 @@
+import type { MotionOverlayV2VStep } from './execute.js';
+export interface FlowV2VConfig {
+    token: string;
+    email: string;
+    base?: string;
+    maxAttempts?: number;
+    pollIntervalMs?: number;
+    pollTimeoutMs?: number;
+    /** Injectable fetch (tests). Defaults to the global `fetch`. */
+    fetcher?: typeof fetch;
+}
+/**
+ * Read the useapi.net credentials from the environment. Throws a clear,
+ * actionable error when they are absent (so `--execute` fails fast rather than
+ * silently producing nothing).
+ */
+export declare function flowV2VConfigFromEnv(env?: NodeJS.ProcessEnv): FlowV2VConfig;
+/** Pure: build the POST /videos request body for an omni-flash V2V edit. */
+export declare function buildV2VRequestBody(args: {
+    prompt: string;
+    referenceVideoId: string;
+    frames: number;
+    aspect: string;
+    email: string;
+}): Record<string, unknown>;
+/** Pure: pull the job id from a submit response — the API returns `jobid`, some paths `jobId`. */
+export declare function extractJobId(payload: unknown): string | undefined;
+/** Pure: pull the first completed videoUrl out of a poll response. */
+export declare function extractVideoUrl(payload: unknown): string | undefined;
+/** Pure: extract a compact moderation/failure reason from a failed poll payload. */
+export declare function extractFailureReason(payload: unknown): string;
+/**
+ * Build the live omni-flash V2V transport. The returned function uploads the
+ * take, submits the edit, polls, and writes the annotated take to `outputPath`.
+ */
+export declare function createFlowV2VTransport(cfg: FlowV2VConfig): (step: MotionOverlayV2VStep) => Promise<void>;
+//# sourceMappingURL=v2v-transport.d.ts.map

package/dist/video/motion-overlay/v2v-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"v2v-transport.d.ts","sourceRoot":"","sources":["../../../src/video/motion-overlay/v2v-transport.ts"],"names":[],"mappings":"AAgCA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAKzD,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gEAAgE;IAChE,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;CACxB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,aAAa,CAUxF;AAED,4EAA4E;AAC5E,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAW1B;AAED,kGAAkG;AAClG,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAIjE;AAED,sEAAsE;AACtE,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAIpE;AAED,oFAAoF;AACpF,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAO7D;AA2BD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,aAAa,GAAG,CAAC,IAAI,EAAE,oBAAoB,KAAK,OAAO,CAAC,IAAI,CAAC,CAsExG"}

package/dist/video/motion-overlay/v2v-transport.js

@@ -0,0 +1,178 @@
+/**
+ * Real Google Flow omni-flash V2V transport for the standalone motion-overlay
+ * default runner (the per-take seam injected into {@link createDefaultMotionOverlayRunner}).
+ *
+ * Per take it: uploads the base footage as a Flow asset (referenceVideo_1),
+ * submits an omni-flash video-to-video edit with the composed prompt + a
+ * frame-window, polls the job to completion, and downloads the annotated take to
+ * `outputPath`. The audio-restore mux and the clip-stitch are handled by the
+ * surrounding default runner — this module is ONLY the V2V edit.
+ *
+ * Proven recipe (validated live against useapi.net 2026-06-05):
+ *  - upload:  POST {base}/assets/{email}  (Content-Type: video/mp4, raw bytes)
+ *             → { mediaGenerationId: { mediaGenerationId } }
+ *  - submit:  POST {base}/videos { model:'omni-flash', prompt, referenceVideo_1,
+ *             startFrameIndex_1:0, endFrameIndex_1:<frames>, aspectRatio, email,
+ *             async:true } → { jobid }   (NOTE: the field is `jobid`, lowercase i)
+ *  - poll:    GET  {base}/jobs/{jobId}   (jobId passed RAW — do NOT URL-encode it)
+ *             → status created → completed | failed
+ *  - result:  response.media[].videoUrl
+ *
+ * The Flow safety filter (PUBLIC_ERROR_UNSAFE_GENERATION / FINISH_REASON_INPUT_VIDEO_EDIT)
+ * is probabilistic AND input-video-specific (it rejects some source clips for
+ * editing regardless of how benign the prompt is), so a `failed` verdict is
+ * retried a few times before giving up with an actionable message.
+ *
+ * The network path is intentionally an injectable seam (`fetcher`); the pure
+ * request-shaping helpers below are unit-tested.
+ */
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { dirname } from 'node:path';
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+const execFileP = promisify(execFile);
+const FLOW_BASE = 'https://api.useapi.net/v1/google-flow';
+/**
+ * Read the useapi.net credentials from the environment. Throws a clear,
+ * actionable error when they are absent (so `--execute` fails fast rather than
+ * silently producing nothing).
+ */
+export function flowV2VConfigFromEnv(env = process.env) {
+    const token = env.USEAPI_API_TOKEN;
+    const email = env.USEAPI_ACCOUNT_EMAIL;
+    if (!token || !email) {
+        throw new Error('motion-overlay --execute requires USEAPI_API_TOKEN and USEAPI_ACCOUNT_EMAIL in the environment — ' +
+            'the omni-flash V2V transport uploads each take to Google Flow via useapi.net. Export them (e.g. from .env) and retry.');
+    }
+    return { token, email };
+}
+/** Pure: build the POST /videos request body for an omni-flash V2V edit. */
+export function buildV2VRequestBody(args) {
+    return {
+        model: 'omni-flash',
+        prompt: args.prompt,
+        referenceVideo_1: args.referenceVideoId,
+        startFrameIndex_1: 0,
+        endFrameIndex_1: args.frames,
+        aspectRatio: args.aspect,
+        email: args.email,
+        async: true,
+    };
+}
+/** Pure: pull the job id from a submit response — the API returns `jobid`, some paths `jobId`. */
+export function extractJobId(payload) {
+    const p = payload;
+    const id = p?.jobId ?? p?.jobid;
+    return typeof id === 'string' && id.length > 0 ? id : undefined;
+}
+/** Pure: pull the first completed videoUrl out of a poll response. */
+export function extractVideoUrl(payload) {
+    const media = payload?.response?.media;
+    const url = media?.find((m) => typeof m.videoUrl === 'string' && m.videoUrl)?.videoUrl;
+    return typeof url === 'string' ? url : undefined;
+}
+/** Pure: extract a compact moderation/failure reason from a failed poll payload. */
+export function extractFailureReason(payload) {
+    return (JSON.stringify(payload?.response ?? payload)
+        .match(/PUBLIC_ERROR_\w+|FINISH_REASON_\w+/g)
+        ?.slice(0, 3)
+        ?.join(', ') ?? 'unknown');
+}
+/** A `failed` verdict from the Flow safety filter (retryable — it is probabilistic). */
+class V2VModerationError extends Error {
+}
+function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/** ffprobe the clip for an integer frame count + aspect (24fps + landscape fallback). */
+async function probeVideo(path) {
+    try {
+        const [{ stdout: wh }, { stdout: dur }] = await Promise.all([
+            execFileP('ffprobe', ['-v', 'error', '-select_streams', 'v:0', '-show_entries', 'stream=width,height', '-of', 'csv=p=0', path]),
+            execFileP('ffprobe', ['-v', 'error', '-show_entries', 'format=duration', '-of', 'default=nk=1:nw=1', path]),
+        ]);
+        const [w, h] = wh.trim().split(',').map(Number);
+        const d = Number(dur.trim());
+        return {
+            frames: Math.max(1, Math.round((Number.isFinite(d) ? d : 5) * 24)),
+            aspect: w >= h ? 'landscape' : 'portrait',
+        };
+    }
+    catch {
+        return { frames: 120, aspect: 'landscape' };
+    }
+}
+/**
+ * Build the live omni-flash V2V transport. The returned function uploads the
+ * take, submits the edit, polls, and writes the annotated take to `outputPath`.
+ */
+export function createFlowV2VTransport(cfg) {
+    const base = cfg.base ?? FLOW_BASE;
+    const doFetch = cfg.fetcher ?? fetch;
+    const auth = { Authorization: `Bearer ${cfg.token}` };
+    const maxAttempts = cfg.maxAttempts ?? 3;
+    const pollIntervalMs = cfg.pollIntervalMs ?? 20000;
+    const pollTimeoutMs = cfg.pollTimeoutMs ?? 8 * 60 * 1000;
+    async function poll(jobId) {
+        const deadline = Date.now() + pollTimeoutMs;
+        while (Date.now() < deadline) {
+            await delay(pollIntervalMs);
+            const res = await doFetch(`${base}/jobs/${jobId}`, { headers: auth }); // RAW jobId — do NOT encode
+            const pj = (await res.json().catch(() => ({})));
+            if (pj.status === 'completed') {
+                const url = extractVideoUrl(pj);
+                if (url)
+                    return url;
+                throw new Error('motion-overlay V2V completed but the response carried no videoUrl.');
+            }
+            if (pj.status === 'failed') {
+                throw new V2VModerationError(extractFailureReason(pj));
+            }
+        }
+        throw new Error('motion-overlay V2V poll timed out.');
+    }
+    return async (step) => {
+        const bytes = await readFile(step.baseFootage);
+        const up = await doFetch(`${base}/assets/${encodeURIComponent(cfg.email)}`, {
+            method: 'POST',
+            headers: { ...auth, 'Content-Type': 'video/mp4' },
+            body: bytes,
+        });
+        const upJson = (await up.json().catch(() => ({})));
+        const referenceVideoId = upJson?.mediaGenerationId?.mediaGenerationId;
+        if (!referenceVideoId) {
+            throw new Error(`motion-overlay V2V upload failed (HTTP ${up.status}) for take ${step.index}.`);
+        }
+        const { frames, aspect } = await probeVideo(step.baseFootage);
+        let lastReason = '';
+        for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+            const gen = await doFetch(`${base}/videos`, {
+                method: 'POST',
+                headers: { ...auth, 'Content-Type': 'application/json' },
+                body: JSON.stringify(buildV2VRequestBody({ prompt: step.prompt, referenceVideoId, frames, aspect, email: cfg.email })),
+            });
+            const jobId = extractJobId(await gen.json().catch(() => ({})));
+            if (!jobId) {
+                lastReason = `submit returned HTTP ${gen.status} with no job id`;
+                continue;
+            }
+            try {
+                const url = await poll(jobId);
+                const dl = await doFetch(url);
+                await mkdir(dirname(step.outputPath), { recursive: true });
+                await writeFile(step.outputPath, Buffer.from(await dl.arrayBuffer()));
+                return;
+            }
+            catch (err) {
+                lastReason = err.message;
+                if (err instanceof V2VModerationError)
+                    continue; // probabilistic — retry
+                throw err; // timeout / transport / no-url — fail fast
+            }
+        }
+        throw new Error(`motion-overlay V2V failed for take ${step.index} after ${maxAttempts} attempt(s): ${lastReason}. ` +
+            'The Google Flow safety filter rejects some input videos for editing (FINISH_REASON_INPUT_VIDEO_EDIT) ' +
+            'regardless of prompt — try a different, more stylized source clip.');
+    };
+}
+//# sourceMappingURL=v2v-transport.js.map