video-maker-mcp 0.1.0

package/README.md

@@ -0,0 +1,143 @@
+# video-maker-mcp
+
+Local MCP storyboard video renderer for Codex-driven short video generation.
+
+`video-maker-mcp` does not run its own LLM and does not generate images itself. Codex writes the script and storyboard, uses its host image generation capability to create scene images, then this MCP server validates assets, generates Doubao/Volcengine narration, and renders a 9:16 MP4 with ffmpeg.
+
+## Install With Codex
+
+Paste this into Codex:
+
+```text
+请帮我安装 video-maker-mcp。执行：
+npx -y video-maker-mcp@latest install --host codex
+
+如果提示缺少 ffmpeg，请按提示安装 ffmpeg，然后重新运行：
+npx -y video-maker-mcp@latest doctor
+
+最后确认 Codex 能看到 video-maker MCP server。
+```
+
+Manual command:
+
+```bash
+npx -y video-maker-mcp@latest install --host codex
+```
+
+The installer configures Codex with:
+
+```bash
+codex mcp add video-maker -- npx -y video-maker-mcp@latest serve
+```
+
+It does not silently install system packages and does not bundle `ffmpeg-static`.
+
+## Requirements
+
+- Node.js 20+
+- Codex CLI
+- ffmpeg on PATH
+- Doubao/Volcengine TTS credentials
+
+ffmpeg install hints:
+
+```bash
+# macOS
+brew install ffmpeg
+
+# Ubuntu/Debian
+sudo apt update && sudo apt install -y ffmpeg
+
+# Windows
+winget install Gyan.FFmpeg
+```
+
+## TTS Environment
+
+Set:
+
+```env
+VIDEO_MAKER_TTS_API_KEY=your-api-key
+VIDEO_MAKER_TTS_VOICE_ID=zh_female_vv_uranus_bigtts
+VIDEO_MAKER_TTS_RESOURCE_ID=seed-tts-2.0
+```
+
+For local development, put these values in a project-root `.env` file. The CLI loads `.env` automatically. To load another env file, set `VIDEO_MAKER_ENV_FILE=/path/to/file`.
+
+The default TTS integration uses the current Doubao/Volcengine V3 HTTP unidirectional API with `X-Api-Key`. This matches the new console API Key page.
+
+Legacy V1 `AppID + Access Token` is still accepted as a fallback when `VIDEO_MAKER_TTS_API_KEY` is not set, but new accounts should use `VIDEO_MAKER_TTS_API_KEY`.
+
+Optional:
+
+```env
+VIDEO_MAKER_TTS_ENDPOINT=https://openspeech.bytedance.com/api/v3/tts/unidirectional
+VIDEO_MAKER_WORKSPACE=$HOME/.video-maker
+VIDEO_MAKER_EXPORT_DIR=$HOME/Downloads/video-maker
+```
+
+Quick TTS smoke test:
+
+```bash
+npm run build
+node dist/cli/index.js tts-test --text "你好，这是一段豆包语音测试。"
+open ~/Downloads/video-maker/doubao-tts-test.mp3
+```
+
+`tts-test --out` accepts either a directory or an `.mp3` file:
+
+```bash
+node dist/cli/index.js tts-test --out ~/Downloads/video-maker
+node dist/cli/index.js tts-test --out ~/Downloads/my-voice-test.mp3
+```
+
+## Codex Workflow
+
+Once installed, ask Codex:
+
+```text
+用 video-maker 把下面文稿生成一个 60 秒竖屏中文解说视频。请先检查环境，然后创建项目，生成分镜计划，生成每个分镜图片，验证素材，生成语音，最后渲染 mp4，并把最终文件导出到 ~/Downloads/video-maker。
+```
+
+The MCP workflow is:
+
+1. `check_environment`
+2. `create_video_project`
+3. `get_video_plan_schema`
+4. `save_video_plan`
+5. `list_required_assets`
+6. Codex generates images into the exact returned paths
+7. `verify_assets`
+8. `generate_audio`
+9. `render_video`
+10. Optional: `export_video`
+
+## Output
+
+Projects are stored under:
+
+```text
+~/.video-maker/projects/<projectId>
+```
+
+Final files:
+
+- `output/final.mp4`
+- `output/subtitles.srt`
+- `manifest.json`
+- `video_plan.json`
+
+For user-facing delivery, ask Codex to pass `outputDir` to `render_video` or call `export_video` after rendering. If no export directory is provided, `export_video` copies files to:
+
+```text
+~/Downloads/video-maker/<projectId>
+```
+
+## Local Development
+
+```bash
+npm install
+npm run typecheck
+npm run build
+node dist/cli/index.js doctor
+```

package/dist/cli/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli/index.js

@@ -0,0 +1,74 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import fs from "node:fs/promises";
+import path from "node:path";
+import { serveMcp } from "../mcp/server.js";
+import { installCodex, runDoctor } from "./install.js";
+import { synthesizeVolcengineSpeech } from "../providers/tts/volcengine.js";
+import { loadCliEnv } from "./load-env.js";
+import { DEFAULT_EXPORT_DIR, resolveUserPath } from "../core/paths.js";
+loadCliEnv();
+const program = new Command();
+function defaultTtsTestPath() {
+    return path.join(DEFAULT_EXPORT_DIR, "doubao-tts-test.mp3");
+}
+async function resolveOutputPath(output) {
+    const resolved = resolveUserPath(output);
+    if (path.extname(resolved).toLowerCase() === ".mp3") {
+        await fs.mkdir(path.dirname(resolved), { recursive: true });
+        return resolved;
+    }
+    await fs.mkdir(resolved, { recursive: true });
+    return path.join(resolved, "doubao-tts-test.mp3");
+}
+program
+    .name("video-maker-mcp")
+    .description("Local MCP storyboard video renderer for Codex.")
+    .version("0.1.0");
+program
+    .command("serve")
+    .description("Start the stdio MCP server.")
+    .action(async () => {
+    await serveMcp();
+});
+program
+    .command("doctor")
+    .description("Check local dependencies and configuration.")
+    .action(async () => {
+    const result = await runDoctor();
+    console.log(JSON.stringify(result, null, 2));
+    if (!result.ok)
+        process.exitCode = 1;
+});
+program
+    .command("install")
+    .description("Configure video-maker-mcp for a supported host.")
+    .option("--host <host>", "Host to configure; v1 supports codex", "codex")
+    .option("--package-spec <spec>", "npm package spec used in Codex MCP config", "video-maker-mcp@latest")
+    .action(async (opts) => {
+    if (opts.host !== "codex") {
+        console.error("v1 only supports --host codex");
+        process.exitCode = 1;
+        return;
+    }
+    const result = await installCodex({ host: "codex", packageSpec: opts.packageSpec });
+    console.log(JSON.stringify(result, null, 2));
+    if (!result.ok)
+        process.exitCode = 1;
+});
+program
+    .command("tts-test")
+    .description("Generate a short MP3 with the configured Doubao/Volcengine TTS credentials.")
+    .option("--text <text>", "Text to synthesize", "你好，这是一段 video-maker-mcp 的豆包语音合成本地测试。")
+    .option("--out <path>", "Output MP3 path or directory", defaultTtsTestPath())
+    .action(async (opts) => {
+    const outputPath = await resolveOutputPath(opts.out);
+    const audio = await synthesizeVolcengineSpeech(opts.text);
+    await fs.writeFile(outputPath, audio);
+    console.log(JSON.stringify({ ok: true, outputPath, bytes: audio.length }, null, 2));
+});
+program.parseAsync(process.argv).catch((error) => {
+    console.error(error instanceof Error ? error.message : String(error));
+    process.exitCode = 1;
+});
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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

package/dist/cli/install.d.ts

@@ -0,0 +1,15 @@
+import { checkEnvironment } from "../core/env.js";
+export interface InstallOptions {
+    host: "codex";
+    packageSpec?: string;
+}
+export declare function runDoctor(): Promise<{
+    ok: boolean;
+    environment: Awaited<ReturnType<typeof checkEnvironment>>;
+}>;
+export declare function installCodex(options: InstallOptions): Promise<{
+    ok: boolean;
+    configured: boolean;
+    message: string;
+    environment: Awaited<ReturnType<typeof checkEnvironment>>;
+}>;

package/dist/cli/install.js

@@ -0,0 +1,59 @@
+import { execa } from "execa";
+import { checkEnvironment, ffmpegInstallCommand } from "../core/env.js";
+import { ensureWorkspace } from "../core/project.js";
+export async function runDoctor() {
+    await ensureWorkspace();
+    const environment = await checkEnvironment();
+    return { ok: environment.ok, environment };
+}
+export async function installCodex(options) {
+    if (options.host !== "codex") {
+        throw new Error("v1 only supports --host codex");
+    }
+    await ensureWorkspace();
+    const environment = await checkEnvironment();
+    if (!environment.ffmpeg.installed) {
+        return {
+            ok: false,
+            configured: false,
+            environment,
+            message: `ffmpeg is required before configuring video-maker-mcp. Install it with: ${environment.ffmpeg.installCommand ?? ffmpegInstallCommand()}`
+        };
+    }
+    if (!environment.codex.installed) {
+        return {
+            ok: false,
+            configured: false,
+            environment,
+            message: "Codex CLI was not found on PATH. Install Codex first, then rerun this installer."
+        };
+    }
+    const already = await execa("codex", ["mcp", "get", "video-maker"], { reject: false });
+    if (already.exitCode === 0) {
+        return {
+            ok: true,
+            configured: false,
+            environment,
+            message: "Codex MCP server 'video-maker' is already configured."
+        };
+    }
+    const packageSpec = options.packageSpec ?? "video-maker-mcp@latest";
+    const add = await execa("codex", [
+        "mcp", "add", "video-maker", "--",
+        "npx", "-y", packageSpec, "serve"
+    ], { reject: false });
+    if (add.exitCode !== 0) {
+        throw new Error(`codex mcp add failed:\n${add.stdout}\n${add.stderr}`);
+    }
+    const smoke = await execa("codex", ["mcp", "get", "video-maker"], { reject: false });
+    if (smoke.exitCode !== 0) {
+        throw new Error(`codex mcp get video-maker failed after install:\n${smoke.stdout}\n${smoke.stderr}`);
+    }
+    return {
+        ok: true,
+        configured: true,
+        environment,
+        message: "Configured Codex MCP server 'video-maker'. Restart active Codex sessions to load it."
+    };
+}
+//# sourceMappingURL=install.js.map

package/dist/cli/install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../../src/cli/install.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAC9B,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAOrD,MAAM,CAAC,KAAK,UAAU,SAAS;IAI7B,MAAM,eAAe,EAAE,CAAC;IACxB,MAAM,WAAW,GAAG,MAAM,gBAAgB,EAAE,CAAC;IAC7C,OAAO,EAAE,EAAE,EAAE,WAAW,CAAC,EAAE,EAAE,WAAW,EAAE,CAAC;AAC7C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAAuB;IAMxD,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;IACnD,CAAC;IACD,MAAM,eAAe,EAAE,CAAC;IACxB,MAAM,WAAW,GAAG,MAAM,gBAAgB,EAAE,CAAC;IAC7C,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;QAClC,OAAO;YACL,EAAE,EAAE,KAAK;YACT,UAAU,EAAE,KAAK;YACjB,WAAW;YACX,OAAO,EAAE,2EAA2E,WAAW,CAAC,MAAM,CAAC,cAAc,IAAI,oBAAoB,EAAE,EAAE;SAClJ,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;QACjC,OAAO;YACL,EAAE,EAAE,KAAK;YACT,UAAU,EAAE,KAAK;YACjB,WAAW;YACX,OAAO,EAAE,kFAAkF;SAC5F,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IACvF,IAAI,OAAO,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO;YACL,EAAE,EAAE,IAAI;YACR,UAAU,EAAE,KAAK;YACjB,WAAW;YACX,OAAO,EAAE,uDAAuD;SACjE,CAAC;IACJ,CAAC;IAED,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,wBAAwB,CAAC;IACpE,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,OAAO,EAAE;QAC/B,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI;QACjC,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO;KAClC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IACtB,IAAI,GAAG,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,0BAA0B,GAAG,CAAC,MAAM,KAAK,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;IACzE,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IACrF,IAAI,KAAK,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,oDAAoD,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IACvG,CAAC;IACD,OAAO;QACL,EAAE,EAAE,IAAI;QACR,UAAU,EAAE,IAAI;QAChB,WAAW;QACX,OAAO,EAAE,sFAAsF;KAChG,CAAC;AACJ,CAAC"}

package/dist/cli/load-env.d.ts

@@ -0,0 +1 @@
+export declare function loadCliEnv(): string | undefined;

package/dist/cli/load-env.js

@@ -0,0 +1,11 @@
+import fs from "node:fs";
+import path from "node:path";
+import dotenv from "dotenv";
+export function loadCliEnv() {
+    const envFile = process.env.VIDEO_MAKER_ENV_FILE ?? path.join(process.cwd(), ".env");
+    if (!fs.existsSync(envFile))
+        return undefined;
+    dotenv.config({ path: envFile, quiet: true });
+    return envFile;
+}
+//# sourceMappingURL=load-env.js.map

package/dist/cli/load-env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-env.js","sourceRoot":"","sources":["../../src/cli/load-env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,MAAM,MAAM,QAAQ,CAAC;AAE5B,MAAM,UAAU,UAAU;IACxB,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,CAAC;IACrF,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,SAAS,CAAC;IAC9C,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/core/assets.d.ts

@@ -0,0 +1,28 @@
+export interface RequiredAsset {
+    sceneId: string;
+    assetPath: string;
+    absolutePath: string;
+    prompt: string;
+    durationSec: number;
+}
+export interface AssetIssue {
+    sceneId: string;
+    assetPath: string;
+    absolutePath: string;
+    ok: false;
+    error: string;
+}
+export interface VerifiedAsset {
+    sceneId: string;
+    assetPath: string;
+    absolutePath: string;
+    ok: true;
+    width: number;
+    height: number;
+    format?: string;
+}
+export declare function listRequiredAssets(projectId: string): Promise<RequiredAsset[]>;
+export declare function verifyAssets(projectId: string): Promise<{
+    ok: boolean;
+    assets: Array<VerifiedAsset | AssetIssue>;
+}>;

package/dist/core/assets.js

@@ -0,0 +1,50 @@
+import fs from "node:fs/promises";
+import sharp from "sharp";
+import { readVideoPlan, markStatus } from "./project.js";
+import { toProjectPath } from "./paths.js";
+export async function listRequiredAssets(projectId) {
+    const plan = await readVideoPlan(projectId);
+    return plan.scenes.map((scene) => ({
+        sceneId: scene.id,
+        assetPath: scene.assetPath,
+        absolutePath: toProjectPath(projectId, scene.assetPath),
+        prompt: scene.visualPrompt,
+        durationSec: scene.durationSec
+    }));
+}
+export async function verifyAssets(projectId) {
+    const required = await listRequiredAssets(projectId);
+    const assets = await Promise.all(required.map(async (asset) => {
+        try {
+            await fs.access(asset.absolutePath);
+            const metadata = await sharp(asset.absolutePath).metadata();
+            if (!metadata.width || !metadata.height) {
+                throw new Error("Image dimensions could not be read");
+            }
+            return {
+                sceneId: asset.sceneId,
+                assetPath: asset.assetPath,
+                absolutePath: asset.absolutePath,
+                ok: true,
+                width: metadata.width,
+                height: metadata.height,
+                format: metadata.format
+            };
+        }
+        catch (error) {
+            return {
+                sceneId: asset.sceneId,
+                assetPath: asset.assetPath,
+                absolutePath: asset.absolutePath,
+                ok: false,
+                error: error instanceof Error ? error.message : String(error)
+            };
+        }
+    }));
+    const ok = assets.every((asset) => asset.ok);
+    if (ok) {
+        await markStatus(projectId, "assets_ready");
+    }
+    return { ok, assets };
+}
+//# sourceMappingURL=assets.js.map

package/dist/core/assets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assets.js","sourceRoot":"","sources":["../../src/core/assets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AA4B3C,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,SAAiB;IACxD,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,SAAS,CAAC,CAAC;IAC5C,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACjC,OAAO,EAAE,KAAK,CAAC,EAAE;QACjB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,YAAY,EAAE,aAAa,CAAC,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC;QACvD,MAAM,EAAE,KAAK,CAAC,YAAY;QAC1B,WAAW,EAAE,KAAK,CAAC,WAAW;KAC/B,CAAC,CAAC,CAAC;AACN,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,SAAiB;IAIlD,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC,SAAS,CAAC,CAAC;IACrD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,EAAuC,EAAE;QACjG,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;YACpC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,QAAQ,EAAE,CAAC;YAC5D,IAAI,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;gBACxC,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;YACxD,CAAC;YACD,OAAO;gBACL,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,YAAY,EAAE,KAAK,CAAC,YAAY;gBAChC,EAAE,EAAE,IAAI;gBACR,KAAK,EAAE,QAAQ,CAAC,KAAK;gBACrB,MAAM,EAAE,QAAQ,CAAC,MAAM;gBACvB,MAAM,EAAE,QAAQ,CAAC,MAAM;aACxB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,YAAY,EAAE,KAAK,CAAC,YAAY;gBAChC,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAC9D,CAAC;QACJ,CAAC;IACH,CAAC,CAAC,CAAC,CAAC;IACJ,MAAM,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC7C,IAAI,EAAE,EAAE,CAAC;QACP,MAAM,UAAU,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC;AACxB,CAAC"}

package/dist/core/env.d.ts

@@ -0,0 +1,27 @@
+export interface BinaryCheck {
+    installed: boolean;
+    path?: string;
+    version?: string;
+    installCommand?: string;
+    error?: string;
+}
+export interface TtsCheck {
+    configured: boolean;
+    missingEnv: string[];
+}
+export interface EnvironmentCheck {
+    ok: boolean;
+    node: {
+        version: string;
+        ok: boolean;
+    };
+    ffmpeg: BinaryCheck;
+    codex: BinaryCheck;
+    tts: TtsCheck;
+    workspaceDir: string;
+    defaultExportDir: string;
+    nextActions: string[];
+}
+export declare function ffmpegInstallCommand(platform?: NodeJS.Platform): string;
+export declare function resolveBinary(name: string, args?: string[]): Promise<BinaryCheck>;
+export declare function checkEnvironment(): Promise<EnvironmentCheck>;

package/dist/core/env.js

@@ -0,0 +1,89 @@
+import os from "node:os";
+import { execa } from "execa";
+import which from "which";
+import { exportDir, workspaceDir } from "./paths.js";
+function missingTtsEnv(env = process.env) {
+    const missing = [];
+    if (!env.VIDEO_MAKER_TTS_VOICE_ID)
+        missing.push("VIDEO_MAKER_TTS_VOICE_ID");
+    if (env.VIDEO_MAKER_TTS_API_KEY)
+        return missing;
+    if (env.VIDEO_MAKER_TTS_APP_ID && (env.VIDEO_MAKER_TTS_TOKEN || env.VIDEO_MAKER_TTS_ACCESS_TOKEN || env.VOLCENGINE_SECRET_ACCESS_KEY)) {
+        return missing;
+    }
+    missing.push("VIDEO_MAKER_TTS_API_KEY");
+    return missing;
+}
+export function ffmpegInstallCommand(platform = process.platform) {
+    if (platform === "darwin")
+        return "brew install ffmpeg";
+    if (platform === "win32")
+        return "winget install Gyan.FFmpeg";
+    if (platform === "linux") {
+        const distro = os.release().toLowerCase();
+        if (distro.includes("arch"))
+            return "sudo pacman -S ffmpeg";
+        if (distro.includes("fedora"))
+            return "sudo dnf install -y ffmpeg";
+        return "sudo apt update && sudo apt install -y ffmpeg";
+    }
+    return "Install ffmpeg from https://ffmpeg.org/download.html and ensure ffmpeg is on PATH";
+}
+export async function resolveBinary(name, args = ["--version"]) {
+    try {
+        const binaryPath = await which(name);
+        const result = await execa(binaryPath, args, { reject: false });
+        const version = `${result.stdout}\n${result.stderr}`.trim().split("\n")[0];
+        return {
+            installed: result.exitCode === 0,
+            path: binaryPath,
+            version,
+            error: result.exitCode === 0 ? undefined : `${name} exited with ${result.exitCode}`
+        };
+    }
+    catch (error) {
+        return {
+            installed: false,
+            installCommand: name === "ffmpeg" ? ffmpegInstallCommand() : undefined,
+            error: error instanceof Error ? error.message : String(error)
+        };
+    }
+}
+export async function checkEnvironment() {
+    const nodeMajor = Number(process.versions.node.split(".")[0]);
+    const [ffmpeg, codex] = await Promise.all([
+        resolveBinary("ffmpeg", ["-version"]),
+        resolveBinary("codex", ["--version"])
+    ]);
+    const missingEnv = missingTtsEnv();
+    const nextActions = [];
+    if (!ffmpeg.installed) {
+        nextActions.push(`Install ffmpeg: ${ffmpeg.installCommand ?? ffmpegInstallCommand()}`);
+    }
+    if (!codex.installed) {
+        nextActions.push("Install Codex CLI before using the Codex installer integration.");
+    }
+    if (missingEnv.length > 0) {
+        nextActions.push(`Set TTS environment variables: ${missingEnv.join(", ")}`);
+    }
+    if (nodeMajor < 20) {
+        nextActions.push("Install Node.js 20 or newer.");
+    }
+    return {
+        ok: nodeMajor >= 20 && ffmpeg.installed && missingEnv.length === 0,
+        node: {
+            version: process.versions.node,
+            ok: nodeMajor >= 20
+        },
+        ffmpeg,
+        codex,
+        tts: {
+            configured: missingEnv.length === 0,
+            missingEnv
+        },
+        workspaceDir: workspaceDir(),
+        defaultExportDir: exportDir(),
+        nextActions
+    };
+}
+//# sourceMappingURL=env.js.map

package/dist/core/env.js.map

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

package/dist/core/export.d.ts

@@ -0,0 +1,11 @@
+export interface ExportVideoResult {
+    projectId: string;
+    exportDir: string;
+    files: {
+        video: string;
+        subtitles?: string;
+        manifest: string;
+        plan?: string;
+    };
+}
+export declare function exportProjectVideo(projectId: string, outputDir?: string): Promise<ExportVideoResult>;

package/dist/core/export.js

@@ -0,0 +1,39 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { exportDir, resolveUserPath, toProjectPath } from "./paths.js";
+import { markStatus, readManifest } from "./project.js";
+export async function exportProjectVideo(projectId, outputDir) {
+    const manifest = await readManifest(projectId);
+    if (!manifest.outputPath) {
+        throw new Error("Project video is missing. Run render_video before export_video.");
+    }
+    const destinationDir = outputDir ? resolveUserPath(outputDir) : path.join(exportDir(), projectId);
+    await fs.mkdir(destinationDir, { recursive: true });
+    const videoPath = path.join(destinationDir, "final.mp4");
+    const manifestPath = path.join(destinationDir, "manifest.json");
+    const subtitlePath = manifest.subtitlePath ? path.join(destinationDir, "subtitles.srt") : undefined;
+    const planPath = manifest.planPath ? path.join(destinationDir, "video_plan.json") : undefined;
+    await markStatus(projectId, "rendered", {
+        exportedPath: videoPath,
+        exportedAt: new Date().toISOString()
+    });
+    await fs.copyFile(toProjectPath(projectId, manifest.outputPath), videoPath);
+    await fs.copyFile(toProjectPath(projectId, "manifest.json"), manifestPath);
+    if (manifest.subtitlePath && subtitlePath) {
+        await fs.copyFile(toProjectPath(projectId, manifest.subtitlePath), subtitlePath);
+    }
+    if (manifest.planPath && planPath) {
+        await fs.copyFile(toProjectPath(projectId, manifest.planPath), planPath);
+    }
+    return {
+        projectId,
+        exportDir: destinationDir,
+        files: {
+            video: videoPath,
+            subtitles: subtitlePath,
+            manifest: manifestPath,
+            plan: planPath
+        }
+    };
+}
+//# sourceMappingURL=export.js.map

package/dist/core/export.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.js","sourceRoot":"","sources":["../../src/core/export.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACvE,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAaxD,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,SAAiB,EAAE,SAAkB;IAC5E,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,SAAS,CAAC,CAAC;IAC/C,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAC;IACrF,CAAC;IAED,MAAM,cAAc,GAAG,SAAS,CAAC,CAAC,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,SAAS,CAAC,CAAC;IAClG,MAAM,EAAE,CAAC,KAAK,CAAC,cAAc,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEpD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;IACzD,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,eAAe,CAAC,CAAC;IAChE,MAAM,YAAY,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACpG,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAE9F,MAAM,UAAU,CAAC,SAAS,EAAE,UAAU,EAAE;QACtC,YAAY,EAAE,SAAS;QACvB,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACrC,CAAC,CAAC;IAEH,MAAM,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC,SAAS,EAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,CAAC,CAAC;IAC5E,MAAM,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC,SAAS,EAAE,eAAe,CAAC,EAAE,YAAY,CAAC,CAAC;IAC3E,IAAI,QAAQ,CAAC,YAAY,IAAI,YAAY,EAAE,CAAC;QAC1C,MAAM,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC,SAAS,EAAE,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC,CAAC;IACnF,CAAC;IACD,IAAI,QAAQ,CAAC,QAAQ,IAAI,QAAQ,EAAE,CAAC;QAClC,MAAM,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC,SAAS,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC3E,CAAC;IAED,OAAO;QACL,SAAS;QACT,SAAS,EAAE,cAAc;QACzB,KAAK,EAAE;YACL,KAAK,EAAE,SAAS;YAChB,SAAS,EAAE,YAAY;YACvB,QAAQ,EAAE,YAAY;YACtB,IAAI,EAAE,QAAQ;SACf;KACF,CAAC;AACJ,CAAC"}

package/dist/core/paths.d.ts

@@ -0,0 +1,12 @@
+export declare const DEFAULT_WORKSPACE_DIR: string;
+export declare const DEFAULT_EXPORT_DIR: string;
+export declare const PROJECTS_DIR = "projects";
+export declare function workspaceDir(): string;
+export declare function exportDir(): string;
+export declare function resolveUserPath(input: string): string;
+export declare function projectsDir(): string;
+export declare function projectDir(projectId: string): string;
+export declare function toProjectPath(projectId: string, relativePath: string): string;
+export declare function assertSafeProjectId(projectId: string): void;
+export declare function assertProjectRelativePath(relativePath: string): void;
+export declare function makeProjectId(date?: Date): string;