@studiomeyer/mcp-video 1.0.0

package/dist/server.js

@@ -0,0 +1,239 @@
+#!/usr/bin/env node
+/**
+ * Video Production — MCP Server v1.0.0
+ *
+ * 8 consolidated tools (from 33+) for recording, editing, color grading,
+ * audio, text, compositing, speech/narration, and smart screenshots.
+ *
+ * Port: 9847 (HTTP mode, configurable via MCP_PORT)
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+import { logger } from './lib/logger.js';
+import { startDualTransport } from './lib/dual-transport.js';
+import { videoHandlers } from './handlers/video.js';
+import { editingHandlers } from './handlers/editing.js';
+import { capcutHandlers } from './handlers/capcut.js';
+import { postProductionHandlers } from './handlers/post-production.js';
+import { ttsHandlers } from './handlers/tts.js';
+import { smartScreenshotHandlers } from './handlers/smart-screenshot.js';
+const SERVER_NAME = 'mcp-video';
+const SERVER_VERSION = '1.0.0';
+/* eslint-disable @typescript-eslint/no-explicit-any */
+const ALL_HANDLERS = {
+    ...videoHandlers,
+    ...editingHandlers,
+    ...capcutHandlers,
+    ...postProductionHandlers,
+    ...ttsHandlers,
+    ...smartScreenshotHandlers,
+};
+/** Delegate to existing handler by original tool name, fix content type literals */
+async function delegate(name, args) {
+    const handler = ALL_HANDLERS[name];
+    if (!handler)
+        throw new Error(`Unknown handler: ${name}`);
+    const result = await handler(args);
+    // Ensure content items have literal 'text' type for MCP SDK
+    if (result?.content) {
+        for (const item of result.content) {
+            if (item.type === 'text')
+                item.type = 'text';
+        }
+    }
+    return result;
+}
+export function createMcpServer() {
+    const server = new McpServer({ name: SERVER_NAME, version: SERVER_VERSION }, {
+        instructions: `# Video Server — Tool Selection Guide
+
+You have 8 tools for video production. Each has a \`type\` parameter to select the operation.
+
+## Recording:
+- **video_record** — Record websites: cinema (full control), scroll (quick scroll-through), multi-device (desktop+tablet+mobile)
+
+## Editing:
+- **video_edit** — Edit clips: speed (slow-mo/timelapse), crop, reverse, keyframe (zoom/pan), pip (picture-in-picture)
+- **video_color** — Color & effects: grade (brightness/contrast/etc), effect (blur/sharpen/vignette/etc), lut (22 cinema presets), chroma (green screen)
+- **video_audio** — Audio: extract, music (background), ducking (auto volume), mix (multi-track), voice (effects like echo/robot/whisper)
+- **video_text** — Text & captions: subtitles (burn SRT), caption (Whisper AI auto-caption), overlay (animated text layers), animate (15 text animations)
+
+## Post-Production:
+- **video_compose** — Compose: concat (join clips), intro (animated intro/outro), social (format for Instagram/TikTok/etc), social-all (batch all platforms), beat-sync (cuts on music beats), templates (list), render (from template)
+
+## Speech & AI:
+- **video_speech** — TTS & narration: generate (ElevenLabs/OpenAI speech), voices (list available), narrated (full narrated video from script)
+
+## Screenshots:
+- **video_screenshot** — Smart screenshots: capture (element-aware), detect (page feature analysis)
+
+## Decision Flow:
+1. Record website? → video_record
+2. Edit existing video? → video_edit
+3. Color/effects? → video_color
+4. Audio work? → video_audio
+5. Text/captions? → video_text
+6. Join clips/format? → video_compose
+7. Need voiceover? → video_speech
+8. Screenshots? → video_screenshot`,
+    });
+    // ── 1. video_record ────────────────────────────────────
+    server.registerTool('video_record', {
+        title: 'Record Website Video',
+        description: 'Record website videos. Types: cinema (full 60fps with scenes/cursor), scroll (quick scroll-through), multi-device (desktop+tablet+mobile).',
+        inputSchema: z.object({
+            type: z.enum(['cinema', 'scroll', 'multi-device']).describe('Recording type'),
+            url: z.string().min(1).describe('Website URL'),
+        }).passthrough(),
+        annotations: { title: 'Record Video', readOnlyHint: false, openWorldHint: true },
+    }, async (args) => {
+        const { type, ...rest } = args;
+        const handlerName = type === 'cinema' ? 'record_website_video'
+            : type === 'scroll' ? 'record_website_scroll'
+                : 'record_multi_device';
+        return await delegate(handlerName, rest);
+    });
+    // ── 2. video_edit ──────────────────────────────────────
+    server.registerTool('video_edit', {
+        title: 'Edit Video',
+        description: 'Edit video clips. Types: speed (0.25x-4x), crop (region), reverse (± audio), keyframe (zoom/pan animation), pip (picture-in-picture overlay).',
+        inputSchema: z.object({
+            type: z.enum(['speed', 'crop', 'reverse', 'keyframe', 'pip']).describe('Edit operation'),
+        }).passthrough(),
+        annotations: { title: 'Edit Video', readOnlyHint: false },
+    }, async (args) => {
+        const { type, ...rest } = args;
+        const map = {
+            speed: 'adjust_video_speed', crop: 'crop_video', reverse: 'reverse_clip',
+            keyframe: 'add_keyframe_animation', pip: 'compose_picture_in_pip',
+        };
+        return await delegate(map[type], rest);
+    });
+    // ── 3. video_color ─────────────────────────────────────
+    server.registerTool('video_color', {
+        title: 'Color & Effects',
+        description: 'Color grading & visual effects. Types: grade (brightness/contrast/saturation/gamma/temperature), effect (blur/sharpen/vignette/grayscale/sepia/noise/glow), lut (22 cinema presets), chroma (green/blue screen replacement).',
+        inputSchema: z.object({
+            type: z.enum(['grade', 'effect', 'lut', 'chroma']).describe('Color operation'),
+        }).passthrough(),
+        annotations: { title: 'Color & Effects', readOnlyHint: false },
+    }, async (args) => {
+        const { type, ...rest } = args;
+        const map = {
+            grade: 'apply_color_grade', effect: 'apply_video_effect',
+            lut: 'apply_lut_preset', chroma: 'apply_chroma_key',
+        };
+        return await delegate(map[type], rest);
+    });
+    // ── 4. video_audio ─────────────────────────────────────
+    server.registerTool('video_audio', {
+        title: 'Audio Tools',
+        description: 'Audio operations. Types: extract (MP3/AAC/WAV/FLAC from video), music (add background music with fade), ducking (auto volume reduction), mix (multi-track mixing), voice (9 voice effects: echo/reverb/deep/chipmunk/robot/whisper/radio/megaphone/underwater).',
+        inputSchema: z.object({
+            type: z.enum(['extract', 'music', 'ducking', 'mix', 'voice']).describe('Audio operation'),
+        }).passthrough(),
+        annotations: { title: 'Audio', readOnlyHint: false },
+    }, async (args) => {
+        const { type, ...rest } = args;
+        const map = {
+            extract: 'extract_audio', music: 'add_background_music',
+            ducking: 'add_audio_ducking', mix: 'mix_audio_tracks', voice: 'apply_voice_effect',
+        };
+        return await delegate(map[type], rest);
+    });
+    // ── 5. video_text ──────────────────────────────────────
+    server.registerTool('video_text', {
+        title: 'Text & Captions',
+        description: 'Text overlays & captions. Types: subtitles (burn SRT/ASS), caption (Whisper AI auto-caption), overlay (animated text layers), animate (15 text animation styles).',
+        inputSchema: z.object({
+            type: z.enum(['subtitles', 'caption', 'overlay', 'animate']).describe('Text operation'),
+        }).passthrough(),
+        annotations: { title: 'Text & Captions', readOnlyHint: false },
+    }, async (args) => {
+        const { type, ...rest } = args;
+        const map = {
+            subtitles: 'burn_subtitles', caption: 'auto_caption',
+            overlay: 'add_text_overlay', animate: 'animate_text',
+        };
+        return await delegate(map[type], rest);
+    });
+    // ── 6. video_compose ───────────────────────────────────
+    server.registerTool('video_compose', {
+        title: 'Compose & Export',
+        description: 'Compose and export videos. Types: concat (join clips with transitions), intro (animated intro/outro), social (convert to Instagram/TikTok/YouTube/LinkedIn), social-all (batch all platforms), beat-sync (cut on music beats), templates (list available), render (render from template).',
+        inputSchema: z.object({
+            type: z.enum(['concat', 'intro', 'social', 'social-all', 'beat-sync', 'templates', 'render']).describe('Compose operation'),
+        }).passthrough(),
+        annotations: { title: 'Compose & Export', readOnlyHint: false },
+    }, async (args) => {
+        const { type, ...rest } = args;
+        const map = {
+            concat: 'concatenate_videos', intro: 'generate_intro',
+            social: 'convert_social_format', 'social-all': 'convert_all_social_formats',
+            'beat-sync': 'sync_to_beat', templates: 'list_video_templates', render: 'render_template',
+        };
+        return await delegate(map[type], rest);
+    });
+    // ── 7. video_speech ────────────────────────────────────
+    server.registerTool('video_speech', {
+        title: 'Speech & Narration',
+        description: 'Text-to-speech & narrated videos. Types: generate (ElevenLabs/OpenAI TTS), voices (list available voices), narrated (full narrated video: script → TTS → website recording → sync → MP4).',
+        inputSchema: z.object({
+            type: z.enum(['generate', 'voices', 'narrated']).describe('Speech operation'),
+        }).passthrough(),
+        annotations: { title: 'Speech & Narration', readOnlyHint: false, openWorldHint: true },
+    }, async (args) => {
+        const { type, ...rest } = args;
+        const map = {
+            generate: 'generate_speech', voices: 'list_voices', narrated: 'create_narrated_video',
+        };
+        return await delegate(map[type], rest);
+    });
+    // ── 8. video_screenshot ────────────────────────────────
+    server.registerTool('video_screenshot', {
+        title: 'Smart Screenshot',
+        description: 'Smart element-aware screenshots. Types: capture (detect & screenshot specific page features: chat, pricing, hero, etc.), detect (analyze page features without screenshotting).',
+        inputSchema: z.object({
+            type: z.enum(['capture', 'detect']).describe('Screenshot operation'),
+            url: z.string().min(1).describe('Website URL'),
+        }).passthrough(),
+        annotations: { title: 'Smart Screenshot', readOnlyHint: true, openWorldHint: true },
+    }, async (args) => {
+        const { type, ...rest } = args;
+        const handlerName = type === 'capture' ? 'screenshot_element' : 'detect_page_features';
+        return await delegate(handlerName, rest);
+    });
+    return server;
+}
+// ─── Startup Validation ──────────────────────────────────
+import { execSync } from 'child_process';
+import * as fs from 'fs';
+function checkDependencies() {
+    for (const bin of ['ffmpeg', 'ffprobe']) {
+        try {
+            execSync(`which ${bin}`, { stdio: 'pipe' });
+        }
+        catch {
+            logger.error(`${bin} not found. Install ffmpeg: https://ffmpeg.org/download.html`);
+            process.exit(1);
+        }
+    }
+    const outputDir = process.env.VIDEO_OUTPUT_DIR || './output';
+    if (!fs.existsSync(outputDir)) {
+        fs.mkdirSync(outputDir, { recursive: true });
+        logger.info(`Created output directory: ${outputDir}`);
+    }
+}
+// ─── Start ────────────────────────────────────────────────
+checkDependencies();
+startDualTransport(createMcpServer, {
+    serverName: SERVER_NAME,
+    serverVersion: SERVER_VERSION,
+    defaultPort: 9847,
+}).then((result) => {
+    logger.info(`Video MCP Server running — 8 tools (${result.type}${result.port ? ` :${result.port}` : ''})`);
+}).catch((error) => {
+    logger.logError('Fatal error', error);
+    process.exit(1);
+});
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/server.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/server.test.js

@@ -0,0 +1,87 @@
+import { describe, it, expect, vi } from 'vitest';
+vi.mock('./lib/logger.js', () => ({
+    logger: { info: vi.fn(), logError: vi.fn(), warn: vi.fn(), error: vi.fn(), debug: vi.fn() },
+}));
+vi.mock('./lib/dual-transport.js', () => ({
+    startDualTransport: vi.fn().mockResolvedValue({ type: 'stdio' }),
+}));
+vi.mock('./lib/types.js', () => ({
+    jsonResponse: (data, isError) => ({
+        content: [{ type: 'text', text: JSON.stringify(data) }],
+        ...(isError ? { isError: true } : {}),
+    }),
+}));
+vi.mock('playwright', () => ({
+    chromium: { launch: vi.fn() },
+}));
+describe('createMcpServer', () => {
+    it('creates server with 8 tools', async () => {
+        const { createMcpServer } = await import('./server.js');
+        const server = createMcpServer();
+        expect(server).toBeDefined();
+    });
+});
+describe('delegate function', () => {
+    it('server exports createMcpServer', async () => {
+        const mod = await import('./server.js');
+        expect(typeof mod.createMcpServer).toBe('function');
+    });
+});
+describe('handler registries', () => {
+    it('video handlers exist', async () => {
+        const { videoHandlers } = await import('./handlers/video.js');
+        expect(videoHandlers).toBeDefined();
+        expect(videoHandlers.record_website_video).toBeDefined();
+        expect(videoHandlers.record_website_scroll).toBeDefined();
+        expect(videoHandlers.record_multi_device).toBeDefined();
+    });
+    it('editing handlers exist', async () => {
+        const { editingHandlers } = await import('./handlers/editing.js');
+        expect(editingHandlers).toBeDefined();
+        expect(editingHandlers.adjust_video_speed).toBeDefined();
+        expect(editingHandlers.crop_video).toBeDefined();
+        expect(editingHandlers.reverse_clip).toBeDefined();
+    });
+    it('capcut handlers exist', async () => {
+        const { capcutHandlers } = await import('./handlers/capcut.js');
+        expect(capcutHandlers).toBeDefined();
+        expect(capcutHandlers.apply_lut_preset).toBeDefined();
+        expect(capcutHandlers.sync_to_beat).toBeDefined();
+    });
+    it('post-production handlers exist', async () => {
+        const { postProductionHandlers } = await import('./handlers/post-production.js');
+        expect(postProductionHandlers).toBeDefined();
+        expect(postProductionHandlers.concatenate_videos).toBeDefined();
+        expect(postProductionHandlers.convert_social_format).toBeDefined();
+    });
+    it('tts handlers exist', async () => {
+        const { ttsHandlers } = await import('./handlers/tts.js');
+        expect(ttsHandlers).toBeDefined();
+        expect(ttsHandlers.generate_speech).toBeDefined();
+        expect(ttsHandlers.list_voices).toBeDefined();
+        expect(ttsHandlers.create_narrated_video).toBeDefined();
+    });
+    it('screenshot handlers exist', async () => {
+        const { smartScreenshotHandlers } = await import('./handlers/smart-screenshot.js');
+        expect(smartScreenshotHandlers).toBeDefined();
+        expect(smartScreenshotHandlers.screenshot_element).toBeDefined();
+        expect(smartScreenshotHandlers.detect_page_features).toBeDefined();
+    });
+});
+describe('tool consolidation', () => {
+    it('all handler names are covered by delegate map', () => {
+        const allOriginalNames = [
+            'record_website_video', 'record_website_scroll', 'record_multi_device',
+            'adjust_video_speed', 'crop_video', 'reverse_clip', 'add_keyframe_animation', 'compose_picture_in_pip',
+            'apply_color_grade', 'apply_video_effect', 'apply_lut_preset', 'apply_chroma_key',
+            'extract_audio', 'add_background_music', 'add_audio_ducking', 'mix_audio_tracks', 'apply_voice_effect',
+            'burn_subtitles', 'auto_caption', 'add_text_overlay', 'animate_text',
+            'concatenate_videos', 'generate_intro', 'convert_social_format', 'convert_all_social_formats',
+            'sync_to_beat', 'list_video_templates', 'render_template',
+            'generate_speech', 'list_voices', 'create_narrated_video',
+            'screenshot_element', 'detect_page_features',
+        ];
+        expect(allOriginalNames.length).toBe(33);
+    });
+});
+//# sourceMappingURL=server.test.js.map

package/dist/server.test.js.map

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

package/dist/tools/engine/audio-mixer.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Audio Mixer Engine — Multi-track audio mixing with auto-ducking.
+ *
+ * Mixes N audio tracks (voiceover + music + SFX) into one.
+ * Auto-ducking: automatically lowers music volume when speech is detected.
+ * Per-track: volume, fade in/out.
+ */
+export interface AudioTrack {
+    /** Path to audio or video file (audio stream will be used) */
+    path: string;
+    /** Volume: 0.0-2.0 (1.0 = original). Default: 1.0 */
+    volume?: number;
+    /** Fade in duration in seconds (default: 0) */
+    fadeIn?: number;
+    /** Fade out duration in seconds (default: 0) */
+    fadeOut?: number;
+    /** Start time offset in seconds — delay this track. Default: 0 */
+    delay?: number;
+    /** Track role for auto-ducking: 'voice' tracks trigger ducking on 'music' tracks */
+    role?: 'voice' | 'music' | 'sfx';
+}
+export interface AudioMixConfig {
+    /** Audio/video tracks to mix together */
+    tracks: AudioTrack[];
+    outputPath: string;
+    /** Enable auto-ducking: music volume reduces when voice is active. Default: false */
+    autoDuck?: boolean;
+    /** How much to reduce music volume during speech: 0.0-1.0 (0.2 = reduce to 20%). Default: 0.2 */
+    duckLevel?: number;
+    /** Output format: 'mp3', 'aac', 'wav'. Default: 'aac' */
+    format?: 'mp3' | 'aac' | 'wav';
+    /** Duration of output in seconds. If omitted, uses longest track. */
+    duration?: number;
+}
+export interface AudioMixResult {
+    outputPath: string;
+    trackCount: number;
+    ducking: boolean;
+}
+export declare function mixAudioTracks(config: AudioMixConfig): Promise<AudioMixResult>;

package/dist/tools/engine/audio-mixer.js

@@ -0,0 +1,169 @@
+/**
+ * Audio Mixer Engine — Multi-track audio mixing with auto-ducking.
+ *
+ * Mixes N audio tracks (voiceover + music + SFX) into one.
+ * Auto-ducking: automatically lowers music volume when speech is detected.
+ * Per-track: volume, fade in/out.
+ */
+import { execFile } from 'child_process';
+import * as fs from 'fs';
+import * as path from 'path';
+import { logger } from '../../lib/logger.js';
+// ─── Helpers ────────────────────────────────────────────────────────
+function runFfmpeg(args, timeoutMs = 300_000) {
+    return new Promise((resolve, reject) => {
+        execFile('ffmpeg', args, { maxBuffer: 100 * 1024 * 1024, timeout: timeoutMs }, (error, stdout, stderr) => {
+            if (error) {
+                logger.error(`ffmpeg failed: ${stderr}`);
+                reject(new Error(`ffmpeg failed: ${stderr || error.message}`));
+                return;
+            }
+            resolve(stdout);
+        });
+    });
+}
+function ensureDir(filePath) {
+    const dir = path.dirname(filePath);
+    if (!fs.existsSync(dir))
+        fs.mkdirSync(dir, { recursive: true });
+}
+function assertExists(filePath, label = 'File') {
+    if (!fs.existsSync(filePath))
+        throw new Error(`${label} not found: ${filePath}`);
+}
+function fileInfo(filePath) {
+    const stats = fs.statSync(filePath);
+    return `${(stats.size / 1024 / 1024).toFixed(2)} MB`;
+}
+function getMediaDuration(filePath) {
+    return new Promise((resolve, reject) => {
+        execFile('ffprobe', ['-v', 'quiet', '-show_entries', 'format=duration', '-of', 'csv=p=0', filePath], (error, stdout) => {
+            if (error) {
+                reject(new Error(`ffprobe failed: ${error.message}`));
+                return;
+            }
+            const dur = parseFloat(stdout.trim());
+            resolve(isNaN(dur) ? 0 : dur);
+        });
+    });
+}
+// ─── Main Function ──────────────────────────────────────────────────
+export async function mixAudioTracks(config) {
+    const { tracks, outputPath, autoDuck = false, duckLevel = 0.2, format = 'aac', duration, } = config;
+    if (tracks.length < 2)
+        throw new Error('Need at least 2 audio tracks to mix');
+    if (tracks.length > 8)
+        throw new Error('Maximum 8 tracks supported');
+    // Validate all files exist
+    for (const track of tracks) {
+        assertExists(track.path, `Audio track`);
+    }
+    ensureDir(outputPath);
+    logger.info(`Mixing ${tracks.length} audio tracks (duck: ${autoDuck}, format: ${format})`);
+    const args = ['-y'];
+    const filterParts = [];
+    const inputLabels = [];
+    // Add inputs
+    for (let i = 0; i < tracks.length; i++) {
+        args.push('-i', tracks[i].path);
+    }
+    // Build per-track filter chains
+    for (let i = 0; i < tracks.length; i++) {
+        const track = tracks[i];
+        const vol = track.volume ?? 1.0;
+        const fadeIn = track.fadeIn ?? 0;
+        const fadeOut = track.fadeOut ?? 0;
+        const delay = track.delay ?? 0;
+        const subFilters = [];
+        // Volume adjustment
+        if (vol !== 1.0) {
+            subFilters.push(`volume=${vol.toFixed(3)}`);
+        }
+        // Delay (adelay in milliseconds)
+        if (delay > 0) {
+            subFilters.push(`adelay=${Math.round(delay * 1000)}|${Math.round(delay * 1000)}`);
+        }
+        // Fade in
+        if (fadeIn > 0) {
+            subFilters.push(`afade=t=in:st=0:d=${fadeIn}`);
+        }
+        // Fade out — need duration for this
+        if (fadeOut > 0) {
+            try {
+                const dur = duration ?? await getMediaDuration(track.path);
+                if (dur > fadeOut) {
+                    subFilters.push(`afade=t=out:st=${(dur - fadeOut).toFixed(2)}:d=${fadeOut}`);
+                }
+            }
+            catch {
+                // Skip fade out if we can't get duration
+            }
+        }
+        const label = `a${i}`;
+        if (subFilters.length > 0) {
+            filterParts.push(`[${i}:a]${subFilters.join(',')}[${label}]`);
+        }
+        else {
+            filterParts.push(`[${i}:a]anull[${label}]`);
+        }
+        inputLabels.push(`[${label}]`);
+    }
+    if (autoDuck && tracks.some(t => t.role === 'voice') && tracks.some(t => t.role === 'music')) {
+        // Auto-ducking: use sidechaincompress on music tracks triggered by voice
+        const voiceIdx = tracks.findIndex(t => t.role === 'voice');
+        const musicIdx = tracks.findIndex(t => t.role === 'music');
+        if (voiceIdx !== -1 && musicIdx !== -1) {
+            const voiceLabel = `a${voiceIdx}`;
+            const musicLabel = `a${musicIdx}`;
+            const duckRatio = Math.round(1 / Math.max(0.05, duckLevel));
+            // Sidechain compress: music is ducked when voice is loud
+            filterParts.push(`[${musicLabel}][${voiceLabel}]sidechaincompress=threshold=0.02:ratio=${duckRatio}:attack=20:release=300:level_sc=1[ducked]`);
+            // Build final mix — replace music label with ducked
+            const mixLabels = inputLabels.map((label, idx) => {
+                if (idx === musicIdx)
+                    return '[ducked]';
+                if (idx === voiceIdx)
+                    return `[${voiceLabel}]`;
+                return label;
+            });
+            // Use amix to combine all
+            filterParts.push(`${mixLabels.join('')}amix=inputs=${tracks.length}:duration=longest:dropout_transition=2:normalize=0[out]`);
+        }
+        else {
+            // Fallback: simple amix
+            filterParts.push(`${inputLabels.join('')}amix=inputs=${tracks.length}:duration=longest:dropout_transition=2:normalize=0[out]`);
+        }
+    }
+    else {
+        // Simple amix without ducking
+        filterParts.push(`${inputLabels.join('')}amix=inputs=${tracks.length}:duration=longest:dropout_transition=2:normalize=0[out]`);
+    }
+    args.push('-filter_complex', filterParts.join(';'));
+    args.push('-map', '[out]');
+    // Duration limit
+    if (duration) {
+        args.push('-t', String(duration));
+    }
+    // Output codec
+    switch (format) {
+        case 'mp3':
+            args.push('-c:a', 'libmp3lame', '-b:a', '192k');
+            break;
+        case 'wav':
+            args.push('-c:a', 'pcm_s16le');
+            break;
+        case 'aac':
+        default:
+            args.push('-c:a', 'aac', '-b:a', '192k');
+            break;
+    }
+    args.push(outputPath);
+    await runFfmpeg(args);
+    logger.info(`Audio mixed: ${tracks.length} tracks → ${outputPath} (${fileInfo(outputPath)})`);
+    return {
+        outputPath,
+        trackCount: tracks.length,
+        ducking: autoDuck,
+    };
+}
+//# sourceMappingURL=audio-mixer.js.map

package/dist/tools/engine/audio-mixer.js.map

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

package/dist/tools/engine/audio.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Audio engine — background music, fade, loop, volume control
+ * All processing via ffmpeg + ffprobe (no npm dependencies)
+ */
+export declare function getMediaDuration(filePath: string): Promise<number>;
+export interface AddMusicConfig {
+    /** Path to video file */
+    videoPath: string;
+    /** Path to audio file (mp3, wav, aac, ogg) */
+    musicPath: string;
+    /** Output path */
+    outputPath: string;
+    /** Music volume 0.0-1.0 (default: 0.25) */
+    musicVolume?: number;
+    /** Fade in duration in seconds (default: 2) */
+    fadeInDuration?: number;
+    /** Fade out duration in seconds (default: 3) */
+    fadeOutDuration?: number;
+    /** Loop music if shorter than video (default: true) */
+    loopMusic?: boolean;
+}
+export declare function addBackgroundMusic(config: AddMusicConfig): Promise<string>;