@vibeframe/cli 0.27.0

package/dist/index.js

@@ -0,0 +1,131 @@
+#!/usr/bin/env node
+// Debug: Check if script starts at all
+if (process.env.VIBE_DEBUG === "1") {
+    console.log("[CLI] Script started, loading modules...");
+}
+import { Command } from "commander";
+import { createRequire } from "module";
+import chalk from "chalk";
+const require = createRequire(import.meta.url);
+const pkg = require("../package.json");
+// Re-export engine for library usage
+export { Project, generateId } from "./engine/index.js";
+import { projectCommand } from "./commands/project.js";
+import { timelineCommand } from "./commands/timeline.js";
+import { generateCommand } from "./commands/generate.js";
+import { editCommand } from "./commands/edit-cmd.js";
+import { analyzeCommand } from "./commands/analyze.js";
+import { audioCommand } from "./commands/audio.js";
+import { pipelineCommand } from "./commands/pipeline.js";
+import { schemaCommand } from "./commands/schema.js";
+import { mediaCommand } from "./commands/media.js";
+import { exportCommand } from "./commands/export.js";
+import { batchCommand } from "./commands/batch.js";
+import { detectCommand } from "./commands/detect.js";
+import { setupCommand } from "./commands/setup.js";
+import { doctorCommand } from "./commands/doctor.js";
+import { agentCommand, startAgent } from "./commands/agent.js";
+import { ApiKeyError } from "./utils/api-key.js";
+import { isFirstRun, showFirstRunBanner } from "./utils/first-run.js";
+import { exitWithError } from "./commands/output.js";
+export { startAgent } from "./commands/agent.js";
+export { loadConfig, saveConfig, isConfigured } from "./config/index.js";
+export { AgentExecutor, ToolRegistry, ConversationMemory } from "./agent/index.js";
+const program = new Command();
+program
+    .name("vibe")
+    .showSuggestionAfterError(true)
+    .description("VibeFrame CLI - AI-First Video Editor")
+    .version(pkg.version)
+    .option("--json", "Output in JSON format")
+    .option("-q, --quiet", "Output only the primary result value (path, URL, or ID)")
+    .option("--fields <fields>", "Limit JSON output to specific fields (comma-separated)")
+    .configureOutput({
+    outputError: (str, write) => {
+        write(chalk.red(str.trim()) + "\n");
+        write(chalk.dim("Run with --help for full options.\n"));
+    },
+})
+    .addHelpText("after", `
+Tips:
+  vibe setup               Configure API keys and preferences
+  vibe doctor              Check system health and available commands
+  vibe schema <command>    Show JSON schema for any command (e.g., vibe schema generate.image)
+  vibe                     Start interactive Agent mode (no args)
+
+More commands: vibe project|timeline|export|batch|detect|schema --help
+`);
+// Set JSON mode env var before subcommand parsing
+// Also check for first-run and show banner
+program.hook("preAction", async (thisCommand) => {
+    const opts = program.opts();
+    // --json flag or auto-detect non-TTY stdout
+    if (opts.json || (!process.stdout.isTTY && !process.env.VIBE_HUMAN_OUTPUT)) {
+        process.env.VIBE_JSON_OUTPUT = "1";
+    }
+    // --quiet flag
+    if (opts.quiet) {
+        process.env.VIBE_QUIET_OUTPUT = "1";
+    }
+    // --fields flag
+    if (opts.fields) {
+        process.env.VIBE_OUTPUT_FIELDS = opts.fields;
+    }
+    // Show first-run banner for non-setup/doctor commands
+    const cmdName = thisCommand.name();
+    const skipBannerCommands = ["setup", "doctor", "help"];
+    if (!skipBannerCommands.includes(cmdName) && process.stdin.isTTY) {
+        try {
+            if (await isFirstRun()) {
+                showFirstRunBanner();
+            }
+        }
+        catch {
+            // Don't block on first-run check failure
+        }
+    }
+});
+// Main commands (visible in --help)
+program.addCommand(generateCommand);
+program.addCommand(editCommand);
+program.addCommand(analyzeCommand);
+program.addCommand(audioCommand);
+program.addCommand(pipelineCommand);
+program.addCommand(setupCommand);
+program.addCommand(doctorCommand);
+program.addCommand(agentCommand);
+// Infrastructure commands (hidden from --help, still fully functional)
+program.addCommand(projectCommand, { hidden: true });
+program.addCommand(timelineCommand, { hidden: true });
+program.addCommand(schemaCommand, { hidden: true });
+program.addCommand(mediaCommand, { hidden: true });
+program.addCommand(exportCommand, { hidden: true });
+program.addCommand(batchCommand, { hidden: true });
+program.addCommand(detectCommand, { hidden: true });
+// Check if any arguments provided
+if (process.argv.length <= 2) {
+    // No arguments - start Agent mode
+    if (process.env.VIBE_DEBUG === "1") {
+        console.log("[CLI] No args, starting Agent...");
+    }
+    startAgent().catch((err) => {
+        console.error("Failed to start Agent:", err);
+        process.exit(1);
+    });
+}
+else {
+    // Arguments provided - parse normally with global error handling
+    (async () => {
+        try {
+            await program.parseAsync();
+        }
+        catch (err) {
+            if (err instanceof ApiKeyError) {
+                exitWithError(err.toStructured());
+            }
+            // Re-throw non-ApiKeyError errors
+            throw err;
+        }
+    })();
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/utils/api-key.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Load environment variables from .env files.
+ * Priority: CWD .env (project-scoped) > monorepo root .env (development)
+ * Later loads don't override earlier values, so CWD takes precedence.
+ */
+export declare function loadEnv(): void;
+/**
+ * Get API key from config, environment, or prompt
+ */
+export declare function getApiKey(envVar: string, providerName: string, optionValue?: string): Promise<string | null>;
+/**
+ * Error thrown when a required API key is missing (non-interactive mode)
+ */
+export declare class ApiKeyError extends Error {
+    envVar: string;
+    providerName: string;
+    constructor(envVar: string, providerName: string);
+    toStructured(): {
+        success: false;
+        error: string;
+        code: string;
+        exitCode: number;
+        suggestion: string;
+        retryable: false;
+    };
+}
+/**
+ * Check if an API key is available without prompting or side effects.
+ */
+export declare function hasApiKey(envVar: string): boolean;
+/**
+ * Get API key or throw ApiKeyError if not found.
+ * Use this instead of getApiKey() + manual null check.
+ */
+export declare function requireApiKey(envVar: string, providerName: string, cliOverride?: string): Promise<string>;
+//# sourceMappingURL=api-key.d.ts.map

package/dist/utils/api-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-key.d.ts","sourceRoot":"","sources":["../../src/utils/api-key.ts"],"names":[],"mappings":"AAOA;;;;GAIG;AACH,wBAAgB,OAAO,IAAI,IAAI,CAS9B;AAkED;;GAEG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA2DxB;AAED;;GAEG;AACH,qBAAa,WAAY,SAAQ,KAAK;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;gBAEhB,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM;IAUhD,YAAY,IAAI;QACd,OAAO,EAAE,KAAK,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,KAAK,CAAC;KAClB;CAUF;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAKjD;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,CAAC,CAMjB"}

package/dist/utils/api-key.js

@@ -0,0 +1,211 @@
+import { createInterface } from "node:readline";
+import { readFile, writeFile, access } from "node:fs/promises";
+import { resolve } from "node:path";
+import { config } from "dotenv";
+import chalk from "chalk";
+import { getApiKeyFromConfig } from "../config/index.js";
+/**
+ * Load environment variables from .env files.
+ * Priority: CWD .env (project-scoped) > monorepo root .env (development)
+ * Later loads don't override earlier values, so CWD takes precedence.
+ */
+export function loadEnv() {
+    // 1. Load from current working directory (project-scoped, highest priority)
+    config({ path: resolve(process.cwd(), ".env"), debug: false });
+    // 2. Load from monorepo root if in development (won't override existing vars)
+    const monorepoRoot = findMonorepoRoot();
+    if (monorepoRoot && monorepoRoot !== process.cwd()) {
+        config({ path: resolve(monorepoRoot, ".env"), debug: false });
+    }
+}
+// Find monorepo root for development environments
+function findMonorepoRoot() {
+    let dir = process.cwd();
+    while (dir !== "/") {
+        try {
+            require.resolve(resolve(dir, "pnpm-workspace.yaml"));
+            return dir;
+        }
+        catch {
+            dir = resolve(dir, "..");
+        }
+    }
+    return null;
+}
+/**
+ * Prompt user for input (hidden for API keys)
+ */
+async function prompt(question, hidden = false) {
+    const rl = createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    return new Promise((resolve) => {
+        // For hidden input, we need to handle it differently
+        if (hidden && process.stdin.isTTY) {
+            process.stdout.write(question);
+            let input = "";
+            process.stdin.setRawMode(true);
+            process.stdin.resume();
+            process.stdin.setEncoding("utf8");
+            const onData = (char) => {
+                if (char === "\n" || char === "\r" || char === "\u0004") {
+                    process.stdin.setRawMode(false);
+                    process.stdin.pause();
+                    process.stdin.removeListener("data", onData);
+                    process.stdout.write("\n");
+                    rl.close();
+                    resolve(input);
+                }
+                else if (char === "\u0003") {
+                    // Ctrl+C
+                    process.exit(1);
+                }
+                else if (char === "\u007F" || char === "\b") {
+                    // Backspace
+                    if (input.length > 0) {
+                        input = input.slice(0, -1);
+                    }
+                }
+                else {
+                    input += char;
+                }
+            };
+            process.stdin.on("data", onData);
+        }
+        else {
+            rl.question(question, (answer) => {
+                rl.close();
+                resolve(answer);
+            });
+        }
+    });
+}
+/**
+ * Get API key from config, environment, or prompt
+ */
+export async function getApiKey(envVar, providerName, optionValue) {
+    // 1. Check command line option
+    if (optionValue) {
+        return optionValue;
+    }
+    // 2. Check ~/.vibeframe/config.yaml
+    // Map env var to provider key
+    const providerKeyMap = {
+        ANTHROPIC_API_KEY: "anthropic",
+        OPENAI_API_KEY: "openai",
+        GOOGLE_API_KEY: "google",
+        ELEVENLABS_API_KEY: "elevenlabs",
+        RUNWAY_API_SECRET: "runway",
+        KLING_API_KEY: "kling",
+        IMGBB_API_KEY: "imgbb",
+        REPLICATE_API_TOKEN: "replicate",
+    };
+    const providerKey = providerKeyMap[envVar];
+    if (providerKey) {
+        const configKey = await getApiKeyFromConfig(providerKey);
+        if (configKey) {
+            return configKey;
+        }
+    }
+    // 3. Load .env and check environment
+    loadEnv();
+    const envValue = process.env[envVar];
+    if (envValue) {
+        return envValue;
+    }
+    // 4. Check if running in TTY (interactive terminal)
+    if (!process.stdin.isTTY) {
+        return null;
+    }
+    // 5. Prompt for API key
+    console.log();
+    console.log(chalk.yellow(`${providerName} API key not found.`));
+    console.log(chalk.dim(`Set ${envVar} in .env (current directory), run 'vibe setup', or enter below.`));
+    console.log();
+    const apiKey = await prompt(chalk.cyan(`Enter ${providerName} API key: `), true);
+    if (!apiKey || apiKey.trim() === "") {
+        return null;
+    }
+    // 6. Ask if user wants to save to .env
+    const save = await prompt(chalk.cyan("Save to .env for future use? (y/N): "));
+    if (save.toLowerCase() === "y" || save.toLowerCase() === "yes") {
+        await saveApiKeyToEnv(envVar, apiKey.trim());
+        console.log(chalk.green("API key saved to .env"));
+    }
+    return apiKey.trim();
+}
+/**
+ * Error thrown when a required API key is missing (non-interactive mode)
+ */
+export class ApiKeyError extends Error {
+    envVar;
+    providerName;
+    constructor(envVar, providerName) {
+        super(`${providerName} API key required.\n` +
+            `  Set ${envVar} in .env, or run: vibe setup`);
+        this.name = "ApiKeyError";
+        this.envVar = envVar;
+        this.providerName = providerName;
+    }
+    toStructured() {
+        return {
+            success: false,
+            error: `${this.providerName} API key required.`,
+            code: "API_KEY_MISSING",
+            exitCode: 4,
+            suggestion: `Set ${this.envVar} in .env, or run: vibe setup`,
+            retryable: false,
+        };
+    }
+}
+/**
+ * Check if an API key is available without prompting or side effects.
+ */
+export function hasApiKey(envVar) {
+    loadEnv();
+    if (process.env[envVar])
+        return true;
+    const key = getApiKeyFromConfig(envVar);
+    return !!key;
+}
+/**
+ * Get API key or throw ApiKeyError if not found.
+ * Use this instead of getApiKey() + manual null check.
+ */
+export async function requireApiKey(envVar, providerName, cliOverride) {
+    const key = await getApiKey(envVar, providerName, cliOverride);
+    if (!key) {
+        throw new ApiKeyError(envVar, providerName);
+    }
+    return key;
+}
+/**
+ * Save API key to .env file
+ */
+async function saveApiKeyToEnv(envVar, apiKey) {
+    const envPath = resolve(process.cwd(), ".env");
+    let content = "";
+    try {
+        await access(envPath);
+        content = await readFile(envPath, "utf-8");
+    }
+    catch {
+        // File doesn't exist, will create new
+    }
+    // Check if variable already exists
+    const regex = new RegExp(`^${envVar}=.*$`, "m");
+    if (regex.test(content)) {
+        // Replace existing
+        content = content.replace(regex, `${envVar}=${apiKey}`);
+    }
+    else {
+        // Append new
+        if (content && !content.endsWith("\n")) {
+            content += "\n";
+        }
+        content += `${envVar}=${apiKey}\n`;
+    }
+    await writeFile(envPath, content, "utf-8");
+}
+//# sourceMappingURL=api-key.js.map

package/dist/utils/api-key.js.map

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

package/dist/utils/api-key.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=api-key.test.d.ts.map

package/dist/utils/api-key.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-key.test.d.ts","sourceRoot":"","sources":["../../src/utils/api-key.test.ts"],"names":[],"mappings":""}

package/dist/utils/api-key.test.js

@@ -0,0 +1,35 @@
+import { describe, it, expect, beforeEach, afterEach, vi } from "vitest";
+import { loadEnv, getApiKey } from "./api-key.js";
+describe("api-key utilities", () => {
+    const originalEnv = process.env;
+    beforeEach(() => {
+        vi.resetModules();
+        process.env = { ...originalEnv };
+    });
+    afterEach(() => {
+        process.env = originalEnv;
+    });
+    describe("loadEnv", () => {
+        it("does not throw when .env file is missing", () => {
+            expect(() => loadEnv()).not.toThrow();
+        });
+    });
+    describe("getApiKey", () => {
+        it("returns option value if provided", async () => {
+            const result = await getApiKey("TEST_KEY", "Test", "my-api-key");
+            expect(result).toBe("my-api-key");
+        });
+        it("returns env value if option not provided", async () => {
+            process.env.TEST_KEY = "env-api-key";
+            const result = await getApiKey("TEST_KEY", "Test");
+            expect(result).toBe("env-api-key");
+        });
+        it("returns null when no key available and not TTY", async () => {
+            // In test environment, stdin is not TTY, so it should return null
+            delete process.env.TEST_KEY;
+            const result = await getApiKey("TEST_KEY", "Test");
+            expect(result).toBeNull();
+        });
+    });
+});
+//# sourceMappingURL=api-key.test.js.map

package/dist/utils/api-key.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-key.test.js","sourceRoot":"","sources":["../../src/utils/api-key.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AACzE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAElD,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC;IAEhC,UAAU,CAAC,GAAG,EAAE;QACd,EAAE,CAAC,YAAY,EAAE,CAAC;QAClB,OAAO,CAAC,GAAG,GAAG,EAAE,GAAG,WAAW,EAAE,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,CAAC,GAAG,GAAG,WAAW,CAAC;IAC5B,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,SAAS,EAAE,GAAG,EAAE;QACvB,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;YAClD,MAAM,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QACxC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;QACzB,EAAE,CAAC,kCAAkC,EAAE,KAAK,IAAI,EAAE;YAChD,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC;YACjE,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,0CAA0C,EAAE,KAAK,IAAI,EAAE;YACxD,OAAO,CAAC,GAAG,CAAC,QAAQ,GAAG,aAAa,CAAC;YACrC,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;YACnD,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,gDAAgD,EAAE,KAAK,IAAI,EAAE;YAC9D,kEAAkE;YAClE,OAAO,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC;YAC5B,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;YACnD,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC;QAC5B,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/utils/audio.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Get the duration of an audio file using ffprobe
+ * @param filePath - Path to the audio file
+ * @returns Duration in seconds
+ */
+export declare function getAudioDuration(filePath: string): Promise<number>;
+/**
+ * Get the duration of a video file using ffprobe
+ * @param filePath - Path to the video file
+ * @returns Duration in seconds
+ */
+export declare function getVideoDuration(filePath: string): Promise<number>;
+/**
+ * Extend a video naturally to match target duration using progressive techniques.
+ * Uses slowdown, frame interpolation, and freeze frames based on extension ratio.
+ *
+ * @param videoPath - Path to the source video
+ * @param targetDuration - Target duration in seconds
+ * @param outputPath - Path for the extended video output
+ * @returns Promise that resolves when extension is complete
+ */
+export declare function extendVideoNaturally(videoPath: string, targetDuration: number, outputPath: string): Promise<void>;
+//# sourceMappingURL=audio.d.ts.map

package/dist/utils/audio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio.d.ts","sourceRoot":"","sources":["../../src/utils/audio.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAOxE;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAOxE;AAED;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAuCf"}

package/dist/utils/audio.js

@@ -0,0 +1,79 @@
+import { execSafe, ffprobeDuration } from "./exec-safe.js";
+/**
+ * Get the duration of an audio file using ffprobe
+ * @param filePath - Path to the audio file
+ * @returns Duration in seconds
+ */
+export async function getAudioDuration(filePath) {
+    try {
+        return await ffprobeDuration(filePath);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to get audio duration: ${message}`);
+    }
+}
+/**
+ * Get the duration of a video file using ffprobe
+ * @param filePath - Path to the video file
+ * @returns Duration in seconds
+ */
+export async function getVideoDuration(filePath) {
+    try {
+        return await ffprobeDuration(filePath);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to get video duration: ${message}`);
+    }
+}
+/**
+ * Extend a video naturally to match target duration using progressive techniques.
+ * Uses slowdown, frame interpolation, and freeze frames based on extension ratio.
+ *
+ * @param videoPath - Path to the source video
+ * @param targetDuration - Target duration in seconds
+ * @param outputPath - Path for the extended video output
+ * @returns Promise that resolves when extension is complete
+ */
+export async function extendVideoNaturally(videoPath, targetDuration, outputPath) {
+    const videoDuration = await getVideoDuration(videoPath);
+    const ratio = targetDuration / videoDuration;
+    if (ratio <= 1.0) {
+        // No extension needed, just copy
+        const { copyFile } = await import("node:fs/promises");
+        await copyFile(videoPath, outputPath);
+        return;
+    }
+    if (ratio <= 1.15) {
+        // 0-15% extension: Simple slowdown using setpts
+        // setpts factor = 1/ratio to slow down the video
+        const slowFactor = (1 / ratio).toFixed(4);
+        await execSafe("ffmpeg", ["-y", "-i", videoPath, "-filter:v", `setpts=${slowFactor}*PTS`, "-an", outputPath]);
+    }
+    else if (ratio <= 1.4) {
+        // 15-40% extension: Frame interpolation + slowdown
+        // minterpolate creates smooth slow-motion effect
+        const slowFactor = (1 / ratio).toFixed(4);
+        await execSafe("ffmpeg", ["-y", "-i", videoPath, "-filter:v", `minterpolate=fps=60:mi_mode=mci,setpts=${slowFactor}*PTS`, "-an", outputPath]);
+    }
+    else {
+        // 40%+ extension: Slowdown to 0.7x speed + freeze last frame for remainder
+        // First, slow down to get ~43% extension
+        const slowRatio = 0.7;
+        const slowedDuration = videoDuration / slowRatio;
+        const freezeDuration = targetDuration - slowedDuration;
+        if (freezeDuration <= 0) {
+            // Can achieve target with slowdown alone
+            const slowFactor = (1 / ratio).toFixed(4);
+            await execSafe("ffmpeg", ["-y", "-i", videoPath, "-filter:v", `minterpolate=fps=60:mi_mode=mci,setpts=${slowFactor}*PTS`, "-an", outputPath]);
+        }
+        else {
+            // Need slowdown + freeze frame
+            // Use tpad to extend the last frame
+            const slowFactor = (1 / slowRatio).toFixed(4); // ~1.43 for 0.7x speed
+            await execSafe("ffmpeg", ["-y", "-i", videoPath, "-filter:v", `setpts=${slowFactor}*PTS,tpad=stop_mode=clone:stop_duration=${freezeDuration.toFixed(2)}`, "-an", outputPath]);
+        }
+    }
+}
+//# sourceMappingURL=audio.js.map

package/dist/utils/audio.js.map

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

package/dist/utils/exec-safe.d.ts

@@ -0,0 +1,22 @@
+/** Safe async exec — no shell, args as array */
+export declare function execSafe(cmd: string, args: string[], options?: {
+    timeout?: number;
+    maxBuffer?: number;
+}): Promise<{
+    stdout: string;
+    stderr: string;
+}>;
+/** Safe sync exec — no shell, args as array */
+export declare function execSafeSync(cmd: string, args: string[], options?: {
+    stdio?: "pipe" | "ignore";
+}): string;
+/** Shorthand: ffprobe duration query */
+export declare function ffprobeDuration(filePath: string): Promise<number>;
+/** Shorthand: ffprobe video dimensions */
+export declare function ffprobeVideoSize(filePath: string): Promise<{
+    width: number;
+    height: number;
+}>;
+/** Shorthand: check if a command exists */
+export declare function commandExists(cmd: string): boolean;
+//# sourceMappingURL=exec-safe.d.ts.map

package/dist/utils/exec-safe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec-safe.d.ts","sourceRoot":"","sources":["../../src/utils/exec-safe.ts"],"names":[],"mappings":"AAKA,gDAAgD;AAChD,wBAAsB,QAAQ,CAC5B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GACjD,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAK7C;AAED,+CAA+C;AAC/C,wBAAgB,YAAY,CAC1B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAA;CAAE,GACtC,MAAM,CAKR;AAED,wCAAwC;AACxC,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAavE;AAED,0CAA0C;AAC1C,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAgB5C;AAED,2CAA2C;AAC3C,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAOlD"}

package/dist/utils/exec-safe.js

@@ -0,0 +1,62 @@
+import { execFile, execFileSync } from "node:child_process";
+import { promisify } from "node:util";
+const execFileAsync = promisify(execFile);
+/** Safe async exec — no shell, args as array */
+export async function execSafe(cmd, args, options) {
+    return execFileAsync(cmd, args, {
+        timeout: options?.timeout,
+        maxBuffer: options?.maxBuffer ?? 50 * 1024 * 1024,
+    });
+}
+/** Safe sync exec — no shell, args as array */
+export function execSafeSync(cmd, args, options) {
+    return execFileSync(cmd, args, {
+        encoding: "utf-8",
+        stdio: options?.stdio ?? "pipe",
+    });
+}
+/** Shorthand: ffprobe duration query */
+export async function ffprobeDuration(filePath) {
+    const { stdout } = await execSafe("ffprobe", [
+        "-v",
+        "error",
+        "-show_entries",
+        "format=duration",
+        "-of",
+        "default=noprint_wrappers=1:nokey=1",
+        filePath,
+    ]);
+    const duration = parseFloat(stdout.trim());
+    if (isNaN(duration))
+        throw new Error(`Invalid duration: ${stdout}`);
+    return duration;
+}
+/** Shorthand: ffprobe video dimensions */
+export async function ffprobeVideoSize(filePath) {
+    const { stdout } = await execSafe("ffprobe", [
+        "-v",
+        "error",
+        "-select_streams",
+        "v:0",
+        "-show_entries",
+        "stream=width,height",
+        "-of",
+        "csv=p=0:s=x",
+        filePath,
+    ]);
+    const [w, h] = stdout.trim().split("x").map(Number);
+    if (isNaN(w) || isNaN(h))
+        throw new Error(`Invalid dimensions: ${stdout.trim()}`);
+    return { width: w, height: h };
+}
+/** Shorthand: check if a command exists */
+export function commandExists(cmd) {
+    try {
+        execFileSync("which", [cmd], { stdio: "ignore" });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=exec-safe.js.map