mcp-scraper 0.2.18 → 0.2.20

package/dist/index.d.cts

@@ -26,7 +26,7 @@ declare const HarvestOptionsSchema: z.ZodObject<{
     gl: string;
     hl: string;
     device: "desktop" | "mobile";
-    proxyMode: "location" | "configured" | "none";
+    proxyMode: "configured" | "location" | "none";
     debug: boolean;
     depth: number;
     maxQuestions: number;
@@ -48,7 +48,7 @@ declare const HarvestOptionsSchema: z.ZodObject<{
     gl?: string | undefined;
     hl?: string | undefined;
     device?: "desktop" | "mobile" | undefined;
-    proxyMode?: "location" | "configured" | "none" | undefined;
+    proxyMode?: "configured" | "location" | "none" | undefined;
     proxyZip?: string | undefined;
     debug?: boolean | undefined;
     depth?: number | undefined;

package/dist/index.d.ts

@@ -26,7 +26,7 @@ declare const HarvestOptionsSchema: z.ZodObject<{
     gl: string;
     hl: string;
     device: "desktop" | "mobile";
-    proxyMode: "location" | "configured" | "none";
+    proxyMode: "configured" | "location" | "none";
     debug: boolean;
     depth: number;
     maxQuestions: number;
@@ -48,7 +48,7 @@ declare const HarvestOptionsSchema: z.ZodObject<{
     gl?: string | undefined;
     hl?: string | undefined;
     device?: "desktop" | "mobile" | undefined;
-    proxyMode?: "location" | "configured" | "none" | undefined;
+    proxyMode?: "configured" | "location" | "none" | undefined;
     proxyZip?: string | undefined;
     debug?: boolean | undefined;
     depth?: number | undefined;

package/dist/index.js

@@ -1,7 +1,8 @@
 import {
   harvest
-} from "./chunk-CQTAKXBN.js";
+} from "./chunk-XGUDTDZ2.js";
 import "./chunk-M2S27J6Z.js";
+import "./chunk-LFATOGDF.js";
 
 // src/video/VideoGenerator.ts
 import { execSync as execSync2 } from "child_process";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/video/VideoGenerator.ts","../src/video/promptBuilder.ts","../src/video/AudioGenerator.ts","../src/video/VideoMixer.ts"],"sourcesContent":["import { execSync } from 'node:child_process'\nimport { readFileSync, writeFileSync, unlinkSync, mkdirSync } from 'node:fs'\nimport { tmpdir } from 'node:os'\nimport { join } from 'node:path'\nimport { fal } from '@fal-ai/client'\nimport { buildClipPrompts, extractEpisodePrompts } from './promptBuilder.js'\nimport type { EpisodeBrief } from './episodeBrief.js'\nimport { generateVoiceover, addBackgroundAudio } from './AudioGenerator.js'\nimport { concatenateClips, uploadToFal, overlayVoiceover } from './VideoMixer.js'\n\nexport interface ClipPairOptions {\n  resolution?:           '480p' | '720p' | '1080p'\n  aspectRatio?:          '16:9' | '9:16' | '1:1'\n  clipDurationSeconds?:  number\n  generateAudio?:        boolean\n  seed?:                 number\n  outputDir?:            string\n}\n\nexport interface ClipPairResult {\n  clip1Url:       string\n  clip2Url:       string\n  finalVideoPath: string\n  seed:           number\n  promptClip1:    string\n  promptClip2:    string\n  voiceover:      string\n  audioMood:      string\n}\n\ninterface VideoOutput { video: { url: string }; seed: number }\n\nconst T2V = 'bytedance/seedance-2.0/text-to-video'\nconst I2V = 'bytedance/seedance-2.0/image-to-video'\n\nfunction buildInput(prompt: string, opts: ClipPairOptions, seed?: number, imageUrl?: string) {\n  return {\n    prompt,\n    resolution:     opts.resolution ?? '720p',\n    duration:       opts.clipDurationSeconds ?? 8,\n    aspect_ratio:   opts.aspectRatio ?? '16:9',\n    generate_audio: false,\n    ...(seed     !== undefined ? { seed }               : {}),\n    ...(imageUrl !== undefined ? { image_url: imageUrl } : {}),\n  }\n}\n\nasync function generate(model: string, input: Record<string, unknown>): Promise<VideoOutput> {\n  const { request_id } = await fal.queue.submit(model, { input })\n  console.log(`[fal] submitted ${model} → ${request_id}`)\n  while (true) {\n    await new Promise(r => setTimeout(r, 5000))\n    const s = await fal.queue.status(model, { requestId: request_id, logs: false })\n    console.log(`[fal] ${request_id} → ${s.status}`)\n    if ((s.status as string) === 'FAILED') throw new Error(`Request ${request_id} failed`)\n    if ((s.status as string) !== 'COMPLETED') continue\n    const result = await fal.queue.result(model, { requestId: request_id })\n    return result.data as VideoOutput\n  }\n}\n\nasync function extractLastFrame(videoUrl: string, outDir: string): Promise<string> {\n  const ts      = Date.now()\n  const mp4Path = join(outDir, `clip1-raw-${ts}.mp4`)\n  const jpgPath = join(outDir, `last-frame-${ts}.jpg`)\n\n  const res = await fetch(videoUrl)\n  if (!res.ok) throw new Error(`Failed to download clip 1 (${res.status})`)\n  writeFileSync(mp4Path, Buffer.from(await res.arrayBuffer()))\n\n  try {\n    execSync(`ffmpeg -sseof -0.1 -i \"${mp4Path}\" -vframes 1 -y \"${jpgPath}\" -loglevel error`)\n  } finally {\n    try { unlinkSync(mp4Path) } catch {}\n  }\n  return jpgPath\n}\n\nexport class VideoGenerator {\n  constructor(apiKey?: string) {\n    const key = apiKey ?? process.env['FAL_KEY']\n    if (!key) throw new Error('FAL_KEY is required')\n    fal.config({ credentials: key })\n  }\n\n  async generateClipPair(\n    question: string,\n    answer:   string,\n    opts:     ClipPairOptions = {},\n  ): Promise<ClipPairResult> {\n    const outDir = opts.outputDir ?? join(tmpdir(), `paa-video-${Date.now()}`)\n    mkdirSync(outDir, { recursive: true })\n\n    console.log('\\n[1/7] Generating prompts via QWEN 3.6...')\n    const prompts = await buildClipPrompts(question, answer)\n    console.log('  Voiceover:', prompts.voiceover)\n    console.log('  Audio mood:', prompts.audioMood)\n\n    console.log('\\n[2/7] Generating clip 1 (text-to-video)...')\n    const result1 = await generate(T2V, buildInput(prompts.clip1, opts, opts.seed))\n\n    console.log('\\n[3/7] Extracting last frame → clip 2 start...')\n    const jpgPath  = await extractLastFrame(result1.video.url, outDir)\n    const imageBlob = new Blob([readFileSync(jpgPath)], { type: 'image/jpeg' })\n    const frameUrl  = await fal.storage.upload(imageBlob)\n    try { unlinkSync(jpgPath) } catch {}\n\n    console.log('\\n[4/7] Generating clip 2 (image-to-video from last frame)...')\n    const seed2   = opts.seed !== undefined ? opts.seed + 1 : undefined\n    const result2 = await generate(I2V, buildInput(prompts.clip2, opts, seed2, frameUrl))\n\n    console.log('\\n[5/7] Concatenating clips + generating voiceover (parallel)...')\n    const [combinedPath, voiceoverUrl] = await Promise.all([\n      concatenateClips(result1.video.url, result2.video.url, outDir),\n      generateVoiceover(prompts.voiceover),\n    ])\n\n    console.log('\\n[6/7] Adding background audio via MMAudio V2...')\n    const falVideoUrl        = await uploadToFal(combinedPath)\n    const totalDuration      = (opts.clipDurationSeconds ?? 8) * 2\n    const videoWithAudioUrl  = await addBackgroundAudio(falVideoUrl, prompts.audioMood, totalDuration)\n\n    console.log('\\n[7/7] Overlaying voiceover on final video...')\n    const videoWithAudioPath = join(outDir, `with-bg-audio-${Date.now()}.mp4`)\n    const bgRes = await fetch(videoWithAudioUrl)\n    writeFileSync(videoWithAudioPath, Buffer.from(await bgRes.arrayBuffer()))\n    const finalVideoPath = await overlayVoiceover(videoWithAudioPath, voiceoverUrl, outDir)\n\n    return {\n      clip1Url:       result1.video.url,\n      clip2Url:       result2.video.url,\n      finalVideoPath,\n      seed:           result1.seed,\n      promptClip1:    prompts.clip1,\n      promptClip2:    prompts.clip2,\n      voiceover:      prompts.voiceover,\n      audioMood:      prompts.audioMood,\n    }\n  }\n\n  async generateEpisode(\n    brief: EpisodeBrief,\n    opts:  ClipPairOptions = {},\n  ): Promise<ClipPairResult> {\n    const outDir = opts.outputDir ?? join(tmpdir(), `episode-${brief.episodeNumber}-${Date.now()}`)\n    mkdirSync(outDir, { recursive: true })\n\n    const prompts = extractEpisodePrompts(brief)\n    console.log(`\\n[Episode ${brief.episodeNumber}/${brief.episodeCount}] ${brief.sectionTitle}`)\n    console.log('  Voiceover:', prompts.voiceover)\n\n    console.log('\\n[2/7] Generating clip 1 (text-to-video)...')\n    const result1 = await generate(T2V, buildInput(prompts.clip1, opts, opts.seed))\n\n    console.log('\\n[3/7] Extracting last frame → clip 2 start...')\n    const jpgPath  = await extractLastFrame(result1.video.url, outDir)\n    const imageBlob = new Blob([readFileSync(jpgPath)], { type: 'image/jpeg' })\n    const frameUrl  = await fal.storage.upload(imageBlob)\n    try { unlinkSync(jpgPath) } catch {}\n\n    console.log('\\n[4/7] Generating clip 2 (image-to-video from last frame)...')\n    const seed2   = opts.seed !== undefined ? opts.seed + 1 : undefined\n    const result2 = await generate(I2V, buildInput(prompts.clip2, opts, seed2, frameUrl))\n\n    console.log('\\n[5/7] Concatenating clips + generating voiceover (parallel)...')\n    const [combinedPath, voiceoverUrl] = await Promise.all([\n      concatenateClips(result1.video.url, result2.video.url, outDir),\n      generateVoiceover(prompts.voiceover),\n    ])\n\n    console.log('\\n[6/7] Adding background audio via MMAudio V2...')\n    const falVideoUrl        = await uploadToFal(combinedPath)\n    const totalDuration      = (opts.clipDurationSeconds ?? 8) * 2\n    const videoWithAudioUrl  = await addBackgroundAudio(falVideoUrl, prompts.audioMood, totalDuration)\n\n    console.log('\\n[7/7] Overlaying voiceover on final video...')\n    const videoWithAudioPath = join(outDir, `with-bg-audio-${Date.now()}.mp4`)\n    const bgRes = await fetch(videoWithAudioUrl)\n    writeFileSync(videoWithAudioPath, Buffer.from(await bgRes.arrayBuffer()))\n    const finalVideoPath = await overlayVoiceover(videoWithAudioPath, voiceoverUrl, outDir)\n\n    return {\n      clip1Url:       result1.video.url,\n      clip2Url:       result2.video.url,\n      finalVideoPath,\n      seed:           result1.seed,\n      promptClip1:    prompts.clip1,\n      promptClip2:    prompts.clip2,\n      voiceover:      prompts.voiceover,\n      audioMood:      prompts.audioMood,\n    }\n  }\n}\n","export interface ClipPromptPair {\n  clip1:      string\n  clip2:      string\n  voiceover:  string\n  audioMood:  string\n}\n\nexport interface EpisodeBriefInput {\n  storyMoment:   string\n  characterName: string\n  sectionTitle:  string\n  clip1:         string\n  clip2:         string\n  voiceover:     string\n  audioMood:     string\n}\n\nconst DEEPINFRA_URL  = 'https://api.deepinfra.com/v1/openai/chat/completions'\nconst OPENROUTER_URL = 'https://openrouter.ai/api/v1/chat/completions'\nconst QWEN_MODEL     = 'Qwen/Qwen3.6-35B-A3B'\n\nconst SYSTEM_PROMPT = `You are a video prompt engineer for Seedance 2.0 text-to-video AI.\n\nIMPORTANT TECHNICAL CONTEXT: Clip 2 will be generated using image-to-video, meaning it will start from the exact last frame of Clip 1. The two clips will be visually seamless — same location, same characters, continuous motion. You must write prompts that make this feel like one uninterrupted 16-second video.\n\nYour job: turn a PAA question and its answer into a complete short-form video with visuals, narration, and a background audio mood.\n\nProduce four things:\n\n1. clip1 (~8s): Show a real person experiencing the situation the question describes. End on a specific frozen moment — a held expression, a paused action — that clip 2 continues from.\n\n2. clip2 (~8s): Continue from that exact frozen frame. Deliver the informational payoff from the answer. Show specific facts playing out visually. Describe motion continuing from clip 1's ending frame, not a new scene.\n\n3. voiceover: A spoken narration that fits in 10 seconds of TTS audio. HARD LIMIT: 22 words maximum. Count every word before finalizing — if it exceeds 22 words, cut it. Starts with the problem, ends with the answer. No filler, no \"in conclusion\". Informational and direct.\n\n4. audioMood: 6-10 words describing INSTRUMENTAL background music only — no vocals, no voice, no lyrics. Describe instruments and mood (e.g. \"warm acoustic guitar, uplifting, professional home service, no vocals\"). Will be passed to an AI audio model.\n\nRules for visuals:\n- No text, captions, graphics, or overlays\n- Photorealistic, natural lighting, specific details\n- Describe exactly what the camera sees\n\nRespond with JSON only:\n{\"clip1\": \"...\", \"clip2\": \"...\", \"voiceover\": \"...\", \"audioMood\": \"...\"}`\n\ninterface ChatResponse {\n  choices: Array<{ message: { content: string } }>\n}\n\nasync function callLLM(apiKey: string, baseUrl: string, question: string, answer: string): Promise<ClipPromptPair> {\n  const res = await fetch(baseUrl, {\n    method:  'POST',\n    headers: { 'Authorization': `Bearer ${apiKey}`, 'Content-Type': 'application/json' },\n    body: JSON.stringify({\n      model:       QWEN_MODEL,\n      temperature: 0.7,\n      messages: [\n        { role: 'system', content: SYSTEM_PROMPT },\n        { role: 'user',   content: `Question: ${question}\\n\\nAnswer: ${answer.slice(0, 500)}` },\n      ],\n    }),\n  })\n  if (!res.ok) throw new Error(`LLM call failed (${res.status}): ${await res.text()}`)\n\n  const data  = (await res.json()) as ChatResponse\n  const raw   = data.choices[0]?.message?.content?.trim() ?? ''\n  const match = raw.match(/\\{[\\s\\S]*\\}/)\n  if (!match) throw new Error(`No JSON in QWEN response: ${raw.slice(0, 200)}`)\n\n  const parsed = JSON.parse(match[0]) as Partial<ClipPromptPair>\n  if (!parsed.clip1 || !parsed.clip2 || !parsed.voiceover || !parsed.audioMood) {\n    throw new Error(`QWEN response missing fields: ${raw.slice(0, 200)}`)\n  }\n  return parsed as ClipPromptPair\n}\n\nexport async function buildClipPrompts(question: string, answer: string): Promise<ClipPromptPair> {\n  const deepinfraKey  = process.env['DEEPINFRA_API_KEY']\n  const openrouterKey = process.env['OPENROUTER_API_KEY']\n\n  if (deepinfraKey) {\n    try {\n      return await callLLM(deepinfraKey, DEEPINFRA_URL, question, answer)\n    } catch (err) {\n      console.warn('[promptBuilder] DeepInfra failed, trying OpenRouter:', (err as Error).message)\n    }\n  }\n  if (openrouterKey) {\n    return await callLLM(openrouterKey, OPENROUTER_URL, question, answer)\n  }\n  throw new Error('No LLM key — set DEEPINFRA_API_KEY or OPENROUTER_API_KEY')\n}\n\nexport function extractEpisodePrompts(brief: EpisodeBriefInput): ClipPromptPair {\n  if (!brief.clip1 || !brief.clip2 || !brief.voiceover || !brief.audioMood) {\n    throw new Error('Episode brief is missing prompt fields — run blog-to-video skill to regenerate')\n  }\n  return { clip1: brief.clip1, clip2: brief.clip2, voiceover: brief.voiceover, audioMood: brief.audioMood }\n}\n\nconst EPISODE_SYSTEM_PROMPT = `You are a video prompt engineer for Seedance 2.0 text-to-video AI.\n\nYou are working with a character-driven narrative brief. The clips must feel like a continuous 16-second moment in one person's story — not an explainer video.\n\nIMPORTANT TECHNICAL CONTEXT: Clip 2 will start from the exact last frame of Clip 1. Both clips must show the same person, same location, same lighting. Clip 2 continues motion from Clip 1's frozen ending frame.\n\nUse the Kling prompt format for every clip:\n[Shot type] of [character name] [action]. The scene starts at [keyframe 1]. Camera Motion: [motion] ending in [keyframe 2]. Lighting: [style]. Style: [style].\n\nShot types: Close-up, Medium shot, Over-the-shoulder, Wide shot, Tracking shot.\nCamera motions: Slow push in, Slow pull back, Rack focus, Static hold, Subtle drift right/left, Pan left/right.\n\nRules for visuals:\n- No text, no captions, no UI overlays, no readable code on screen\n- Photorealistic, specific objects, natural-feeling details\n- Keyframe 2 (clip 1's end) must be a specific held moment clip 2 continues from\n\nvoiceover: The character's internal tension, in 22 words maximum. Not a summary. Count every word.\naudioMood: Specific instruments + tempo + emotional register + \"no vocals, no lyrics\".\n\nRespond with JSON only: {\"clip1\": \"...\", \"clip2\": \"...\", \"voiceover\": \"...\", \"audioMood\": \"...\"}`\n\nasync function callEpisodeLLM(apiKey: string, baseUrl: string, brief: EpisodeBriefInput): Promise<ClipPromptPair> {\n  const userContent = `Character: ${brief.characterName}\nSection: ${brief.sectionTitle}\nStory moment: ${brief.storyMoment}\n\nExisting clip1 (refine if needed): ${brief.clip1}\nExisting clip2 (refine if needed): ${brief.clip2}\nExisting voiceover: ${brief.voiceover}\nExisting audioMood: ${brief.audioMood}\n\nProduce refined Kling-format prompts that follow all rules. Keep what's good, fix what violates the format.`\n\n  const res = await fetch(baseUrl, {\n    method:  'POST',\n    headers: { 'Authorization': `Bearer ${apiKey}`, 'Content-Type': 'application/json' },\n    body: JSON.stringify({\n      model:       QWEN_MODEL,\n      temperature: 0.5,\n      messages: [\n        { role: 'system', content: EPISODE_SYSTEM_PROMPT },\n        { role: 'user',   content: userContent },\n      ],\n    }),\n  })\n  if (!res.ok) throw new Error(`LLM episode call failed (${res.status}): ${await res.text()}`)\n\n  const data  = (await res.json()) as ChatResponse\n  const raw   = data.choices[0]?.message?.content?.trim() ?? ''\n  const match = raw.match(/\\{[\\s\\S]*\\}/)\n  if (!match) throw new Error(`No JSON in episode response: ${raw.slice(0, 200)}`)\n\n  const parsed = JSON.parse(match[0]) as Partial<ClipPromptPair>\n  if (!parsed.clip1 || !parsed.clip2 || !parsed.voiceover || !parsed.audioMood) {\n    throw new Error(`Episode response missing fields: ${raw.slice(0, 200)}`)\n  }\n  return parsed as ClipPromptPair\n}\n\nexport async function regenerateEpisodePrompts(brief: EpisodeBriefInput): Promise<ClipPromptPair> {\n  const deepinfraKey  = process.env['DEEPINFRA_API_KEY']\n  const openrouterKey = process.env['OPENROUTER_API_KEY']\n\n  if (deepinfraKey) {\n    try {\n      return await callEpisodeLLM(deepinfraKey, DEEPINFRA_URL, brief)\n    } catch (err) {\n      console.warn('[promptBuilder] DeepInfra failed, trying OpenRouter:', (err as Error).message)\n    }\n  }\n  if (openrouterKey) {\n    return await callEpisodeLLM(openrouterKey, OPENROUTER_URL, brief)\n  }\n  throw new Error('No LLM key — set DEEPINFRA_API_KEY or OPENROUTER_API_KEY')\n}\n","import { writeFileSync, mkdirSync } from 'node:fs'\nimport { join } from 'node:path'\nimport { tmpdir } from 'node:os'\nimport { fal } from '@fal-ai/client'\n\nconst MMAUDIO_MODEL    = 'fal-ai/mmaudio-v2'\nconst ELEVENLABS_MODEL = 'fal-ai/elevenlabs/tts'\nconst GEMINI_TTS_MODEL = 'fal-ai/google/gemini-2.5-flash-preview-tts'\n\ninterface VideoOutput { video: { url: string } }\ninterface TTSOutput   { audio: { url: string } }\n\nasync function downloadAudio(url: string): Promise<Buffer> {\n  const res = await fetch(url)\n  if (!res.ok) throw new Error(`Failed to download TTS audio (${res.status})`)\n  return Buffer.from(await res.arrayBuffer())\n}\n\nexport async function generateVoiceover(text: string): Promise<string> {\n  console.log('[AudioGenerator] Generating voiceover...')\n\n  const outDir  = join(tmpdir(), `tts-${Date.now()}`)\n  mkdirSync(outDir, { recursive: true })\n  const outPath = join(outDir, 'voiceover.mp3')\n\n  try {\n    const voiceId = process.env['ELEVENLABS_VOICE_ID'] ?? 'pNInz6obpgDQGcFmaJgB'\n    const result  = await fal.run(ELEVENLABS_MODEL, {\n      input: { text, voice_id: voiceId, model_id: 'eleven_v3' },\n    }) as unknown as TTSOutput\n    writeFileSync(outPath, await downloadAudio(result.audio.url))\n    console.log('[AudioGenerator] TTS: ElevenLabs via fal')\n    return outPath\n  } catch (err) {\n    console.warn('[AudioGenerator] ElevenLabs via fal failed, trying Gemini:', (err as Error).message)\n  }\n\n  const voice  = process.env['GEMINI_TTS_VOICE'] ?? 'Kore'\n  const result = await fal.run(GEMINI_TTS_MODEL, { input: { text, voice } }) as unknown as TTSOutput\n  writeFileSync(outPath, await downloadAudio(result.audio.url))\n  console.log('[AudioGenerator] TTS: Gemini via fal')\n  return outPath\n}\n\nexport async function addBackgroundAudio(videoUrl: string, mood: string, durationSeconds: number): Promise<string> {\n  console.log('[AudioGenerator] Adding background audio via MMAudio V2...')\n  const result = await fal.run(MMAUDIO_MODEL, {\n    input: {\n      video_url:       videoUrl,\n      prompt:          mood,\n      negative_prompt: 'speech, voice, talking, dialogue, narration, vocals, singing, human voice, conversation, words, lyrics, announcer, commentary',\n      duration:        durationSeconds,\n      cfg_strength:    4.5,\n    },\n  }) as unknown as VideoOutput\n  return result.video.url\n}\n","import { execSync } from 'node:child_process'\nimport { writeFileSync, mkdirSync } from 'node:fs'\nimport { join } from 'node:path'\nimport { fal } from '@fal-ai/client'\n\nasync function download(url: string, destPath: string): Promise<void> {\n  const res = await fetch(url)\n  if (!res.ok) throw new Error(`Download failed (${res.status}): ${url}`)\n  writeFileSync(destPath, Buffer.from(await res.arrayBuffer()))\n}\n\nexport async function concatenateClips(clip1Url: string, clip2Url: string, outDir: string): Promise<string> {\n  mkdirSync(outDir, { recursive: true })\n  const ts   = Date.now()\n  const p1   = join(outDir, `clip1-${ts}.mp4`)\n  const p2   = join(outDir, `clip2-${ts}.mp4`)\n  const out  = join(outDir, `combined-${ts}.mp4`)\n\n  console.log('[VideoMixer] Downloading clips...')\n  await Promise.all([download(clip1Url, p1), download(clip2Url, p2)])\n\n  console.log('[VideoMixer] Concatenating...')\n  execSync(\n    `ffmpeg -i \"${p1}\" -i \"${p2}\" -filter_complex \"[0:v][1:v]concat=n=2:v=1:a=0[v]\" -map \"[v]\" -y \"${out}\" -loglevel error`\n  )\n  return out\n}\n\nexport async function uploadToFal(localPath: string): Promise<string> {\n  const { readFileSync } = await import('node:fs')\n  const blob = new Blob([readFileSync(localPath)], { type: 'video/mp4' })\n  const url  = await fal.storage.upload(blob)\n  console.log('[VideoMixer] Uploaded to fal:', url)\n  return url\n}\n\nexport async function overlayVoiceover(\n  videoPath:     string,\n  voiceoverUrl:  string,\n  outDir:        string,\n): Promise<string> {\n  const ts  = Date.now()\n  const wav = join(outDir, `voiceover-${ts}.wav`)\n  const out = join(outDir, `final-${ts}.mp4`)\n\n  console.log('[VideoMixer] Downloading voiceover...')\n  await download(voiceoverUrl, wav)\n\n  console.log('[VideoMixer] Mixing voiceover over background audio...')\n  execSync(\n    `ffmpeg -i \"${videoPath}\" -i \"${wav}\" ` +\n    `-filter_complex \"[0:a]volume=0.2[bg];[1:a]volume=1.0[vo];[bg][vo]amix=inputs=2:duration=first[a]\" ` +\n    `-map 0:v -map \"[a]\" -c:v copy -y \"${out}\" -loglevel error`\n  )\n  return out\n}\n"],"mappings":"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","names":["execSync","writeFileSync","mkdirSync","tmpdir","join","fal","result","writeFileSync","mkdirSync","join","fal","readFileSync","fal","join","writeFileSync","execSync","tmpdir","mkdirSync"]}
+{"version":3,"sources":["../src/video/VideoGenerator.ts","../src/video/promptBuilder.ts","../src/video/AudioGenerator.ts","../src/video/VideoMixer.ts"],"sourcesContent":["import { execSync } from 'node:child_process'\nimport { readFileSync, writeFileSync, unlinkSync, mkdirSync } from 'node:fs'\nimport { tmpdir } from 'node:os'\nimport { join } from 'node:path'\nimport { fal } from '@fal-ai/client'\nimport { buildClipPrompts, extractEpisodePrompts } from './promptBuilder.js'\nimport type { EpisodeBrief } from './episodeBrief.js'\nimport { generateVoiceover, addBackgroundAudio } from './AudioGenerator.js'\nimport { concatenateClips, uploadToFal, overlayVoiceover } from './VideoMixer.js'\n\nexport interface ClipPairOptions {\n  resolution?:           '480p' | '720p' | '1080p'\n  aspectRatio?:          '16:9' | '9:16' | '1:1'\n  clipDurationSeconds?:  number\n  generateAudio?:        boolean\n  seed?:                 number\n  outputDir?:            string\n}\n\nexport interface ClipPairResult {\n  clip1Url:       string\n  clip2Url:       string\n  finalVideoPath: string\n  seed:           number\n  promptClip1:    string\n  promptClip2:    string\n  voiceover:      string\n  audioMood:      string\n}\n\ninterface VideoOutput { video: { url: string }; seed: number }\n\nconst T2V = 'bytedance/seedance-2.0/text-to-video'\nconst I2V = 'bytedance/seedance-2.0/image-to-video'\n\nfunction buildInput(prompt: string, opts: ClipPairOptions, seed?: number, imageUrl?: string) {\n  return {\n    prompt,\n    resolution:     opts.resolution ?? '720p',\n    duration:       opts.clipDurationSeconds ?? 8,\n    aspect_ratio:   opts.aspectRatio ?? '16:9',\n    generate_audio: false,\n    ...(seed     !== undefined ? { seed }               : {}),\n    ...(imageUrl !== undefined ? { image_url: imageUrl } : {}),\n  }\n}\n\nasync function generate(model: string, input: Record<string, unknown>): Promise<VideoOutput> {\n  const { request_id } = await fal.queue.submit(model, { input })\n  console.log(`[fal] submitted ${model} → ${request_id}`)\n  while (true) {\n    await new Promise(r => setTimeout(r, 5000))\n    const s = await fal.queue.status(model, { requestId: request_id, logs: false })\n    console.log(`[fal] ${request_id} → ${s.status}`)\n    if ((s.status as string) === 'FAILED') throw new Error(`Request ${request_id} failed`)\n    if ((s.status as string) !== 'COMPLETED') continue\n    const result = await fal.queue.result(model, { requestId: request_id })\n    return result.data as VideoOutput\n  }\n}\n\nasync function extractLastFrame(videoUrl: string, outDir: string): Promise<string> {\n  const ts      = Date.now()\n  const mp4Path = join(outDir, `clip1-raw-${ts}.mp4`)\n  const jpgPath = join(outDir, `last-frame-${ts}.jpg`)\n\n  const res = await fetch(videoUrl)\n  if (!res.ok) throw new Error(`Failed to download clip 1 (${res.status})`)\n  writeFileSync(mp4Path, Buffer.from(await res.arrayBuffer()))\n\n  try {\n    execSync(`ffmpeg -sseof -0.1 -i \"${mp4Path}\" -vframes 1 -y \"${jpgPath}\" -loglevel error`)\n  } finally {\n    try { unlinkSync(mp4Path) } catch {}\n  }\n  return jpgPath\n}\n\nexport class VideoGenerator {\n  constructor(apiKey?: string) {\n    const key = apiKey ?? process.env['FAL_KEY']\n    if (!key) throw new Error('FAL_KEY is required')\n    fal.config({ credentials: key })\n  }\n\n  async generateClipPair(\n    question: string,\n    answer:   string,\n    opts:     ClipPairOptions = {},\n  ): Promise<ClipPairResult> {\n    const outDir = opts.outputDir ?? join(tmpdir(), `paa-video-${Date.now()}`)\n    mkdirSync(outDir, { recursive: true })\n\n    console.log('\\n[1/7] Generating prompts via QWEN 3.6...')\n    const prompts = await buildClipPrompts(question, answer)\n    console.log('  Voiceover:', prompts.voiceover)\n    console.log('  Audio mood:', prompts.audioMood)\n\n    console.log('\\n[2/7] Generating clip 1 (text-to-video)...')\n    const result1 = await generate(T2V, buildInput(prompts.clip1, opts, opts.seed))\n\n    console.log('\\n[3/7] Extracting last frame → clip 2 start...')\n    const jpgPath  = await extractLastFrame(result1.video.url, outDir)\n    const imageBlob = new Blob([readFileSync(jpgPath)], { type: 'image/jpeg' })\n    const frameUrl  = await fal.storage.upload(imageBlob)\n    try { unlinkSync(jpgPath) } catch {}\n\n    console.log('\\n[4/7] Generating clip 2 (image-to-video from last frame)...')\n    const seed2   = opts.seed !== undefined ? opts.seed + 1 : undefined\n    const result2 = await generate(I2V, buildInput(prompts.clip2, opts, seed2, frameUrl))\n\n    console.log('\\n[5/7] Concatenating clips + generating voiceover (parallel)...')\n    const [combinedPath, voiceoverUrl] = await Promise.all([\n      concatenateClips(result1.video.url, result2.video.url, outDir),\n      generateVoiceover(prompts.voiceover),\n    ])\n\n    console.log('\\n[6/7] Adding background audio via MMAudio V2...')\n    const falVideoUrl        = await uploadToFal(combinedPath)\n    const totalDuration      = (opts.clipDurationSeconds ?? 8) * 2\n    const videoWithAudioUrl  = await addBackgroundAudio(falVideoUrl, prompts.audioMood, totalDuration)\n\n    console.log('\\n[7/7] Overlaying voiceover on final video...')\n    const videoWithAudioPath = join(outDir, `with-bg-audio-${Date.now()}.mp4`)\n    const bgRes = await fetch(videoWithAudioUrl)\n    writeFileSync(videoWithAudioPath, Buffer.from(await bgRes.arrayBuffer()))\n    const finalVideoPath = await overlayVoiceover(videoWithAudioPath, voiceoverUrl, outDir)\n\n    return {\n      clip1Url:       result1.video.url,\n      clip2Url:       result2.video.url,\n      finalVideoPath,\n      seed:           result1.seed,\n      promptClip1:    prompts.clip1,\n      promptClip2:    prompts.clip2,\n      voiceover:      prompts.voiceover,\n      audioMood:      prompts.audioMood,\n    }\n  }\n\n  async generateEpisode(\n    brief: EpisodeBrief,\n    opts:  ClipPairOptions = {},\n  ): Promise<ClipPairResult> {\n    const outDir = opts.outputDir ?? join(tmpdir(), `episode-${brief.episodeNumber}-${Date.now()}`)\n    mkdirSync(outDir, { recursive: true })\n\n    const prompts = extractEpisodePrompts(brief)\n    console.log(`\\n[Episode ${brief.episodeNumber}/${brief.episodeCount}] ${brief.sectionTitle}`)\n    console.log('  Voiceover:', prompts.voiceover)\n\n    console.log('\\n[2/7] Generating clip 1 (text-to-video)...')\n    const result1 = await generate(T2V, buildInput(prompts.clip1, opts, opts.seed))\n\n    console.log('\\n[3/7] Extracting last frame → clip 2 start...')\n    const jpgPath  = await extractLastFrame(result1.video.url, outDir)\n    const imageBlob = new Blob([readFileSync(jpgPath)], { type: 'image/jpeg' })\n    const frameUrl  = await fal.storage.upload(imageBlob)\n    try { unlinkSync(jpgPath) } catch {}\n\n    console.log('\\n[4/7] Generating clip 2 (image-to-video from last frame)...')\n    const seed2   = opts.seed !== undefined ? opts.seed + 1 : undefined\n    const result2 = await generate(I2V, buildInput(prompts.clip2, opts, seed2, frameUrl))\n\n    console.log('\\n[5/7] Concatenating clips + generating voiceover (parallel)...')\n    const [combinedPath, voiceoverUrl] = await Promise.all([\n      concatenateClips(result1.video.url, result2.video.url, outDir),\n      generateVoiceover(prompts.voiceover),\n    ])\n\n    console.log('\\n[6/7] Adding background audio via MMAudio V2...')\n    const falVideoUrl        = await uploadToFal(combinedPath)\n    const totalDuration      = (opts.clipDurationSeconds ?? 8) * 2\n    const videoWithAudioUrl  = await addBackgroundAudio(falVideoUrl, prompts.audioMood, totalDuration)\n\n    console.log('\\n[7/7] Overlaying voiceover on final video...')\n    const videoWithAudioPath = join(outDir, `with-bg-audio-${Date.now()}.mp4`)\n    const bgRes = await fetch(videoWithAudioUrl)\n    writeFileSync(videoWithAudioPath, Buffer.from(await bgRes.arrayBuffer()))\n    const finalVideoPath = await overlayVoiceover(videoWithAudioPath, voiceoverUrl, outDir)\n\n    return {\n      clip1Url:       result1.video.url,\n      clip2Url:       result2.video.url,\n      finalVideoPath,\n      seed:           result1.seed,\n      promptClip1:    prompts.clip1,\n      promptClip2:    prompts.clip2,\n      voiceover:      prompts.voiceover,\n      audioMood:      prompts.audioMood,\n    }\n  }\n}\n","export interface ClipPromptPair {\n  clip1:      string\n  clip2:      string\n  voiceover:  string\n  audioMood:  string\n}\n\nexport interface EpisodeBriefInput {\n  storyMoment:   string\n  characterName: string\n  sectionTitle:  string\n  clip1:         string\n  clip2:         string\n  voiceover:     string\n  audioMood:     string\n}\n\nconst DEEPINFRA_URL  = 'https://api.deepinfra.com/v1/openai/chat/completions'\nconst OPENROUTER_URL = 'https://openrouter.ai/api/v1/chat/completions'\nconst QWEN_MODEL     = 'Qwen/Qwen3.6-35B-A3B'\n\nconst SYSTEM_PROMPT = `You are a video prompt engineer for Seedance 2.0 text-to-video AI.\n\nIMPORTANT TECHNICAL CONTEXT: Clip 2 will be generated using image-to-video, meaning it will start from the exact last frame of Clip 1. The two clips will be visually seamless — same location, same characters, continuous motion. You must write prompts that make this feel like one uninterrupted 16-second video.\n\nYour job: turn a PAA question and its answer into a complete short-form video with visuals, narration, and a background audio mood.\n\nProduce four things:\n\n1. clip1 (~8s): Show a real person experiencing the situation the question describes. End on a specific frozen moment — a held expression, a paused action — that clip 2 continues from.\n\n2. clip2 (~8s): Continue from that exact frozen frame. Deliver the informational payoff from the answer. Show specific facts playing out visually. Describe motion continuing from clip 1's ending frame, not a new scene.\n\n3. voiceover: A spoken narration that fits in 10 seconds of TTS audio. HARD LIMIT: 22 words maximum. Count every word before finalizing — if it exceeds 22 words, cut it. Starts with the problem, ends with the answer. No filler, no \"in conclusion\". Informational and direct.\n\n4. audioMood: 6-10 words describing INSTRUMENTAL background music only — no vocals, no voice, no lyrics. Describe instruments and mood (e.g. \"warm acoustic guitar, uplifting, professional home service, no vocals\"). Will be passed to an AI audio model.\n\nRules for visuals:\n- No text, captions, graphics, or overlays\n- Photorealistic, natural lighting, specific details\n- Describe exactly what the camera sees\n\nRespond with JSON only:\n{\"clip1\": \"...\", \"clip2\": \"...\", \"voiceover\": \"...\", \"audioMood\": \"...\"}`\n\ninterface ChatResponse {\n  choices: Array<{ message: { content: string } }>\n}\n\nasync function callLLM(apiKey: string, baseUrl: string, question: string, answer: string): Promise<ClipPromptPair> {\n  const res = await fetch(baseUrl, {\n    method:  'POST',\n    headers: { 'Authorization': `Bearer ${apiKey}`, 'Content-Type': 'application/json' },\n    body: JSON.stringify({\n      model:       QWEN_MODEL,\n      temperature: 0.7,\n      messages: [\n        { role: 'system', content: SYSTEM_PROMPT },\n        { role: 'user',   content: `Question: ${question}\\n\\nAnswer: ${answer.slice(0, 500)}` },\n      ],\n    }),\n  })\n  if (!res.ok) throw new Error(`LLM call failed (${res.status}): ${await res.text()}`)\n\n  const data  = (await res.json()) as ChatResponse\n  const raw   = data.choices[0]?.message?.content?.trim() ?? ''\n  const match = raw.match(/\\{[\\s\\S]*\\}/)\n  if (!match) throw new Error(`No JSON in QWEN response: ${raw.slice(0, 200)}`)\n\n  const parsed = JSON.parse(match[0]) as Partial<ClipPromptPair>\n  if (!parsed.clip1 || !parsed.clip2 || !parsed.voiceover || !parsed.audioMood) {\n    throw new Error(`QWEN response missing fields: ${raw.slice(0, 200)}`)\n  }\n  return parsed as ClipPromptPair\n}\n\nexport async function buildClipPrompts(question: string, answer: string): Promise<ClipPromptPair> {\n  const deepinfraKey  = process.env['DEEPINFRA_API_KEY']\n  const openrouterKey = process.env['OPENROUTER_API_KEY']\n\n  if (deepinfraKey) {\n    try {\n      return await callLLM(deepinfraKey, DEEPINFRA_URL, question, answer)\n    } catch (err) {\n      console.warn('[promptBuilder] DeepInfra failed, trying OpenRouter:', (err as Error).message)\n    }\n  }\n  if (openrouterKey) {\n    return await callLLM(openrouterKey, OPENROUTER_URL, question, answer)\n  }\n  throw new Error('No LLM key — set DEEPINFRA_API_KEY or OPENROUTER_API_KEY')\n}\n\nexport function extractEpisodePrompts(brief: EpisodeBriefInput): ClipPromptPair {\n  if (!brief.clip1 || !brief.clip2 || !brief.voiceover || !brief.audioMood) {\n    throw new Error('Episode brief is missing prompt fields — run blog-to-video skill to regenerate')\n  }\n  return { clip1: brief.clip1, clip2: brief.clip2, voiceover: brief.voiceover, audioMood: brief.audioMood }\n}\n\nconst EPISODE_SYSTEM_PROMPT = `You are a video prompt engineer for Seedance 2.0 text-to-video AI.\n\nYou are working with a character-driven narrative brief. The clips must feel like a continuous 16-second moment in one person's story — not an explainer video.\n\nIMPORTANT TECHNICAL CONTEXT: Clip 2 will start from the exact last frame of Clip 1. Both clips must show the same person, same location, same lighting. Clip 2 continues motion from Clip 1's frozen ending frame.\n\nUse the Kling prompt format for every clip:\n[Shot type] of [character name] [action]. The scene starts at [keyframe 1]. Camera Motion: [motion] ending in [keyframe 2]. Lighting: [style]. Style: [style].\n\nShot types: Close-up, Medium shot, Over-the-shoulder, Wide shot, Tracking shot.\nCamera motions: Slow push in, Slow pull back, Rack focus, Static hold, Subtle drift right/left, Pan left/right.\n\nRules for visuals:\n- No text, no captions, no UI overlays, no readable code on screen\n- Photorealistic, specific objects, natural-feeling details\n- Keyframe 2 (clip 1's end) must be a specific held moment clip 2 continues from\n\nvoiceover: The character's internal tension, in 22 words maximum. Not a summary. Count every word.\naudioMood: Specific instruments + tempo + emotional register + \"no vocals, no lyrics\".\n\nRespond with JSON only: {\"clip1\": \"...\", \"clip2\": \"...\", \"voiceover\": \"...\", \"audioMood\": \"...\"}`\n\nasync function callEpisodeLLM(apiKey: string, baseUrl: string, brief: EpisodeBriefInput): Promise<ClipPromptPair> {\n  const userContent = `Character: ${brief.characterName}\nSection: ${brief.sectionTitle}\nStory moment: ${brief.storyMoment}\n\nExisting clip1 (refine if needed): ${brief.clip1}\nExisting clip2 (refine if needed): ${brief.clip2}\nExisting voiceover: ${brief.voiceover}\nExisting audioMood: ${brief.audioMood}\n\nProduce refined Kling-format prompts that follow all rules. Keep what's good, fix what violates the format.`\n\n  const res = await fetch(baseUrl, {\n    method:  'POST',\n    headers: { 'Authorization': `Bearer ${apiKey}`, 'Content-Type': 'application/json' },\n    body: JSON.stringify({\n      model:       QWEN_MODEL,\n      temperature: 0.5,\n      messages: [\n        { role: 'system', content: EPISODE_SYSTEM_PROMPT },\n        { role: 'user',   content: userContent },\n      ],\n    }),\n  })\n  if (!res.ok) throw new Error(`LLM episode call failed (${res.status}): ${await res.text()}`)\n\n  const data  = (await res.json()) as ChatResponse\n  const raw   = data.choices[0]?.message?.content?.trim() ?? ''\n  const match = raw.match(/\\{[\\s\\S]*\\}/)\n  if (!match) throw new Error(`No JSON in episode response: ${raw.slice(0, 200)}`)\n\n  const parsed = JSON.parse(match[0]) as Partial<ClipPromptPair>\n  if (!parsed.clip1 || !parsed.clip2 || !parsed.voiceover || !parsed.audioMood) {\n    throw new Error(`Episode response missing fields: ${raw.slice(0, 200)}`)\n  }\n  return parsed as ClipPromptPair\n}\n\nexport async function regenerateEpisodePrompts(brief: EpisodeBriefInput): Promise<ClipPromptPair> {\n  const deepinfraKey  = process.env['DEEPINFRA_API_KEY']\n  const openrouterKey = process.env['OPENROUTER_API_KEY']\n\n  if (deepinfraKey) {\n    try {\n      return await callEpisodeLLM(deepinfraKey, DEEPINFRA_URL, brief)\n    } catch (err) {\n      console.warn('[promptBuilder] DeepInfra failed, trying OpenRouter:', (err as Error).message)\n    }\n  }\n  if (openrouterKey) {\n    return await callEpisodeLLM(openrouterKey, OPENROUTER_URL, brief)\n  }\n  throw new Error('No LLM key — set DEEPINFRA_API_KEY or OPENROUTER_API_KEY')\n}\n","import { writeFileSync, mkdirSync } from 'node:fs'\nimport { join } from 'node:path'\nimport { tmpdir } from 'node:os'\nimport { fal } from '@fal-ai/client'\n\nconst MMAUDIO_MODEL    = 'fal-ai/mmaudio-v2'\nconst ELEVENLABS_MODEL = 'fal-ai/elevenlabs/tts'\nconst GEMINI_TTS_MODEL = 'fal-ai/google/gemini-2.5-flash-preview-tts'\n\ninterface VideoOutput { video: { url: string } }\ninterface TTSOutput   { audio: { url: string } }\n\nasync function downloadAudio(url: string): Promise<Buffer> {\n  const res = await fetch(url)\n  if (!res.ok) throw new Error(`Failed to download TTS audio (${res.status})`)\n  return Buffer.from(await res.arrayBuffer())\n}\n\nexport async function generateVoiceover(text: string): Promise<string> {\n  console.log('[AudioGenerator] Generating voiceover...')\n\n  const outDir  = join(tmpdir(), `tts-${Date.now()}`)\n  mkdirSync(outDir, { recursive: true })\n  const outPath = join(outDir, 'voiceover.mp3')\n\n  try {\n    const voiceId = process.env['ELEVENLABS_VOICE_ID'] ?? 'pNInz6obpgDQGcFmaJgB'\n    const result  = await fal.run(ELEVENLABS_MODEL, {\n      input: { text, voice_id: voiceId, model_id: 'eleven_v3' },\n    }) as unknown as TTSOutput\n    writeFileSync(outPath, await downloadAudio(result.audio.url))\n    console.log('[AudioGenerator] TTS: ElevenLabs via fal')\n    return outPath\n  } catch (err) {\n    console.warn('[AudioGenerator] ElevenLabs via fal failed, trying Gemini:', (err as Error).message)\n  }\n\n  const voice  = process.env['GEMINI_TTS_VOICE'] ?? 'Kore'\n  const result = await fal.run(GEMINI_TTS_MODEL, { input: { text, voice } }) as unknown as TTSOutput\n  writeFileSync(outPath, await downloadAudio(result.audio.url))\n  console.log('[AudioGenerator] TTS: Gemini via fal')\n  return outPath\n}\n\nexport async function addBackgroundAudio(videoUrl: string, mood: string, durationSeconds: number): Promise<string> {\n  console.log('[AudioGenerator] Adding background audio via MMAudio V2...')\n  const result = await fal.run(MMAUDIO_MODEL, {\n    input: {\n      video_url:       videoUrl,\n      prompt:          mood,\n      negative_prompt: 'speech, voice, talking, dialogue, narration, vocals, singing, human voice, conversation, words, lyrics, announcer, commentary',\n      duration:        durationSeconds,\n      cfg_strength:    4.5,\n    },\n  }) as unknown as VideoOutput\n  return result.video.url\n}\n","import { execSync } from 'node:child_process'\nimport { writeFileSync, mkdirSync } from 'node:fs'\nimport { join } from 'node:path'\nimport { fal } from '@fal-ai/client'\n\nasync function download(url: string, destPath: string): Promise<void> {\n  const res = await fetch(url)\n  if (!res.ok) throw new Error(`Download failed (${res.status}): ${url}`)\n  writeFileSync(destPath, Buffer.from(await res.arrayBuffer()))\n}\n\nexport async function concatenateClips(clip1Url: string, clip2Url: string, outDir: string): Promise<string> {\n  mkdirSync(outDir, { recursive: true })\n  const ts   = Date.now()\n  const p1   = join(outDir, `clip1-${ts}.mp4`)\n  const p2   = join(outDir, `clip2-${ts}.mp4`)\n  const out  = join(outDir, `combined-${ts}.mp4`)\n\n  console.log('[VideoMixer] Downloading clips...')\n  await Promise.all([download(clip1Url, p1), download(clip2Url, p2)])\n\n  console.log('[VideoMixer] Concatenating...')\n  execSync(\n    `ffmpeg -i \"${p1}\" -i \"${p2}\" -filter_complex \"[0:v][1:v]concat=n=2:v=1:a=0[v]\" -map \"[v]\" -y \"${out}\" -loglevel error`\n  )\n  return out\n}\n\nexport async function uploadToFal(localPath: string): Promise<string> {\n  const { readFileSync } = await import('node:fs')\n  const blob = new Blob([readFileSync(localPath)], { type: 'video/mp4' })\n  const url  = await fal.storage.upload(blob)\n  console.log('[VideoMixer] Uploaded to fal:', url)\n  return url\n}\n\nexport async function overlayVoiceover(\n  videoPath:     string,\n  voiceoverUrl:  string,\n  outDir:        string,\n): Promise<string> {\n  const ts  = Date.now()\n  const wav = join(outDir, `voiceover-${ts}.wav`)\n  const out = join(outDir, `final-${ts}.mp4`)\n\n  console.log('[VideoMixer] Downloading voiceover...')\n  await download(voiceoverUrl, wav)\n\n  console.log('[VideoMixer] Mixing voiceover over background audio...')\n  execSync(\n    `ffmpeg -i \"${videoPath}\" -i \"${wav}\" ` +\n    `-filter_complex \"[0:a]volume=0.2[bg];[1:a]volume=1.0[vo];[bg][vo]amix=inputs=2:duration=first[a]\" ` +\n    `-map 0:v -map \"[a]\" -c:v copy -y \"${out}\" -loglevel error`\n  )\n  return out\n}\n"],"mappings":"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","names":["execSync","writeFileSync","mkdirSync","tmpdir","join","fal","result","writeFileSync","mkdirSync","join","fal","readFileSync","fal","join","writeFileSync","execSync","tmpdir","mkdirSync"]}

package/dist/{server-VVY5K44O.js → server-7NE45K2A.js}

@@ -16,9 +16,11 @@ import {
   harvestProblemResponse,
   insufficientBalanceResponse,
   serializeHarvestProblem
-} from "./chunk-BSYPATSM.js";
+} from "./chunk-SXTXMFEQ.js";
 import {
   SiteAuditJobRowSchema,
+  advanceWorkflowRunStep,
+  appendWorkflowArtifacts,
   cancelJob,
   checkRateLimit,
   claimMonthlyFreeRefresh,
@@ -48,6 +50,7 @@ import {
   getUserStats,
   getWorkflowArtifact,
   getWorkflowRun,
+  getWorkflowRunStepState,
   getWorkflowSchedule,
   ledgerExistsForOperation,
   ledgerExistsForStripePI,
@@ -74,33 +77,31 @@ import {
   setPassword,
   setStripeCustomerId,
   verifyPassword
-} from "./chunk-TL7YTFLH.js";
+} from "./chunk-DBQDG7EH.js";
 import {
   BrowserDriver,
-  MapsPlaceOptionsSchema,
-  MapsSearchOptionsSchema,
   MapsSelectors,
-  RawMapsAboutAttributeSchema,
-  RawMapsHoursRowSchema,
-  RawMapsOverviewSchema,
-  RawMapsReviewStatsSchema,
   browserServiceApiKey,
   browserServiceProxyId,
   buildYouTubeChannelVideosUrl,
   deleteKernelProxyId,
   harvest,
   resolveKernelProxyId
-} from "./chunk-CQTAKXBN.js";
+} from "./chunk-XGUDTDZ2.js";
 import {
   CaptureSerpPageSnapshotsInputSchema,
+  CaptureSerpPageSnapshotsOutputSchema,
   CaptureSerpSnapshotInputSchema,
+  CaptureSerpSnapshotOutputSchema,
   HttpMcpToolExecutor,
   buildPaaExtractorMcpServer,
   configureReportSaving,
+  formatCaptureSerpPageSnapshots,
+  formatCaptureSerpSnapshot,
   harvestTimeoutBudget,
   liveWebToolAnnotations,
   outputBaseDir
-} from "./chunk-RJMCASQH.js";
+} from "./chunk-O5J7E4VX.js";
 import {
   CaptchaError,
   RECAPTCHA_INSTRUCTIONS,
@@ -111,10 +112,23 @@ import {
   listWorkflowDefinitions,
   rowsToCsv,
   runWorkflow,
+  runWorkflowStep,
   workflowDefinition,
-  workflowOutputBaseDir
-} from "./chunk-F44RBOJ5.js";
-import "./chunk-M5SAUO4K.js";
+  workflowOutputBaseDir,
+  workflowStepCount,
+  workflowSupportsSteps
+} from "./chunk-H2R232HK.js";
+import {
+  DEFAULT_MAPS_PROXY_MODE,
+  DEFAULT_PROXY_MODE,
+  MapsPlaceOptionsSchema,
+  MapsSearchOptionsSchema,
+  RawMapsAboutAttributeSchema,
+  RawMapsHoursRowSchema,
+  RawMapsOverviewSchema,
+  RawMapsReviewStatsSchema
+} from "./chunk-LFATOGDF.js";
+import "./chunk-XKUDVN2E.js";
 
 // src/api/outbound-sanitize.ts
 var KEY_RENAMES = {
@@ -7245,6 +7259,7 @@ var YouTubeHarvestOptionsSchema = z10.object({
   downloadMp3: z10.boolean().default(false),
   outputDir: z10.string().default("./yt-output"),
   kernelApiKey: z10.string().optional(),
+  kernelProxyId: z10.string().optional(),
   headless: z10.boolean().default(false)
 }).refine(
   (o) => o.mode === "search" ? !!o.query : !!o.channelHandle,
@@ -7498,6 +7513,7 @@ var YouTubeExtractor = class {
     const config = {
       headless: options.headless,
       kernelApiKey: options.kernelApiKey,
+      kernelProxyId: options.kernelProxyId,
       viewport: { width: 1280, height: 800 },
       locale: "en-US"
     };
@@ -7697,7 +7713,11 @@ async function ytHarvest(rawOptions) {
     throw new Error("A browser backend API key is required \u2014 YouTube harvesting requires a stealth session.");
   }
   const raw = typeof rawOptions === "object" && rawOptions !== null ? rawOptions : {};
-  const options = YouTubeHarvestOptionsSchema.parse({ kernelApiKey, ...raw });
+  const options = YouTubeHarvestOptionsSchema.parse({
+    kernelApiKey,
+    kernelProxyId: browserServiceProxyId(),
+    ...raw
+  });
   for (let attempt = 1; attempt <= MAX_ATTEMPTS; attempt++) {
     try {
       const result = await extractOnce(options);
@@ -7789,10 +7809,11 @@ function parseTimedtextXml(xml) {
 async function fetchViaKernelInnertube(videoId) {
   const kernelApiKey = browserServiceApiKey();
   if (!kernelApiKey) return null;
+  const kernelProxyId = browserServiceProxyId();
   const driver = new BrowserDriver();
   const start = Date.now();
   try {
-    await driver.launch({ kernelApiKey, headless: true, viewport: { width: 1280, height: 800 }, locale: "en-US" });
+    await driver.launch({ kernelApiKey, kernelProxyId, headless: true, viewport: { width: 1280, height: 800 }, locale: "en-US" });
     const page = driver.getPage();
     await driver.navigateTo(`https://www.youtube.com/watch?v=${videoId}`);
     await page.waitForFunction(
@@ -7887,10 +7908,10 @@ async function captureAudioViaMediaRecorder(page) {
   if (!result.ok || !result.base64 || !result.mimeType) return null;
   return { bytes: Buffer.from(result.base64, "base64"), mimeType: result.mimeType };
 }
-async function attemptKernelWhisper(videoId, kernelApiKey, falKey, start) {
+async function attemptKernelWhisper(videoId, kernelApiKey, kernelProxyId, falKey, start) {
   const driver = new BrowserDriver();
   try {
-    await driver.launch({ kernelApiKey, headless: true, viewport: { width: 1280, height: 800 }, locale: "en-US" });
+    await driver.launch({ kernelApiKey, kernelProxyId, headless: true, viewport: { width: 1280, height: 800 }, locale: "en-US" });
     const page = driver.getPage();
     await driver.navigateTo(`https://www.youtube.com/watch?v=${videoId}`);
     await page.waitForFunction(
@@ -7932,12 +7953,13 @@ async function attemptKernelWhisper(videoId, kernelApiKey, falKey, start) {
 }
 async function fetchViaKernelWhisper(videoId) {
   const kernelApiKey = browserServiceApiKey();
+  const kernelProxyId = browserServiceProxyId();
   const falKey = process.env.FAL_KEY;
   if (!kernelApiKey || !falKey) return null;
   const start = Date.now();
   for (let attempt = 0; attempt < 4; attempt++) {
     if (attempt > 0) await new Promise((r) => setTimeout(r, 2e3 * attempt));
-    const result = await attemptKernelWhisper(videoId, kernelApiKey, falKey, start);
+    const result = await attemptKernelWhisper(videoId, kernelApiKey, kernelProxyId, falKey, start);
     if (result) return result;
   }
   return null;
@@ -9396,9 +9418,8 @@ async function kernelLaunchOptsResidential() {
   try {
     const resolution = await resolveKernelProxyId({
       kernelApiKey: browserServiceApiKey(),
-      proxyMode: "location",
+      proxyMode: DEFAULT_PROXY_MODE,
       configuredKernelProxyId: browserServiceProxyId(),
-      location: "New York, NY",
       gl: "us"
     });
     if (resolution.kernelProxyId) proxyId = resolution.kernelProxyId;
@@ -10845,7 +10866,7 @@ var DirectoryWorkflowOptionsSchema = z15.object({
   saveCsv: z15.boolean().default(true),
   gl: z15.string().length(2).default("us"),
   hl: z15.string().length(2).default("en"),
-  proxyMode: z15.enum(["location", "configured", "none"]).default("location"),
+  proxyMode: z15.enum(["location", "configured", "none"]).default(DEFAULT_MAPS_PROXY_MODE),
   proxyZip: z15.string().regex(/^\d{5}$/).optional(),
   debug: z15.boolean().default(false),
   headless: z15.boolean().default(true),
@@ -11302,6 +11323,88 @@ async function executeWorkflowRun(input) {
     throw err;
   }
 }
+async function runWorkflowStepAndPersist(input) {
+  const runId = input.run.id;
+  const workflowId = input.run.workflow_id;
+  await markWorkflowRunRunning(runId);
+  let result;
+  try {
+    result = await runWorkflowStep(workflowId, input.workflowInput, {
+      stepIndex: input.stepIndex,
+      state: input.priorState ?? void 0,
+      options: {
+        apiKey: input.user.api_key,
+        apiUrl: input.apiUrl,
+        outputDir: hostedWorkflowOutputDir(),
+        runId,
+        headers: input.concurrencyLockId ? { "x-mcp-scraper-concurrency-lock": input.concurrencyLockId } : void 0
+      }
+    });
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    await failWorkflowRunRecord(runId, message, { error: message });
+    const failedRun = await getWorkflowRun(runId, input.user.id);
+    if (failedRun) await deliverWorkflowWebhook({ userId: input.user.id, run: failedRun, scheduleId: failedRun.schedule_id, webhookUrl: input.webhookUrl ?? null, summary: null, artifacts: [] });
+    throw err;
+  }
+  if (result.artifacts.length) {
+    await appendWorkflowArtifacts(runId, input.user.id, result.artifacts.map((a) => ({
+      kind: a.kind,
+      label: a.label,
+      path: a.path,
+      bytes: a.bytes,
+      rows: a.rows,
+      content: a.content
+    })));
+  }
+  const logEntry = {
+    stepIndex: result.stepIndex,
+    stepId: result.stepId,
+    stepTitle: result.stepTitle,
+    output: result.output,
+    warnings: result.warnings,
+    at: (/* @__PURE__ */ new Date()).toISOString()
+  };
+  const status = result.isLast ? result.summary?.status ?? "succeeded" : "running";
+  await advanceWorkflowRunStep(runId, {
+    stepIndex: result.stepIndex + 1,
+    totalSteps: result.totalSteps,
+    state: result.state,
+    status,
+    logEntry,
+    appendLog: input.priorLog
+  });
+  if (result.isLast && result.summary) {
+    const manifest = await readManifestFromSummary(result.summary);
+    await completeWorkflowRunRecord(runId, result.summary.status, manifest ?? { summary: result.summary });
+  }
+  const run = await getWorkflowRun(runId, input.user.id);
+  const artifacts = await listWorkflowArtifacts(runId, input.user.id);
+  if (result.isLast && run) {
+    await deliverWorkflowWebhook({ userId: input.user.id, run, scheduleId: run.schedule_id, webhookUrl: input.webhookUrl ?? null, summary: result.summary, artifacts });
+  }
+  const definition = workflowDefinition(workflowId);
+  const nextIndex = result.stepIndex + 1;
+  const nextStep = result.isLast ? null : {
+    index: nextIndex,
+    id: definition.steps?.[nextIndex]?.id ?? null,
+    title: definition.steps?.[nextIndex]?.title ?? null
+  };
+  return {
+    run: run ? exposeRun(input.c, run, artifacts) : null,
+    summary: result.isLast ? result.summary : null,
+    step: {
+      index: result.stepIndex,
+      id: result.stepId,
+      title: result.stepTitle,
+      totalSteps: result.totalSteps,
+      output: result.output,
+      warnings: result.warnings
+    },
+    nextStep,
+    done: result.isLast
+  };
+}
 workflowApp.get("/definitions", createApiKeyAuth(), (c) => {
   return c.json({ workflows: listWorkflowDefinitions() });
 });
@@ -11324,7 +11427,29 @@ workflowApp.post("/run", createApiKeyAuth(), async (c) => {
   if (!gate.ok) return c.json(concurrencyLimitExceededResponse(gate), 429, { "Retry-After": String(gate.retryAfterSeconds) });
   let run = null;
   try {
-    run = await createWorkflowRun({ userId: user.id, workflowId: parsed.data.workflowId, workflowInput: input });
+    const stepwise = workflowSupportsSteps(parsed.data.workflowId);
+    run = await createWorkflowRun({
+      userId: user.id,
+      workflowId: parsed.data.workflowId,
+      workflowInput: input,
+      webhookUrl,
+      totalSteps: stepwise ? workflowStepCount(parsed.data.workflowId) : 1
+    });
+    if (stepwise) {
+      const response = await runWorkflowStepAndPersist({
+        c,
+        user,
+        run,
+        workflowInput: input,
+        stepIndex: 0,
+        priorState: null,
+        priorLog: [],
+        apiUrl: originFromUrl(c.req.url),
+        webhookUrl,
+        concurrencyLockId: gate.lockId
+      });
+      return c.json(response);
+    }
     const executed = await executeWorkflowRun({
       runId: run.id,
       user,
@@ -11334,7 +11459,7 @@ workflowApp.post("/run", createApiKeyAuth(), async (c) => {
       webhookUrl,
       concurrencyLockId: gate.lockId
     });
-    return c.json({ run: exposeRun(c, executed.run, executed.artifacts), summary: executed.summary });
+    return c.json({ run: exposeRun(c, executed.run, executed.artifacts), summary: executed.summary, done: true });
   } catch (err) {
     const failed = run ? await getWorkflowRun(run.id, user.id) : null;
     return c.json({ run: failed, error: err instanceof Error ? err.message : String(err) }, 500);
@@ -11342,6 +11467,50 @@ workflowApp.post("/run", createApiKeyAuth(), async (c) => {
     await releaseConcurrencyGate(gate.lockId);
   }
 });
+var TERMINAL_RUN_STATUSES = ["succeeded", "partial", "failed", "cancelled"];
+workflowApp.post("/runs/:id/step", createApiKeyAuth(), async (c) => {
+  const user = c.get("user");
+  const run = await getWorkflowRun(c.req.param("id"), user.id);
+  if (!run) return c.json({ error: "Run not found" }, 404);
+  if (!workflowSupportsSteps(run.workflow_id)) {
+    return c.json({ error: `Workflow "${run.workflow_id}" does not support stepwise execution` }, 400);
+  }
+  const artifactsNow = await listWorkflowArtifacts(run.id, user.id);
+  if (TERMINAL_RUN_STATUSES.includes(run.status)) {
+    return c.json({ run: exposeRun(c, run, artifactsNow), done: true, error: `Run is already ${run.status}` }, 409);
+  }
+  const stepState = await getWorkflowRunStepState(run.id, user.id);
+  const stepIndex = stepState?.stepIndex ?? run.step_index;
+  const totalSteps = workflowStepCount(run.workflow_id);
+  if (stepIndex >= totalSteps) {
+    return c.json({ run: exposeRun(c, run, artifactsNow), done: true, error: "No remaining steps" }, 409);
+  }
+  const gate = await acquireConcurrencyGate(user, "workflow_run", {
+    ttlSeconds: 60 * 60,
+    metadata: { workflowId: run.workflow_id, step: stepIndex }
+  });
+  if (!gate.ok) return c.json(concurrencyLimitExceededResponse(gate), 429, { "Retry-After": String(gate.retryAfterSeconds) });
+  try {
+    const response = await runWorkflowStepAndPersist({
+      c,
+      user,
+      run,
+      workflowInput: run.input,
+      stepIndex,
+      priorState: stepState?.state ?? null,
+      priorLog: stepState?.stepLog ?? run.step_log,
+      apiUrl: originFromUrl(c.req.url),
+      webhookUrl: run.webhook_url,
+      concurrencyLockId: gate.lockId
+    });
+    return c.json(response);
+  } catch (err) {
+    const failed = await getWorkflowRun(run.id, user.id);
+    return c.json({ run: failed, error: err instanceof Error ? err.message : String(err) }, 500);
+  } finally {
+    await releaseConcurrencyGate(gate.lockId);
+  }
+});
 workflowApp.get("/runs", createApiKeyAuth(), async (c) => {
   const user = c.get("user");
   const runs = await listWorkflowRuns(user.id);
@@ -11360,14 +11529,17 @@ workflowApp.get("/runs/:id/artifacts/:artifactId", createApiKeyAuth(), async (c)
   if (!run) return c.json({ error: "Run not found" }, 404);
   const artifact = await getWorkflowArtifact(c.req.param("artifactId"), user.id);
   if (!artifact || artifact.run_id !== run.id) return c.json({ error: "Artifact not found" }, 404);
+  const filename = artifact.path.split("/").pop() || artifact.id;
+  const headers = {
+    "Content-Type": artifact.content_type,
+    "Content-Disposition": `attachment; filename="${filename}"`
+  };
+  if (artifact.content != null) {
+    return new Response(artifact.content, { headers });
+  }
   try {
     const content = await readFile2(artifact.path);
-    return new Response(content, {
-      headers: {
-        "Content-Type": artifact.content_type,
-        "Content-Disposition": `attachment; filename="${artifact.path.split("/").pop() || artifact.id}"`
-      }
-    });
+    return new Response(content, { headers });
   } catch {
     return c.json({ error: "Artifact file is no longer available" }, 410);
   }
@@ -11905,7 +12077,7 @@ var SerpIntelligenceCaptureBodySchema = z17.object({
   gl: z17.string().trim().length(2).default("us"),
   hl: z17.string().trim().length(2).default("en"),
   device: z17.enum(SerpIntelligenceDeviceValues).default("desktop"),
-  proxyMode: z17.enum(SerpIntelligenceProxyModeValues).default("location"),
+  proxyMode: z17.enum(SerpIntelligenceProxyModeValues).default(DEFAULT_PROXY_MODE),
   proxyZip: z17.string().regex(/^\d{5}$/).optional(),
   pages: z17.number().int().min(1).max(2).default(1),
   debug: z17.boolean().default(false),
@@ -12437,16 +12609,18 @@ var mcpApp = new Hono9();
 function registerSerpIntelligenceCaptureTools(server, executor) {
   server.registerTool("capture_serp_snapshot", {
     title: "SERP Intelligence Snapshot",
-    description: "Capture a structured SERP Intelligence Google snapshot through POST /serp-intelligence/capture, the same product capture path used by Phoenix. Split query from location, infer gl/hl, use proxyMode location for localized US residential evidence; location mode creates fresh proxy IDs across retries, briefly waits for browser-service automatic CAPTCHA/challenge solving when Google blocks a page, and rotates to a new proxy/session if the challenge does not clear or location evidence is wrong. Use configured only for the static residential proxy, and none only for direct-network debugging. Set debug true when investigating location evidence, proxy behavior, CAPTCHA, or capture reliability.",
+    description: "Capture a structured SERP Intelligence Google snapshot through POST /serp-intelligence/capture, the same product capture path used by Phoenix. Split query from location and infer gl/hl. Omit proxyMode for normal use; the service defaults to the configured browser-service proxy without city/ZIP targeting for the highest general success rate. Use proxyMode location only when the user explicitly needs city/ZIP-targeted residential proxy evidence. Use none only for direct-network debugging. Set debug true when investigating location evidence, proxy behavior, CAPTCHA, or capture reliability.",
     inputSchema: CaptureSerpSnapshotInputSchema,
+    outputSchema: CaptureSerpSnapshotOutputSchema,
     annotations: liveWebToolAnnotations("SERP Intelligence Snapshot")
-  }, async (input) => executor.captureSerpSnapshot(input));
+  }, async (input) => formatCaptureSerpSnapshot(await executor.captureSerpSnapshot(input), input));
   server.registerTool("capture_serp_page_snapshots", {
     title: "SERP Intelligence Page Snapshots",
     description: "Capture public ranking-page evidence through POST /serp-intelligence/page-snapshots, the same product page snapshot path used by Phoenix. Provide urls for simple captures or targets when preserving organic, AI citation, local-pack, configured target, or site-subject source metadata. Private IPs, localhost, file URLs, and internal URLs are rejected by the service. Use timeoutMs for slow pages and debug true for sanitized proxy/browser diagnostics.",
     inputSchema: CaptureSerpPageSnapshotsInputSchema,
+    outputSchema: CaptureSerpPageSnapshotsOutputSchema,
     annotations: liveWebToolAnnotations("SERP Intelligence Page Snapshots")
-  }, async (input) => executor.captureSerpPageSnapshots(input));
+  }, async (input) => formatCaptureSerpPageSnapshots(await executor.captureSerpPageSnapshots(input), input));
 }
 mcpApp.all("/", async (c) => {
   try {
@@ -14103,7 +14277,7 @@ app.post("/harvest", auth2, async (c) => {
     gl: body.gl ?? "us",
     hl: body.hl ?? "en",
     device: body.device ?? "desktop",
-    proxyMode: body.proxyMode ?? "location",
+    proxyMode: body.proxyMode ?? DEFAULT_PROXY_MODE,
     proxyZip: body.proxyZip,
     debug: body.debug ?? false,
     serpOnly: body.serpOnly ?? false,
@@ -14139,7 +14313,7 @@ app.post("/harvest/sync", auth2, async (c) => {
     gl: body.gl ?? "us",
     hl: body.hl ?? "en",
     device: body.device ?? "desktop",
-    proxyMode: body.proxyMode ?? "location",
+    proxyMode: body.proxyMode ?? DEFAULT_PROXY_MODE,
     proxyZip: body.proxyZip,
     debug: body.debug ?? false,
     serpOnly: body.serpOnly ?? false,
@@ -14605,7 +14779,7 @@ app.get("/cron/tick", async (c) => {
   if (!process.env.CRON_SECRET || secret2 !== `Bearer ${process.env.CRON_SECRET}`) {
     return c.json({ error: "Unauthorized" }, 401);
   }
-  const { drainQueue } = await import("./worker-OZSWIS3F.js");
+  const { drainQueue } = await import("./worker-MIYG2B2I.js");
   const budget = { maxJobs: 10, deadlineMs: Date.now() + 28e4 };
   const workflowDispatchResult = await dispatchDueWorkflowSchedules(`${new URL(c.req.url).protocol}//${new URL(c.req.url).host}`);
   const [results, sweepResult] = await Promise.all([
@@ -14733,4 +14907,4 @@ app.get("/blog/:slug/", (c) => {
 export {
   app
 };
-//# sourceMappingURL=server-VVY5K44O.js.map
+//# sourceMappingURL=server-7NE45K2A.js.map