videoclaw 3.0.0-alpha.1

package/dist/video/cost-estimate.js

@@ -0,0 +1,103 @@
+import { existsSync } from 'node:fs';
+import { readFile } from 'node:fs/promises';
+import { artifactPathFor } from './artifact-store.js';
+import { listCharacterProfiles } from './characters.js';
+import { findHistoricalSeedanceCostTelemetry } from './generation-telemetry.js';
+import { resolveProjectWorkspace } from './workspace.js';
+function roundUsd(value) {
+    return Math.round(value * 100) / 100;
+}
+function estimateSeedancePerSceneUsd(clipDurationSeconds) {
+    if (clipDurationSeconds <= 10)
+        return 0.27;
+    if (clipDurationSeconds <= 15)
+        return 0.40;
+    return 0.53;
+}
+export function buildVideoCostEstimate(input) {
+    const sceneCount = input.sceneCount;
+    const clipDurationSeconds = input.clipDurationSeconds;
+    const newCharacterCount = input.newCharacterCount ?? 0;
+    const narrationEnabled = input.narrationEnabled ?? true;
+    const seedancePerSceneUsd = input.seedancePerSceneUsd ?? estimateSeedancePerSceneUsd(clipDurationSeconds);
+    const seedanceTotalUsd = roundUsd(sceneCount * seedancePerSceneUsd);
+    const geminiTotalUsd = 0.03;
+    const goBananasTotalUsd = roundUsd(newCharacterCount * 0.05);
+    const elevenLabsTotalUsd = narrationEnabled ? roundUsd(sceneCount * 0.01) : 0;
+    const totalUsd = roundUsd(seedanceTotalUsd + geminiTotalUsd + goBananasTotalUsd + elevenLabsTotalUsd);
+    const wallTimeMinutes = sceneCount * 4 + 5;
+    return {
+        sceneCount,
+        clipDurationSeconds,
+        newCharacterCount,
+        narrationEnabled,
+        seedancePerSceneUsd,
+        seedanceTotalUsd,
+        geminiTotalUsd,
+        goBananasTotalUsd,
+        elevenLabsTotalUsd,
+        totalUsd,
+        wallTimeMinutes,
+        estimateSource: input.telemetry ? 'historical-telemetry' : 'static-default',
+        ...(input.telemetry ? { telemetry: input.telemetry } : {}),
+    };
+}
+export async function buildProjectCostEstimate(input) {
+    const root = input.root ?? process.cwd();
+    const workspace = resolveProjectWorkspace(input.projectSlug, root);
+    const storyboardPath = artifactPathFor(workspace, 'storyboard');
+    const briefPath = artifactPathFor(workspace, 'brief');
+    let inferredSceneCount = input.sceneCount;
+    let inferredClipDurationSeconds = input.clipDurationSeconds;
+    if (existsSync(storyboardPath)) {
+        const storyboard = JSON.parse(await readFile(storyboardPath, 'utf-8'));
+        const scenes = storyboard.scenes ?? [];
+        if (inferredSceneCount === undefined) {
+            inferredSceneCount = scenes.length;
+        }
+        if (inferredClipDurationSeconds === undefined && scenes.length > 0) {
+            const durations = scenes
+                .map((scene) => scene.durationSeconds)
+                .filter((value) => Number.isFinite(value));
+            if (durations.length > 0) {
+                inferredClipDurationSeconds = Math.round(durations.reduce((sum, value) => sum + value, 0) / durations.length);
+            }
+        }
+    }
+    let narrationEnabled = input.narrationEnabled;
+    if (narrationEnabled === undefined && existsSync(briefPath)) {
+        const brief = JSON.parse(await readFile(briefPath, 'utf-8'));
+        const generateAudio = brief.metadata?.executionProfile?.generateAudio;
+        if (typeof generateAudio === 'boolean') {
+            narrationEnabled = generateAudio;
+        }
+    }
+    let newCharacterCount = input.newCharacterCount;
+    if (newCharacterCount === undefined) {
+        const characters = await listCharacterProfiles(workspace);
+        newCharacterCount = characters.filter((character) => character.goBananasId === undefined).length;
+    }
+    if (inferredSceneCount === undefined || !Number.isInteger(inferredSceneCount) || inferredSceneCount <= 0) {
+        throw new Error('Could not determine scene count. Provide --scenes or create a storyboard first.');
+    }
+    const resolvedSceneCount = inferredSceneCount;
+    const resolvedClipDurationSeconds = inferredClipDurationSeconds ?? 15;
+    const resolvedNewCharacterCount = newCharacterCount ?? 0;
+    const historicalTelemetry = await findHistoricalSeedanceCostTelemetry(root);
+    const telemetry = historicalTelemetry
+        ? {
+            sampleCount: historicalTelemetry.sampleCount,
+            matchedRouteId: historicalTelemetry.matchedRouteId,
+            averageSeedancePerSceneUsd: historicalTelemetry.averageSeedancePerSceneUsd,
+            lastRecordedAt: historicalTelemetry.lastRecordedAt,
+        }
+        : undefined;
+    return buildVideoCostEstimate({
+        sceneCount: resolvedSceneCount,
+        clipDurationSeconds: resolvedClipDurationSeconds,
+        newCharacterCount: resolvedNewCharacterCount,
+        narrationEnabled,
+        ...(telemetry ? { seedancePerSceneUsd: telemetry.averageSeedancePerSceneUsd, telemetry } : {}),
+    });
+}
+//# sourceMappingURL=cost-estimate.js.map

package/dist/video/cost-estimate.js.map

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

package/dist/video/csv-export.d.ts

@@ -0,0 +1,8 @@
+import type { VideoProductionMode } from './types.js';
+export interface CsvExportResult {
+    reportPath: string;
+    projectsCsvPath: string;
+    timelineCsvPath: string;
+}
+export declare function exportPortfolioCsv(root?: string, outputDir?: string, productionMode?: VideoProductionMode): Promise<CsvExportResult>;
+//# sourceMappingURL=csv-export.d.ts.map

package/dist/video/csv-export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"csv-export.d.ts","sourceRoot":"","sources":["../../src/video/csv-export.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAUtD,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,wBAAsB,kBAAkB,CACtC,IAAI,SAAgB,EACpB,SAAS,SAAwB,EACjC,cAAc,GAAE,mBAAkC,GACjD,OAAO,CAAC,eAAe,CAAC,CA8H1B"}

package/dist/video/csv-export.js

@@ -0,0 +1,133 @@
+import { mkdir, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { buildPortfolioReport } from './report.js';
+function csvEscape(value) {
+    const text = String(value ?? '');
+    if (text.includes('"') || text.includes(',') || text.includes('\n')) {
+        return `"${text.replaceAll('"', '""')}"`;
+    }
+    return text;
+}
+export async function exportPortfolioCsv(root = process.cwd(), outputDir = join(root, 'exports'), productionMode = 'storyboard') {
+    const report = await buildPortfolioReport(root, productionMode);
+    await mkdir(outputDir, { recursive: true });
+    const reportPath = join(outputDir, 'portfolio-report.json');
+    const projectsCsvPath = join(outputDir, 'projects.csv');
+    const timelineCsvPath = join(outputDir, 'timeline.csv');
+    const projectHeaders = [
+        'slug',
+        'opsStatus',
+        'productionMode',
+        'targetRuntimeSeconds',
+        'clipDurationSeconds',
+        'genre',
+        'platform',
+        'style',
+        'colorGrading',
+        'legacyImportManifestPresent',
+        'legacyImportQueueFilePresent',
+        'legacyImportQueueStatusMismatch',
+        'legacyImportNestedOutputRootDetected',
+        'owner',
+        'priority',
+        'dueDate',
+        'nextStage',
+        'storyboardReviewState',
+        'storyboardReviewExists',
+        'storyboardReviewPath',
+        'storyboardReviewGeneratedAt',
+        'storyboardReviewStale',
+        'reviewReportVerdict',
+        'reviewPublishReady',
+        'executionProfileAspectRatio',
+        'executionProfileQuality',
+        'executionProfileResolution',
+        'executionProfileGenerateAudio',
+        'executionProfileOutputCount',
+        'promptGuidance',
+        'characterProfileCount',
+        'characterHydrationExplicitCount',
+        'characterHydrationImportedCount',
+        'characterHydrationAutoCreatedCount',
+        'characterBindings',
+        'completedStageCount',
+        'pendingStageCount',
+        'artifactCount',
+        'checkpointCount',
+        'reference_sheets_count',
+        'reference_sheets_types',
+        'scene_selection_with_selection',
+        'scene_candidates_total',
+    ];
+    const projectLines = [
+        projectHeaders.join(','),
+        ...report.index.projects.map((project) => [
+            project.slug,
+            project.opsStatus,
+            project.productionMode,
+            typeof project.targetRuntimeSeconds === 'number' ? project.targetRuntimeSeconds : '',
+            typeof project.clipDurationSeconds === 'number' ? project.clipDurationSeconds : '',
+            project.genre ?? '',
+            project.platform ?? '',
+            project.style ?? '',
+            project.colorGrading ?? '',
+            typeof project.legacyImportSummary?.manifestPresent === 'boolean' ? String(project.legacyImportSummary.manifestPresent) : '',
+            typeof project.legacyImportSummary?.queueFilePresent === 'boolean' ? String(project.legacyImportSummary.queueFilePresent) : '',
+            typeof project.legacyImportSummary?.queueStatusMismatch === 'boolean' ? String(project.legacyImportSummary.queueStatusMismatch) : '',
+            typeof project.legacyImportSummary?.nestedOutputRootDetected === 'boolean' ? String(project.legacyImportSummary.nestedOutputRootDetected) : '',
+            project.owner ?? '',
+            project.priority ?? '',
+            project.dueDate ?? '',
+            project.nextStage ?? 'complete',
+            project.storyboardReviewState ?? '',
+            typeof project.storyboardReviewExists === 'boolean' ? String(project.storyboardReviewExists) : '',
+            project.storyboardReviewPath ?? '',
+            project.storyboardReviewGeneratedAt ?? '',
+            typeof project.storyboardReviewStale === 'boolean' ? String(project.storyboardReviewStale) : '',
+            project.reviewReportVerdict ?? '',
+            typeof project.reviewPublishReady === 'boolean' ? String(project.reviewPublishReady) : '',
+            project.executionProfile?.aspectRatio ?? '',
+            project.executionProfile?.quality ?? '',
+            project.executionProfile?.resolution ?? '',
+            typeof project.executionProfile?.generateAudio === 'boolean' ? String(project.executionProfile.generateAudio) : '',
+            typeof project.executionProfile?.outputCount === 'number' ? project.executionProfile.outputCount : '',
+            (project.promptGuidance ?? []).join('|'),
+            typeof project.characterProfileCount === 'number' ? project.characterProfileCount : '',
+            typeof project.characterHydrationSummary?.explicitCount === 'number' ? project.characterHydrationSummary.explicitCount : '',
+            typeof project.characterHydrationSummary?.importedCount === 'number' ? project.characterHydrationSummary.importedCount : '',
+            typeof project.characterHydrationSummary?.autoCreatedCount === 'number' ? project.characterHydrationSummary.autoCreatedCount : '',
+            (project.characterBindings ?? [])
+                .map((binding) => `${binding.name}:${binding.goBananasId ?? 'none'}:${binding.referenceAssets.join('&') || 'none'}`)
+                .join('|'),
+            project.completedStages.length,
+            project.pendingStages.length,
+            project.artifactCount,
+            project.checkpointCount,
+            project.referenceSheets?.count ?? 0,
+            Object.keys(project.referenceSheets?.byType ?? {}).join('|'),
+            project.sceneSelection?.withSelection ?? 0,
+            project.sceneSelection?.totalCandidates ?? 0,
+        ].map(csvEscape).join(',')),
+    ];
+    const timelineHeaders = ['recordedAt', 'slug', 'type', 'payload'];
+    const timelineLines = [
+        timelineHeaders.join(','),
+        ...report.timeline.map((event) => [
+            event.recordedAt,
+            event.slug,
+            event.type,
+            JSON.stringify(event.payload ?? {}),
+        ].map(csvEscape).join(',')),
+    ];
+    await Promise.all([
+        writeFile(reportPath, `${JSON.stringify(report, null, 2)}\n`),
+        writeFile(projectsCsvPath, `${projectLines.join('\n')}\n`),
+        writeFile(timelineCsvPath, `${timelineLines.join('\n')}\n`),
+    ]);
+    return {
+        reportPath,
+        projectsCsvPath,
+        timelineCsvPath,
+    };
+}
+//# sourceMappingURL=csv-export.js.map

package/dist/video/csv-export.js.map

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

package/dist/video/dependencies.d.ts

@@ -0,0 +1,23 @@
+import type { VideoProductionMode } from './types.js';
+import type { LegacyImportSummary } from './types.js';
+export interface ProjectDependencyEdge {
+    from: string;
+    to: string;
+    reason?: string | null;
+}
+export interface ProjectDependencyReport {
+    generatedAt: string;
+    root: string;
+    nodes: Array<{
+        slug: string;
+        opsStatus: string;
+        legacyImportSummary?: LegacyImportSummary;
+        platform?: string;
+        blockedBy: string[];
+    }>;
+    edges: ProjectDependencyEdge[];
+    blockedProjects: string[];
+    blockerProjects: string[];
+}
+export declare function buildDependencyReport(root?: string, productionMode?: VideoProductionMode): Promise<ProjectDependencyReport>;
+//# sourceMappingURL=dependencies.d.ts.map

package/dist/video/dependencies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependencies.d.ts","sourceRoot":"","sources":["../../src/video/dependencies.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,KAAK,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;QAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC,CAAC;IACH,KAAK,EAAE,qBAAqB,EAAE,CAAC;IAC/B,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,wBAAsB,qBAAqB,CACzC,IAAI,SAAgB,EACpB,cAAc,GAAE,mBAAkC,GACjD,OAAO,CAAC,uBAAuB,CAAC,CAmClC"}

package/dist/video/dependencies.js

@@ -0,0 +1,36 @@
+import { buildProjectIndex } from './project-index.js';
+export async function buildDependencyReport(root = process.cwd(), productionMode = 'storyboard') {
+    const index = await buildProjectIndex(root, productionMode);
+    const edges = [];
+    const blockerProjects = new Set();
+    const blockedProjects = [];
+    for (const project of index.projects) {
+        const blockers = project.blockedBy ?? [];
+        if (blockers.length > 0) {
+            blockedProjects.push(project.slug);
+        }
+        for (const blocker of blockers) {
+            blockerProjects.add(blocker);
+            edges.push({
+                from: project.slug,
+                to: blocker,
+                reason: project.blockedReason ?? null,
+            });
+        }
+    }
+    return {
+        generatedAt: new Date().toISOString(),
+        root,
+        nodes: index.projects.map((project) => ({
+            slug: project.slug,
+            opsStatus: project.opsStatus,
+            ...(project.legacyImportSummary ? { legacyImportSummary: project.legacyImportSummary } : {}),
+            ...(project.platform ? { platform: project.platform } : {}),
+            blockedBy: project.blockedBy ?? [],
+        })),
+        edges,
+        blockedProjects: blockedProjects.sort(),
+        blockerProjects: [...blockerProjects].sort(),
+    };
+}
+//# sourceMappingURL=dependencies.js.map

package/dist/video/dependencies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependencies.js","sourceRoot":"","sources":["../../src/video/dependencies.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAyBvD,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,EACpB,iBAAsC,YAAY;IAElD,MAAM,KAAK,GAAG,MAAM,iBAAiB,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;IAC5D,MAAM,KAAK,GAA4B,EAAE,CAAC;IAC1C,MAAM,eAAe,GAAG,IAAI,GAAG,EAAU,CAAC;IAC1C,MAAM,eAAe,GAAa,EAAE,CAAC;IAErC,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAG,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC;QACzC,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACrC,CAAC;QACD,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAC7B,KAAK,CAAC,IAAI,CAAC;gBACT,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,EAAE,EAAE,OAAO;gBACX,MAAM,EAAE,OAAO,CAAC,aAAa,IAAI,IAAI;aACtC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO;QACL,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACrC,IAAI;QACJ,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YACtC,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,GAAG,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC,CAAC,EAAE,mBAAmB,EAAE,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5F,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3D,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,EAAE;SACnC,CAAC,CAAC;QACH,KAAK;QACL,eAAe,EAAE,eAAe,CAAC,IAAI,EAAE;QACvC,eAAe,EAAE,CAAC,GAAG,eAAe,CAAC,CAAC,IAAI,EAAE;KAC7C,CAAC;AACJ,CAAC"}

package/dist/video/dialogue-fit.d.ts

@@ -0,0 +1,23 @@
+export interface DialogueFitScene {
+    sceneIndex?: number;
+    dialogue?: string;
+    durationSeconds?: number;
+}
+export interface DialogueFitIssue {
+    severity: 'warn' | 'error';
+    code: 'DIALOGUE_DURATION_OVERFLOW';
+    sceneIndex: number;
+    dialogueWordCount: number;
+    targetDurationSeconds: number;
+    estimatedDurationSeconds: number;
+    message: string;
+    suggestion: string;
+}
+export declare function countDialogueWords(text: string): number;
+export declare function estimateDialogueDurationSeconds(wordCount: number): number;
+export declare function checkDialogueDurationFit(input: {
+    scenes?: DialogueFitScene[];
+    strict?: boolean;
+    defaultDurationSeconds?: number;
+}): DialogueFitIssue[];
+//# sourceMappingURL=dialogue-fit.d.ts.map

package/dist/video/dialogue-fit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialogue-fit.d.ts","sourceRoot":"","sources":["../../src/video/dialogue-fit.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3B,IAAI,EAAE,4BAA4B,CAAC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,wBAAwB,EAAE,MAAM,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAKD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,wBAAgB,+BAA+B,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE;IAC9C,MAAM,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC,GAAG,gBAAgB,EAAE,CA6BrB"}

package/dist/video/dialogue-fit.js

@@ -0,0 +1,38 @@
+const DEFAULT_SCENE_DURATION_SECONDS = 15;
+const COMFORTABLE_WORDS_PER_SECOND = 2.5;
+export function countDialogueWords(text) {
+    return text.match(/[A-Za-z0-9']+/g)?.length ?? 0;
+}
+export function estimateDialogueDurationSeconds(wordCount) {
+    return Math.ceil(wordCount / COMFORTABLE_WORDS_PER_SECOND);
+}
+export function checkDialogueDurationFit(input) {
+    const issues = [];
+    const defaultDurationSeconds = input.defaultDurationSeconds ?? DEFAULT_SCENE_DURATION_SECONDS;
+    const strict = input.strict ?? process.env.DIRECTOR_STRICT_DIALOGUE_FIT === '1';
+    for (const [index, scene] of (input.scenes ?? []).entries()) {
+        const dialogue = scene.dialogue?.trim();
+        if (!dialogue)
+            continue;
+        const sceneIndex = Number.isInteger(scene.sceneIndex) ? Number(scene.sceneIndex) : index;
+        const targetDurationSeconds = Number.isFinite(scene.durationSeconds)
+            ? Number(scene.durationSeconds)
+            : defaultDurationSeconds;
+        const dialogueWordCount = countDialogueWords(dialogue);
+        const estimatedDurationSeconds = estimateDialogueDurationSeconds(dialogueWordCount);
+        if (estimatedDurationSeconds <= targetDurationSeconds)
+            continue;
+        issues.push({
+            severity: strict ? 'error' : 'warn',
+            code: 'DIALOGUE_DURATION_OVERFLOW',
+            sceneIndex,
+            dialogueWordCount,
+            targetDurationSeconds,
+            estimatedDurationSeconds,
+            message: `Scene ${sceneIndex + 1} dialogue needs about ${estimatedDurationSeconds}s but the clip target is ${targetDurationSeconds}s.`,
+            suggestion: 'Shorten the line, split it across scenes, or increase durationSeconds before provider execution.',
+        });
+    }
+    return issues;
+}
+//# sourceMappingURL=dialogue-fit.js.map

package/dist/video/dialogue-fit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialogue-fit.js","sourceRoot":"","sources":["../../src/video/dialogue-fit.ts"],"names":[],"mappings":"AAiBA,MAAM,8BAA8B,GAAG,EAAE,CAAC;AAC1C,MAAM,4BAA4B,GAAG,GAAG,CAAC;AAEzC,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,OAAO,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,+BAA+B,CAAC,SAAiB;IAC/D,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,GAAG,4BAA4B,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,KAIxC;IACC,MAAM,MAAM,GAAuB,EAAE,CAAC;IACtC,MAAM,sBAAsB,GAAG,KAAK,CAAC,sBAAsB,IAAI,8BAA8B,CAAC;IAC9F,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,4BAA4B,KAAK,GAAG,CAAC;IAEhF,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;QAC5D,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC;QACxC,IAAI,CAAC,QAAQ;YAAE,SAAS;QACxB,MAAM,UAAU,GAAG,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QACzF,MAAM,qBAAqB,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,eAAe,CAAC;YAClE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC;YAC/B,CAAC,CAAC,sBAAsB,CAAC;QAC3B,MAAM,iBAAiB,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;QACvD,MAAM,wBAAwB,GAAG,+BAA+B,CAAC,iBAAiB,CAAC,CAAC;QACpF,IAAI,wBAAwB,IAAI,qBAAqB;YAAE,SAAS;QAEhE,MAAM,CAAC,IAAI,CAAC;YACV,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM;YACnC,IAAI,EAAE,4BAA4B;YAClC,UAAU;YACV,iBAAiB;YACjB,qBAAqB;YACrB,wBAAwB;YACxB,OAAO,EAAE,SAAS,UAAU,GAAG,CAAC,yBAAyB,wBAAwB,4BAA4B,qBAAqB,IAAI;YACtI,UAAU,EAAE,kGAAkG;SAC/G,CAAC,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/video/dialogue.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Per-character dialogue audio orchestrator.
+ *
+ * `generateDialogueAudio` synthesizes one TTS clip per `DialogueTurn` — each
+ * turn maps to a named character (optional per-turn voice override) — and
+ * persists a `dialogue.json` artifact listing every clip with its project-
+ * relative path and durationMs.
+ *
+ * Files are written to:
+ *   projects/<slug>/artifacts/audio/dialogue-<i>-<nameSlug>.wav
+ *
+ * The orchestrator is pure-ish: `env` and `fetcher` are threaded through to the
+ * TTS backend so tests run fully offline with no real keys or network. Throws
+ * `tts_failed` when no requested/available TTS backend can run.
+ */
+export declare const DIALOGUE_SCHEMA_VERSION = 1;
+/** A single spoken line attributed to a named character. */
+export interface DialogueTurn {
+    /** Character name (used in artifact and output filename). */
+    name: string;
+    /** Optional per-turn voice id forwarded to the TTS backend. */
+    voice?: string;
+    /** The spoken line to synthesize. */
+    line: string;
+}
+export interface DialogueClip {
+    name: string;
+    voice?: string;
+    line: string;
+    /** Project-relative path to the generated audio clip. */
+    path: string;
+    durationMs: number;
+}
+export interface DialogueArtifact {
+    schemaVersion: typeof DIALOGUE_SCHEMA_VERSION;
+    projectSlug: string;
+    generatedAt: string;
+    backendId: string;
+    turns: DialogueClip[];
+}
+export interface GenerateDialogueAudioOptions {
+    workspaceRoot: string;
+    slug: string;
+    turns: DialogueTurn[];
+    /** Restrict to this backend id (defaults to the first AVAILABLE backend). */
+    backendId?: string;
+    dryRun?: boolean;
+    env?: NodeJS.ProcessEnv;
+    fetcher?: typeof fetch;
+}
+export interface GenerateDialogueAudioResult {
+    clips: {
+        name: string;
+        voice?: string;
+        path: string;
+        durationMs: number;
+    }[];
+    artifactPath: string;
+}
+/** Path of the persisted dialogue.json artifact for a project. */
+export declare function dialogueArtifactPathFor(root: string, slug: string): string;
+/** Directory where per-turn audio clips are written. */
+export declare function dialogueAudioDirFor(root: string, slug: string): string;
+/**
+ * Synthesize one audio clip per turn and persist dialogue.json.
+ *
+ * Returns the in-memory clip list and the absolute path of the written
+ * artifact so callers can chain into the assemble layer.
+ *
+ * Throws `tts_failed` when:
+ *   - no turns are provided
+ *   - a requested backend is not available
+ *   - no TTS backend is available at all
+ *   - a turn has an empty line
+ */
+export declare function generateDialogueAudio(options: GenerateDialogueAudioOptions): Promise<GenerateDialogueAudioResult>;
+//# sourceMappingURL=dialogue.d.ts.map

package/dist/video/dialogue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialogue.d.ts","sourceRoot":"","sources":["../../src/video/dialogue.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAeH,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAEzC,4DAA4D;AAC5D,MAAM,WAAW,YAAY;IAC3B,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,OAAO,uBAAuB,CAAC;IAC9C,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,YAAY,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,4BAA4B;IAC3C,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,6EAA6E;IAC7E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;CACxB;AAED,MAAM,WAAW,2BAA2B;IAC1C,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC5E,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,kEAAkE;AAClE,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE1E;AAED,wDAAwD;AACxD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEtE;AAgBD;;;;;;;;;;;GAWG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAAC,2BAA2B,CAAC,CA4GtC"}

package/dist/video/dialogue.js

@@ -0,0 +1,143 @@
+/**
+ * Per-character dialogue audio orchestrator.
+ *
+ * `generateDialogueAudio` synthesizes one TTS clip per `DialogueTurn` — each
+ * turn maps to a named character (optional per-turn voice override) — and
+ * persists a `dialogue.json` artifact listing every clip with its project-
+ * relative path and durationMs.
+ *
+ * Files are written to:
+ *   projects/<slug>/artifacts/audio/dialogue-<i>-<nameSlug>.wav
+ *
+ * The orchestrator is pure-ish: `env` and `fetcher` are threaded through to the
+ * TTS backend so tests run fully offline with no real keys or network. Throws
+ * `tts_failed` when no requested/available TTS backend can run.
+ */
+import { mkdir } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { dirname, join, relative, resolve } from 'node:path';
+import { resolveProjectWorkspace } from './workspace.js';
+import { appendProjectEvent } from './events.js';
+import { writeTextFileAtomic } from './atomic-write.js';
+import { VclawError } from './errors.js';
+import { getTtsBackend, listAvailableTtsBackends, isTtsBackendAvailable, } from './audio-platform/registry.js';
+export const DIALOGUE_SCHEMA_VERSION = 1;
+/** Path of the persisted dialogue.json artifact for a project. */
+export function dialogueArtifactPathFor(root, slug) {
+    return join(resolveProjectWorkspace(slug, root).projectDir, 'artifacts', 'dialogue.json');
+}
+/** Directory where per-turn audio clips are written. */
+export function dialogueAudioDirFor(root, slug) {
+    return join(resolveProjectWorkspace(slug, root).projectDir, 'artifacts', 'audio');
+}
+/**
+ * Normalise a character name into a safe filename fragment:
+ *   - lowercase
+ *   - collapse non-alphanumeric runs to a single hyphen
+ *   - strip leading/trailing hyphens
+ * e.g. "Dr. Smith" → "dr-smith"
+ */
+function nameSlug(name) {
+    return name
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '') || 'char';
+}
+/**
+ * Synthesize one audio clip per turn and persist dialogue.json.
+ *
+ * Returns the in-memory clip list and the absolute path of the written
+ * artifact so callers can chain into the assemble layer.
+ *
+ * Throws `tts_failed` when:
+ *   - no turns are provided
+ *   - a requested backend is not available
+ *   - no TTS backend is available at all
+ *   - a turn has an empty line
+ */
+export async function generateDialogueAudio(options) {
+    const { workspaceRoot, slug } = options;
+    const env = options.env ?? process.env;
+    if (!options.turns || options.turns.length === 0) {
+        throw new VclawError('tts_failed', 'Cannot generate dialogue audio with no turns.', { slug });
+    }
+    const available = listAvailableTtsBackends(env);
+    // Resolve the backend: explicit id (looked up + gated on availability), else
+    // the first available backend.
+    let backend = available[0];
+    if (options.backendId) {
+        const named = getTtsBackend(options.backendId); // throws on unknown id
+        if (!isTtsBackendAvailable(named, env)) {
+            throw new VclawError('tts_failed', `TTS backend '${named.id}' is not available. Set a Gemini API key (GEMINI_API_KEYS / GOOGLE_API_KEYS / GOOGLE_API_KEY).`, { slug, requested: named.id, available: available.map((b) => b.id) });
+        }
+        backend = named;
+    }
+    if (!backend) {
+        throw new VclawError('tts_failed', 'No TTS backend is available. Set a Gemini API key (GEMINI_API_KEYS / GOOGLE_API_KEYS / GOOGLE_API_KEY).', { slug, requested: options.backendId ?? null, available: available.map((b) => b.id) });
+    }
+    const workspace = resolveProjectWorkspace(slug, workspaceRoot);
+    const projectRoot = resolve(workspace.projectDir);
+    const audioDir = dialogueAudioDirFor(workspaceRoot, slug);
+    await mkdir(audioDir, { recursive: true });
+    const clips = [];
+    for (let i = 0; i < options.turns.length; i++) {
+        const turn = options.turns[i];
+        if (!turn.line || !turn.line.trim()) {
+            throw new VclawError('tts_failed', `Dialogue turn ${i} for '${turn.name}' has an empty line.`, {
+                slug,
+                turnIndex: i,
+                name: turn.name,
+            });
+        }
+        // e.g. dialogue-0-dr-smith.wav
+        const filename = `dialogue-${i}-${nameSlug(turn.name)}.wav`;
+        const outputPath = join(audioDir, filename);
+        const result = await backend.generate({
+            text: turn.line,
+            ...(turn.voice ? { voice: turn.voice } : {}),
+            outputPath,
+            ...(options.dryRun !== undefined ? { dryRun: options.dryRun } : {}),
+            env,
+            ...(options.fetcher ? { fetcher: options.fetcher } : {}),
+        });
+        const rel = relative(projectRoot, resolve(result.path)).replaceAll('\\', '/');
+        const clip = {
+            name: turn.name,
+            ...(turn.voice ? { voice: turn.voice } : {}),
+            line: turn.line,
+            path: rel,
+            durationMs: result.durationMs,
+        };
+        clips.push(clip);
+    }
+    const artifact = {
+        schemaVersion: DIALOGUE_SCHEMA_VERSION,
+        projectSlug: slug,
+        generatedAt: new Date().toISOString(),
+        backendId: backend.id,
+        turns: clips,
+    };
+    const artifactPath = dialogueArtifactPathFor(workspaceRoot, slug);
+    await mkdir(dirname(artifactPath), { recursive: true });
+    await writeTextFileAtomic(artifactPath, `${JSON.stringify(artifact, null, 2)}\n`);
+    if (existsSync(workspace.eventsPath) || existsSync(workspace.eventsDir)) {
+        await appendProjectEvent(workspace, {
+            type: 'dialogue.generated',
+            payload: {
+                backendId: backend.id,
+                turns: clips.length,
+                dryRun: options.dryRun ?? false,
+            },
+        });
+    }
+    return {
+        clips: clips.map((c) => ({
+            name: c.name,
+            ...(c.voice ? { voice: c.voice } : {}),
+            path: c.path,
+            durationMs: c.durationMs,
+        })),
+        artifactPath,
+    };
+}
+//# sourceMappingURL=dialogue.js.map