@spark-apps/quickpeek 1.2.5 → 1.2.6

package/dist/qp.js

@@ -147,6 +147,139 @@ var init_image_kind = __esm({
   }
 });
 
+// src/browser/headless.ts
+async function launchHeadlessChromium(options = {}) {
+  const opts = { ...options, headless: true };
+  try {
+    return await import_playwright.chromium.launch(opts);
+  } catch (bundledError) {
+    try {
+      return await import_playwright.chromium.launch({ ...opts, channel: "chrome" });
+    } catch {
+      const detail = bundledError instanceof Error ? bundledError.message : String(bundledError);
+      throw new Error(`${NO_BROWSER_MESSAGE}
+
+  Playwright reported: ${detail}`);
+    }
+  }
+}
+var import_playwright, NO_BROWSER_MESSAGE;
+var init_headless = __esm({
+  "src/browser/headless.ts"() {
+    "use strict";
+    import_playwright = require("playwright");
+    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";
+  }
+});
+
+// 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");
+}
+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;
+}
+var MAX_SALVAGE_ATTEMPTS, CLOSERS;
+var init_json_repair = __esm({
+  "src/lib/json-repair.ts"() {
+    "use strict";
+    MAX_SALVAGE_ATTEMPTS = 500;
+    CLOSERS = { "{": "}", "[": "]" };
+  }
+});
+
 // src/lib/utils.ts
 function getLanguageName(lang) {
   if (!lang || lang === "en") return null;
@@ -468,24 +601,26 @@ async function callAIViaRelay(systemPrompt, userPrompt, email, tier = "free", op
   }
 }
 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();
@@ -496,6 +631,7 @@ var PLAN_MAX_TOKENS, SERVER_BACKOFF_MS, CLI_BACKOFF_MS, SPARK_AI_BASE, SPARK_AI_
 var init_api_client = __esm({
   "src/lib/api-client.ts"() {
     "use strict";
+    init_json_repair();
     init_utils();
     PLAN_MAX_TOKENS = 1500;
     SERVER_BACKOFF_MS = [2e3, 4e3];
@@ -666,7 +802,7 @@ var VERSION, CONFIG_FILE, SIZE_PRESETS, RATE_FACTOR, NO_CLIP_OUTRO, DEFAULT_CONF
 var init_config = __esm({
   "src/lib/config.ts"() {
     "use strict";
-    VERSION = "1.2.5";
+    VERSION = "1.2.6";
     CONFIG_FILE = "quickpeek.config.json";
     SIZE_PRESETS = {
       wide: { width: 1920, height: 1080, zoom: 1 },
@@ -977,7 +1113,13 @@ async function crawlPage(url, task2 = noopTask, storageStatePath, viewport) {
     return { title: cached.title, elements: [...cached.elements], scrollable: cached.scrollable };
   }
   const browserTask = task2("Launching browser");
-  const browser = await import_playwright4.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 } : {},
@@ -1153,11 +1295,11 @@ async function crawlPage(url, task2 = noopTask, storageStatePath, viewport) {
     });
   }
 }
-var import_playwright4, SETTLE_POLL_MS, SETTLE_STABLE_POLLS, SETTLE_CAP_MS, PLACEHOLDER_POLL_MS, PLACEHOLDER_CAP_MS, PLACEHOLDER_STATIC_POLLS, PLACEHOLDER_CLEAR_POLLS, PLACEHOLDER_SELECTOR, noopTask, CRAWL_CACHE_TTL_MS, CRAWL_CACHE_MAX_ENTRIES, crawlCache;
+var SETTLE_POLL_MS, SETTLE_STABLE_POLLS, SETTLE_CAP_MS, PLACEHOLDER_POLL_MS, PLACEHOLDER_CAP_MS, PLACEHOLDER_STATIC_POLLS, PLACEHOLDER_CLEAR_POLLS, PLACEHOLDER_SELECTOR, noopTask, CRAWL_CACHE_TTL_MS, CRAWL_CACHE_MAX_ENTRIES, crawlCache;
 var init_crawl = __esm({
   "src/lib/crawl.ts"() {
     "use strict";
-    import_playwright4 = require("playwright");
+    init_headless();
     init_scraping();
     SETTLE_POLL_MS = 400;
     SETTLE_STABLE_POLLS = 2;
@@ -2635,114 +2777,6 @@ var init_ffmpeg2 = __esm({
   }
 });
 
-// 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");
-}
-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;
-}
-var MAX_SALVAGE_ATTEMPTS, CLOSERS;
-var init_json_repair = __esm({
-  "src/lib/json-repair.ts"() {
-    "use strict";
-    MAX_SALVAGE_ATTEMPTS = 500;
-    CLOSERS = { "{": "}", "[": "]" };
-  }
-});
-
 // src/lib/prompts.ts
 function buildSystemPrompt(maxSteps, profile) {
   let scope;
@@ -4115,6 +4149,7 @@ __export(lib_exports, {
   buildUserPrompt: () => buildUserPrompt,
   buildWatermarkFilters: () => buildWatermarkFilters,
   callAI: () => callAI,
+  callAIForPlan: () => callAIForPlan,
   callAIViaRelay: () => callAIViaRelay,
   canReuseVoiceover: () => canReuseVoiceover,
   captionCanvas: () => captionCanvas,
@@ -5037,7 +5072,7 @@ async function listAuthStates() {
 
 // src/browser/launch.ts
 var import_promises2 = require("fs/promises");
-var import_playwright2 = require("playwright");
+var import_playwright3 = require("playwright");
 init_lifecycle();
 
 // src/browser/brand-watermark.ts
@@ -5131,11 +5166,14 @@ function clampOpacity(value) {
   return Math.min(1, Math.max(0.35, value));
 }
 
+// src/browser/launch.ts
+init_headless();
+
 // src/browser/wsl.ts
 var import_node_child_process = require("child_process");
 var import_node_fs3 = require("fs");
 var import_node_http = require("http");
-var import_playwright = require("playwright");
+var import_playwright2 = require("playwright");
 function isWSL() {
   if (process.platform !== "linux") return false;
   try {
@@ -5254,7 +5292,7 @@ async function launchWindowsChrome(extensionPath, userDataDir, options = {}) {
   const { proc: relay, port: proxyPort } = await startRelay(nodePath, windowsHost, debugPort);
   try {
     await waitForChrome(windowsHost, proxyPort);
-    const browser = await import_playwright.chromium.connectOverCDP(`http://${windowsHost}:${proxyPort}`, { timeout: 5e3 });
+    const browser = await import_playwright2.chromium.connectOverCDP(`http://${windowsHost}:${proxyPort}`, { timeout: 5e3 });
     return {
       browser,
       cleanup: async () => {
@@ -5311,7 +5349,7 @@ async function launchBrowserContext(config, userDataDir, recordVideo, storageSta
           acceptDownloads: true
         });
       } catch {
-        context = await import_playwright2.chromium.launchPersistentContext(userDataDir, {
+        context = await import_playwright3.chromium.launchPersistentContext(userDataDir, {
           headless: false,
           args: persistentArgs,
           viewport,
@@ -5322,7 +5360,7 @@ async function launchBrowserContext(config, userDataDir, recordVideo, storageSta
         });
       }
     } else {
-      context = await import_playwright2.chromium.launchPersistentContext(userDataDir, {
+      context = await import_playwright3.chromium.launchPersistentContext(userDataDir, {
         headless: false,
         args: persistentArgs,
         viewport,
@@ -5340,12 +5378,12 @@ async function launchBrowserContext(config, userDataDir, recordVideo, storageSta
         ignoreDefaultArgs: ["--enable-automation"]
       };
       try {
-        browser = await import_playwright2.chromium.launch({ ...headedOpts, channel: "chrome" });
+        browser = await import_playwright3.chromium.launch({ ...headedOpts, channel: "chrome" });
       } catch {
-        browser = await import_playwright2.chromium.launch(headedOpts);
+        browser = await import_playwright3.chromium.launch(headedOpts);
       }
     } else {
-      browser = await import_playwright2.chromium.launch({ headless: true });
+      browser = await launchHeadlessChromium();
     }
     context = await browser.newContext({
       viewport,
@@ -5382,9 +5420,9 @@ async function launchSignInBrowser() {
     ignoreDefaultArgs: ["--enable-automation"]
   };
   try {
-    return await import_playwright2.chromium.launch({ ...opts, channel: "chrome" });
+    return await import_playwright3.chromium.launch({ ...opts, channel: "chrome" });
   } catch {
-    return await import_playwright2.chromium.launch(opts);
+    return await import_playwright3.chromium.launch(opts);
   }
 }
 async function cleanupBrowserSession(session) {
@@ -5453,7 +5491,7 @@ async function cancelSignIn() {
 var import_node_fs4 = require("fs");
 var import_node_os2 = require("os");
 var import_node_path2 = require("path");
-var import_playwright3 = require("playwright");
+var import_playwright4 = require("playwright");
 var BROWSERS = [
   {
     key: "chrome",
@@ -5563,7 +5601,7 @@ async function readState(profileDir, channel, store2) {
   ];
   if (store2) args.push(`--password-store=${store2}`);
   try {
-    const context = await import_playwright3.chromium.launchPersistentContext(profileDir, { headless: true, channel, args });
+    const context = await import_playwright4.chromium.launchPersistentContext(profileDir, { headless: true, channel, args });
     try {
       return await context.storageState();
     } finally {
@@ -6359,35 +6397,23 @@ async function setupUserEmail() {
   console.log(import_chalk5.default.white("  needs an address to meter. No card, and no verification"));
   console.log(import_chalk5.default.white("  needed for your first 5 videos."));
   console.log(import_chalk5.default.dim("  After that, signing in gets you 10 videos a day."));
-  const browserEmail = await browserLogin();
-  if (browserEmail) {
-    console.log();
-    console.log(import_chalk5.default.green(`  \u2713 Signed in as ${browserEmail}`));
-    console.log();
-    return browserEmail;
-  }
   console.log();
-  console.log(import_chalk5.default.dim("  Or enter your email (Enter to skip):"));
+  console.log(import_chalk5.default.dim("  Type your email, or 'b' to sign in through a browser."));
   const email = await prompt(import_chalk5.default.white("  Email: "));
-  if (!email) {
+  if (!email) return null;
+  if (email.toLowerCase() === "b" || email.toLowerCase() === "browser") {
+    const browserEmail = await browserLogin();
+    if (!browserEmail) return null;
     console.log();
-    console.log(import_chalk5.default.yellow("  No email given, so the AI planner cannot be reached."));
-    console.log(import_chalk5.default.dim("  Nothing has been recorded. Run qp again when you are ready."));
-    console.log(import_chalk5.default.dim("  To record with no account at all, use the MCP server:"));
-    console.log(import_chalk5.default.dim("    https://quickpeek.co/mcp"));
+    console.log(import_chalk5.default.green(`  \u2713 Signed in as ${browserEmail}`));
     console.log();
-    process.exit(1);
+    return browserEmail;
   }
   if (!email.includes("@") || !email.includes(".")) {
     console.log();
     console.log(import_chalk5.default.yellow("  \u26A0 That doesn't look like a valid email address."));
     const proceed = await prompt(import_chalk5.default.white("  Continue anyway? ") + import_chalk5.default.dim("[y/N] "));
-    if (proceed.toLowerCase() !== "y") {
-      console.log();
-      console.log(import_chalk5.default.dim("  Nothing has been recorded. Run qp again when you are ready."));
-      console.log();
-      process.exit(1);
-    }
+    if (proceed.toLowerCase() !== "y") return null;
   }
   console.log();
   console.log(import_chalk5.default.green("  \u2713 Email registered"));
@@ -10548,10 +10574,11 @@ async function handleRegistrationGate() {
   console.log(import_chalk15.default.dim("    \u2022 10 videos a day instead of 5 in total"));
   console.log(import_chalk15.default.dim("    \u2022 Keep your video history"));
   console.log(import_chalk15.default.dim("    \u2022 Upgrade to Pro anytime"));
-  let email = await browserLogin();
-  if (!email) {
-    console.log();
-    email = await promptInput("Email: ");
+  console.log();
+  console.log(import_chalk15.default.dim("  Type your email, or 'b' to sign in through a browser."));
+  let email = await promptInput("Email: ");
+  if (email.toLowerCase() === "b" || email.toLowerCase() === "browser") {
+    email = await browserLogin() ?? "";
   }
   if (!email || !email.includes("@")) {
     console.log(import_chalk15.default.red("  Invalid email. Run qp again to try again."));
@@ -10626,7 +10653,7 @@ async function runAuthPhase(input) {
       console.log();
       const input2 = await promptInput(`New email or Enter to retry (${userEmail}): `);
       if (input2.toLowerCase() === "exit") {
-        gracefulExit();
+        gracefulExit(1);
         return null;
       }
       if (input2?.includes("@")) {
@@ -10635,7 +10662,7 @@ async function runAuthPhase(input) {
         const result = await registerFreeUser(newEmail);
         if (!result.success) {
           registerTask.fail(result.error || "Registration failed");
-          gracefulExit();
+          gracefulExit(1);
           return null;
         }
         if (result.alreadyVerified) {
@@ -10650,7 +10677,7 @@ async function runAuthPhase(input) {
           console.log(import_chalk16.default.cyan(`  \u{1F4E7} Verification sent to: ${newEmail}`));
           console.log(import_chalk16.default.dim("  Click the link in the email, then run qp again."));
           console.log();
-          gracefulExit();
+          gracefulExit(1);
           return null;
         }
       } else {
@@ -10666,7 +10693,7 @@ async function runAuthPhase(input) {
           console.log();
           console.log(import_chalk16.default.cyan(`  Register/upgrade at: ${getUpgradeUrl(userEmail)}`));
           console.log();
-          gracefulExit();
+          gracefulExit(1);
           return null;
         }
       }
@@ -10674,7 +10701,7 @@ async function runAuthPhase(input) {
   } else if (localVideoCount >= FREE_VIDEO_LIMIT) {
     const registration = await handleRegistrationGate();
     if (!registration) {
-      gracefulExit();
+      gracefulExit(1);
       return null;
     }
     userEmail = registration.email;
@@ -10684,7 +10711,7 @@ async function runAuthPhase(input) {
       localVideoCount
     });
     if (!registration.verified) {
-      gracefulExit();
+      gracefulExit(1);
       return null;
     }
     await displayUsageStatus(userEmail, userTier, localVideoCount);
@@ -10693,7 +10720,16 @@ async function runAuthPhase(input) {
     console.log();
     console.log(import_chalk16.default.cyan(`  \u{1F3AC} Video ${localVideoCount + 1}/${FREE_VIDEO_LIMIT} free`));
     console.log(import_chalk16.default.dim(`     ${remaining2 - 1} more after this \u2022 Sign up for 10 a day`));
-    userEmail = await setupUserEmail();
+    const enteredEmail = await setupUserEmail();
+    if (!enteredEmail) {
+      console.log();
+      console.log(import_chalk16.default.yellow("  No email, so no video was recorded."));
+      console.log(import_chalk16.default.white("  Next: run `qp login` to sign in, then run qp again."));
+      console.log();
+      gracefulExit(1);
+      return null;
+    }
+    userEmail = enteredEmail;
     let registeredVerified = false;
     try {
       const reg = await registerFreeUser(userEmail);

package/dist/{voices-ufga0oOn.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.5";
+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). */
@@ -280,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. */
@@ -338,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;
@@ -357,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
  */
@@ -644,4 +686,4 @@ declare function hasVoice(lang: string): boolean;
  */
 declare function voiceFor(lang: string, gender?: VoiceGender): string | null;
 
-export { getStatus 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, callAIViaRelay as O, PLAN_MAX_TOKENS as P, crawlPage as Q, RATE_FACTOR as R, SERVER_BACKOFF_MS as S, type Tier as T, type UserTier as U, type VoiceRate as V, deStock as W, defaultCaptionsFor as X, getErrorMessage as Y, getLanguageName as Z, getOrRefreshRelayToken as _, type CaptionPosition as a, getStatusCached as a0, getTierByEmail as a1, gotoSettled as a2, hasTrialRemaining as a3, hasVoice as a4, idSelector as a5, internationalVoiceFor as a6, isCanceling as a7, isExcludedLink as a8, isPaid as a9, isVerified as aa, normalizeUrl as ab, parseAIPlanResponse as ac, parsePartial as ad, pricingUrl as ae, rgbaToHex as af, runPooled as ag, shouldSkipLink as ah, showPaywall as ai, stripLongDashes as aj, toTitleCase as ak, voiceFor as al, waitForPlaceholdersGone as am, getTier as an, 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 };
+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-ufga0oOn.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, Q as crawlPage, W as deStock, Y as getErrorMessage, Z as getLanguageName, $ as getStatus, a0 as getStatusCached, an as getTier, a1 as getTierByEmail, a3 as hasTrialRemaining, a4 as hasVoice, a6 as internationalVoiceFor, a7 as isCanceling, a8 as isExcludedLink, a9 as isPaid, aa as isVerified, ab as normalizeUrl, ac as parseAIPlanResponse, ad as parsePartial, ae as pricingUrl, af as rgbaToHex, ag as runPooled, ah as shouldSkipLink, ai as showPaywall, aj as stripLongDashes, ak as toTitleCase, al as voiceFor } from './voices-ufga0oOn.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';