@spark-apps/quickpeek 1.2.0 → 1.2.1

package/dist/mcp-tools.mjs

@@ -43,7 +43,7 @@ function getErrorMessage(err) {
   return err instanceof Error ? err.message : String(err);
 }
 function toTitleCase(text) {
-  return text.replace(/\w+/g, (word, index) => {
+  return text.replace(/\w+(?:'\w+)*/g, (word, index) => {
     if (index === 0) {
       return word.charAt(0).toUpperCase() + word.slice(1).toLowerCase();
     }
@@ -107,6 +107,9 @@ var init_utils = __esm({
 });
 
 // src/lib/api-client.ts
+function apiKey() {
+  return process.env.SPARK_AI_KEY || "";
+}
 async function getOrRefreshDirectToken() {
   const now = Date.now();
   if (cachedDirectToken && cachedDirectToken.expiresAt > now + 3e5) {
@@ -115,7 +118,7 @@ async function getOrRefreshDirectToken() {
   try {
     const response = await fetch(SPARK_AI_TOKEN, {
       method: "POST",
-      headers: { "X-Api-Key": API_KEY }
+      headers: { "X-Api-Key": apiKey() }
     });
     if (!response.ok) {
       throw new Error(`Token exchange failed: ${response.status} ${response.statusText}`);
@@ -226,7 +229,7 @@ async function executeChat(chatUrl, bearerToken, systemPrompt, userPrompt, tier)
   return lastRateLimitError || { success: false, error: "Request failed after retries" };
 }
 async function callAI(systemPrompt, userPrompt, tier = "free") {
-  if (!API_KEY) {
+  if (!apiKey()) {
     return {
       success: false,
       error: "AI service is not configured. Please report this issue.",
@@ -286,7 +289,7 @@ function normalizeUrl(input) {
   url = url.replace(/^(https?:\/\/)?(www\.)?/i, "");
   return `https://${url}`;
 }
-var SPARK_AI_BASE, SPARK_AI_CHAT, SPARK_AI_TOKEN, RELAY_BASE, RELAY_TOKEN_URL, RELAY_CHAT_URL, API_KEY, cachedDirectToken, cachedRelayToken;
+var SPARK_AI_BASE, SPARK_AI_CHAT, SPARK_AI_TOKEN, RELAY_BASE, RELAY_TOKEN_URL, RELAY_CHAT_URL, cachedDirectToken, cachedRelayToken;
 var init_api_client = __esm({
   "src/lib/api-client.ts"() {
     "use strict";
@@ -297,7 +300,6 @@ var init_api_client = __esm({
     RELAY_BASE = process.env.QUICKPEEK_API_BASE || "https://quickpeek.co";
     RELAY_TOKEN_URL = `${RELAY_BASE}/api/cli/token`;
     RELAY_CHAT_URL = `${RELAY_BASE}/api/cli/ai`;
-    API_KEY = process.env.SPARK_AI_KEY || "";
     cachedDirectToken = null;
     cachedRelayToken = null;
   }
@@ -401,7 +403,7 @@ var VERSION, CONFIG_FILE, DEFAULT_CONFIG, DEFAULT_CAPTIONS;
 var init_config = __esm({
   "src/lib/config.ts"() {
     "use strict";
-    VERSION = "1.1.1";
+    VERSION = "1.2.1";
     CONFIG_FILE = "quickpeek.config.json";
     DEFAULT_CONFIG = {
       plan: { maxSteps: 8 },
@@ -551,7 +553,7 @@ var init_scraping = __esm({
 });
 
 // src/lib/crawl.ts
-import { chromium } from "playwright";
+import { chromium as chromium2 } from "playwright";
 function getActionForType(type) {
   switch (type) {
     case "button":
@@ -569,20 +571,29 @@ function getActionForType(type) {
       return "type";
   }
 }
-async function crawlPage(url, task2 = noopTask, storageStatePath) {
-  const cached = crawlCache.get(url);
+async function crawlPage(url, task2 = noopTask, storageStatePath, viewport) {
+  const cacheKey = viewport ? `${url}@${viewport.width}x${viewport.height}` : url;
+  const cached = crawlCache.get(cacheKey);
   if (cached && Date.now() - cached.timestamp < CRAWL_CACHE_TTL_MS) {
     task2("Using cached crawl").succeed(`Found ${cached.elements.length} interactive elements (cached)`);
-    return { title: cached.title, elements: [...cached.elements] };
+    return { title: cached.title, elements: [...cached.elements], scrollable: cached.scrollable };
   }
   const browserTask = task2("Launching browser");
-  const browser = await chromium.launch({ headless: true });
-  const context = await browser.newContext(storageStatePath ? { storageState: storageStatePath } : {});
+  const browser = await chromium2.launch({ headless: true });
+  const context = await browser.newContext({
+    ...storageStatePath ? { storageState: storageStatePath } : {},
+    // Crawl at the size we will record at, or the measurements below describe
+    // a page nobody will ever see.
+    ...viewport ? { viewport } : {}
+  });
   const page = await context.newPage();
   browserTask.succeed(storageStatePath ? "Browser launched (signed in)" : "Browser launched");
   const crawlTask = task2("Crawling page");
   await page.goto(url, { waitUntil: "networkidle", timeout: 3e4 });
   const title = await page.title();
+  const scrollable = await page.evaluate(
+    "Math.max(0, document.documentElement.scrollHeight - window.innerHeight)"
+  );
   const rawElements = await page.evaluate(`
     (() => {
       const items = [];
@@ -712,12 +723,12 @@ async function crawlPage(url, task2 = noopTask, storageStatePath) {
   });
   await browser.close();
   crawlTask.succeed(`Found ${elements.length} interactive elements`);
-  crawlCache.set(url, { timestamp: Date.now(), title, elements: [...elements] });
+  crawlCache.set(cacheKey, { timestamp: Date.now(), title, elements: [...elements], scrollable });
   if (crawlCache.size > CRAWL_CACHE_MAX_ENTRIES) {
     const oldest = crawlCache.keys().next().value;
     if (oldest !== void 0) crawlCache.delete(oldest);
   }
-  return { title, elements };
+  return { title, elements, scrollable };
 }
 var noopTask, CRAWL_CACHE_TTL_MS, CRAWL_CACHE_MAX_ENTRIES, crawlCache;
 var init_crawl = __esm({
@@ -1289,7 +1300,7 @@ EXAMPLES:
 \u2022 File upload: "target": "input[type=\\"file\\"]"
 \u2022 Slider: "target": "input[type=\\"range\\"]"`;
 }
-function buildUserPrompt(url, title, elements, langName, description, maxSteps) {
+function buildUserPrompt(url, title, elements, langName, description, maxSteps, scrollable) {
   const lang = langName ? `
 Language: Write ALL captions in ${langName}.` : "";
   const purpose = description ? `
@@ -1327,8 +1338,13 @@ ${selectables.map((e) => `\u2022 "${e.text}" \u2192 ${e.selector}`).join("\n")}`
 ${checkables.map((e) => `\u2022 "${e.text}" \u2192 ${e.selector}`).join("\n")}`);
   }
   const elementSummary = elementDict.length > 0 ? elementDict.join("\n\n") : "(no interactive elements found)";
+  const cannotScroll = scrollable !== void 0 && scrollable < MIN_USEFUL_SCROLL_PX;
+  const scrolling = cannotScroll ? `
+
+SCROLLING: this page has only ${scrollable}px of scroll travel at the recording size, so it does not scroll.` : "";
+  const scrollRule = cannotScroll ? "\n\u2022 NEVER use the scroll action: this page does not scroll, so the video would freeze. Use wait and click steps only" : "";
   return `URL: ${url}
-Title: ${title}${purpose}
+Title: ${title}${purpose}${scrolling}
 
 AVAILABLE ELEMENTS (grouped by action):
 ${elementSummary}
@@ -1338,7 +1354,7 @@ REQUIREMENTS:
 \u2022 Complete ONE user journey: input \u2192 process \u2192 output
 \u2022 For CLICK: use simplified text target like "extract frame" or "download"
 \u2022 For UPLOAD/DRAG/TYPE: use the CSS selector shown above
-\u2022 For buttons that appear after actions: use partial text like "extract" or "download"${lang}
+\u2022 For buttons that appear after actions: use partial text like "extract" or "download"${scrollRule}${lang}
 
 Return JSON:
 {
@@ -1361,10 +1377,12 @@ TARGET SYNTAX:
 \u2022 Sliders: input[type="range"]
 \u2022 Text inputs: Use selector from list above`;
 }
+var MIN_USEFUL_SCROLL_PX;
 var init_prompts = __esm({
   "src/lib/prompts.ts"() {
     "use strict";
     init_utils();
+    MIN_USEFUL_SCROLL_PX = 200;
   }
 });
 
@@ -2246,10 +2264,13 @@ function fileResult(output, data, poster) {
 }
 
 // src/mcp/tools.ts
-import { readdirSync as readdirSync4, statSync as statSync2 } from "fs";
-import { join as join22 } from "path";
+import { readdirSync as readdirSync5, readFileSync as readFileSync6, statSync as statSync2 } from "fs";
+import { join as join23 } from "path";
 import { WIDE_VOICES as WIDE_VOICES2 } from "@spark-apps/video-kit";
 
+// src/browser/auth-session.ts
+import { chromium } from "playwright";
+
 // src/browser/auth-state.ts
 import { existsSync as existsSync2 } from "fs";
 import { chmod, mkdir, readdir, unlink, writeFile } from "fs/promises";
@@ -2271,12 +2292,52 @@ function findAuthState(url) {
   const path = authStatePath(url);
   return path && existsSync2(path) ? path : void 0;
 }
+async function saveAuthState(url, state) {
+  const path = authStatePath(url);
+  if (!path) throw new Error(`Not a valid URL: ${url}`);
+  await mkdir(AUTH_DIR, { recursive: true });
+  await writeFile(path, JSON.stringify(state, null, 2));
+  await chmod(path, 384);
+  return path;
+}
+
+// src/browser/auth-session.ts
+var pending = null;
+function pendingSignIn() {
+  return pending?.url ?? null;
+}
+async function openSignIn(url) {
+  await cancelSignIn();
+  const browser = await chromium.launch({ headless: false });
+  const context = await browser.newContext();
+  const page = await context.newPage();
+  pending = { browser, context, url };
+  try {
+    await page.goto(url, { waitUntil: "domcontentloaded", timeout: 3e4 });
+  } catch {
+  }
+}
+async function saveSignIn() {
+  if (!pending) throw new Error("No sign-in window is open. Call start_auth first.");
+  const { context, url } = pending;
+  try {
+    const path = await saveAuthState(url, await context.storageState());
+    return { host: new URL(url).host, path };
+  } finally {
+    await cancelSignIn();
+  }
+}
+async function cancelSignIn() {
+  const open = pending;
+  pending = null;
+  await open?.browser.close().catch(() => {
+  });
+}
 
-// src/commands/record-cmd.ts
-import { existsSync as existsSync17 } from "fs";
-import { mkdir as mkdir8 } from "fs/promises";
-import { isAbsolute as isAbsolute5, join as join20, resolve as resolve9 } from "path";
-import chalk14 from "chalk";
+// src/commands/edit-cmd.ts
+import { existsSync as existsSync7, readdirSync, readFileSync as readFileSync3 } from "fs";
+import { join as join10 } from "path";
+import chalk7 from "chalk";
 
 // src/help.ts
 init_lib();
@@ -2341,66 +2402,123 @@ function formatUsageLines(status, tier) {
   return lines;
 }
 
-// src/commands/record-cmd.ts
-init_lib();
-init_config_loader();
+// src/lib/browser-open.ts
+import { exec as exec2 } from "child_process";
+function editorBaseUrl() {
+  return (process.env.QUICKPEEK_API_BASE || "https://quickpeek.co").replace(/\/$/, "");
+}
+function openInBrowser(url) {
+  const isWSL2 = process.platform === "linux" && Boolean(process.env.WSL_DISTRO_NAME);
+  const command = isWSL2 ? `cmd.exe /c start "" "${url}"` : process.platform === "darwin" ? `open "${url}"` : `xdg-open "${url}"`;
+  return new Promise((resolve10) => {
+    exec2(command, () => resolve10());
+  });
+}
 
-// src/utils/logging.ts
-import { appendFile, writeFile as writeFile5 } from "fs/promises";
-import { join as join8 } from "path";
-var LOG_FILE_NAME = "quickpeek.log";
-var logFileInitialized = false;
-var logFilePath = LOG_FILE_NAME;
-async function writeLogEntry(entry) {
-  try {
-    if (!logFileInitialized) {
-      await writeFile5(logFilePath, entry);
-      logFileInitialized = true;
-    } else {
-      await appendFile(logFilePath, entry);
+// src/lib/plan-validation.ts
+var INVALID_TARGETS = [
+  /\.png$/i,
+  /\.jpg$/i,
+  /\.gif$/i,
+  /\.webp$/i,
+  /\.svg$/i,
+  /sprite_sheet/i,
+  /downloaded/i
+];
+var ACTIONS_REQUIRING_TARGET = ["click", "type", "select", "check", "drag"];
+function isFilePath(value) {
+  if (!value) return false;
+  return /\.\w{2,5}$/.test(value) && (/[/\\]/.test(value) || /^[a-zA-Z]:/.test(value));
+}
+function isInvalidTarget(target) {
+  return INVALID_TARGETS.some((pattern) => pattern.test(target));
+}
+function validateStep(step) {
+  if (!step?.action) {
+    return "Missing action";
+  }
+  if (step.action === "navigate") {
+    if (!step.target) return "Navigate requires a URL target";
+    if (!step.target.startsWith("http://") && !step.target.startsWith("https://")) {
+      return "Navigate target must be a valid URL";
     }
-  } catch {
   }
+  if (step.action === "media") {
+    if (!step.mediaFile && !isFilePath(step.value)) {
+      return "Media step requires a file (image or video)";
+    }
+  }
+  if (step.action === "upload") {
+    if (!step.mediaFile && !isFilePath(step.value)) {
+      return "Upload step requires a file";
+    }
+  }
+  if (ACTIONS_REQUIRING_TARGET.includes(step.action)) {
+    if (!step.target) return `${step.action} requires a target`;
+    if (isInvalidTarget(step.target)) return `Invalid target pattern: ${step.target}`;
+  }
+  return null;
 }
-async function setLogFilePath(outputDir) {
-  logFilePath = join8(outputDir, LOG_FILE_NAME);
-  const header2 = `QuickPeek Log - ${(/* @__PURE__ */ new Date()).toISOString()}
-${"=".repeat(60)}
 
+// src/lib/plan-file.ts
+var MAX_HANDOFF_URL_CHARS = 32e3;
+function serializePlan(plan) {
+  return `${JSON.stringify(plan, null, 2)}
 `;
+}
+function parsePlanText(text) {
+  let raw;
   try {
-    await writeFile5(logFilePath, header2);
-    logFileInitialized = true;
-  } catch {
+    raw = JSON.parse(text);
+  } catch (e) {
+    return { ok: false, error: `Not valid JSON: ${e instanceof Error ? e.message : String(e)}` };
   }
+  if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
+    return { ok: false, error: "A plan must be a JSON object." };
+  }
+  const candidate = raw;
+  if (typeof candidate.url !== "string" || !candidate.url.trim()) {
+    return { ok: false, error: "A plan needs a `url` to record." };
+  }
+  if (!Array.isArray(candidate.steps) || candidate.steps.length === 0) {
+    return { ok: false, error: "A plan needs at least one step." };
+  }
+  const steps = [];
+  for (const [index, step] of candidate.steps.entries()) {
+    if (!step || typeof step !== "object" || Array.isArray(step)) {
+      return { ok: false, error: `Step ${index + 1} is not an object.` };
+    }
+    const typed = step;
+    if (typeof typed.action !== "string" || !typed.action.trim()) {
+      return { ok: false, error: `Step ${index + 1} has no action.` };
+    }
+    const failure = validateStep(typed);
+    if (failure) return { ok: false, error: `Step ${index + 1}: ${failure}` };
+    steps.push({ ...typed, id: typed.id ?? index + 1 });
+  }
+  return {
+    ok: true,
+    plan: {
+      url: candidate.url,
+      title: candidate.title ?? "",
+      description: candidate.description ?? "",
+      ...candidate.lang ? { lang: candidate.lang } : {},
+      steps
+    }
+  };
 }
-async function logInfo(context, message) {
-  await writeLogEntry(`[${(/* @__PURE__ */ new Date()).toISOString()}] [INFO] [${context}] ${message}
-`);
-}
-async function logDebug(context, message) {
-  await writeLogEntry(`[${(/* @__PURE__ */ new Date()).toISOString()}] [DEBUG] [${context}] ${message}
-`);
+function toBase64Url(text) {
+  const bytes = new TextEncoder().encode(text);
+  const binary = Array.from(bytes, (b) => String.fromCharCode(b)).join("");
+  const base64 = typeof btoa === "function" ? btoa(binary) : Buffer.from(text, "utf8").toString("base64");
+  return base64.replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
 }
-async function logError(context, error) {
-  let errorMsg;
-  if (error instanceof Error) {
-    errorMsg = `${error.message}
-${error.stack}`;
-  } else if (typeof error === "object" && error !== null) {
-    errorMsg = JSON.stringify(error, null, 2);
-  } else {
-    errorMsg = String(error);
-  }
-  await writeLogEntry(`[${(/* @__PURE__ */ new Date()).toISOString()}] [ERROR] [${context}]
-${errorMsg}
-
-`);
+function encodePlan(plan) {
+  return toBase64Url(serializePlan(plan));
 }
-async function logStep(stepNum, action, details) {
-  const detailsStr = Object.entries(details).map(([k, v]) => `${k}=${JSON.stringify(v)}`).join(", ");
-  await writeLogEntry(`[${(/* @__PURE__ */ new Date()).toISOString()}] [STEP ${stepNum}] ${action} | ${detailsStr}
-`);
+function planEditorUrl(baseUrl, plan) {
+  const url = `${baseUrl.replace(/\/$/, "")}/edit#plan=${encodePlan(plan)}`;
+  return url.length <= MAX_HANDOFF_URL_CHARS ? url : null;
 }
 
 // src/utils/ui.ts
@@ -2446,7 +2564,7 @@ function promptInput(prompt2) {
 var _isWSL = process.platform === "linux" && process.env.WSL_DISTRO_NAME;
 function formatClickablePath(filePath) {
   const absolutePath = resolve4(filePath);
-  if (_isWSL) {
+  if (_isWSL || process.platform !== "win32") {
     return absolutePath;
   }
   let formatted = absolutePath;
@@ -2462,15 +2580,15 @@ function formatDuration(ms) {
   return `${mins}:${secs.toString().padStart(2, "0")}`;
 }
 
-// src/commands/phases/auth-phase.ts
+// src/commands/utils/record-helpers.ts
+import chalk6 from "chalk";
 init_lib();
-import chalk8 from "chalk";
 
 // src/plan.ts
-import { mkdir as mkdir5, readFile as readFile3, writeFile as writeFile6 } from "fs/promises";
-import { join as join9 } from "path";
+import { mkdir as mkdir5, readFile as readFile3, writeFile as writeFile5 } from "fs/promises";
+import { join as join8 } from "path";
 import chalk5 from "chalk";
-import { chromium as chromium4 } from "playwright";
+import { chromium as chromium5 } from "playwright";
 
 // src/ai/client.ts
 init_lib();
@@ -2478,19 +2596,11 @@ import { createInterface as createInterface2 } from "readline";
 import chalk4 from "chalk";
 
 // src/utils/browser-auth.ts
-init_SparkStripe_feature_gating();
 import { createServer } from "http";
 import { URL as URL2 } from "url";
 import chalk3 from "chalk";
+init_SparkStripe_feature_gating();
 var TIMEOUT_MS = 12e4;
-async function openBrowser(url) {
-  const { exec: exec2 } = await import("child_process");
-  const isWSL2 = process.platform === "linux" && Boolean(process.env.WSL_DISTRO_NAME);
-  const command = isWSL2 ? `cmd.exe /c start "" "${url}"` : process.platform === "darwin" ? `open "${url}"` : `xdg-open "${url}"`;
-  return new Promise((resolve10) => {
-    exec2(command, () => resolve10());
-  });
-}
 async function browserLogin() {
   return new Promise((resolve10) => {
     let server;
@@ -2544,7 +2654,7 @@ async function browserLogin() {
       console.log(chalk3.dim(`  ${url}`));
       console.log();
       console.log(chalk3.dim("  Waiting for sign-in (press Ctrl+C to cancel)..."));
-      openBrowser(url);
+      void openInBrowser(url);
     });
     timer = setTimeout(() => {
       console.log();
@@ -2646,13 +2756,13 @@ async function callGroq(systemPrompt, userPrompt, logError2, userEmail, tier = "
 
 // src/browser/launch.ts
 import { mkdir as mkdir4 } from "fs/promises";
-import { chromium as chromium3 } from "playwright";
+import { chromium as chromium4 } from "playwright";
 
 // src/browser/wsl.ts
 import { execSync, spawn as spawn2 } from "child_process";
 import { existsSync as existsSync6, readFileSync as readFileSync2 } from "fs";
 import { request } from "http";
-import { chromium as chromium2 } from "playwright";
+import { chromium as chromium3 } from "playwright";
 function isWSL() {
   if (process.platform !== "linux") return false;
   try {
@@ -2771,7 +2881,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 chromium2.connectOverCDP(`http://${windowsHost}:${proxyPort}`, { timeout: 5e3 });
+    const browser = await chromium3.connectOverCDP(`http://${windowsHost}:${proxyPort}`, { timeout: 5e3 });
     return {
       browser,
       cleanup: async () => {
@@ -2812,7 +2922,7 @@ async function launchBrowserContext(config, userDataDir, recordVideo, storageSta
         const contexts = chromeSession.browser.contexts();
         context = contexts[0] || await chromeSession.browser.newContext({ viewport, ...videoOpts, acceptDownloads: true });
       } catch {
-        context = await chromium3.launchPersistentContext(userDataDir, {
+        context = await chromium4.launchPersistentContext(userDataDir, {
           headless: false,
           args: persistentArgs,
           viewport,
@@ -2821,7 +2931,7 @@ async function launchBrowserContext(config, userDataDir, recordVideo, storageSta
         });
       }
     } else {
-      context = await chromium3.launchPersistentContext(userDataDir, {
+      context = await chromium4.launchPersistentContext(userDataDir, {
         headless: false,
         args: persistentArgs,
         viewport,
@@ -2830,7 +2940,7 @@ async function launchBrowserContext(config, userDataDir, recordVideo, storageSta
       });
     }
   } else {
-    browser = await chromium3.launch({ headless: true });
+    browser = await chromium4.launch({ headless: true });
     context = await browser.newContext({ viewport, ...videoOpts, ...authOpts, acceptDownloads: true });
   }
   return { context, browser, chromeSession };
@@ -2848,12 +2958,12 @@ async function cleanupBrowserSession(session) {
 init_lib();
 async function crawlExtension(url, extensionPath, workDir, task2) {
   const browserTask = task2("Launching browser with extension");
-  const userDataDir = join9(workDir, ".browser-data");
+  const userDataDir = join8(workDir, ".browser-data");
   await mkdir5(userDataDir, { recursive: true });
   let context;
   let chromeSession = null;
   const useWindowsChrome = isWSL() && tryEnableWSLInterop();
-  const launchPersistent = () => chromium4.launchPersistentContext(userDataDir, {
+  const launchPersistent = () => chromium5.launchPersistentContext(userDataDir, {
     headless: false,
     args: [
       `--disable-extensions-except=${extensionPath}`,
@@ -2972,12 +3082,12 @@ async function parsePlanJson(content, task2, logError2, userEmail, tier = "free"
     }
   }
 }
-async function crawlAndAnalyze(url, lang, description, maxSteps, task2, logError2, userEmail, extensionPath, workDir, tier = "free") {
-  const { title, elements } = extensionPath && workDir ? await crawlExtension(url, extensionPath, workDir, task2) : await crawlPage(url, task2, findAuthState(url));
+async function crawlAndAnalyze(url, lang, description, maxSteps, task2, logError2, userEmail, extensionPath, workDir, tier = "free", viewport) {
+  const { title, elements, scrollable } = extensionPath && workDir ? { ...await crawlExtension(url, extensionPath, workDir, task2), scrollable: void 0 } : await crawlPage(url, task2, findAuthState(url), viewport);
   const aiTask = task2("Generating plan with AI");
   const langName = getLanguageName(lang);
   const systemPrompt = buildSystemPrompt(maxSteps);
-  const userPrompt = buildUserPrompt(url, title, elements, langName, description, maxSteps);
+  const userPrompt = buildUserPrompt(url, title, elements, langName, description, maxSteps, scrollable);
   try {
     const content = await callGroq(systemPrompt, userPrompt, logError2, userEmail, tier);
     const jsonMatch = content.match(/\{[\s\S]*\}/);
@@ -3006,7 +3116,7 @@ async function validateAndFixPlan(planPath, task2, logError2, userEmail, tier =
   }
   const renumberTask = task2("Validating plan structure");
   const originalCount = plan.steps.length;
-  const INVALID_TARGETS = [/\.png$/i, /\.jpg$/i, /\.gif$/i, /\.webp$/i, /\.svg$/i, /sprite_sheet/i, /downloaded/i];
+  const INVALID_TARGETS2 = [/\.png$/i, /\.jpg$/i, /\.gif$/i, /\.webp$/i, /\.svg$/i, /sprite_sheet/i, /downloaded/i];
   const isValidStep = (s) => {
     if (!s?.action) return false;
     if (s.action === "navigate") {
@@ -3015,7 +3125,7 @@ async function validateAndFixPlan(planPath, task2, logError2, userEmail, tier =
     }
     if (["click", "type", "select", "check", "upload", "drag"].includes(s.action)) {
       if (!s.target) return false;
-      if (INVALID_TARGETS.some((pattern) => pattern.test(s.target))) return false;
+      if (INVALID_TARGETS2.some((pattern) => pattern.test(s.target))) return false;
     }
     if (s.action === "upload") {
       if (!s.target?.includes("file") && !s.target?.includes("input")) return false;
@@ -3032,7 +3142,7 @@ async function validateAndFixPlan(planPath, task2, logError2, userEmail, tier =
     renumberTask.fail("No valid steps");
     throw new Error("Plan has no valid steps");
   }
-  await writeFile6(planPath, JSON.stringify(plan, null, 2));
+  await writeFile5(planPath, JSON.stringify(plan, null, 2));
   const removed = originalCount - plan.steps.length;
   renumberTask.succeed(
     removed > 0 ? `${plan.steps.length} steps (${removed} removed)` : `${plan.steps.length} steps validated`
@@ -3040,67 +3150,68 @@ async function validateAndFixPlan(planPath, task2, logError2, userEmail, tier =
   return plan;
 }
 
-// src/commands/phases/auth-phase.ts
+// src/commands/utils/record-helpers.ts
 init_config_loader();
 
-// src/commands/utils/auth-helpers.ts
-init_lib();
-import chalk6 from "chalk";
-async function handleRegistrationGate() {
-  console.log();
-  console.log(chalk6.yellow("  \u{1F389} You've made 5 free videos!"));
-  console.log(chalk6.white("     Sign in to continue creating videos."));
-  console.log();
-  console.log(chalk6.dim("  Benefits of signing in:"));
-  console.log(chalk6.dim("    \u2022 20 more videos per month"));
-  console.log(chalk6.dim("    \u2022 Keep your video history"));
-  console.log(chalk6.dim("    \u2022 Upgrade to Pro anytime"));
-  let email = await browserLogin();
-  if (!email) {
-    console.log();
-    email = await promptInput("Email: ");
-  }
-  if (!email || !email.includes("@")) {
-    console.log(chalk6.red("  Invalid email. Run qp again to try again."));
-    return null;
-  }
-  const registerTask = task("Sending verification email");
-  const result = await registerFreeUser(email);
-  if (!result.success) {
-    registerTask.fail(result.error || "Registration failed");
-    return null;
+// src/utils/logging.ts
+import { appendFile, writeFile as writeFile6 } from "fs/promises";
+import { join as join9 } from "path";
+var LOG_FILE_NAME = "quickpeek.log";
+var logFileInitialized = false;
+var logFilePath = LOG_FILE_NAME;
+async function writeLogEntry(entry) {
+  try {
+    if (!logFileInitialized) {
+      await writeFile6(logFilePath, entry);
+      logFileInitialized = true;
+    } else {
+      await appendFile(logFilePath, entry);
+    }
+  } catch {
   }
-  if (result.alreadyVerified) {
-    registerTask.succeed("Already verified!");
-    return { email, verified: true };
+}
+async function setLogFilePath(outputDir) {
+  logFilePath = join9(outputDir, LOG_FILE_NAME);
+  const header2 = `QuickPeek Log - ${(/* @__PURE__ */ new Date()).toISOString()}
+${"=".repeat(60)}
+
+`;
+  try {
+    await writeFile6(logFilePath, header2);
+    logFileInitialized = true;
+  } catch {
   }
-  registerTask.succeed("Check your email!");
-  console.log();
-  console.log(chalk6.cyan("  \u{1F4E7} Verification email sent to:"));
-  console.log(chalk6.white(`     ${email}`));
-  console.log();
-  console.log(chalk6.dim("  Click the link in the email, then press Enter to continue..."));
-  await promptInput("");
-  const verifyTask = task("Checking verification");
-  const verified = await isVerified(email);
-  if (verified) {
-    verifyTask.succeed("Email verified!");
-    return { email, verified: true };
+}
+async function logInfo(context, message) {
+  await writeLogEntry(`[${(/* @__PURE__ */ new Date()).toISOString()}] [INFO] [${context}] ${message}
+`);
+}
+async function logDebug(context, message) {
+  await writeLogEntry(`[${(/* @__PURE__ */ new Date()).toISOString()}] [DEBUG] [${context}] ${message}
+`);
+}
+async function logError(context, error) {
+  let errorMsg;
+  if (error instanceof Error) {
+    errorMsg = `${error.message}
+${error.stack}`;
+  } else if (typeof error === "object" && error !== null) {
+    errorMsg = JSON.stringify(error, null, 2);
+  } else {
+    errorMsg = String(error);
   }
-  verifyTask.fail("Not verified yet");
-  console.log();
-  console.log(chalk6.yellow("  Email not verified. Check your inbox and spam folder."));
-  console.log(chalk6.dim("  Run qp again after clicking the verification link."));
-  console.log();
-  console.log(chalk6.cyan(`  Or register/upgrade at: ${getUpgradeUrl(email)}`));
-  console.log();
-  return { email, verified: false };
+  await writeLogEntry(`[${(/* @__PURE__ */ new Date()).toISOString()}] [ERROR] [${context}]
+${errorMsg}
+
+`);
+}
+async function logStep(stepNum, action, details) {
+  const detailsStr = Object.entries(details).map(([k, v]) => `${k}=${JSON.stringify(v)}`).join(", ");
+  await writeLogEntry(`[${(/* @__PURE__ */ new Date()).toISOString()}] [STEP ${stepNum}] ${action} | ${detailsStr}
+`);
 }
 
 // src/commands/utils/record-helpers.ts
-import chalk7 from "chalk";
-init_lib();
-init_config_loader();
 init_utils();
 var FREE_VIDEO_LIMIT = 5;
 var INDENT2 = "   ";
@@ -3124,41 +3235,41 @@ function displayRateLimitInfo() {
   const percentage = Math.round(limits.used / limits.limit * 100);
   if (percentage >= 90) {
     console.log();
-    console.log(chalk7.yellow(`  \u26A0 ${remaining} requests remaining (${limits.tier} tier)`));
+    console.log(chalk6.yellow(`  \u26A0 ${remaining} requests remaining (${limits.tier} tier)`));
     if (limits.tier === "free") {
-      console.log(chalk7.dim(`    Upgrade: ${getUpgradeUrl()}`));
+      console.log(chalk6.dim(`    Upgrade: ${getUpgradeUrl()}`));
     }
   } else if (percentage >= 50) {
-    console.log(chalk7.dim(`  ${remaining}/${limits.limit} requests remaining`));
+    console.log(chalk6.dim(`  ${remaining}/${limits.limit} requests remaining`));
   }
 }
 async function displayUsageStatus(userEmail, userTier, _localVideoCount = 0) {
   const tier = userTier === "pro" ? "pro" : "free";
-  const tierLabel = tier === "pro" ? chalk7.green("Pro") : "Free";
-  console.log(chalk7.cyan(`    \u2714 ${tierLabel} plan`));
-  console.log(chalk7.dim(`      ${userEmail}`));
+  const tierLabel = tier === "pro" ? chalk6.green("Pro") : "Free";
+  console.log(chalk6.cyan(`    \u2714 ${tierLabel} plan`));
+  console.log(chalk6.dim(`      ${userEmail}`));
   if (userEmail && userEmail !== "anonymous") {
     try {
       const status = await getStatusCached(userEmail);
       for (const line of formatUsageLines(status, tier)) {
-        console.log(chalk7.dim(`      ${line}`));
+        console.log(chalk6.dim(`      ${line}`));
       }
     } catch {
     }
   }
   if (userTier === "free") {
     const upgradeUrl = getUpgradeUrl(userEmail !== "anonymous" ? userEmail : void 0);
-    console.log(chalk7.dim(`      Upgrade: ${upgradeUrl}`));
+    console.log(chalk6.dim(`      Upgrade: ${upgradeUrl}`));
   }
 }
 function displayPlanSummary(plan) {
   console.log();
-  console.log(chalk7.dim(`  ${plan.title || "Untitled"}`));
-  console.log(chalk7.dim(`  ${plan.steps?.length || 0} steps`));
+  console.log(chalk6.dim(`  ${plan.title || "Untitled"}`));
+  console.log(chalk6.dim(`  ${plan.steps?.length || 0} steps`));
   for (const step of plan.steps || []) {
     const text = step.caption || step.action || "";
     const caption = text.length > 50 ? `${text.slice(0, 47)}...` : text;
-    console.log(chalk7.dim(`    ${step.id}. ${caption}`));
+    console.log(chalk6.dim(`    ${step.id}. ${caption}`));
   }
 }
 function getOutputDirFromUrl(url) {
@@ -3205,6 +3316,86 @@ function getOutputDirFromUrl(url) {
   }
 }
 
+// src/commands/edit-cmd.ts
+var PLAN_FILE = /^plan-([a-z]{2}(?:-[A-Z]{2})?)\.json$/;
+function findPlanFile(dir, lang) {
+  if (lang) {
+    const exact = join10(dir, `plan-${lang}.json`);
+    return existsSync7(exact) ? exact : null;
+  }
+  if (!existsSync7(dir)) return null;
+  const plans = readdirSync(dir).filter((f) => PLAN_FILE.test(f));
+  const preferred = plans.find((f) => f === "plan-en.json") ?? plans[0];
+  return preferred ? join10(dir, preferred) : null;
+}
+
+// src/commands/record-cmd.ts
+import { existsSync as existsSync18 } from "fs";
+import { mkdir as mkdir8 } from "fs/promises";
+import { isAbsolute as isAbsolute5, join as join21, resolve as resolve9 } from "path";
+import chalk15 from "chalk";
+init_lib();
+init_config_loader();
+
+// src/commands/phases/auth-phase.ts
+init_lib();
+import chalk9 from "chalk";
+init_config_loader();
+
+// src/commands/utils/auth-helpers.ts
+init_lib();
+import chalk8 from "chalk";
+async function handleRegistrationGate() {
+  console.log();
+  console.log(chalk8.yellow("  \u{1F389} You've made 5 free videos!"));
+  console.log(chalk8.white("     Sign in to continue creating videos."));
+  console.log();
+  console.log(chalk8.dim("  Benefits of signing in:"));
+  console.log(chalk8.dim("    \u2022 20 more videos per month"));
+  console.log(chalk8.dim("    \u2022 Keep your video history"));
+  console.log(chalk8.dim("    \u2022 Upgrade to Pro anytime"));
+  let email = await browserLogin();
+  if (!email) {
+    console.log();
+    email = await promptInput("Email: ");
+  }
+  if (!email || !email.includes("@")) {
+    console.log(chalk8.red("  Invalid email. Run qp again to try again."));
+    return null;
+  }
+  const registerTask = task("Sending verification email");
+  const result = await registerFreeUser(email);
+  if (!result.success) {
+    registerTask.fail(result.error || "Registration failed");
+    return null;
+  }
+  if (result.alreadyVerified) {
+    registerTask.succeed("Already verified!");
+    return { email, verified: true };
+  }
+  registerTask.succeed("Check your email!");
+  console.log();
+  console.log(chalk8.cyan("  \u{1F4E7} Verification email sent to:"));
+  console.log(chalk8.white(`     ${email}`));
+  console.log();
+  console.log(chalk8.dim("  Click the link in the email, then press Enter to continue..."));
+  await promptInput("");
+  const verifyTask = task("Checking verification");
+  const verified = await isVerified(email);
+  if (verified) {
+    verifyTask.succeed("Email verified!");
+    return { email, verified: true };
+  }
+  verifyTask.fail("Not verified yet");
+  console.log();
+  console.log(chalk8.yellow("  Email not verified. Check your inbox and spam folder."));
+  console.log(chalk8.dim("  Run qp again after clicking the verification link."));
+  console.log();
+  console.log(chalk8.cyan(`  Or register/upgrade at: ${getUpgradeUrl(email)}`));
+  console.log();
+  return { email, verified: false };
+}
+
 // src/commands/phases/auth-phase.ts
 async function runAuthPhase(input) {
   let { userEmail, userTier, localVideoCount } = input;
@@ -3228,7 +3419,7 @@ async function runAuthPhase(input) {
     } else {
       verifyTask.fail("Email not verified");
       console.log();
-      console.log(chalk8.yellow("  Check your inbox for the verification email."));
+      console.log(chalk9.yellow("  Check your inbox for the verification email."));
       console.log();
       const input2 = await promptInput(`New email or Enter to retry (${userEmail}): `);
       if (input2.toLowerCase() === "exit") {
@@ -3253,8 +3444,8 @@ async function runAuthPhase(input) {
           registerTask.succeed("Check your email!");
           await saveUserData({ email: newEmail, verified: false });
           console.log();
-          console.log(chalk8.cyan(`  \u{1F4E7} Verification sent to: ${newEmail}`));
-          console.log(chalk8.dim("  Click the link in the email, then run qp again."));
+          console.log(chalk9.cyan(`  \u{1F4E7} Verification sent to: ${newEmail}`));
+          console.log(chalk9.dim("  Click the link in the email, then run qp again."));
           console.log();
           gracefulExit();
           return null;
@@ -3270,7 +3461,7 @@ async function runAuthPhase(input) {
         } else {
           recheckTask.fail("Still not verified");
           console.log();
-          console.log(chalk8.cyan(`  Register/upgrade at: ${getUpgradeUrl(userEmail)}`));
+          console.log(chalk9.cyan(`  Register/upgrade at: ${getUpgradeUrl(userEmail)}`));
           console.log();
           gracefulExit();
           return null;
@@ -3297,8 +3488,8 @@ async function runAuthPhase(input) {
   } else {
     const remaining = FREE_VIDEO_LIMIT - localVideoCount;
     console.log();
-    console.log(chalk8.cyan(`  \u{1F3AC} Video ${localVideoCount + 1}/${FREE_VIDEO_LIMIT} free`));
-    console.log(chalk8.dim(`     ${remaining - 1} more after this \u2022 Sign up for unlimited`));
+    console.log(chalk9.cyan(`  \u{1F3AC} Video ${localVideoCount + 1}/${FREE_VIDEO_LIMIT} free`));
+    console.log(chalk9.dim(`     ${remaining - 1} more after this \u2022 Sign up for unlimited`));
     userEmail = await setupUserEmail();
     let registeredVerified = false;
     try {
@@ -3317,10 +3508,10 @@ async function runAuthPhase(input) {
 }
 
 // src/commands/phases/plan-phase.ts
-import { existsSync as existsSync7, readdirSync } from "fs";
+import { existsSync as existsSync8, readdirSync as readdirSync2 } from "fs";
 import { readFile as readFile4 } from "fs/promises";
-import { basename, join as join10 } from "path";
-import chalk9 from "chalk";
+import { basename, join as join11 } from "path";
+import chalk10 from "chalk";
 
 // src/ai/fix.ts
 init_lib();
@@ -3473,12 +3664,22 @@ Return ONLY JSON: {"description": "...", "captions": ["...", ...]}`;
 init_config_loader();
 var INDENT3 = "   ";
 async function runPlanPhase(params) {
-  const { url, config, userEmail, description, planPath, legacyPlanPath, targetLang, userTier = "free" } = params;
+  const {
+    url,
+    config,
+    userEmail,
+    description,
+    planPath,
+    legacyPlanPath,
+    targetLang,
+    userTier = "free",
+    fresh = false
+  } = params;
   const maxSteps = config.plan?.maxSteps ?? 8;
   const extensionPath = config.browser?.extension;
   let existingPlan = null;
   let existingPlanPath = null;
-  if (existsSync7(planPath)) {
+  if (existsSync8(planPath)) {
     try {
       const parsed = JSON.parse(await readFile4(planPath, "utf-8"));
       if (parsed.url && parsed.steps?.length > 0) {
@@ -3490,10 +3691,10 @@ async function runPlanPhase(params) {
   }
   if (!existingPlan) {
     try {
-      const files = readdirSync(config.output.dir);
+      const files = readdirSync2(config.output.dir);
       const planFiles = files.filter((f) => /^plan-[a-z]{2}(-[A-Z]{2})?\.json$/.test(f) && f !== basename(planPath));
       for (const file of planFiles) {
-        const filePath = join10(config.output.dir, file);
+        const filePath = join11(config.output.dir, file);
         try {
           const parsed = JSON.parse(await readFile4(filePath, "utf-8"));
           if (parsed.url && parsed.steps?.length > 0) {
@@ -3507,7 +3708,7 @@ async function runPlanPhase(params) {
     } catch {
     }
   }
-  if (!existingPlan && existsSync7(legacyPlanPath)) {
+  if (!existingPlan && existsSync8(legacyPlanPath)) {
     try {
       const parsed = JSON.parse(await readFile4(legacyPlanPath, "utf-8"));
       if (parsed.url && parsed.steps?.length > 0) {
@@ -3533,25 +3734,25 @@ async function runPlanPhase(params) {
       translateTask.fail(failMsg);
     }
   };
-  if (existingPlan && existingPlanPath) {
+  if (existingPlan && existingPlanPath && !fresh) {
     console.log();
-    console.log(chalk9.dim(`  Found existing plan: `) + chalk9.cyan(formatClickablePath(existingPlanPath)));
-    console.log(chalk9.dim(`  ${existingPlan.steps.length} steps for ${existingPlan.url}`));
+    console.log(chalk10.dim(`  Found existing plan: `) + chalk10.cyan(formatClickablePath(existingPlanPath)));
+    console.log(chalk10.dim(`  ${existingPlan.steps.length} steps for ${existingPlan.url}`));
     if (!urlMatches) {
-      console.log(chalk9.yellow(`  \u26A0 Plan URL differs from argument:`));
-      console.log(chalk9.yellow(`    Plan: ${existingPlan.url}`));
-      console.log(chalk9.yellow(`    Arg:  ${url}`));
+      console.log(chalk10.yellow(`  \u26A0 Plan URL differs from argument:`));
+      console.log(chalk10.yellow(`    Plan: ${existingPlan.url}`));
+      console.log(chalk10.yellow(`    Arg:  ${url}`));
     }
     const existingLang = existingPlan.lang || "en";
     if (existingLang !== targetLang) {
-      console.log(chalk9.yellow(`  \u26A0 Plan is in ${existingLang}, config is ${targetLang}`));
+      console.log(chalk10.yellow(`  \u26A0 Plan is in ${existingLang}, config is ${targetLang}`));
     }
     const reuse = await confirm(`${INDENT3}Use existing plan?`);
     if (reuse) {
       plan = await validateAndFixPlan(existingPlanPath, task, logError, userEmail, userTier);
       if (existingPlanPath !== planPath) {
         await savePlan(plan, planPath);
-        console.log(chalk9.dim(`  Migrated to: ${formatClickablePath(planPath)}`));
+        console.log(chalk10.dim(`  Migrated to: ${formatClickablePath(planPath)}`));
       }
       if (existingLang !== targetLang) {
         const translate = await confirm(`${INDENT3}Translate to ${targetLang}?`);
@@ -3569,7 +3770,8 @@ async function runPlanPhase(params) {
         userEmail,
         extensionPath,
         config.output.dir,
-        userTier
+        userTier,
+        { width: config.video.width, height: config.video.height }
       );
       displayRateLimitInfo();
       if (urlMatches) {
@@ -3586,7 +3788,7 @@ async function runPlanPhase(params) {
             uploadIdx++;
           }
         }
-        console.log(chalk9.dim(`  Preserved upload paths from previous plan`));
+        console.log(chalk10.dim(`  Preserved upload paths from previous plan`));
       }
       await savePlan(plan, planPath);
       plan = await validateAndFixPlan(planPath, task, logError, userEmail, userTier);
@@ -3602,7 +3804,9 @@ async function runPlanPhase(params) {
       logError,
       userEmail,
       extensionPath,
-      config.output.dir
+      config.output.dir,
+      void 0,
+      { width: config.video.width, height: config.video.height }
     );
     displayRateLimitInfo();
     await savePlan(plan, planPath);
@@ -3610,8 +3814,8 @@ async function runPlanPhase(params) {
   }
   displayPlanSummary(plan);
   console.log();
-  console.log(chalk9.dim(`  Plan: ${formatClickablePath(planPath)}`));
-  console.log(chalk9.dim(`  Enter a prompt to refine, or press Enter to continue.`));
+  console.log(chalk10.dim(`  Plan: ${formatClickablePath(planPath)}`));
+  console.log(chalk10.dim(`  Enter a prompt to refine, or press Enter to continue.`));
   const MAX_REFINEMENTS = 10;
   let refinementCount = 0;
   while (true) {
@@ -3629,15 +3833,15 @@ async function runPlanPhase(params) {
       refineTask.succeed("Plan refined");
       displayRateLimitInfo();
       if (plan.steps.length > maxSteps) {
-        console.log(chalk9.yellow(`  \u26A0 ${plan.steps.length} steps exceeds limit of ${maxSteps}`));
+        console.log(chalk10.yellow(`  \u26A0 ${plan.steps.length} steps exceeds limit of ${maxSteps}`));
       }
       displayPlanSummary(plan);
       console.log();
-      console.log(chalk9.dim(`  Plan: ${formatClickablePath(planPath)}`));
+      console.log(chalk10.dim(`  Plan: ${formatClickablePath(planPath)}`));
       if (refinementCount >= MAX_REFINEMENTS) {
         console.log();
-        console.log(chalk9.yellow(`  \u26A0 You've refined the plan ${MAX_REFINEMENTS} times.`));
-        console.log(chalk9.dim(`  Further refinements may incur additional costs.`));
+        console.log(chalk10.yellow(`  \u26A0 You've refined the plan ${MAX_REFINEMENTS} times.`));
+        console.log(chalk10.dim(`  Further refinements may incur additional costs.`));
         const continueRefining = await confirm(`${INDENT3}Continue refining?`);
         if (!continueRefining) break;
       }
@@ -3649,12 +3853,12 @@ async function runPlanPhase(params) {
   const planLang = plan.lang || "en";
   if (planLang !== targetLang) {
     let useExistingTranslation = false;
-    if (existsSync7(planPath) && existingPlanPath !== planPath) {
+    if (existsSync8(planPath) && existingPlanPath !== planPath) {
       try {
         const translatedPlan = JSON.parse(await readFile4(planPath, "utf-8"));
         if (translatedPlan.steps?.length === plan.steps.length && translatedPlan.lang === targetLang) {
           console.log();
-          console.log(chalk9.dim(`  Found translated plan: ${formatClickablePath(planPath)}`));
+          console.log(chalk10.dim(`  Found translated plan: ${formatClickablePath(planPath)}`));
           const useTranslated = await confirm(`${INDENT3}Use ${targetLang} translation?`);
           if (useTranslated) {
             plan = translatedPlan;
@@ -3666,7 +3870,7 @@ async function runPlanPhase(params) {
     }
     if (!useExistingTranslation) {
       console.log();
-      console.log(chalk9.yellow(`  Plan is in ${planLang}, but voice is set to ${targetLang}`));
+      console.log(chalk10.yellow(`  Plan is in ${planLang}, but voice is set to ${targetLang}`));
       const translate = await confirm(`${INDENT3}Translate captions to ${targetLang}?`);
       if (translate) await doTranslate("Translation failed, using original");
     }
@@ -3676,32 +3880,32 @@ async function runPlanPhase(params) {
 
 // src/commands/phases/validation-phase.ts
 import { readFile as readFile7 } from "fs/promises";
-import chalk11 from "chalk";
+import chalk12 from "chalk";
 
 // src/record.ts
-import { existsSync as existsSync12 } from "fs";
+import { existsSync as existsSync13 } from "fs";
 import { mkdir as mkdir6 } from "fs/promises";
-import { join as join15 } from "path";
-import chalk10 from "chalk";
+import { join as join16 } from "path";
+import chalk11 from "chalk";
 
 // src/browser/actions.ts
-import { existsSync as existsSync9 } from "fs";
+import { existsSync as existsSync10 } from "fs";
 import { readFile as readFile5 } from "fs/promises";
 import { isAbsolute as isAbsolute2, resolve as resolve5 } from "path";
 
 // src/browser/effects.ts
 init_lib();
-import { existsSync as existsSync8, readFileSync as readFileSync3 } from "fs";
-import { join as join11 } from "path";
+import { existsSync as existsSync9, readFileSync as readFileSync4 } from "fs";
+import { join as join12 } from "path";
 function loadHighlightCSS() {
   const candidates = [
-    join11(__dirname, "highlight.css"),
+    join12(__dirname, "highlight.css"),
     // dist/ build
-    join11(__dirname, "..", "highlight.css")
+    join12(__dirname, "..", "highlight.css")
     // src/browser/ → src/
   ];
   for (const p of candidates) {
-    if (existsSync8(p)) return readFileSync3(p, "utf-8");
+    if (existsSync9(p)) return readFileSync4(p, "utf-8");
   }
   return "";
 }
@@ -4025,7 +4229,14 @@ async function executeStep(page, step, plan, config, cursorInjected, baseDir) {
         }
       } else {
         const amount = direction === "up" ? -PAGE_SCROLL_PX : PAGE_SCROLL_PX;
-        await page.evaluate((y) => window.scrollBy(0, y), amount);
+        const moved = await page.evaluate((y) => {
+          const before = window.scrollY;
+          window.scrollBy(0, y);
+          return window.scrollY - before;
+        }, amount);
+        if (moved === 0) {
+          throw new Error("scroll moved nothing: the page has no scroll headroom at this viewport");
+        }
       }
       break;
     }
@@ -4043,7 +4254,7 @@ async function executeStep(page, step, plan, config, cursorInjected, baseDir) {
           if (!isPlaceholder) {
             const normalizedPath = rawPath.startsWith("mnt/") ? `/${rawPath}` : rawPath;
             const filePath = isAbsolute2(normalizedPath) ? normalizedPath : resolve5(baseDir, normalizedPath);
-            if (existsSync9(filePath)) {
+            if (existsSync10(filePath)) {
               await fileInput.setInputFiles(filePath);
               await page.waitForTimeout(2e3);
               break;
@@ -4160,7 +4371,7 @@ async function executeStep(page, step, plan, config, cursorInjected, baseDir) {
       break;
     case "image": {
       const imagePath = step.value ? isAbsolute2(step.value) ? step.value : resolve5(baseDir, step.value) : null;
-      if (imagePath && existsSync9(imagePath)) {
+      if (imagePath && existsSync10(imagePath)) {
         const imgStyle = step.target === "stretch" ? `width: ${config.video.width}px; height: ${config.video.height}px; object-fit: cover;` : "max-width: 90%; max-height: 90%;";
         if (await showImagePage(page, imagePath, imgStyle, config, cursorInjected)) injected = true;
       }
@@ -4190,7 +4401,7 @@ async function executeStep(page, step, plan, config, cursorInjected, baseDir) {
         await pendingDownload;
         pendingDownload = null;
       }
-      if (lastDownloadPath && existsSync9(lastDownloadPath)) {
+      if (lastDownloadPath && existsSync10(lastDownloadPath)) {
         const imgStyle = step.target === "stretch" ? "width: 100%; height: 100%; object-fit: contain;" : "max-width: 90%; max-height: 90%; object-fit: contain;";
         if (await showImagePage(page, lastDownloadPath, imgStyle, config, cursorInjected)) injected = true;
       }
@@ -4235,22 +4446,22 @@ init_lib();
 
 // src/browser/dry-run.ts
 init_utils();
-import { join as join13 } from "path";
+import { join as join14 } from "path";
 
 // src/browser/step-validator.ts
 init_utils();
-import { existsSync as existsSync10, readdirSync as readdirSync2 } from "fs";
-import { basename as basename2, isAbsolute as isAbsolute3, join as join12, resolve as resolve6 } from "path";
+import { existsSync as existsSync11, readdirSync as readdirSync3 } from "fs";
+import { basename as basename2, isAbsolute as isAbsolute3, join as join13, resolve as resolve6 } from "path";
 function findMediaFile(filename, baseDir) {
   const name = basename2(filename);
-  const searchDirs = [baseDir, join12(baseDir, "res"), join12(baseDir, "assets"), join12(baseDir, "media")];
+  const searchDirs = [baseDir, join13(baseDir, "res"), join13(baseDir, "assets"), join13(baseDir, "media")];
   for (const dir of searchDirs) {
-    if (!existsSync10(dir)) continue;
+    if (!existsSync11(dir)) continue;
     try {
-      const files = readdirSync2(dir);
-      if (files.includes(name)) return join12(dir, name);
+      const files = readdirSync3(dir);
+      if (files.includes(name)) return join13(dir, name);
       const match = files.find((f) => f.toLowerCase() === name.toLowerCase());
-      if (match) return join12(dir, match);
+      if (match) return join13(dir, match);
     } catch {
     }
   }
@@ -4323,7 +4534,7 @@ function resolveMediaStep(step, baseDir, label, startTime) {
     return { success: false, error: `Missing ${label} path`, executionTimeMs: Date.now() - startTime };
   }
   const specifiedPath = isAbsolute3(step.value) ? step.value : resolve6(baseDir, step.value);
-  if (existsSync10(specifiedPath)) return { success: true, executionTimeMs: Date.now() - startTime };
+  if (existsSync11(specifiedPath)) return { success: true, executionTimeMs: Date.now() - startTime };
   const foundPath = findMediaFile(step.value, baseDir);
   if (foundPath) {
     step.value = `./${foundPath.replace(`${baseDir}/`, "").replace(`${baseDir}\\`, "")}`;
@@ -4445,7 +4656,7 @@ async function validateAndExecuteStep(page, step, plan, baseDir) {
         if (!isPlaceholder) {
           const normalizedPath = rawPath.startsWith("mnt/") ? `/${rawPath}` : rawPath;
           let filePath = isAbsolute3(normalizedPath) ? normalizedPath : resolve6(baseDir, normalizedPath);
-          if (!existsSync10(filePath)) {
+          if (!existsSync11(filePath)) {
             const foundPath = findMediaFile(rawPath, baseDir);
             if (foundPath) {
               const relativePath = `./${foundPath.replace(`${baseDir}/`, "").replace(`${baseDir}\\`, "")}`;
@@ -4544,7 +4755,7 @@ async function getPageElements(page) {
   });
 }
 async function validateStepsOnPage(plan, config, logError2, baseDir, onStepStart, onStepEnd) {
-  const userDataDir = join13(baseDir, ".browser-data");
+  const userDataDir = join14(baseDir, ".browser-data");
   const { context, browser, chromeSession } = await launchBrowserContext(
     config,
     userDataDir,
@@ -4609,17 +4820,17 @@ async function validateStepsOnPage(plan, config, logError2, baseDir, onStepStart
 }
 
 // src/browser/meta.ts
-import { existsSync as existsSync11 } from "fs";
+import { existsSync as existsSync12 } from "fs";
 import { readFile as readFile6, writeFile as writeFile7 } from "fs/promises";
-import { join as join14 } from "path";
+import { join as join15 } from "path";
 var RECORDING_FILE = "recording.mp4";
 var RECORDING_META_FILE = "recording.meta.json";
 function getRecordingPath(outputDir) {
-  return join14(outputDir, RECORDING_FILE);
+  return join15(outputDir, RECORDING_FILE);
 }
 async function loadRecordingMeta(outputDir) {
-  const metaPath = join14(outputDir, RECORDING_META_FILE);
-  if (!existsSync11(metaPath)) return null;
+  const metaPath = join15(outputDir, RECORDING_META_FILE);
+  if (!existsSync12(metaPath)) return null;
   try {
     const content = await readFile6(metaPath, "utf-8");
     return JSON.parse(content);
@@ -4628,7 +4839,7 @@ async function loadRecordingMeta(outputDir) {
   }
 }
 async function saveRecordingMeta(outputDir, meta) {
-  const metaPath = join14(outputDir, RECORDING_META_FILE);
+  const metaPath = join15(outputDir, RECORDING_META_FILE);
   await writeFile7(metaPath, JSON.stringify(meta, null, 2));
 }
 function canReuseRecording(plan, config, stepDurations, existingMeta) {
@@ -4698,14 +4909,14 @@ function formatStepLabel(step) {
   return `${caption.slice(0, 47)}...`;
 }
 async function recordSession(plan, config, stepDurations, workDir, baseDir, task2, logError2) {
-  const videoDir = join15(workDir, "video");
+  const videoDir = join16(workDir, "video");
   await mkdir6(videoDir, { recursive: true });
   const getStepDuration = (stepNum) => {
     return stepDurations[stepNum - 1] ?? config.timing.minStepDuration;
   };
   const browserTask = task2("Starting browser recording");
   const recordingStartTime = Date.now();
-  const userDataDir = join15(workDir, "browser-data");
+  const userDataDir = join16(workDir, "browser-data");
   const recordVideo = { dir: videoDir, size: { width: config.video.width, height: config.video.height } };
   const authState = findAuthState(plan.url);
   const { context, browser, chromeSession } = await launchBrowserContext(config, userDataDir, recordVideo, authState);
@@ -4806,9 +5017,9 @@ async function recordSession(plan, config, stepDurations, workDir, baseDir, task
     actualStepDurations.push(actualDuration);
   }
   if (failures.length > 0) {
-    console.log(chalk10.yellow(`  \u26A0 ${failures.length} step(s) skipped:`));
+    console.log(chalk11.yellow(`  \u26A0 ${failures.length} step(s) skipped:`));
     for (const f of failures) {
-      console.log(chalk10.yellow(`    - ${f}`));
+      console.log(chalk11.yellow(`    - ${f}`));
     }
   }
   const saveTask = task2("Saving video");
@@ -4817,7 +5028,7 @@ async function recordSession(plan, config, stepDurations, workDir, baseDir, task
   await page.close();
   const videoPath = await video.path();
   await cleanupBrowserSession({ context, browser, chromeSession });
-  if (!videoPath || !existsSync12(videoPath)) {
+  if (!videoPath || !existsSync13(videoPath)) {
     throw new Error("Video file was not created");
   }
   saveTask.succeed("Video saved");
@@ -4876,21 +5087,21 @@ async function runValidationPhase(params) {
     const stepNum = result.stepIndex + 1;
     const step = plan.steps[result.stepIndex];
     console.log();
-    console.log(chalk11.red(`  \u2717 Step ${stepNum}: ${step.action}`));
+    console.log(chalk12.red(`  \u2717 Step ${stepNum}: ${step.action}`));
     const caption = step.caption || "";
-    if (caption) console.log(chalk11.dim(`    Caption: ${caption.slice(0, 50)}${caption.length > 50 ? "..." : ""}`));
-    console.log(chalk11.dim(`    Target: ${step.target || "none"}`));
-    if (step.value) console.log(chalk11.dim(`    Value: ${step.value}`));
-    console.log(chalk11.dim(`    Error: ${result.error}`));
+    if (caption) console.log(chalk12.dim(`    Caption: ${caption.slice(0, 50)}${caption.length > 50 ? "..." : ""}`));
+    console.log(chalk12.dim(`    Target: ${step.target || "none"}`));
+    if (step.value) console.log(chalk12.dim(`    Value: ${step.value}`));
+    console.log(chalk12.dim(`    Error: ${result.error}`));
     if (result.suggestion) {
-      console.log(chalk11.yellow(`    Hint: ${result.suggestion}`));
+      console.log(chalk12.yellow(`    Hint: ${result.suggestion}`));
     }
     console.log();
     const isUploadMissingFile = step.action === "upload" && (!step.value || step.value.startsWith("[") || step.value.includes("example") || step.value.includes("/path/to"));
     if (isUploadMissingFile) {
       const filePath = await promptInput('Enter file path to upload (or "skip"): ');
       if (filePath.toLowerCase() === "skip") {
-        console.log(chalk11.yellow(`  Skipping step ${stepNum}`));
+        console.log(chalk12.yellow(`  Skipping step ${stepNum}`));
         continue;
       }
       if (filePath) {
@@ -4899,13 +5110,13 @@ async function runValidationPhase(params) {
         const revalidation2 = await validateStepsOnPage(plan, config, logError, config.output.dir);
         const newResult2 = revalidation2.results[result.stepIndex];
         if (newResult2?.success) {
-          console.log(chalk11.green(`  \u2713 Step ${stepNum} now passes`));
+          console.log(chalk12.green(`  \u2713 Step ${stepNum} now passes`));
           validationResult = revalidation2;
           continue;
         }
         result.error = newResult2?.error;
         result.suggestion = newResult2?.suggestion;
-        console.log(chalk11.red(`  Still failing: ${result.error}`));
+        console.log(chalk12.red(`  Still failing: ${result.error}`));
       }
     }
     const fixTask = task(`Fixing step ${stepNum} with AI`);
@@ -4927,8 +5138,8 @@ async function runValidationPhase(params) {
       await savePlan(plan, planPath);
       fixTask.succeed("AI suggested a fix");
       const fixedStep = plan.steps[result.stepIndex];
-      console.log(chalk11.dim(`    New target: ${fixedStep.target || "none"}`));
-      if (fixedStep.value) console.log(chalk11.dim(`    New value: ${fixedStep.value}`));
+      console.log(chalk12.dim(`    New target: ${fixedStep.target || "none"}`));
+      if (fixedStep.value) console.log(chalk12.dim(`    New value: ${fixedStep.value}`));
     } catch {
       fixTask.fail("AI could not fix automatically");
     }
@@ -4944,11 +5155,11 @@ async function runValidationPhase(params) {
     result.error = newResult?.error;
     result.suggestion = newResult?.suggestion;
     console.log();
-    console.log(chalk11.yellow(`  Edit step ${stepNum} in: `) + chalk11.cyan(formatClickablePath(planPath)));
+    console.log(chalk12.yellow(`  Edit step ${stepNum} in: `) + chalk12.cyan(formatClickablePath(planPath)));
     console.log();
     const choice = await promptInput('Press Enter after editing, or type "skip" to skip this step: ');
     if (choice.toLowerCase() === "skip") {
-      console.log(chalk11.yellow(`  Skipping step ${stepNum} - may fail during recording`));
+      console.log(chalk12.yellow(`  Skipping step ${stepNum} - may fail during recording`));
       continue;
     }
     plan = JSON.parse(await readFile7(planPath, "utf-8"));
@@ -4976,17 +5187,17 @@ async function runValidationPhase(params) {
 
 // src/commands/phases/video-phase.ts
 init_lib();
-import { existsSync as existsSync14 } from "fs";
+import { existsSync as existsSync15 } from "fs";
 import { copyFile } from "fs/promises";
-import { join as join17, resolve as resolve8 } from "path";
+import { join as join18, resolve as resolve8 } from "path";
 
 // src/utils/video-pipeline.ts
 init_lib();
 import { chunkWordsByCount, assTimeFromMs as formatASSTime } from "@spark-apps/video-kit";
-import { existsSync as existsSync13 } from "fs";
+import { existsSync as existsSync14 } from "fs";
 import { mkdir as mkdir7, writeFile as writeFile8 } from "fs/promises";
-import { isAbsolute as isAbsolute4, join as join16, resolve as resolve7 } from "path";
-import chalk12 from "chalk";
+import { isAbsolute as isAbsolute4, join as join17, resolve as resolve7 } from "path";
+import chalk13 from "chalk";
 var INDENT4 = "   ";
 async function generateASS(plan, stepAudio, workDir, config, captions) {
   const regularColor = hexToAss(captions.regular.color);
@@ -5033,7 +5244,7 @@ async function generateASS(plan, stepAudio, workDir, config, captions) {
     }
     currentTime += audio.duration;
   }
-  const assPath = join16(workDir, "subtitles.ass");
+  const assPath = join17(workDir, "subtitles.ass");
   await writeFile8(assPath, ass);
   return assPath;
 }
@@ -5048,7 +5259,7 @@ function buildVideoOverlays(steps, stepDurations, baseDir) {
       const ext = step.value.split(".").pop()?.toLowerCase() || "";
       if (["mp4", "webm", "mov"].includes(ext)) {
         const mediaPath = isAbsolute4(step.value) ? step.value : resolve7(baseDir, step.value);
-        if (existsSync13(mediaPath)) {
+        if (existsSync14(mediaPath)) {
           const partial = parsePartial(step.partial);
           overlays.push({
             path: mediaPath,
@@ -5067,11 +5278,11 @@ function buildVideoOverlays(steps, stepDurations, baseDir) {
 }
 async function composeAndFinish(videoPath, audioPath, assPath, config, userTier = "free", mainContentDuration, trimStart = 0.5, stepTransitions, _stepSync) {
   header("Compose");
-  const configPath = join16(process.cwd(), CONFIG_FILE);
-  console.log(`${INDENT4}${chalk12.dim(`Config: ${formatClickablePath(configPath)}`)}`);
+  const configPath = join17(process.cwd(), CONFIG_FILE);
+  console.log(`${INDENT4}${chalk13.dim(`Config: ${formatClickablePath(configPath)}`)}`);
   const proceed = await confirm(`${INDENT4}Review config or continue?`);
   if (!proceed) {
-    console.log(chalk12.yellow(`
+    console.log(chalk13.yellow(`
   Edit ${CONFIG_FILE} and run again.
 `));
     process.exit(0);
@@ -5079,11 +5290,11 @@ async function composeAndFinish(videoPath, audioPath, assPath, config, userTier
   const composeTask = task("Building final video");
   await mkdir7(config.output.dir, { recursive: true });
   const suffix = config.lang ? `-${config.lang}` : "";
-  const finalPath = join16(config.output.dir, `demo${suffix}.${config.video.format}`);
+  const finalPath = join17(config.output.dir, `demo${suffix}.${config.video.format}`);
   const videoDuration = await getMediaDuration(videoPath) / 1e3;
-  const hasVoiceover = audioPath && existsSync13(audioPath);
+  const hasVoiceover = audioPath && existsSync14(audioPath);
   const musicPath = config.music?.path ? isAbsolute4(config.music.path) ? config.music.path : resolve7(config.output.dir, config.music.path) : "";
-  const hasMusic = musicPath && existsSync13(musicPath);
+  const hasMusic = musicPath && existsSync14(musicPath);
   try {
     await composeVideo({
       videoPath,
@@ -5122,7 +5333,7 @@ async function speedUpToFitLimit(finalPath, config, limitSecs = 60) {
   if (duration <= limitSecs * 1e3) return finalPath;
   const speedFactor = Math.ceil(duration / (limitSecs * 1e3) * 10) / 10;
   console.log();
-  console.log(chalk12.yellow(`  Video is ${(duration / 1e3).toFixed(0)}s - over ${limitSecs}s`));
+  console.log(chalk13.yellow(`  Video is ${(duration / 1e3).toFixed(0)}s - over ${limitSecs}s`));
   const speedUp = await confirm(`  Speed up ${speedFactor}x to fit under ${limitSecs}s?`);
   if (!speedUp) return finalPath;
   const speedTask = task(`Speeding up ${speedFactor}x`);
@@ -5163,7 +5374,7 @@ async function runVideoPhase(params) {
               mediaDuration = (trimEnd - trimStart2) * 1e3;
             } else {
               const mediaPath = resolve8(s.value);
-              if (existsSync14(mediaPath)) {
+              if (existsSync15(mediaPath)) {
                 try {
                   const fullDuration = await getMediaDuration(mediaPath);
                   const start = (trimStart2 ?? 0) * 1e3;
@@ -5175,7 +5386,7 @@ async function runVideoPhase(params) {
             }
           } else {
             const mediaPath = resolve8(s.value);
-            if (existsSync14(mediaPath)) {
+            if (existsSync15(mediaPath)) {
               try {
                 mediaDuration = await getMediaDuration(mediaPath);
               } catch {
@@ -5188,7 +5399,7 @@ async function runVideoPhase(params) {
     })
   );
   const recordingPath = getRecordingPath(config.output.dir);
-  const hasExistingRecording = existingRecordingMeta && existsSync14(recordingPath);
+  const hasExistingRecording = existingRecordingMeta && existsSync15(recordingPath);
   let videoPath = recordingPath;
   const firstStep = plan.steps[0];
   const firstStepIsVideo = firstStep && (firstStep.action === "video" || firstStep.action === "media");
@@ -5228,7 +5439,7 @@ async function runVideoPhase(params) {
   if (videoOverlays.length > 0) {
     const spliceTask = task("Splicing videos into recording");
     try {
-      const splicedPath = join17(workDir, "spliced.mp4");
+      const splicedPath = join18(workDir, "spliced.mp4");
       await spliceVideos({
         inputPath: videoPath,
         outputPath: splicedPath,
@@ -5248,7 +5459,7 @@ async function runVideoPhase(params) {
   if (stepTransitions.length > 0) {
     const transitionTask = task("Applying transitions");
     try {
-      const transitionedPath = join17(workDir, "transitioned.mp4");
+      const transitionedPath = join18(workDir, "transitioned.mp4");
       const videoDuration = alignedStepDurations.reduce((a, b) => a + b, 0) / 1e3;
       await applyTransitions({
         inputVideo: videoPath,
@@ -5269,15 +5480,15 @@ async function runVideoPhase(params) {
   let mainContentDuration;
   if (userTier === "free") {
     const scriptDir = getScriptDir();
-    let outroPath = join17(scriptDir, "assets", "qp.wm");
-    if (!existsSync14(outroPath)) {
-      outroPath = join17(scriptDir, "..", "dist", "assets", "qp.wm");
+    let outroPath = join18(scriptDir, "assets", "qp.wm");
+    if (!existsSync15(outroPath)) {
+      outroPath = join18(scriptDir, "..", "dist", "assets", "qp.wm");
     }
-    if (existsSync14(outroPath)) {
+    if (existsSync15(outroPath)) {
       try {
         const mainDuration = await getMediaDuration(videoPath);
         mainContentDuration = mainDuration / 1e3 - trimStart;
-        const combinedPath = join17(workDir, "combined-with-outro.mp4");
+        const combinedPath = join18(workDir, "combined-with-outro.mp4");
         await concatVideoWithOutro({
           inputPath: videoPath,
           outroPath,
@@ -5325,16 +5536,16 @@ async function runVideoPhase(params) {
 
 // src/commands/phases/voiceover-phase.ts
 init_lib();
-import { existsSync as existsSync15 } from "fs";
-import { join as join18 } from "path";
-import chalk13 from "chalk";
+import { existsSync as existsSync16 } from "fs";
+import { join as join19 } from "path";
+import chalk14 from "chalk";
 var INDENT6 = "   ";
 async function runVoiceoverPhase(plan, config, workDir, skipVoice, fresh) {
   if (fresh) {
     const filesToDelete = ["voiceover.json", "voiceover.wav", "recording.meta.json"];
     for (const file of filesToDelete) {
-      const filePath = join18(config.output.dir, file);
-      if (existsSync15(filePath)) {
+      const filePath = join19(config.output.dir, file);
+      if (existsSync16(filePath)) {
         const { unlink: unlink3 } = await import("fs/promises");
         await unlink3(filePath).catch(() => {
         });
@@ -5344,8 +5555,8 @@ async function runVoiceoverPhase(plan, config, workDir, skipVoice, fresh) {
   }
   const voice = resolveVoice(config);
   const existingMeta = await loadVoiceoverMeta(config.output.dir);
-  const voiceoverFile = join18(config.output.dir, "voiceover.wav");
-  const hasExistingVoiceover = existingMeta && existsSync15(voiceoverFile);
+  const voiceoverFile = join19(config.output.dir, "voiceover.wav");
+  const hasExistingVoiceover = existingMeta && existsSync16(voiceoverFile);
   const voiceMatches = !existingMeta || !voice || existingMeta.voice === voice;
   let voiceoverPath;
   let stepAudio;
@@ -5368,9 +5579,9 @@ async function runVoiceoverPhase(plan, config, workDir, skipVoice, fresh) {
     const reuseCheck = canReuseVoiceover(plan.steps, voice, existingMeta);
     if (reuseCheck.canReuse) {
       console.log();
-      console.log(chalk13.dim(`  Found existing voiceover in ${config.output.dir}`));
+      console.log(chalk14.dim(`  Found existing voiceover in ${config.output.dir}`));
       if (reuseCheck.reason) {
-        console.log(chalk13.dim(`  ${reuseCheck.reason}`));
+        console.log(chalk14.dim(`  ${reuseCheck.reason}`));
       }
       const reuse = await confirm(`${INDENT6}Reuse existing voiceover?`);
       if (reuse) {
@@ -5402,31 +5613,31 @@ async function runVoiceoverPhase(plan, config, workDir, skipVoice, fresh) {
 }
 
 // src/commands/utils/chrome-extension.ts
-import { existsSync as existsSync16, readdirSync as readdirSync3, readFileSync as readFileSync4 } from "fs";
+import { existsSync as existsSync17, readdirSync as readdirSync4, readFileSync as readFileSync5 } from "fs";
 import { homedir as homedir3 } from "os";
-import { join as join19 } from "path";
+import { join as join20 } from "path";
 function resolveChromeExtension(extensionId) {
   const platform = process.platform;
   const possibleDirs = [];
   const getChromeExtDirs = (userDataPath) => {
     const dirs = [];
     try {
-      const profiles = readdirSync3(userDataPath).filter((p) => p === "Default" || p.startsWith("Profile "));
+      const profiles = readdirSync4(userDataPath).filter((p) => p === "Default" || p.startsWith("Profile "));
       for (const profile of profiles) {
-        dirs.push(join19(userDataPath, profile, "Extensions"));
+        dirs.push(join20(userDataPath, profile, "Extensions"));
       }
     } catch {
-      dirs.push(join19(userDataPath, "Default", "Extensions"));
+      dirs.push(join20(userDataPath, "Default", "Extensions"));
     }
     return dirs;
   };
   if (platform === "win32") {
-    possibleDirs.push(...getChromeExtDirs(join19(homedir3(), "AppData", "Local", "Google", "Chrome", "User Data")));
+    possibleDirs.push(...getChromeExtDirs(join20(homedir3(), "AppData", "Local", "Google", "Chrome", "User Data")));
   } else if (platform === "darwin") {
-    possibleDirs.push(...getChromeExtDirs(join19(homedir3(), "Library", "Application Support", "Google", "Chrome")));
+    possibleDirs.push(...getChromeExtDirs(join20(homedir3(), "Library", "Application Support", "Google", "Chrome")));
   } else {
     try {
-      const windowsUsers = readdirSync3("/mnt/c/Users").filter(
+      const windowsUsers = readdirSync4("/mnt/c/Users").filter(
         (u) => !["All Users", "Default", "Default User", "Public", "desktop.ini"].includes(u)
       );
       for (const user of windowsUsers) {
@@ -5434,22 +5645,22 @@ function resolveChromeExtension(extensionId) {
       }
     } catch {
     }
-    possibleDirs.push(...getChromeExtDirs(join19(homedir3(), ".config", "google-chrome")));
+    possibleDirs.push(...getChromeExtDirs(join20(homedir3(), ".config", "google-chrome")));
   }
   for (const chromeExtDir of possibleDirs) {
-    const extDir = join19(chromeExtDir, extensionId);
-    if (!existsSync16(extDir)) continue;
+    const extDir = join20(chromeExtDir, extensionId);
+    if (!existsSync17(extDir)) continue;
     try {
-      const versions = readdirSync3(extDir).filter((f) => !f.startsWith("."));
+      const versions = readdirSync4(extDir).filter((f) => !f.startsWith("."));
       if (versions.length === 0) continue;
       const latestVersion = versions.sort().pop();
-      const extPath = join19(extDir, latestVersion);
+      const extPath = join20(extDir, latestVersion);
       let name = extensionId;
       let popupPath = "popup.html";
-      const manifestPath = join19(extPath, "manifest.json");
-      if (existsSync16(manifestPath)) {
+      const manifestPath = join20(extPath, "manifest.json");
+      if (existsSync17(manifestPath)) {
         try {
-          const manifest = JSON.parse(readFileSync4(manifestPath, "utf-8"));
+          const manifest = JSON.parse(readFileSync5(manifestPath, "utf-8"));
           if (manifest.name && !manifest.name.startsWith("__MSG_")) {
             name = manifest.name;
           }
@@ -5480,16 +5691,16 @@ async function recordCommand(url, options = {}) {
     const extensionId = url.slice(7);
     chromeExtension = resolveChromeExtension(extensionId);
     if (!chromeExtension) {
-      console.log(chalk14.red(`
+      console.log(chalk15.red(`
   \u2717 Chrome extension not found: ${extensionId}`));
-      console.log(chalk14.dim(`    Make sure the extension is installed in Chrome
+      console.log(chalk15.dim(`    Make sure the extension is installed in Chrome
 `));
       process.exit(1);
     }
     config.browser = { extension: chromeExtension.path };
     url = chromeExtension.popupUrl;
-    console.log(chalk14.dim(`  Extension: ${chromeExtension.name}`));
-    console.log(chalk14.dim(`  Path: ${chromeExtension.path}`));
+    console.log(chalk15.dim(`  Extension: ${chromeExtension.name}`));
+    console.log(chalk15.dim(`  Path: ${chromeExtension.path}`));
   }
   config.output.dir = chromeExtension ? `./${chromeExtension.name.toLowerCase().replace(/[^a-z0-9]+/g, "-")}-demo` : getOutputDirFromUrl(url);
   const userData = await loadUserData();
@@ -5502,20 +5713,20 @@ async function recordCommand(url, options = {}) {
   if (!authResult) return;
   const { userEmail, userTier, localVideoCount } = authResult;
   if (configCreated) {
-    const configPath = join20(process.cwd(), CONFIG_FILE);
+    const configPath = join21(process.cwd(), CONFIG_FILE);
     console.log();
-    console.log(chalk14.green(`  \u2714 Created ${CONFIG_FILE}`));
-    console.log(chalk14.dim(`    ${configPath}`));
+    console.log(chalk15.green(`  \u2714 Created ${CONFIG_FILE}`));
+    console.log(chalk15.dim(`    ${configPath}`));
     console.log();
-    console.log(chalk14.cyan("  Review the config file to customize:"));
-    console.log(chalk14.dim("    \u2022 lang: Voice language (en, es, ar, zh...)"));
-    console.log(chalk14.dim("    \u2022 video: Resolution, quality, effects"));
-    console.log(chalk14.dim("    \u2022 music: Background music path and volume"));
-    console.log(chalk14.dim("    \u2022 output: Output directory"));
+    console.log(chalk15.cyan("  Review the config file to customize:"));
+    console.log(chalk15.dim("    \u2022 lang: Voice language (en, es, ar, zh...)"));
+    console.log(chalk15.dim("    \u2022 video: Resolution, quality, effects"));
+    console.log(chalk15.dim("    \u2022 music: Background music path and volume"));
+    console.log(chalk15.dim("    \u2022 output: Output directory"));
     console.log();
     const proceed = await confirm(`${INDENT2}Proceed with default settings?`);
     if (!proceed) {
-      console.log(chalk14.yellow(`
+      console.log(chalk15.yellow(`
   Edit ${CONFIG_FILE} and run again.
 `));
       process.exit(0);
@@ -5524,16 +5735,16 @@ async function recordCommand(url, options = {}) {
   if (langOverride) config.lang = langOverride;
   if (config.music?.path) {
     const musicPath = isAbsolute5(config.music.path) ? config.music.path : resolve9(config.output.dir, config.music.path);
-    if (!existsSync17(musicPath)) {
+    if (!existsSync18(musicPath)) {
       console.log();
-      console.log(chalk14.yellow(`  \u26A0 Music file not found: ${config.music.path}`));
-      console.log(chalk14.dim(`    Config: ${join20(process.cwd(), CONFIG_FILE)}`));
+      console.log(chalk15.yellow(`  \u26A0 Music file not found: ${config.music.path}`));
+      console.log(chalk15.dim(`    Config: ${join21(process.cwd(), CONFIG_FILE)}`));
       console.log();
       const proceed = await confirm(`${INDENT2}Continue without background music?`);
       if (!proceed) {
-        console.log(chalk14.yellow(`
+        console.log(chalk15.yellow(`
   Edit music.path in config and run again.`));
-        console.log(chalk14.dim(`    ${join20(process.cwd(), CONFIG_FILE)}
+        console.log(chalk15.dim(`    ${join21(process.cwd(), CONFIG_FILE)}
 `));
         process.exit(0);
       }
@@ -5543,8 +5754,8 @@ async function recordCommand(url, options = {}) {
   const captions = await loadCaptions();
   const workDir = await prepareWorkDir();
   const targetLang = config.lang || "en";
-  const planPath = join20(config.output.dir, `plan-${targetLang}.json`);
-  const legacyPlanPath = join20(config.output.dir, "plan.json");
+  const planPath = join21(config.output.dir, `plan-${targetLang}.json`);
+  const legacyPlanPath = join21(config.output.dir, "plan.json");
   const isExtensionUrl = url.startsWith("chrome-extension://");
   await mkdir8(config.output.dir, { recursive: true });
   await setLogFilePath(config.output.dir);
@@ -5557,7 +5768,8 @@ async function recordCommand(url, options = {}) {
       ...description !== void 0 && { description },
       planPath,
       legacyPlanPath,
-      targetLang
+      targetLang,
+      ...fresh !== void 0 && { fresh }
     });
     const validatedPlan = await runValidationPhase({
       plan,
@@ -5582,29 +5794,29 @@ async function recordCommand(url, options = {}) {
       await saveUserData({ localVideoCount: newCount });
       const remaining = FREE_VIDEO_LIMIT - newCount;
       if (remaining > 0) {
-        console.log(chalk14.dim(`  ${remaining} free video${remaining === 1 ? "" : "s"} remaining`));
+        console.log(chalk15.dim(`  ${remaining} free video${remaining === 1 ? "" : "s"} remaining`));
       }
     }
     console.log();
-    console.log(chalk14.bold.green("  \u2713 Done!"));
+    console.log(chalk15.bold.green("  \u2713 Done!"));
     console.log();
-    console.log(chalk14.cyan(`  ${formatClickablePath(finalPath)}`));
+    console.log(chalk15.cyan(`  ${formatClickablePath(finalPath)}`));
     console.log();
     return finalPath;
   } catch (err) {
     await logError("Record Command", err);
     if (rethrow) throw err;
     console.log();
-    console.log(chalk14.red(`  Error: ${err instanceof Error ? err.message : "Unknown error"}`));
-    console.log(chalk14.dim(`  See ${logFilePath} for details`));
+    console.log(chalk15.red(`  Error: ${err instanceof Error ? err.message : "Unknown error"}`));
+    console.log(chalk15.dim(`  See ${logFilePath} for details`));
     process.exit(1);
   }
 }
 
 // src/commands/script-cmd.ts
 import { readFile as readFile8 } from "fs/promises";
-import { join as join21 } from "path";
-import chalk15 from "chalk";
+import { join as join22 } from "path";
+import chalk16 from "chalk";
 
 // src/ai/narrate.ts
 init_lib();
@@ -5659,7 +5871,7 @@ async function scriptCommand(url, scriptPath, lang) {
   const raw = await readFile8(scriptPath, "utf-8");
   const lines = raw.split("\n").map((l) => l.trim()).filter((l) => l.length > 0 && !l.startsWith("#"));
   if (lines.length === 0) {
-    console.log(chalk15.red("  Script file is empty or has no non-comment lines"));
+    console.log(chalk16.red("  Script file is empty or has no non-comment lines"));
     process.exit(1);
   }
   info(`${lines.length} captions from script`);
@@ -5671,7 +5883,7 @@ async function scriptCommand(url, scriptPath, lang) {
   const planTask = task("Mapping script to UI actions");
   const appTitle = new URL(url).hostname.replace(/^www\./, "");
   const plan = await generatePlanFromScript(lines, url, appTitle, elementsText, lang, logError);
-  const planPath = join21(config.output.dir, `plan-${lang ?? "en"}.json`);
+  const planPath = join22(config.output.dir, `plan-${lang ?? "en"}.json`);
   await savePlan(plan, planPath);
   planTask.succeed(`${plan.steps.length} steps planned`);
   header("Voiceover");
@@ -5691,12 +5903,23 @@ async function scriptCommand(url, scriptPath, lang) {
   const assPath = await generateASS(plan, stepAudio, workDir, config, captions);
   const finalPath = await composeAndFinish(videoPath, voiceoverPath, assPath, config, "free");
   console.log();
-  console.log(chalk15.bold.green("  Done!"));
-  console.log(chalk15.cyan(`  ${finalPath}`));
+  console.log(chalk16.bold.green("  Done!"));
+  console.log(chalk16.cyan(`  ${finalPath}`));
 }
 
 // src/mcp/tools.ts
 init_SparkStripe_feature_gating();
+
+// src/mcp/elicit.ts
+var elicit = null;
+function setElicit(fn) {
+  elicit = fn;
+}
+async function askUser(message) {
+  return elicit ? elicit(message) : null;
+}
+
+// src/mcp/tools.ts
 var URL_PROPERTY = {
   url: {
     type: "string",
@@ -5712,7 +5935,7 @@ var LANG_PROPERTY = {
 var QUICKPEEK_TOOLS = [
   {
     name: "generate_demo",
-    description: "Record a narrated demo video of a web app, end to end: an AI plans the walkthrough, Playwright drives a real browser, and the result is composed with voiceover and burned karaoke captions. This is the headline tool. It takes minutes, not seconds, because a real browser session is recorded. Returns the finished MP4 path and a file:// url. Pages behind a login can be demoed after the user runs `qp auth <url>` once in a terminal; the saved session is picked up automatically.",
+    description: "Record a narrated demo video of a web app, end to end: an AI plans the walkthrough, Playwright drives a real browser, and the result is composed with voiceover and burned karaoke captions. This is the headline tool. It takes minutes, not seconds, because a real browser session is recorded. Returns the finished MP4 path and a file:// url. Pages behind a login can be demoed once a session is saved for the host, by start_auth or by the user running `qp auth <url>`; it is picked up automatically. The result says whether this recording was signed in.",
     inputSchema: {
       type: "object",
       properties: {
@@ -5750,6 +5973,29 @@ var QUICKPEEK_TOOLS = [
       required: ["url", "script_path"]
     }
   },
+  {
+    name: "open_in_editor",
+    description: "Open a recorded demo's plan in the browser editor, where the user can reword captions, reorder steps or drop them. The plan travels in the URL fragment, so nothing is uploaded; saving in the editor writes back over the same file and the next recording picks it up. Records nothing itself.",
+    inputSchema: {
+      type: "object",
+      properties: { ...URL_PROPERTY, ...LANG_PROPERTY },
+      required: ["url"]
+    }
+  },
+  {
+    name: "start_auth",
+    description: "Open a visible browser on a site so the user can sign in, once, by hand. Everything recorded afterwards starts from that session, so a demo can cover pages behind the login. QuickPeek never sees the password: only the resulting cookies are saved. On clients that support prompting, this saves the session as soon as the user confirms; otherwise call finish_auth when they say they are done.",
+    inputSchema: {
+      type: "object",
+      properties: { ...URL_PROPERTY },
+      required: ["url"]
+    }
+  },
+  {
+    name: "finish_auth",
+    description: "Save the session from the browser window start_auth opened, and close it. Call this once the user says they have signed in.",
+    inputSchema: { type: "object", properties: {} }
+  },
   {
     name: "list_demos",
     description: "List demo videos already produced for a URL, newest first, with size and modified time. Cheap: reads the output directory, records nothing.",
@@ -5803,7 +6049,7 @@ function authStatus(url) {
   return {
     signedIn: false,
     host,
-    note: `No saved session for ${host}, so only pages reachable while logged out were recorded. To cover pages behind the login, ask the user to run \`qp auth ${url}\` in a terminal and sign in once, then re-run with fresh: true.`
+    note: `No saved session for ${host}, so only pages reachable while logged out were recorded. To cover pages behind the login, call start_auth with this url (or have the user run \`qp auth ${url}\`), then re-run with fresh: true.`
   };
 }
 async function handleGenerateDemoFromScript(args) {
@@ -5817,9 +6063,56 @@ async function handleGenerateDemoFromScript(args) {
     return fileResult(newest, { name: newest.split("/").pop(), url_recorded: url, scriptPath });
   });
 }
+async function handleOpenInEditor(args) {
+  const url = resolveUrl(args.url);
+  return withSilencedStdout(async () => {
+    const dir = getOutputDirFromUrl(url);
+    const planPath = findPlanFile(dir, args.lang);
+    if (!planPath) {
+      return errorContent(`No plan found in ${dir}. Record the demo first with generate_demo.`);
+    }
+    const parsed = parsePlanText(readFileSync6(planPath, "utf8"));
+    if (!parsed.ok) return errorContent(`${planPath} cannot be opened: ${parsed.error}`);
+    const base = editorBaseUrl();
+    const editorUrl = planEditorUrl(base, parsed.plan);
+    await openInBrowser(editorUrl ?? `${base}/edit`);
+    return jsonContent({
+      opened: true,
+      plan_path: planPath,
+      steps: parsed.plan.steps.length,
+      url: editorUrl ?? `${base}/edit`,
+      next_steps: editorUrl ? ["The editor opens with the plan loaded.", "Saving there writes back over plan_path; then re-record."] : [`This plan is too long for a link. Load ${planPath} in the editor by hand.`]
+    });
+  });
+}
+async function handleStartAuth(args) {
+  const url = resolveUrl(args.url);
+  return withSilencedStdout(async () => {
+    await openSignIn(url);
+    const confirmed = await askUser(`A browser window is open on ${url}. Sign in there, then confirm.`);
+    if (confirmed === null) {
+      return jsonContent({
+        status: "awaiting_sign_in",
+        url,
+        next: "A browser window is open. Call finish_auth once the user says they are signed in."
+      });
+    }
+    if (!confirmed) {
+      await cancelSignIn();
+      return jsonContent({ status: "cancelled", url, note: "Nothing was saved." });
+    }
+    return jsonContent({ status: "saved", ...await saveSignIn() });
+  });
+}
+async function handleFinishAuth() {
+  return withSilencedStdout(async () => {
+    if (!pendingSignIn()) return errorContent("No sign-in window is open. Call start_auth first.");
+    return jsonContent({ status: "saved", ...await saveSignIn() });
+  });
+}
 function newestVideo(dir) {
   try {
-    const videos = readdirSync4(dir).filter((f) => f.toLowerCase().endsWith(".mp4")).map((f) => join22(dir, f)).map((p) => ({ path: p, mtime: statSync2(p).mtimeMs })).sort((a, b) => b.mtime - a.mtime);
+    const videos = readdirSync5(dir).filter((f) => f.toLowerCase().endsWith(".mp4")).map((f) => join23(dir, f)).map((p) => ({ path: p, mtime: statSync2(p).mtimeMs })).sort((a, b) => b.mtime - a.mtime);
     return videos[0]?.path ?? null;
   } catch {
     return null;
@@ -5831,8 +6124,8 @@ async function handleListDemos(args) {
   return withSilencedStdout(async () => {
     let entries = [];
     try {
-      entries = readdirSync4(dir).filter((f) => f.toLowerCase().endsWith(".mp4")).map((f) => {
-        const s = statSync2(join22(dir, f));
+      entries = readdirSync5(dir).filter((f) => f.toLowerCase().endsWith(".mp4")).map((f) => {
+        const s = statSync2(join23(dir, f));
         return { name: f, bytes: s.size, modified: new Date(s.mtimeMs).toISOString() };
       }).sort((a, b) => b.modified.localeCompare(a.modified));
     } catch {
@@ -5878,6 +6171,9 @@ async function handleCheckAccount() {
 var QUICKPEEK_HANDLERS = {
   generate_demo: handleGenerateDemo,
   generate_demo_from_script: handleGenerateDemoFromScript,
+  open_in_editor: handleOpenInEditor,
+  start_auth: handleStartAuth,
+  finish_auth: handleFinishAuth,
   list_demos: handleListDemos,
   get_demo_config: handleGetDemoConfig,
   list_voices: handleListVoices,
@@ -5905,5 +6201,6 @@ export {
   TOOLS,
   TOOL_HANDLERS,
   errorContent,
-  jsonContent
+  jsonContent,
+  setElicit
 };