venice-video-harness 2.4.0

package/dist/editing/packer.js

@@ -0,0 +1,170 @@
+/**
+ * Packer: collapses word streams into phrases and renders takes_packed.md.
+ *
+ * The pack is the primary LLM surface for editing. Keep it compact — target
+ * ~12KB per 40 minutes of source audio. The format matches the one used by
+ * browser-use/video-use so experience across projects transfers directly.
+ *
+ * Phrase boundary heuristics, in order:
+ *   1. Gap between consecutive words > `silenceGapSec` (default 0.45s)
+ *   2. Hard sentence punctuation followed by any gap (. ! ?)
+ *   3. Soft punctuation (, ; :) only when followed by > 0.30s gap
+ */
+import { createHash } from 'node:crypto';
+import { writeFileSync, mkdirSync } from 'node:fs';
+import { dirname, basename, extname } from 'node:path';
+const DEFAULT_OPTIONS = {
+    silenceGapSec: 0.45,
+    maxPhraseSec: 12.0,
+    minPhraseChars: 4,
+};
+/**
+ * Derive a stable 5-char hex id (e.g. `C0103`) from the file path. The
+ * leading `C` matches video-use's naming. Stable across runs so EDLs
+ * survive re-transcription.
+ */
+export function deriveTakeId(file, ordinal) {
+    const hash = createHash('sha1').update(file).digest('hex');
+    // Use first 4 hex chars + ordinal to avoid collisions on very large source folders.
+    const prefix = hash.slice(0, 4).toUpperCase();
+    return `C${prefix.slice(0, 3)}${String(ordinal).padStart(1, '0')}`;
+}
+function groupWordsIntoPhrases(words, speaker, options) {
+    if (words.length === 0)
+        return [];
+    const phrases = [];
+    let current = [words[0]];
+    const pushPhrase = () => {
+        if (current.length === 0)
+            return;
+        const startSec = current[0].startSec;
+        const endSec = current[current.length - 1].endSec;
+        const text = current.map((w) => w.word).join(' ').replace(/\s+([,.!?;:])/g, '$1').trim();
+        phrases.push({
+            speaker,
+            startSec,
+            endSec,
+            text,
+            words: current,
+        });
+        current = [];
+    };
+    for (let i = 1; i < words.length; i++) {
+        const prev = words[i - 1];
+        const w = words[i];
+        const gap = w.startSec - prev.endSec;
+        const prevText = prev.word.trim();
+        const endsHard = /[.!?]$/.test(prevText);
+        const endsSoft = /[,;:]$/.test(prevText);
+        const phraseDur = w.startSec - current[0].startSec;
+        const boundary = gap >= options.silenceGapSec ||
+            (endsHard && gap >= 0.08) ||
+            (endsSoft && gap >= 0.30) ||
+            phraseDur >= options.maxPhraseSec;
+        if (boundary) {
+            pushPhrase();
+        }
+        current.push(w);
+    }
+    pushPhrase();
+    // Merge fragments shorter than minPhraseChars into the following phrase.
+    const merged = [];
+    for (const p of phrases) {
+        if (p.text.length < options.minPhraseChars && merged.length > 0) {
+            const last = merged[merged.length - 1];
+            last.endSec = p.endSec;
+            last.text = `${last.text} ${p.text}`.trim();
+            last.words = [...last.words, ...p.words];
+        }
+        else {
+            merged.push(p);
+        }
+    }
+    return merged;
+}
+export function buildTake(input) {
+    const opts = { ...DEFAULT_OPTIONS, ...(input.packOptions ?? {}) };
+    const speaker = input.defaultSpeaker ?? 'S0';
+    let phrases = groupWordsIntoPhrases(input.words, speaker, opts);
+    if (input.phraseSpeakers && input.phraseSpeakers.length === phrases.length) {
+        phrases = phrases.map((p, i) => ({ ...p, speaker: input.phraseSpeakers[i] }));
+    }
+    return {
+        id: deriveTakeId(input.file, input.ordinal),
+        file: input.file,
+        durationSec: input.durationSec,
+        phrases,
+        audioEvents: input.audioEvents ?? [],
+        transcribedAt: new Date().toISOString(),
+        transcriber: input.transcriber,
+        mode: input.mode,
+    };
+}
+function formatTimestamp(sec) {
+    return sec.toFixed(2).padStart(6, '0');
+}
+/**
+ * Render a TakesPack to markdown. Each take becomes a `##` heading with
+ * bracketed phrase timestamps inside — the exact format video-use uses.
+ */
+export function renderTakesPack(pack) {
+    const lines = [];
+    lines.push('# Takes Pack');
+    lines.push('');
+    lines.push(`Generated: ${pack.generatedAt}`);
+    lines.push(`Source: ${pack.sourceLabel}`);
+    lines.push(`Takes: ${pack.takes.length}`);
+    lines.push('');
+    lines.push('Format: each take is a heading with per-phrase `[start-end] speaker text` lines. ' +
+        'Times are in seconds from the start of the source file. Speaker labels are from ' +
+        'diarization (or the script) when available, otherwise `S0` single-speaker.');
+    lines.push('');
+    for (const take of pack.takes) {
+        const dur = take.durationSec.toFixed(1);
+        const phraseCount = take.phrases.length;
+        const fileRel = basename(take.file);
+        lines.push(`## ${take.id}  (duration: ${dur}s, ${phraseCount} phrases)`);
+        lines.push(`file: ${fileRel}`);
+        if (take.mode === 'aligned')
+            lines.push('mode: aligned (ground-truth script)');
+        lines.push('');
+        for (const p of take.phrases) {
+            lines.push(`  [${formatTimestamp(p.startSec)}-${formatTimestamp(p.endSec)}] ${p.speaker} ${p.text}`);
+        }
+        for (const ev of take.audioEvents) {
+            lines.push(`  [${formatTimestamp(ev.startSec)}-${formatTimestamp(ev.endSec)}] _audio_ ${ev.label}`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+export function writeTakesPack(pack, outPath) {
+    mkdirSync(dirname(outPath), { recursive: true });
+    writeFileSync(outPath, renderTakesPack(pack), 'utf-8');
+}
+/** Write `<source>.words.json` next to a take for programmatic consumers. */
+export function writeWordsJson(take, outPath) {
+    mkdirSync(dirname(outPath), { recursive: true });
+    const payload = {
+        takeId: take.id,
+        file: take.file,
+        durationSec: take.durationSec,
+        transcribedAt: take.transcribedAt,
+        transcriber: take.transcriber,
+        mode: take.mode,
+        words: take.phrases.flatMap((p) => p.words.map((w) => ({ ...w, speaker: p.speaker }))),
+        phrases: take.phrases.map((p) => ({
+            speaker: p.speaker,
+            startSec: p.startSec,
+            endSec: p.endSec,
+            text: p.text,
+        })),
+        audioEvents: take.audioEvents,
+    };
+    writeFileSync(outPath, JSON.stringify(payload, null, 2), 'utf-8');
+}
+export function wordsJsonPathFor(sourceFile, editDir) {
+    const stem = basename(sourceFile, extname(sourceFile));
+    return `${editDir}/${stem}.words.json`;
+}
+//# sourceMappingURL=packer.js.map

package/dist/editing/packer.js.map

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

package/dist/editing/providers/whisper-cpp.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Whisper.cpp transcriber provider.
+ *
+ * Shells out to the `whisper-cpp` binary (install via `brew install whisper-cpp`).
+ * Extracts audio to 16kHz mono WAV via ffmpeg, runs whisper.cpp with JSON output,
+ * and parses word-level timestamps.
+ *
+ * whisper.cpp output format (--output-json-full):
+ *   {
+ *     "result": { "language": "en" },
+ *     "transcription": [
+ *       {
+ *         "timestamps": { "from": "00:00:00,000", "to": "00:00:03,400" },
+ *         "offsets": { "from": 0, "to": 3400 },
+ *         "text": " Hello world.",
+ *         "tokens": [
+ *           { "offsets": { "from": 0, "to": 400 }, "text": " Hello", ... },
+ *           ...
+ *         ]
+ *       }
+ *     ]
+ *   }
+ *
+ * Offsets are in milliseconds from the start of the source.
+ */
+import type { TranscriberProvider, TranscribeOptions, TranscribeResult } from '../types.js';
+export declare class WhisperCppProvider implements TranscriberProvider {
+    readonly id = "whisper-cpp";
+    assertAvailable(): Promise<void>;
+    transcribe(file: string, options?: TranscribeOptions): Promise<TranscribeResult>;
+}
+//# sourceMappingURL=whisper-cpp.d.ts.map

package/dist/editing/providers/whisper-cpp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"whisper-cpp.d.ts","sourceRoot":"","sources":["../../../src/editing/providers/whisper-cpp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAMH,OAAO,KAAK,EACV,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAEjB,MAAM,aAAa,CAAC;AAqLrB,qBAAa,kBAAmB,YAAW,mBAAmB;IAC5D,QAAQ,CAAC,EAAE,iBAAiB;IAEtB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAQhC,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC;CA6D3F"}

package/dist/editing/providers/whisper-cpp.js

@@ -0,0 +1,239 @@
+/**
+ * Whisper.cpp transcriber provider.
+ *
+ * Shells out to the `whisper-cpp` binary (install via `brew install whisper-cpp`).
+ * Extracts audio to 16kHz mono WAV via ffmpeg, runs whisper.cpp with JSON output,
+ * and parses word-level timestamps.
+ *
+ * whisper.cpp output format (--output-json-full):
+ *   {
+ *     "result": { "language": "en" },
+ *     "transcription": [
+ *       {
+ *         "timestamps": { "from": "00:00:00,000", "to": "00:00:03,400" },
+ *         "offsets": { "from": 0, "to": 3400 },
+ *         "text": " Hello world.",
+ *         "tokens": [
+ *           { "offsets": { "from": 0, "to": 400 }, "text": " Hello", ... },
+ *           ...
+ *         ]
+ *       }
+ *     ]
+ *   }
+ *
+ * Offsets are in milliseconds from the start of the source.
+ */
+import { execSync, spawnSync } from 'node:child_process';
+import { existsSync, readFileSync, mkdtempSync, rmSync } from 'node:fs';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+const MODEL_FILENAME = {
+    'tiny': 'ggml-tiny.bin',
+    'base': 'ggml-base.bin',
+    'small': 'ggml-small.bin',
+    'medium': 'ggml-medium.bin',
+    'large': 'ggml-large-v3.bin',
+    'tiny.en': 'ggml-tiny.en.bin',
+    'base.en': 'ggml-base.en.bin',
+    'small.en': 'ggml-small.en.bin',
+    'medium.en': 'ggml-medium.en.bin',
+};
+/**
+ * Search the usual places for a whisper.cpp model file. In order:
+ *   1. $WHISPER_CPP_MODELS_DIR / <filename>
+ *   2. /opt/homebrew/share/whisper-cpp/<filename>  (Apple Silicon brew)
+ *   3. /usr/local/share/whisper-cpp/<filename>     (Intel brew)
+ *   4. ~/.cache/whisper.cpp/<filename>
+ */
+function resolveModelPath(modelSize) {
+    const filename = MODEL_FILENAME[modelSize];
+    const candidates = [
+        process.env.WHISPER_CPP_MODELS_DIR
+            ? join(process.env.WHISPER_CPP_MODELS_DIR, filename)
+            : null,
+        `/opt/homebrew/share/whisper-cpp/${filename}`,
+        `/usr/local/share/whisper-cpp/${filename}`,
+        join(process.env.HOME || '', '.cache', 'whisper.cpp', filename),
+    ].filter((x) => x !== null);
+    for (const path of candidates) {
+        if (existsSync(path))
+            return path;
+    }
+    throw new Error([
+        `whisper.cpp model '${filename}' not found. Searched:`,
+        ...candidates.map((c) => `  - ${c}`),
+        '',
+        'Download via:',
+        `  curl -L -o ~/.cache/whisper.cpp/${filename} \\`,
+        `    https://huggingface.co/ggerganov/whisper.cpp/resolve/main/${filename}`,
+        '',
+        'Or set WHISPER_CPP_MODELS_DIR to a directory that contains the file.',
+    ].join('\n'));
+}
+function resolveWhisperBinary() {
+    for (const candidate of ['whisper-cli', 'whisper-cpp', 'main']) {
+        const r = spawnSync('which', [candidate], { encoding: 'utf-8' });
+        if (r.status === 0 && r.stdout.trim())
+            return candidate;
+    }
+    throw new Error('whisper.cpp binary not found on PATH. Install with:\n' +
+        '  brew install whisper-cpp\n' +
+        '\n' +
+        'This provides the `whisper-cli` binary (newer releases) or `whisper-cpp` (older).');
+}
+function probeDuration(file) {
+    const out = execSync(`ffprobe -v error -show_entries format=duration -of default=noprint_wrappers=1:nokey=1 "${file}"`, { encoding: 'utf-8' }).trim();
+    const d = parseFloat(out);
+    if (Number.isNaN(d))
+        throw new Error(`ffprobe could not read duration from ${file}`);
+    return d;
+}
+function extractWav(file, wavPath) {
+    execSync(`ffmpeg -y -hide_banner -loglevel error -i "${file}" -ar 16000 -ac 1 -c:a pcm_s16le "${wavPath}"`, { stdio: 'inherit' });
+}
+/**
+ * Flatten whisper.cpp segment+token output into a flat word timing stream.
+ *
+ * whisper.cpp's "tokens" are BPE tokens, not words — they get merged into
+ * words by concatenating adjacent tokens until we hit whitespace. For most
+ * purposes the segment-level "text" split on whitespace is sufficient and
+ * accurate enough; we allocate times proportionally when tokens are missing.
+ */
+function segmentsToWords(segments) {
+    const words = [];
+    for (const seg of segments) {
+        const segStartSec = seg.offsets.from / 1000;
+        const segEndSec = seg.offsets.to / 1000;
+        const segDur = Math.max(0.001, segEndSec - segStartSec);
+        // Prefer token-level timestamps when available (whisper.cpp with
+        // --word-thold and --max-len 1 emits per-word tokens).
+        const tokenWords = [];
+        if (seg.tokens && seg.tokens.length > 0) {
+            // Merge tokens into words at whitespace boundaries.
+            let buf = null;
+            for (const tok of seg.tokens) {
+                const text = tok.text;
+                // whisper.cpp emits [_BEG_], [_TT_XX], <|...|> special tokens; skip them.
+                if (text.startsWith('[_') || text.startsWith('<|'))
+                    continue;
+                const isWordStart = text.startsWith(' ') || buf === null;
+                const trimmed = text.trim();
+                if (!trimmed)
+                    continue;
+                if (isWordStart) {
+                    if (buf) {
+                        tokenWords.push({
+                            word: buf.text,
+                            startSec: buf.from / 1000,
+                            endSec: buf.to / 1000,
+                            confidence: buf.p,
+                        });
+                    }
+                    buf = { text: trimmed, from: tok.offsets.from, to: tok.offsets.to, p: tok.p };
+                }
+                else if (buf) {
+                    buf.text += trimmed;
+                    buf.to = tok.offsets.to;
+                    if (tok.p !== undefined && buf.p !== undefined) {
+                        buf.p = Math.min(buf.p, tok.p);
+                    }
+                }
+            }
+            if (buf) {
+                tokenWords.push({
+                    word: buf.text,
+                    startSec: buf.from / 1000,
+                    endSec: buf.to / 1000,
+                    confidence: buf.p,
+                });
+            }
+        }
+        if (tokenWords.length > 0) {
+            words.push(...tokenWords);
+            continue;
+        }
+        // Fallback: split segment text evenly across its duration.
+        const plainWords = seg.text
+            .split(/\s+/)
+            .map((w) => w.trim())
+            .filter((w) => w.length > 0);
+        if (plainWords.length === 0)
+            continue;
+        const per = segDur / plainWords.length;
+        for (let i = 0; i < plainWords.length; i++) {
+            words.push({
+                word: plainWords[i],
+                startSec: segStartSec + i * per,
+                endSec: segStartSec + (i + 1) * per,
+            });
+        }
+    }
+    return words;
+}
+export class WhisperCppProvider {
+    id = 'whisper-cpp';
+    async assertAvailable() {
+        resolveWhisperBinary();
+        const r = spawnSync('ffmpeg', ['-version'], { encoding: 'utf-8' });
+        if (r.status !== 0) {
+            throw new Error('ffmpeg not found on PATH. Install via `brew install ffmpeg`.');
+        }
+    }
+    async transcribe(file, options = {}) {
+        const modelSize = options.modelSize ?? 'base.en';
+        const language = options.language ?? 'auto';
+        const wordThold = options.wordThreshold ?? 0.01;
+        const threads = options.threads ?? Math.max(1, Math.min(8, Number(process.env.WHISPER_THREADS) || 4));
+        const binary = resolveWhisperBinary();
+        const modelPath = resolveModelPath(modelSize);
+        const durationSec = probeDuration(file);
+        const tmp = mkdtempSync(join(tmpdir(), 'whisper-cpp-'));
+        const wav = join(tmp, 'audio.wav');
+        const jsonBase = join(tmp, 'out');
+        const jsonPath = `${jsonBase}.json`;
+        try {
+            extractWav(file, wav);
+            const args = [
+                '--model', modelPath,
+                '--file', wav,
+                '--output-json-full',
+                '--output-file', jsonBase,
+                '--word-thold', String(wordThold),
+                '--max-len', '1',
+                '--threads', String(threads),
+                '--print-progress',
+            ];
+            if (language !== 'auto') {
+                args.push('--language', language);
+            }
+            const r = spawnSync(binary, args, { stdio: 'inherit' });
+            if (r.status !== 0) {
+                throw new Error(`${binary} exited with code ${r.status}`);
+            }
+            if (!existsSync(jsonPath)) {
+                throw new Error(`whisper.cpp did not produce ${jsonPath}`);
+            }
+            const raw = readFileSync(jsonPath, 'utf-8');
+            const parsed = JSON.parse(raw);
+            const words = segmentsToWords(parsed.transcription ?? []);
+            const text = words.map((w) => w.word).join(' ');
+            const detectedLang = parsed.result?.language ?? (language === 'auto' ? 'en' : language);
+            return {
+                words,
+                text,
+                language: detectedLang,
+                durationSec,
+                transcriberLabel: `whisper-cpp:${modelSize}`,
+            };
+        }
+        finally {
+            try {
+                rmSync(tmp, { recursive: true, force: true });
+            }
+            catch {
+                // best-effort cleanup
+            }
+        }
+    }
+}
+//# sourceMappingURL=whisper-cpp.js.map

package/dist/editing/providers/whisper-cpp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"whisper-cpp.js","sourceRoot":"","sources":["../../../src/editing/providers/whisper-cpp.ts"],"names":[],"mappings":"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"}

package/dist/editing/render.d.ts

@@ -0,0 +1,36 @@
+/**
+ * EDL renderer.
+ *
+ * Turns an Edl into a single mp4 file via ffmpeg. Produces 30ms audio
+ * fades at every cut boundary (video-use's "no pops" rule). Supports
+ * hard cuts, crossfades, and fade-to-black transitions.
+ *
+ * Archive-first per workspace rule `.cursor/rules/shot-asset-safety.mdc`:
+ * any existing output file is renamed to `<stem>-v<N>.<ext>` before the
+ * new render lands.
+ */
+import type { Edl, Take } from './types.js';
+export interface RenderOptions {
+    /** Optional destination for the output file. Default: `<editDir>/final-edit.mp4`. */
+    outputPath?: string;
+    /** Skip archiving the prior version. Default false (always archive). */
+    skipArchive?: boolean;
+    /** Dry-run — print the ffmpeg invocation without executing. */
+    dryRun?: boolean;
+    /**
+     * Only re-render a specific clip by index. When set, the renderer writes
+     * a partial mp4 at `<outputStem>.clip-<N>.mp4` that the caller can splice
+     * via a secondary concat. This supports anti-pattern E4 (don't re-render
+     * the whole edit to fix one clip).
+     */
+    onlyClipIndex?: number;
+}
+export interface RenderResult {
+    outputPath: string;
+    archivedPath: string | null;
+    filterGraph: string;
+    command: string;
+    durationEstSec: number;
+}
+export declare function renderEdl(edl: Edl, takes: Take[], options?: RenderOptions): RenderResult;
+//# sourceMappingURL=render.d.ts.map

package/dist/editing/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/editing/render.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAWH,OAAO,KAAK,EAAE,GAAG,EAAW,IAAI,EAAE,MAAM,YAAY,CAAC;AAErD,MAAM,WAAW,aAAa;IAC5B,qFAAqF;IACrF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wEAAwE;IACxE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,+DAA+D;IAC/D,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;CACxB;AAuKD,wBAAgB,SAAS,CACvB,GAAG,EAAE,GAAG,EACR,KAAK,EAAE,IAAI,EAAE,EACb,OAAO,GAAE,aAAkB,GAC1B,YAAY,CAqFd"}