vidpipe 1.0.0

package/dist/agents/SilenceRemovalAgent.js

@@ -0,0 +1,208 @@
+import ffmpeg from 'fluent-ffmpeg';
+import path from 'path';
+import { BaseAgent } from './BaseAgent';
+import { detectSilence } from '../tools/ffmpeg/silenceDetection';
+import { singlePassEdit } from '../tools/ffmpeg/singlePassEdit';
+import logger from '../config/logger';
+const ffmpegPath = process.env.FFMPEG_PATH || 'ffmpeg';
+const ffprobePath = process.env.FFPROBE_PATH || 'ffprobe';
+ffmpeg.setFfmpegPath(ffmpegPath);
+ffmpeg.setFfprobePath(ffprobePath);
+// ── System prompt ───────────────────────────────────────────────────────────
+const SYSTEM_PROMPT = `You are a video editor AI that decides which silent regions in a video should be removed.
+You will receive a transcript with timestamps and a list of detected silence regions.
+
+Be CONSERVATIVE. Only remove silence that is CLEARLY dead air — no speech, no demonstration, no purpose.
+Aim to remove no more than 10-15% of total video duration.
+When in doubt, KEEP the silence.
+
+KEEP silences that are:
+- Dramatic pauses after impactful statements
+- Brief thinking pauses (< 2 seconds) in natural speech
+- Pauses before important reveals or demonstrations
+- Pauses where the speaker is clearly showing something on screen
+- Silence during screen demonstrations or typing — the viewer is watching the screen
+
+REMOVE silences that are:
+- Dead air with no purpose (> 3 seconds of nothing)
+- Gaps between topics where the speaker was gathering thoughts
+- Silence at the very beginning or end of the video
+
+Return a JSON array of silence regions to REMOVE (not keep).
+When you have decided, call the **decide_removals** tool with your removal list.`;
+// ── JSON Schema for the decide_removals tool ────────────────────────────────
+const DECIDE_REMOVALS_SCHEMA = {
+    type: 'object',
+    properties: {
+        removals: {
+            type: 'array',
+            description: 'Array of silence regions to remove',
+            items: {
+                type: 'object',
+                properties: {
+                    start: { type: 'number', description: 'Start time in seconds' },
+                    end: { type: 'number', description: 'End time in seconds' },
+                    reason: { type: 'string', description: 'Why this silence should be removed' },
+                },
+                required: ['start', 'end', 'reason'],
+            },
+        },
+    },
+    required: ['removals'],
+};
+// ── Agent ────────────────────────────────────────────────────────────────────
+class SilenceRemovalAgent extends BaseAgent {
+    removals = [];
+    constructor() {
+        super('SilenceRemovalAgent', SYSTEM_PROMPT);
+    }
+    getTools() {
+        return [
+            {
+                name: 'decide_removals',
+                description: 'Submit the list of silence regions to remove. Call this once with all removal decisions.',
+                parameters: DECIDE_REMOVALS_SCHEMA,
+                handler: async (args) => {
+                    return this.handleToolCall('decide_removals', args);
+                },
+            },
+        ];
+    }
+    async handleToolCall(toolName, args) {
+        if (toolName === 'decide_removals') {
+            this.removals = args.removals;
+            logger.info(`[SilenceRemovalAgent] Decided to remove ${this.removals.length} silence regions`);
+            return { success: true, count: this.removals.length };
+        }
+        throw new Error(`Unknown tool: ${toolName}`);
+    }
+    getRemovals() {
+        return this.removals;
+    }
+}
+// ── FFmpeg helpers ───────────────────────────────────────────────────────────
+function getVideoDuration(videoPath) {
+    return new Promise((resolve, reject) => {
+        ffmpeg.ffprobe(videoPath, (err, metadata) => {
+            if (err)
+                return reject(new Error(`ffprobe failed: ${err.message}`));
+            resolve(metadata.format.duration ?? 0);
+        });
+    });
+}
+// ── Public API ───────────────────────────────────────────────────────────────
+/**
+ * Detect silence, use the agent to decide context-aware removals, and produce
+ * an edited video with dead silence removed.
+ *
+ * Returns the path to the edited video, or the original path if no edits were needed.
+ */
+export async function removeDeadSilence(video, transcript) {
+    const noEdit = { editedPath: video.repoPath, removals: [], keepSegments: [], wasEdited: false };
+    // 1. Detect silence regions (FFmpeg already filters to >= 0.5s via d=0.5)
+    const silenceRegions = await detectSilence(video.repoPath, 0.5);
+    if (silenceRegions.length === 0) {
+        logger.info('[SilenceRemoval] No silence regions detected — skipping');
+        return noEdit;
+    }
+    const totalSilence = silenceRegions.reduce((sum, r) => sum + r.duration, 0);
+    logger.info(`[SilenceRemoval] ${silenceRegions.length} silence regions detected (${totalSilence.toFixed(1)}s total silence)`);
+    // Only send silence regions >= 2s to the agent; short pauses are natural speech rhythm
+    let regionsForAgent = silenceRegions.filter(r => r.duration >= 2);
+    if (regionsForAgent.length === 0) {
+        logger.info('[SilenceRemoval] No silence regions >= 2s — skipping');
+        return noEdit;
+    }
+    // Cap at 30 longest regions to fit in context window
+    if (regionsForAgent.length > 30) {
+        regionsForAgent = [...regionsForAgent].sort((a, b) => b.duration - a.duration).slice(0, 30);
+        regionsForAgent.sort((a, b) => a.start - b.start); // restore chronological order
+        logger.info(`[SilenceRemoval] Capped to top 30 longest regions for agent analysis`);
+    }
+    // 2. Run the agent to decide which silences to remove
+    const agent = new SilenceRemovalAgent();
+    const transcriptLines = transcript.segments.map((seg) => `[${seg.start.toFixed(2)}s – ${seg.end.toFixed(2)}s] ${seg.text}`);
+    const silenceLines = regionsForAgent.map((r, i) => `${i + 1}. ${r.start.toFixed(2)}s – ${r.end.toFixed(2)}s (${r.duration.toFixed(2)}s)`);
+    const prompt = [
+        `Video: ${video.filename} (${transcript.duration.toFixed(1)}s total)\n`,
+        '--- TRANSCRIPT ---\n',
+        transcriptLines.join('\n'),
+        '\n--- END TRANSCRIPT ---\n',
+        '--- SILENCE REGIONS ---\n',
+        silenceLines.join('\n'),
+        '\n--- END SILENCE REGIONS ---\n',
+        'Analyze the context around each silence region and decide which to remove.',
+    ].join('\n');
+    let removals;
+    try {
+        await agent.run(prompt);
+        removals = agent.getRemovals();
+    }
+    finally {
+        await agent.destroy();
+    }
+    if (removals.length === 0) {
+        logger.info('[SilenceRemoval] Agent decided to keep all silences — skipping edit');
+        return noEdit;
+    }
+    // Safety: cap removals at 20% of video duration
+    const maxRemoval = transcript.duration * 0.20;
+    let totalRemoval = 0;
+    const cappedRemovals = [];
+    const byDuration = [...removals].sort((a, b) => (b.end - b.start) - (a.end - a.start));
+    for (const r of byDuration) {
+        const dur = r.end - r.start;
+        if (totalRemoval + dur <= maxRemoval) {
+            cappedRemovals.push(r);
+            totalRemoval += dur;
+        }
+    }
+    if (cappedRemovals.length < removals.length) {
+        logger.warn(`[SilenceRemoval] Capped from ${removals.length} to ${cappedRemovals.length} regions (${totalRemoval.toFixed(1)}s) to stay under 20% threshold`);
+    }
+    removals = cappedRemovals;
+    if (removals.length === 0) {
+        logger.info('[SilenceRemoval] All removals exceeded 20% cap — skipping edit');
+        return noEdit;
+    }
+    // 3. Build list of segments to KEEP (inverse of removal regions)
+    const videoDuration = await getVideoDuration(video.repoPath);
+    const sortedRemovals = [...removals].sort((a, b) => a.start - b.start);
+    const keepSegments = [];
+    let cursor = 0;
+    for (const removal of sortedRemovals) {
+        if (removal.start > cursor) {
+            keepSegments.push({ start: cursor, end: removal.start });
+        }
+        cursor = Math.max(cursor, removal.end);
+    }
+    if (cursor < videoDuration) {
+        keepSegments.push({ start: cursor, end: videoDuration });
+    }
+    if (keepSegments.length === 0) {
+        logger.warn('[SilenceRemoval] No segments to keep — returning original');
+        return noEdit;
+    }
+    // 4. Single-pass re-encode with trim+setpts+concat for frame-accurate cuts
+    const editedPath = path.join(video.videoDir, `${video.slug}-edited.mp4`);
+    await singlePassEdit(video.repoPath, keepSegments, editedPath);
+    // Compute effective removals (merged, non-overlapping) from keep-segments
+    const effectiveRemovals = [];
+    let prevEnd = 0;
+    for (const seg of keepSegments) {
+        if (seg.start > prevEnd) {
+            effectiveRemovals.push({ start: prevEnd, end: seg.start });
+        }
+        prevEnd = seg.end;
+    }
+    // Don't add trailing silence as a "removal" — it's just the end of the video
+    const actualRemoved = effectiveRemovals.reduce((sum, r) => sum + (r.end - r.start), 0);
+    logger.info(`[SilenceRemoval] Removed ${effectiveRemovals.length} silence regions (${actualRemoved.toFixed(1)}s). Output: ${editedPath}`);
+    return {
+        editedPath,
+        removals: effectiveRemovals,
+        keepSegments,
+        wasEdited: true,
+    };
+}
+//# sourceMappingURL=SilenceRemovalAgent.js.map

package/dist/agents/SilenceRemovalAgent.js.map

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

package/dist/agents/SocialMediaAgent.d.ts

@@ -0,0 +1,4 @@
+import { ShortClip, SocialPost, Transcript, VideoFile, VideoSummary } from '../types';
+export declare function generateShortPosts(video: VideoFile, short: ShortClip, transcript: Transcript): Promise<SocialPost[]>;
+export declare function generateSocialPosts(video: VideoFile, transcript: Transcript, summary: VideoSummary, outputDir?: string): Promise<SocialPost[]>;
+//# sourceMappingURL=SocialMediaAgent.d.ts.map

package/dist/agents/SocialMediaAgent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SocialMediaAgent.d.ts","sourceRoot":"","sources":["../../src/agents/SocialMediaAgent.ts"],"names":[],"mappings":"AAMA,OAAO,EAEL,SAAS,EACT,UAAU,EACV,UAAU,EACV,SAAS,EACT,YAAY,EACb,MAAM,UAAU,CAAA;AAwMjB,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,SAAS,EAChB,KAAK,EAAE,SAAS,EAChB,UAAU,EAAE,UAAU,GACrB,OAAO,CAAC,UAAU,EAAE,CAAC,CAyDvB;AAED,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,SAAS,EAChB,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,YAAY,EACrB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,UAAU,EAAE,CAAC,CAsDvB"}

package/dist/agents/SocialMediaAgent.js

@@ -0,0 +1,248 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { BaseAgent } from './BaseAgent';
+import logger from '../config/logger';
+import { searchWeb } from '../tools/search/exaClient';
+import { Platform, } from '../types';
+// ── System prompt ───────────────────────────────────────────────────────────
+const SYSTEM_PROMPT = `You are a viral social-media content strategist.
+Given a video transcript and summary you MUST generate one post for each of the 5 platforms listed below.
+Each post must match the platform's tone, format, and constraints exactly.
+
+Platform guidelines:
+1. **TikTok** – Casual, hook-driven, trending hashtags, 150 chars max, emoji-heavy.
+2. **YouTube** – Descriptive, SEO-optimized title + description, relevant tags.
+3. **Instagram** – Visual storytelling, emoji-rich, 30 hashtags max, engaging caption.
+4. **LinkedIn** – Professional, thought-leadership, industry insights, 1-3 hashtags.
+5. **X (Twitter)** – Concise, punchy, 280 chars max, 2-5 hashtags, thread-ready.
+
+IMPORTANT – Content format:
+The "content" field you provide must be the FINAL, ready-to-post text that can be directly copied and pasted onto the platform. Do NOT use markdown headers, bullet points, or any formatting inside the content. Include hashtags inline at the end of the post text where appropriate. The content is saved as-is for direct posting.
+
+Workflow:
+1. First call the "search_links" tool with the key topics to find relevant URLs.
+2. Then call the "create_posts" tool with a JSON object that has a "posts" array.
+   Each element must have: platform, content, hashtags (array), links (array), characterCount.
+
+Include relevant links in posts when search results provide them.
+Always call "create_posts" exactly once with all 5 platform posts.`;
+// ── Agent ────────────────────────────────────────────────────────────────────
+class SocialMediaAgent extends BaseAgent {
+    collectedPosts = [];
+    constructor() {
+        super('SocialMediaAgent', SYSTEM_PROMPT);
+    }
+    getTools() {
+        return [
+            {
+                name: 'search_links',
+                description: 'Search for relevant URLs based on topics discussed in the video.',
+                parameters: {
+                    type: 'object',
+                    properties: {
+                        topics: {
+                            type: 'array',
+                            items: { type: 'string' },
+                            description: 'List of topics to search for',
+                        },
+                    },
+                    required: ['topics'],
+                },
+                handler: async (args) => {
+                    const { topics } = args;
+                    logger.info(`[SocialMediaAgent] search_links called with topics: ${topics.join(', ')}`);
+                    const allResults = {};
+                    for (const topic of topics) {
+                        allResults[topic] = await searchWeb(topic, 3);
+                    }
+                    return JSON.stringify({ results: allResults });
+                },
+            },
+            {
+                name: 'create_posts',
+                description: 'Submit the generated social media posts for all 5 platforms.',
+                parameters: {
+                    type: 'object',
+                    properties: {
+                        posts: {
+                            type: 'array',
+                            items: {
+                                type: 'object',
+                                properties: {
+                                    platform: { type: 'string' },
+                                    content: { type: 'string' },
+                                    hashtags: { type: 'array', items: { type: 'string' } },
+                                    links: { type: 'array', items: { type: 'string' } },
+                                    characterCount: { type: 'number' },
+                                },
+                                required: ['platform', 'content', 'hashtags', 'links', 'characterCount'],
+                            },
+                            description: 'Array of posts, one per platform',
+                        },
+                    },
+                    required: ['posts'],
+                },
+                handler: async (args) => {
+                    const { posts } = args;
+                    this.collectedPosts = posts;
+                    logger.info(`[SocialMediaAgent] create_posts received ${posts.length} posts`);
+                    return JSON.stringify({ success: true, count: posts.length });
+                },
+            },
+        ];
+    }
+    async handleToolCall(toolName, args) {
+        // Tool dispatch is handled inline via tool handlers above.
+        // This satisfies the abstract contract from BaseAgent.
+        logger.warn(`[SocialMediaAgent] Unexpected handleToolCall for "${toolName}"`);
+        return { error: `Unknown tool: ${toolName}` };
+    }
+    getCollectedPosts() {
+        return this.collectedPosts;
+    }
+}
+// ── Helper: map raw platform string → Platform enum ─────────────────────────
+function toPlatformEnum(raw) {
+    const normalised = raw.toLowerCase().trim();
+    switch (normalised) {
+        case 'tiktok':
+            return Platform.TikTok;
+        case 'youtube':
+            return Platform.YouTube;
+        case 'instagram':
+            return Platform.Instagram;
+        case 'linkedin':
+            return Platform.LinkedIn;
+        case 'x':
+        case 'twitter':
+            return Platform.X;
+        default:
+            return normalised;
+    }
+}
+function renderPostFile(post, opts) {
+    const now = new Date().toISOString();
+    const platform = toPlatformEnum(post.platform);
+    const lines = ['---'];
+    lines.push(`platform: ${platform}`);
+    lines.push(`status: draft`);
+    lines.push(`scheduledDate: null`);
+    if (post.hashtags.length > 0) {
+        lines.push('hashtags:');
+        for (const tag of post.hashtags) {
+            lines.push(`  - "${tag}"`);
+        }
+    }
+    else {
+        lines.push('hashtags: []');
+    }
+    if (post.links.length > 0) {
+        lines.push('links:');
+        for (const link of post.links) {
+            lines.push(`  - url: "${link}"`);
+            lines.push(`    title: null`);
+        }
+    }
+    else {
+        lines.push('links: []');
+    }
+    lines.push(`characterCount: ${post.characterCount}`);
+    lines.push(`videoSlug: "${opts.videoSlug}"`);
+    lines.push(`shortSlug: ${opts.shortSlug ? `"${opts.shortSlug}"` : 'null'}`);
+    lines.push(`createdAt: "${now}"`);
+    lines.push('---');
+    lines.push('');
+    lines.push(post.content);
+    lines.push('');
+    return lines.join('\n');
+}
+// ── Public API ──────────────────────────────────────────────────────────────
+export async function generateShortPosts(video, short, transcript) {
+    const agent = new SocialMediaAgent();
+    try {
+        // Extract transcript segments that overlap with the short's time ranges
+        const relevantText = transcript.segments
+            .filter((seg) => short.segments.some((ss) => seg.start < ss.end && seg.end > ss.start))
+            .map((seg) => seg.text)
+            .join(' ');
+        const userMessage = [
+            '## Short Clip Metadata',
+            `- **Title:** ${short.title}`,
+            `- **Description:** ${short.description}`,
+            `- **Duration:** ${short.totalDuration.toFixed(1)}s`,
+            `- **Tags:** ${short.tags.join(', ')}`,
+            '',
+            '## Relevant Transcript',
+            relevantText.slice(0, 3000),
+        ].join('\n');
+        await agent.run(userMessage);
+        const collectedPosts = agent.getCollectedPosts();
+        // Save posts to recordings/{slug}/shorts/{short-slug}/posts/
+        const shortsDir = path.join(path.dirname(video.repoPath), 'shorts');
+        const postsDir = path.join(shortsDir, short.slug, 'posts');
+        fs.mkdirSync(postsDir, { recursive: true });
+        const socialPosts = collectedPosts.map((p) => {
+            const platform = toPlatformEnum(p.platform);
+            const outputPath = path.join(postsDir, `${platform}.md`);
+            fs.writeFileSync(outputPath, renderPostFile(p, { videoSlug: video.slug, shortSlug: short.slug }), 'utf-8');
+            logger.info(`[SocialMediaAgent] Wrote short post ${outputPath}`);
+            return {
+                platform,
+                content: p.content,
+                hashtags: p.hashtags,
+                links: p.links,
+                characterCount: p.characterCount,
+                outputPath,
+            };
+        });
+        return socialPosts;
+    }
+    finally {
+        await agent.destroy();
+    }
+}
+export async function generateSocialPosts(video, transcript, summary, outputDir) {
+    const agent = new SocialMediaAgent();
+    try {
+        // Build the user prompt with transcript summary and metadata
+        const userMessage = [
+            '## Video Metadata',
+            `- **Title:** ${summary.title}`,
+            `- **Slug:** ${video.slug}`,
+            `- **Duration:** ${video.duration}s`,
+            '',
+            '## Summary',
+            summary.overview,
+            '',
+            '## Key Topics',
+            summary.keyTopics.map((t) => `- ${t}`).join('\n'),
+            '',
+            '## Transcript (first 3000 chars)',
+            transcript.text.slice(0, 3000),
+        ].join('\n');
+        await agent.run(userMessage);
+        const collectedPosts = agent.getCollectedPosts();
+        // Ensure the output directory exists
+        const outDir = outputDir ?? path.join(video.videoDir, 'social-posts');
+        fs.mkdirSync(outDir, { recursive: true });
+        const socialPosts = collectedPosts.map((p) => {
+            const platform = toPlatformEnum(p.platform);
+            const outputPath = path.join(outDir, `${platform}.md`);
+            fs.writeFileSync(outputPath, renderPostFile(p, { videoSlug: video.slug }), 'utf-8');
+            logger.info(`[SocialMediaAgent] Wrote ${outputPath}`);
+            return {
+                platform,
+                content: p.content,
+                hashtags: p.hashtags,
+                links: p.links,
+                characterCount: p.characterCount,
+                outputPath,
+            };
+        });
+        return socialPosts;
+    }
+    finally {
+        await agent.destroy();
+    }
+}
+//# sourceMappingURL=SocialMediaAgent.js.map

package/dist/agents/SocialMediaAgent.js.map

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

package/dist/agents/SummaryAgent.d.ts

@@ -0,0 +1,11 @@
+import type { VideoFile, Transcript, VideoSummary, ShortClip, Chapter } from '../types';
+/**
+ * Generate a beautiful Markdown summary for a video recording.
+ *
+ * 1. Creates a SummaryAgent with `capture_frame` and `write_summary` tools
+ * 2. Builds a prompt containing the full transcript with timestamps
+ * 3. Lets the agent analyse the transcript, capture key frames, and write Markdown
+ * 4. Returns a {@link VideoSummary} with metadata and snapshot paths
+ */
+export declare function generateSummary(video: VideoFile, transcript: Transcript, shorts?: ShortClip[], chapters?: Chapter[]): Promise<VideoSummary>;
+//# sourceMappingURL=SummaryAgent.d.ts.map

package/dist/agents/SummaryAgent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SummaryAgent.d.ts","sourceRoot":"","sources":["../../src/agents/SummaryAgent.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAiB,SAAS,EAAE,OAAO,EAAE,MAAM,UAAU,CAAA;AA+TtG;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,SAAS,EAChB,UAAU,EAAE,UAAU,EACtB,MAAM,CAAC,EAAE,SAAS,EAAE,EACpB,QAAQ,CAAC,EAAE,OAAO,EAAE,GACnB,OAAO,CAAC,YAAY,CAAC,CA+DvB"}