mcp-scraper 0.3.1 → 0.3.3

package/dist/bin/api-server.cjs

@@ -4098,9 +4098,9 @@ async function extractBrandingFromPage(page) {
     colors: {
       primary: primary && !isTransparentOrWhite(primary) ? primary : null,
       accent: accent && !isTransparentOrWhite(accent) ? accent : null,
-      background: background && !isTransparentOrWhite(background) ? background : null,
-      text: text && text !== "#000000" ? text : null,
-      heading: heading && heading !== "#000000" ? heading : null
+      background: background ?? null,
+      text: text ?? null,
+      heading: heading ?? null
     },
     fonts: {
       body: firstFont(raw.bodyFont ?? ""),
@@ -4372,8 +4372,8 @@ async function downloadAsset(url, destDir, filename) {
   }
   const writer = (0, import_node_fs.createWriteStream)(dest);
   await (0, import_promises2.pipeline)(import_node_stream.Readable.fromWeb(res.body), writer);
-  const { statSync: statSync2 } = await import("fs");
-  const sizeBytes = statSync2(dest).size;
+  const { statSync: statSync3 } = await import("fs");
+  const sizeBytes = statSync3(dest).size;
   return { savedPath: dest, sizeBytes, mimeType };
 }
 async function harvestPageMedia(html, pageUrl, options = {}) {
@@ -8590,8 +8590,8 @@ var init_site_audit_middleware = __esm({
 
 // src/api/site-audit-routes.ts
 function isPathInside(root, target) {
-  const relative = import_node_path2.default.relative(root, target);
-  return relative === "" || !relative.startsWith("..") && !import_node_path2.default.isAbsolute(relative);
+  const relative2 = import_node_path2.default.relative(root, target);
+  return relative2 === "" || !relative2.startsWith("..") && !import_node_path2.default.isAbsolute(relative2);
 }
 var import_node_path2, import_node_os2, import_hono, import_zod11, siteAuditApp;
 var init_site_audit_routes = __esm({
@@ -8827,6 +8827,9 @@ var init_rates = __esm({
       maps_review: 50,
       fb_search: 50,
       fb_transcribe: 50,
+      instagram_profile: 100,
+      instagram_media: 100,
+      instagram_transcribe: 50,
       browser_minute: 4e3
     };
     MC_PER_BROWSER_MS = MC_COSTS.browser_minute / 6e4;
@@ -8927,6 +8930,30 @@ var init_rates = __esm({
         unit: "per call",
         notes: "Whisper transcription of Facebook ad video via fal.ai."
       },
+      {
+        key: "instagram_profile",
+        label: "Instagram profile content discovery",
+        aliases: ["instagram_profile_content", "instagram profile", "instagram content list", "ig profile"],
+        credits: mcToCredits(MC_COSTS.instagram_profile),
+        unit: "per profile scan",
+        notes: "Browser extraction of public Instagram profile grid links. Complete history may require a logged-in profile."
+      },
+      {
+        key: "instagram_media",
+        label: "Instagram media download",
+        aliases: ["instagram_media_download", "instagram reel download", "instagram post download", "ig media"],
+        credits: mcToCredits(MC_COSTS.instagram_media),
+        unit: "per post or reel",
+        notes: "Extracts post text, image URLs, and reel audio/video tracks, with local downloads when the server can write files."
+      },
+      {
+        key: "instagram_transcribe",
+        label: "Instagram media transcription",
+        aliases: ["instagram transcript", "instagram reel transcript", "ig transcribe"],
+        credits: mcToCredits(MC_COSTS.instagram_transcribe),
+        unit: "per call",
+        notes: "Whisper transcription of selected Instagram audio/video media via fal.ai."
+      },
       {
         key: "browser_minute",
         label: "Interactive browser session",
@@ -8985,6 +9012,12 @@ var init_rates = __esm({
       FB_TRANSCRIBE: "fb_transcribe",
       FB_SEARCH_REFUND: "fb_search_refund",
       FB_TRANSCRIBE_REFUND: "fb_transcribe_refund",
+      INSTAGRAM_PROFILE: "instagram_profile",
+      INSTAGRAM_PROFILE_REFUND: "instagram_profile_refund",
+      INSTAGRAM_MEDIA: "instagram_media",
+      INSTAGRAM_MEDIA_REFUND: "instagram_media_refund",
+      INSTAGRAM_TRANSCRIBE: "instagram_transcribe",
+      INSTAGRAM_TRANSCRIBE_REFUND: "instagram_transcribe_refund",
       BROWSER_SESSION: "browser_session"
     };
   }
@@ -9297,7 +9330,9 @@ var init_BrowserDriver = __esm({
         }
         const launchOpts = {
           headless: config.headless,
-          proxy: config.proxy ? { server: config.proxy } : void 0
+          proxy: config.proxy ? { server: config.proxy } : void 0,
+          ...config.browserExecutablePath ? { executablePath: config.browserExecutablePath } : {},
+          ...config.ignoreDefaultArgs ? { ignoreDefaultArgs: config.ignoreDefaultArgs } : {}
         };
         const ctxOpts = rankCheckContextOptions(config);
         if (config.profileDir) {
@@ -10283,8 +10318,8 @@ async function fetchViaKernelInnertube(videoId) {
       const tracks = data?.captions?.playerCaptionsTracklistRenderer?.captionTracks ?? [];
       if (tracks.length === 0) return null;
       const track = tracks.find((t) => t.languageCode === "en") ?? tracks[0];
-      const sep = track.baseUrl.includes("?") ? "&" : "?";
-      const xmlResp = await fetch(`${track.baseUrl}${sep}fmt=json3`);
+      const sep2 = track.baseUrl.includes("?") ? "&" : "?";
+      const xmlResp = await fetch(`${track.baseUrl}${sep2}fmt=json3`);
       return xmlResp.ok ? xmlResp.text() : null;
     }, videoId);
     if (!xml) return null;
@@ -12492,15 +12527,8 @@ var init_schemas3 = __esm({
   }
 });
 
-// src/api/facebook-ad-routes.ts
-function invalidRequest(message) {
-  return { error_code: "invalid_request", message };
-}
-function isAllowedFacebookOrganicUrl(url) {
-  const hostname = url.hostname.toLowerCase().replace(/^www\./, "").replace(/^m\./, "");
-  return hostname === "facebook.com" || hostname === "fb.watch";
-}
-function facebookTranscriptMarkdown(title, text, chunks, durationMs) {
+// src/services/media-transcription.ts
+function transcriptMarkdown(title, text, chunks, durationMs) {
   const fmtTs2 = (s) => `${Math.floor(s / 60)}:${String(Math.floor(s % 60)).padStart(2, "0")}`;
   const lines = [title, "", `*Transcribed in ${(durationMs / 1e3).toFixed(1)}s*`, "", "## Full Text", "", text, ""];
   if (chunks.length) {
@@ -12511,10 +12539,10 @@ function facebookTranscriptMarkdown(title, text, chunks, durationMs) {
   }
   return lines.join("\n");
 }
-async function transcribeFacebookVideoUrl(videoUrl, markdownTitle = "# Facebook Video Transcript") {
+async function transcribeMediaUrl(mediaUrl, markdownTitle = "# Media Transcript") {
   const startMs = Date.now();
   const result = await import_client3.fal.subscribe("fal-ai/wizper", {
-    input: { audio_url: videoUrl, task: "transcribe", language: "en" },
+    input: { audio_url: mediaUrl, task: "transcribe", language: "en" },
     logs: false,
     pollInterval: 3e3
   });
@@ -12526,9 +12554,28 @@ async function transcribeFacebookVideoUrl(videoUrl, markdownTitle = "# Facebook
     text,
     chunks,
     durationMs,
-    markdown: facebookTranscriptMarkdown(markdownTitle, text, chunks, durationMs)
+    markdown: transcriptMarkdown(markdownTitle, text, chunks, durationMs)
   };
 }
+var import_client3;
+var init_media_transcription = __esm({
+  "src/services/media-transcription.ts"() {
+    "use strict";
+    import_client3 = require("@fal-ai/client");
+  }
+});
+
+// src/api/facebook-ad-routes.ts
+function invalidRequest(message) {
+  return { error_code: "invalid_request", message };
+}
+function isAllowedFacebookOrganicUrl(url) {
+  const hostname = url.hostname.toLowerCase().replace(/^www\./, "").replace(/^m\./, "");
+  return hostname === "facebook.com" || hostname === "fb.watch";
+}
+async function transcribeFacebookVideoUrl(videoUrl, markdownTitle = "# Facebook Video Transcript") {
+  return transcribeMediaUrl(videoUrl, markdownTitle);
+}
 async function detectSoftBlock(driver) {
   const page = driver.getPage();
   const bodyText = await page.evaluate(() => document.body?.innerText ?? "").catch(() => "");
@@ -12557,7 +12604,7 @@ async function kernelLaunchOptsResidential() {
   }
   return { headless: true, kernelApiKey: browserServiceApiKey(), kernelProxyId: proxyId, viewport: { width: 1280, height: 900 }, locale: "en-US" };
 }
-var import_hono4, import_zod16, import_client3, FacebookAdBodySchema, FacebookPageIntelBodySchema, FacebookTranscribeBodySchema, FacebookVideoTranscribeBodySchema, FacebookSearchBodySchema, FacebookMediaBodySchema, facebookAdApp, ALLOWED_MEDIA_HOSTS;
+var import_hono4, import_zod16, import_client4, FacebookAdBodySchema, FacebookPageIntelBodySchema, FacebookTranscribeBodySchema, FacebookVideoTranscribeBodySchema, FacebookSearchBodySchema, FacebookMediaBodySchema, facebookAdApp, ALLOWED_MEDIA_HOSTS;
 var init_facebook_ad_routes = __esm({
   "src/api/facebook-ad-routes.ts"() {
     "use strict";
@@ -12572,10 +12619,11 @@ var init_facebook_ad_routes = __esm({
     init_FacebookOrganicVideoExtractor();
     init_kernel_proxy_resolver();
     init_schemas3();
-    import_client3 = require("@fal-ai/client");
+    import_client4 = require("@fal-ai/client");
     init_api_auth();
     init_url_utils();
     init_concurrency_gates();
+    init_media_transcription();
     FacebookAdBodySchema = import_zod16.z.object({
       url: import_zod16.z.string().trim().optional(),
       libraryId: import_zod16.z.string().trim().optional(),
@@ -12714,7 +12762,7 @@ var init_facebook_ad_routes = __esm({
         metadata: { videoUrl }
       });
       if (!gate.ok) return c.json(concurrencyLimitExceededResponse(gate), 429, { "Retry-After": String(gate.retryAfterSeconds) });
-      import_client3.fal.config({ credentials: process.env.FAL_KEY });
+      import_client4.fal.config({ credentials: process.env.FAL_KEY });
       let debited = false;
       try {
         const { ok, balance_mc } = await debitMc(fbUser.id, MC_COSTS.fb_transcribe, LedgerOperation.FB_TRANSCRIBE, videoUrl);
@@ -12753,7 +12801,7 @@ var init_facebook_ad_routes = __esm({
         metadata: { url: sourceUrl.href }
       });
       if (!gate.ok) return c.json(concurrencyLimitExceededResponse(gate), 429, { "Retry-After": String(gate.retryAfterSeconds) });
-      import_client3.fal.config({ credentials: process.env.FAL_KEY });
+      import_client4.fal.config({ credentials: process.env.FAL_KEY });
       const driver = new BrowserDriver();
       let debited = false;
       try {
@@ -12930,6 +12978,824 @@ var init_facebook_ad_routes = __esm({
   }
 });
 
+// src/lib/chrome-profiles.ts
+function recommendedKernelProfileName(value) {
+  return value.trim().toLowerCase().replace(/@/g, "-").replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 80) || "browser-profile";
+}
+var import_promises4, import_node_os3, import_node_path5;
+var init_chrome_profiles = __esm({
+  "src/lib/chrome-profiles.ts"() {
+    "use strict";
+    import_promises4 = require("fs/promises");
+    import_node_os3 = require("os");
+    import_node_path5 = require("path");
+  }
+});
+
+// src/lib/local-browser-profiles.ts
+function defaultImportedBrowserProfilesDir() {
+  return process.env.MCP_SCRAPER_BROWSER_PROFILE_BASE_DIR?.trim() || (0, import_node_path6.join)((0, import_node_os4.homedir)(), ".mcp-scraper", "browser-profiles");
+}
+function defaultChromeExecutablePath() {
+  const envPath = process.env.MCP_SCRAPER_BROWSER_EXECUTABLE?.trim() || process.env.CHROME_PATH?.trim();
+  if (envPath) return envPath;
+  const candidates = process.platform === "darwin" ? ["/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"] : process.platform === "win32" ? [
+    (0, import_node_path6.join)(process.env.PROGRAMFILES ?? "C:\\Program Files", "Google", "Chrome", "Application", "chrome.exe"),
+    (0, import_node_path6.join)(process.env["PROGRAMFILES(X86)"] ?? "C:\\Program Files (x86)", "Google", "Chrome", "Application", "chrome.exe")
+  ] : ["/usr/bin/google-chrome", "/usr/bin/google-chrome-stable", "/usr/bin/chromium-browser", "/usr/bin/chromium"];
+  return candidates.find((candidate) => (0, import_node_fs3.existsSync)(candidate));
+}
+function localBrowserModeEnabled() {
+  return process.env.MCP_SCRAPER_BROWSER_MODE?.trim().toLowerCase() === "local";
+}
+function importedProfileName(value) {
+  return recommendedKernelProfileName(value);
+}
+function importedProfileRoot(name, outputDir = defaultImportedBrowserProfilesDir()) {
+  return (0, import_node_path6.join)(outputDir, importedProfileName(name));
+}
+function importedProfileManifestPath(name, outputDir = defaultImportedBrowserProfilesDir()) {
+  return (0, import_node_path6.join)(importedProfileRoot(name, outputDir), "manifest.json");
+}
+async function readExistingManifest(path6) {
+  try {
+    return JSON.parse(await (0, import_promises5.readFile)(path6, "utf8"));
+  } catch {
+    return null;
+  }
+}
+async function loadImportedBrowserProfile(name = process.env.MCP_SCRAPER_BROWSER_PROFILE?.trim() || "default", outputDir = defaultImportedBrowserProfilesDir()) {
+  const profileName = importedProfileName(name);
+  const manifestPath = importedProfileManifestPath(profileName, outputDir);
+  const manifest = await readExistingManifest(manifestPath);
+  if (!manifest) {
+    throw new Error(
+      `Imported browser profile "${profileName}" was not found. Run: mcp-scraper-cli browser import-chrome --name ${profileName}`
+    );
+  }
+  return manifest;
+}
+var import_node_fs3, import_promises5, import_node_os4, import_node_path6;
+var init_local_browser_profiles = __esm({
+  "src/lib/local-browser-profiles.ts"() {
+    "use strict";
+    import_node_fs3 = require("fs");
+    import_promises5 = require("fs/promises");
+    import_node_os4 = require("os");
+    import_node_path6 = require("path");
+    init_chrome_profiles();
+  }
+});
+
+// src/extractor/InstagramContentExtractor.ts
+function htmlDecode2(value) {
+  return value.replace(/&amp;/g, "&").replace(/&quot;/g, '"').replace(/&#039;/g, "'").replace(/&lt;/g, "<").replace(/&gt;/g, ">");
+}
+function decodeEscapedValue2(raw) {
+  let out = raw;
+  try {
+    out = JSON.parse(`"${raw.replace(/"/g, '\\"')}"`);
+  } catch {
+    out = raw.replace(/\\u0025/g, "%").replace(/\\u0026/g, "&").replace(/\\u003D/g, "=").replace(/\\u003d/g, "=").replace(/\\"/g, '"').replace(/\\\//g, "/");
+  }
+  return htmlDecode2(out);
+}
+function metadataContent2(html, key) {
+  const escaped = key.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  const re = new RegExp(`<meta\\s+[^>]*(?:property|name)=["']${escaped}["'][^>]*content=["']([^"']+)["'][^>]*>`, "i");
+  const m = html.match(re);
+  return m ? htmlDecode2(m[1]).trim() : null;
+}
+function instagramContentTypeFromPath(rawPath) {
+  const match = rawPath.match(CONTENT_PATH_RE);
+  if (!match) return null;
+  const type = match[1].toLowerCase() === "p" ? "post" : match[1].toLowerCase();
+  return { type, shortcode: match[2] };
+}
+function normalizeInstagramProfileInput(input) {
+  const raw = input.trim();
+  if (!raw) throw new Error("Instagram handle or profile URL is required");
+  if (/^https?:\/\//i.test(raw) || /^www\.instagram\.com/i.test(raw) || /^instagram\.com/i.test(raw)) {
+    const parsed = new URL(/^https?:\/\//i.test(raw) ? raw : `https://${raw}`);
+    const host = parsed.hostname.toLowerCase().replace(/^www\./, "").replace(/^m\./, "");
+    if (host !== "instagram.com") throw new Error("Profile URL must be on instagram.com");
+    const first = parsed.pathname.split("/").filter(Boolean)[0];
+    if (!first || ["p", "reel", "tv", "stories", "explore"].includes(first.toLowerCase())) {
+      throw new Error("Profile URL must point to an Instagram profile, not a post, reel, story, or explore page");
+    }
+    return { handle: first, profileUrl: `https://www.instagram.com/${first}/` };
+  }
+  const handle = raw.replace(/^@/, "").replace(/^\/+|\/+$/g, "");
+  if (!/^[A-Za-z0-9._]{1,30}$/.test(handle)) throw new Error("Invalid Instagram handle");
+  return { handle, profileUrl: `https://www.instagram.com/${handle}/` };
+}
+function isAllowedInstagramPageUrl(url) {
+  const host = url.hostname.toLowerCase().replace(/^www\./, "").replace(/^m\./, "");
+  return host === "instagram.com";
+}
+function normalizeInstagramMediaUrl(raw) {
+  try {
+    const decoded = decodeEscapedValue2(raw);
+    const parsed = new URL(decoded);
+    if (!CDN_HOST_RE.test(parsed.hostname.toLowerCase())) return null;
+    parsed.searchParams.delete("bytestart");
+    parsed.searchParams.delete("byteend");
+    return parsed.href;
+  } catch {
+    return null;
+  }
+}
+function parseInstagramEfg(url) {
+  try {
+    const efg = new URL(url).searchParams.get("efg");
+    if (!efg) return null;
+    return JSON.parse(Buffer.from(efg, "base64").toString("utf8"));
+  } catch {
+    return null;
+  }
+}
+function trackFromUrl(url) {
+  const normalized = normalizeInstagramMediaUrl(url);
+  if (!normalized) return null;
+  const parsed = parseInstagramEfg(normalized);
+  const tag = typeof parsed?.vencode_tag === "string" ? parsed.vencode_tag : null;
+  const streamType = tag?.toLowerCase().includes("audio") ? "audio" : normalized.includes(".mp4") ? "video" : "unknown";
+  return {
+    url: normalized,
+    streamType,
+    bitrate: typeof parsed?.bitrate === "number" ? parsed.bitrate : null,
+    durationSec: typeof parsed?.duration_s === "number" ? parsed.duration_s : null,
+    vencodeTag: tag,
+    width: typeof parsed?.width === "number" ? parsed.width : null,
+    height: typeof parsed?.height === "number" ? parsed.height : null
+  };
+}
+function extractInstagramMp4UrlsFromText(text) {
+  const urls = [];
+  const seen = /* @__PURE__ */ new Set();
+  const patterns = [
+    /https?:\\?\/\\?\/[^"'<>\s]+?\.mp4(?:\?[^"'<>\s]+)?/g,
+    /https?:%5C?\/%5C?\/[^"'<>\s]+?\.mp4(?:\?[^"'<>\s]+)?/g
+  ];
+  for (const pattern of patterns) {
+    let match;
+    while ((match = pattern.exec(text)) !== null) {
+      const normalized = normalizeInstagramMediaUrl(match[0].replace(/%5C/gi, "\\"));
+      if (!normalized || seen.has(normalized)) continue;
+      seen.add(normalized);
+      urls.push(normalized);
+    }
+  }
+  return urls;
+}
+function instagramTracksFromUrls(urls) {
+  const seen = /* @__PURE__ */ new Set();
+  const tracks = [];
+  for (const raw of urls) {
+    const track = trackFromUrl(raw);
+    if (!track || seen.has(track.url)) continue;
+    seen.add(track.url);
+    tracks.push(track);
+  }
+  return tracks;
+}
+function selectInstagramTracks(tracks) {
+  const selectedVideoTrack = tracks.filter((track) => track.streamType === "video").sort((a, b) => {
+    const aPixels = (a.width ?? 0) * (a.height ?? 0);
+    const bPixels = (b.width ?? 0) * (b.height ?? 0);
+    if (aPixels !== bPixels) return bPixels - aPixels;
+    return (b.bitrate ?? 0) - (a.bitrate ?? 0);
+  })[0] ?? null;
+  const selectedAudioTrack = tracks.filter((track) => track.streamType === "audio").sort((a, b) => (b.bitrate ?? 0) - (a.bitrate ?? 0))[0] ?? null;
+  return { selectedVideoTrack, selectedAudioTrack };
+}
+function parseCount(text) {
+  if (!text) return null;
+  const match = text.match(/([\d,.]+)\s*posts?/i);
+  if (!match) return null;
+  const value = Number(match[1].replace(/[,.]/g, ""));
+  return Number.isFinite(value) ? value : null;
+}
+function captionFromMetadata(metadata) {
+  const raw = metadata.ogDescription ?? metadata.description;
+  if (!raw) return null;
+  const quoted = raw.match(/:\s*"([\s\S]+)"\.?\s*$/);
+  if (quoted?.[1]) return quoted[1].trim();
+  return raw.trim();
+}
+function ownerFromMetadata(metadata) {
+  const title = metadata.ogTitle ?? metadata.twitterTitle ?? metadata.title;
+  if (!title) return null;
+  const match = title.match(/^(.+?)\s+on Instagram:/i) ?? title.match(/^(.+?)\s+\(@[^)]+\)\s+•\s+Instagram/i);
+  return match?.[1]?.trim() || null;
+}
+async function collectInstagramProfileContentFromPage(page, opts) {
+  const maxItems = Math.min(500, Math.max(1, opts.maxItems ?? 50));
+  const maxScrolls = Math.min(100, Math.max(0, opts.maxScrolls ?? 10));
+  const scrollDelayMs = Math.min(5e3, Math.max(250, opts.scrollDelayMs ?? 1200));
+  const stableScrollLimit = Math.min(10, Math.max(1, opts.stableScrollLimit ?? 4));
+  const seen = /* @__PURE__ */ new Set();
+  const items = [];
+  const stages = [];
+  let attemptedScrolls = 0;
+  let stableScrolls = 0;
+  let stoppedReason = null;
+  const collect = async (stage) => {
+    const before = items.length;
+    const links = await page.evaluate(() => Array.from(document.querySelectorAll("a[href]")).map((a) => ({
+      href: a.href,
+      text: (a.textContent ?? "").replace(/\s+/g, " ").trim()
+    })));
+    for (const link of links) {
+      let parsed;
+      try {
+        parsed = new URL(link.href);
+      } catch {
+        continue;
+      }
+      const found = instagramContentTypeFromPath(parsed.pathname);
+      if (!found) continue;
+      const normalized = `https://www.instagram.com/${found.type === "post" ? "p" : found.type}/${found.shortcode}/`;
+      if (seen.has(normalized)) continue;
+      seen.add(normalized);
+      items.push({
+        url: normalized,
+        type: found.type,
+        shortcode: found.shortcode,
+        anchorText: link.text || null,
+        firstSeenStage: stage
+      });
+      if (items.length >= maxItems) return items.length - before;
+    }
+    return items.length - before;
+  };
+  const readBodyText = async () => page.evaluate(() => document.body?.innerText ?? "").catch(() => "");
+  const profileLines = (text) => text.split("\n").map((line) => line.trim()).filter(Boolean);
+  const profilePostCountText = (text) => profileLines(text).find((line) => /\bposts?\b/i.test(line) && /[\d,.]/.test(line)) ?? null;
+  const scrollMetrics = async () => page.evaluate(() => ({
+    scrollY: typeof window.scrollY === "number" ? window.scrollY : null,
+    scrollHeight: Math.max(
+      document.body?.scrollHeight ?? 0,
+      document.documentElement?.scrollHeight ?? 0
+    ) || null
+  })).catch(() => ({ scrollY: null, scrollHeight: null }));
+  const recordStage = async (stage, addedCount) => {
+    const metrics = await scrollMetrics();
+    stages.push({
+      stage,
+      itemCount: items.length,
+      addedCount,
+      scrollY: metrics.scrollY,
+      scrollHeight: metrics.scrollHeight
+    });
+  };
+  const advancePagination = async () => page.evaluate(() => {
+    const contentLinks = Array.from(document.querySelectorAll('a[href*="/p/"], a[href*="/reel/"], a[href*="/tv/"]'));
+    const last = contentLinks[contentLinks.length - 1];
+    if (last) last.scrollIntoView({ block: "end", inline: "nearest" });
+    const distance = Math.max(window.innerHeight * 0.9, 700);
+    window.scrollBy(0, distance);
+    return {
+      scrollY: typeof window.scrollY === "number" ? window.scrollY : null,
+      scrollHeight: Math.max(
+        document.body?.scrollHeight ?? 0,
+        document.documentElement?.scrollHeight ?? 0
+      ) || null
+    };
+  }).catch(() => ({ scrollY: null, scrollHeight: null }));
+  await page.waitForLoadState("domcontentloaded", { timeout: 15e3 }).catch(() => {
+  });
+  await page.waitForTimeout(1500);
+  await recordStage("initial", await collect("initial"));
+  const initialReportedPostCount = parseCount(profilePostCountText(await readBodyText()));
+  for (let i = 0; i < maxScrolls && items.length < maxItems && stableScrolls < stableScrollLimit; i++) {
+    const before = items.length;
+    const beforeMetrics = await scrollMetrics();
+    attemptedScrolls = i + 1;
+    await advancePagination();
+    await page.keyboard.press("PageDown").catch(() => {
+    });
+    await page.waitForLoadState("networkidle", { timeout: 2500 }).catch(() => {
+    });
+    await page.waitForTimeout(scrollDelayMs);
+    const added = await collect(`scroll_${i + 1}`);
+    await recordStage(`scroll_${i + 1}`, added);
+    const afterMetrics = await scrollMetrics();
+    const advanced = (afterMetrics.scrollHeight ?? 0) > (beforeMetrics.scrollHeight ?? 0) || (afterMetrics.scrollY ?? 0) > (beforeMetrics.scrollY ?? 0);
+    stableScrolls = items.length === before && !advanced ? stableScrolls + 1 : 0;
+    if (initialReportedPostCount != null && items.length >= initialReportedPostCount) {
+      stoppedReason = "reported_post_count";
+      break;
+    }
+    if (items.length >= maxItems) {
+      stoppedReason = "max_items";
+      break;
+    }
+    if (stableScrolls >= stableScrollLimit) {
+      stoppedReason = "stable_scrolls";
+      break;
+    }
+  }
+  const bodyText = await readBodyText();
+  const lines = profileLines(bodyText);
+  const reportedPostCountText = lines.find((line) => /\bposts?\b/i.test(line) && /[\d,.]/.test(line)) ?? null;
+  const followerCountText = lines.find((line) => /\bfollowers?\b/i.test(line)) ?? null;
+  const followingCountText = lines.find((line) => /\bfollowing\b/i.test(line)) ?? null;
+  const profileName = lines.find((line) => line && line.toLowerCase() !== opts.handle.toLowerCase()) ?? null;
+  const typeCounts = {
+    post: items.filter((item) => item.type === "post").length,
+    reel: items.filter((item) => item.type === "reel").length,
+    tv: items.filter((item) => item.type === "tv").length
+  };
+  const reportedPostCount = parseCount(reportedPostCountText);
+  const reachedMaxItems = items.length >= maxItems;
+  const reachedReportedPostCount = reportedPostCount != null && items.length >= reportedPostCount;
+  if (!stoppedReason) {
+    stoppedReason = reachedMaxItems ? "max_items" : reachedReportedPostCount ? "reported_post_count" : maxScrolls === 0 ? "no_scrolls" : attemptedScrolls >= maxScrolls ? "max_scrolls" : "stable_scrolls";
+  }
+  const finalMetrics = await scrollMetrics();
+  const pagination = {
+    maxItems,
+    maxScrolls,
+    attemptedScrolls,
+    stableScrolls,
+    stableScrollLimit,
+    scrollDelayMs,
+    reachedMaxItems,
+    reachedReportedPostCount,
+    finalScrollHeight: finalMetrics.scrollHeight,
+    stoppedReason,
+    stages
+  };
+  const limitations = [];
+  if (/log in|sign up/i.test(bodyText)) limitations.push("Login or sign-up prompts were visible during extraction.");
+  if (reachedMaxItems && !reachedReportedPostCount) limitations.push("Collection stopped at maxItems before the full profile history was proven.");
+  if (reportedPostCount != null && items.length < reportedPostCount && !reachedMaxItems) limitations.push("Collected item count is lower than the profile-reported post count.");
+  if (stoppedReason === "stable_scrolls" && !reachedReportedPostCount) limitations.push("Pagination stopped after repeated stable scrolls without new content.");
+  if (stoppedReason === "max_scrolls" && !reachedReportedPostCount) limitations.push("Pagination reached maxScrolls before the full profile history was proven.");
+  return {
+    handle: opts.handle,
+    profileUrl: opts.profileUrl,
+    pageUrl: page.url(),
+    profileName,
+    bio: null,
+    reportedPostCount,
+    reportedPostCountText,
+    followerCountText,
+    followingCountText,
+    collectedContentCount: items.length,
+    typeCounts,
+    pagination,
+    items,
+    limited: limitations.length > 0,
+    limitations,
+    extractedAt: (/* @__PURE__ */ new Date()).toISOString()
+  };
+}
+async function extractInstagramMediaFromPage(page, sourceUrl, capturedMediaUrls = []) {
+  await page.waitForLoadState("domcontentloaded", { timeout: 15e3 }).catch(() => {
+  });
+  await page.waitForTimeout(2500);
+  const html = await page.content();
+  const bodyText = await page.evaluate(() => document.body?.innerText ?? "").catch(() => "");
+  const metadata = {
+    title: await page.title().catch(() => null),
+    description: metadataContent2(html, "description"),
+    ogTitle: metadataContent2(html, "og:title"),
+    ogDescription: metadataContent2(html, "og:description"),
+    ogImage: metadataContent2(html, "og:image"),
+    ogUrl: metadataContent2(html, "og:url"),
+    twitterImage: metadataContent2(html, "twitter:image"),
+    twitterTitle: metadataContent2(html, "twitter:title")
+  };
+  const parsedPath = (() => {
+    try {
+      return instagramContentTypeFromPath(new URL(page.url()).pathname) ?? instagramContentTypeFromPath(new URL(sourceUrl).pathname);
+    } catch {
+      return null;
+    }
+  })();
+  const htmlUrls = extractInstagramMp4UrlsFromText(html);
+  const tracks = instagramTracksFromUrls([...capturedMediaUrls, ...htmlUrls]);
+  const selected = selectInstagramTracks(tracks);
+  const imageUrl = metadata.ogImage ?? metadata.twitterImage;
+  const limitations = [];
+  if (/log in|sign up/i.test(bodyText)) limitations.push("Login or sign-up prompts were visible during extraction.");
+  if (parsedPath?.type === "reel" && tracks.length === 0) limitations.push("No Instagram MP4 tracks were captured; retry with a logged-in browser profile or longer wait.");
+  return {
+    sourceUrl,
+    pageUrl: page.url(),
+    type: parsedPath?.type ?? null,
+    shortcode: parsedPath?.shortcode ?? null,
+    ownerName: ownerFromMetadata(metadata),
+    caption: captionFromMetadata(metadata),
+    bodyText,
+    metadata,
+    imageUrl,
+    tracks,
+    selectedVideoTrack: selected.selectedVideoTrack,
+    selectedAudioTrack: selected.selectedAudioTrack,
+    limitations,
+    extractedAt: (/* @__PURE__ */ new Date()).toISOString()
+  };
+}
+var CONTENT_PATH_RE, CDN_HOST_RE;
+var init_InstagramContentExtractor = __esm({
+  "src/extractor/InstagramContentExtractor.ts"() {
+    "use strict";
+    CONTENT_PATH_RE = /^\/(?:[^/]+\/)?(p|reel|tv)\/([A-Za-z0-9_-]+)\/?/i;
+    CDN_HOST_RE = /(^|\.)((cdninstagram\.com)|(scontent[^/]*\.cdninstagram\.com))$/i;
+  }
+});
+
+// src/api/instagram-routes.ts
+function invalidRequest2(message) {
+  return { error_code: "invalid_request", message };
+}
+function directProfileDir() {
+  return process.env.MCP_SCRAPER_BROWSER_PROFILE_DIR?.trim() || void 0;
+}
+function configuredProfileName(profile) {
+  const directDir = directProfileDir();
+  return profile?.trim() || process.env.MCP_SCRAPER_BROWSER_PROFILE?.trim() || (directDir ? (0, import_node_path7.basename)(directDir) : "default");
+}
+function launchExecutablePath(manifestExecutablePath) {
+  const configured = process.env.MCP_SCRAPER_BROWSER_EXECUTABLE?.trim() || manifestExecutablePath || defaultChromeExecutablePath();
+  return configured && (0, import_node_fs4.existsSync)(configured) ? configured : void 0;
+}
+function ignoreDefaultArgsFor(executablePath) {
+  if (!executablePath) return void 0;
+  if (process.platform !== "darwin") return void 0;
+  if (!/Google Chrome\.app\/Contents\/MacOS\/Google Chrome$/.test(executablePath)) return void 0;
+  return ["--password-store=basic", "--use-mock-keychain"];
+}
+async function kernelLaunchOptsResidential2() {
+  let proxyId = browserServiceProxyId();
+  try {
+    const resolution2 = await resolveKernelProxyId({
+      kernelApiKey: browserServiceApiKey(),
+      proxyMode: DEFAULT_PROXY_MODE,
+      configuredKernelProxyId: browserServiceProxyId(),
+      gl: "us"
+    });
+    if (resolution2.kernelProxyId) proxyId = resolution2.kernelProxyId;
+  } catch {
+    proxyId = browserServiceProxyId();
+  }
+  return {
+    headless: true,
+    kernelApiKey: browserServiceApiKey(),
+    kernelProxyId: proxyId,
+    viewport: { width: 1280, height: 900 },
+    locale: "en-US"
+  };
+}
+async function resolveInstagramLaunch(input) {
+  const requestedMode = input.browserMode ?? "auto";
+  const directDir = directProfileDir();
+  const useLocal = requestedMode === "local" || requestedMode === "auto" && (Boolean(input.browserProfile) || Boolean(directDir) || localBrowserModeEnabled());
+  if (!useLocal) {
+    return {
+      config: await kernelLaunchOptsResidential2(),
+      browser: {
+        mode: "hosted",
+        requestedMode,
+        profileName: null,
+        profileSource: "hosted",
+        profileDirConfigured: false,
+        executablePathConfigured: false
+      }
+    };
+  }
+  const requestedName = configuredProfileName(input.browserProfile);
+  if (directDir && (!input.browserProfile || requestedName === process.env.MCP_SCRAPER_BROWSER_PROFILE?.trim())) {
+    const executablePath2 = launchExecutablePath(null);
+    return {
+      config: {
+        headless: false,
+        profileDir: directDir,
+        browserExecutablePath: executablePath2,
+        ignoreDefaultArgs: ignoreDefaultArgsFor(executablePath2),
+        viewport: { width: 1280, height: 900 },
+        locale: "en-US"
+      },
+      browser: {
+        mode: "local",
+        requestedMode,
+        profileName: requestedName,
+        profileSource: "direct_profile_dir",
+        profileDirConfigured: true,
+        executablePathConfigured: Boolean(executablePath2)
+      }
+    };
+  }
+  const manifest = await loadImportedBrowserProfile(requestedName);
+  const executablePath = launchExecutablePath(manifest.browserExecutablePath);
+  return {
+    config: {
+      headless: false,
+      profileDir: manifest.userDataDir,
+      browserExecutablePath: executablePath,
+      ignoreDefaultArgs: ignoreDefaultArgsFor(executablePath),
+      viewport: { width: 1280, height: 900 },
+      locale: "en-US"
+    },
+    browser: {
+      mode: "local",
+      requestedMode,
+      profileName: manifest.name,
+      profileSource: "managed_profile",
+      profileDirConfigured: true,
+      executablePathConfigured: Boolean(executablePath)
+    }
+  };
+}
+function outputBaseDir() {
+  return process.env.MCP_SCRAPER_OUTPUT_DIR?.trim() || (0, import_node_path7.join)((0, import_node_os5.homedir)(), "Downloads", "mcp-scraper");
+}
+function safeFilePart(input) {
+  return input.replace(/^https?:\/\//, "").replace(/[^a-z0-9._-]+/gi, "-").replace(/^-+|-+$/g, "").slice(0, 80) || "instagram";
+}
+function mediaOutputDir(shortcode, sourceUrl) {
+  const stamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-").slice(0, 19);
+  const slug = shortcode ? `instagram-${shortcode}` : safeFilePart(sourceUrl);
+  const dir = (0, import_node_path7.join)(outputBaseDir(), "instagram", `${stamp}-${slug}`);
+  (0, import_node_fs4.mkdirSync)(dir, { recursive: true });
+  return dir;
+}
+async function downloadToFile(url, destPath, referer) {
+  const res = await fetch(url, {
+    headers: {
+      "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36",
+      "Referer": referer
+    },
+    signal: AbortSignal.timeout(9e4)
+  });
+  if (!res.ok) throw new Error(`HTTP ${res.status}`);
+  if (!res.body) throw new Error("Empty response body");
+  await (0, import_promises6.pipeline)(import_node_stream2.Readable.fromWeb(res.body), (0, import_node_fs4.createWriteStream)(destPath));
+  return {
+    savedPath: destPath,
+    sizeBytes: (0, import_node_fs4.statSync)(destPath).size,
+    mimeType: res.headers.get("content-type")?.split(";")[0]?.trim() ?? null
+  };
+}
+function extFromMime(mimeType, fallback) {
+  const map = {
+    "image/jpeg": "jpg",
+    "image/png": "png",
+    "image/webp": "webp",
+    "image/gif": "gif",
+    "video/mp4": "mp4",
+    "audio/mp4": "mp4",
+    "audio/aac": "aac"
+  };
+  return mimeType ? map[mimeType] ?? fallback : fallback;
+}
+function runFfmpegMux(videoPath, audioPath, outPath) {
+  return new Promise((resolve) => {
+    const child = (0, import_node_child_process2.spawn)("ffmpeg", ["-y", "-i", videoPath, "-i", audioPath, "-c", "copy", "-shortest", outPath], {
+      stdio: ["ignore", "ignore", "pipe"]
+    });
+    let stderr = "";
+    child.stderr.on("data", (chunk) => {
+      stderr += String(chunk);
+    });
+    child.on("error", (err) => resolve({ ok: false, error: err.message }));
+    child.on("close", (code) => resolve({ ok: code === 0, error: code === 0 ? null : stderr.trim() || `ffmpeg exited ${code}` }));
+  });
+}
+function trackFilename(track, index, shortcode) {
+  const label = shortcode ?? "instagram";
+  const type = track.streamType === "audio" ? "audio" : track.streamType === "video" ? "video" : "track";
+  const bitrate = track.bitrate ? `-${track.bitrate}` : "";
+  return `${label}-${type}-${index}${bitrate}.mp4`;
+}
+var import_hono5, import_zod17, import_node_fs4, import_node_os5, import_node_path7, import_node_stream2, import_promises6, import_node_child_process2, InstagramBrowserModeSchema, InstagramBrowserOptionsSchema, InstagramProfileContentBodySchema, InstagramMediaTypeSchema, InstagramMediaDownloadBodySchema, instagramApp;
+var init_instagram_routes = __esm({
+  "src/api/instagram-routes.ts"() {
+    "use strict";
+    import_hono5 = require("hono");
+    import_zod17 = require("zod");
+    import_node_fs4 = require("fs");
+    import_node_os5 = require("os");
+    import_node_path7 = require("path");
+    import_node_stream2 = require("stream");
+    import_promises6 = require("stream/promises");
+    import_node_child_process2 = require("child_process");
+    init_browser_service_env();
+    init_BrowserDriver();
+    init_kernel_proxy_resolver();
+    init_schemas3();
+    init_api_auth();
+    init_url_utils();
+    init_db();
+    init_rates();
+    init_concurrency_gates();
+    init_local_browser_profiles();
+    init_InstagramContentExtractor();
+    init_media_transcription();
+    InstagramBrowserModeSchema = import_zod17.z.enum(["auto", "hosted", "local"]);
+    InstagramBrowserOptionsSchema = {
+      browserMode: InstagramBrowserModeSchema.default("auto"),
+      browserProfile: import_zod17.z.string().trim().min(1).optional()
+    };
+    InstagramProfileContentBodySchema = import_zod17.z.object({
+      handle: import_zod17.z.string().trim().optional(),
+      url: import_zod17.z.string().trim().optional(),
+      maxItems: import_zod17.z.number().int().min(1).max(500).default(50),
+      maxScrolls: import_zod17.z.number().int().min(0).max(100).default(10),
+      scrollDelayMs: import_zod17.z.number().int().min(250).max(5e3).default(1200),
+      stableScrollLimit: import_zod17.z.number().int().min(1).max(10).default(4),
+      ...InstagramBrowserOptionsSchema
+    }).refine((d) => !!d.handle || !!d.url, {
+      message: "handle or url is required"
+    });
+    InstagramMediaTypeSchema = import_zod17.z.enum(["image", "video", "audio"]);
+    InstagramMediaDownloadBodySchema = import_zod17.z.object({
+      url: import_zod17.z.string().trim().min(1, "url is required"),
+      mediaTypes: import_zod17.z.array(InstagramMediaTypeSchema).default(["image", "video", "audio"]),
+      downloadMedia: import_zod17.z.boolean().default(true),
+      downloadAllTracks: import_zod17.z.boolean().default(false),
+      includeTranscript: import_zod17.z.boolean().default(false),
+      mux: import_zod17.z.boolean().default(true),
+      ...InstagramBrowserOptionsSchema
+    });
+    instagramApp = new import_hono5.Hono();
+    instagramApp.post("/profile-content", createApiKeyAuth(), async (c) => {
+      const raw = await c.req.json().catch(() => ({}));
+      const parsed = InstagramProfileContentBodySchema.safeParse(raw);
+      if (!parsed.success) return c.json(invalidRequest2(parsed.error.issues[0]?.message ?? "Invalid request"), 400);
+      const body = parsed.data;
+      let target;
+      try {
+        target = normalizeInstagramProfileInput(body.url ?? body.handle ?? "");
+      } catch (err) {
+        return c.json(invalidRequest2(err instanceof Error ? err.message : String(err)), 400);
+      }
+      const user = c.get("user");
+      const gate = await acquireConcurrencyGate(user, "instagram_profile_content", {
+        reuseLockId: c.req.header("x-mcp-scraper-concurrency-lock"),
+        metadata: { handle: target.handle }
+      });
+      if (!gate.ok) return c.json(concurrencyLimitExceededResponse(gate), 429, { "Retry-After": String(gate.retryAfterSeconds) });
+      const driver = new BrowserDriver();
+      let debited = false;
+      try {
+        const { ok, balance_mc } = await debitMc(user.id, MC_COSTS.instagram_profile, LedgerOperation.INSTAGRAM_PROFILE, target.profileUrl);
+        if (!ok) return c.json(insufficientBalanceResponse(balance_mc, MC_COSTS.instagram_profile), 402);
+        debited = true;
+        const launch = await resolveInstagramLaunch(body);
+        await driver.launch(launch.config);
+        await driver.navigateTo(target.profileUrl);
+        const page = driver.getPage();
+        const result = await collectInstagramProfileContentFromPage(page, {
+          ...target,
+          maxItems: body.maxItems,
+          maxScrolls: body.maxScrolls,
+          scrollDelayMs: body.scrollDelayMs,
+          stableScrollLimit: body.stableScrollLimit
+        });
+        const response = { ...result, browser: launch.browser };
+        await logRequestEvent({ userId: user.id, source: "instagram_profile_content", status: "done", query: target.profileUrl, resultCount: result.items.length, result: response });
+        return c.json(response);
+      } catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        if (debited) await creditMc(user.id, MC_COSTS.instagram_profile, LedgerOperation.INSTAGRAM_PROFILE_REFUND, "failed call");
+        await logRequestEvent({ userId: user.id, source: "instagram_profile_content", status: "failed", query: target.profileUrl, error: msg });
+        if (msg.toLowerCase().includes("blocked") || msg.toLowerCase().includes("captcha")) return c.json({ error: msg }, 503);
+        return c.json({ error: msg }, 500);
+      } finally {
+        await driver.close();
+        await releaseConcurrencyGate(gate.lockId);
+      }
+    });
+    instagramApp.post("/media-download", createApiKeyAuth(), async (c) => {
+      const raw = await c.req.json().catch(() => ({}));
+      const parsed = InstagramMediaDownloadBodySchema.safeParse(raw);
+      if (!parsed.success) return c.json(invalidRequest2(parsed.error.issues[0]?.message ?? "Invalid request"), 400);
+      const body = parsed.data;
+      const urlCheck = await validatePublicHttpUrl(body.url, { field: "url", requireHttps: false });
+      if (urlCheck.error) return c.json(invalidRequest2(urlCheck.error), 400);
+      const sourceUrl = urlCheck.parsed;
+      if (!isAllowedInstagramPageUrl(sourceUrl)) return c.json(invalidRequest2("url must be an Instagram post, reel, or tv URL"), 400);
+      const user = c.get("user");
+      const gate = await acquireConcurrencyGate(user, "instagram_media_download", {
+        reuseLockId: c.req.header("x-mcp-scraper-concurrency-lock"),
+        metadata: { url: sourceUrl.href }
+      });
+      if (!gate.ok) return c.json(concurrencyLimitExceededResponse(gate), 429, { "Retry-After": String(gate.retryAfterSeconds) });
+      const driver = new BrowserDriver();
+      let mediaDebited = false;
+      let transcriptDebited = false;
+      try {
+        const { ok, balance_mc } = await debitMc(user.id, MC_COSTS.instagram_media, LedgerOperation.INSTAGRAM_MEDIA, sourceUrl.href);
+        if (!ok) return c.json(insufficientBalanceResponse(balance_mc, MC_COSTS.instagram_media), 402);
+        mediaDebited = true;
+        const launch = await resolveInstagramLaunch(body);
+        await driver.launch(launch.config);
+        const page = driver.getPage();
+        const capturedMediaUrls = [];
+        page.on("response", (response) => {
+          const url = normalizeInstagramMediaUrl(response.url());
+          if (!url) return;
+          const headers = response.headers();
+          const contentType = headers["content-type"] ?? "";
+          if (contentType.includes("video/mp4") || url.includes(".mp4")) capturedMediaUrls.push(url);
+        });
+        await driver.navigateTo(sourceUrl.href);
+        const extraction = await extractInstagramMediaFromPage(page, sourceUrl.href, capturedMediaUrls);
+        const mediaTypes = new Set(body.mediaTypes);
+        const downloads = [];
+        const warnings = [];
+        let outputDir = null;
+        if (body.downloadMedia) {
+          outputDir = mediaOutputDir(extraction.shortcode, sourceUrl.href);
+          const textPath = (0, import_node_path7.join)(outputDir, `${extraction.shortcode ?? "instagram"}-text.txt`);
+          (0, import_node_fs4.writeFileSync)(textPath, [
+            `URL: ${extraction.pageUrl}`,
+            extraction.caption ? `Caption: ${extraction.caption}` : "",
+            "",
+            extraction.bodyText
+          ].filter(Boolean).join("\n"), "utf8");
+          downloads.push({ kind: "text", url: null, savedPath: textPath, sizeBytes: (0, import_node_fs4.statSync)(textPath).size, mimeType: "text/plain", error: null });
+          if (mediaTypes.has("image") && extraction.imageUrl) {
+            const imagePathBase = (0, import_node_path7.join)(outputDir, `${extraction.shortcode ?? "instagram"}-image`);
+            try {
+              const downloaded = await downloadToFile(extraction.imageUrl, imagePathBase, extraction.pageUrl);
+              const ext = extFromMime(downloaded.mimeType, "jpg");
+              const finalPath = downloaded.savedPath.endsWith(`.${ext}`) ? downloaded.savedPath : `${downloaded.savedPath}.${ext}`;
+              if (finalPath !== downloaded.savedPath) {
+                const { renameSync } = await import("fs");
+                renameSync(downloaded.savedPath, finalPath);
+              }
+              downloads.push({ kind: "image", url: extraction.imageUrl, savedPath: finalPath, sizeBytes: (0, import_node_fs4.statSync)(finalPath).size, mimeType: downloaded.mimeType, error: null });
+            } catch (err) {
+              downloads.push({ kind: "image", url: extraction.imageUrl, savedPath: null, sizeBytes: null, mimeType: null, error: err instanceof Error ? err.message : String(err) });
+            }
+          }
+          const tracksToDownload = body.downloadAllTracks ? extraction.tracks : [extraction.selectedVideoTrack, extraction.selectedAudioTrack].filter((track) => Boolean(track));
+          const savedByUrl = /* @__PURE__ */ new Map();
+          for (const [index, track] of tracksToDownload.entries()) {
+            if (track.streamType === "video" && !mediaTypes.has("video")) continue;
+            if (track.streamType === "audio" && !mediaTypes.has("audio")) continue;
+            const kind = track.streamType === "audio" ? "audio" : "video";
+            const target = (0, import_node_path7.join)(outputDir, trackFilename(track, index, extraction.shortcode));
+            try {
+              const downloaded = await downloadToFile(track.url, target, extraction.pageUrl);
+              downloads.push({ kind, url: track.url, savedPath: downloaded.savedPath, sizeBytes: downloaded.sizeBytes, mimeType: downloaded.mimeType, error: null });
+              savedByUrl.set(track.url, downloaded.savedPath);
+            } catch (err) {
+              downloads.push({ kind, url: track.url, savedPath: null, sizeBytes: null, mimeType: null, error: err instanceof Error ? err.message : String(err) });
+            }
+          }
+          if (body.mux && mediaTypes.has("video") && mediaTypes.has("audio") && extraction.selectedVideoTrack && extraction.selectedAudioTrack && savedByUrl.has(extraction.selectedVideoTrack.url) && savedByUrl.has(extraction.selectedAudioTrack.url)) {
+            const outPath = (0, import_node_path7.join)(outputDir, `${extraction.shortcode ?? "instagram"}-muxed.mp4`);
+            const muxed = await runFfmpegMux(savedByUrl.get(extraction.selectedVideoTrack.url), savedByUrl.get(extraction.selectedAudioTrack.url), outPath);
+            if (muxed.ok) {
+              downloads.push({ kind: "muxed_video", url: null, savedPath: outPath, sizeBytes: (0, import_node_fs4.statSync)(outPath).size, mimeType: "video/mp4", error: null });
+            } else {
+              warnings.push(`Mux skipped/failed: ${muxed.error}`);
+            }
+          }
+        }
+        let transcript = null;
+        if (body.includeTranscript) {
+          const audioUrl = extraction.selectedAudioTrack?.url ?? extraction.selectedVideoTrack?.url;
+          if (!audioUrl) {
+            warnings.push("Transcript requested, but no audio/video track was available.");
+          } else {
+            const tx = await debitMc(user.id, MC_COSTS.instagram_transcribe, LedgerOperation.INSTAGRAM_TRANSCRIBE, sourceUrl.href);
+            if (!tx.ok) return c.json(insufficientBalanceResponse(tx.balance_mc, MC_COSTS.instagram_transcribe), 402);
+            transcriptDebited = true;
+            transcript = await transcribeMediaUrl(audioUrl, "# Instagram Media Transcript");
+          }
+        }
+        const result = {
+          ...extraction,
+          browser: launch.browser,
+          outputDir,
+          downloads,
+          warnings,
+          transcript
+        };
+        await logRequestEvent({ userId: user.id, source: "instagram_media_download", status: "done", query: sourceUrl.href, resultCount: downloads.length, result });
+        return c.json(result);
+      } catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        if (transcriptDebited) await creditMc(user.id, MC_COSTS.instagram_transcribe, LedgerOperation.INSTAGRAM_TRANSCRIBE_REFUND, "failed call");
+        if (mediaDebited) await creditMc(user.id, MC_COSTS.instagram_media, LedgerOperation.INSTAGRAM_MEDIA_REFUND, "failed call");
+        await logRequestEvent({ userId: user.id, source: "instagram_media_download", status: "failed", query: sourceUrl.href, error: msg });
+        if (msg.toLowerCase().includes("blocked") || msg.toLowerCase().includes("captcha")) return c.json({ error: msg }, 503);
+        return c.json({ error: msg }, 500);
+      } finally {
+        await driver.close();
+        await releaseConcurrencyGate(gate.lockId);
+      }
+    });
+  }
+});
+
 // src/extractor/MapsNavigator.ts
 var MapsNavigator;
 var init_MapsNavigator = __esm({
@@ -13117,7 +13983,7 @@ var init_MapsReviewCollector = __esm({
 });
 
 // src/extractor/MapsExtractor.ts
-var import_zod17, MapsExtractor;
+var import_zod18, MapsExtractor;
 var init_MapsExtractor = __esm({
   "src/extractor/MapsExtractor.ts"() {
     "use strict";
@@ -13125,7 +13991,7 @@ var init_MapsExtractor = __esm({
     init_selectors();
     init_MapsNavigator();
     init_MapsReviewCollector();
-    import_zod17 = require("zod");
+    import_zod18 = require("zod");
     MapsExtractor = class {
       constructor(driver) {
         this.driver = driver;
@@ -13311,7 +14177,7 @@ var init_MapsExtractor = __esm({
           });
           return rows;
         }, { hoursTable: MapsSelectors.hoursTable, hoursTableAlt: MapsSelectors.hoursTableAlt });
-        const result = import_zod17.z.array(RawMapsHoursRowSchema).safeParse(raw);
+        const result = import_zod18.z.array(RawMapsHoursRowSchema).safeParse(raw);
         if (!result.success) {
           console.warn("[MapsExtractor] hours parse failed", result.error.flatten());
           return [];
@@ -13375,7 +14241,7 @@ var init_MapsExtractor = __esm({
           });
           return results;
         });
-        const result = import_zod17.z.array(RawMapsAboutAttributeSchema).safeParse(raw);
+        const result = import_zod18.z.array(RawMapsAboutAttributeSchema).safeParse(raw);
         if (!result.success) {
           console.warn("[MapsExtractor] about parse failed", result.error.flatten());
           return [];
@@ -13767,11 +14633,11 @@ function mapsErrorResponse(c, err, errorCode) {
     attempts: rotationError?.attempts ?? void 0
   }, retryable ? 503 : 500);
 }
-var import_hono5, mapsApp;
+var import_hono6, mapsApp;
 var init_maps_routes = __esm({
   "src/api/maps-routes.ts"() {
     "use strict";
-    import_hono5 = require("hono");
+    import_hono6 = require("hono");
     init_db();
     init_rates();
     init_MapsExtractor();
@@ -13782,7 +14648,7 @@ var init_maps_routes = __esm({
     init_browser_service_env();
     init_maps_search_rotation();
     init_concurrency_gates();
-    mapsApp = new import_hono5.Hono();
+    mapsApp = new import_hono6.Hono();
     mapsApp.post("/search", createApiKeyAuth(), async (c) => {
       const user = c.get("user");
       const body = await c.req.json().catch(() => ({}));
@@ -14058,17 +14924,17 @@ function reportTitle(full) {
   const title = full.split("\n").find((line) => line.startsWith("# "));
   return title?.replace(/^#\s+/, "").trim() || "MCP Scraper Report";
 }
-function outputBaseDir() {
-  return process.env.MCP_SCRAPER_OUTPUT_DIR?.trim() || (0, import_node_path5.join)((0, import_node_os3.homedir)(), "Downloads", "mcp-scraper");
+function outputBaseDir2() {
+  return process.env.MCP_SCRAPER_OUTPUT_DIR?.trim() || (0, import_node_path8.join)((0, import_node_os6.homedir)(), "Downloads", "mcp-scraper");
 }
 function saveFullReport(full) {
   if (!reportSavingEnabled || process.env.MCP_SCRAPER_SAVE_REPORTS === "false") return null;
-  const outDir = outputBaseDir();
+  const outDir = outputBaseDir2();
   try {
-    (0, import_node_fs3.mkdirSync)(outDir, { recursive: true });
+    (0, import_node_fs5.mkdirSync)(outDir, { recursive: true });
     const stamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
-    const file = (0, import_node_path5.join)(outDir, `${stamp}-${slugifyReportName(reportTitle(full))}.md`);
-    (0, import_node_fs3.writeFileSync)(file, full, "utf8");
+    const file = (0, import_node_path8.join)(outDir, `${stamp}-${slugifyReportName(reportTitle(full))}.md`);
+    (0, import_node_fs5.writeFileSync)(file, full, "utf8");
     return file;
   } catch {
     return null;
@@ -14077,12 +14943,12 @@ function saveFullReport(full) {
 function persistScreenshotLocally(base64, url) {
   if (!reportSavingEnabled || process.env.MCP_SCRAPER_SAVE_REPORTS === "false") return null;
   try {
-    const dir = (0, import_node_path5.join)(outputBaseDir(), "screenshots");
-    (0, import_node_fs3.mkdirSync)(dir, { recursive: true });
+    const dir = (0, import_node_path8.join)(outputBaseDir2(), "screenshots");
+    (0, import_node_fs5.mkdirSync)(dir, { recursive: true });
     const stamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
     const slug = url.replace(/^https?:\/\//, "").replace(/[^a-z0-9]+/gi, "-").replace(/^-+|-+$/g, "").slice(0, 60);
-    const filePath = (0, import_node_path5.join)(dir, `${stamp}-${slug}.png`);
-    (0, import_node_fs3.writeFileSync)(filePath, Buffer.from(base64, "base64"));
+    const filePath = (0, import_node_path8.join)(dir, `${stamp}-${slug}.png`);
+    (0, import_node_fs5.writeFileSync)(filePath, Buffer.from(base64, "base64"));
     return filePath;
   } catch {
     return null;
@@ -14399,7 +15265,9 @@ ${headingSection}${kpoSection}${brandingSection}${bodySection}${screenshotSectio
     entityTypes: kpo?.type ?? [],
     napScore: kpo?.napScore ?? null,
     missingSchemaFields: kpo?.missingFields ?? [],
-    screenshotSaved: screenshotPath ?? null
+    screenshotSaved: screenshotPath ?? null,
+    branding: branding ?? null,
+    mediaAssets: media?.assets ?? null
   };
   if (screenshotMeta?.base64) {
     return {
@@ -15371,6 +16239,216 @@ ${chunkRows}` : "",
     }
   };
 }
+function structuredInstagramBrowser(raw) {
+  const browser = raw && typeof raw === "object" ? raw : {};
+  const mode = browser.mode === "local" ? "local" : "hosted";
+  const requestedMode = browser.requestedMode === "local" || browser.requestedMode === "hosted" || browser.requestedMode === "auto" ? browser.requestedMode : "auto";
+  const profileSource = browser.profileSource === "managed_profile" || browser.profileSource === "direct_profile_dir" ? browser.profileSource : "hosted";
+  return {
+    mode,
+    requestedMode,
+    profileName: typeof browser.profileName === "string" ? browser.profileName : null,
+    profileSource,
+    profileDirConfigured: browser.profileDirConfigured === true,
+    executablePathConfigured: browser.executablePathConfigured === true
+  };
+}
+function structuredInstagramPagination(raw, input) {
+  const pagination = raw && typeof raw === "object" ? raw : {};
+  const stages = Array.isArray(pagination.stages) ? pagination.stages : [];
+  const stoppedReason = typeof pagination.stoppedReason === "string" && ["max_items", "reported_post_count", "stable_scrolls", "max_scrolls", "no_scrolls"].includes(pagination.stoppedReason) ? pagination.stoppedReason : "no_scrolls";
+  return {
+    maxItems: typeof pagination.maxItems === "number" ? pagination.maxItems : Number(input.maxItems ?? 50),
+    maxScrolls: typeof pagination.maxScrolls === "number" ? pagination.maxScrolls : Number(input.maxScrolls ?? 10),
+    attemptedScrolls: typeof pagination.attemptedScrolls === "number" ? pagination.attemptedScrolls : 0,
+    stableScrolls: typeof pagination.stableScrolls === "number" ? pagination.stableScrolls : 0,
+    stableScrollLimit: typeof pagination.stableScrollLimit === "number" ? pagination.stableScrollLimit : Number(input.stableScrollLimit ?? 4),
+    scrollDelayMs: typeof pagination.scrollDelayMs === "number" ? pagination.scrollDelayMs : Number(input.scrollDelayMs ?? 1200),
+    reachedMaxItems: pagination.reachedMaxItems === true,
+    reachedReportedPostCount: pagination.reachedReportedPostCount === true,
+    finalScrollHeight: typeof pagination.finalScrollHeight === "number" ? pagination.finalScrollHeight : null,
+    stoppedReason,
+    stages: stages.map((stage) => {
+      const row = stage && typeof stage === "object" ? stage : {};
+      return {
+        stage: String(row.stage ?? ""),
+        itemCount: typeof row.itemCount === "number" ? row.itemCount : 0,
+        addedCount: typeof row.addedCount === "number" ? row.addedCount : 0,
+        scrollY: typeof row.scrollY === "number" ? row.scrollY : null,
+        scrollHeight: typeof row.scrollHeight === "number" ? row.scrollHeight : null
+      };
+    })
+  };
+}
+function formatInstagramProfileContent(raw, input) {
+  const parsed = parseData(raw);
+  if ("error" in parsed) return { content: [{ type: "text", text: parsed.error }], isError: true };
+  const d = parsed.data;
+  const items = Array.isArray(d.items) ? d.items : [];
+  const typeCounts = d.typeCounts;
+  const limitations = Array.isArray(d.limitations) ? d.limitations.map(String) : [];
+  const browser = structuredInstagramBrowser(d.browser);
+  const pagination = structuredInstagramPagination(d.pagination, input);
+  const itemRows = items.slice(0, 100).map(
+    (item, i) => `| ${i + 1} | ${item.type} | \`${item.shortcode}\` | ${item.url} | ${cell(item.firstSeenStage ?? "")} |`
+  ).join("\n");
+  const browserLabel = browser.mode === "local" ? `local profile ${browser.profileName ? `\`${browser.profileName}\`` : "(unnamed)"}` : "hosted browser";
+  const full = [
+    `# Instagram Profile Content: ${d.handle ?? input.handle ?? input.url ?? "profile"}`,
+    `**Collected:** ${items.length} items \xB7 posts ${typeCounts?.post ?? 0} \xB7 reels ${typeCounts?.reel ?? 0} \xB7 tv ${typeCounts?.tv ?? 0}`,
+    `**Browser:** ${browserLabel}`,
+    `**Pagination:** ${pagination.attemptedScrolls} scrolls \xB7 stopped: ${pagination.stoppedReason}`,
+    d.reportedPostCountText ? `**Profile count:** ${d.reportedPostCountText}` : "",
+    d.followerCountText ? `**Followers:** ${d.followerCountText}` : "",
+    `
+## Content Links
+| # | Type | Shortcode | URL | First Seen |
+|---|------|-----------|-----|------------|
+${itemRows || "| \u2014 | \u2014 | \u2014 | \u2014 | \u2014 |"}`,
+    limitations.length ? `
+## Limits
+${limitations.map((l) => `- ${l}`).join("\n")}` : "",
+    `
+---
+\u{1F4A1} Use \`instagram_media_download\` with one of these URLs to download text, image, reel tracks, and optional transcript.`
+  ].filter(Boolean).join("\n");
+  return {
+    ...oneBlock(full),
+    structuredContent: {
+      handle: String(d.handle ?? input.handle ?? ""),
+      profileUrl: String(d.profileUrl ?? input.url ?? ""),
+      pageUrl: String(d.pageUrl ?? d.profileUrl ?? input.url ?? ""),
+      browser,
+      profileName: typeof d.profileName === "string" ? d.profileName : null,
+      reportedPostCount: typeof d.reportedPostCount === "number" ? d.reportedPostCount : null,
+      reportedPostCountText: typeof d.reportedPostCountText === "string" ? d.reportedPostCountText : null,
+      followerCountText: typeof d.followerCountText === "string" ? d.followerCountText : null,
+      followingCountText: typeof d.followingCountText === "string" ? d.followingCountText : null,
+      collectedContentCount: items.length,
+      typeCounts: {
+        post: Number(typeCounts?.post ?? 0),
+        reel: Number(typeCounts?.reel ?? 0),
+        tv: Number(typeCounts?.tv ?? 0)
+      },
+      pagination,
+      limited: d.limited === true,
+      limitations,
+      items: items.map((item) => ({
+        url: String(item.url ?? ""),
+        type: item.type,
+        shortcode: String(item.shortcode ?? ""),
+        anchorText: item.anchorText ?? null,
+        firstSeenStage: String(item.firstSeenStage ?? "")
+      }))
+    }
+  };
+}
+function structuredInstagramTrack(track) {
+  if (!track) return null;
+  return {
+    url: String(track.url ?? ""),
+    streamType: track.streamType ?? "unknown",
+    bitrate: typeof track.bitrate === "number" ? track.bitrate : null,
+    durationSec: typeof track.durationSec === "number" ? track.durationSec : null,
+    vencodeTag: track.vencodeTag ?? null,
+    width: typeof track.width === "number" ? track.width : null,
+    height: typeof track.height === "number" ? track.height : null
+  };
+}
+function formatInstagramMediaDownload(raw, input) {
+  const parsed = parseData(raw);
+  if ("error" in parsed) return { content: [{ type: "text", text: parsed.error }], isError: true };
+  const d = parsed.data;
+  const tracks = Array.isArray(d.tracks) ? d.tracks : [];
+  const downloads = Array.isArray(d.downloads) ? d.downloads : [];
+  const warnings = Array.isArray(d.warnings) ? d.warnings.map(String) : [];
+  const limitations = Array.isArray(d.limitations) ? d.limitations.map(String) : [];
+  const transcript = d.transcript;
+  const transcriptText = transcript?.text ?? "";
+  const chunks = transcript?.chunks ?? [];
+  const browser = structuredInstagramBrowser(d.browser);
+  const browserLabel = browser.mode === "local" ? `local profile ${browser.profileName ? `\`${browser.profileName}\`` : "(unnamed)"}` : "hosted browser";
+  const downloadRows = downloads.map((download, i) => {
+    const status = download.error ? `error: ${cell(download.error)}` : `${download.sizeBytes ?? 0} bytes`;
+    return `| ${i + 1} | ${download.kind} | ${download.savedPath ? `\`${download.savedPath}\`` : "\u2014"} | ${status} |`;
+  }).join("\n");
+  const trackRows = tracks.slice(0, 20).map(
+    (track, i) => `| ${i + 1} | ${track.streamType} | ${track.bitrate ?? "\u2014"} | ${track.durationSec ?? "\u2014"} | ${cell(track.vencodeTag ?? "")} |`
+  ).join("\n");
+  const full = [
+    `# Instagram Media Download`,
+    `**URL:** ${d.pageUrl ?? input.url}`,
+    `**Browser:** ${browserLabel}`,
+    d.ownerName ? `**Owner:** ${d.ownerName}` : "",
+    d.shortcode ? `**Shortcode:** \`${d.shortcode}\`` : "",
+    d.caption ? `
+## Caption
+${truncate(String(d.caption), 1200)}` : "",
+    d.imageUrl ? `
+## Image
+${d.imageUrl}` : "",
+    tracks.length ? `
+## Media Tracks
+| # | Type | Bitrate | Duration | Tag |
+|---|------|---------|----------|-----|
+${trackRows}` : "\n## Media Tracks\n*None captured.*",
+    downloads.length ? `
+## Downloads
+| # | Kind | File | Status |
+|---|------|------|--------|
+${downloadRows}` : "",
+    d.outputDir ? `
+**Output directory:** \`${d.outputDir}\`` : "",
+    transcript ? `
+## Transcript
+**${wordCount(transcriptText)} words** \xB7 ${chunks.length} chunks
+
+${transcriptText}` : "",
+    warnings.length ? `
+## Warnings
+${warnings.map((w) => `- ${w}`).join("\n")}` : "",
+    limitations.length ? `
+## Limits
+${limitations.map((l) => `- ${l}`).join("\n")}` : "",
+    `
+---
+\u{1F4A1} Reels may expose separate video-only and audio-only MP4 tracks. Use the muxed file when present; otherwise use the selected video/audio track URLs or saved files.`
+  ].filter(Boolean).join("\n");
+  return {
+    ...oneBlock(full),
+    structuredContent: {
+      sourceUrl: String(d.sourceUrl ?? input.url),
+      pageUrl: String(d.pageUrl ?? input.url),
+      browser,
+      type: d.type === "post" || d.type === "reel" || d.type === "tv" ? d.type : null,
+      shortcode: typeof d.shortcode === "string" ? d.shortcode : null,
+      ownerName: typeof d.ownerName === "string" ? d.ownerName : null,
+      caption: typeof d.caption === "string" ? d.caption : null,
+      imageUrl: typeof d.imageUrl === "string" ? d.imageUrl : null,
+      trackCount: tracks.length,
+      selectedVideoTrack: structuredInstagramTrack(d.selectedVideoTrack),
+      selectedAudioTrack: structuredInstagramTrack(d.selectedAudioTrack),
+      downloads: downloads.map((download) => ({
+        kind: download.kind,
+        url: download.url ?? null,
+        savedPath: download.savedPath ?? null,
+        sizeBytes: typeof download.sizeBytes === "number" ? download.sizeBytes : null,
+        mimeType: download.mimeType ?? null,
+        error: download.error ?? null
+      })),
+      outputDir: typeof d.outputDir === "string" ? d.outputDir : null,
+      warnings,
+      limitations,
+      transcript: transcript ? {
+        wordCount: wordCount(transcriptText),
+        chunkCount: chunks.length,
+        durationMs: typeof transcript.durationMs === "number" ? transcript.durationMs : null,
+        transcriptText,
+        chunks: structuredTranscriptChunks(chunks)
+      } : null
+    }
+  };
+}
 function formatCaptureSerpSnapshot(raw, input) {
   const parsed = parseData(raw);
   if ("error" in parsed) return { content: [{ type: "text", text: parsed.error }], isError: true };
@@ -15461,13 +16539,13 @@ ${rows}` : ""
     }
   };
 }
-var import_node_fs3, import_node_os3, import_node_path5, reportSavingEnabled;
+var import_node_fs5, import_node_os6, import_node_path8, reportSavingEnabled;
 var init_mcp_response_formatter = __esm({
   "src/mcp/mcp-response-formatter.ts"() {
     "use strict";
-    import_node_fs3 = require("fs");
-    import_node_os3 = require("os");
-    import_node_path5 = require("path");
+    import_node_fs5 = require("fs");
+    import_node_os6 = require("os");
+    import_node_path8 = require("path");
     init_errors();
     init_workflow_catalog();
     reportSavingEnabled = true;
@@ -15574,7 +16652,7 @@ function localLocationFileAllowed() {
 async function existingPath(value) {
   const trimmed = value?.trim();
   if (!trimmed) return null;
-  await (0, import_promises4.access)(trimmed);
+  await (0, import_promises7.access)(trimmed);
   return trimmed;
 }
 async function resolveUsZipsPath(requestedPath) {
@@ -15592,7 +16670,7 @@ async function loadZipGroups(stateAbbr, requestedPath, warnings) {
   }
   const path6 = await resolveUsZipsPath(requestedPath);
   if (!path6) return { path: null, groups: /* @__PURE__ */ new Map() };
-  const records = csvRecords(await (0, import_promises4.readFile)(path6, "utf8"));
+  const records = csvRecords(await (0, import_promises7.readFile)(path6, "utf8"));
   const groups = /* @__PURE__ */ new Map();
   for (const record of records) {
     const state = (record.state_abbr ?? record.state ?? "").trim().toUpperCase();
@@ -15643,11 +16721,11 @@ async function resolveDirectoryMarkets(options) {
   }
   return { markets, censusSourceUrl: sourceUrl, usZipsSourcePath: zipData.path, warnings };
 }
-var import_promises4, POPULATION_YEARS, STATE_META, STATE_BY_NAME;
+var import_promises7, POPULATION_YEARS, STATE_META, STATE_BY_NAME;
 var init_location_db = __esm({
   "src/directory/location-db.ts"() {
     "use strict";
-    import_promises4 = require("fs/promises");
+    import_promises7 = require("fs/promises");
     init_csv();
     POPULATION_YEARS = [2020, 2021, 2022, 2023, 2024, 2025];
     STATE_META = {
@@ -15863,11 +16941,11 @@ function csvRowsFor(result) {
   return rows;
 }
 async function saveDirectoryCsv(result) {
-  const outDir = (0, import_node_path6.join)(outputBaseDir(), "directory-workflows");
-  await (0, import_promises5.mkdir)(outDir, { recursive: true });
+  const outDir = (0, import_node_path9.join)(outputBaseDir2(), "directory-workflows");
+  await (0, import_promises8.mkdir)(outDir, { recursive: true });
   const stamp = result.extractedAt.replace(/[:.]/g, "-");
   const slug = `${result.state}-${result.query}`.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 80);
-  const path6 = (0, import_node_path6.join)(outDir, `${stamp}-${slug}-directory-workflow.csv`);
+  const path6 = (0, import_node_path9.join)(outDir, `${stamp}-${slug}-directory-workflow.csv`);
   const headers = [
     "source_query",
     "source_location",
@@ -15899,7 +16977,7 @@ async function saveDirectoryCsv(result) {
     "extracted_at",
     "duration_ms"
   ];
-  await (0, import_promises5.writeFile)(path6, rowsToCsv(headers, csvRowsFor(result)), "utf8");
+  await (0, import_promises8.writeFile)(path6, rowsToCsv(headers, csvRowsFor(result)), "utf8");
   return path6;
 }
 async function runDirectoryWorkflowFromPlan(options, plan) {
@@ -15925,47 +17003,47 @@ async function runDirectoryWorkflowFromPlan(options, plan) {
   const csvPath = options.saveCsv ? await saveDirectoryCsv(base) : null;
   return { ...base, csvPath };
 }
-var import_promises5, import_node_path6, import_zod18, DirectoryWorkflowOptionsSchema;
+var import_promises8, import_node_path9, import_zod19, DirectoryWorkflowOptionsSchema;
 var init_directory_workflow = __esm({
   "src/directory/directory-workflow.ts"() {
     "use strict";
-    import_promises5 = require("fs/promises");
-    import_node_path6 = require("path");
-    import_zod18 = require("zod");
+    import_promises8 = require("fs/promises");
+    import_node_path9 = require("path");
+    import_zod19 = require("zod");
     init_mcp_response_formatter();
     init_browser_service_env();
     init_maps_search_rotation();
     init_schemas3();
     init_csv();
     init_location_db();
-    DirectoryWorkflowOptionsSchema = import_zod18.z.object({
-      query: import_zod18.z.string().min(1),
-      state: import_zod18.z.string().min(2).default("TN"),
-      minPopulation: import_zod18.z.number().int().min(0).default(1e5),
-      populationYear: import_zod18.z.union(POPULATION_YEARS.map((year) => import_zod18.z.literal(year))).default(2025),
-      maxCities: import_zod18.z.number().int().min(1).max(100).default(25),
-      maxResultsPerCity: import_zod18.z.number().int().min(1).max(50).default(50),
-      concurrency: import_zod18.z.number().int().min(1).max(5).default(5),
-      includeZipGroups: import_zod18.z.boolean().default(true),
-      usZipsCsvPath: import_zod18.z.string().optional(),
-      saveCsv: import_zod18.z.boolean().default(true),
-      gl: import_zod18.z.string().length(2).default("us"),
-      hl: import_zod18.z.string().length(2).default("en"),
-      proxyMode: import_zod18.z.enum(["location", "configured", "none"]).default(DEFAULT_MAPS_PROXY_MODE),
-      proxyZip: import_zod18.z.string().regex(/^\d{5}$/).optional(),
-      debug: import_zod18.z.boolean().default(false),
-      headless: import_zod18.z.boolean().default(true),
-      kernelApiKey: import_zod18.z.string().optional()
+    DirectoryWorkflowOptionsSchema = import_zod19.z.object({
+      query: import_zod19.z.string().min(1),
+      state: import_zod19.z.string().min(2).default("TN"),
+      minPopulation: import_zod19.z.number().int().min(0).default(1e5),
+      populationYear: import_zod19.z.union(POPULATION_YEARS.map((year) => import_zod19.z.literal(year))).default(2025),
+      maxCities: import_zod19.z.number().int().min(1).max(100).default(25),
+      maxResultsPerCity: import_zod19.z.number().int().min(1).max(50).default(50),
+      concurrency: import_zod19.z.number().int().min(1).max(5).default(5),
+      includeZipGroups: import_zod19.z.boolean().default(true),
+      usZipsCsvPath: import_zod19.z.string().optional(),
+      saveCsv: import_zod19.z.boolean().default(true),
+      gl: import_zod19.z.string().length(2).default("us"),
+      hl: import_zod19.z.string().length(2).default("en"),
+      proxyMode: import_zod19.z.enum(["location", "configured", "none"]).default(DEFAULT_MAPS_PROXY_MODE),
+      proxyZip: import_zod19.z.string().regex(/^\d{5}$/).optional(),
+      debug: import_zod19.z.boolean().default(false),
+      headless: import_zod19.z.boolean().default(true),
+      kernelApiKey: import_zod19.z.string().optional()
     });
   }
 });
 
 // src/api/directory-routes.ts
-var import_hono6, directoryApp;
+var import_hono7, directoryApp;
 var init_directory_routes = __esm({
   "src/api/directory-routes.ts"() {
     "use strict";
-    import_hono6 = require("hono");
+    import_hono7 = require("hono");
     init_api_auth();
     init_db();
     init_rates();
@@ -15973,7 +17051,7 @@ var init_directory_routes = __esm({
     init_location_db();
     init_browser_service_env();
     init_concurrency_gates();
-    directoryApp = new import_hono6.Hono();
+    directoryApp = new import_hono7.Hono();
     directoryApp.post("/run", createApiKeyAuth(), async (c) => {
       const user = c.get("user");
       const body = await c.req.json().catch(() => ({}));
@@ -16057,7 +17135,7 @@ var init_slugify = __esm({
 
 // src/workflows/artifact-writer.ts
 function workflowOutputBaseDir(outputDir) {
-  return outputDir?.trim() || process.env.MCP_SCRAPER_OUTPUT_DIR?.trim() || (0, import_node_path7.join)((0, import_node_os4.homedir)(), "Downloads", "mcp-scraper");
+  return outputDir?.trim() || process.env.MCP_SCRAPER_OUTPUT_DIR?.trim() || (0, import_node_path10.join)((0, import_node_os7.homedir)(), "Downloads", "mcp-scraper");
 }
 function timestamp() {
   return (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
@@ -16066,13 +17144,13 @@ function safeSlug(value) {
   return slugify(value).replace(/^-+|-+$/g, "").slice(0, 80) || "run";
 }
 function indexPath(baseDir = workflowOutputBaseDir()) {
-  return (0, import_node_path7.join)(baseDir, "workflows", "index.json");
+  return (0, import_node_path10.join)(baseDir, "workflows", "index.json");
 }
 async function readIndex(baseDir) {
   const path6 = indexPath(baseDir);
-  if (!(0, import_node_fs4.existsSync)(path6)) return { runs: [] };
+  if (!(0, import_node_fs6.existsSync)(path6)) return { runs: [] };
   try {
-    return JSON.parse(await (0, import_promises6.readFile)(path6, "utf8"));
+    return JSON.parse(await (0, import_promises9.readFile)(path6, "utf8"));
   } catch {
     return { runs: [] };
   }
@@ -16092,18 +17170,18 @@ async function updateWorkflowIndex(manifest, manifestPath, baseDir) {
     summary: `${manifest.title} (${manifest.status})`
   };
   index.runs = [entry, ...index.runs.filter((r) => r.runId !== manifest.runId)].slice(0, 200);
-  await (0, import_promises6.mkdir)((0, import_node_path7.dirname)(path6), { recursive: true });
-  await (0, import_promises6.writeFile)(path6, JSON.stringify(index, null, 2), "utf8");
+  await (0, import_promises9.mkdir)((0, import_node_path10.dirname)(path6), { recursive: true });
+  await (0, import_promises9.writeFile)(path6, JSON.stringify(index, null, 2), "utf8");
 }
-var import_promises6, import_node_fs4, import_node_os4, import_node_path7, import_node_child_process2, ArtifactWriter;
+var import_promises9, import_node_fs6, import_node_os7, import_node_path10, import_node_child_process3, ArtifactWriter;
 var init_artifact_writer = __esm({
   "src/workflows/artifact-writer.ts"() {
     "use strict";
-    import_promises6 = require("fs/promises");
-    import_node_fs4 = require("fs");
-    import_node_os4 = require("os");
-    import_node_path7 = require("path");
-    import_node_child_process2 = require("child_process");
+    import_promises9 = require("fs/promises");
+    import_node_fs6 = require("fs");
+    import_node_os7 = require("os");
+    import_node_path10 = require("path");
+    import_node_child_process3 = require("child_process");
     init_csv();
     init_slugify();
     ArtifactWriter = class _ArtifactWriter {
@@ -16129,31 +17207,31 @@ var init_artifact_writer = __esm({
         const runId = forcedRunId?.trim() || `${timestamp()}-${safeSlug(workflowId)}-${Math.random().toString(36).slice(2, 8)}`;
         const nameSource = String(input.keyword ?? input.query ?? input.domain ?? input.state ?? workflowId);
         const baseDir = workflowOutputBaseDir(outputDir);
-        const runDir = (0, import_node_path7.join)(baseDir, "workflows", workflowId, `${timestamp()}-${safeSlug(nameSource)}-${safeSlug(runId).slice(0, 20)}`);
-        await (0, import_promises6.mkdir)(runDir, { recursive: true });
+        const runDir = (0, import_node_path10.join)(baseDir, "workflows", workflowId, `${timestamp()}-${safeSlug(nameSource)}-${safeSlug(runId).slice(0, 20)}`);
+        await (0, import_promises9.mkdir)(runDir, { recursive: true });
         return new _ArtifactWriter(workflowId, title, runId, baseDir, runDir, startedAt, input);
       }
       async remember(kind, label, path6, rows) {
-        const size = await (0, import_promises6.stat)(path6).then((s) => s.size).catch(() => void 0);
+        const size = await (0, import_promises9.stat)(path6).then((s) => s.size).catch(() => void 0);
         this.artifacts.push({ kind, label, path: path6, bytes: size, rows });
         return path6;
       }
       async writeJson(label, relativePath, data) {
-        const path6 = (0, import_node_path7.join)(this.runDir, relativePath);
-        await (0, import_promises6.mkdir)((0, import_node_path7.dirname)(path6), { recursive: true });
-        await (0, import_promises6.writeFile)(path6, JSON.stringify(data, null, 2), "utf8");
+        const path6 = (0, import_node_path10.join)(this.runDir, relativePath);
+        await (0, import_promises9.mkdir)((0, import_node_path10.dirname)(path6), { recursive: true });
+        await (0, import_promises9.writeFile)(path6, JSON.stringify(data, null, 2), "utf8");
         return this.remember("json", label, path6);
       }
       async writeText(label, relativePath, text, kind = "markdown") {
-        const path6 = (0, import_node_path7.join)(this.runDir, relativePath);
-        await (0, import_promises6.mkdir)((0, import_node_path7.dirname)(path6), { recursive: true });
-        await (0, import_promises6.writeFile)(path6, text, "utf8");
+        const path6 = (0, import_node_path10.join)(this.runDir, relativePath);
+        await (0, import_promises9.mkdir)((0, import_node_path10.dirname)(path6), { recursive: true });
+        await (0, import_promises9.writeFile)(path6, text, "utf8");
         return this.remember(kind, label, path6);
       }
       async writeCsv(label, relativePath, headers, rows) {
-        const path6 = (0, import_node_path7.join)(this.runDir, relativePath);
-        await (0, import_promises6.mkdir)((0, import_node_path7.dirname)(path6), { recursive: true });
-        await (0, import_promises6.writeFile)(path6, rowsToCsv(headers, rows), "utf8");
+        const path6 = (0, import_node_path10.join)(this.runDir, relativePath);
+        await (0, import_promises9.mkdir)((0, import_node_path10.dirname)(path6), { recursive: true });
+        await (0, import_promises9.writeFile)(path6, rowsToCsv(headers, rows), "utf8");
         return this.remember("csv", label, path6, rows.length);
       }
       async writeHtml(label, relativePath, html) {
@@ -16173,8 +17251,8 @@ var init_artifact_writer = __esm({
           errors,
           counts
         };
-        const path6 = (0, import_node_path7.join)(this.runDir, "manifest.json");
-        await (0, import_promises6.writeFile)(path6, JSON.stringify(manifest, null, 2), "utf8");
+        const path6 = (0, import_node_path10.join)(this.runDir, "manifest.json");
+        await (0, import_promises9.writeFile)(path6, JSON.stringify(manifest, null, 2), "utf8");
         await updateWorkflowIndex(manifest, path6, this.baseDir);
         return path6;
       }
@@ -16354,21 +17432,21 @@ function competitorRows(rows, targetDomain) {
     source_url_count: entry.urls.size
   })).sort((a, b) => Number(a.organic_best_position || 999) - Number(b.organic_best_position || 999));
 }
-var import_zod19, AgentPacketInputSchema, agentPacketWorkflowDefinition;
+var import_zod20, AgentPacketInputSchema, agentPacketWorkflowDefinition;
 var init_agent_packet = __esm({
   "src/workflows/workflows/agent-packet.ts"() {
     "use strict";
-    import_zod19 = require("zod");
+    import_zod20 = require("zod");
     init_report_renderer();
-    AgentPacketInputSchema = import_zod19.z.object({
-      keyword: import_zod19.z.string().min(1),
-      domain: import_zod19.z.string().optional(),
-      location: import_zod19.z.string().optional(),
-      maxQuestions: import_zod19.z.number().int().min(1).max(200).default(40),
-      includeSerp: import_zod19.z.boolean().default(true),
-      includePaa: import_zod19.z.boolean().default(true),
-      includeAiOverview: import_zod19.z.boolean().default(true),
-      returnPartial: import_zod19.z.boolean().default(true)
+    AgentPacketInputSchema = import_zod20.z.object({
+      keyword: import_zod20.z.string().min(1),
+      domain: import_zod20.z.string().optional(),
+      location: import_zod20.z.string().optional(),
+      maxQuestions: import_zod20.z.number().int().min(1).max(200).default(40),
+      includeSerp: import_zod20.z.boolean().default(true),
+      includePaa: import_zod20.z.boolean().default(true),
+      includeAiOverview: import_zod20.z.boolean().default(true),
+      returnPartial: import_zod20.z.boolean().default(true)
     });
     agentPacketWorkflowDefinition = {
       id: "agent-packet",
@@ -16566,22 +17644,22 @@ function directoryRows(result) {
   }
   return rows;
 }
-var import_zod20, DirectoryWorkflowCliInputSchema, DIRECTORY_CSV_HEADERS, directoryWorkflowDefinition;
+var import_zod21, DirectoryWorkflowCliInputSchema, DIRECTORY_CSV_HEADERS, directoryWorkflowDefinition;
 var init_directory = __esm({
   "src/workflows/workflows/directory.ts"() {
     "use strict";
-    import_zod20 = require("zod");
+    import_zod21 = require("zod");
     init_report_renderer();
     init_schemas3();
-    DirectoryWorkflowCliInputSchema = import_zod20.z.object({
-      query: import_zod20.z.string().min(1),
-      state: import_zod20.z.string().min(2).default("TN"),
-      minPopulation: import_zod20.z.number().int().min(0).default(1e5),
-      maxCities: import_zod20.z.number().int().min(1).max(100).default(25),
-      maxResultsPerCity: import_zod20.z.number().int().min(1).max(50).default(20),
-      concurrency: import_zod20.z.number().int().min(1).max(5).default(5),
-      proxyMode: import_zod20.z.enum(["location", "configured", "none"]).default(DEFAULT_MAPS_PROXY_MODE),
-      saveCsv: import_zod20.z.boolean().default(true)
+    DirectoryWorkflowCliInputSchema = import_zod21.z.object({
+      query: import_zod21.z.string().min(1),
+      state: import_zod21.z.string().min(2).default("TN"),
+      minPopulation: import_zod21.z.number().int().min(0).default(1e5),
+      maxCities: import_zod21.z.number().int().min(1).max(100).default(25),
+      maxResultsPerCity: import_zod21.z.number().int().min(1).max(50).default(20),
+      concurrency: import_zod21.z.number().int().min(1).max(5).default(5),
+      proxyMode: import_zod21.z.enum(["location", "configured", "none"]).default(DEFAULT_MAPS_PROXY_MODE),
+      saveCsv: import_zod21.z.boolean().default(true)
     });
     DIRECTORY_CSV_HEADERS = [
       "source_query",
@@ -16690,25 +17768,25 @@ function termsFrom(texts) {
   }
   return [...counts.entries()].sort((a, b) => b[1] - a[1]).slice(0, 8).map(([term, count]) => `${term} (${count})`).join("; ");
 }
-var import_zod21, LocalCompetitiveAuditInputSchema, localCompetitiveAuditWorkflowDefinition;
+var import_zod22, LocalCompetitiveAuditInputSchema, localCompetitiveAuditWorkflowDefinition;
 var init_local_competitive_audit = __esm({
   "src/workflows/workflows/local-competitive-audit.ts"() {
     "use strict";
-    import_zod21 = require("zod");
+    import_zod22 = require("zod");
     init_report_renderer();
     init_directory();
     init_schemas3();
-    LocalCompetitiveAuditInputSchema = import_zod21.z.object({
-      query: import_zod21.z.string().min(1),
-      state: import_zod21.z.string().min(2).default("TN"),
-      minPopulation: import_zod21.z.number().int().min(0).default(1e5),
-      maxCities: import_zod21.z.number().int().min(1).max(100).default(25),
-      maxResultsPerCity: import_zod21.z.number().int().min(1).max(50).default(20),
-      hydrateTop: import_zod21.z.number().int().min(0).max(10).default(5),
-      maxReviews: import_zod21.z.number().int().min(0).max(500).default(50),
-      concurrency: import_zod21.z.number().int().min(1).max(5).default(5),
-      proxyMode: import_zod21.z.enum(["location", "configured", "none"]).default(DEFAULT_MAPS_PROXY_MODE),
-      returnPartial: import_zod21.z.boolean().default(true)
+    LocalCompetitiveAuditInputSchema = import_zod22.z.object({
+      query: import_zod22.z.string().min(1),
+      state: import_zod22.z.string().min(2).default("TN"),
+      minPopulation: import_zod22.z.number().int().min(0).default(1e5),
+      maxCities: import_zod22.z.number().int().min(1).max(100).default(25),
+      maxResultsPerCity: import_zod22.z.number().int().min(1).max(50).default(20),
+      hydrateTop: import_zod22.z.number().int().min(0).max(10).default(5),
+      maxReviews: import_zod22.z.number().int().min(0).max(500).default(50),
+      concurrency: import_zod22.z.number().int().min(1).max(5).default(5),
+      proxyMode: import_zod22.z.enum(["location", "configured", "none"]).default(DEFAULT_MAPS_PROXY_MODE),
+      returnPartial: import_zod22.z.boolean().default(true)
     });
     localCompetitiveAuditWorkflowDefinition = {
       id: "local-competitive-audit",
@@ -17151,58 +18229,58 @@ async function extractPages(ctx, sources, warnings, labelPrefix) {
     }
   }).then((items) => items.filter((item) => item !== null));
 }
-var import_zod22, ProxyModeSchema, MapComparisonInputSchema, SerpComparisonInputSchema, PaaExpansionBriefInputSchema, AiOverviewLanguageInputSchema, mapComparisonWorkflowDefinition, serpComparisonWorkflowDefinition, paaExpansionBriefWorkflowDefinition, aiOverviewLanguageWorkflowDefinition;
+var import_zod23, ProxyModeSchema, MapComparisonInputSchema, SerpComparisonInputSchema, PaaExpansionBriefInputSchema, AiOverviewLanguageInputSchema, mapComparisonWorkflowDefinition, serpComparisonWorkflowDefinition, paaExpansionBriefWorkflowDefinition, aiOverviewLanguageWorkflowDefinition;
 var init_comparison_briefs = __esm({
   "src/workflows/workflows/comparison-briefs.ts"() {
     "use strict";
-    import_zod22 = require("zod");
+    import_zod23 = require("zod");
     init_report_renderer();
     init_directory();
     init_seo_workflow_utils();
     init_schemas3();
-    ProxyModeSchema = import_zod22.z.enum(["location", "configured", "none"]);
-    MapComparisonInputSchema = import_zod22.z.object({
-      query: import_zod22.z.string().min(1),
-      location: import_zod22.z.string().optional(),
-      state: import_zod22.z.string().optional(),
-      minPopulation: import_zod22.z.number().int().min(0).default(1e5),
-      maxCities: import_zod22.z.number().int().min(1).max(100).default(5),
-      maxResultsPerCity: import_zod22.z.number().int().min(1).max(50).default(20),
-      hydrateTop: import_zod22.z.number().int().min(0).max(10).default(5),
-      maxReviews: import_zod22.z.number().int().min(0).max(500).default(25),
-      concurrency: import_zod22.z.number().int().min(1).max(5).default(5),
+    ProxyModeSchema = import_zod23.z.enum(["location", "configured", "none"]);
+    MapComparisonInputSchema = import_zod23.z.object({
+      query: import_zod23.z.string().min(1),
+      location: import_zod23.z.string().optional(),
+      state: import_zod23.z.string().optional(),
+      minPopulation: import_zod23.z.number().int().min(0).default(1e5),
+      maxCities: import_zod23.z.number().int().min(1).max(100).default(5),
+      maxResultsPerCity: import_zod23.z.number().int().min(1).max(50).default(20),
+      hydrateTop: import_zod23.z.number().int().min(0).max(10).default(5),
+      maxReviews: import_zod23.z.number().int().min(0).max(500).default(25),
+      concurrency: import_zod23.z.number().int().min(1).max(5).default(5),
       proxyMode: ProxyModeSchema.default(DEFAULT_MAPS_PROXY_MODE),
-      returnPartial: import_zod22.z.boolean().default(true)
+      returnPartial: import_zod23.z.boolean().default(true)
     }).refine((input) => input.location || input.state, {
       message: "Either location or state is required for map-comparison"
     });
-    SerpComparisonInputSchema = import_zod22.z.object({
-      keyword: import_zod22.z.string().min(1),
-      domain: import_zod22.z.string().optional(),
-      url: import_zod22.z.string().url().optional(),
-      location: import_zod22.z.string().optional(),
-      maxResults: import_zod22.z.number().int().min(1).max(20).default(10),
-      maxQuestions: import_zod22.z.number().int().min(1).max(200).default(40),
-      extractTop: import_zod22.z.number().int().min(0).max(10).default(5),
-      includePaa: import_zod22.z.boolean().default(true),
-      includeAiOverview: import_zod22.z.boolean().default(true),
-      returnPartial: import_zod22.z.boolean().default(true)
+    SerpComparisonInputSchema = import_zod23.z.object({
+      keyword: import_zod23.z.string().min(1),
+      domain: import_zod23.z.string().optional(),
+      url: import_zod23.z.string().url().optional(),
+      location: import_zod23.z.string().optional(),
+      maxResults: import_zod23.z.number().int().min(1).max(20).default(10),
+      maxQuestions: import_zod23.z.number().int().min(1).max(200).default(40),
+      extractTop: import_zod23.z.number().int().min(0).max(10).default(5),
+      includePaa: import_zod23.z.boolean().default(true),
+      includeAiOverview: import_zod23.z.boolean().default(true),
+      returnPartial: import_zod23.z.boolean().default(true)
     });
-    PaaExpansionBriefInputSchema = import_zod22.z.object({
-      keyword: import_zod22.z.string().min(1),
-      location: import_zod22.z.string().optional(),
-      maxQuestions: import_zod22.z.number().int().min(1).max(300).default(80),
-      depth: import_zod22.z.number().int().min(1).max(6).default(3),
-      returnPartial: import_zod22.z.boolean().default(true)
+    PaaExpansionBriefInputSchema = import_zod23.z.object({
+      keyword: import_zod23.z.string().min(1),
+      location: import_zod23.z.string().optional(),
+      maxQuestions: import_zod23.z.number().int().min(1).max(300).default(80),
+      depth: import_zod23.z.number().int().min(1).max(6).default(3),
+      returnPartial: import_zod23.z.boolean().default(true)
     });
-    AiOverviewLanguageInputSchema = import_zod22.z.object({
-      keyword: import_zod22.z.string().min(1),
-      domain: import_zod22.z.string().optional(),
-      url: import_zod22.z.string().url().optional(),
-      location: import_zod22.z.string().optional(),
-      maxQuestions: import_zod22.z.number().int().min(1).max(200).default(40),
-      extractTop: import_zod22.z.number().int().min(0).max(8).default(3),
-      returnPartial: import_zod22.z.boolean().default(true)
+    AiOverviewLanguageInputSchema = import_zod23.z.object({
+      keyword: import_zod23.z.string().min(1),
+      domain: import_zod23.z.string().optional(),
+      url: import_zod23.z.string().url().optional(),
+      location: import_zod23.z.string().optional(),
+      maxQuestions: import_zod23.z.number().int().min(1).max(200).default(40),
+      extractTop: import_zod23.z.number().int().min(0).max(8).default(3),
+      returnPartial: import_zod23.z.boolean().default(true)
     });
     mapComparisonWorkflowDefinition = {
       id: "map-comparison",
@@ -17653,7 +18731,7 @@ async function runWorkflowStep(id, rawInput, opts) {
   const writtenArtifacts = await Promise.all(
     artifacts.artifacts.map(async (artifact) => ({
       ...artifact,
-      content: await (0, import_promises7.readFile)(artifact.path, "utf8").catch(() => "")
+      content: await (0, import_promises10.readFile)(artifact.path, "utf8").catch(() => "")
     }))
   );
   return {
@@ -17672,12 +18750,12 @@ async function runWorkflowStep(id, rawInput, opts) {
     artifacts: writtenArtifacts
   };
 }
-var import_promises7, import_zod23, DEFINITIONS;
+var import_promises10, import_zod24, DEFINITIONS;
 var init_registry2 = __esm({
   "src/workflows/registry.ts"() {
     "use strict";
-    import_promises7 = require("fs/promises");
-    import_zod23 = require("zod");
+    import_promises10 = require("fs/promises");
+    import_zod24 = require("zod");
     init_artifact_writer();
     init_http_client2();
     init_agent_packet();
@@ -17745,7 +18823,7 @@ async function readManifestFromSummary(summary) {
   if (!summary.reportPath) return null;
   const manifestPath = summary.reportPath.replace(/report\.html$/, "manifest.json");
   try {
-    return JSON.parse(await (0, import_promises8.readFile)(manifestPath, "utf8"));
+    return JSON.parse(await (0, import_promises11.readFile)(manifestPath, "utf8"));
   } catch {
     return null;
   }
@@ -17960,47 +19038,47 @@ async function dispatchDueWorkflowSchedules(apiUrl, limit = 3) {
   }
   return { dispatched: results.length, results };
 }
-var import_node_crypto3, import_promises8, import_hono7, import_zod24, workflowApp, WorkflowInputSchema, WorkflowIdSchema, CadenceSchema, ScheduleStatusSchema, RunBodySchema, ScheduleCreateSchema, SchedulePatchSchema, TERMINAL_RUN_STATUSES;
+var import_node_crypto3, import_promises11, import_hono8, import_zod25, workflowApp, WorkflowInputSchema, WorkflowIdSchema, CadenceSchema, ScheduleStatusSchema, RunBodySchema, ScheduleCreateSchema, SchedulePatchSchema, TERMINAL_RUN_STATUSES;
 var init_workflow_routes = __esm({
   "src/api/workflow-routes.ts"() {
     "use strict";
     import_node_crypto3 = require("crypto");
-    import_promises8 = require("fs/promises");
-    import_hono7 = require("hono");
-    import_zod24 = require("zod");
+    import_promises11 = require("fs/promises");
+    import_hono8 = require("hono");
+    import_zod25 = require("zod");
     init_artifact_writer();
     init_registry2();
     init_api_auth();
     init_db();
     init_url_utils();
     init_concurrency_gates();
-    workflowApp = new import_hono7.Hono();
-    WorkflowInputSchema = import_zod24.z.record(import_zod24.z.unknown()).default({});
-    WorkflowIdSchema = import_zod24.z.string().min(1);
-    CadenceSchema = import_zod24.z.enum(["daily", "weekly", "monthly"]);
-    ScheduleStatusSchema = import_zod24.z.enum(["active", "paused"]);
-    RunBodySchema = import_zod24.z.object({
+    workflowApp = new import_hono8.Hono();
+    WorkflowInputSchema = import_zod25.z.record(import_zod25.z.unknown()).default({});
+    WorkflowIdSchema = import_zod25.z.string().min(1);
+    CadenceSchema = import_zod25.z.enum(["daily", "weekly", "monthly"]);
+    ScheduleStatusSchema = import_zod25.z.enum(["active", "paused"]);
+    RunBodySchema = import_zod25.z.object({
       workflowId: WorkflowIdSchema,
       input: WorkflowInputSchema,
-      webhookUrl: import_zod24.z.string().url().optional()
+      webhookUrl: import_zod25.z.string().url().optional()
     });
-    ScheduleCreateSchema = import_zod24.z.object({
+    ScheduleCreateSchema = import_zod25.z.object({
       workflowId: WorkflowIdSchema,
-      name: import_zod24.z.string().min(1).max(120).optional(),
+      name: import_zod25.z.string().min(1).max(120).optional(),
       input: WorkflowInputSchema,
       cadence: CadenceSchema.default("weekly"),
-      timezone: import_zod24.z.string().min(1).max(64).default("UTC"),
-      webhookUrl: import_zod24.z.string().url().optional(),
-      nextRunAt: import_zod24.z.string().datetime().optional()
+      timezone: import_zod25.z.string().min(1).max(64).default("UTC"),
+      webhookUrl: import_zod25.z.string().url().optional(),
+      nextRunAt: import_zod25.z.string().datetime().optional()
     });
-    SchedulePatchSchema = import_zod24.z.object({
-      name: import_zod24.z.string().min(1).max(120).optional(),
+    SchedulePatchSchema = import_zod25.z.object({
+      name: import_zod25.z.string().min(1).max(120).optional(),
       status: ScheduleStatusSchema.optional(),
       input: WorkflowInputSchema.optional(),
       cadence: CadenceSchema.optional(),
-      timezone: import_zod24.z.string().min(1).max(64).optional(),
-      webhookUrl: import_zod24.z.string().url().nullable().optional(),
-      nextRunAt: import_zod24.z.string().datetime().nullable().optional()
+      timezone: import_zod25.z.string().min(1).max(64).optional(),
+      webhookUrl: import_zod25.z.string().url().nullable().optional(),
+      nextRunAt: import_zod25.z.string().datetime().nullable().optional()
     });
     workflowApp.get("/definitions", createApiKeyAuth(), (c) => {
       return c.json({ workflows: listWorkflowDefinitions() });
@@ -18135,7 +19213,7 @@ var init_workflow_routes = __esm({
         return new Response(artifact.content, { headers });
       }
       try {
-        const content = await (0, import_promises8.readFile)(artifact.path);
+        const content = await (0, import_promises11.readFile)(artifact.path);
         return new Response(content, { headers });
       } catch {
         return c.json({ error: "Artifact file is no longer available" }, 410);
@@ -19794,52 +20872,52 @@ var init_PAAExtractor = __esm({
 });
 
 // src/output/OutputSerializer.ts
-var import_node_fs5, import_node_path8, import_papaparse2, OutputSerializer;
+var import_node_fs7, import_node_path11, import_papaparse2, OutputSerializer;
 var init_OutputSerializer = __esm({
   "src/output/OutputSerializer.ts"() {
     "use strict";
-    import_node_fs5 = require("fs");
-    import_node_path8 = __toESM(require("path"), 1);
+    import_node_fs7 = require("fs");
+    import_node_path11 = __toESM(require("path"), 1);
     import_papaparse2 = __toESM(require("papaparse"), 1);
     OutputSerializer = class {
       async writeJSON(result, outputDir) {
-        await import_node_fs5.promises.mkdir(outputDir, { recursive: true });
+        await import_node_fs7.promises.mkdir(outputDir, { recursive: true });
         const slug = result.seed.toLowerCase().replace(/\W+/g, "-").slice(0, 40);
         const filename = `${slug}-${Date.now()}.json`;
-        const fullPath = import_node_path8.default.join(outputDir, filename);
-        await import_node_fs5.promises.writeFile(fullPath, JSON.stringify(result, null, 2), "utf8");
+        const fullPath = import_node_path11.default.join(outputDir, filename);
+        await import_node_fs7.promises.writeFile(fullPath, JSON.stringify(result, null, 2), "utf8");
         return fullPath;
       }
       async writeCSV(rows, outputDir) {
-        await import_node_fs5.promises.mkdir(outputDir, { recursive: true });
+        await import_node_fs7.promises.mkdir(outputDir, { recursive: true });
         const seedRaw = rows[0]?.seed_query ?? "paa";
         const slug = seedRaw.toLowerCase().replace(/\W+/g, "-").slice(0, 40);
         const csv = import_papaparse2.default.unparse(rows, { header: true });
         const filename = `${slug}-${Date.now()}.csv`;
-        const fullPath = import_node_path8.default.join(outputDir, filename);
-        await import_node_fs5.promises.writeFile(fullPath, csv, "utf8");
+        const fullPath = import_node_path11.default.join(outputDir, filename);
+        await import_node_fs7.promises.writeFile(fullPath, csv, "utf8");
         return fullPath;
       }
       async writeVideoCSV(videos, seed, outputDir) {
-        await import_node_fs5.promises.mkdir(outputDir, { recursive: true });
+        await import_node_fs7.promises.mkdir(outputDir, { recursive: true });
         const slug = seed.toLowerCase().replace(/\W+/g, "-").slice(0, 40);
         const csv = import_papaparse2.default.unparse(videos, { header: true });
         const filename = `${slug}-videos-${Date.now()}.csv`;
-        const fullPath = import_node_path8.default.join(outputDir, filename);
-        await import_node_fs5.promises.writeFile(fullPath, csv, "utf8");
+        const fullPath = import_node_path11.default.join(outputDir, filename);
+        await import_node_fs7.promises.writeFile(fullPath, csv, "utf8");
         return fullPath;
       }
       async writeForumCSV(forums, seed, outputDir) {
-        await import_node_fs5.promises.mkdir(outputDir, { recursive: true });
+        await import_node_fs7.promises.mkdir(outputDir, { recursive: true });
         const slug = seed.toLowerCase().replace(/\W+/g, "-").slice(0, 40);
         const csv = import_papaparse2.default.unparse(forums, { header: true });
         const filename = `${slug}-forums-${Date.now()}.csv`;
-        const fullPath = import_node_path8.default.join(outputDir, filename);
-        await import_node_fs5.promises.writeFile(fullPath, csv, "utf8");
+        const fullPath = import_node_path11.default.join(outputDir, filename);
+        await import_node_fs7.promises.writeFile(fullPath, csv, "utf8");
         return fullPath;
       }
       async writeAIOverviewCSV(citations, text, seed, outputDir) {
-        await import_node_fs5.promises.mkdir(outputDir, { recursive: true });
+        await import_node_fs7.promises.mkdir(outputDir, { recursive: true });
         const slug = seed.toLowerCase().replace(/\W+/g, "-").slice(0, 40);
         const rows = citations.map((c, i) => ({
           seed_query: seed,
@@ -19849,12 +20927,12 @@ var init_OutputSerializer = __esm({
         }));
         const csv = import_papaparse2.default.unparse(rows, { header: true });
         const filename = `${slug}-ai-overview-${Date.now()}.csv`;
-        const fullPath = import_node_path8.default.join(outputDir, filename);
-        await import_node_fs5.promises.writeFile(fullPath, csv, "utf8");
+        const fullPath = import_node_path11.default.join(outputDir, filename);
+        await import_node_fs7.promises.writeFile(fullPath, csv, "utf8");
         return fullPath;
       }
       async writeAIModeCSV(citations, text, seed, outputDir) {
-        await import_node_fs5.promises.mkdir(outputDir, { recursive: true });
+        await import_node_fs7.promises.mkdir(outputDir, { recursive: true });
         const slug = seed.toLowerCase().replace(/\W+/g, "-").slice(0, 40);
         const rows = citations.map((c, i) => ({
           seed_query: seed,
@@ -19864,18 +20942,18 @@ var init_OutputSerializer = __esm({
         }));
         const csv = import_papaparse2.default.unparse(rows, { header: true });
         const filename = `${slug}-ai-mode-${Date.now()}.csv`;
-        const fullPath = import_node_path8.default.join(outputDir, filename);
-        await import_node_fs5.promises.writeFile(fullPath, csv, "utf8");
+        const fullPath = import_node_path11.default.join(outputDir, filename);
+        await import_node_fs7.promises.writeFile(fullPath, csv, "utf8");
         return fullPath;
       }
       async writeWhatPeopleSayingCSV(cards, seed, outputDir) {
-        await import_node_fs5.promises.mkdir(outputDir, { recursive: true });
+        await import_node_fs7.promises.mkdir(outputDir, { recursive: true });
         const slug = seed.toLowerCase().replace(/\W+/g, "-").slice(0, 40);
         const rows = cards.map((c) => ({ seed_query: seed, ...c }));
         const csv = import_papaparse2.default.unparse(rows, { header: true });
         const filename = `${slug}-what-people-saying-${Date.now()}.csv`;
-        const fullPath = import_node_path8.default.join(outputDir, filename);
-        await import_node_fs5.promises.writeFile(fullPath, csv, "utf8");
+        const fullPath = import_node_path11.default.join(outputDir, filename);
+        await import_node_fs7.promises.writeFile(fullPath, csv, "utf8");
         return fullPath;
       }
     };
@@ -20426,11 +21504,11 @@ function isPublicHttpUrl(value) {
     return false;
   }
 }
-var import_zod25, SerpIntelligenceDeviceValues, SerpIntelligenceProxyModeValues, SerpIntelligenceAttemptOutcomeValues, SerpIntelligenceLocalizationStatusValues, SerpPageSnapshotSourceKindValues, SerpPageFetchStatusValues, SerpPageFetchedViaValues, HostnameSuffixPattern, Ipv4Pattern, SerpIntelligencePublicHttpUrlSchema, SerpIntelligenceCaptureBodySchema, SerpIntelligencePageSnapshotRequestSchema, SerpIntelligencePageSnapshotsBodySchema, SerpIntelligenceAICitationSchema, SerpIntelligenceOrganicResultSchema, SerpIntelligenceLocationEvidenceSchema, SerpIntelligenceHarvestResultSchema, SerpIntelligenceCaptureAttemptSchema, SerpPageSnapshotCaptureSchema, SerpIntelligenceCaptureResponseSchema, SerpIntelligencePageSnapshotsResponseSchema;
+var import_zod26, SerpIntelligenceDeviceValues, SerpIntelligenceProxyModeValues, SerpIntelligenceAttemptOutcomeValues, SerpIntelligenceLocalizationStatusValues, SerpPageSnapshotSourceKindValues, SerpPageFetchStatusValues, SerpPageFetchedViaValues, HostnameSuffixPattern, Ipv4Pattern, SerpIntelligencePublicHttpUrlSchema, SerpIntelligenceCaptureBodySchema, SerpIntelligencePageSnapshotRequestSchema, SerpIntelligencePageSnapshotsBodySchema, SerpIntelligenceAICitationSchema, SerpIntelligenceOrganicResultSchema, SerpIntelligenceLocationEvidenceSchema, SerpIntelligenceHarvestResultSchema, SerpIntelligenceCaptureAttemptSchema, SerpPageSnapshotCaptureSchema, SerpIntelligenceCaptureResponseSchema, SerpIntelligencePageSnapshotsResponseSchema;
 var init_schemas4 = __esm({
   "src/serp-intelligence/schemas.ts"() {
     "use strict";
-    import_zod25 = require("zod");
+    import_zod26 = require("zod");
     init_schemas3();
     SerpIntelligenceDeviceValues = ["desktop", "mobile"];
     SerpIntelligenceProxyModeValues = ["location", "configured", "none"];
@@ -20465,171 +21543,171 @@ var init_schemas4 = __esm({
     SerpPageFetchedViaValues = ["fetch", "headless", "browser", "mcp"];
     HostnameSuffixPattern = /(^|\.)localhost$/i;
     Ipv4Pattern = /^\d{1,3}(?:\.\d{1,3}){3}$/;
-    SerpIntelligencePublicHttpUrlSchema = import_zod25.z.string().url().refine(isPublicHttpUrl, "url must be a public HTTP or HTTPS URL");
-    SerpIntelligenceCaptureBodySchema = import_zod25.z.object({
-      query: import_zod25.z.string().trim().min(1, "query is required"),
-      location: import_zod25.z.string().trim().min(1).optional(),
-      gl: import_zod25.z.string().trim().length(2).default("us"),
-      hl: import_zod25.z.string().trim().length(2).default("en"),
-      device: import_zod25.z.enum(SerpIntelligenceDeviceValues).default("desktop"),
-      proxyMode: import_zod25.z.enum(SerpIntelligenceProxyModeValues).default(DEFAULT_PROXY_MODE),
-      proxyZip: import_zod25.z.string().regex(/^\d{5}$/).optional(),
-      pages: import_zod25.z.number().int().min(1).max(2).default(1),
-      debug: import_zod25.z.boolean().default(false),
-      includePageSnapshots: import_zod25.z.boolean().default(false),
-      pageSnapshotLimit: import_zod25.z.number().int().min(0).max(10).default(0)
+    SerpIntelligencePublicHttpUrlSchema = import_zod26.z.string().url().refine(isPublicHttpUrl, "url must be a public HTTP or HTTPS URL");
+    SerpIntelligenceCaptureBodySchema = import_zod26.z.object({
+      query: import_zod26.z.string().trim().min(1, "query is required"),
+      location: import_zod26.z.string().trim().min(1).optional(),
+      gl: import_zod26.z.string().trim().length(2).default("us"),
+      hl: import_zod26.z.string().trim().length(2).default("en"),
+      device: import_zod26.z.enum(SerpIntelligenceDeviceValues).default("desktop"),
+      proxyMode: import_zod26.z.enum(SerpIntelligenceProxyModeValues).default(DEFAULT_PROXY_MODE),
+      proxyZip: import_zod26.z.string().regex(/^\d{5}$/).optional(),
+      pages: import_zod26.z.number().int().min(1).max(2).default(1),
+      debug: import_zod26.z.boolean().default(false),
+      includePageSnapshots: import_zod26.z.boolean().default(false),
+      pageSnapshotLimit: import_zod26.z.number().int().min(0).max(10).default(0)
     }).strict();
-    SerpIntelligencePageSnapshotRequestSchema = import_zod25.z.object({
+    SerpIntelligencePageSnapshotRequestSchema = import_zod26.z.object({
       url: SerpIntelligencePublicHttpUrlSchema,
-      sourceKind: import_zod25.z.enum(SerpPageSnapshotSourceKindValues).default("configured_target"),
-      sourcePosition: import_zod25.z.number().int().min(1).optional()
+      sourceKind: import_zod26.z.enum(SerpPageSnapshotSourceKindValues).default("configured_target"),
+      sourcePosition: import_zod26.z.number().int().min(1).optional()
     }).strict();
-    SerpIntelligencePageSnapshotsBodySchema = import_zod25.z.object({
-      urls: import_zod25.z.array(SerpIntelligencePublicHttpUrlSchema).min(1).max(25),
-      targets: import_zod25.z.array(SerpIntelligencePageSnapshotRequestSchema).min(1).max(25).optional(),
-      maxConcurrency: import_zod25.z.number().int().min(1).max(5).default(2),
-      timeoutMs: import_zod25.z.number().int().min(1e3).max(6e4).default(15e3),
-      debug: import_zod25.z.boolean().default(false)
+    SerpIntelligencePageSnapshotsBodySchema = import_zod26.z.object({
+      urls: import_zod26.z.array(SerpIntelligencePublicHttpUrlSchema).min(1).max(25),
+      targets: import_zod26.z.array(SerpIntelligencePageSnapshotRequestSchema).min(1).max(25).optional(),
+      maxConcurrency: import_zod26.z.number().int().min(1).max(5).default(2),
+      timeoutMs: import_zod26.z.number().int().min(1e3).max(6e4).default(15e3),
+      debug: import_zod26.z.boolean().default(false)
     }).strict();
-    SerpIntelligenceAICitationSchema = import_zod25.z.object({
-      text: import_zod25.z.string(),
-      href: import_zod25.z.string()
+    SerpIntelligenceAICitationSchema = import_zod26.z.object({
+      text: import_zod26.z.string(),
+      href: import_zod26.z.string()
     }).strict();
-    SerpIntelligenceOrganicResultSchema = import_zod25.z.object({
-      position: import_zod25.z.number().int().min(1),
-      title: import_zod25.z.string(),
-      url: import_zod25.z.string(),
-      domain: import_zod25.z.string(),
-      cite: import_zod25.z.string().nullable(),
-      snippet: import_zod25.z.string().nullable(),
-      isRedditStyle: import_zod25.z.boolean(),
-      inlineRating: import_zod25.z.object({
-        value: import_zod25.z.string(),
-        count: import_zod25.z.string()
+    SerpIntelligenceOrganicResultSchema = import_zod26.z.object({
+      position: import_zod26.z.number().int().min(1),
+      title: import_zod26.z.string(),
+      url: import_zod26.z.string(),
+      domain: import_zod26.z.string(),
+      cite: import_zod26.z.string().nullable(),
+      snippet: import_zod26.z.string().nullable(),
+      isRedditStyle: import_zod26.z.boolean(),
+      inlineRating: import_zod26.z.object({
+        value: import_zod26.z.string(),
+        count: import_zod26.z.string()
       }).strict().nullable()
     }).strict();
-    SerpIntelligenceLocationEvidenceSchema = import_zod25.z.object({
-      status: import_zod25.z.enum(SerpIntelligenceLocalizationStatusValues),
-      expected: import_zod25.z.object({
-        city: import_zod25.z.string(),
-        regionCode: import_zod25.z.string().nullable(),
-        canonicalLocation: import_zod25.z.string()
+    SerpIntelligenceLocationEvidenceSchema = import_zod26.z.object({
+      status: import_zod26.z.enum(SerpIntelligenceLocalizationStatusValues),
+      expected: import_zod26.z.object({
+        city: import_zod26.z.string(),
+        regionCode: import_zod26.z.string().nullable(),
+        canonicalLocation: import_zod26.z.string()
       }).strict().nullable(),
-      candidates: import_zod25.z.array(import_zod25.z.object({
-        city: import_zod25.z.string(),
-        regionCode: import_zod25.z.string(),
-        count: import_zod25.z.number().int().min(0),
-        examples: import_zod25.z.array(import_zod25.z.string())
+      candidates: import_zod26.z.array(import_zod26.z.object({
+        city: import_zod26.z.string(),
+        regionCode: import_zod26.z.string(),
+        count: import_zod26.z.number().int().min(0),
+        examples: import_zod26.z.array(import_zod26.z.string())
       }).strict())
     }).strict();
-    SerpIntelligenceHarvestResultSchema = import_zod25.z.object({
-      seed: import_zod25.z.string(),
-      location: import_zod25.z.string().nullable(),
-      extractedAt: import_zod25.z.string(),
-      totalQuestions: import_zod25.z.number().int().min(0),
-      surface: import_zod25.z.enum(["web", "aim", "unknown"]),
-      aiOverview: import_zod25.z.object({
-        detected: import_zod25.z.boolean(),
-        text: import_zod25.z.string().nullable(),
-        citations: import_zod25.z.array(SerpIntelligenceAICitationSchema),
-        expanded: import_zod25.z.boolean().optional(),
-        fullyExpanded: import_zod25.z.boolean().optional(),
-        sections: import_zod25.z.array(import_zod25.z.string()).optional()
+    SerpIntelligenceHarvestResultSchema = import_zod26.z.object({
+      seed: import_zod26.z.string(),
+      location: import_zod26.z.string().nullable(),
+      extractedAt: import_zod26.z.string(),
+      totalQuestions: import_zod26.z.number().int().min(0),
+      surface: import_zod26.z.enum(["web", "aim", "unknown"]),
+      aiOverview: import_zod26.z.object({
+        detected: import_zod26.z.boolean(),
+        text: import_zod26.z.string().nullable(),
+        citations: import_zod26.z.array(SerpIntelligenceAICitationSchema),
+        expanded: import_zod26.z.boolean().optional(),
+        fullyExpanded: import_zod26.z.boolean().optional(),
+        sections: import_zod26.z.array(import_zod26.z.string()).optional()
       }).strict(),
-      aiMode: import_zod25.z.object({
-        detected: import_zod25.z.boolean(),
-        text: import_zod25.z.string().nullable(),
-        citations: import_zod25.z.array(SerpIntelligenceAICitationSchema)
+      aiMode: import_zod26.z.object({
+        detected: import_zod26.z.boolean(),
+        text: import_zod26.z.string().nullable(),
+        citations: import_zod26.z.array(SerpIntelligenceAICitationSchema)
       }).strict(),
-      tree: import_zod25.z.array(import_zod25.z.unknown()),
-      flat: import_zod25.z.array(import_zod25.z.unknown()),
-      videos: import_zod25.z.array(import_zod25.z.unknown()),
-      forums: import_zod25.z.array(import_zod25.z.unknown()),
-      organicResults: import_zod25.z.array(SerpIntelligenceOrganicResultSchema),
-      localPack: import_zod25.z.array(import_zod25.z.unknown()),
-      entityIds: import_zod25.z.object({
-        entities: import_zod25.z.array(import_zod25.z.object({
-          name: import_zod25.z.string(),
-          kgId: import_zod25.z.string().nullable(),
-          cid: import_zod25.z.string().nullable(),
-          gcid: import_zod25.z.string().nullable()
+      tree: import_zod26.z.array(import_zod26.z.unknown()),
+      flat: import_zod26.z.array(import_zod26.z.unknown()),
+      videos: import_zod26.z.array(import_zod26.z.unknown()),
+      forums: import_zod26.z.array(import_zod26.z.unknown()),
+      organicResults: import_zod26.z.array(SerpIntelligenceOrganicResultSchema),
+      localPack: import_zod26.z.array(import_zod26.z.unknown()),
+      entityIds: import_zod26.z.object({
+        entities: import_zod26.z.array(import_zod26.z.object({
+          name: import_zod26.z.string(),
+          kgId: import_zod26.z.string().nullable(),
+          cid: import_zod26.z.string().nullable(),
+          gcid: import_zod26.z.string().nullable()
         }).strict()),
-        kgIds: import_zod25.z.array(import_zod25.z.string()),
-        cids: import_zod25.z.array(import_zod25.z.string()),
-        gcids: import_zod25.z.array(import_zod25.z.string())
+        kgIds: import_zod26.z.array(import_zod26.z.string()),
+        cids: import_zod26.z.array(import_zod26.z.string()),
+        gcids: import_zod26.z.array(import_zod26.z.string())
       }).strict(),
-      stats: import_zod25.z.object({
-        seed: import_zod25.z.string(),
-        totalQuestions: import_zod25.z.number().int().min(0),
-        maxDepthReached: import_zod25.z.number().int().min(0),
-        durationMs: import_zod25.z.number().min(0),
-        errorCount: import_zod25.z.number().int().min(0)
+      stats: import_zod26.z.object({
+        seed: import_zod26.z.string(),
+        totalQuestions: import_zod26.z.number().int().min(0),
+        maxDepthReached: import_zod26.z.number().int().min(0),
+        durationMs: import_zod26.z.number().min(0),
+        errorCount: import_zod26.z.number().int().min(0)
       }).strict(),
-      diagnostics: import_zod25.z.object({
-        completionStatus: import_zod25.z.enum(["paa_found", "no_paa", "serp_only"]),
-        problem: import_zod25.z.null(),
-        warnings: import_zod25.z.array(import_zod25.z.unknown()).optional(),
-        debug: import_zod25.z.object({
+      diagnostics: import_zod26.z.object({
+        completionStatus: import_zod26.z.enum(["paa_found", "no_paa", "serp_only"]),
+        problem: import_zod26.z.null(),
+        warnings: import_zod26.z.array(import_zod26.z.unknown()).optional(),
+        debug: import_zod26.z.object({
           locationEvidence: SerpIntelligenceLocationEvidenceSchema.optional()
         }).passthrough().optional()
       }).passthrough(),
-      whatPeopleSaying: import_zod25.z.array(import_zod25.z.unknown())
+      whatPeopleSaying: import_zod26.z.array(import_zod26.z.unknown())
     }).strict();
-    SerpIntelligenceCaptureAttemptSchema = import_zod25.z.object({
-      attemptNumber: import_zod25.z.number().int().min(1),
-      outcome: import_zod25.z.enum(SerpIntelligenceAttemptOutcomeValues),
-      startedAt: import_zod25.z.string().optional(),
-      completedAt: import_zod25.z.string().optional(),
-      durationMs: import_zod25.z.number().min(0).optional(),
-      problemCode: import_zod25.z.string().optional(),
-      message: import_zod25.z.string().optional(),
-      kernelSessionId: import_zod25.z.string().nullable().optional(),
-      cleanupSucceeded: import_zod25.z.boolean().nullable().optional()
+    SerpIntelligenceCaptureAttemptSchema = import_zod26.z.object({
+      attemptNumber: import_zod26.z.number().int().min(1),
+      outcome: import_zod26.z.enum(SerpIntelligenceAttemptOutcomeValues),
+      startedAt: import_zod26.z.string().optional(),
+      completedAt: import_zod26.z.string().optional(),
+      durationMs: import_zod26.z.number().min(0).optional(),
+      problemCode: import_zod26.z.string().optional(),
+      message: import_zod26.z.string().optional(),
+      kernelSessionId: import_zod26.z.string().nullable().optional(),
+      cleanupSucceeded: import_zod26.z.boolean().nullable().optional()
     }).strict();
-    SerpPageSnapshotCaptureSchema = import_zod25.z.object({
+    SerpPageSnapshotCaptureSchema = import_zod26.z.object({
       url: SerpIntelligencePublicHttpUrlSchema,
       requestedUrl: SerpIntelligencePublicHttpUrlSchema,
       finalUrl: SerpIntelligencePublicHttpUrlSchema.nullable(),
-      sourceKind: import_zod25.z.enum(SerpPageSnapshotSourceKindValues),
-      sourcePosition: import_zod25.z.number().int().min(1).nullable(),
-      status: import_zod25.z.enum(SerpPageFetchStatusValues),
-      fetchedVia: import_zod25.z.enum(SerpPageFetchedViaValues).nullable(),
-      httpStatus: import_zod25.z.number().int().min(100).max(599).nullable(),
-      contentType: import_zod25.z.string().nullable(),
-      title: import_zod25.z.string().nullable(),
+      sourceKind: import_zod26.z.enum(SerpPageSnapshotSourceKindValues),
+      sourcePosition: import_zod26.z.number().int().min(1).nullable(),
+      status: import_zod26.z.enum(SerpPageFetchStatusValues),
+      fetchedVia: import_zod26.z.enum(SerpPageFetchedViaValues).nullable(),
+      httpStatus: import_zod26.z.number().int().min(100).max(599).nullable(),
+      contentType: import_zod26.z.string().nullable(),
+      title: import_zod26.z.string().nullable(),
       canonicalUrl: SerpIntelligencePublicHttpUrlSchema.nullable(),
-      metaDescription: import_zod25.z.string().nullable(),
-      headings: import_zod25.z.array(import_zod25.z.object({
-        level: import_zod25.z.number().int().min(1).max(6),
-        text: import_zod25.z.string()
+      metaDescription: import_zod26.z.string().nullable(),
+      headings: import_zod26.z.array(import_zod26.z.object({
+        level: import_zod26.z.number().int().min(1).max(6),
+        text: import_zod26.z.string()
       }).strict()).default([]),
-      artifact: import_zod25.z.object({
-        htmlBlobUrl: import_zod25.z.string().url().nullable(),
-        textBlobUrl: import_zod25.z.string().url().nullable(),
-        markdownBlobUrl: import_zod25.z.string().url().nullable(),
-        screenshotBlobUrl: import_zod25.z.string().url().nullable(),
-        contentSha256: import_zod25.z.string().nullable(),
-        capturedAt: import_zod25.z.string().nullable()
+      artifact: import_zod26.z.object({
+        htmlBlobUrl: import_zod26.z.string().url().nullable(),
+        textBlobUrl: import_zod26.z.string().url().nullable(),
+        markdownBlobUrl: import_zod26.z.string().url().nullable(),
+        screenshotBlobUrl: import_zod26.z.string().url().nullable(),
+        contentSha256: import_zod26.z.string().nullable(),
+        capturedAt: import_zod26.z.string().nullable()
       }).strict(),
-      error: import_zod25.z.object({
-        code: import_zod25.z.string(),
-        message: import_zod25.z.string()
+      error: import_zod26.z.object({
+        code: import_zod26.z.string(),
+        message: import_zod26.z.string()
       }).strict().nullable()
     }).strict();
-    SerpIntelligenceCaptureResponseSchema = import_zod25.z.object({
+    SerpIntelligenceCaptureResponseSchema = import_zod26.z.object({
       harvestResult: SerpIntelligenceHarvestResultSchema,
-      attempts: import_zod25.z.array(SerpIntelligenceCaptureAttemptSchema),
+      attempts: import_zod26.z.array(SerpIntelligenceCaptureAttemptSchema),
       locationEvidence: SerpIntelligenceLocationEvidenceSchema.nullable(),
-      pageSnapshotArtifacts: import_zod25.z.array(SerpPageSnapshotCaptureSchema),
-      billing: import_zod25.z.object({
-        creditsUsed: import_zod25.z.number().min(0).optional(),
-        requestId: import_zod25.z.string().optional(),
-        jobId: import_zod25.z.string().optional()
+      pageSnapshotArtifacts: import_zod26.z.array(SerpPageSnapshotCaptureSchema),
+      billing: import_zod26.z.object({
+        creditsUsed: import_zod26.z.number().min(0).optional(),
+        requestId: import_zod26.z.string().optional(),
+        jobId: import_zod26.z.string().optional()
       }).strict().optional()
     }).strict();
-    SerpIntelligencePageSnapshotsResponseSchema = import_zod25.z.object({
-      pageSnapshotArtifacts: import_zod25.z.array(SerpPageSnapshotCaptureSchema),
-      attempts: import_zod25.z.array(SerpIntelligenceCaptureAttemptSchema).default([])
+    SerpIntelligencePageSnapshotsResponseSchema = import_zod26.z.object({
+      pageSnapshotArtifacts: import_zod26.z.array(SerpPageSnapshotCaptureSchema),
+      attempts: import_zod26.z.array(SerpIntelligenceCaptureAttemptSchema).default([])
     }).strict();
   }
 });
@@ -20853,11 +21931,11 @@ function pageSnapshotTargetsFromBody(body) {
     sourcePosition: null
   }));
 }
-var import_hono8, SERP_INTELLIGENCE_RATE_LIMIT, SERP_INTELLIGENCE_RATE_WINDOW_SECONDS, POST_CAPTURE_ROUTE_LABEL, POST_PAGE_SNAPSHOTS_ROUTE_LABEL, serpIntelligenceApp;
+var import_hono9, SERP_INTELLIGENCE_RATE_LIMIT, SERP_INTELLIGENCE_RATE_WINDOW_SECONDS, POST_CAPTURE_ROUTE_LABEL, POST_PAGE_SNAPSHOTS_ROUTE_LABEL, serpIntelligenceApp;
 var init_serp_intelligence_routes = __esm({
   "src/api/serp-intelligence-routes.ts"() {
     "use strict";
-    import_hono8 = require("hono");
+    import_hono9 = require("hono");
     init_browser_service_env();
     init_page_snapshot_extractor();
     init_serp_capture_service();
@@ -20870,7 +21948,7 @@ var init_serp_intelligence_routes = __esm({
     SERP_INTELLIGENCE_RATE_WINDOW_SECONDS = 60;
     POST_CAPTURE_ROUTE_LABEL = "POST /capture";
     POST_PAGE_SNAPSHOTS_ROUTE_LABEL = "POST /page-snapshots";
-    serpIntelligenceApp = new import_hono8.Hono();
+    serpIntelligenceApp = new import_hono9.Hono();
     serpIntelligenceApp.use("*", createApiKeyAuth());
     serpIntelligenceApp.post("/capture", async (c) => {
       void POST_CAPTURE_ROUTE_LABEL;
@@ -21002,139 +22080,159 @@ var PACKAGE_VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    PACKAGE_VERSION = "0.3.1";
+    PACKAGE_VERSION = "0.3.3";
   }
 });
 
 // src/mcp/mcp-tool-schemas.ts
-var import_zod26, HarvestPaaInputSchema, ExtractUrlInputSchema, MapSiteUrlsInputSchema, ExtractSiteInputSchema, YoutubeHarvestInputSchema, YoutubeTranscribeInputSchema, FacebookPageIntelInputSchema, FacebookAdSearchInputSchema, FacebookAdTranscribeInputSchema, FacebookVideoTranscribeInputSchema, MapsPlaceIntelInputSchema, MapsSearchInputSchema, DirectoryWorkflowInputSchema, RankTrackerModeSchema, RankTrackerBlueprintInputSchema, NullableString, MapsSearchAttemptOutput, MapsSearchOutputSchema, DirectoryMapsBusinessOutput, DirectoryWorkflowOutputSchema, RankTrackerToolPlanOutput, RankTrackerTableOutput, RankTrackerCronJobOutput, RankTrackerBlueprintOutputSchema, OrganicResultOutput, AiOverviewOutput, EntityIdsOutput, HarvestPaaOutputSchema, SearchSerpOutputSchema, ExtractUrlOutputSchema, ExtractSiteOutputSchema, MapsPlaceIntelOutputSchema, CreditsInfoOutputSchema, MapSiteUrlsOutputSchema, YoutubeHarvestOutputSchema, FacebookAdSearchOutputSchema, FacebookPageIntelOutputSchema, FacebookVideoTranscribeOutputSchema, TranscriptChunkOutput, YoutubeTranscribeOutputSchema, FacebookAdTranscribeOutputSchema, CaptureSerpSnapshotOutputSchema, CaptureSerpPageSnapshotsOutputSchema, CreditsInfoInputSchema, WorkflowIdSchema2, WorkflowListInputSchema, WorkflowSuggestInputSchema, WorkflowRunInputSchema, WorkflowStepInputSchema, WorkflowStatusInputSchema, WorkflowArtifactReadInputSchema, WorkflowRecipeOutput, WorkflowDefinitionOutput, WorkflowArtifactOutput, WorkflowListOutputSchema, WorkflowSuggestOutputSchema, WorkflowRunOutputSchema, WorkflowStepOutputSchema, WorkflowStatusOutputSchema, WorkflowArtifactReadOutputSchema, SearchSerpInputSchema, CaptureSerpSnapshotInputSchema, ScreenshotInputSchema, CaptureSerpPageSnapshotsInputSchema;
+var import_zod27, HarvestPaaInputSchema, ExtractUrlInputSchema, MapSiteUrlsInputSchema, ExtractSiteInputSchema, YoutubeHarvestInputSchema, YoutubeTranscribeInputSchema, FacebookPageIntelInputSchema, FacebookAdSearchInputSchema, FacebookAdTranscribeInputSchema, FacebookVideoTranscribeInputSchema, InstagramProfileContentInputSchema, InstagramMediaDownloadInputSchema, MapsPlaceIntelInputSchema, MapsSearchInputSchema, DirectoryWorkflowInputSchema, RankTrackerModeSchema, RankTrackerBlueprintInputSchema, NullableString, MapsSearchAttemptOutput, MapsSearchOutputSchema, DirectoryMapsBusinessOutput, DirectoryWorkflowOutputSchema, RankTrackerToolPlanOutput, RankTrackerTableOutput, RankTrackerCronJobOutput, RankTrackerBlueprintOutputSchema, OrganicResultOutput, AiOverviewOutput, EntityIdsOutput, HarvestPaaOutputSchema, SearchSerpOutputSchema, ExtractUrlOutputSchema, ExtractSiteOutputSchema, MapsPlaceIntelOutputSchema, CreditsInfoOutputSchema, MapSiteUrlsOutputSchema, YoutubeHarvestOutputSchema, FacebookAdSearchOutputSchema, FacebookPageIntelOutputSchema, FacebookVideoTranscribeOutputSchema, TranscriptChunkOutput, InstagramBrowserOutput, InstagramPaginationOutput, InstagramProfileContentOutputSchema, InstagramMediaTrackOutput, InstagramDownloadOutput, InstagramMediaDownloadOutputSchema, YoutubeTranscribeOutputSchema, FacebookAdTranscribeOutputSchema, CaptureSerpSnapshotOutputSchema, CaptureSerpPageSnapshotsOutputSchema, CreditsInfoInputSchema, WorkflowIdSchema2, WorkflowListInputSchema, WorkflowSuggestInputSchema, WorkflowRunInputSchema, WorkflowStepInputSchema, WorkflowStatusInputSchema, WorkflowArtifactReadInputSchema, WorkflowRecipeOutput, WorkflowDefinitionOutput, WorkflowArtifactOutput, WorkflowListOutputSchema, WorkflowSuggestOutputSchema, WorkflowRunOutputSchema, WorkflowStepOutputSchema, WorkflowStatusOutputSchema, WorkflowArtifactReadOutputSchema, SearchSerpInputSchema, CaptureSerpSnapshotInputSchema, ScreenshotInputSchema, CaptureSerpPageSnapshotsInputSchema;
 var init_mcp_tool_schemas = __esm({
   "src/mcp/mcp-tool-schemas.ts"() {
     "use strict";
-    import_zod26 = require("zod");
+    import_zod27 = require("zod");
     init_schemas3();
     HarvestPaaInputSchema = {
-      query: import_zod26.z.string().min(1).describe('Core search topic only. If the user says "best hvac company in Denver CO", use query="best hvac company" and location="Denver, CO". Do not include the location in query when it can be separated.'),
-      location: import_zod26.z.string().optional().describe('City, region, or country for geo-targeted results, inferred from the user request when present, e.g. "Denver, CO", "Tokyo, Japan", "London, UK".'),
-      maxQuestions: import_zod26.z.number().int().min(1).max(200).default(30).describe("Number of PAA questions to extract. Default 30. Maximum 200. Use 10 for quick probes, 30 for normal research, 100-200 when the user asks for everything/full/deep research. Larger harvests get a longer server time budget (151-200 questions \u2192 up to 280s). Credits are charged by extracted question; unused request hold is refunded."),
-      gl: import_zod26.z.string().length(2).default("us").describe("Google country code inferred from location or user language. Examples: United States us, United Kingdom gb, Japan jp, Canada ca, Australia au."),
-      hl: import_zod26.z.string().default("en").describe("Google interface/content language inferred from the user request. Use en unless the user asks for another language or locale."),
-      device: import_zod26.z.enum(["desktop", "mobile"]).default("desktop").describe("SERP device context. Use desktop by default; use mobile only when the user asks for mobile rankings."),
-      proxyMode: import_zod26.z.enum(["location", "configured", "none"]).default(DEFAULT_PROXY_MODE).describe("Proxy targeting mode. Default configured uses the service proxy without city/ZIP targeting for the highest general success rate. Use location only when the user explicitly needs city/ZIP-targeted residential proxy evidence. Use none only for direct-network debugging."),
-      proxyZip: import_zod26.z.string().regex(/^\d{5}$/).optional().describe("Optional US ZIP override for residential location proxy targeting. Use only with proxyMode location when the user gives a specific ZIP or city-center targeting needs to be forced."),
-      debug: import_zod26.z.boolean().default(false).describe("Include sanitized browser/session/location diagnostics in the response. Use true when debugging localization, CAPTCHA, or proxy behavior.")
+      query: import_zod27.z.string().min(1).describe('Core search topic only. If the user says "best hvac company in Denver CO", use query="best hvac company" and location="Denver, CO". Do not include the location in query when it can be separated.'),
+      location: import_zod27.z.string().optional().describe('City, region, or country for geo-targeted results, inferred from the user request when present, e.g. "Denver, CO", "Tokyo, Japan", "London, UK".'),
+      maxQuestions: import_zod27.z.number().int().min(1).max(200).default(30).describe("Number of PAA questions to extract. Default 30. Maximum 200. Use 10 for quick probes, 30 for normal research, 100-200 when the user asks for everything/full/deep research. Larger harvests get a longer server time budget (151-200 questions \u2192 up to 280s). Credits are charged by extracted question; unused request hold is refunded."),
+      gl: import_zod27.z.string().length(2).default("us").describe("Google country code inferred from location or user language. Examples: United States us, United Kingdom gb, Japan jp, Canada ca, Australia au."),
+      hl: import_zod27.z.string().default("en").describe("Google interface/content language inferred from the user request. Use en unless the user asks for another language or locale."),
+      device: import_zod27.z.enum(["desktop", "mobile"]).default("desktop").describe("SERP device context. Use desktop by default; use mobile only when the user asks for mobile rankings."),
+      proxyMode: import_zod27.z.enum(["location", "configured", "none"]).default(DEFAULT_PROXY_MODE).describe("Proxy targeting mode. Default configured uses the service proxy without city/ZIP targeting for the highest general success rate. Use location only when the user explicitly needs city/ZIP-targeted residential proxy evidence. Use none only for direct-network debugging."),
+      proxyZip: import_zod27.z.string().regex(/^\d{5}$/).optional().describe("Optional US ZIP override for residential location proxy targeting. Use only with proxyMode location when the user gives a specific ZIP or city-center targeting needs to be forced."),
+      debug: import_zod27.z.boolean().default(false).describe("Include sanitized browser/session/location diagnostics in the response. Use true when debugging localization, CAPTCHA, or proxy behavior.")
     };
     ExtractUrlInputSchema = {
-      url: import_zod26.z.string().url().describe("Public http/https URL to extract. Use this when the user provides one specific page URL."),
-      screenshot: import_zod26.z.boolean().default(false).describe("Also capture a full-page screenshot of the URL. Saved to ~/Downloads/mcp-scraper/screenshots/ and returned inline. Use when the user asks to see or capture the page visually."),
-      screenshotDevice: import_zod26.z.enum(["desktop", "mobile"]).default("desktop").describe("Viewport for screenshot. desktop = 1440\xD7900. mobile = 390\xD7844. Default desktop."),
-      extractBranding: import_zod26.z.boolean().default(false).describe("Extract brand colors, fonts, logo, and favicon using a rendered browser session. Returns colorScheme (light/dark), colors (primary/accent/background/text/heading as hex), fonts (heading/body family names), and assets (logo URL, favicon URL). Use when the user asks about brand colors, site theme, or brand assets."),
-      downloadMedia: import_zod26.z.boolean().default(false).describe("Extract and download all page media (images, video, audio) to ~/Downloads/mcp-scraper/media/. Ad networks, tracking pixels, and noise URLs are filtered automatically. Use when the user asks to download or harvest assets from a page."),
-      mediaTypes: import_zod26.z.array(import_zod26.z.enum(["image", "video", "audio"])).default(["image", "video", "audio"]).describe("Which media types to download. Default all three."),
-      allowLocal: import_zod26.z.boolean().default(false).describe("Allow localhost and private-network URLs. For local development only.")
+      url: import_zod27.z.string().url().describe("Public http/https URL to extract. Use this when the user provides one specific page URL."),
+      screenshot: import_zod27.z.boolean().default(false).describe("Also capture a full-page screenshot of the URL. Saved to ~/Downloads/mcp-scraper/screenshots/ and returned inline. Use when the user asks to see or capture the page visually."),
+      screenshotDevice: import_zod27.z.enum(["desktop", "mobile"]).default("desktop").describe("Viewport for screenshot. desktop = 1440\xD7900. mobile = 390\xD7844. Default desktop."),
+      extractBranding: import_zod27.z.boolean().default(false).describe("Extract brand colors, fonts, logo, and favicon using a rendered browser session. Returns colorScheme (light/dark), colors (primary/accent/background/text/heading as hex), fonts (heading/body family names), and assets (logo URL, favicon URL). Use when the user asks about brand colors, site theme, or brand assets."),
+      downloadMedia: import_zod27.z.boolean().default(false).describe("Extract and download all page media (images, video, audio) to ~/Downloads/mcp-scraper/media/. Ad networks, tracking pixels, and noise URLs are filtered automatically. Use when the user asks to download or harvest assets from a page."),
+      mediaTypes: import_zod27.z.array(import_zod27.z.enum(["image", "video", "audio"])).default(["image", "video", "audio"]).describe("Which media types to download. Default all three."),
+      allowLocal: import_zod27.z.boolean().default(false).describe("Allow localhost and private-network URLs. For local development only.")
     };
     MapSiteUrlsInputSchema = {
-      url: import_zod26.z.string().url().describe("Public website URL or domain to crawl for internal URLs. Use before extract_site when the user asks to audit/map/crawl a site."),
-      maxUrls: import_zod26.z.number().int().min(1).max(500).optional().describe("Maximum URLs to discover. Use 100 for normal maps, higher when the user asks for a full inventory.")
+      url: import_zod27.z.string().url().describe("Public website URL or domain to crawl for internal URLs. Use before extract_site when the user asks to audit/map/crawl a site."),
+      maxUrls: import_zod27.z.number().int().min(1).max(500).optional().describe("Maximum URLs to discover. Use 100 for normal maps, higher when the user asks for a full inventory.")
     };
     ExtractSiteInputSchema = {
-      url: import_zod26.z.string().url().describe("Public website URL or domain to extract across multiple pages. Use when the user asks for a site audit, website crawl, or full-site content/schema extraction."),
-      maxPages: import_zod26.z.number().int().min(1).max(50).optional().describe("Maximum pages to extract. Use 50 when the user asks for full results or a complete crawl within MCP limits.")
+      url: import_zod27.z.string().url().describe("Public website URL or domain to extract across multiple pages. Use when the user asks for a site audit, website crawl, or full-site content/schema extraction."),
+      maxPages: import_zod27.z.number().int().min(1).max(50).optional().describe("Maximum pages to extract. Use 50 when the user asks for full results or a complete crawl within MCP limits.")
     };
     YoutubeHarvestInputSchema = {
-      mode: import_zod26.z.enum(["search", "channel"]).describe("Use search for topic/keyword requests. Use channel when the user provides @handle, channel ID, or channel URL."),
-      query: import_zod26.z.string().optional().describe("Required when mode is search. The YouTube search topic in the user\u2019s words."),
-      channelHandle: import_zod26.z.string().optional().describe("YouTube channel handle, channel ID, or URL. Examples: @mkbhd, UC..., https://youtube.com/@mkbhd."),
-      maxVideos: import_zod26.z.number().int().min(1).max(500).default(50).describe("Number of videos to return. Default 50, maximum 500. Use 10-25 for quick topic discovery, 50 for normal channel/search harvests, and larger values only when the user asks for full channel/history because large responses consume more context.")
+      mode: import_zod27.z.enum(["search", "channel"]).describe("Use search for topic/keyword requests. Use channel when the user provides @handle, channel ID, or channel URL."),
+      query: import_zod27.z.string().optional().describe("Required when mode is search. The YouTube search topic in the user\u2019s words."),
+      channelHandle: import_zod27.z.string().optional().describe("YouTube channel handle, channel ID, or URL. Examples: @mkbhd, UC..., https://youtube.com/@mkbhd."),
+      maxVideos: import_zod27.z.number().int().min(1).max(500).default(50).describe("Number of videos to return. Default 50, maximum 500. Use 10-25 for quick topic discovery, 50 for normal channel/search harvests, and larger values only when the user asks for full channel/history because large responses consume more context.")
     };
     YoutubeTranscribeInputSchema = {
-      videoId: import_zod26.z.string().min(1).optional().describe("YouTube video ID, e.g. dQw4w9WgXcQ. Use only an ID returned by youtube_harvest or visible in a YouTube URL; do not invent one."),
-      url: import_zod26.z.string().url().optional().describe("Full YouTube URL, e.g. https://www.youtube.com/watch?v=dQw4w9WgXcQ or https://youtu.be/dQw4w9WgXcQ. Use this when the user pasted a URL instead of an ID. Provide videoId or url.")
+      videoId: import_zod27.z.string().min(1).optional().describe("YouTube video ID, e.g. dQw4w9WgXcQ. Use only an ID returned by youtube_harvest or visible in a YouTube URL; do not invent one."),
+      url: import_zod27.z.string().url().optional().describe("Full YouTube URL, e.g. https://www.youtube.com/watch?v=dQw4w9WgXcQ or https://youtu.be/dQw4w9WgXcQ. Use this when the user pasted a URL instead of an ID. Provide videoId or url.")
     };
     FacebookPageIntelInputSchema = {
-      pageId: import_zod26.z.string().optional().describe("Facebook advertiser/page ID. Use only a pageId returned by facebook_ad_search/facebook_page_intel or copied from Facebook Ad Library; do not construct one yourself."),
-      libraryId: import_zod26.z.string().optional().describe("Facebook Ad Library archive ID for a known ad or advertiser sample. Use a libraryId returned by facebook_ad_search, or a libraryId/adArchiveId visible in Ad Library."),
-      query: import_zod26.z.string().optional().describe("Advertiser or brand name when pageId/libraryId is not known. One of pageId, libraryId, or query is required."),
-      maxAds: import_zod26.z.number().int().min(1).max(200).default(50).describe("Maximum ads to inspect. Default 50, maximum 200. Prefer 25-50 for focused advertiser scans; use 100-200 only when the user asks for a broad ad archive sweep."),
-      country: import_zod26.z.string().length(2).default("US").describe("Two-letter Ad Library country code. Default US. Examples: US, CA, GB, AU. Infer from the user request when they name a country.")
+      pageId: import_zod27.z.string().optional().describe("Facebook advertiser/page ID. Use only a pageId returned by facebook_ad_search/facebook_page_intel or copied from Facebook Ad Library; do not construct one yourself."),
+      libraryId: import_zod27.z.string().optional().describe("Facebook Ad Library archive ID for a known ad or advertiser sample. Use a libraryId returned by facebook_ad_search, or a libraryId/adArchiveId visible in Ad Library."),
+      query: import_zod27.z.string().optional().describe("Advertiser or brand name when pageId/libraryId is not known. One of pageId, libraryId, or query is required."),
+      maxAds: import_zod27.z.number().int().min(1).max(200).default(50).describe("Maximum ads to inspect. Default 50, maximum 200. Prefer 25-50 for focused advertiser scans; use 100-200 only when the user asks for a broad ad archive sweep."),
+      country: import_zod27.z.string().length(2).default("US").describe("Two-letter Ad Library country code. Default US. Examples: US, CA, GB, AU. Infer from the user request when they name a country.")
     };
     FacebookAdSearchInputSchema = {
-      query: import_zod26.z.string().min(1).describe("Advertiser, brand, competitor, niche, or keyword to search in Facebook Ad Library."),
-      country: import_zod26.z.string().length(2).default("US").describe("Two-letter Ad Library country code. Default US. Examples: US, CA, GB, AU."),
-      maxResults: import_zod26.z.number().int().min(1).max(20).default(10).describe("Maximum advertisers to return. Default 10, maximum 20. Prefer tighter search terms over maxing this out.")
+      query: import_zod27.z.string().min(1).describe("Advertiser, brand, competitor, niche, or keyword to search in Facebook Ad Library."),
+      country: import_zod27.z.string().length(2).default("US").describe("Two-letter Ad Library country code. Default US. Examples: US, CA, GB, AU."),
+      maxResults: import_zod27.z.number().int().min(1).max(20).default(10).describe("Maximum advertisers to return. Default 10, maximum 20. Prefer tighter search terms over maxing this out.")
     };
     FacebookAdTranscribeInputSchema = {
-      videoUrl: import_zod26.z.string().url().describe("Direct Facebook CDN video URL from a facebook_page_intel ad result. Do not pass a public Facebook reel/post/share URL here; use facebook_video_transcribe for organic Facebook URLs.")
+      videoUrl: import_zod27.z.string().url().describe("Direct Facebook CDN video URL from a facebook_page_intel ad result. Do not pass a public Facebook reel/post/share URL here; use facebook_video_transcribe for organic Facebook URLs.")
     };
     FacebookVideoTranscribeInputSchema = {
-      url: import_zod26.z.string().url().describe("Organic Facebook reel, video, watch, post, or share URL from facebook.com, m.facebook.com, or fb.watch. The tool renders the page, extracts the best matching public Facebook CDN MP4 URL, then transcribes it. Use this when the user pastes a normal Facebook video page URL and asks for the transcript or downloadable MP4."),
-      quality: import_zod26.z.enum(["best", "hd", "sd"]).default("best").describe("Preferred progressive MP4 quality. Use best by default; hd prefers the highest HD progressive URL; sd forces the SD URL.")
+      url: import_zod27.z.string().url().describe("Organic Facebook reel, video, watch, post, or share URL from facebook.com, m.facebook.com, or fb.watch. The tool renders the page, extracts the best matching public Facebook CDN MP4 URL, then transcribes it. Use this when the user pastes a normal Facebook video page URL and asks for the transcript or downloadable MP4."),
+      quality: import_zod27.z.enum(["best", "hd", "sd"]).default("best").describe("Preferred progressive MP4 quality. Use best by default; hd prefers the highest HD progressive URL; sd forces the SD URL.")
+    };
+    InstagramProfileContentInputSchema = {
+      handle: import_zod27.z.string().min(1).optional().describe("Instagram handle, with or without @. Provide handle or url. Use only public profiles unless a configured browser profile is available server-side."),
+      url: import_zod27.z.string().url().optional().describe("Instagram profile URL, e.g. https://www.instagram.com/nasaartemis/. Provide handle or url."),
+      maxItems: import_zod27.z.number().int().min(1).max(500).default(50).describe("Maximum profile grid post/reel/tv URLs to collect. Default 50, maximum 500. Use higher values with an authenticated browser profile when the user asks for a fuller archive."),
+      maxScrolls: import_zod27.z.number().int().min(0).max(100).default(10).describe("Maximum pagination scroll attempts. Default 10, maximum 100. Increase when using authenticated Chromium and the profile has a long history."),
+      scrollDelayMs: import_zod27.z.number().int().min(250).max(5e3).default(1200).describe("Delay after each pagination scroll before collecting newly loaded links. Default 1200ms. Increase to 2000-3000ms when Instagram loads slowly."),
+      stableScrollLimit: import_zod27.z.number().int().min(1).max(10).default(4).describe("Stop after this many consecutive scrolls with no new links or scroll progress. Default 4."),
+      browserMode: import_zod27.z.enum(["auto", "hosted", "local"]).default("auto").describe("Browser backend. auto uses the hosted browser unless local mode is configured or browserProfile is passed. local uses an imported/authenticated Chrome profile from browser_profile_import/sync. hosted forces the remote browser path."),
+      browserProfile: import_zod27.z.string().min(1).optional().describe("Managed local browser profile name created by browser_profile_import/sync. Passing this opts the Instagram tool into local authenticated Chromium for this call.")
+    };
+    InstagramMediaDownloadInputSchema = {
+      url: import_zod27.z.string().url().describe("Instagram post, reel, or tv URL, e.g. https://www.instagram.com/reel/SHORTCODE/. The tool renders the page, extracts text, image metadata, and Instagram CDN media tracks."),
+      mediaTypes: import_zod27.z.array(import_zod27.z.enum(["image", "video", "audio"])).default(["image", "video", "audio"]).describe("Which media types to download when downloadMedia is true. Reels commonly expose separate video-only and audio-only MP4 tracks."),
+      downloadMedia: import_zod27.z.boolean().default(true).describe("Download extracted text/media files to the MCP Scraper output directory when the API server can write files. Always returns extracted media URLs even when false."),
+      downloadAllTracks: import_zod27.z.boolean().default(false).describe("Download every captured Instagram MP4 track instead of only the selected best video and audio tracks. Use false by default to avoid duplicate bitrates."),
+      includeTranscript: import_zod27.z.boolean().default(false).describe("Transcribe the selected audio track when available. This adds transcription cost and may take longer."),
+      mux: import_zod27.z.boolean().default(true).describe("When video and audio tracks are downloaded separately, try to mux them into a single MP4 if ffmpeg is available. Returns separate tracks when muxing is unavailable."),
+      browserMode: import_zod27.z.enum(["auto", "hosted", "local"]).default("auto").describe("Browser backend. auto uses the hosted browser unless local mode is configured or browserProfile is passed. local uses an imported/authenticated Chrome profile from browser_profile_import/sync. hosted forces the remote browser path."),
+      browserProfile: import_zod27.z.string().min(1).optional().describe("Managed local browser profile name created by browser_profile_import/sync. Passing this opts the Instagram tool into local authenticated Chromium for this call.")
     };
     MapsPlaceIntelInputSchema = {
-      businessName: import_zod26.z.string().min(1).describe('Business name only. If user says "Elite Roofing Denver CO", use businessName="Elite Roofing" and location="Denver, CO".'),
-      location: import_zod26.z.string().min(1).describe('City/region/country where the business should be searched, e.g. "Denver, CO". Infer from the user request when possible.'),
-      gl: import_zod26.z.string().length(2).default("us").describe("Google country code inferred from location."),
-      hl: import_zod26.z.string().length(2).default("en").describe("Language inferred from user request."),
-      includeReviews: import_zod26.z.boolean().default(false).describe("Whether to fetch individual review cards. Use true when the user asks for reviews, customer pain, complaints, praise, themes, or review evidence."),
-      maxReviews: import_zod26.z.number().int().min(1).max(500).default(50).describe("Max review cards to return when includeReviews is true. Default 50, maximum 500. Use 50 for normal review analysis and larger values only for deep review mining.")
+      businessName: import_zod27.z.string().min(1).describe('Business name only. If user says "Elite Roofing Denver CO", use businessName="Elite Roofing" and location="Denver, CO".'),
+      location: import_zod27.z.string().min(1).describe('City/region/country where the business should be searched, e.g. "Denver, CO". Infer from the user request when possible.'),
+      gl: import_zod27.z.string().length(2).default("us").describe("Google country code inferred from location."),
+      hl: import_zod27.z.string().length(2).default("en").describe("Language inferred from user request."),
+      includeReviews: import_zod27.z.boolean().default(false).describe("Whether to fetch individual review cards. Use true when the user asks for reviews, customer pain, complaints, praise, themes, or review evidence."),
+      maxReviews: import_zod27.z.number().int().min(1).max(500).default(50).describe("Max review cards to return when includeReviews is true. Default 50, maximum 500. Use 50 for normal review analysis and larger values only for deep review mining.")
     };
     MapsSearchInputSchema = {
-      query: import_zod26.z.string().min(1).describe('Business category, niche, keyword, or search term. If the user says "roofers in Denver CO", use query="roofers" and location="Denver, CO". Do not put the location here when it can be separated.'),
-      location: import_zod26.z.string().optional().describe('City, region, country, or service area for the Maps search, e.g. "Denver, CO". Infer from the user request when present.'),
-      gl: import_zod26.z.string().length(2).default("us").describe("Google country code inferred from location."),
-      hl: import_zod26.z.string().length(2).default("en").describe("Language inferred from user request."),
-      maxResults: import_zod26.z.number().int().min(1).max(50).default(10).describe("Number of Google Maps business/profile candidates to return. Default 10. Maximum 50. Use 10 unless the user asks for more."),
-      proxyMode: import_zod26.z.enum(["location", "configured", "none"]).default(DEFAULT_MAPS_PROXY_MODE).describe("Proxy targeting mode. Maps defaults to location so local market searches get city/state residential proxy targeting and rotation. Use configured to force the service proxy without city/ZIP targeting, and none only for local direct-network debugging."),
-      proxyZip: import_zod26.z.string().regex(/^\d{5}$/).optional().describe("Optional US ZIP override for residential location proxy targeting. Use when the user gives a specific ZIP or city-center ZIP."),
-      debug: import_zod26.z.boolean().default(false).describe("Include sanitized browser/proxy diagnostics when debugging Maps localization, CAPTCHA, or proxy behavior.")
+      query: import_zod27.z.string().min(1).describe('Business category, niche, keyword, or search term. If the user says "roofers in Denver CO", use query="roofers" and location="Denver, CO". Do not put the location here when it can be separated.'),
+      location: import_zod27.z.string().optional().describe('City, region, country, or service area for the Maps search, e.g. "Denver, CO". Infer from the user request when present.'),
+      gl: import_zod27.z.string().length(2).default("us").describe("Google country code inferred from location."),
+      hl: import_zod27.z.string().length(2).default("en").describe("Language inferred from user request."),
+      maxResults: import_zod27.z.number().int().min(1).max(50).default(10).describe("Number of Google Maps business/profile candidates to return. Default 10. Maximum 50. Use 10 unless the user asks for more."),
+      proxyMode: import_zod27.z.enum(["location", "configured", "none"]).default(DEFAULT_MAPS_PROXY_MODE).describe("Proxy targeting mode. Maps defaults to location so local market searches get city/state residential proxy targeting and rotation. Use configured to force the service proxy without city/ZIP targeting, and none only for local direct-network debugging."),
+      proxyZip: import_zod27.z.string().regex(/^\d{5}$/).optional().describe("Optional US ZIP override for residential location proxy targeting. Use when the user gives a specific ZIP or city-center ZIP."),
+      debug: import_zod27.z.boolean().default(false).describe("Include sanitized browser/proxy diagnostics when debugging Maps localization, CAPTCHA, or proxy behavior.")
     };
     DirectoryWorkflowInputSchema = {
-      query: import_zod26.z.string().min(1).describe("Business category, niche, or keyword to search on Google Maps for every selected market, e.g. roofers, dentists, med spas. Do not include the city here."),
-      state: import_zod26.z.string().min(2).default("TN").describe("US state abbreviation or state name used to select Census places, e.g. TN or Tennessee."),
-      minPopulation: import_zod26.z.number().int().min(0).default(1e5).describe('Minimum Census place population for market selection. Use 100000 for "cities above 100k population".'),
-      populationYear: import_zod26.z.number().int().min(2020).max(2025).default(2025).describe("Census population estimate year from the 2020-2025 Population Estimates Program city/place dataset."),
-      maxCities: import_zod26.z.number().int().min(1).max(100).default(25).describe("Maximum number of markets to process after sorting by population descending."),
-      maxResultsPerCity: import_zod26.z.number().int().min(1).max(50).default(50).describe("Google Maps business/profile candidates to collect for each city. Maximum 50."),
-      concurrency: import_zod26.z.number().int().min(1).max(5).default(5).describe("How many city Maps searches to run in parallel. Use 5 for broad directory batches unless debugging."),
-      includeZipGroups: import_zod26.z.boolean().default(true).describe("Attach ZIP groups from a configured US ZIPS CSV when available. Set MCP_SCRAPER_USZIPS_CSV_PATH on the API server or pass usZipsCsvPath in local/test mode."),
-      usZipsCsvPath: import_zod26.z.string().optional().describe("Local/test-only path to a US ZIPS CSV with state_abbr, zipcode, county, city columns, such as Lead Magician tools/analytics/data/uszips.csv. Deployed APIs should use MCP_SCRAPER_USZIPS_CSV_PATH instead."),
-      saveCsv: import_zod26.z.boolean().default(true).describe("Save a directory-ready CSV to the MCP Scraper output directory and return its path. CSV rows include source_location, result_position, business_name, review_stars, review_count, category, address, phone, hours_status, website_url, directions_url, place_url, CID fields, population, and ZIP groups."),
-      proxyMode: import_zod26.z.enum(["location", "configured", "none"]).default(DEFAULT_MAPS_PROXY_MODE).describe("Proxy targeting mode for every city Maps search. Maps workflows default to location so each city can use city/state or ZIP-group residential proxy targeting. Use configured to force the service proxy without city/ZIP targeting, and none only for local direct-network debugging."),
-      proxyZip: import_zod26.z.string().regex(/^\d{5}$/).optional().describe("Optional ZIP override for proxy targeting. Normally omit it so each city can use its ZIP group or city/state location."),
-      debug: import_zod26.z.boolean().default(false).describe("Include sanitized browser/proxy diagnostics in each Maps browser session when supported.")
+      query: import_zod27.z.string().min(1).describe("Business category, niche, or keyword to search on Google Maps for every selected market, e.g. roofers, dentists, med spas. Do not include the city here."),
+      state: import_zod27.z.string().min(2).default("TN").describe("US state abbreviation or state name used to select Census places, e.g. TN or Tennessee."),
+      minPopulation: import_zod27.z.number().int().min(0).default(1e5).describe('Minimum Census place population for market selection. Use 100000 for "cities above 100k population".'),
+      populationYear: import_zod27.z.number().int().min(2020).max(2025).default(2025).describe("Census population estimate year from the 2020-2025 Population Estimates Program city/place dataset."),
+      maxCities: import_zod27.z.number().int().min(1).max(100).default(25).describe("Maximum number of markets to process after sorting by population descending."),
+      maxResultsPerCity: import_zod27.z.number().int().min(1).max(50).default(50).describe("Google Maps business/profile candidates to collect for each city. Maximum 50."),
+      concurrency: import_zod27.z.number().int().min(1).max(5).default(5).describe("How many city Maps searches to run in parallel. Use 5 for broad directory batches unless debugging."),
+      includeZipGroups: import_zod27.z.boolean().default(true).describe("Attach ZIP groups from a configured US ZIPS CSV when available. Set MCP_SCRAPER_USZIPS_CSV_PATH on the API server or pass usZipsCsvPath in local/test mode."),
+      usZipsCsvPath: import_zod27.z.string().optional().describe("Local/test-only path to a US ZIPS CSV with state_abbr, zipcode, county, city columns, such as Lead Magician tools/analytics/data/uszips.csv. Deployed APIs should use MCP_SCRAPER_USZIPS_CSV_PATH instead."),
+      saveCsv: import_zod27.z.boolean().default(true).describe("Save a directory-ready CSV to the MCP Scraper output directory and return its path. CSV rows include source_location, result_position, business_name, review_stars, review_count, category, address, phone, hours_status, website_url, directions_url, place_url, CID fields, population, and ZIP groups."),
+      proxyMode: import_zod27.z.enum(["location", "configured", "none"]).default(DEFAULT_MAPS_PROXY_MODE).describe("Proxy targeting mode for every city Maps search. Maps workflows default to location so each city can use city/state or ZIP-group residential proxy targeting. Use configured to force the service proxy without city/ZIP targeting, and none only for local direct-network debugging."),
+      proxyZip: import_zod27.z.string().regex(/^\d{5}$/).optional().describe("Optional ZIP override for proxy targeting. Normally omit it so each city can use its ZIP group or city/state location."),
+      debug: import_zod27.z.boolean().default(false).describe("Include sanitized browser/proxy diagnostics in each Maps browser session when supported.")
     };
-    RankTrackerModeSchema = import_zod26.z.enum(["maps", "organic", "ai_overview", "paa"]);
+    RankTrackerModeSchema = import_zod27.z.enum(["maps", "organic", "ai_overview", "paa"]);
     RankTrackerBlueprintInputSchema = {
-      projectName: import_zod26.z.string().min(1).optional().describe("Optional name for the rank tracker project, client, or campaign."),
-      targetDomain: import_zod26.z.string().min(1).optional().describe("Primary domain to track in organic results, AI Overview citations, and PAA sources, e.g. example.com."),
-      targetBusinessName: import_zod26.z.string().min(1).optional().describe("Primary Google Business Profile or brand/business name to match in Maps results. Required for reliable Maps rank tracking."),
-      trackingModes: import_zod26.z.array(RankTrackerModeSchema).min(1).max(4).default(["maps", "organic", "ai_overview", "paa"]).describe("Rank tracker surfaces to build. maps uses directory_workflow/maps_search. organic uses search_serp. ai_overview uses search_serp/harvest_paa. paa uses harvest_paa source presence."),
-      keywords: import_zod26.z.array(import_zod26.z.string().min(1)).max(200).default([]).describe("Seed keywords or service queries to track. Leave empty when the downstream AI should create the keyword table from user input."),
-      locations: import_zod26.z.array(import_zod26.z.string().min(1)).max(100).default([]).describe("Markets, cities, ZIPs, or service areas to track. Use city/state strings like Denver, CO for localized SERP and Maps checks."),
-      competitors: import_zod26.z.array(import_zod26.z.string().min(1)).max(100).default([]).describe("Optional competitor domains or business names to persist as comparison targets."),
-      database: import_zod26.z.enum(["postgres", "neon", "supabase", "sqlite", "mysql"]).default("postgres").describe("Database family the downstream AI should target when generating migrations."),
-      scheduleCadence: import_zod26.z.enum(["daily", "weekly", "monthly", "custom"]).default("weekly").describe("Default recurring rank check cadence for the generated cron/heartbeat plan."),
-      customCron: import_zod26.z.string().min(1).optional().describe("Cron expression to use when scheduleCadence is custom."),
-      timezone: import_zod26.z.string().min(1).default("UTC").describe("IANA timezone for scheduled rank checks, e.g. America/Denver."),
-      includeCron: import_zod26.z.boolean().default(true).describe("Include a cron or heartbeat worker plan. Keep true for production rank trackers."),
-      includeDashboard: import_zod26.z.boolean().default(true).describe("Include dashboard/reporting requirements in the generated prompt."),
-      includeAlerts: import_zod26.z.boolean().default(true).describe("Include alert rules for rank movement and SERP feature gains/losses."),
-      notes: import_zod26.z.string().max(4e3).optional().describe("Extra product, client, stack, or hosting requirements to include in the implementation prompt.")
+      projectName: import_zod27.z.string().min(1).optional().describe("Optional name for the rank tracker project, client, or campaign."),
+      targetDomain: import_zod27.z.string().min(1).optional().describe("Primary domain to track in organic results, AI Overview citations, and PAA sources, e.g. example.com."),
+      targetBusinessName: import_zod27.z.string().min(1).optional().describe("Primary Google Business Profile or brand/business name to match in Maps results. Required for reliable Maps rank tracking."),
+      trackingModes: import_zod27.z.array(RankTrackerModeSchema).min(1).max(4).default(["maps", "organic", "ai_overview", "paa"]).describe("Rank tracker surfaces to build. maps uses directory_workflow/maps_search. organic uses search_serp. ai_overview uses search_serp/harvest_paa. paa uses harvest_paa source presence."),
+      keywords: import_zod27.z.array(import_zod27.z.string().min(1)).max(200).default([]).describe("Seed keywords or service queries to track. Leave empty when the downstream AI should create the keyword table from user input."),
+      locations: import_zod27.z.array(import_zod27.z.string().min(1)).max(100).default([]).describe("Markets, cities, ZIPs, or service areas to track. Use city/state strings like Denver, CO for localized SERP and Maps checks."),
+      competitors: import_zod27.z.array(import_zod27.z.string().min(1)).max(100).default([]).describe("Optional competitor domains or business names to persist as comparison targets."),
+      database: import_zod27.z.enum(["postgres", "neon", "supabase", "sqlite", "mysql"]).default("postgres").describe("Database family the downstream AI should target when generating migrations."),
+      scheduleCadence: import_zod27.z.enum(["daily", "weekly", "monthly", "custom"]).default("weekly").describe("Default recurring rank check cadence for the generated cron/heartbeat plan."),
+      customCron: import_zod27.z.string().min(1).optional().describe("Cron expression to use when scheduleCadence is custom."),
+      timezone: import_zod27.z.string().min(1).default("UTC").describe("IANA timezone for scheduled rank checks, e.g. America/Denver."),
+      includeCron: import_zod27.z.boolean().default(true).describe("Include a cron or heartbeat worker plan. Keep true for production rank trackers."),
+      includeDashboard: import_zod27.z.boolean().default(true).describe("Include dashboard/reporting requirements in the generated prompt."),
+      includeAlerts: import_zod27.z.boolean().default(true).describe("Include alert rules for rank movement and SERP feature gains/losses."),
+      notes: import_zod27.z.string().max(4e3).optional().describe("Extra product, client, stack, or hosting requirements to include in the implementation prompt.")
     };
-    NullableString = import_zod26.z.string().nullable();
-    MapsSearchAttemptOutput = import_zod26.z.object({
-      attemptNumber: import_zod26.z.number().int().min(1),
-      maxAttempts: import_zod26.z.number().int().min(1),
-      status: import_zod26.z.enum(["ok", "failed"]),
-      outcome: import_zod26.z.string(),
-      willRetry: import_zod26.z.boolean(),
-      durationMs: import_zod26.z.number().int().min(0),
-      resultCount: import_zod26.z.number().int().min(0),
+    NullableString = import_zod27.z.string().nullable();
+    MapsSearchAttemptOutput = import_zod27.z.object({
+      attemptNumber: import_zod27.z.number().int().min(1),
+      maxAttempts: import_zod27.z.number().int().min(1),
+      status: import_zod27.z.enum(["ok", "failed"]),
+      outcome: import_zod27.z.string(),
+      willRetry: import_zod27.z.boolean(),
+      durationMs: import_zod27.z.number().int().min(0),
+      resultCount: import_zod27.z.number().int().min(0),
       error: NullableString,
-      proxyMode: import_zod26.z.enum(["location", "configured", "none"]),
-      proxyResolutionSource: import_zod26.z.enum(["disabled", "location_reused", "location_created", "configured_fallback", "unavailable"]).nullable(),
+      proxyMode: import_zod27.z.enum(["location", "configured", "none"]),
+      proxyResolutionSource: import_zod27.z.enum(["disabled", "location_reused", "location_created", "configured_fallback", "unavailable"]).nullable(),
       proxyIdSuffix: NullableString,
-      proxyTargetLevel: import_zod26.z.enum(["zip", "city", "state"]).nullable(),
+      proxyTargetLevel: import_zod27.z.enum(["zip", "city", "state"]).nullable(),
       proxyTargetLocation: NullableString,
       proxyTargetZip: NullableString,
       browserSessionIdSuffix: NullableString,
@@ -21143,17 +22241,17 @@ var init_mcp_tool_schemas = __esm({
       observedRegion: NullableString
     });
     MapsSearchOutputSchema = {
-      query: import_zod26.z.string(),
-      location: import_zod26.z.string().nullable(),
-      searchQuery: import_zod26.z.string(),
-      searchUrl: import_zod26.z.string().url(),
-      extractedAt: import_zod26.z.string(),
-      requestedMaxResults: import_zod26.z.number().int().min(1).max(50),
-      resultCount: import_zod26.z.number().int().min(0).max(50),
-      results: import_zod26.z.array(import_zod26.z.object({
-        position: import_zod26.z.number().int().min(1),
-        name: import_zod26.z.string(),
-        placeUrl: import_zod26.z.string().url(),
+      query: import_zod27.z.string(),
+      location: import_zod27.z.string().nullable(),
+      searchQuery: import_zod27.z.string(),
+      searchUrl: import_zod27.z.string().url(),
+      extractedAt: import_zod27.z.string(),
+      requestedMaxResults: import_zod27.z.number().int().min(1).max(50),
+      resultCount: import_zod27.z.number().int().min(0).max(50),
+      results: import_zod27.z.array(import_zod27.z.object({
+        position: import_zod27.z.number().int().min(1),
+        name: import_zod27.z.string(),
+        placeUrl: import_zod27.z.string().url(),
         cid: NullableString,
         cidDecimal: NullableString,
         rating: NullableString,
@@ -21164,15 +22262,15 @@ var init_mcp_tool_schemas = __esm({
         hoursStatus: NullableString,
         websiteUrl: NullableString,
         directionsUrl: NullableString,
-        metadata: import_zod26.z.array(import_zod26.z.string())
+        metadata: import_zod27.z.array(import_zod27.z.string())
       })),
-      attempts: import_zod26.z.array(MapsSearchAttemptOutput),
-      durationMs: import_zod26.z.number().int().min(0)
+      attempts: import_zod27.z.array(MapsSearchAttemptOutput),
+      durationMs: import_zod27.z.number().int().min(0)
     };
-    DirectoryMapsBusinessOutput = import_zod26.z.object({
-      position: import_zod26.z.number().int().min(1),
-      name: import_zod26.z.string(),
-      placeUrl: import_zod26.z.string().url(),
+    DirectoryMapsBusinessOutput = import_zod27.z.object({
+      position: import_zod27.z.number().int().min(1),
+      name: import_zod27.z.string(),
+      placeUrl: import_zod27.z.string().url(),
       cid: NullableString,
       cidDecimal: NullableString,
       rating: NullableString,
@@ -21183,113 +22281,113 @@ var init_mcp_tool_schemas = __esm({
       hoursStatus: NullableString,
       websiteUrl: NullableString,
       directionsUrl: NullableString,
-      metadata: import_zod26.z.array(import_zod26.z.string())
+      metadata: import_zod27.z.array(import_zod27.z.string())
     });
     DirectoryWorkflowOutputSchema = {
-      query: import_zod26.z.string(),
-      state: import_zod26.z.string(),
-      minPopulation: import_zod26.z.number().int().min(0),
-      populationYear: import_zod26.z.number().int().min(2020).max(2025),
-      maxResultsPerCity: import_zod26.z.number().int().min(1).max(50),
-      concurrency: import_zod26.z.number().int().min(1).max(5),
-      censusSourceUrl: import_zod26.z.string().url(),
+      query: import_zod27.z.string(),
+      state: import_zod27.z.string(),
+      minPopulation: import_zod27.z.number().int().min(0),
+      populationYear: import_zod27.z.number().int().min(2020).max(2025),
+      maxResultsPerCity: import_zod27.z.number().int().min(1).max(50),
+      concurrency: import_zod27.z.number().int().min(1).max(5),
+      censusSourceUrl: import_zod27.z.string().url(),
       usZipsSourcePath: NullableString,
-      warnings: import_zod26.z.array(import_zod26.z.string()),
-      extractedAt: import_zod26.z.string(),
-      selectedCityCount: import_zod26.z.number().int().min(0),
-      totalResultCount: import_zod26.z.number().int().min(0),
+      warnings: import_zod27.z.array(import_zod27.z.string()),
+      extractedAt: import_zod27.z.string(),
+      selectedCityCount: import_zod27.z.number().int().min(0),
+      totalResultCount: import_zod27.z.number().int().min(0),
       csvPath: NullableString,
-      cities: import_zod26.z.array(import_zod26.z.object({
-        city: import_zod26.z.string(),
-        state: import_zod26.z.string(),
-        location: import_zod26.z.string(),
-        cityKey: import_zod26.z.string(),
-        censusName: import_zod26.z.string(),
-        population: import_zod26.z.number().int().min(0),
-        populationYear: import_zod26.z.number().int().min(2020).max(2025),
-        zips: import_zod26.z.array(import_zod26.z.string()),
-        counties: import_zod26.z.array(import_zod26.z.string()),
-        status: import_zod26.z.enum(["ok", "empty", "failed"]),
+      cities: import_zod27.z.array(import_zod27.z.object({
+        city: import_zod27.z.string(),
+        state: import_zod27.z.string(),
+        location: import_zod27.z.string(),
+        cityKey: import_zod27.z.string(),
+        censusName: import_zod27.z.string(),
+        population: import_zod27.z.number().int().min(0),
+        populationYear: import_zod27.z.number().int().min(2020).max(2025),
+        zips: import_zod27.z.array(import_zod27.z.string()),
+        counties: import_zod27.z.array(import_zod27.z.string()),
+        status: import_zod27.z.enum(["ok", "empty", "failed"]),
         error: NullableString,
-        resultCount: import_zod26.z.number().int().min(0),
-        durationMs: import_zod26.z.number().int().min(0),
-        attempts: import_zod26.z.array(MapsSearchAttemptOutput),
-        results: import_zod26.z.array(DirectoryMapsBusinessOutput)
+        resultCount: import_zod27.z.number().int().min(0),
+        durationMs: import_zod27.z.number().int().min(0),
+        attempts: import_zod27.z.array(MapsSearchAttemptOutput),
+        results: import_zod27.z.array(DirectoryMapsBusinessOutput)
       })),
-      durationMs: import_zod26.z.number().int().min(0)
+      durationMs: import_zod27.z.number().int().min(0)
     };
-    RankTrackerToolPlanOutput = import_zod26.z.object({
-      tool: import_zod26.z.string(),
-      purpose: import_zod26.z.string()
+    RankTrackerToolPlanOutput = import_zod27.z.object({
+      tool: import_zod27.z.string(),
+      purpose: import_zod27.z.string()
     });
-    RankTrackerTableOutput = import_zod26.z.object({
-      name: import_zod26.z.string(),
-      purpose: import_zod26.z.string(),
-      keyColumns: import_zod26.z.array(import_zod26.z.string())
+    RankTrackerTableOutput = import_zod27.z.object({
+      name: import_zod27.z.string(),
+      purpose: import_zod27.z.string(),
+      keyColumns: import_zod27.z.array(import_zod27.z.string())
     });
-    RankTrackerCronJobOutput = import_zod26.z.object({
-      name: import_zod26.z.string(),
-      purpose: import_zod26.z.string(),
-      modes: import_zod26.z.array(RankTrackerModeSchema),
-      recommendedTools: import_zod26.z.array(import_zod26.z.string())
+    RankTrackerCronJobOutput = import_zod27.z.object({
+      name: import_zod27.z.string(),
+      purpose: import_zod27.z.string(),
+      modes: import_zod27.z.array(RankTrackerModeSchema),
+      recommendedTools: import_zod27.z.array(import_zod27.z.string())
     });
     RankTrackerBlueprintOutputSchema = {
-      projectName: import_zod26.z.string(),
+      projectName: import_zod27.z.string(),
       targetDomain: NullableString,
       targetBusinessName: NullableString,
-      trackingModes: import_zod26.z.array(RankTrackerModeSchema),
-      database: import_zod26.z.string(),
-      recommendedTools: import_zod26.z.array(RankTrackerToolPlanOutput),
-      tables: import_zod26.z.array(RankTrackerTableOutput),
-      cron: import_zod26.z.object({
-        enabled: import_zod26.z.boolean(),
-        cadence: import_zod26.z.string(),
-        expression: import_zod26.z.string(),
-        timezone: import_zod26.z.string(),
-        jobs: import_zod26.z.array(RankTrackerCronJobOutput)
+      trackingModes: import_zod27.z.array(RankTrackerModeSchema),
+      database: import_zod27.z.string(),
+      recommendedTools: import_zod27.z.array(RankTrackerToolPlanOutput),
+      tables: import_zod27.z.array(RankTrackerTableOutput),
+      cron: import_zod27.z.object({
+        enabled: import_zod27.z.boolean(),
+        cadence: import_zod27.z.string(),
+        expression: import_zod27.z.string(),
+        timezone: import_zod27.z.string(),
+        jobs: import_zod27.z.array(RankTrackerCronJobOutput)
       }),
-      metrics: import_zod26.z.array(import_zod26.z.string()),
-      implementationPrompt: import_zod26.z.string()
+      metrics: import_zod27.z.array(import_zod27.z.string()),
+      implementationPrompt: import_zod27.z.string()
     };
-    OrganicResultOutput = import_zod26.z.object({
-      position: import_zod26.z.number().int(),
-      title: import_zod26.z.string(),
-      url: import_zod26.z.string(),
-      domain: import_zod26.z.string(),
+    OrganicResultOutput = import_zod27.z.object({
+      position: import_zod27.z.number().int(),
+      title: import_zod27.z.string(),
+      url: import_zod27.z.string(),
+      domain: import_zod27.z.string(),
       snippet: NullableString
     });
-    AiOverviewOutput = import_zod26.z.object({
-      detected: import_zod26.z.boolean(),
+    AiOverviewOutput = import_zod27.z.object({
+      detected: import_zod27.z.boolean(),
       text: NullableString
     }).nullable();
-    EntityIdsOutput = import_zod26.z.object({
-      kgIds: import_zod26.z.array(import_zod26.z.string()),
-      cids: import_zod26.z.array(import_zod26.z.string()),
-      gcids: import_zod26.z.array(import_zod26.z.string())
+    EntityIdsOutput = import_zod27.z.object({
+      kgIds: import_zod27.z.array(import_zod27.z.string()),
+      cids: import_zod27.z.array(import_zod27.z.string()),
+      gcids: import_zod27.z.array(import_zod27.z.string())
     }).nullable();
     HarvestPaaOutputSchema = {
-      query: import_zod26.z.string(),
+      query: import_zod27.z.string(),
       location: NullableString,
-      questionCount: import_zod26.z.number().int().min(0),
+      questionCount: import_zod27.z.number().int().min(0),
       completionStatus: NullableString,
-      questions: import_zod26.z.array(import_zod26.z.object({
-        question: import_zod26.z.string(),
+      questions: import_zod27.z.array(import_zod27.z.object({
+        question: import_zod27.z.string(),
         answer: NullableString,
         sourceTitle: NullableString,
         sourceSite: NullableString
       })),
-      organicResults: import_zod26.z.array(OrganicResultOutput),
+      organicResults: import_zod27.z.array(OrganicResultOutput),
       aiOverview: AiOverviewOutput,
       entityIds: EntityIdsOutput,
-      durationMs: import_zod26.z.number().min(0).nullable()
+      durationMs: import_zod27.z.number().min(0).nullable()
     };
     SearchSerpOutputSchema = {
-      query: import_zod26.z.string(),
+      query: import_zod27.z.string(),
       location: NullableString,
-      organicResults: import_zod26.z.array(OrganicResultOutput),
-      localPack: import_zod26.z.array(import_zod26.z.object({
-        position: import_zod26.z.number().int(),
-        name: import_zod26.z.string(),
+      organicResults: import_zod27.z.array(OrganicResultOutput),
+      localPack: import_zod27.z.array(import_zod27.z.object({
+        position: import_zod27.z.number().int(),
+        name: import_zod27.z.string(),
         rating: NullableString,
         reviewCount: NullableString,
         websiteUrl: NullableString
@@ -21298,31 +22396,31 @@ var init_mcp_tool_schemas = __esm({
       entityIds: EntityIdsOutput
     };
     ExtractUrlOutputSchema = {
-      url: import_zod26.z.string(),
+      url: import_zod27.z.string(),
       title: NullableString,
-      headings: import_zod26.z.array(import_zod26.z.object({
-        level: import_zod26.z.number().int(),
-        text: import_zod26.z.string()
+      headings: import_zod27.z.array(import_zod27.z.object({
+        level: import_zod27.z.number().int(),
+        text: import_zod27.z.string()
       })),
-      schemaBlockCount: import_zod26.z.number().int().min(0),
+      schemaBlockCount: import_zod27.z.number().int().min(0),
       entityName: NullableString,
-      entityTypes: import_zod26.z.array(import_zod26.z.string()),
-      napScore: import_zod26.z.number().nullable(),
-      missingSchemaFields: import_zod26.z.array(import_zod26.z.string()),
+      entityTypes: import_zod27.z.array(import_zod27.z.string()),
+      napScore: import_zod27.z.number().nullable(),
+      missingSchemaFields: import_zod27.z.array(import_zod27.z.string()),
       screenshotSaved: NullableString
     };
     ExtractSiteOutputSchema = {
-      url: import_zod26.z.string(),
-      pageCount: import_zod26.z.number().int().min(0),
-      pages: import_zod26.z.array(import_zod26.z.object({
-        url: import_zod26.z.string(),
+      url: import_zod27.z.string(),
+      pageCount: import_zod27.z.number().int().min(0),
+      pages: import_zod27.z.array(import_zod27.z.object({
+        url: import_zod27.z.string(),
         title: NullableString,
-        schemaTypes: import_zod26.z.array(import_zod26.z.string())
+        schemaTypes: import_zod27.z.array(import_zod27.z.string())
       })),
-      durationMs: import_zod26.z.number().min(0)
+      durationMs: import_zod27.z.number().min(0)
     };
     MapsPlaceIntelOutputSchema = {
-      name: import_zod26.z.string(),
+      name: import_zod27.z.string(),
       rating: NullableString,
       reviewCount: NullableString,
       category: NullableString,
@@ -21334,75 +22432,75 @@ var init_mcp_tool_schemas = __esm({
       kgmid: NullableString,
       cidDecimal: NullableString,
       cidUrl: NullableString,
-      lat: import_zod26.z.number().nullable(),
-      lng: import_zod26.z.number().nullable(),
-      reviewsStatus: import_zod26.z.string(),
-      reviewsCollected: import_zod26.z.number().int().min(0),
-      reviewTopics: import_zod26.z.array(import_zod26.z.object({
-        label: import_zod26.z.string(),
-        count: import_zod26.z.string()
+      lat: import_zod27.z.number().nullable(),
+      lng: import_zod27.z.number().nullable(),
+      reviewsStatus: import_zod27.z.string(),
+      reviewsCollected: import_zod27.z.number().int().min(0),
+      reviewTopics: import_zod27.z.array(import_zod27.z.object({
+        label: import_zod27.z.string(),
+        count: import_zod27.z.string()
       }))
     };
     CreditsInfoOutputSchema = {
-      balanceCredits: import_zod26.z.number().nullable(),
-      matchedCost: import_zod26.z.object({
-        label: import_zod26.z.string(),
-        credits: import_zod26.z.number(),
-        unit: import_zod26.z.string(),
+      balanceCredits: import_zod27.z.number().nullable(),
+      matchedCost: import_zod27.z.object({
+        label: import_zod27.z.string(),
+        credits: import_zod27.z.number(),
+        unit: import_zod27.z.string(),
         notes: NullableString
       }).nullable(),
-      costs: import_zod26.z.array(import_zod26.z.object({
-        key: import_zod26.z.string(),
-        label: import_zod26.z.string(),
-        credits: import_zod26.z.number(),
-        unit: import_zod26.z.string(),
+      costs: import_zod27.z.array(import_zod27.z.object({
+        key: import_zod27.z.string(),
+        label: import_zod27.z.string(),
+        credits: import_zod27.z.number(),
+        unit: import_zod27.z.string(),
         notes: NullableString
       })),
-      ledger: import_zod26.z.array(import_zod26.z.object({
-        createdAt: import_zod26.z.string(),
-        operation: import_zod26.z.string(),
-        credits: import_zod26.z.number(),
+      ledger: import_zod27.z.array(import_zod27.z.object({
+        createdAt: import_zod27.z.string(),
+        operation: import_zod27.z.string(),
+        credits: import_zod27.z.number(),
         description: NullableString
       })),
-      concurrency: import_zod26.z.object({
-        currentExtraSlots: import_zod26.z.number().int().min(0),
-        currentLimit: import_zod26.z.number().int().min(1),
-        hasSubscription: import_zod26.z.boolean(),
-        upgrade: import_zod26.z.object({
-          product: import_zod26.z.string(),
-          priceLabel: import_zod26.z.string(),
-          unitAmountUsd: import_zod26.z.number(),
-          currency: import_zod26.z.string(),
-          interval: import_zod26.z.string(),
-          billingUrl: import_zod26.z.string().url(),
-          terminalCommand: import_zod26.z.string(),
-          terminalCommandWithApiKeyEnv: import_zod26.z.string()
+      concurrency: import_zod27.z.object({
+        currentExtraSlots: import_zod27.z.number().int().min(0),
+        currentLimit: import_zod27.z.number().int().min(1),
+        hasSubscription: import_zod27.z.boolean(),
+        upgrade: import_zod27.z.object({
+          product: import_zod27.z.string(),
+          priceLabel: import_zod27.z.string(),
+          unitAmountUsd: import_zod27.z.number(),
+          currency: import_zod27.z.string(),
+          interval: import_zod27.z.string(),
+          billingUrl: import_zod27.z.string().url(),
+          terminalCommand: import_zod27.z.string(),
+          terminalCommandWithApiKeyEnv: import_zod27.z.string()
         })
       }).nullable()
     };
     MapSiteUrlsOutputSchema = {
-      startUrl: import_zod26.z.string(),
-      totalFound: import_zod26.z.number().int().min(0),
-      truncated: import_zod26.z.boolean(),
-      okCount: import_zod26.z.number().int().min(0),
-      redirectCount: import_zod26.z.number().int().min(0),
-      brokenCount: import_zod26.z.number().int().min(0),
-      urls: import_zod26.z.array(import_zod26.z.object({
-        url: import_zod26.z.string(),
-        status: import_zod26.z.number().int().nullable()
+      startUrl: import_zod27.z.string(),
+      totalFound: import_zod27.z.number().int().min(0),
+      truncated: import_zod27.z.boolean(),
+      okCount: import_zod27.z.number().int().min(0),
+      redirectCount: import_zod27.z.number().int().min(0),
+      brokenCount: import_zod27.z.number().int().min(0),
+      urls: import_zod27.z.array(import_zod27.z.object({
+        url: import_zod27.z.string(),
+        status: import_zod27.z.number().int().nullable()
       })),
-      durationMs: import_zod26.z.number().min(0)
+      durationMs: import_zod27.z.number().min(0)
     };
     YoutubeHarvestOutputSchema = {
-      mode: import_zod26.z.string(),
-      videoCount: import_zod26.z.number().int().min(0),
-      channel: import_zod26.z.object({
+      mode: import_zod27.z.string(),
+      videoCount: import_zod27.z.number().int().min(0),
+      channel: import_zod27.z.object({
         title: NullableString,
         subscriberCount: NullableString
       }).nullable(),
-      videos: import_zod26.z.array(import_zod26.z.object({
-        videoId: import_zod26.z.string(),
-        title: import_zod26.z.string(),
+      videos: import_zod27.z.array(import_zod27.z.object({
+        videoId: import_zod27.z.string(),
+        title: import_zod27.z.string(),
         channelName: NullableString,
         views: NullableString,
         duration: NullableString,
@@ -21410,24 +22508,24 @@ var init_mcp_tool_schemas = __esm({
       }))
     };
     FacebookAdSearchOutputSchema = {
-      query: import_zod26.z.string(),
-      advertiserCount: import_zod26.z.number().int().min(0),
-      advertisers: import_zod26.z.array(import_zod26.z.object({
+      query: import_zod27.z.string(),
+      advertiserCount: import_zod27.z.number().int().min(0),
+      advertisers: import_zod27.z.array(import_zod27.z.object({
         name: NullableString,
         pageId: NullableString,
         pageUrl: NullableString,
-        adCount: import_zod26.z.number().int().nullable(),
+        adCount: import_zod27.z.number().int().nullable(),
         libraryId: NullableString,
         sampleLibraryId: NullableString
       }))
     };
     FacebookPageIntelOutputSchema = {
       advertiserName: NullableString,
-      totalAds: import_zod26.z.number().int().min(0),
-      activeCount: import_zod26.z.number().int().min(0),
-      videoCount: import_zod26.z.number().int().min(0),
-      imageCount: import_zod26.z.number().int().min(0),
-      ads: import_zod26.z.array(import_zod26.z.object({
+      totalAds: import_zod27.z.number().int().min(0),
+      activeCount: import_zod27.z.number().int().min(0),
+      videoCount: import_zod27.z.number().int().min(0),
+      imageCount: import_zod27.z.number().int().min(0),
+      ads: import_zod27.z.array(import_zod27.z.object({
         libraryId: NullableString,
         status: NullableString,
         creativeType: NullableString,
@@ -21440,84 +22538,179 @@ var init_mcp_tool_schemas = __esm({
         videoUrl: NullableString,
         imageUrl: NullableString,
         videoPoster: NullableString,
-        variations: import_zod26.z.number().int().nullable()
+        variations: import_zod27.z.number().int().nullable()
       }))
     };
     FacebookVideoTranscribeOutputSchema = {
-      sourceUrl: import_zod26.z.string().url(),
-      pageUrl: import_zod26.z.string().url(),
+      sourceUrl: import_zod27.z.string().url(),
+      pageUrl: import_zod27.z.string().url(),
       videoId: NullableString,
       ownerName: NullableString,
-      selectedQuality: import_zod26.z.string(),
-      bitrate: import_zod26.z.number().int().nullable(),
-      videoDurationSec: import_zod26.z.number().nullable(),
-      videoUrl: import_zod26.z.string().url(),
-      wordCount: import_zod26.z.number().int().min(0),
-      chunkCount: import_zod26.z.number().int().min(0),
-      transcriptText: import_zod26.z.string(),
-      chunks: import_zod26.z.array(import_zod26.z.object({
-        startSec: import_zod26.z.number(),
-        endSec: import_zod26.z.number(),
-        text: import_zod26.z.string()
+      selectedQuality: import_zod27.z.string(),
+      bitrate: import_zod27.z.number().int().nullable(),
+      videoDurationSec: import_zod27.z.number().nullable(),
+      videoUrl: import_zod27.z.string().url(),
+      wordCount: import_zod27.z.number().int().min(0),
+      chunkCount: import_zod27.z.number().int().min(0),
+      transcriptText: import_zod27.z.string(),
+      chunks: import_zod27.z.array(import_zod27.z.object({
+        startSec: import_zod27.z.number(),
+        endSec: import_zod27.z.number(),
+        text: import_zod27.z.string()
+      }))
+    };
+    TranscriptChunkOutput = import_zod27.z.object({
+      startSec: import_zod27.z.number(),
+      endSec: import_zod27.z.number(),
+      text: import_zod27.z.string()
+    });
+    InstagramBrowserOutput = import_zod27.z.object({
+      mode: import_zod27.z.enum(["hosted", "local"]),
+      requestedMode: import_zod27.z.enum(["auto", "hosted", "local"]),
+      profileName: NullableString,
+      profileSource: import_zod27.z.enum(["hosted", "managed_profile", "direct_profile_dir"]),
+      profileDirConfigured: import_zod27.z.boolean(),
+      executablePathConfigured: import_zod27.z.boolean()
+    });
+    InstagramPaginationOutput = import_zod27.z.object({
+      maxItems: import_zod27.z.number().int().min(1).max(500),
+      maxScrolls: import_zod27.z.number().int().min(0).max(100),
+      attemptedScrolls: import_zod27.z.number().int().min(0),
+      stableScrolls: import_zod27.z.number().int().min(0),
+      stableScrollLimit: import_zod27.z.number().int().min(1).max(10),
+      scrollDelayMs: import_zod27.z.number().int().min(250).max(5e3),
+      reachedMaxItems: import_zod27.z.boolean(),
+      reachedReportedPostCount: import_zod27.z.boolean(),
+      finalScrollHeight: import_zod27.z.number().int().nullable(),
+      stoppedReason: import_zod27.z.enum(["max_items", "reported_post_count", "stable_scrolls", "max_scrolls", "no_scrolls"]),
+      stages: import_zod27.z.array(import_zod27.z.object({
+        stage: import_zod27.z.string(),
+        itemCount: import_zod27.z.number().int().min(0),
+        addedCount: import_zod27.z.number().int().min(0),
+        scrollY: import_zod27.z.number().nullable(),
+        scrollHeight: import_zod27.z.number().nullable()
+      }))
+    });
+    InstagramProfileContentOutputSchema = {
+      handle: import_zod27.z.string(),
+      profileUrl: import_zod27.z.string().url(),
+      pageUrl: import_zod27.z.string().url(),
+      browser: InstagramBrowserOutput,
+      profileName: NullableString,
+      reportedPostCount: import_zod27.z.number().int().nullable(),
+      reportedPostCountText: NullableString,
+      followerCountText: NullableString,
+      followingCountText: NullableString,
+      collectedContentCount: import_zod27.z.number().int().min(0),
+      typeCounts: import_zod27.z.object({
+        post: import_zod27.z.number().int().min(0),
+        reel: import_zod27.z.number().int().min(0),
+        tv: import_zod27.z.number().int().min(0)
+      }),
+      pagination: InstagramPaginationOutput,
+      limited: import_zod27.z.boolean(),
+      limitations: import_zod27.z.array(import_zod27.z.string()),
+      items: import_zod27.z.array(import_zod27.z.object({
+        url: import_zod27.z.string().url(),
+        type: import_zod27.z.enum(["post", "reel", "tv"]),
+        shortcode: import_zod27.z.string(),
+        anchorText: NullableString,
+        firstSeenStage: import_zod27.z.string()
       }))
     };
-    TranscriptChunkOutput = import_zod26.z.object({
-      startSec: import_zod26.z.number(),
-      endSec: import_zod26.z.number(),
-      text: import_zod26.z.string()
+    InstagramMediaTrackOutput = import_zod27.z.object({
+      url: import_zod27.z.string().url(),
+      streamType: import_zod27.z.enum(["video", "audio", "unknown"]),
+      bitrate: import_zod27.z.number().int().nullable(),
+      durationSec: import_zod27.z.number().nullable(),
+      vencodeTag: NullableString,
+      width: import_zod27.z.number().int().nullable(),
+      height: import_zod27.z.number().int().nullable()
     });
+    InstagramDownloadOutput = import_zod27.z.object({
+      kind: import_zod27.z.enum(["text", "image", "video", "audio", "muxed_video"]),
+      url: import_zod27.z.string().url().nullable(),
+      savedPath: NullableString,
+      sizeBytes: import_zod27.z.number().int().nullable(),
+      mimeType: NullableString,
+      error: NullableString
+    });
+    InstagramMediaDownloadOutputSchema = {
+      sourceUrl: import_zod27.z.string().url(),
+      pageUrl: import_zod27.z.string().url(),
+      browser: InstagramBrowserOutput,
+      type: import_zod27.z.enum(["post", "reel", "tv"]).nullable(),
+      shortcode: NullableString,
+      ownerName: NullableString,
+      caption: NullableString,
+      imageUrl: import_zod27.z.string().url().nullable(),
+      trackCount: import_zod27.z.number().int().min(0),
+      selectedVideoTrack: InstagramMediaTrackOutput.nullable(),
+      selectedAudioTrack: InstagramMediaTrackOutput.nullable(),
+      downloads: import_zod27.z.array(InstagramDownloadOutput),
+      outputDir: NullableString,
+      warnings: import_zod27.z.array(import_zod27.z.string()),
+      limitations: import_zod27.z.array(import_zod27.z.string()),
+      transcript: import_zod27.z.object({
+        wordCount: import_zod27.z.number().int().min(0),
+        chunkCount: import_zod27.z.number().int().min(0),
+        durationMs: import_zod27.z.number().nullable(),
+        transcriptText: import_zod27.z.string(),
+        chunks: import_zod27.z.array(TranscriptChunkOutput)
+      }).nullable()
+    };
     YoutubeTranscribeOutputSchema = {
       videoId: NullableString,
       url: NullableString,
-      wordCount: import_zod26.z.number().int().min(0),
-      chunkCount: import_zod26.z.number().int().min(0),
-      durationMs: import_zod26.z.number().nullable(),
-      transcriptText: import_zod26.z.string(),
-      chunks: import_zod26.z.array(TranscriptChunkOutput),
-      resolvedInputs: import_zod26.z.object({
+      wordCount: import_zod27.z.number().int().min(0),
+      chunkCount: import_zod27.z.number().int().min(0),
+      durationMs: import_zod27.z.number().nullable(),
+      transcriptText: import_zod27.z.string(),
+      chunks: import_zod27.z.array(TranscriptChunkOutput),
+      resolvedInputs: import_zod27.z.object({
         videoId: NullableString,
         url: NullableString
       })
     };
     FacebookAdTranscribeOutputSchema = {
-      videoUrl: import_zod26.z.string().url(),
-      wordCount: import_zod26.z.number().int().min(0),
-      chunkCount: import_zod26.z.number().int().min(0),
-      durationMs: import_zod26.z.number().nullable(),
-      transcriptText: import_zod26.z.string(),
-      chunks: import_zod26.z.array(TranscriptChunkOutput),
-      resolvedInputs: import_zod26.z.object({
-        videoUrl: import_zod26.z.string().url()
+      videoUrl: import_zod27.z.string().url(),
+      wordCount: import_zod27.z.number().int().min(0),
+      chunkCount: import_zod27.z.number().int().min(0),
+      durationMs: import_zod27.z.number().nullable(),
+      transcriptText: import_zod27.z.string(),
+      chunks: import_zod27.z.array(TranscriptChunkOutput),
+      resolvedInputs: import_zod27.z.object({
+        videoUrl: import_zod27.z.string().url()
       })
     };
     CaptureSerpSnapshotOutputSchema = {
-      schemaVersion: import_zod26.z.literal("serp-intelligence.capture.v1"),
-      status: import_zod26.z.string(),
+      schemaVersion: import_zod27.z.literal("serp-intelligence.capture.v1"),
+      status: import_zod27.z.string(),
       query: NullableString,
       location: NullableString,
       capturedAt: NullableString,
-      resultCount: import_zod26.z.number().int().min(0).nullable(),
+      resultCount: import_zod27.z.number().int().min(0).nullable(),
       snapshotId: NullableString,
-      resolvedInputs: import_zod26.z.record(import_zod26.z.unknown()),
-      artifacts: import_zod26.z.array(import_zod26.z.record(import_zod26.z.unknown())),
-      diagnostics: import_zod26.z.record(import_zod26.z.unknown()).nullable(),
-      providerPayload: import_zod26.z.record(import_zod26.z.unknown())
+      resolvedInputs: import_zod27.z.record(import_zod27.z.unknown()),
+      artifacts: import_zod27.z.array(import_zod27.z.record(import_zod27.z.unknown())),
+      diagnostics: import_zod27.z.record(import_zod27.z.unknown()).nullable(),
+      providerPayload: import_zod27.z.record(import_zod27.z.unknown())
     };
     CaptureSerpPageSnapshotsOutputSchema = {
-      schemaVersion: import_zod26.z.literal("serp-intelligence.page-snapshots.v1"),
-      status: import_zod26.z.string(),
-      count: import_zod26.z.number().int().min(0),
-      failedCount: import_zod26.z.number().int().min(0),
-      captures: import_zod26.z.array(import_zod26.z.record(import_zod26.z.unknown())),
-      resolvedInputs: import_zod26.z.record(import_zod26.z.unknown()),
-      diagnostics: import_zod26.z.record(import_zod26.z.unknown()).nullable(),
-      providerPayload: import_zod26.z.record(import_zod26.z.unknown())
+      schemaVersion: import_zod27.z.literal("serp-intelligence.page-snapshots.v1"),
+      status: import_zod27.z.string(),
+      count: import_zod27.z.number().int().min(0),
+      failedCount: import_zod27.z.number().int().min(0),
+      captures: import_zod27.z.array(import_zod27.z.record(import_zod27.z.unknown())),
+      resolvedInputs: import_zod27.z.record(import_zod27.z.unknown()),
+      diagnostics: import_zod27.z.record(import_zod27.z.unknown()).nullable(),
+      providerPayload: import_zod27.z.record(import_zod27.z.unknown())
     };
     CreditsInfoInputSchema = {
-      item: import_zod26.z.string().optional().describe('Optional tool, action, or feature to look up, e.g. "maps reviews", "extract_url", "YouTube transcription", or "concurrency"'),
-      includeLedger: import_zod26.z.boolean().default(false).describe("Whether to include recent credit ledger entries")
+      item: import_zod27.z.string().optional().describe('Optional tool, action, or feature to look up, e.g. "maps reviews", "extract_url", "YouTube transcription", or "concurrency"'),
+      includeLedger: import_zod27.z.boolean().default(false).describe("Whether to include recent credit ledger entries")
     };
-    WorkflowIdSchema2 = import_zod26.z.enum([
+    WorkflowIdSchema2 = import_zod27.z.enum([
       "directory",
       "agent-packet",
       "local-competitive-audit",
@@ -21527,129 +22720,129 @@ var init_mcp_tool_schemas = __esm({
       "ai-overview-language"
     ]);
     WorkflowListInputSchema = {
-      includeRecipes: import_zod26.z.boolean().default(true).describe("Include high-level AI-facing recipes such as market analysis, ICP research, forum/review research, brand design briefings, CRO audits, positioning briefs, content gaps, and AI search visibility audits.")
+      includeRecipes: import_zod27.z.boolean().default(true).describe("Include high-level AI-facing recipes such as market analysis, ICP research, forum/review research, brand design briefings, CRO audits, positioning briefs, content gaps, and AI search visibility audits.")
     };
     WorkflowSuggestInputSchema = {
-      goal: import_zod26.z.string().min(1).describe('The user goal or job to route, e.g. "market analysis for roofers in Tennessee", "ICP research for med spas", "CRO audit for this URL", or "brand design briefing".'),
-      query: import_zod26.z.string().optional().describe("Business category, niche, or Maps query when known."),
-      keyword: import_zod26.z.string().optional().describe("Search keyword, audience problem, or content topic when known."),
-      domain: import_zod26.z.string().optional().describe("Target domain or brand domain when known."),
-      url: import_zod26.z.string().url().optional().describe("Target URL when the workflow should inspect a specific page."),
-      location: import_zod26.z.string().optional().describe("City/region/country for localized research, e.g. Denver, CO."),
-      state: import_zod26.z.string().optional().describe("US state abbreviation or name for state-wide market research."),
-      maxSuggestions: import_zod26.z.number().int().min(1).max(8).default(3).describe("Number of matching workflow recipes to return.")
+      goal: import_zod27.z.string().min(1).describe('The user goal or job to route, e.g. "market analysis for roofers in Tennessee", "ICP research for med spas", "CRO audit for this URL", or "brand design briefing".'),
+      query: import_zod27.z.string().optional().describe("Business category, niche, or Maps query when known."),
+      keyword: import_zod27.z.string().optional().describe("Search keyword, audience problem, or content topic when known."),
+      domain: import_zod27.z.string().optional().describe("Target domain or brand domain when known."),
+      url: import_zod27.z.string().url().optional().describe("Target URL when the workflow should inspect a specific page."),
+      location: import_zod27.z.string().optional().describe("City/region/country for localized research, e.g. Denver, CO."),
+      state: import_zod27.z.string().optional().describe("US state abbreviation or name for state-wide market research."),
+      maxSuggestions: import_zod27.z.number().int().min(1).max(8).default(3).describe("Number of matching workflow recipes to return.")
     };
     WorkflowRunInputSchema = {
       workflowId: WorkflowIdSchema2.describe("Workflow to run: directory, agent-packet, local-competitive-audit, map-comparison, serp-comparison, paa-expansion-brief, ai-overview-language. Use only these values; call workflow_list or workflow_suggest first when unsure."),
-      input: import_zod26.z.record(import_zod26.z.unknown()).default({}).describe("Workflow-specific input object. Examples: agent-packet uses {keyword, domain?, location?, maxQuestions?}; local-competitive-audit uses {query, state, minPopulation?, maxCities?, maxResultsPerCity?, hydrateTop?, maxReviews?}; serp-comparison uses {keyword, domain?, url?, location?, extractTop?}."),
-      webhookUrl: import_zod26.z.string().url().optional().describe("Optional HTTPS webhook to receive the completed hosted workflow run event.")
+      input: import_zod27.z.record(import_zod27.z.unknown()).default({}).describe("Workflow-specific input object. Examples: agent-packet uses {keyword, domain?, location?, maxQuestions?}; local-competitive-audit uses {query, state, minPopulation?, maxCities?, maxResultsPerCity?, hydrateTop?, maxReviews?}; serp-comparison uses {keyword, domain?, url?, location?, extractTop?}."),
+      webhookUrl: import_zod27.z.string().url().optional().describe("Optional HTTPS webhook to receive the completed hosted workflow run event.")
     };
     WorkflowStepInputSchema = {
-      runId: import_zod26.z.string().min(1).describe("Workflow run id returned by workflow_run, workflow_step, or workflow_status. Use only a returned runId; do not construct one yourself. Advances the run by exactly one step (one logical leg, e.g. one live harvest).")
+      runId: import_zod27.z.string().min(1).describe("Workflow run id returned by workflow_run, workflow_step, or workflow_status. Use only a returned runId; do not construct one yourself. Advances the run by exactly one step (one logical leg, e.g. one live harvest).")
     };
     WorkflowStatusInputSchema = {
-      runId: import_zod26.z.string().min(1).describe("Workflow run id returned by workflow_run, workflow_step, or workflow_status. Use only a returned runId; do not construct one yourself.")
+      runId: import_zod27.z.string().min(1).describe("Workflow run id returned by workflow_run, workflow_step, or workflow_status. Use only a returned runId; do not construct one yourself.")
     };
     WorkflowArtifactReadInputSchema = {
-      runId: import_zod26.z.string().min(1).describe("Workflow run id returned by workflow_run, workflow_step, or workflow_status. Use only a returned runId; do not construct one yourself."),
-      artifactId: import_zod26.z.string().min(1).describe("Artifact id from the run artifact list returned by workflow_run, workflow_step, or workflow_status. Use only a returned artifactId; do not construct one yourself."),
-      maxBytes: import_zod26.z.number().int().min(1e3).max(1e6).default(2e5).describe("Maximum bytes of artifact text to return inline. Use lower values for large CSV/JSON artifacts; call again with the downloadUrl if needed outside MCP.")
+      runId: import_zod27.z.string().min(1).describe("Workflow run id returned by workflow_run, workflow_step, or workflow_status. Use only a returned runId; do not construct one yourself."),
+      artifactId: import_zod27.z.string().min(1).describe("Artifact id from the run artifact list returned by workflow_run, workflow_step, or workflow_status. Use only a returned artifactId; do not construct one yourself."),
+      maxBytes: import_zod27.z.number().int().min(1e3).max(1e6).default(2e5).describe("Maximum bytes of artifact text to return inline. Use lower values for large CSV/JSON artifacts; call again with the downloadUrl if needed outside MCP.")
     };
-    WorkflowRecipeOutput = import_zod26.z.object({
-      id: import_zod26.z.string(),
-      title: import_zod26.z.string(),
-      description: import_zod26.z.string(),
-      primaryWorkflowId: import_zod26.z.string().nullable(),
-      recommendedTools: import_zod26.z.array(import_zod26.z.string()),
-      requiredInputs: import_zod26.z.array(import_zod26.z.string()),
-      optionalInputs: import_zod26.z.array(import_zod26.z.string()),
-      produces: import_zod26.z.array(import_zod26.z.string()),
-      runHint: import_zod26.z.string()
+    WorkflowRecipeOutput = import_zod27.z.object({
+      id: import_zod27.z.string(),
+      title: import_zod27.z.string(),
+      description: import_zod27.z.string(),
+      primaryWorkflowId: import_zod27.z.string().nullable(),
+      recommendedTools: import_zod27.z.array(import_zod27.z.string()),
+      requiredInputs: import_zod27.z.array(import_zod27.z.string()),
+      optionalInputs: import_zod27.z.array(import_zod27.z.string()),
+      produces: import_zod27.z.array(import_zod27.z.string()),
+      runHint: import_zod27.z.string()
     });
-    WorkflowDefinitionOutput = import_zod26.z.object({
-      id: import_zod26.z.string(),
-      title: import_zod26.z.string(),
-      description: import_zod26.z.string()
+    WorkflowDefinitionOutput = import_zod27.z.object({
+      id: import_zod27.z.string(),
+      title: import_zod27.z.string(),
+      description: import_zod27.z.string()
     });
-    WorkflowArtifactOutput = import_zod26.z.record(import_zod26.z.unknown());
+    WorkflowArtifactOutput = import_zod27.z.record(import_zod27.z.unknown());
     WorkflowListOutputSchema = {
-      workflows: import_zod26.z.array(WorkflowDefinitionOutput),
-      recipes: import_zod26.z.array(WorkflowRecipeOutput)
+      workflows: import_zod27.z.array(WorkflowDefinitionOutput),
+      recipes: import_zod27.z.array(WorkflowRecipeOutput)
     };
     WorkflowSuggestOutputSchema = {
-      goal: import_zod26.z.string(),
-      suggestions: import_zod26.z.array(WorkflowRecipeOutput)
+      goal: import_zod27.z.string(),
+      suggestions: import_zod27.z.array(WorkflowRecipeOutput)
     };
     WorkflowRunOutputSchema = {
-      workflowId: import_zod26.z.string(),
-      input: import_zod26.z.record(import_zod26.z.unknown()),
-      run: import_zod26.z.record(import_zod26.z.unknown()).optional(),
-      summary: import_zod26.z.record(import_zod26.z.unknown()).optional(),
-      step: import_zod26.z.record(import_zod26.z.unknown()).optional(),
-      nextStep: import_zod26.z.record(import_zod26.z.unknown()).nullable().optional(),
-      done: import_zod26.z.boolean().optional(),
-      artifacts: import_zod26.z.array(WorkflowArtifactOutput)
+      workflowId: import_zod27.z.string(),
+      input: import_zod27.z.record(import_zod27.z.unknown()),
+      run: import_zod27.z.record(import_zod27.z.unknown()).optional(),
+      summary: import_zod27.z.record(import_zod27.z.unknown()).optional(),
+      step: import_zod27.z.record(import_zod27.z.unknown()).optional(),
+      nextStep: import_zod27.z.record(import_zod27.z.unknown()).nullable().optional(),
+      done: import_zod27.z.boolean().optional(),
+      artifacts: import_zod27.z.array(WorkflowArtifactOutput)
     };
     WorkflowStepOutputSchema = {
-      runId: import_zod26.z.string(),
-      run: import_zod26.z.record(import_zod26.z.unknown()).optional(),
-      summary: import_zod26.z.record(import_zod26.z.unknown()).nullable().optional(),
-      step: import_zod26.z.record(import_zod26.z.unknown()).optional(),
-      nextStep: import_zod26.z.record(import_zod26.z.unknown()).nullable().optional(),
-      done: import_zod26.z.boolean(),
-      artifacts: import_zod26.z.array(WorkflowArtifactOutput)
+      runId: import_zod27.z.string(),
+      run: import_zod27.z.record(import_zod27.z.unknown()).optional(),
+      summary: import_zod27.z.record(import_zod27.z.unknown()).nullable().optional(),
+      step: import_zod27.z.record(import_zod27.z.unknown()).optional(),
+      nextStep: import_zod27.z.record(import_zod27.z.unknown()).nullable().optional(),
+      done: import_zod27.z.boolean(),
+      artifacts: import_zod27.z.array(WorkflowArtifactOutput)
     };
     WorkflowStatusOutputSchema = {
-      run: import_zod26.z.record(import_zod26.z.unknown()).optional(),
-      artifacts: import_zod26.z.array(WorkflowArtifactOutput)
+      run: import_zod27.z.record(import_zod27.z.unknown()).optional(),
+      artifacts: import_zod27.z.array(WorkflowArtifactOutput)
     };
     WorkflowArtifactReadOutputSchema = {
-      runId: import_zod26.z.string(),
-      artifactId: import_zod26.z.string(),
-      contentType: import_zod26.z.string(),
-      bytes: import_zod26.z.number().int().min(0),
-      truncated: import_zod26.z.boolean(),
-      text: import_zod26.z.string()
+      runId: import_zod27.z.string(),
+      artifactId: import_zod27.z.string(),
+      contentType: import_zod27.z.string(),
+      bytes: import_zod27.z.number().int().min(0),
+      truncated: import_zod27.z.boolean(),
+      text: import_zod27.z.string()
     };
     SearchSerpInputSchema = {
-      query: import_zod26.z.string().min(1).describe('Core search topic only. Separate location when possible. If user says "best dentist in Brooklyn NY serp", use query="best dentist" and location="Brooklyn, NY".'),
-      location: import_zod26.z.string().optional().describe("City, region, or country for geo-targeted results, inferred from user request when present."),
-      gl: import_zod26.z.string().length(2).default("us").describe("Google country code inferred from location or user language."),
-      hl: import_zod26.z.string().default("en").describe("Google interface/content language inferred from user request."),
-      device: import_zod26.z.enum(["desktop", "mobile"]).default("desktop").describe("SERP device context. Use desktop by default; use mobile only when the user asks for mobile rankings."),
-      proxyMode: import_zod26.z.enum(["location", "configured", "none"]).default(DEFAULT_PROXY_MODE).describe("Proxy targeting mode. Default configured uses the service proxy without city/ZIP targeting for the highest general SERP success rate. Use location only when the user explicitly needs city/ZIP-targeted residential proxy evidence. Use none only for direct-network debugging."),
-      proxyZip: import_zod26.z.string().regex(/^\d{5}$/).optional().describe("Optional US ZIP override for residential location proxy targeting. Use only with proxyMode location when the user gives a specific ZIP or city-center targeting needs to be forced."),
-      debug: import_zod26.z.boolean().default(false).describe("Include sanitized browser/session/location diagnostics in the response. Use true when debugging localization, CAPTCHA, or proxy behavior."),
-      pages: import_zod26.z.number().int().min(1).max(2).default(1).describe("Number of result pages to fetch (1\u20132)")
+      query: import_zod27.z.string().min(1).describe('Core search topic only. Separate location when possible. If user says "best dentist in Brooklyn NY serp", use query="best dentist" and location="Brooklyn, NY".'),
+      location: import_zod27.z.string().optional().describe("City, region, or country for geo-targeted results, inferred from user request when present."),
+      gl: import_zod27.z.string().length(2).default("us").describe("Google country code inferred from location or user language."),
+      hl: import_zod27.z.string().default("en").describe("Google interface/content language inferred from user request."),
+      device: import_zod27.z.enum(["desktop", "mobile"]).default("desktop").describe("SERP device context. Use desktop by default; use mobile only when the user asks for mobile rankings."),
+      proxyMode: import_zod27.z.enum(["location", "configured", "none"]).default(DEFAULT_PROXY_MODE).describe("Proxy targeting mode. Default configured uses the service proxy without city/ZIP targeting for the highest general SERP success rate. Use location only when the user explicitly needs city/ZIP-targeted residential proxy evidence. Use none only for direct-network debugging."),
+      proxyZip: import_zod27.z.string().regex(/^\d{5}$/).optional().describe("Optional US ZIP override for residential location proxy targeting. Use only with proxyMode location when the user gives a specific ZIP or city-center targeting needs to be forced."),
+      debug: import_zod27.z.boolean().default(false).describe("Include sanitized browser/session/location diagnostics in the response. Use true when debugging localization, CAPTCHA, or proxy behavior."),
+      pages: import_zod27.z.number().int().min(1).max(2).default(1).describe("Number of result pages to fetch (1\u20132)")
     };
     CaptureSerpSnapshotInputSchema = {
-      query: import_zod26.z.string().min(1).describe("Core search query to capture as a structured SERP Intelligence snapshot. Separate the place into location when the user gives a city, region, country, or ZIP."),
-      location: import_zod26.z.string().optional().describe("City, region, country, or service area used for localized Google results. MCP Scraper records location evidence; UULE alone is not proof of localization."),
-      gl: import_zod26.z.string().length(2).default("us").describe("Google country code inferred from the requested market, e.g. us, gb, ca, au."),
-      hl: import_zod26.z.string().default("en").describe("Google interface/content language inferred from the user request."),
-      device: import_zod26.z.enum(["desktop", "mobile"]).default("desktop").describe("SERP device context. Use mobile only when the user asks for mobile rankings or mobile SERP evidence."),
-      proxyMode: import_zod26.z.enum(["location", "configured", "none"]).default(DEFAULT_PROXY_MODE).describe("Proxy behavior for capture. Default configured uses the service proxy without city/ZIP targeting for the highest general capture success rate. Use location only when the user explicitly needs city/ZIP-targeted residential proxy evidence. Use none only for direct-network debugging."),
-      proxyZip: import_zod26.z.string().regex(/^\d{5}$/).optional().describe("Optional US ZIP override for residential location proxy targeting. Use only with proxyMode location when a precise city-center or ZIP proxy is needed."),
-      pages: import_zod26.z.number().int().min(1).max(2).default(1).describe("Number of Google result pages to capture. Use 1 normally and 2 only when the user needs deeper ranking evidence."),
-      debug: import_zod26.z.boolean().default(false).describe("Include sanitized browser, proxy, and location diagnostics. Use true when debugging localization, CAPTCHA, proxy selection, or capture reliability."),
-      includePageSnapshots: import_zod26.z.boolean().default(false).describe("Also capture ranking-page snapshots for selected SERP URLs through the same product capture path."),
-      pageSnapshotLimit: import_zod26.z.number().int().min(0).max(10).default(0).describe("Maximum ranking-page snapshots to capture when includePageSnapshots is true. Use 0 when only SERP evidence is needed.")
+      query: import_zod27.z.string().min(1).describe("Core search query to capture as a structured SERP Intelligence snapshot. Separate the place into location when the user gives a city, region, country, or ZIP."),
+      location: import_zod27.z.string().optional().describe("City, region, country, or service area used for localized Google results. MCP Scraper records location evidence; UULE alone is not proof of localization."),
+      gl: import_zod27.z.string().length(2).default("us").describe("Google country code inferred from the requested market, e.g. us, gb, ca, au."),
+      hl: import_zod27.z.string().default("en").describe("Google interface/content language inferred from the user request."),
+      device: import_zod27.z.enum(["desktop", "mobile"]).default("desktop").describe("SERP device context. Use mobile only when the user asks for mobile rankings or mobile SERP evidence."),
+      proxyMode: import_zod27.z.enum(["location", "configured", "none"]).default(DEFAULT_PROXY_MODE).describe("Proxy behavior for capture. Default configured uses the service proxy without city/ZIP targeting for the highest general capture success rate. Use location only when the user explicitly needs city/ZIP-targeted residential proxy evidence. Use none only for direct-network debugging."),
+      proxyZip: import_zod27.z.string().regex(/^\d{5}$/).optional().describe("Optional US ZIP override for residential location proxy targeting. Use only with proxyMode location when a precise city-center or ZIP proxy is needed."),
+      pages: import_zod27.z.number().int().min(1).max(2).default(1).describe("Number of Google result pages to capture. Use 1 normally and 2 only when the user needs deeper ranking evidence."),
+      debug: import_zod27.z.boolean().default(false).describe("Include sanitized browser, proxy, and location diagnostics. Use true when debugging localization, CAPTCHA, proxy selection, or capture reliability."),
+      includePageSnapshots: import_zod27.z.boolean().default(false).describe("Also capture ranking-page snapshots for selected SERP URLs through the same product capture path."),
+      pageSnapshotLimit: import_zod27.z.number().int().min(0).max(10).default(0).describe("Maximum ranking-page snapshots to capture when includePageSnapshots is true. Use 0 when only SERP evidence is needed.")
     };
     ScreenshotInputSchema = {
-      url: import_zod26.z.string().url().describe("URL to capture as a full-page screenshot. Use http or https. Pass allowLocal: true to capture localhost or private-network URLs during development."),
-      device: import_zod26.z.enum(["desktop", "mobile"]).default("desktop").describe("Viewport profile. desktop = 1440\xD7900. mobile = 390\xD7844. Use desktop by default; use mobile when the user asks for a mobile view."),
-      allowLocal: import_zod26.z.boolean().default(false).describe("Allow localhost and private-network URLs (127.x, 192.168.x, 10.x, etc.). For local development only \u2014 not for production use.")
+      url: import_zod27.z.string().url().describe("URL to capture as a full-page screenshot. Use http or https. Pass allowLocal: true to capture localhost or private-network URLs during development."),
+      device: import_zod27.z.enum(["desktop", "mobile"]).default("desktop").describe("Viewport profile. desktop = 1440\xD7900. mobile = 390\xD7844. Use desktop by default; use mobile when the user asks for a mobile view."),
+      allowLocal: import_zod27.z.boolean().default(false).describe("Allow localhost and private-network URLs (127.x, 192.168.x, 10.x, etc.). For local development only \u2014 not for production use.")
     };
     CaptureSerpPageSnapshotsInputSchema = {
-      urls: import_zod26.z.array(import_zod26.z.string().url()).min(1).max(25).describe("Public HTTP/HTTPS URLs to capture as SERP Intelligence page snapshots. Do not pass localhost, private IPs, file URLs, or internal admin URLs."),
-      targets: import_zod26.z.array(import_zod26.z.object({
-        url: import_zod26.z.string().url().describe("Public HTTP/HTTPS URL to capture."),
-        sourceKind: import_zod26.z.enum(["organic", "ai_citation", "local_pack_website", "configured_target", "site_subject"]).default("configured_target").describe("Why this page is being captured for SERP Intelligence evidence."),
-        sourcePosition: import_zod26.z.number().int().min(1).optional().describe("Ranking or citation position when the page came from SERP evidence.")
+      urls: import_zod27.z.array(import_zod27.z.string().url()).min(1).max(25).describe("Public HTTP/HTTPS URLs to capture as SERP Intelligence page snapshots. Do not pass localhost, private IPs, file URLs, or internal admin URLs."),
+      targets: import_zod27.z.array(import_zod27.z.object({
+        url: import_zod27.z.string().url().describe("Public HTTP/HTTPS URL to capture."),
+        sourceKind: import_zod27.z.enum(["organic", "ai_citation", "local_pack_website", "configured_target", "site_subject"]).default("configured_target").describe("Why this page is being captured for SERP Intelligence evidence."),
+        sourcePosition: import_zod27.z.number().int().min(1).optional().describe("Ranking or citation position when the page came from SERP evidence.")
       }).strict()).min(1).max(25).optional().describe("Structured page snapshot targets. Use this instead of urls when source kind or position should be preserved."),
-      maxConcurrency: import_zod26.z.number().int().min(1).max(5).default(2).describe("Parallel page captures. Use 2 normally; higher values can increase proxy/browser pressure."),
-      timeoutMs: import_zod26.z.number().int().min(1e3).max(6e4).default(15e3).describe("Per-page capture timeout in milliseconds. Increase for slow pages; timeout artifacts are returned as structured capture failures."),
-      debug: import_zod26.z.boolean().default(false).describe("Include sanitized browser/proxy diagnostics for page snapshot debugging. Use true for capture, network, or proxy troubleshooting.")
+      maxConcurrency: import_zod27.z.number().int().min(1).max(5).default(2).describe("Parallel page captures. Use 2 normally; higher values can increase proxy/browser pressure."),
+      timeoutMs: import_zod27.z.number().int().min(1e3).max(6e4).default(15e3).describe("Per-page capture timeout in milliseconds. Increase for slow pages; timeout artifacts are returned as structured capture failures."),
+      debug: import_zod27.z.boolean().default(false).describe("Include sanitized browser/proxy diagnostics for page snapshot debugging. Use true for capture, network, or proxy troubleshooting.")
     };
   }
 });
@@ -22004,8 +23197,8 @@ function localPlanningToolAnnotations(title) {
 }
 function listSavedReports() {
   try {
-    const dir = outputBaseDir();
-    return (0, import_node_fs6.readdirSync)(dir).filter((f) => f.endsWith(".md")).map((f) => ({ filename: f, mtimeMs: (0, import_node_fs6.statSync)((0, import_node_path9.join)(dir, f)).mtimeMs })).sort((a, b) => b.mtimeMs - a.mtimeMs).slice(0, 100);
+    const dir = outputBaseDir2();
+    return (0, import_node_fs8.readdirSync)(dir).filter((f) => f.endsWith(".md")).map((f) => ({ filename: f, mtimeMs: (0, import_node_fs8.statSync)((0, import_node_path12.join)(dir, f)).mtimeMs })).sort((a, b) => b.mtimeMs - a.mtimeMs).slice(0, 100);
   } catch {
     return [];
   }
@@ -22029,9 +23222,9 @@ function registerSavedReportResources(server) {
     },
     async (uri, variables) => {
       const requested = Array.isArray(variables.filename) ? variables.filename[0] : variables.filename;
-      const filename = (0, import_node_path9.basename)(decodeURIComponent(String(requested ?? "")));
+      const filename = (0, import_node_path12.basename)(decodeURIComponent(String(requested ?? "")));
       if (!filename.endsWith(".md")) throw new Error("Only saved .md reports can be read");
-      const text = (0, import_node_fs6.readFileSync)((0, import_node_path9.join)(outputBaseDir(), filename), "utf8");
+      const text = (0, import_node_fs8.readFileSync)((0, import_node_path12.join)(outputBaseDir2(), filename), "utf8");
       return { contents: [{ uri: uri.href, mimeType: "text/markdown", text }] };
     }
   );
@@ -22123,6 +23316,20 @@ function registerPaaExtractorMcpTools(server, executor, options = {}) {
     outputSchema: FacebookVideoTranscribeOutputSchema,
     annotations: liveWebToolAnnotations("Facebook Organic Video Transcription")
   }, async (input) => formatFacebookVideoTranscribe(await executor.facebookVideoTranscribe(input), input));
+  server.registerTool("instagram_profile_content", {
+    title: "Instagram Profile Content Discovery",
+    description: withReportNote("Discover Instagram profile grid content links for a handle or profile URL. Use this when the user wants a person or brand account content inventory before selecting posts/reels to download. Returns profile stats, collected post/reel/tv URLs, shortcodes, type counts, browser mode, pagination attempts, stop reason, and limitations. For authenticated collection, first use browser_profile_import/sync, then pass browserProfile and raise maxItems/maxScrolls for longer profile pagination."),
+    inputSchema: InstagramProfileContentInputSchema,
+    outputSchema: InstagramProfileContentOutputSchema,
+    annotations: liveWebToolAnnotations("Instagram Profile Content Discovery")
+  }, async (input) => formatInstagramProfileContent(await executor.instagramProfileContent(input), input));
+  server.registerTool("instagram_media_download", {
+    title: "Instagram Post/Reel Media Download",
+    description: withReportNote("Extract and download media from one Instagram post, reel, or tv URL. Use after instagram_profile_content or when the user gives a specific Instagram URL and wants the image, caption/text, reel audio/video tracks, optional muxed MP4, or optional transcript. Reels commonly expose separate video-only and audio-only MP4 tracks; this tool selects the best video and audio tracks and attempts muxing when ffmpeg is available. Pass browserProfile from browser_profile_import/sync when the media is login-gated."),
+    inputSchema: InstagramMediaDownloadInputSchema,
+    outputSchema: InstagramMediaDownloadOutputSchema,
+    annotations: liveWebToolAnnotations("Instagram Post/Reel Media Download")
+  }, async (input) => formatInstagramMediaDownload(await executor.instagramMediaDownload(input), input));
   server.registerTool("maps_place_intel", {
     title: "Google Maps Business Profile Details",
     description: withReportNote('Extract Google Maps business intelligence for one known/named business: rating, review count, category, address, phone, website, hours, booking URL, review histogram, review topics, about attributes, entity IDs, and optional review cards. Do not use this for category searches, local market prospect lists, or requests for multiple GMB/GBP profiles; use maps_search first for those. Split business name from location (e.g. "Elite Roofing Denver CO" => businessName "Elite Roofing", location "Denver, CO"). Pass includeReviews true when the user asks for reviews/customer pain.'),
@@ -22207,13 +23414,13 @@ function registerPaaExtractorMcpTools(server, executor, options = {}) {
     }
   }, async (input) => formatCreditsInfo(await executor.creditsInfo(input), input));
 }
-var import_mcp, import_node_fs6, import_node_path9;
+var import_mcp, import_node_fs8, import_node_path12;
 var init_paa_mcp_server = __esm({
   "src/mcp/paa-mcp-server.ts"() {
     "use strict";
     import_mcp = require("@modelcontextprotocol/sdk/server/mcp.js");
-    import_node_fs6 = require("fs");
-    import_node_path9 = require("path");
+    import_node_fs8 = require("fs");
+    import_node_path12 = require("path");
     init_version();
     init_mcp_response_formatter();
     init_mcp_tool_schemas();
@@ -22402,6 +23609,12 @@ var init_http_mcp_tool_executor = __esm({
       facebookVideoTranscribe(input) {
         return this.call("/facebook/video-transcribe", input, this.httpTimeoutOverrideMs ?? 24e4);
       }
+      instagramProfileContent(input) {
+        return this.call("/instagram/profile-content", input, this.httpTimeoutOverrideMs ?? 24e4);
+      }
+      instagramMediaDownload(input) {
+        return this.call("/instagram/media-download", input, this.httpTimeoutOverrideMs ?? 3e5);
+      }
       mapsPlaceIntel(input) {
         return this.call("/maps/place", input);
       }
@@ -22495,11 +23708,11 @@ function registerSerpIntelligenceCaptureTools(server, executor) {
     annotations: liveWebToolAnnotations("SERP Intelligence Page Snapshots")
   }, async (input) => formatCaptureSerpPageSnapshots(await executor.captureSerpPageSnapshots(input), input));
 }
-var import_hono9, import_webStandardStreamableHttp, mcpApp;
+var import_hono10, import_webStandardStreamableHttp, mcpApp;
 var init_mcp_routes = __esm({
   "src/mcp/mcp-routes.ts"() {
     "use strict";
-    import_hono9 = require("hono");
+    import_hono10 = require("hono");
     import_webStandardStreamableHttp = require("@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js");
     init_paa_mcp_server();
     init_http_mcp_tool_executor();
@@ -22507,7 +23720,7 @@ var init_mcp_routes = __esm({
     init_db();
     init_mcp_tool_schemas();
     configureReportSaving(false);
-    mcpApp = new import_hono9.Hono();
+    mcpApp = new import_hono10.Hono();
     mcpApp.all("/", async (c) => {
       try {
         const keyOrError = await requireMcpCallerKey(c);
@@ -23371,19 +24584,19 @@ var init_classify = __esm({
 });
 
 // src/services/fanout/export.ts
-function outputBaseDir2() {
-  return process.env.MCP_SCRAPER_OUTPUT_DIR?.trim() || (0, import_node_path10.join)((0, import_node_os5.homedir)(), "Downloads", "mcp-scraper");
+function outputBaseDir3() {
+  return process.env.MCP_SCRAPER_OUTPUT_DIR?.trim() || (0, import_node_path13.join)((0, import_node_os8.homedir)(), "Downloads", "mcp-scraper");
 }
 function safe(value) {
   return value.replace(/[^a-zA-Z0-9._-]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 80) || "capture";
 }
 function writeTable(path6, rows, delimiter) {
-  (0, import_node_fs7.writeFileSync)(path6, import_papaparse3.default.unparse(rows.length ? rows : [{}], { delimiter }));
+  (0, import_node_fs9.writeFileSync)(path6, import_papaparse3.default.unparse(rows.length ? rows : [{}], { delimiter }));
 }
 function exportFanout(enriched) {
   const stamp = safe(enriched.capturedAt.replace(/[:.]/g, "-"));
-  const dir = (0, import_node_path10.join)(outputBaseDir2(), "fanout", `${stamp}-${safe(enriched.platform)}`);
-  (0, import_node_fs7.mkdirSync)(dir, { recursive: true });
+  const dir = (0, import_node_path13.join)(outputBaseDir3(), "fanout", `${stamp}-${safe(enriched.platform)}`);
+  (0, import_node_fs9.mkdirSync)(dir, { recursive: true });
   const queryRows = enriched.queries.map((q, i) => ({ index: i + 1, query: q }));
   const citationRows = enriched.aggregates.citationOrder.map((c) => {
     const src = enriched.citedUrls.find((s) => s.url === c.url);
@@ -23393,21 +24606,21 @@ function exportFanout(enriched) {
   const domainRows = enriched.aggregates.topSites.map((d) => ({ domain: d.domain, count: d.count, cited: d.cited, timesCited: d.timesCited, siteType: d.siteType }));
   const paths = {
     dir,
-    json: (0, import_node_path10.join)(dir, "fanout.json"),
-    queriesCsv: (0, import_node_path10.join)(dir, "queries.csv"),
-    queriesTsv: (0, import_node_path10.join)(dir, "queries.tsv"),
-    citationsCsv: (0, import_node_path10.join)(dir, "citations.csv"),
-    sourcesCsv: (0, import_node_path10.join)(dir, "sources.csv"),
-    domainsCsv: (0, import_node_path10.join)(dir, "domains.csv"),
-    report: (0, import_node_path10.join)(dir, "report.html")
+    json: (0, import_node_path13.join)(dir, "fanout.json"),
+    queriesCsv: (0, import_node_path13.join)(dir, "queries.csv"),
+    queriesTsv: (0, import_node_path13.join)(dir, "queries.tsv"),
+    citationsCsv: (0, import_node_path13.join)(dir, "citations.csv"),
+    sourcesCsv: (0, import_node_path13.join)(dir, "sources.csv"),
+    domainsCsv: (0, import_node_path13.join)(dir, "domains.csv"),
+    report: (0, import_node_path13.join)(dir, "report.html")
   };
-  (0, import_node_fs7.writeFileSync)(paths.json, JSON.stringify(enriched, null, 2));
+  (0, import_node_fs9.writeFileSync)(paths.json, JSON.stringify(enriched, null, 2));
   writeTable(paths.queriesCsv, queryRows, ",");
   writeTable(paths.queriesTsv, queryRows, "	");
   writeTable(paths.citationsCsv, citationRows, ",");
   writeTable(paths.sourcesCsv, sourceRows2, ",");
   writeTable(paths.domainsCsv, domainRows, ",");
-  (0, import_node_fs7.writeFileSync)(paths.report, renderReportHtml(enriched));
+  (0, import_node_fs9.writeFileSync)(paths.report, renderReportHtml(enriched));
   return paths;
 }
 function esc(s) {
@@ -23485,13 +24698,13 @@ render();
 </script>
 </body></html>`;
 }
-var import_node_fs7, import_node_os5, import_node_path10, import_papaparse3;
+var import_node_fs9, import_node_os8, import_node_path13, import_papaparse3;
 var init_export = __esm({
   "src/services/fanout/export.ts"() {
     "use strict";
-    import_node_fs7 = require("fs");
-    import_node_os5 = require("os");
-    import_node_path10 = require("path");
+    import_node_fs9 = require("fs");
+    import_node_os8 = require("os");
+    import_node_path13 = require("path");
     import_papaparse3 = __toESM(require("papaparse"), 1);
   }
 });
@@ -23983,7 +25196,7 @@ async function loadOpenSession(id, userId) {
   return row;
 }
 function buildBrowserAgentRoutes() {
-  const app2 = new import_hono10.Hono();
+  const app2 = new import_hono11.Hono();
   app2.use("*", async (c, next) => {
     await migrateBrowserAgent();
     return next();
@@ -24340,11 +25553,11 @@ function buildBrowserAgentRoutes() {
   });
   return app2;
 }
-var import_hono10, auth, DEFAULT_BROWSER_SESSION_LOCK_TTL_SECONDS;
+var import_hono11, auth, DEFAULT_BROWSER_SESSION_LOCK_TTL_SECONDS;
 var init_browser_agent_routes = __esm({
   "src/api/browser-agent-routes.ts"() {
     "use strict";
-    import_hono10 = require("hono");
+    import_hono11 = require("hono");
     init_api_auth();
     init_errors();
     init_db();
@@ -24561,16 +25774,16 @@ var init_browser_agent_console = __esm({
 });
 
 // src/api/stripe-routes.ts
-var import_stripe, import_hono11, stripe, stripeApp;
+var import_stripe, import_hono12, stripe, stripeApp;
 var init_stripe_routes = __esm({
   "src/api/stripe-routes.ts"() {
     "use strict";
     import_stripe = __toESM(require("stripe"), 1);
-    import_hono11 = require("hono");
+    import_hono12 = require("hono");
     init_db();
     init_rates();
     stripe = new import_stripe.default(process.env.STRIPE_SECRET_KEY, { apiVersion: "2026-02-25.clover" });
-    stripeApp = new import_hono11.Hono();
+    stripeApp = new import_hono12.Hono();
     stripeApp.post("/webhooks", async (c) => {
       const sig = c.req.header("stripe-signature");
       const body = await c.req.text();
@@ -24671,31 +25884,31 @@ var init_site_audit_worker = __esm({
 });
 
 // src/api/billing-schemas.ts
-var import_zod27, BillingCheckoutBodySchema, FreeCreditBreakdownSchema, BillingBalanceResponseSchema, MonthlyRefreshSweepResultSchema;
+var import_zod28, BillingCheckoutBodySchema, FreeCreditBreakdownSchema, BillingBalanceResponseSchema, MonthlyRefreshSweepResultSchema;
 var init_billing_schemas = __esm({
   "src/api/billing-schemas.ts"() {
     "use strict";
-    import_zod27 = require("zod");
-    BillingCheckoutBodySchema = import_zod27.z.object({
-      priceId: import_zod27.z.string().min(1)
+    import_zod28 = require("zod");
+    BillingCheckoutBodySchema = import_zod28.z.object({
+      priceId: import_zod28.z.string().min(1)
     });
-    FreeCreditBreakdownSchema = import_zod27.z.object({
-      signup_grant_mc: import_zod27.z.number().int().nonnegative(),
-      monthly_refresh_mc: import_zod27.z.number().int().nonnegative(),
-      total_free_mc: import_zod27.z.number().int().nonnegative(),
-      signup_grant_credits: import_zod27.z.number().nonnegative(),
-      monthly_refresh_credits: import_zod27.z.number().nonnegative(),
-      total_free_credits: import_zod27.z.number().nonnegative()
+    FreeCreditBreakdownSchema = import_zod28.z.object({
+      signup_grant_mc: import_zod28.z.number().int().nonnegative(),
+      monthly_refresh_mc: import_zod28.z.number().int().nonnegative(),
+      total_free_mc: import_zod28.z.number().int().nonnegative(),
+      signup_grant_credits: import_zod28.z.number().nonnegative(),
+      monthly_refresh_credits: import_zod28.z.number().nonnegative(),
+      total_free_credits: import_zod28.z.number().nonnegative()
     });
-    BillingBalanceResponseSchema = import_zod27.z.object({
-      balance_mc: import_zod27.z.number().int().nonnegative(),
-      balance_credits: import_zod27.z.number().nonnegative(),
+    BillingBalanceResponseSchema = import_zod28.z.object({
+      balance_mc: import_zod28.z.number().int().nonnegative(),
+      balance_credits: import_zod28.z.number().nonnegative(),
       free_credits: FreeCreditBreakdownSchema,
-      ledger: import_zod27.z.array(import_zod27.z.any())
+      ledger: import_zod28.z.array(import_zod28.z.any())
     });
-    MonthlyRefreshSweepResultSchema = import_zod27.z.object({
-      usersRefreshed: import_zod27.z.number().int().nonnegative(),
-      totalMcGranted: import_zod27.z.number().int().nonnegative()
+    MonthlyRefreshSweepResultSchema = import_zod28.z.object({
+      usersRefreshed: import_zod28.z.number().int().nonnegative(),
+      totalMcGranted: import_zod28.z.number().int().nonnegative()
     });
   }
 });
@@ -25106,7 +26319,7 @@ async function checkHarvestLimits(user, reuseLockId) {
   }
   return null;
 }
-var import_resend, import_hono12, import_hono13, import_factory6, import_cookie, import_stripe2, secureCookies, isProduction2, sessionCookieOptions, requireAllowedOrigin, auth2, adminAuth, sessionAuth, app, STRIPE_API_VERSION, SYNC_HARVEST_TIMEOUT_OVERRIDE_MS;
+var import_resend, import_hono13, import_hono14, import_factory6, import_cookie, import_stripe2, secureCookies, isProduction2, sessionCookieOptions, requireAllowedOrigin, auth2, adminAuth, sessionAuth, app, STRIPE_API_VERSION, SYNC_HARVEST_TIMEOUT_OVERRIDE_MS;
 var init_server = __esm({
   "src/api/server.ts"() {
     "use strict";
@@ -25124,14 +26337,15 @@ var init_server = __esm({
     init_media_extractor();
     init_site_mapper();
     init_site_extractor();
-    import_hono12 = require("hono");
-    import_hono13 = require("inngest/hono");
+    import_hono13 = require("hono");
+    import_hono14 = require("inngest/hono");
     init_client();
     init_site_audit();
     init_site_audit_routes();
     init_youtube_routes();
     init_screenshot_routes();
     init_facebook_ad_routes();
+    init_instagram_routes();
     init_maps_routes();
     init_directory_routes();
     init_workflow_routes();
@@ -25199,7 +26413,7 @@ var init_server = __esm({
       c.set("sessionUser", { ...refreshed, balance_mc: balanceMc });
       return next();
     });
-    app = new import_hono12.Hono();
+    app = new import_hono13.Hono();
     STRIPE_API_VERSION = "2026-02-25.clover";
     app.use("*", async (c, next) => {
       await next();
@@ -25578,7 +26792,10 @@ var init_server = __esm({
         const device = screenshotDevice === "mobile" ? "mobile" : "desktop";
         const [result, pageData] = await Promise.all([
           extractKpo({ url: canonicalUrl, kernelApiKey }),
-          screenshot2 || extractBranding ? capturePageData(canonicalUrl, { kernelApiKey, device, screenshot: !!screenshot2, branding: !!extractBranding }).catch(() => null) : null
+          screenshot2 || extractBranding ? capturePageData(canonicalUrl, { kernelApiKey, device, screenshot: !!screenshot2, branding: !!extractBranding }).catch((err) => {
+            console.error("[extract-url] capturePageData failed:", err instanceof Error ? err.message : err);
+            return null;
+          }) : null
         ]);
         const screenshotBuf = pageData?.screenshot ?? null;
         const brandingData = pageData?.branding ?? null;
@@ -25586,7 +26803,7 @@ var init_server = __esm({
         if (screenshotBuf) {
           screenshotMeta = { base64: screenshotBuf.toString("base64"), sizeBytes: screenshotBuf.length, device };
         }
-        const mediaMeta = downloadMedia ? await harvestPageMedia(result.bodyHtml, canonicalUrl, { types: mediaTypes ?? ["image", "video", "audio"] }) : null;
+        const mediaMeta = downloadMedia ? await harvestPageMedia(result.bodyHtml, canonicalUrl, { types: mediaTypes ?? ["image", "video", "audio"], outputDir: null }) : null;
         await logRequestEvent({ userId: user.id, source: "extract_url", status: "done", query: canonicalUrl, resultCount: result.headings.length, result });
         return c.json({ ...result, screenshot: screenshotMeta, branding: brandingData, media: mediaMeta });
       } catch (err) {
@@ -25889,11 +27106,12 @@ var init_server = __esm({
       ]);
       return c.json({ drained: results.length, results, sweepResult, workflowDispatch: workflowDispatchResult });
     });
-    app.on(["GET", "POST", "PUT"], "/api/inngest", (0, import_hono13.serve)({ client: inngest, functions: [siteAuditFn] }));
+    app.on(["GET", "POST", "PUT"], "/api/inngest", (0, import_hono14.serve)({ client: inngest, functions: [siteAuditFn] }));
     app.route("/api/internal/site-architecture-auditor", siteAuditApp);
     app.route("/youtube", youtubeApp);
     app.route("/screenshot", screenshotApp);
     app.route("/facebook", facebookAdApp);
+    app.route("/instagram", instagramApp);
     app.route("/maps", mapsApp);
     app.route("/directory", directoryApp);
     app.route("/workflows", workflowApp);
@@ -26010,10 +27228,10 @@ ${ATTRIBUTION_PIXEL_SCRIPT}
 });
 
 // bin/api-server.ts
-var import_node_fs8 = require("fs");
+var import_node_fs10 = require("fs");
 function loadDotEnv() {
   try {
-    for (const line of (0, import_node_fs8.readFileSync)(".env", "utf8").split("\n")) {
+    for (const line of (0, import_node_fs10.readFileSync)(".env", "utf8").split("\n")) {
       const eq = line.indexOf("=");
       if (eq < 1 || line.trimStart().startsWith("#")) continue;
       const k = line.slice(0, eq).trim();