@vibeframe/cli 0.27.0

package/dist/commands/ai-helpers.js

@@ -0,0 +1,59 @@
+/**
+ * ai-helpers.ts — Shared utility functions used across AI commands.
+ *
+ * These were extracted from ai.ts to improve maintainability.
+ * ai.ts imports and re-uses these internally.
+ */
+/**
+ * Download a video from URL, handling Veo/Google API authentication.
+ * Uses x-goog-api-key header (not query param) for Google API URLs.
+ *
+ * @param url - Video URL to download
+ * @param apiKey - Google API key (caller should resolve from env/config)
+ */
+export async function downloadVideo(url, apiKey) {
+    const headers = {};
+    if (url.includes("generativelanguage.googleapis.com") && apiKey) {
+        headers["x-goog-api-key"] = apiKey;
+    }
+    const response = await fetch(url, { headers, redirect: "follow" });
+    if (!response.ok) {
+        throw new Error(`Download failed (${response.status}): ${response.statusText}`);
+    }
+    return Buffer.from(await response.arrayBuffer());
+}
+/** Format a duration in seconds to m:ss.s display format */
+export function formatTime(seconds) {
+    const mins = Math.floor(seconds / 60);
+    const secs = (seconds % 60).toFixed(1);
+    return `${mins}:${secs.padStart(4, "0")}`;
+}
+/** Apply a single AI edit suggestion to a project */
+export function applySuggestion(project, suggestion) {
+    const { type, clipIds, params } = suggestion;
+    if (clipIds.length === 0)
+        return false;
+    const clipId = clipIds[0];
+    switch (type) {
+        case "trim":
+            if (params.newDuration) {
+                return project.trimClipEnd(clipId, params.newDuration);
+            }
+            break;
+        case "add-effect":
+            if (params.effectType) {
+                const effect = project.addEffect(clipId, {
+                    type: params.effectType,
+                    startTime: params.startTime || 0,
+                    duration: params.duration || 1,
+                    params: params.effectParams || {},
+                });
+                return effect !== null;
+            }
+            break;
+        case "delete":
+            return project.removeClip(clipId);
+    }
+    return false;
+}
+//# sourceMappingURL=ai-helpers.js.map

package/dist/commands/ai-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-helpers.js","sourceRoot":"","sources":["../../src/commands/ai-helpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,GAAW,EAAE,MAAe;IAC9D,MAAM,OAAO,GAA2B,EAAE,CAAC;IAC3C,IAAI,GAAG,CAAC,QAAQ,CAAC,mCAAmC,CAAC,IAAI,MAAM,EAAE,CAAC;QAChE,OAAO,CAAC,gBAAgB,CAAC,GAAG,MAAM,CAAC;IACrC,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC;IACnE,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,oBAAoB,QAAQ,CAAC,MAAM,MAAM,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;IAClF,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;AACnD,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,UAAU,CAAC,OAAe;IACxC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;IACtC,MAAM,IAAI,GAAG,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IACvC,OAAO,GAAG,IAAI,IAAI,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;AAC5C,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,eAAe,CAAC,OAAgB,EAAE,UAAe;IAC/D,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC;IAE7C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACvC,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAE1B,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,MAAM;YACT,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;gBACvB,OAAO,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;YACzD,CAAC;YACD,MAAM;QACR,KAAK,YAAY;YACf,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;gBACtB,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,MAAM,EAAE;oBACvC,IAAI,EAAE,MAAM,CAAC,UAAU;oBACvB,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,CAAC;oBAChC,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,CAAC;oBAC9B,MAAM,EAAE,MAAM,CAAC,YAAY,IAAI,EAAE;iBAClC,CAAC,CAAC;gBACH,OAAO,MAAM,KAAK,IAAI,CAAC;YACzB,CAAC;YACD,MAAM;QACR,KAAK,QAAQ;YACX,OAAO,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IACtC,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/commands/ai-highlights.d.ts

@@ -0,0 +1,127 @@
+/**
+ * @module ai-highlights
+ *
+ * Highlight extraction and auto-shorts generation for long-form content.
+ *
+ * CLI commands: highlights, auto-shorts
+ *
+ * Execute functions:
+ *   executeHighlights  - Extract best moments from video/audio (Whisper+Claude or Gemini)
+ *   executeAutoShorts   - Generate short-form vertical clips from long-form video
+ *
+ * @dependencies Whisper (OpenAI), Claude (Anthropic), Gemini (Google), FFmpeg
+ */
+import { Command } from "commander";
+import { type Highlight } from "@vibeframe/ai-providers";
+/** Options for {@link executeHighlights}. */
+export interface HighlightsOptions {
+    /** Path to the video or audio file */
+    media: string;
+    /** Path for the output JSON with highlight data */
+    output?: string;
+    /** Path for a .vibe.json project with highlight clips */
+    project?: string;
+    /** Target highlight reel duration in seconds */
+    duration?: number;
+    /** Maximum number of highlights to return */
+    count?: number;
+    /** Minimum confidence threshold 0-1 (default: 0.7) */
+    threshold?: number;
+    /** Selection criteria filter */
+    criteria?: "emotional" | "informative" | "funny" | "all";
+    /** Language code for Whisper transcription */
+    language?: string;
+    /** Use Gemini multimodal analysis instead of Whisper+Claude */
+    useGemini?: boolean;
+    /** Use low-resolution mode for Gemini (longer videos) */
+    lowRes?: boolean;
+}
+/** Result from {@link executeHighlights}. */
+export interface HighlightsExtractResult {
+    /** Whether the extraction succeeded */
+    success: boolean;
+    /** Detected and filtered highlights */
+    highlights: Highlight[];
+    /** Total source media duration in seconds */
+    totalDuration: number;
+    /** Combined duration of all returned highlights in seconds */
+    totalHighlightDuration: number;
+    /** Path to the output JSON (if --output specified) */
+    outputPath?: string;
+    /** Path to the generated project file (if --project specified) */
+    projectPath?: string;
+    /** Error message on failure */
+    error?: string;
+}
+/**
+ * Extract the best highlights from a video or audio file.
+ *
+ * Supports two analysis backends:
+ * - Whisper + Claude (default): transcribe audio, then analyze text for highlights
+ * - Gemini (--useGemini): multimodal visual+audio analysis for richer detection
+ *
+ * @param options - Highlight extraction configuration
+ * @returns Result with filtered highlights sorted by time
+ */
+export declare function executeHighlights(options: HighlightsOptions): Promise<HighlightsExtractResult>;
+/** Options for {@link executeAutoShorts}. */
+export interface AutoShortsOptions {
+    /** Path to the source video file */
+    video: string;
+    /** Output directory for generated short clips */
+    outputDir?: string;
+    /** Target duration per short in seconds (default: 60) */
+    duration?: number;
+    /** Number of shorts to generate (default: 1) */
+    count?: number;
+    /** Output aspect ratio (default: "9:16") */
+    aspect?: "9:16" | "1:1";
+    /** Add auto-generated captions to shorts */
+    addCaptions?: boolean;
+    /** Caption visual style preset */
+    captionStyle?: "minimal" | "bold" | "animated";
+    /** If true, only analyze without extracting clips */
+    analyzeOnly?: boolean;
+    /** Language code for Whisper transcription */
+    language?: string;
+    /** Use Gemini multimodal analysis instead of Whisper+Claude */
+    useGemini?: boolean;
+    /** Use low-resolution mode for Gemini (longer videos) */
+    lowRes?: boolean;
+}
+/** Result from {@link executeAutoShorts}. */
+export interface AutoShortsResult {
+    /** Whether the operation succeeded */
+    success: boolean;
+    /** Generated short clips with metadata */
+    shorts: Array<{
+        /** 1-based index */
+        index: number;
+        /** Start time in the source video (seconds) */
+        startTime: number;
+        /** End time in the source video (seconds) */
+        endTime: number;
+        /** Duration of the short (seconds) */
+        duration: number;
+        /** Confidence/virality score 0-1 */
+        confidence: number;
+        /** Why this moment was selected */
+        reason: string;
+        /** Path to the extracted clip (undefined in analyze-only mode) */
+        outputPath?: string;
+    }>;
+    /** Error message on failure */
+    error?: string;
+}
+/**
+ * Auto-generate short-form vertical clips from a long-form video.
+ *
+ * Finds the best viral-worthy moments using Whisper+Claude or Gemini analysis,
+ * then extracts and crops them to the target aspect ratio using FFmpeg.
+ *
+ * @param options - Auto-shorts generation configuration
+ * @returns Result with extracted short clips and metadata
+ */
+export declare function executeAutoShorts(options: AutoShortsOptions): Promise<AutoShortsResult>;
+export declare function registerHighlightsCommands(aiCommand: Command): void;
+//# sourceMappingURL=ai-highlights.d.ts.map

package/dist/commands/ai-highlights.d.ts.map

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