@spark-apps/quickpeek 1.2.4 → 1.2.6

package/dist/{voices-CPpnWn39.d.mts → voices-5AFt1GDp.d.mts}

@@ -3,7 +3,7 @@ import { Page } from 'playwright';
 /**
  * Configuration types and defaults for QuickPeek
  */
-declare const VERSION = "1.2.3";
+declare const VERSION = "1.2.6";
 declare const CONFIG_FILE = "quickpeek.config.json";
 type UserTier = 'free' | 'pro' | 'elite';
 /** The one dimension knob users see: wide (16:9) or short (9:16). */
@@ -63,6 +63,12 @@ interface Config {
         contrast: number;
         tempo: number;
         stepDelay: number;
+        watermark?: {
+            name: string;
+            iconPath?: string;
+            position?: 'top-right' | 'top-left' | 'bottom-right' | 'bottom-left';
+            opacity?: number;
+        };
         outro?: string;
         outroCard?: {
             /** The app the video is about - the card's headline. */
@@ -71,6 +77,8 @@ interface Config {
                 tagline?: string;
                 domain?: string;
                 iconPath?: string;
+                /** Play the mark rather than show a still of it. See OutroSubject. */
+                animatedMark?: 'vidlet';
             };
             /** Tools that made the video, shown small in the corner. */
             credits?: Array<{
@@ -123,10 +131,25 @@ interface Config {
         /**
          * Which bundled CC0 bed to score with when no `path` is given.
          *
-         * 'calm' | 'gentle' | 'lofi' - see assets/music/manifest.json. An unknown
+         * 'corporate' | 'calm' | 'lofi' - see assets/music/manifest.json. An unknown
          * mood falls back to the default rather than dropping the music.
          */
         mood?: string;
+        /**
+         * Hold the music back until the closing card.
+         *
+         * A track written FOR the product is not a bed: ducked under a narrator
+         * for a minute it is inaudible, and it is the thing people are meant to
+         * hear. With this on, the demo plays dry and the song fades in exactly as
+         * the closing card arrives, with the rest of the video silent underneath
+         * the voice.
+         *
+         * ON by default. Music under narration was the single most disliked thing
+         * about the output: ducked it is mud, unducked it fights the voice, and
+         * either way it makes a 17 second demo sound like a stock video. Set
+         * false in quickpeek.config.json to score the whole video.
+         */
+        outroOnly?: boolean;
     };
     timing: {
         minStepDuration: number;
@@ -257,6 +280,8 @@ interface AIError {
     host?: string;
     /** Raw response body (truncated), for the error log. */
     detail?: string;
+    /** The call succeeded but its output was not a usable plan. */
+    isParseError?: boolean;
 }
 type AIResult = AIResponse | AIError;
 /** Called before each backoff so the CLI can explain a long pause. */
@@ -299,6 +324,11 @@ declare const SERVER_BACKOFF_MS: number[];
  * 16 Aug 2026). Only safe where a human is waiting on a spinner.
  */
 declare const CLI_BACKOFF_MS: number[];
+declare const RELAY_BASE: string;
+/**
+ * Relay mode: exchange the signed-in email for a short-lived relay token (cached)
+ */
+declare function getOrRefreshRelayToken(email: string): Promise<string>;
 /**
  * Direct Spark AI call using the runtime SPARK_AI_KEY (dev + server-side use).
  */
@@ -310,7 +340,17 @@ declare function callAI(systemPrompt: string, userPrompt: string, tier?: UserTie
  */
 declare function callAIViaRelay(systemPrompt: string, userPrompt: string, email: string, tier?: UserTier, opts?: ChatOptions): Promise<AIResult>;
 /**
- * Parse AI-generated plan JSON from response text
+ * Parse AI-generated plan JSON from response text.
+ *
+ * Delegates to parseAIJson, the same lenient path the CLI's plan step uses.
+ * This used to do its own `\{[\s\S]*\}` extraction, which fails on exactly the
+ * two things a model does under a token ceiling: stopping mid-array (the
+ * greedy match then ends at an inner brace and JSON.parse throws), and
+ * spending the whole budget on prose so no braces are emitted at all — the
+ * "No valid JSON found in AI response" the web wizard kept showing, where
+ * hitting Retry worked only because the next sample happened to be terser.
+ * The repair path recovers every complete step from a truncated plan, so a
+ * clipped response yields a usable plan instead of an error and a re-crawl.
  */
 declare function parseAIPlanResponse(content: string): {
     success: true;
@@ -329,6 +369,36 @@ declare function parseAIPlanResponse(content: string): {
     success: false;
     error: string;
 };
+/**
+ * Ask for a plan and parse it, resampling once if the answer is unusable.
+ *
+ * parseAIJson recovers a truncated plan, but it cannot recover the other
+ * failure mode: a model that spends its whole completion budget reasoning in
+ * prose and is cut off before writing a single brace. That is sampling luck,
+ * not a broken request — which is why the wizard's Retry button "fixed" it,
+ * and why the fix is to resample here rather than to hand the user a red box.
+ * Retrying in the route is strictly cheaper than the user retrying: their
+ * Retry re-runs the page crawl as well.
+ *
+ * Exactly one extra attempt. A model that produces prose twice is a prompt or
+ * backend problem, and a third round trip only spends the caller's serverless
+ * budget on the same answer.
+ */
+declare function callAIForPlan(systemPrompt: string, userPrompt: string, tier?: UserTier, opts?: ChatOptions): Promise<{
+    success: true;
+    plan: {
+        title?: string;
+        description?: string;
+        steps: Array<{
+            id?: number;
+            action?: string;
+            caption?: string;
+            target?: string;
+            value?: string;
+        }>;
+    };
+    limits: RateLimitInfo;
+} | AIError>;
 /**
  * Normalize a URL by adding https:// and stripping www prefix
  */
@@ -373,6 +443,12 @@ interface Step {
     highlight?: HighlightMode;
     mediaFile?: string;
     mediaType?: 'image' | 'video';
+    /**
+     * A small JPEG data URL of the file `value` names, attached only when a plan
+     * is handed to the browser editor, which cannot read a path on disk. Never
+     * written to a plan file; see plan-thumbs.ts.
+     */
+    thumb?: string;
     /**
      * Speak this step's caption but do not burn it.
      *
@@ -610,4 +686,4 @@ declare function hasVoice(lang: string): boolean;
  */
 declare function voiceFor(lang: string, gender?: VoiceGender): string | null;
 
-export { getTierByEmail as $, type AIError as A, type VoiceGender as B, type CaptionStyle as C, DEFAULT_CAPTIONS as D, EXCLUDED_LINK_PATTERNS as E, applyProfile as F, ariaLabelSelector as G, type HighlightMode as H, INTERACTIVE_SELECTORS as I, buildSystemPrompt as J, buildUserPrompt as K, callAI as L, callAIViaRelay as M, NO_CLIP_OUTRO as N, crawlPage as O, PLAN_MAX_TOKENS as P, deStock as Q, RATE_FACTOR as R, SERVER_BACKOFF_MS as S, type Tier as T, type UserTier as U, type VoiceRate as V, defaultCaptionsFor as W, getErrorMessage as X, getLanguageName as Y, getStatus as Z, getStatusCached as _, type CaptionPosition as a, gotoSettled as a0, hasTrialRemaining as a1, hasVoice as a2, idSelector as a3, internationalVoiceFor as a4, isCanceling as a5, isExcludedLink as a6, isPaid as a7, isVerified as a8, normalizeUrl as a9, parseAIPlanResponse as aa, parsePartial as ab, pricingUrl as ac, rgbaToHex as ad, runPooled as ae, shouldSkipLink as af, showPaywall as ag, stripLongDashes as ah, toTitleCase as ai, voiceFor as aj, waitForPlaceholdersGone as ak, getTier as al, type Config as b, type AIResponse as c, type AIResult as d, CLI_BACKOFF_MS as e, CONFIG_FILE as f, type CaptionPreset as g, type CaptionWordStyle as h, type ChatOptions as i, DEFAULT_CONFIG as j, type ElementInfo as k, type ElementType as l, INTERNATIONAL_VOICE as m, type Plan as n, type RateLimitInfo as o, type RetryNotice as p, SIZE_PRESETS as q, type SparkStatus as r, type SparkSubscription as s, type SparkTrial as t, type Step as u, type SuggestedAction as v, VERSION as w, VIDEO_PROFILES as x, type VideoProfileName as y, type VideoSize as z };
+export { getOrRefreshRelayToken as $, type AIError as A, type VideoSize as B, type CaptionStyle as C, DEFAULT_CAPTIONS as D, EXCLUDED_LINK_PATTERNS as E, type VoiceGender as F, applyProfile as G, type HighlightMode as H, INTERACTIVE_SELECTORS as I, ariaLabelSelector as J, buildSystemPrompt as K, buildUserPrompt as L, callAI as M, NO_CLIP_OUTRO as N, callAIForPlan as O, PLAN_MAX_TOKENS as P, callAIViaRelay as Q, RATE_FACTOR as R, SERVER_BACKOFF_MS as S, type Tier as T, type UserTier as U, type VoiceRate as V, crawlPage as W, deStock as X, defaultCaptionsFor as Y, getErrorMessage as Z, getLanguageName as _, type CaptionPosition as a, getStatus as a0, getStatusCached as a1, getTierByEmail as a2, gotoSettled as a3, hasTrialRemaining as a4, hasVoice as a5, idSelector as a6, internationalVoiceFor as a7, isCanceling as a8, isExcludedLink as a9, isPaid as aa, isVerified as ab, normalizeUrl as ac, parseAIPlanResponse as ad, parsePartial as ae, pricingUrl as af, rgbaToHex as ag, runPooled as ah, shouldSkipLink as ai, showPaywall as aj, stripLongDashes as ak, toTitleCase as al, voiceFor as am, waitForPlaceholdersGone as an, getTier as ao, type Config as b, type AIResponse as c, type AIResult as d, CLI_BACKOFF_MS as e, CONFIG_FILE as f, type CaptionPreset as g, type CaptionWordStyle as h, type ChatOptions as i, DEFAULT_CONFIG as j, type ElementInfo as k, type ElementType as l, INTERNATIONAL_VOICE as m, type Plan as n, RELAY_BASE as o, type RateLimitInfo as p, type RetryNotice as q, SIZE_PRESETS as r, type SparkStatus as s, type SparkSubscription as t, type SparkTrial as u, type Step as v, type SuggestedAction as w, VERSION as x, VIDEO_PROFILES as y, type VideoProfileName as z };

package/dist/web.d.mts

@@ -1,5 +1,5 @@
-import { n as Plan } from './voices-CPpnWn39.mjs';
-export { A as AIError, c as AIResponse, d as AIResult, i as ChatOptions, E as EXCLUDED_LINK_PATTERNS, k as ElementInfo, l as ElementType, H as HighlightMode, I as INTERACTIVE_SELECTORS, m as INTERNATIONAL_VOICE, P as PLAN_MAX_TOKENS, o as RateLimitInfo, r as SparkStatus, s as SparkSubscription, t as SparkTrial, u as Step, v as SuggestedAction, T as Tier, J as buildSystemPrompt, K as buildUserPrompt, L as callAI, O as crawlPage, Q as deStock, X as getErrorMessage, Y as getLanguageName, Z as getStatus, _ as getStatusCached, al as getTier, $ as getTierByEmail, a1 as hasTrialRemaining, a2 as hasVoice, a4 as internationalVoiceFor, a5 as isCanceling, a6 as isExcludedLink, a7 as isPaid, a8 as isVerified, a9 as normalizeUrl, aa as parseAIPlanResponse, ab as parsePartial, ac as pricingUrl, ad as rgbaToHex, ae as runPooled, af as shouldSkipLink, ag as showPaywall, ah as stripLongDashes, ai as toTitleCase, aj as voiceFor } from './voices-CPpnWn39.mjs';
+import { n as Plan } from './voices-5AFt1GDp.mjs';
+export { A as AIError, c as AIResponse, d as AIResult, i as ChatOptions, E as EXCLUDED_LINK_PATTERNS, k as ElementInfo, l as ElementType, H as HighlightMode, I as INTERACTIVE_SELECTORS, m as INTERNATIONAL_VOICE, P as PLAN_MAX_TOKENS, p as RateLimitInfo, s as SparkStatus, t as SparkSubscription, u as SparkTrial, v as Step, w as SuggestedAction, T as Tier, K as buildSystemPrompt, L as buildUserPrompt, M as callAI, O as callAIForPlan, W as crawlPage, X as deStock, Z as getErrorMessage, _ as getLanguageName, a0 as getStatus, a1 as getStatusCached, ao as getTier, a2 as getTierByEmail, a4 as hasTrialRemaining, a5 as hasVoice, a7 as internationalVoiceFor, a8 as isCanceling, a9 as isExcludedLink, aa as isPaid, ab as isVerified, ac as normalizeUrl, ad as parseAIPlanResponse, ae as parsePartial, af as pricingUrl, ag as rgbaToHex, ah as runPooled, ai as shouldSkipLink, aj as showPaywall, ak as stripLongDashes, al as toTitleCase, am as voiceFor } from './voices-5AFt1GDp.mjs';
 export { MALE_VOICES, MULTILINGUAL_VOICES, WIDE_VOICES, hexToAss as hexToASS, windowsDrivePathToWsl as windowsPathToWSL } from '@spark-apps/video-kit';
 import 'playwright';
 

package/dist/web.mjs

@@ -1,3 +1,105 @@
+// src/lib/json-repair.ts
+function repairUnicodeEscapes(content) {
+  return content.replace(/\\u\{([0-9a-fA-F]{1,6})\}/g, (match, hex) => {
+    const code = Number.parseInt(hex, 16);
+    return code <= 1114111 ? String.fromCodePoint(code) : match;
+  }).replace(/\\u(?![0-9a-fA-F]{4})/g, "\\\\u");
+}
+var MAX_SALVAGE_ATTEMPTS = 500;
+var CLOSERS = { "{": "}", "[": "]" };
+function salvageTruncatedJson(content) {
+  const stack = [];
+  const cuts = [];
+  let inString = false;
+  let escaped = false;
+  const record = (index, closesContainer) => cuts.push({ index, open: stack.join(""), closesContainer });
+  for (let i = 0; i < content.length; i++) {
+    const ch = content[i];
+    if (inString) {
+      if (escaped) escaped = false;
+      else if (ch === "\\") escaped = true;
+      else if (ch === '"') {
+        inString = false;
+        record(i + 1, false);
+      }
+      continue;
+    }
+    if (ch === '"') {
+      inString = true;
+    } else if (ch === "{" || ch === "[") {
+      stack.push(ch);
+    } else if (ch === "}" || ch === "]") {
+      stack.pop();
+      record(i + 1, true);
+    } else if (ch === ",") {
+      record(i, content[i - 1] === "}" || content[i - 1] === "]");
+    }
+  }
+  const tryCut = (cut) => {
+    const head = content.slice(0, cut.index).replace(/[\s,]+$/, "");
+    if (head.endsWith(":")) return null;
+    let closed = head;
+    for (let d = cut.open.length - 1; d >= 0; d--) {
+      closed += CLOSERS[cut.open[d]];
+    }
+    try {
+      JSON.parse(closed);
+      return closed;
+    } catch {
+      return null;
+    }
+  };
+  const attempts = Math.min(cuts.length, MAX_SALVAGE_ATTEMPTS);
+  for (const containerOnly of [true, false]) {
+    for (let n = 0; n < attempts; n++) {
+      const cut = cuts[cuts.length - 1 - n];
+      if (containerOnly && !cut.closesContainer) continue;
+      const salvaged = tryCut(cut);
+      if (salvaged !== null) return salvaged;
+    }
+  }
+  return null;
+}
+function extractJsonCandidates(content) {
+  let text = content.trim();
+  const fence = text.match(/```(?:json)?\s*([\s\S]*?)(?:```|$)/);
+  if (fence?.[1]?.trim()) text = fence[1].trim();
+  const start = text.search(/[{[]/);
+  if (start === -1) return [];
+  const closer = text[start] === "{" ? "}" : "]";
+  const end = text.lastIndexOf(closer);
+  const candidates = [text.slice(start)];
+  if (end > start && end < text.length - 1) candidates.unshift(text.slice(start, end + 1));
+  return candidates;
+}
+function parseAIJson(content) {
+  const candidates = extractJsonCandidates(content);
+  if (candidates.length === 0) return null;
+  for (const text of candidates) {
+    try {
+      return { value: JSON.parse(text), repaired: false };
+    } catch {
+    }
+  }
+  for (const text of candidates) {
+    try {
+      return { value: JSON.parse(repairUnicodeEscapes(text)), repaired: true };
+    } catch {
+    }
+  }
+  for (const text of candidates) {
+    for (const variant of [repairUnicodeEscapes(text), text]) {
+      const salvaged = salvageTruncatedJson(variant);
+      if (salvaged === null) continue;
+      try {
+        return { value: JSON.parse(salvaged), repaired: true };
+      } catch {
+      }
+    }
+  }
+  return null;
+}
+
 // src/lib/utils.ts
 import { hexToAss } from "@spark-apps/video-kit";
 import { windowsDrivePathToWsl } from "@spark-apps/video-kit";
@@ -276,24 +378,26 @@ async function callAI(systemPrompt, userPrompt, tier = "free", opts = {}) {
   }
 }
 function parseAIPlanResponse(content) {
-  try {
-    let processedContent = content;
-    const codeBlockMatch = processedContent.match(/```(?:json)?\s*([\s\S]*?)```/);
-    if (codeBlockMatch?.[1]) {
-      processedContent = codeBlockMatch[1].trim();
-    }
-    const jsonMatch = processedContent.match(/\{[\s\S]*\}/);
-    if (!jsonMatch) {
-      return { success: false, error: "No valid JSON found in AI response" };
-    }
-    const parsed = JSON.parse(jsonMatch[0]);
-    return { success: true, plan: parsed };
-  } catch (err) {
-    return {
-      success: false,
-      error: `Failed to parse AI response: ${err instanceof Error ? err.message : String(err)}`
-    };
+  const parsed = parseAIJson(content);
+  if (!parsed) {
+    return { success: false, error: "No valid JSON found in AI response" };
+  }
+  if (!Array.isArray(parsed.value.steps) || parsed.value.steps.length === 0) {
+    return { success: false, error: "AI response has no steps" };
+  }
+  return { success: true, plan: { ...parsed.value, steps: parsed.value.steps } };
+}
+async function callAIForPlan(systemPrompt, userPrompt, tier = "free", opts = {}) {
+  let lastParseError = "No valid JSON found in AI response";
+  for (let attempt = 1; attempt <= 2; attempt++) {
+    const aiResult = await callAI(systemPrompt, userPrompt, tier, opts);
+    if (!aiResult.success) return aiResult;
+    const parsed = parseAIPlanResponse(aiResult.content);
+    if (parsed.success) return { success: true, plan: parsed.plan, limits: aiResult.limits };
+    lastParseError = parsed.error;
+    console.error(`Plan parse failed (attempt ${attempt}/2):`, parsed.error);
   }
+  return { success: false, error: lastParseError, isParseError: true };
 }
 function normalizeUrl(input) {
   let url = input.trim();
@@ -301,8 +405,24 @@ function normalizeUrl(input) {
   return `https://${url}`;
 }
 
-// src/lib/crawl.ts
+// src/browser/headless.ts
 import { chromium } from "playwright";
+var NO_BROWSER_MESSAGE = "QuickPeek needs a browser to record and could not find one.\n  Run this once, then run QuickPeek again:\n    npx playwright install chromium";
+async function launchHeadlessChromium(options = {}) {
+  const opts = { ...options, headless: true };
+  try {
+    return await chromium.launch(opts);
+  } catch (bundledError) {
+    try {
+      return await chromium.launch({ ...opts, channel: "chrome" });
+    } catch {
+      const detail = bundledError instanceof Error ? bundledError.message : String(bundledError);
+      throw new Error(`${NO_BROWSER_MESSAGE}
+
+  Playwright reported: ${detail}`);
+    }
+  }
+}
 
 // src/lib/scraping.ts
 var EXCLUDED_LINK_PATTERNS = [
@@ -423,6 +543,7 @@ async function waitForDomStable(page, cap = SETTLE_CAP_MS) {
 var PLACEHOLDER_POLL_MS = 250;
 var PLACEHOLDER_CAP_MS = 8e3;
 var PLACEHOLDER_STATIC_POLLS = 4;
+var PLACEHOLDER_CLEAR_POLLS = 3;
 var PLACEHOLDER_SELECTOR = [
   '[aria-busy="true"]',
   '[role="progressbar"]',
@@ -435,6 +556,7 @@ async function waitForPlaceholdersGone(page, cap = PLACEHOLDER_CAP_MS) {
   const deadline = Date.now() + cap;
   let previous = -1;
   let unchanged = 0;
+  let clear = 0;
   while (Date.now() < deadline) {
     const count = await page.evaluate((selector) => {
       let visible = 0;
@@ -444,7 +566,12 @@ async function waitForPlaceholdersGone(page, cap = PLACEHOLDER_CAP_MS) {
       }
       return visible;
     }, PLACEHOLDER_SELECTOR).catch(() => 0);
-    if (count === 0) return;
+    if (count === 0) {
+      if (++clear >= PLACEHOLDER_CLEAR_POLLS) return;
+      await page.waitForTimeout(PLACEHOLDER_POLL_MS);
+      continue;
+    }
+    clear = 0;
     if (count === previous) {
       if (++unchanged >= PLACEHOLDER_STATIC_POLLS) return;
     } else {
@@ -530,7 +657,13 @@ async function crawlPage(url, task = noopTask, storageStatePath, viewport) {
     return { title: cached.title, elements: [...cached.elements], scrollable: cached.scrollable };
   }
   const browserTask = task("Launching browser");
-  const browser = await chromium.launch({ headless: true });
+  let browser;
+  try {
+    browser = await launchHeadlessChromium();
+  } catch (err) {
+    browserTask.succeed("Could not launch a browser");
+    throw err;
+  }
   try {
     const context = await browser.newContext({
       ...storageStatePath ? { storageState: storageStatePath } : {},
@@ -1307,6 +1440,7 @@ export {
   buildSystemPrompt,
   buildUserPrompt,
   callAI,
+  callAIForPlan,
   collectPreservedValues,
   crawlPage,
   deStock,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spark-apps/quickpeek",
-  "version": "1.2.4",
+  "version": "1.2.6",
   "description": "Auto-generate demo videos for your web app with AI",
   "mcpName": "co.quickpeek/quickpeek",
   "main": "dist/qp.js",
@@ -48,8 +48,15 @@
     "voiceover",
     "automation",
     "cli",
-    "documentation"
+    "documentation",
+    "mcp",
+    "model-context-protocol"
   ],
+  "homepage": "https://quickpeek.co",
+  "bugs": {
+    "url": "https://quickpeek.co/docs",
+    "email": "support@quickpeek.co"
+  },
   "license": "MIT",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",