mcp-scraper 0.3.42 → 0.3.45

package/dist/bin/api-server.cjs

@@ -4103,6 +4103,12 @@ async function migrate() {
     )
   `);
   await db.execute(`CREATE INDEX IF NOT EXISTS oauth_tokens_identity ON oauth_tokens(identity)`);
+  for (const col of ["replaced_by TEXT", "rotated_at TEXT"]) {
+    try {
+      await db.execute(`ALTER TABLE oauth_tokens ADD COLUMN ${col}`);
+    } catch {
+    }
+  }
 }
 async function registerClient(clientId, redirectUris, name) {
   await getDb().execute({
@@ -4168,15 +4174,20 @@ async function getRefresh(refreshToken) {
     scope: String(row.scope),
     resource: row.resource != null ? String(row.resource) : null,
     expires_at: String(row.expires_at),
-    revoked: Number(row.revoked ?? 0)
+    revoked: Number(row.revoked ?? 0),
+    replaced_by: row.replaced_by != null ? String(row.replaced_by) : null,
+    rotated_at: row.rotated_at != null ? String(row.rotated_at) : null
   };
 }
 async function revokeRefresh(refreshToken) {
   await getDb().execute({ sql: "UPDATE oauth_tokens SET revoked = 1 WHERE refresh_token = ?", args: [refreshToken] });
 }
 async function rotateRefresh(oldToken, next) {
-  await revokeRefresh(oldToken);
   await putRefresh(next);
+  await getDb().execute({
+    sql: "UPDATE oauth_tokens SET revoked = 1, replaced_by = ?, rotated_at = ? WHERE refresh_token = ?",
+    args: [next.refresh_token, (/* @__PURE__ */ new Date()).toISOString(), oldToken]
+  });
 }
 async function recordStripeEvent(eventId) {
   const res = await getDb().execute({
@@ -10060,7 +10071,7 @@ function insufficientBalanceResponse(balanceMc, requiredMc) {
     topup_url: topupUrl
   };
 }
-var MC_COSTS, MC_PER_BROWSER_MS, BROWSER_OPEN_MIN_BALANCE_MC, MC_PER_CREDIT, CREDIT_COST_CATALOG, CONCURRENCY_PRICE_ID, SUBSCRIPTION_TIERS, SUBSCRIPTION_TIER_BY_KEY, CONCURRENCY_SLOT_PRICE_USD, CONCURRENCY_SLOT_PRICE_CURRENCY, CONCURRENCY_SLOT_PRICE_INTERVAL, CONCURRENCY_SLOT_PRICE_LABEL, CONCURRENCY_SLOT_TERMINAL_COMMAND, FREE_SIGNUP_MC, MEMORY_FREE_QUOTA_BYTES, MEMORY_PLANS, MEMORY_PLAN_QUOTA, MEMORY_MARGIN_MULTIPLE, MEMORY_PRO_COST_BUDGET_USD, SCHEDULING_PLANS, LedgerOperation;
+var MC_COSTS, MC_PER_BROWSER_MS, BROWSER_OPEN_MIN_BALANCE_MC, MC_PER_CREDIT, CREDIT_COST_CATALOG, CONCURRENCY_PRICE_ID, SUBSCRIPTION_TIERS, SUBSCRIPTION_TIER_BY_KEY, CONCURRENCY_SLOT_PRICE_USD, CONCURRENCY_SLOT_PRICE_CURRENCY, CONCURRENCY_SLOT_PRICE_INTERVAL, CONCURRENCY_SLOT_PRICE_LABEL, CONCURRENCY_SLOT_TERMINAL_COMMAND, FREE_SIGNUP_MC, MEMORY_FREE_QUOTA_BYTES, MEMORY_PLANS, MEMORY_PLAN_QUOTA, MEMORY_MARGIN_MULTIPLE, MEMORY_PRO_COST_BUDGET_USD, SCHEDULING_PLANS, LedgerOperation, MEMORY_AI_MARGIN_MULTIPLE, MC_PER_USD;
 var init_rates = __esm({
   "src/api/rates.ts"() {
     "use strict";
@@ -10085,7 +10096,8 @@ var init_rates = __esm({
       instagram_media: 400,
       instagram_transcribe: 50,
       browser_minute: 12e3,
-      reddit_thread: 2e3
+      reddit_thread: 2e3,
+      video_analysis: 666667
     };
     MC_PER_BROWSER_MS = MC_COSTS.browser_minute / 6e4;
     BROWSER_OPEN_MIN_BALANCE_MC = 1e3;
@@ -10248,6 +10260,14 @@ var init_rates = __esm({
         credits: mcToCredits(MC_COSTS.reddit_thread),
         unit: "per thread",
         notes: "Captures a Reddit post and its comment tree. Charged on success; refunded if the thread cannot be retrieved."
+      },
+      {
+        key: "video_analysis",
+        label: "Video breakdown (frame-by-frame + transcript)",
+        aliases: ["video_frame_analysis", "video breakdown", "video analysis", "analyze video"],
+        credits: mcToCredits(MC_COSTS.video_analysis),
+        unit: "per video",
+        notes: "Full multi-lens video breakdown: samples up to 120 frames across a video (to 30 min), analyzes each with vision AI, transcribes the audio, then produces summary, pacing/energy, words-per-minute, topic outline, key points, hook analysis, visual style, and a how-to-replicate recipe with a quality-control pass. Flat $1 per video; refunded if the run fails."
       }
     ];
     CONCURRENCY_PRICE_ID = "price_1Ta1NRS8aAcsk3TGwsRnYbix";
@@ -10320,8 +10340,14 @@ var init_rates = __esm({
       INSTAGRAM_TRANSCRIBE_REFUND: "instagram_transcribe_refund",
       BROWSER_SESSION: "browser_session",
       REDDIT_THREAD: "reddit_thread",
-      REDDIT_THREAD_REFUND: "reddit_thread_refund"
+      REDDIT_THREAD_REFUND: "reddit_thread_refund",
+      VIDEO_ANALYSIS: "video_analysis",
+      VIDEO_ANALYSIS_REFUND: "video_analysis_refund",
+      MEMORY_AI: "memory_ai",
+      MEMORY_AI_REFUND: "memory_ai_refund"
     };
+    MEMORY_AI_MARGIN_MULTIPLE = 3;
+    MC_PER_USD = SUBSCRIPTION_TIERS["price_1TmiHRS8aAcsk3TGwmSNfNIa"].credits_mc / SUBSCRIPTION_TIERS["price_1TmiHRS8aAcsk3TGwmSNfNIa"].monthly_usd;
   }
 });
 
@@ -11188,6 +11214,34 @@ var init_site_audit_routes = __esm({
   }
 });
 
+// src/api/internal-memory-routes.ts
+var import_hono2, internalMemoryApp;
+var init_internal_memory_routes = __esm({
+  "src/api/internal-memory-routes.ts"() {
+    "use strict";
+    import_hono2 = require("hono");
+    init_db();
+    init_rates();
+    internalMemoryApp = new import_hono2.Hono();
+    internalMemoryApp.post("/ai-debit", async (c) => {
+      const secret2 = c.req.header("x-internal-secret");
+      if (!secret2 || secret2 !== process.env.INTERNAL_MEMORY_DEBIT_SECRET) {
+        return c.json({ error: "unauthorized" }, 401);
+      }
+      const body = await c.req.json().catch(() => ({}));
+      if (!body.identity || typeof body.costUsd !== "number" || body.costUsd < 0) {
+        return c.json({ error: "invalid_request" }, 400);
+      }
+      const user = await getUserByEmail(body.identity.trim().toLowerCase());
+      if (!user) return c.json({ ok: false, reason: "no_user" }, 200);
+      const mc = Math.round(body.costUsd * MEMORY_AI_MARGIN_MULTIPLE * MC_PER_USD);
+      if (mc <= 0) return c.json({ ok: true, mc: 0, balance_mc: null }, 200);
+      const { ok, balance_mc } = await debitMc(user.id, mc, LedgerOperation.MEMORY_AI, `${body.source ?? "ai"}:${body.op ?? ""}`);
+      return c.json({ ok, mc, balance_mc, insufficient: !ok }, 200);
+    });
+  }
+});
+
 // src/youtube/schemas.ts
 var import_zod12, YouTubeHarvestOptionsSchema;
 var init_schemas2 = __esm({
@@ -13012,11 +13066,11 @@ ${chunks}` : ""}
 function fmtTs(secs) {
   return `${Math.floor(secs / 60)}:${String(Math.floor(secs % 60)).padStart(2, "0")}`;
 }
-var import_hono2, youtubeApp;
+var import_hono3, youtubeApp;
 var init_youtube_routes = __esm({
   "src/api/youtube-routes.ts"() {
     "use strict";
-    import_hono2 = require("hono");
+    import_hono3 = require("hono");
     init_db();
     init_rates();
     init_youtube_harvest();
@@ -13027,7 +13081,7 @@ var init_youtube_routes = __esm({
     init_api_auth();
     init_server_schemas();
     init_concurrency_gates();
-    youtubeApp = new import_hono2.Hono();
+    youtubeApp = new import_hono3.Hono();
     youtubeApp.post("/harvest", createApiKeyAuth(), async (c) => {
       const raw = await c.req.json().catch(() => ({}));
       const parsed = YoutubeHarvestBodySchema.safeParse(raw);
@@ -13140,11 +13194,11 @@ var init_youtube_routes = __esm({
 });
 
 // src/api/screenshot-routes.ts
-var import_hono3, import_zod14, ScreenshotBodySchema, screenshotApp;
+var import_hono4, import_zod14, ScreenshotBodySchema, screenshotApp;
 var init_screenshot_routes = __esm({
   "src/api/screenshot-routes.ts"() {
     "use strict";
-    import_hono3 = require("hono");
+    import_hono4 = require("hono");
     init_browser_service_env();
     import_zod14 = require("zod");
     init_screenshot();
@@ -13158,7 +13212,7 @@ var init_screenshot_routes = __esm({
       device: import_zod14.z.string().trim().optional(),
       allowLocal: import_zod14.z.boolean().optional()
     });
-    screenshotApp = new import_hono3.Hono();
+    screenshotApp = new import_hono4.Hono();
     screenshotApp.use("*", createApiKeyAuth());
     screenshotApp.post("/", async (c) => {
       const raw = await c.req.json().catch(() => ({}));
@@ -14865,11 +14919,11 @@ async function kernelLaunchOptsResidential() {
   }
   return { headless: true, kernelApiKey: browserServiceApiKey(), kernelProxyId: proxyId, viewport: { width: 1280, height: 900 }, locale: "en-US" };
 }
-var import_hono4, import_zod16, import_client5, FacebookAdBodySchema, FacebookPageIntelBodySchema, FacebookTranscribeBodySchema, FacebookVideoTranscribeBodySchema, FacebookSearchBodySchema, FacebookMediaBodySchema, facebookAdApp, ALLOWED_MEDIA_HOSTS;
+var import_hono5, import_zod16, import_client5, FacebookAdBodySchema, FacebookPageIntelBodySchema, FacebookTranscribeBodySchema, FacebookVideoTranscribeBodySchema, FacebookSearchBodySchema, FacebookMediaBodySchema, facebookAdApp, ALLOWED_MEDIA_HOSTS;
 var init_facebook_ad_routes = __esm({
   "src/api/facebook-ad-routes.ts"() {
     "use strict";
-    import_hono4 = require("hono");
+    import_hono5 = require("hono");
     init_browser_service_env();
     import_zod16 = require("zod");
     init_db();
@@ -14915,7 +14969,7 @@ var init_facebook_ad_routes = __esm({
       url: import_zod16.z.string().trim().min(1, "url is required"),
       filename: import_zod16.z.string().trim().optional()
     });
-    facebookAdApp = new import_hono4.Hono();
+    facebookAdApp = new import_hono5.Hono();
     facebookAdApp.post("/ad", createApiKeyAuth(), async (c) => {
       const raw = await c.req.json().catch(() => ({}));
       const parsed = FacebookAdBodySchema.safeParse(raw);
@@ -15446,11 +15500,11 @@ async function kernelLaunchOptsResidential2() {
 function isBlockedMessage(msg) {
   return msg.toLowerCase().includes("blocked") || msg.toLowerCase().includes("captcha");
 }
-var import_hono5, import_zod17, import_client6, GoogleAdsSearchBodySchema, GoogleAdsPageIntelBodySchema, GoogleAdsTranscribeBodySchema, googleAdsApp;
+var import_hono6, import_zod17, import_client6, GoogleAdsSearchBodySchema, GoogleAdsPageIntelBodySchema, GoogleAdsTranscribeBodySchema, googleAdsApp;
 var init_google_ads_routes = __esm({
   "src/api/google-ads-routes.ts"() {
     "use strict";
-    import_hono5 = require("hono");
+    import_hono6 = require("hono");
     import_zod17 = require("zod");
     init_browser_service_env();
     init_db();
@@ -15478,7 +15532,7 @@ var init_google_ads_routes = __esm({
     GoogleAdsTranscribeBodySchema = import_zod17.z.object({
       videoUrl: import_zod17.z.string().trim().min(1, "videoUrl is required")
     });
-    googleAdsApp = new import_hono5.Hono();
+    googleAdsApp = new import_hono6.Hono();
     googleAdsApp.post("/search", createApiKeyAuth(), async (c) => {
       const raw = await c.req.json().catch(() => ({}));
       const parsed = GoogleAdsSearchBodySchema.safeParse(raw);
@@ -16053,11 +16107,11 @@ function trackFilename(track, index, shortcode) {
   const bitrate = track.bitrate ? `-${track.bitrate}` : "";
   return `${label}-${type}-${index}${bitrate}.mp4`;
 }
-var import_hono6, import_zod18, import_node_fs4, import_node_os4, import_node_path6, import_node_stream2, import_promises4, import_node_child_process2, InstagramProfileContentBodySchema, InstagramMediaTypeSchema, InstagramMediaDownloadBodySchema, instagramApp;
+var import_hono7, import_zod18, import_node_fs4, import_node_os4, import_node_path6, import_node_stream2, import_promises4, import_node_child_process2, InstagramProfileContentBodySchema, InstagramMediaTypeSchema, InstagramMediaDownloadBodySchema, instagramApp;
 var init_instagram_routes = __esm({
   "src/api/instagram-routes.ts"() {
     "use strict";
-    import_hono6 = require("hono");
+    import_hono7 = require("hono");
     import_zod18 = require("zod");
     import_node_fs4 = require("fs");
     import_node_os4 = require("os");
@@ -16099,7 +16153,7 @@ var init_instagram_routes = __esm({
       includeTranscript: import_zod18.z.boolean().default(false),
       mux: import_zod18.z.boolean().default(true)
     });
-    instagramApp = new import_hono6.Hono();
+    instagramApp = new import_hono7.Hono();
     instagramApp.post("/profile-content", createApiKeyAuth(), async (c) => {
       const raw = await c.req.json().catch(() => ({}));
       const parsed = InstagramProfileContentBodySchema.safeParse(raw);
@@ -16304,11 +16358,11 @@ async function residentialProxyId(attemptIndex) {
     return void 0;
   }
 }
-var import_hono7, import_zod19, RedditThreadBodySchema, PARSE_REDDIT, redditApp;
+var import_hono8, import_zod19, RedditThreadBodySchema, PARSE_REDDIT, redditApp;
 var init_reddit_routes = __esm({
   "src/api/reddit-routes.ts"() {
     "use strict";
-    import_hono7 = require("hono");
+    import_hono8 = require("hono");
     import_zod19 = require("zod");
     init_BrowserDriver();
     init_kernel_proxy_resolver();
@@ -16346,7 +16400,7 @@ var init_reddit_routes = __esm({
   });
   return { title: title, author: author, score: score, postBody: postBody, blocked: blocked, numComments: comments.length, comments: comments };
 })()`;
-    redditApp = new import_hono7.Hono();
+    redditApp = new import_hono8.Hono();
     redditApp.post("/thread", createApiKeyAuth(), async (c) => {
       const raw = await c.req.json().catch(() => ({}));
       const parsed = RedditThreadBodySchema.safeParse(raw);
@@ -16380,11 +16434,11 @@ var init_reddit_routes = __esm({
               locale: "en-US"
             });
             const page = driver.getPage();
-            await page.goto(oldUrl, { waitUntil: "domcontentloaded", timeout: 45e3 });
+            await page.goto(oldUrl, { waitUntil: "domcontentloaded", timeout: attempt === 0 ? 3e4 : 45e3 });
             await page.waitForTimeout(2500);
             const data = await page.evaluate(PARSE_REDDIT);
             if (!data.blocked && (data.postBody || data.comments.length > 0)) {
-              result = { ...data, sourceUrl: body.url, oldRedditUrl: oldUrl, attempts: attempt + 1 };
+              result = { ...data, sourceUrl: body.url, oldRedditUrl: oldUrl, attempts: attempt + 1, proxied: Boolean(proxyId) };
             }
           } catch {
           } finally {
@@ -16415,6 +16469,249 @@ var init_reddit_routes = __esm({
   }
 });
 
+// src/api/session.ts
+function getSessionSecret() {
+  const configured = process.env.SESSION_SECRET?.trim();
+  if (configured) return configured;
+  if (isProduction()) throw new Error("SESSION_SECRET is not set \u2014 add it to your Vercel env vars (see src/api/env.ts)");
+  return "dev-secret-change-me";
+}
+function safeEqualHex(a, b) {
+  if (a.length !== b.length) return false;
+  try {
+    return (0, import_node_crypto5.timingSafeEqual)(Buffer.from(a, "hex"), Buffer.from(b, "hex"));
+  } catch {
+    return false;
+  }
+}
+function signSession(userId) {
+  const payload = String(userId);
+  const sig = (0, import_node_crypto5.createHmac)("sha256", secret()).update(payload).digest("hex");
+  return `${payload}.${sig}`;
+}
+function verifySession(token) {
+  const dot = token.lastIndexOf(".");
+  if (dot === -1) return null;
+  const payload = token.slice(0, dot);
+  const sig = token.slice(dot + 1);
+  const expected = (0, import_node_crypto5.createHmac)("sha256", secret()).update(payload).digest("hex");
+  if (!safeEqualHex(sig, expected)) return null;
+  const id = parseInt(payload);
+  return isNaN(id) ? null : id;
+}
+var import_node_crypto5, isProduction, secret;
+var init_session = __esm({
+  "src/api/session.ts"() {
+    "use strict";
+    import_node_crypto5 = require("crypto");
+    isProduction = () => process.env.NODE_ENV === "production" || process.env.VERCEL === "1";
+    secret = () => getSessionSecret();
+  }
+});
+
+// src/api/memory.ts
+function isMemoryOperator(email) {
+  if (!email) return false;
+  const ops = (process.env.MEMORY_OPERATOR_IDENTITIES ?? "").split(",").map((s) => s.trim().toLowerCase()).filter(Boolean);
+  return ops.includes(email.trim().toLowerCase());
+}
+function encKey() {
+  return (0, import_node_crypto6.scryptSync)(getSessionSecret(), "mcp-memory-key-v1", 32);
+}
+function encryptMemoryKey(secret2) {
+  const iv = (0, import_node_crypto6.randomBytes)(12);
+  const cipher = (0, import_node_crypto6.createCipheriv)("aes-256-gcm", encKey(), iv);
+  const enc = Buffer.concat([cipher.update(secret2, "utf8"), cipher.final()]);
+  const tag = cipher.getAuthTag();
+  return `${iv.toString("base64")}:${tag.toString("base64")}:${enc.toString("base64")}`;
+}
+function decryptMemoryKey(stored) {
+  try {
+    const [ivB, tagB, dataB] = stored.split(":");
+    const decipher = (0, import_node_crypto6.createDecipheriv)("aes-256-gcm", encKey(), Buffer.from(ivB, "base64"));
+    decipher.setAuthTag(Buffer.from(tagB, "base64"));
+    return Buffer.concat([decipher.update(Buffer.from(dataB, "base64")), decipher.final()]).toString("utf8");
+  } catch {
+    return null;
+  }
+}
+async function memoryCall(toolName, args, userMemoryKey) {
+  try {
+    const res = await fetch(`${MEMORY_BASE_URL()}/api/mcp/memoryServer/tools/${toolName}/execute`, {
+      method: "POST",
+      headers: { "content-type": "application/json" },
+      body: JSON.stringify({ data: { ...args, apiKey: userMemoryKey } })
+    });
+    const body = await res.json().catch(() => null);
+    if (!res.ok) return { ok: false, error: body?.error ?? `memory ${toolName} failed (${res.status})` };
+    if (body?.result) return body.result;
+    return { ok: false, error: body?.error ?? `memory ${toolName} returned no result` };
+  } catch (err) {
+    return { ok: false, error: err?.message ?? "memory call failed" };
+  }
+}
+function personalVault(user) {
+  return `mcp-${user.id}`;
+}
+function memoryIdentity(user) {
+  return user.email;
+}
+function resolveMemoryIdentity(user) {
+  return memoryIdentity(user);
+}
+function memoryPlanForReads(user) {
+  if (isMemoryOperator(user.email)) return "unlimited";
+  if (user.memory_plan === "pro" || user.memory_plan === "team") return user.memory_plan;
+  return "free";
+}
+async function provisionMemoryForUser(user) {
+  try {
+    const { key } = await getOrCreateUserMemoryKey(user);
+    if (key) await setMemoryProvisioned(user.id, true);
+  } catch {
+  }
+}
+async function getOrCreateUserMemoryKey(user) {
+  const creds = await getUserMemoryCreds(user.id);
+  if (creds.memory_key) {
+    const decrypted = decryptMemoryKey(creds.memory_key);
+    if (decrypted) return { key: decrypted };
+  }
+  const admin = ADMIN_KEY();
+  if (!admin) return { key: null, error: "memory not configured (MCP_MEMORY_ADMIN_KEY missing)" };
+  const identity = memoryIdentity(user);
+  const plan = isMemoryOperator(user.email) ? "unlimited" : (await getMemoryPlan(user.id)).plan;
+  const provisioned = await memoryCall(
+    "provisionDefaultsTool",
+    { granteeIdentity: identity, issueKey: true, plan },
+    admin
+  );
+  if (!provisioned.ok || !provisioned.secret) {
+    return { key: null, error: provisioned.error ?? "failed to provision default vaults" };
+  }
+  await setUserMemoryCreds(user.id, encryptMemoryKey(provisioned.secret), identity);
+  return { key: provisioned.secret };
+}
+async function syncMemoryKeyPlan(user, plan) {
+  const effectivePlan = isMemoryOperator(user.email) ? "unlimited" : plan;
+  const { key, error } = await getOrCreateUserMemoryKey(user);
+  if (!key) return { ok: false, error: error ?? "memory unavailable" };
+  const listed = await memoryCall(
+    "listKeysTool",
+    {},
+    key
+  );
+  if (!listed.ok || !listed.keys?.length) return { ok: false, error: listed.error ?? "no memory keys found" };
+  const target = listed.keys[0];
+  if (target.plan === effectivePlan) return { ok: true };
+  const res = await memoryCall("setScopeTool", { keyId: target.keyId, plan: effectivePlan }, key);
+  return { ok: res.ok, error: res.error };
+}
+async function syncScheduleEntitlement(user, enabled, quotaPerPeriod) {
+  const admin = ADMIN_KEY();
+  if (!admin) return { ok: false, error: "memory not configured (MCP_MEMORY_ADMIN_KEY missing)" };
+  const identity = resolveMemoryIdentity(user);
+  const res = await memoryCall("setScheduleEntitlementTool", {
+    granteeIdentity: identity,
+    enabled,
+    quotaPerPeriod,
+    mcpScraperApiKey: user.api_key
+  }, admin);
+  return { ok: res.ok, error: res.error };
+}
+var import_node_crypto6, MEMORY_BASE_URL, ADMIN_KEY;
+var init_memory = __esm({
+  "src/api/memory.ts"() {
+    "use strict";
+    import_node_crypto6 = require("crypto");
+    init_session();
+    init_db();
+    MEMORY_BASE_URL = () => (process.env.MCP_MEMORY_BASE_URL ?? "https://mcp-memory-omega.vercel.app").replace(/\/$/, "");
+    ADMIN_KEY = () => process.env.MCP_MEMORY_ADMIN_KEY?.trim() ?? "";
+  }
+});
+
+// src/api/video-routes.ts
+function invalidRequest5(message) {
+  return { error_code: "invalid_request", message };
+}
+var import_hono9, import_zod20, videoApp, AnalyzeBodySchema;
+var init_video_routes = __esm({
+  "src/api/video-routes.ts"() {
+    "use strict";
+    import_hono9 = require("hono");
+    import_zod20 = require("zod");
+    init_db();
+    init_rates();
+    init_api_auth();
+    init_memory();
+    videoApp = new import_hono9.Hono();
+    AnalyzeBodySchema = import_zod20.z.object({
+      sourceUrl: import_zod20.z.string().trim().url("sourceUrl must be a direct video file URL"),
+      intervalS: import_zod20.z.number().min(1).max(30).optional(),
+      maxFrames: import_zod20.z.number().int().min(1).max(120).optional(),
+      detail: import_zod20.z.enum(["fast", "standard", "deep"]).optional(),
+      vault: import_zod20.z.string().trim().min(1).optional()
+    });
+    videoApp.post("/analyze", createApiKeyAuth(), async (c) => {
+      const parsed = AnalyzeBodySchema.safeParse(await c.req.json().catch(() => ({})));
+      if (!parsed.success) return c.json(invalidRequest5(parsed.error.issues[0]?.message ?? "invalid request"), 400);
+      const body = parsed.data;
+      const user = c.get("user");
+      const { key: memKey, error: memErr } = await getOrCreateUserMemoryKey(user);
+      if (!memKey) return c.json({ error_code: "memory_unavailable", message: memErr ?? "memory unavailable" }, 502);
+      const { ok, balance_mc } = await debitMc(user.id, MC_COSTS.video_analysis, LedgerOperation.VIDEO_ANALYSIS, body.sourceUrl);
+      if (!ok) return c.json(insufficientBalanceResponse(balance_mc, MC_COSTS.video_analysis), 402);
+      const started = await memoryCall(
+        "videoAnalyzeStartTool",
+        {
+          sourceUrl: body.sourceUrl,
+          intervalS: body.intervalS ?? 2,
+          maxFrames: body.maxFrames ?? 120,
+          detail: body.detail ?? "standard",
+          vault: body.vault ?? "Library"
+        },
+        memKey
+      );
+      if (!started.ok || !started.runId) {
+        await creditMc(user.id, MC_COSTS.video_analysis, LedgerOperation.VIDEO_ANALYSIS_REFUND, `start-failed:${body.sourceUrl}`);
+        return c.json({ error_code: "video_start_failed", message: started.error ?? "could not start analysis" }, 502);
+      }
+      return c.json({
+        ok: true,
+        runId: started.runId,
+        status: "queued",
+        message: 'Analysis started. Poll GET /video/status?runId=... every few seconds until status is "done".'
+      });
+    });
+    videoApp.post("/status", createApiKeyAuth(), async (c) => {
+      const rawBody = await c.req.json().catch(() => ({}));
+      const runId = rawBody.runId?.trim();
+      if (!runId) return c.json(invalidRequest5("runId is required"), 400);
+      const user = c.get("user");
+      const { key: memKey, error: memErr } = await getOrCreateUserMemoryKey(user);
+      if (!memKey) return c.json({ error_code: "memory_unavailable", message: memErr ?? "memory unavailable" }, 502);
+      const st = await memoryCall("videoAnalyzeStatusTool", { runId }, memKey);
+      if (!st.ok) return c.json({ error_code: "not_found", message: st.error ?? "run not found" }, 404);
+      if (st.status === "failed") {
+        const refundOp = `${LedgerOperation.VIDEO_ANALYSIS_REFUND}:${runId}`;
+        if (!await ledgerExistsForOperation(user.id, refundOp)) {
+          await creditMc(user.id, MC_COSTS.video_analysis, refundOp, `run-failed:${runId}`);
+        }
+      }
+      return c.json({
+        ok: true,
+        runId,
+        status: st.status ?? "unknown",
+        progress: st.progress ?? null,
+        frameCount: st.frameCount ?? null,
+        ...st.status === "done" ? { artifactPath: st.artifactPath ?? null, report: st.report ?? null } : {},
+        ...st.error ? { error: st.error } : {}
+      });
+    });
+  }
+});
+
 // src/extractor/MapsNavigator.ts
 var MapsNavigator;
 var init_MapsNavigator = __esm({
@@ -16602,7 +16899,7 @@ var init_MapsReviewCollector = __esm({
 });
 
 // src/extractor/MapsExtractor.ts
-var import_zod20, MapsExtractor;
+var import_zod21, MapsExtractor;
 var init_MapsExtractor = __esm({
   "src/extractor/MapsExtractor.ts"() {
     "use strict";
@@ -16610,7 +16907,7 @@ var init_MapsExtractor = __esm({
     init_selectors();
     init_MapsNavigator();
     init_MapsReviewCollector();
-    import_zod20 = require("zod");
+    import_zod21 = require("zod");
     MapsExtractor = class {
       constructor(driver) {
         this.driver = driver;
@@ -16796,7 +17093,7 @@ var init_MapsExtractor = __esm({
           });
           return rows;
         }, { hoursTable: MapsSelectors.hoursTable, hoursTableAlt: MapsSelectors.hoursTableAlt });
-        const result = import_zod20.z.array(RawMapsHoursRowSchema).safeParse(raw);
+        const result = import_zod21.z.array(RawMapsHoursRowSchema).safeParse(raw);
         if (!result.success) {
           console.warn("[MapsExtractor] hours parse failed", result.error.flatten());
           return [];
@@ -16860,7 +17157,7 @@ var init_MapsExtractor = __esm({
           });
           return results;
         });
-        const result = import_zod20.z.array(RawMapsAboutAttributeSchema).safeParse(raw);
+        const result = import_zod21.z.array(RawMapsAboutAttributeSchema).safeParse(raw);
         if (!result.success) {
           console.warn("[MapsExtractor] about parse failed", result.error.flatten());
           return [];
@@ -17256,11 +17553,11 @@ function mapsErrorResponse(c, err, errorCode) {
     attempts: rotationError?.attempts ?? void 0
   }, retryable ? 503 : 500);
 }
-var import_hono8, mapsApp;
+var import_hono10, mapsApp;
 var init_maps_routes = __esm({
   "src/api/maps-routes.ts"() {
     "use strict";
-    import_hono8 = require("hono");
+    import_hono10 = require("hono");
     init_db();
     init_rates();
     init_MapsExtractor();
@@ -17271,7 +17568,7 @@ var init_maps_routes = __esm({
     init_browser_service_env();
     init_maps_search_rotation();
     init_concurrency_gates();
-    mapsApp = new import_hono8.Hono();
+    mapsApp = new import_hono10.Hono();
     mapsApp.post("/search", createApiKeyAuth(), async (c) => {
       const user = c.get("user");
       const body = await c.req.json().catch(() => ({}));
@@ -20081,47 +20378,47 @@ async function runDirectoryWorkflowFromPlan(options, plan) {
   const csvPath = options.saveCsv ? await saveDirectoryCsv(base) : null;
   return { ...base, csvPath };
 }
-var import_promises6, import_node_path8, import_zod21, DirectoryWorkflowOptionsSchema;
+var import_promises6, import_node_path8, import_zod22, DirectoryWorkflowOptionsSchema;
 var init_directory_workflow = __esm({
   "src/directory/directory-workflow.ts"() {
     "use strict";
     import_promises6 = require("fs/promises");
     import_node_path8 = require("path");
-    import_zod21 = require("zod");
+    import_zod22 = require("zod");
     init_mcp_response_formatter();
     init_browser_service_env();
     init_maps_search_rotation();
     init_schemas3();
     init_csv();
     init_location_db();
-    DirectoryWorkflowOptionsSchema = 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),
-      populationYear: import_zod21.z.union(POPULATION_YEARS.map((year) => import_zod21.z.literal(year))).default(2025),
-      maxCities: import_zod21.z.number().int().min(1).max(100).default(25),
-      maxResultsPerCity: import_zod21.z.number().int().min(1).max(50).default(50),
-      concurrency: import_zod21.z.number().int().min(1).max(5).default(5),
-      includeZipGroups: import_zod21.z.boolean().default(true),
-      usZipsCsvPath: import_zod21.z.string().optional(),
-      saveCsv: import_zod21.z.boolean().default(true),
-      gl: import_zod21.z.string().length(2).default("us"),
-      hl: import_zod21.z.string().length(2).default("en"),
-      proxyMode: import_zod21.z.enum(["location", "configured", "none"]).default(DEFAULT_MAPS_PROXY_MODE),
-      proxyZip: import_zod21.z.string().regex(/^\d{5}$/).optional(),
-      debug: import_zod21.z.boolean().default(false),
-      headless: import_zod21.z.boolean().default(true),
-      kernelApiKey: import_zod21.z.string().optional()
+    DirectoryWorkflowOptionsSchema = 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),
+      populationYear: import_zod22.z.union(POPULATION_YEARS.map((year) => import_zod22.z.literal(year))).default(2025),
+      maxCities: import_zod22.z.number().int().min(1).max(100).default(25),
+      maxResultsPerCity: import_zod22.z.number().int().min(1).max(50).default(50),
+      concurrency: import_zod22.z.number().int().min(1).max(5).default(5),
+      includeZipGroups: import_zod22.z.boolean().default(true),
+      usZipsCsvPath: import_zod22.z.string().optional(),
+      saveCsv: import_zod22.z.boolean().default(true),
+      gl: import_zod22.z.string().length(2).default("us"),
+      hl: import_zod22.z.string().length(2).default("en"),
+      proxyMode: import_zod22.z.enum(["location", "configured", "none"]).default(DEFAULT_MAPS_PROXY_MODE),
+      proxyZip: import_zod22.z.string().regex(/^\d{5}$/).optional(),
+      debug: import_zod22.z.boolean().default(false),
+      headless: import_zod22.z.boolean().default(true),
+      kernelApiKey: import_zod22.z.string().optional()
     });
   }
 });
 
 // src/api/directory-routes.ts
-var import_hono9, directoryApp;
+var import_hono11, directoryApp;
 var init_directory_routes = __esm({
   "src/api/directory-routes.ts"() {
     "use strict";
-    import_hono9 = require("hono");
+    import_hono11 = require("hono");
     init_api_auth();
     init_db();
     init_rates();
@@ -20129,7 +20426,7 @@ var init_directory_routes = __esm({
     init_location_db();
     init_browser_service_env();
     init_concurrency_gates();
-    directoryApp = new import_hono9.Hono();
+    directoryApp = new import_hono11.Hono();
     directoryApp.post("/run", createApiKeyAuth(), async (c) => {
       const user = c.get("user");
       const body = await c.req.json().catch(() => ({}));
@@ -20537,21 +20834,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_zod22, AgentPacketInputSchema, agentPacketWorkflowDefinition;
+var import_zod23, AgentPacketInputSchema, agentPacketWorkflowDefinition;
 var init_agent_packet = __esm({
   "src/workflows/workflows/agent-packet.ts"() {
     "use strict";
-    import_zod22 = require("zod");
+    import_zod23 = require("zod");
     init_report_renderer();
-    AgentPacketInputSchema = import_zod22.z.object({
-      keyword: import_zod22.z.string().min(1),
-      domain: import_zod22.z.string().optional(),
-      location: import_zod22.z.string().optional(),
-      maxQuestions: import_zod22.z.number().int().min(1).max(200).default(40),
-      includeSerp: import_zod22.z.boolean().default(true),
-      includePaa: import_zod22.z.boolean().default(true),
-      includeAiOverview: import_zod22.z.boolean().default(true),
-      returnPartial: import_zod22.z.boolean().default(true)
+    AgentPacketInputSchema = import_zod23.z.object({
+      keyword: import_zod23.z.string().min(1),
+      domain: import_zod23.z.string().optional(),
+      location: import_zod23.z.string().optional(),
+      maxQuestions: import_zod23.z.number().int().min(1).max(200).default(40),
+      includeSerp: import_zod23.z.boolean().default(true),
+      includePaa: import_zod23.z.boolean().default(true),
+      includeAiOverview: import_zod23.z.boolean().default(true),
+      returnPartial: import_zod23.z.boolean().default(true)
     });
     agentPacketWorkflowDefinition = {
       id: "agent-packet",
@@ -20749,22 +21046,22 @@ function directoryRows(result) {
   }
   return rows;
 }
-var import_zod23, DirectoryWorkflowCliInputSchema, DIRECTORY_CSV_HEADERS, directoryWorkflowDefinition;
+var import_zod24, DirectoryWorkflowCliInputSchema, DIRECTORY_CSV_HEADERS, directoryWorkflowDefinition;
 var init_directory = __esm({
   "src/workflows/workflows/directory.ts"() {
     "use strict";
-    import_zod23 = require("zod");
+    import_zod24 = require("zod");
     init_report_renderer();
     init_schemas3();
-    DirectoryWorkflowCliInputSchema = import_zod23.z.object({
-      query: import_zod23.z.string().min(1),
-      state: import_zod23.z.string().min(2).default("TN"),
-      minPopulation: import_zod23.z.number().int().min(0).default(1e5),
-      maxCities: import_zod23.z.number().int().min(1).max(100).default(25),
-      maxResultsPerCity: import_zod23.z.number().int().min(1).max(50).default(20),
-      concurrency: import_zod23.z.number().int().min(1).max(5).default(5),
-      proxyMode: import_zod23.z.enum(["location", "configured", "none"]).default(DEFAULT_MAPS_PROXY_MODE),
-      saveCsv: import_zod23.z.boolean().default(true)
+    DirectoryWorkflowCliInputSchema = import_zod24.z.object({
+      query: import_zod24.z.string().min(1),
+      state: import_zod24.z.string().min(2).default("TN"),
+      minPopulation: import_zod24.z.number().int().min(0).default(1e5),
+      maxCities: import_zod24.z.number().int().min(1).max(100).default(25),
+      maxResultsPerCity: import_zod24.z.number().int().min(1).max(50).default(20),
+      concurrency: import_zod24.z.number().int().min(1).max(5).default(5),
+      proxyMode: import_zod24.z.enum(["location", "configured", "none"]).default(DEFAULT_MAPS_PROXY_MODE),
+      saveCsv: import_zod24.z.boolean().default(true)
     });
     DIRECTORY_CSV_HEADERS = [
       "source_query",
@@ -20904,21 +21201,21 @@ function buildAttemptUrls(website) {
   }
   return [...urls].slice(0, 3);
 }
-var import_zod24, GetLeadsInputSchema, LEADS_CSV_HEADERS, EMAIL_RE, MAILTO_RE, SOCIAL_RE, EMAIL_BAD, EMAIL_PREFIX, SOCIAL_SKIP, getLeadsWorkflowDefinition;
+var import_zod25, GetLeadsInputSchema, LEADS_CSV_HEADERS, EMAIL_RE, MAILTO_RE, SOCIAL_RE, EMAIL_BAD, EMAIL_PREFIX, SOCIAL_SKIP, getLeadsWorkflowDefinition;
 var init_get_leads = __esm({
   "src/workflows/workflows/get-leads.ts"() {
     "use strict";
-    import_zod24 = require("zod");
+    import_zod25 = require("zod");
     init_report_renderer();
     init_schemas3();
-    GetLeadsInputSchema = import_zod24.z.object({
-      query: import_zod24.z.string().min(1).describe('Business category, niche, or keyword to search on Google Maps, e.g. "roofers", "med spas", "dentists". Do not include the city here.'),
-      location: import_zod24.z.string().min(1).describe('City / market to search, e.g. "Houston, TX" or "Austin, Texas".'),
-      maxResults: import_zod24.z.number().int().min(1).max(50).default(25).describe("How many Maps businesses to collect for the market. Maximum 50."),
-      enrichWebsites: import_zod24.z.boolean().default(true).describe("Visit each business website (home + contact pages) to harvest email and social links. Uses the proxy/browser-backed extractor so blocked sites still resolve."),
-      hydrateReviewCounts: import_zod24.z.boolean().default(true).describe("Deep-dive each profile to confirm the review count and booking URL that the Maps search list omits."),
-      concurrency: import_zod24.z.number().int().min(1).max(4).default(3).describe("How many businesses to enrich in parallel. Keep low to respect per-account concurrency limits."),
-      proxyMode: import_zod24.z.enum(["location", "configured", "none"]).default(DEFAULT_MAPS_PROXY_MODE).describe("Proxy targeting for the Maps search. location targets the market; none is for local debugging.")
+    GetLeadsInputSchema = import_zod25.z.object({
+      query: import_zod25.z.string().min(1).describe('Business category, niche, or keyword to search on Google Maps, e.g. "roofers", "med spas", "dentists". Do not include the city here.'),
+      location: import_zod25.z.string().min(1).describe('City / market to search, e.g. "Houston, TX" or "Austin, Texas".'),
+      maxResults: import_zod25.z.number().int().min(1).max(50).default(25).describe("How many Maps businesses to collect for the market. Maximum 50."),
+      enrichWebsites: import_zod25.z.boolean().default(true).describe("Visit each business website (home + contact pages) to harvest email and social links. Uses the proxy/browser-backed extractor so blocked sites still resolve."),
+      hydrateReviewCounts: import_zod25.z.boolean().default(true).describe("Deep-dive each profile to confirm the review count and booking URL that the Maps search list omits."),
+      concurrency: import_zod25.z.number().int().min(1).max(4).default(3).describe("How many businesses to enrich in parallel. Keep low to respect per-account concurrency limits."),
+      proxyMode: import_zod25.z.enum(["location", "configured", "none"]).default(DEFAULT_MAPS_PROXY_MODE).describe("Proxy targeting for the Maps search. location targets the market; none is for local debugging.")
     });
     LEADS_CSV_HEADERS = [
       "position",
@@ -21120,25 +21417,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_zod25, LocalCompetitiveAuditInputSchema, localCompetitiveAuditWorkflowDefinition;
+var import_zod26, LocalCompetitiveAuditInputSchema, localCompetitiveAuditWorkflowDefinition;
 var init_local_competitive_audit = __esm({
   "src/workflows/workflows/local-competitive-audit.ts"() {
     "use strict";
-    import_zod25 = require("zod");
+    import_zod26 = require("zod");
     init_report_renderer();
     init_directory();
     init_schemas3();
-    LocalCompetitiveAuditInputSchema = import_zod25.z.object({
-      query: import_zod25.z.string().min(1),
-      state: import_zod25.z.string().min(2).default("TN"),
-      minPopulation: import_zod25.z.number().int().min(0).default(1e5),
-      maxCities: import_zod25.z.number().int().min(1).max(100).default(25),
-      maxResultsPerCity: import_zod25.z.number().int().min(1).max(50).default(20),
-      hydrateTop: import_zod25.z.number().int().min(0).max(10).default(5),
-      maxReviews: import_zod25.z.number().int().min(0).max(500).default(50),
-      concurrency: import_zod25.z.number().int().min(1).max(5).default(5),
-      proxyMode: import_zod25.z.enum(["location", "configured", "none"]).default(DEFAULT_MAPS_PROXY_MODE),
-      returnPartial: import_zod25.z.boolean().default(true)
+    LocalCompetitiveAuditInputSchema = import_zod26.z.object({
+      query: import_zod26.z.string().min(1),
+      state: import_zod26.z.string().min(2).default("TN"),
+      minPopulation: import_zod26.z.number().int().min(0).default(1e5),
+      maxCities: import_zod26.z.number().int().min(1).max(100).default(25),
+      maxResultsPerCity: import_zod26.z.number().int().min(1).max(50).default(20),
+      hydrateTop: import_zod26.z.number().int().min(0).max(10).default(5),
+      maxReviews: import_zod26.z.number().int().min(0).max(500).default(50),
+      concurrency: import_zod26.z.number().int().min(1).max(5).default(5),
+      proxyMode: import_zod26.z.enum(["location", "configured", "none"]).default(DEFAULT_MAPS_PROXY_MODE),
+      returnPartial: import_zod26.z.boolean().default(true)
     });
     localCompetitiveAuditWorkflowDefinition = {
       id: "local-competitive-audit",
@@ -21581,58 +21878,58 @@ async function extractPages(ctx, sources, warnings, labelPrefix) {
     }
   }).then((items) => items.filter((item) => item !== null));
 }
-var import_zod26, ProxyModeSchema, MapComparisonInputSchema, SerpComparisonInputSchema, PaaExpansionBriefInputSchema, AiOverviewLanguageInputSchema, mapComparisonWorkflowDefinition, serpComparisonWorkflowDefinition, paaExpansionBriefWorkflowDefinition, aiOverviewLanguageWorkflowDefinition;
+var import_zod27, ProxyModeSchema, MapComparisonInputSchema, SerpComparisonInputSchema, PaaExpansionBriefInputSchema, AiOverviewLanguageInputSchema, mapComparisonWorkflowDefinition, serpComparisonWorkflowDefinition, paaExpansionBriefWorkflowDefinition, aiOverviewLanguageWorkflowDefinition;
 var init_comparison_briefs = __esm({
   "src/workflows/workflows/comparison-briefs.ts"() {
     "use strict";
-    import_zod26 = require("zod");
+    import_zod27 = require("zod");
     init_report_renderer();
     init_directory();
     init_seo_workflow_utils();
     init_schemas3();
-    ProxyModeSchema = import_zod26.z.enum(["location", "configured", "none"]);
-    MapComparisonInputSchema = import_zod26.z.object({
-      query: import_zod26.z.string().min(1),
-      location: import_zod26.z.string().optional(),
-      state: import_zod26.z.string().optional(),
-      minPopulation: import_zod26.z.number().int().min(0).default(1e5),
-      maxCities: import_zod26.z.number().int().min(1).max(100).default(5),
-      maxResultsPerCity: import_zod26.z.number().int().min(1).max(50).default(20),
-      hydrateTop: import_zod26.z.number().int().min(0).max(10).default(5),
-      maxReviews: import_zod26.z.number().int().min(0).max(500).default(25),
-      concurrency: import_zod26.z.number().int().min(1).max(5).default(5),
+    ProxyModeSchema = import_zod27.z.enum(["location", "configured", "none"]);
+    MapComparisonInputSchema = import_zod27.z.object({
+      query: import_zod27.z.string().min(1),
+      location: import_zod27.z.string().optional(),
+      state: import_zod27.z.string().optional(),
+      minPopulation: import_zod27.z.number().int().min(0).default(1e5),
+      maxCities: import_zod27.z.number().int().min(1).max(100).default(5),
+      maxResultsPerCity: import_zod27.z.number().int().min(1).max(50).default(20),
+      hydrateTop: import_zod27.z.number().int().min(0).max(10).default(5),
+      maxReviews: import_zod27.z.number().int().min(0).max(500).default(25),
+      concurrency: import_zod27.z.number().int().min(1).max(5).default(5),
       proxyMode: ProxyModeSchema.default(DEFAULT_MAPS_PROXY_MODE),
-      returnPartial: import_zod26.z.boolean().default(true)
+      returnPartial: import_zod27.z.boolean().default(true)
     }).refine((input) => input.location || input.state, {
       message: "Either location or state is required for map-comparison"
     });
-    SerpComparisonInputSchema = import_zod26.z.object({
-      keyword: import_zod26.z.string().min(1),
-      domain: import_zod26.z.string().optional(),
-      url: import_zod26.z.string().url().optional(),
-      location: import_zod26.z.string().optional(),
-      maxResults: import_zod26.z.number().int().min(1).max(20).default(10),
-      maxQuestions: import_zod26.z.number().int().min(1).max(200).default(40),
-      extractTop: import_zod26.z.number().int().min(0).max(10).default(5),
-      includePaa: import_zod26.z.boolean().default(true),
-      includeAiOverview: import_zod26.z.boolean().default(true),
-      returnPartial: import_zod26.z.boolean().default(true)
-    });
-    PaaExpansionBriefInputSchema = import_zod26.z.object({
-      keyword: import_zod26.z.string().min(1),
-      location: import_zod26.z.string().optional(),
-      maxQuestions: import_zod26.z.number().int().min(1).max(300).default(80),
-      depth: import_zod26.z.number().int().min(1).max(6).default(3),
-      returnPartial: import_zod26.z.boolean().default(true)
-    });
-    AiOverviewLanguageInputSchema = import_zod26.z.object({
-      keyword: import_zod26.z.string().min(1),
-      domain: import_zod26.z.string().optional(),
-      url: import_zod26.z.string().url().optional(),
-      location: import_zod26.z.string().optional(),
-      maxQuestions: import_zod26.z.number().int().min(1).max(200).default(40),
-      extractTop: import_zod26.z.number().int().min(0).max(8).default(3),
-      returnPartial: import_zod26.z.boolean().default(true)
+    SerpComparisonInputSchema = import_zod27.z.object({
+      keyword: import_zod27.z.string().min(1),
+      domain: import_zod27.z.string().optional(),
+      url: import_zod27.z.string().url().optional(),
+      location: import_zod27.z.string().optional(),
+      maxResults: import_zod27.z.number().int().min(1).max(20).default(10),
+      maxQuestions: import_zod27.z.number().int().min(1).max(200).default(40),
+      extractTop: import_zod27.z.number().int().min(0).max(10).default(5),
+      includePaa: import_zod27.z.boolean().default(true),
+      includeAiOverview: import_zod27.z.boolean().default(true),
+      returnPartial: import_zod27.z.boolean().default(true)
+    });
+    PaaExpansionBriefInputSchema = import_zod27.z.object({
+      keyword: import_zod27.z.string().min(1),
+      location: import_zod27.z.string().optional(),
+      maxQuestions: import_zod27.z.number().int().min(1).max(300).default(80),
+      depth: import_zod27.z.number().int().min(1).max(6).default(3),
+      returnPartial: import_zod27.z.boolean().default(true)
+    });
+    AiOverviewLanguageInputSchema = import_zod27.z.object({
+      keyword: import_zod27.z.string().min(1),
+      domain: import_zod27.z.string().optional(),
+      url: import_zod27.z.string().url().optional(),
+      location: import_zod27.z.string().optional(),
+      maxQuestions: import_zod27.z.number().int().min(1).max(200).default(40),
+      extractTop: import_zod27.z.number().int().min(0).max(8).default(3),
+      returnPartial: import_zod27.z.boolean().default(true)
     });
     mapComparisonWorkflowDefinition = {
       id: "map-comparison",
@@ -22102,12 +22399,12 @@ async function runWorkflowStep(id, rawInput, opts) {
     artifacts: writtenArtifacts
   };
 }
-var import_promises8, import_zod27, DEFINITIONS;
+var import_promises8, import_zod28, DEFINITIONS;
 var init_registry2 = __esm({
   "src/workflows/registry.ts"() {
     "use strict";
     import_promises8 = require("fs/promises");
-    import_zod27 = require("zod");
+    import_zod28 = require("zod");
     init_artifact_writer();
     init_http_client2();
     init_agent_packet();
@@ -22185,7 +22482,7 @@ async function readManifestFromSummary(summary) {
 function webhookSignature(body, timestamp2) {
   const secret2 = process.env.MCP_SCRAPER_WEBHOOK_SECRET?.trim();
   if (!secret2) return null;
-  return (0, import_node_crypto5.createHmac)("sha256", secret2).update(`${timestamp2}.${body}`).digest("hex");
+  return (0, import_node_crypto7.createHmac)("sha256", secret2).update(`${timestamp2}.${body}`).digest("hex");
 }
 async function deliverWorkflowWebhook(input) {
   if (!input.webhookUrl) return;
@@ -22392,47 +22689,47 @@ async function dispatchDueWorkflowSchedules(apiUrl, limit = 3) {
   }
   return { dispatched: results.length, results };
 }
-var import_node_crypto5, import_promises9, import_hono10, import_zod28, workflowApp, WorkflowInputSchema, WorkflowIdSchema, CadenceSchema, ScheduleStatusSchema, RunBodySchema, ScheduleCreateSchema, SchedulePatchSchema, TERMINAL_RUN_STATUSES;
+var import_node_crypto7, import_promises9, import_hono12, import_zod29, 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_crypto5 = require("crypto");
+    import_node_crypto7 = require("crypto");
     import_promises9 = require("fs/promises");
-    import_hono10 = require("hono");
-    import_zod28 = require("zod");
-    init_artifact_writer();
+    import_hono12 = require("hono");
+    import_zod29 = require("zod");
+    init_artifact_writer();
     init_registry2();
     init_api_auth();
     init_db();
     init_url_utils();
     init_concurrency_gates();
-    workflowApp = new import_hono10.Hono();
-    WorkflowInputSchema = import_zod28.z.record(import_zod28.z.unknown()).default({});
-    WorkflowIdSchema = import_zod28.z.string().min(1);
-    CadenceSchema = import_zod28.z.enum(["daily", "weekly", "monthly"]);
-    ScheduleStatusSchema = import_zod28.z.enum(["active", "paused"]);
-    RunBodySchema = import_zod28.z.object({
+    workflowApp = new import_hono12.Hono();
+    WorkflowInputSchema = import_zod29.z.record(import_zod29.z.unknown()).default({});
+    WorkflowIdSchema = import_zod29.z.string().min(1);
+    CadenceSchema = import_zod29.z.enum(["daily", "weekly", "monthly"]);
+    ScheduleStatusSchema = import_zod29.z.enum(["active", "paused"]);
+    RunBodySchema = import_zod29.z.object({
       workflowId: WorkflowIdSchema,
       input: WorkflowInputSchema,
-      webhookUrl: import_zod28.z.string().url().optional()
+      webhookUrl: import_zod29.z.string().url().optional()
     });
-    ScheduleCreateSchema = import_zod28.z.object({
+    ScheduleCreateSchema = import_zod29.z.object({
       workflowId: WorkflowIdSchema,
-      name: import_zod28.z.string().min(1).max(120).optional(),
+      name: import_zod29.z.string().min(1).max(120).optional(),
       input: WorkflowInputSchema,
       cadence: CadenceSchema.default("weekly"),
-      timezone: import_zod28.z.string().min(1).max(64).default("UTC"),
-      webhookUrl: import_zod28.z.string().url().optional(),
-      nextRunAt: import_zod28.z.string().datetime().optional()
+      timezone: import_zod29.z.string().min(1).max(64).default("UTC"),
+      webhookUrl: import_zod29.z.string().url().optional(),
+      nextRunAt: import_zod29.z.string().datetime().optional()
     });
-    SchedulePatchSchema = import_zod28.z.object({
-      name: import_zod28.z.string().min(1).max(120).optional(),
+    SchedulePatchSchema = import_zod29.z.object({
+      name: import_zod29.z.string().min(1).max(120).optional(),
       status: ScheduleStatusSchema.optional(),
       input: WorkflowInputSchema.optional(),
       cadence: CadenceSchema.optional(),
-      timezone: import_zod28.z.string().min(1).max(64).optional(),
-      webhookUrl: import_zod28.z.string().url().nullable().optional(),
-      nextRunAt: import_zod28.z.string().datetime().nullable().optional()
+      timezone: import_zod29.z.string().min(1).max(64).optional(),
+      webhookUrl: import_zod29.z.string().url().nullable().optional(),
+      nextRunAt: import_zod29.z.string().datetime().nullable().optional()
     });
     workflowApp.get("/definitions", createApiKeyAuth(), (c) => {
       return c.json({ workflows: listWorkflowDefinitions() });
@@ -22677,7 +22974,7 @@ var init_workflow_routes = __esm({
 // src/serp-intelligence/page-snapshot-extractor.ts
 function sha256(value) {
   if (!value) return null;
-  return (0, import_node_crypto6.createHash)("sha256").update(value).digest("hex");
+  return (0, import_node_crypto8.createHash)("sha256").update(value).digest("hex");
 }
 function countWords(markdown) {
   const matches = markdown.trim().match(/\b[\p{L}\p{N}][\p{L}\p{N}'-]*\b/gu);
@@ -22977,11 +23274,11 @@ async function capturePageSnapshots(targets, options = {}) {
     }
   };
 }
-var import_node_crypto6, import_p_limit3, DEFAULT_TIMEOUT_MS, DEFAULT_MAX_CONCURRENCY, DEFAULT_MAX_CONTENT_CHARS;
+var import_node_crypto8, import_p_limit3, DEFAULT_TIMEOUT_MS, DEFAULT_MAX_CONCURRENCY, DEFAULT_MAX_CONTENT_CHARS;
 var init_page_snapshot_extractor = __esm({
   "src/serp-intelligence/page-snapshot-extractor.ts"() {
     "use strict";
-    import_node_crypto6 = require("crypto");
+    import_node_crypto8 = require("crypto");
     import_p_limit3 = __toESM(require("p-limit"), 1);
     init_kpo_extractor();
     init_url_utils();
@@ -24981,11 +25278,11 @@ function isPublicHttpUrl(value) {
     return false;
   }
 }
-var import_zod29, SerpIntelligenceDeviceValues, SerpIntelligenceProxyModeValues, SerpIntelligenceAttemptOutcomeValues, SerpIntelligenceLocalizationStatusValues, SerpPageSnapshotSourceKindValues, SerpPageFetchStatusValues, SerpPageFetchedViaValues, HostnameSuffixPattern, Ipv4Pattern, SerpIntelligencePublicHttpUrlSchema, SerpIntelligenceCaptureBodySchema, SerpIntelligencePageSnapshotRequestSchema, SerpIntelligencePageSnapshotsBodySchema, SerpIntelligenceAICitationSchema, SerpIntelligenceOrganicResultSchema, SerpIntelligenceLocationEvidenceSchema, SerpIntelligenceHarvestResultSchema, SerpIntelligenceCaptureAttemptSchema, SerpPageSnapshotCaptureSchema, SerpIntelligenceCaptureResponseSchema, SerpIntelligencePageSnapshotsResponseSchema;
+var import_zod30, 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_zod29 = require("zod");
+    import_zod30 = require("zod");
     init_schemas3();
     SerpIntelligenceDeviceValues = ["desktop", "mobile"];
     SerpIntelligenceProxyModeValues = ["location", "configured", "none"];
@@ -25020,171 +25317,171 @@ var init_schemas4 = __esm({
     SerpPageFetchedViaValues = ["fetch", "headless", "browser", "mcp"];
     HostnameSuffixPattern = /(^|\.)localhost$/i;
     Ipv4Pattern = /^\d{1,3}(?:\.\d{1,3}){3}$/;
-    SerpIntelligencePublicHttpUrlSchema = import_zod29.z.string().url().refine(isPublicHttpUrl, "url must be a public HTTP or HTTPS URL");
-    SerpIntelligenceCaptureBodySchema = import_zod29.z.object({
-      query: import_zod29.z.string().trim().min(1, "query is required"),
-      location: import_zod29.z.string().trim().min(1).optional(),
-      gl: import_zod29.z.string().trim().length(2).default("us"),
-      hl: import_zod29.z.string().trim().length(2).default("en"),
-      device: import_zod29.z.enum(SerpIntelligenceDeviceValues).default("desktop"),
-      proxyMode: import_zod29.z.enum(SerpIntelligenceProxyModeValues).default(DEFAULT_PROXY_MODE),
-      proxyZip: import_zod29.z.string().regex(/^\d{5}$/).optional(),
-      pages: import_zod29.z.number().int().min(1).max(2).default(1),
-      debug: import_zod29.z.boolean().default(false),
-      includePageSnapshots: import_zod29.z.boolean().default(false),
-      pageSnapshotLimit: import_zod29.z.number().int().min(0).max(10).default(0)
+    SerpIntelligencePublicHttpUrlSchema = import_zod30.z.string().url().refine(isPublicHttpUrl, "url must be a public HTTP or HTTPS URL");
+    SerpIntelligenceCaptureBodySchema = import_zod30.z.object({
+      query: import_zod30.z.string().trim().min(1, "query is required"),
+      location: import_zod30.z.string().trim().min(1).optional(),
+      gl: import_zod30.z.string().trim().length(2).default("us"),
+      hl: import_zod30.z.string().trim().length(2).default("en"),
+      device: import_zod30.z.enum(SerpIntelligenceDeviceValues).default("desktop"),
+      proxyMode: import_zod30.z.enum(SerpIntelligenceProxyModeValues).default(DEFAULT_PROXY_MODE),
+      proxyZip: import_zod30.z.string().regex(/^\d{5}$/).optional(),
+      pages: import_zod30.z.number().int().min(1).max(2).default(1),
+      debug: import_zod30.z.boolean().default(false),
+      includePageSnapshots: import_zod30.z.boolean().default(false),
+      pageSnapshotLimit: import_zod30.z.number().int().min(0).max(10).default(0)
     }).strict();
-    SerpIntelligencePageSnapshotRequestSchema = import_zod29.z.object({
+    SerpIntelligencePageSnapshotRequestSchema = import_zod30.z.object({
       url: SerpIntelligencePublicHttpUrlSchema,
-      sourceKind: import_zod29.z.enum(SerpPageSnapshotSourceKindValues).default("configured_target"),
-      sourcePosition: import_zod29.z.number().int().min(1).optional()
+      sourceKind: import_zod30.z.enum(SerpPageSnapshotSourceKindValues).default("configured_target"),
+      sourcePosition: import_zod30.z.number().int().min(1).optional()
     }).strict();
-    SerpIntelligencePageSnapshotsBodySchema = import_zod29.z.object({
-      urls: import_zod29.z.array(SerpIntelligencePublicHttpUrlSchema).min(1).max(25),
-      targets: import_zod29.z.array(SerpIntelligencePageSnapshotRequestSchema).min(1).max(25).optional(),
-      maxConcurrency: import_zod29.z.number().int().min(1).max(5).default(2),
-      timeoutMs: import_zod29.z.number().int().min(1e3).max(6e4).default(15e3),
-      debug: import_zod29.z.boolean().default(false)
+    SerpIntelligencePageSnapshotsBodySchema = import_zod30.z.object({
+      urls: import_zod30.z.array(SerpIntelligencePublicHttpUrlSchema).min(1).max(25),
+      targets: import_zod30.z.array(SerpIntelligencePageSnapshotRequestSchema).min(1).max(25).optional(),
+      maxConcurrency: import_zod30.z.number().int().min(1).max(5).default(2),
+      timeoutMs: import_zod30.z.number().int().min(1e3).max(6e4).default(15e3),
+      debug: import_zod30.z.boolean().default(false)
     }).strict();
-    SerpIntelligenceAICitationSchema = import_zod29.z.object({
-      text: import_zod29.z.string(),
-      href: import_zod29.z.string()
+    SerpIntelligenceAICitationSchema = import_zod30.z.object({
+      text: import_zod30.z.string(),
+      href: import_zod30.z.string()
     }).strict();
-    SerpIntelligenceOrganicResultSchema = import_zod29.z.object({
-      position: import_zod29.z.number().int().min(1),
-      title: import_zod29.z.string(),
-      url: import_zod29.z.string(),
-      domain: import_zod29.z.string(),
-      cite: import_zod29.z.string().nullable(),
-      snippet: import_zod29.z.string().nullable(),
-      isRedditStyle: import_zod29.z.boolean(),
-      inlineRating: import_zod29.z.object({
-        value: import_zod29.z.string(),
-        count: import_zod29.z.string()
+    SerpIntelligenceOrganicResultSchema = import_zod30.z.object({
+      position: import_zod30.z.number().int().min(1),
+      title: import_zod30.z.string(),
+      url: import_zod30.z.string(),
+      domain: import_zod30.z.string(),
+      cite: import_zod30.z.string().nullable(),
+      snippet: import_zod30.z.string().nullable(),
+      isRedditStyle: import_zod30.z.boolean(),
+      inlineRating: import_zod30.z.object({
+        value: import_zod30.z.string(),
+        count: import_zod30.z.string()
       }).strict().nullable()
     }).strict();
-    SerpIntelligenceLocationEvidenceSchema = import_zod29.z.object({
-      status: import_zod29.z.enum(SerpIntelligenceLocalizationStatusValues),
-      expected: import_zod29.z.object({
-        city: import_zod29.z.string(),
-        regionCode: import_zod29.z.string().nullable(),
-        canonicalLocation: import_zod29.z.string()
+    SerpIntelligenceLocationEvidenceSchema = import_zod30.z.object({
+      status: import_zod30.z.enum(SerpIntelligenceLocalizationStatusValues),
+      expected: import_zod30.z.object({
+        city: import_zod30.z.string(),
+        regionCode: import_zod30.z.string().nullable(),
+        canonicalLocation: import_zod30.z.string()
       }).strict().nullable(),
-      candidates: import_zod29.z.array(import_zod29.z.object({
-        city: import_zod29.z.string(),
-        regionCode: import_zod29.z.string(),
-        count: import_zod29.z.number().int().min(0),
-        examples: import_zod29.z.array(import_zod29.z.string())
+      candidates: import_zod30.z.array(import_zod30.z.object({
+        city: import_zod30.z.string(),
+        regionCode: import_zod30.z.string(),
+        count: import_zod30.z.number().int().min(0),
+        examples: import_zod30.z.array(import_zod30.z.string())
       }).strict())
     }).strict();
-    SerpIntelligenceHarvestResultSchema = import_zod29.z.object({
-      seed: import_zod29.z.string(),
-      location: import_zod29.z.string().nullable(),
-      extractedAt: import_zod29.z.string(),
-      totalQuestions: import_zod29.z.number().int().min(0),
-      surface: import_zod29.z.enum(["web", "aim", "unknown"]),
-      aiOverview: import_zod29.z.object({
-        detected: import_zod29.z.boolean(),
-        text: import_zod29.z.string().nullable(),
-        citations: import_zod29.z.array(SerpIntelligenceAICitationSchema),
-        expanded: import_zod29.z.boolean().optional(),
-        fullyExpanded: import_zod29.z.boolean().optional(),
-        sections: import_zod29.z.array(import_zod29.z.string()).optional()
+    SerpIntelligenceHarvestResultSchema = import_zod30.z.object({
+      seed: import_zod30.z.string(),
+      location: import_zod30.z.string().nullable(),
+      extractedAt: import_zod30.z.string(),
+      totalQuestions: import_zod30.z.number().int().min(0),
+      surface: import_zod30.z.enum(["web", "aim", "unknown"]),
+      aiOverview: import_zod30.z.object({
+        detected: import_zod30.z.boolean(),
+        text: import_zod30.z.string().nullable(),
+        citations: import_zod30.z.array(SerpIntelligenceAICitationSchema),
+        expanded: import_zod30.z.boolean().optional(),
+        fullyExpanded: import_zod30.z.boolean().optional(),
+        sections: import_zod30.z.array(import_zod30.z.string()).optional()
       }).strict(),
-      aiMode: import_zod29.z.object({
-        detected: import_zod29.z.boolean(),
-        text: import_zod29.z.string().nullable(),
-        citations: import_zod29.z.array(SerpIntelligenceAICitationSchema)
+      aiMode: import_zod30.z.object({
+        detected: import_zod30.z.boolean(),
+        text: import_zod30.z.string().nullable(),
+        citations: import_zod30.z.array(SerpIntelligenceAICitationSchema)
       }).strict(),
-      tree: import_zod29.z.array(import_zod29.z.unknown()),
-      flat: import_zod29.z.array(import_zod29.z.unknown()),
-      videos: import_zod29.z.array(import_zod29.z.unknown()),
-      forums: import_zod29.z.array(import_zod29.z.unknown()),
-      organicResults: import_zod29.z.array(SerpIntelligenceOrganicResultSchema),
-      localPack: import_zod29.z.array(import_zod29.z.unknown()),
-      entityIds: import_zod29.z.object({
-        entities: import_zod29.z.array(import_zod29.z.object({
-          name: import_zod29.z.string(),
-          kgId: import_zod29.z.string().nullable(),
-          cid: import_zod29.z.string().nullable(),
-          gcid: import_zod29.z.string().nullable()
+      tree: import_zod30.z.array(import_zod30.z.unknown()),
+      flat: import_zod30.z.array(import_zod30.z.unknown()),
+      videos: import_zod30.z.array(import_zod30.z.unknown()),
+      forums: import_zod30.z.array(import_zod30.z.unknown()),
+      organicResults: import_zod30.z.array(SerpIntelligenceOrganicResultSchema),
+      localPack: import_zod30.z.array(import_zod30.z.unknown()),
+      entityIds: import_zod30.z.object({
+        entities: import_zod30.z.array(import_zod30.z.object({
+          name: import_zod30.z.string(),
+          kgId: import_zod30.z.string().nullable(),
+          cid: import_zod30.z.string().nullable(),
+          gcid: import_zod30.z.string().nullable()
         }).strict()),
-        kgIds: import_zod29.z.array(import_zod29.z.string()),
-        cids: import_zod29.z.array(import_zod29.z.string()),
-        gcids: import_zod29.z.array(import_zod29.z.string())
+        kgIds: import_zod30.z.array(import_zod30.z.string()),
+        cids: import_zod30.z.array(import_zod30.z.string()),
+        gcids: import_zod30.z.array(import_zod30.z.string())
       }).strict(),
-      stats: import_zod29.z.object({
-        seed: import_zod29.z.string(),
-        totalQuestions: import_zod29.z.number().int().min(0),
-        maxDepthReached: import_zod29.z.number().int().min(0),
-        durationMs: import_zod29.z.number().min(0),
-        errorCount: import_zod29.z.number().int().min(0)
+      stats: import_zod30.z.object({
+        seed: import_zod30.z.string(),
+        totalQuestions: import_zod30.z.number().int().min(0),
+        maxDepthReached: import_zod30.z.number().int().min(0),
+        durationMs: import_zod30.z.number().min(0),
+        errorCount: import_zod30.z.number().int().min(0)
       }).strict(),
-      diagnostics: import_zod29.z.object({
-        completionStatus: import_zod29.z.enum(["paa_found", "no_paa", "serp_only"]),
-        problem: import_zod29.z.null(),
-        warnings: import_zod29.z.array(import_zod29.z.unknown()).optional(),
-        debug: import_zod29.z.object({
+      diagnostics: import_zod30.z.object({
+        completionStatus: import_zod30.z.enum(["paa_found", "no_paa", "serp_only"]),
+        problem: import_zod30.z.null(),
+        warnings: import_zod30.z.array(import_zod30.z.unknown()).optional(),
+        debug: import_zod30.z.object({
           locationEvidence: SerpIntelligenceLocationEvidenceSchema.optional()
         }).passthrough().optional()
       }).passthrough(),
-      whatPeopleSaying: import_zod29.z.array(import_zod29.z.unknown())
+      whatPeopleSaying: import_zod30.z.array(import_zod30.z.unknown())
     }).strict();
-    SerpIntelligenceCaptureAttemptSchema = import_zod29.z.object({
-      attemptNumber: import_zod29.z.number().int().min(1),
-      outcome: import_zod29.z.enum(SerpIntelligenceAttemptOutcomeValues),
-      startedAt: import_zod29.z.string().optional(),
-      completedAt: import_zod29.z.string().optional(),
-      durationMs: import_zod29.z.number().min(0).optional(),
-      problemCode: import_zod29.z.string().optional(),
-      message: import_zod29.z.string().optional(),
-      kernelSessionId: import_zod29.z.string().nullable().optional(),
-      cleanupSucceeded: import_zod29.z.boolean().nullable().optional()
+    SerpIntelligenceCaptureAttemptSchema = import_zod30.z.object({
+      attemptNumber: import_zod30.z.number().int().min(1),
+      outcome: import_zod30.z.enum(SerpIntelligenceAttemptOutcomeValues),
+      startedAt: import_zod30.z.string().optional(),
+      completedAt: import_zod30.z.string().optional(),
+      durationMs: import_zod30.z.number().min(0).optional(),
+      problemCode: import_zod30.z.string().optional(),
+      message: import_zod30.z.string().optional(),
+      kernelSessionId: import_zod30.z.string().nullable().optional(),
+      cleanupSucceeded: import_zod30.z.boolean().nullable().optional()
     }).strict();
-    SerpPageSnapshotCaptureSchema = import_zod29.z.object({
+    SerpPageSnapshotCaptureSchema = import_zod30.z.object({
       url: SerpIntelligencePublicHttpUrlSchema,
       requestedUrl: SerpIntelligencePublicHttpUrlSchema,
       finalUrl: SerpIntelligencePublicHttpUrlSchema.nullable(),
-      sourceKind: import_zod29.z.enum(SerpPageSnapshotSourceKindValues),
-      sourcePosition: import_zod29.z.number().int().min(1).nullable(),
-      status: import_zod29.z.enum(SerpPageFetchStatusValues),
-      fetchedVia: import_zod29.z.enum(SerpPageFetchedViaValues).nullable(),
-      httpStatus: import_zod29.z.number().int().min(100).max(599).nullable(),
-      contentType: import_zod29.z.string().nullable(),
-      title: import_zod29.z.string().nullable(),
+      sourceKind: import_zod30.z.enum(SerpPageSnapshotSourceKindValues),
+      sourcePosition: import_zod30.z.number().int().min(1).nullable(),
+      status: import_zod30.z.enum(SerpPageFetchStatusValues),
+      fetchedVia: import_zod30.z.enum(SerpPageFetchedViaValues).nullable(),
+      httpStatus: import_zod30.z.number().int().min(100).max(599).nullable(),
+      contentType: import_zod30.z.string().nullable(),
+      title: import_zod30.z.string().nullable(),
       canonicalUrl: SerpIntelligencePublicHttpUrlSchema.nullable(),
-      metaDescription: import_zod29.z.string().nullable(),
-      headings: import_zod29.z.array(import_zod29.z.object({
-        level: import_zod29.z.number().int().min(1).max(6),
-        text: import_zod29.z.string()
+      metaDescription: import_zod30.z.string().nullable(),
+      headings: import_zod30.z.array(import_zod30.z.object({
+        level: import_zod30.z.number().int().min(1).max(6),
+        text: import_zod30.z.string()
       }).strict()).default([]),
-      artifact: import_zod29.z.object({
-        htmlBlobUrl: import_zod29.z.string().url().nullable(),
-        textBlobUrl: import_zod29.z.string().url().nullable(),
-        markdownBlobUrl: import_zod29.z.string().url().nullable(),
-        screenshotBlobUrl: import_zod29.z.string().url().nullable(),
-        contentSha256: import_zod29.z.string().nullable(),
-        capturedAt: import_zod29.z.string().nullable()
+      artifact: import_zod30.z.object({
+        htmlBlobUrl: import_zod30.z.string().url().nullable(),
+        textBlobUrl: import_zod30.z.string().url().nullable(),
+        markdownBlobUrl: import_zod30.z.string().url().nullable(),
+        screenshotBlobUrl: import_zod30.z.string().url().nullable(),
+        contentSha256: import_zod30.z.string().nullable(),
+        capturedAt: import_zod30.z.string().nullable()
       }).strict(),
-      error: import_zod29.z.object({
-        code: import_zod29.z.string(),
-        message: import_zod29.z.string()
+      error: import_zod30.z.object({
+        code: import_zod30.z.string(),
+        message: import_zod30.z.string()
       }).strict().nullable()
     }).strict();
-    SerpIntelligenceCaptureResponseSchema = import_zod29.z.object({
+    SerpIntelligenceCaptureResponseSchema = import_zod30.z.object({
       harvestResult: SerpIntelligenceHarvestResultSchema,
-      attempts: import_zod29.z.array(SerpIntelligenceCaptureAttemptSchema),
+      attempts: import_zod30.z.array(SerpIntelligenceCaptureAttemptSchema),
       locationEvidence: SerpIntelligenceLocationEvidenceSchema.nullable(),
-      pageSnapshotArtifacts: import_zod29.z.array(SerpPageSnapshotCaptureSchema),
-      billing: import_zod29.z.object({
-        creditsUsed: import_zod29.z.number().min(0).optional(),
-        requestId: import_zod29.z.string().optional(),
-        jobId: import_zod29.z.string().optional()
+      pageSnapshotArtifacts: import_zod30.z.array(SerpPageSnapshotCaptureSchema),
+      billing: import_zod30.z.object({
+        creditsUsed: import_zod30.z.number().min(0).optional(),
+        requestId: import_zod30.z.string().optional(),
+        jobId: import_zod30.z.string().optional()
       }).strict().optional()
     }).strict();
-    SerpIntelligencePageSnapshotsResponseSchema = import_zod29.z.object({
-      pageSnapshotArtifacts: import_zod29.z.array(SerpPageSnapshotCaptureSchema),
-      attempts: import_zod29.z.array(SerpIntelligenceCaptureAttemptSchema).default([])
+    SerpIntelligencePageSnapshotsResponseSchema = import_zod30.z.object({
+      pageSnapshotArtifacts: import_zod30.z.array(SerpPageSnapshotCaptureSchema),
+      attempts: import_zod30.z.array(SerpIntelligenceCaptureAttemptSchema).default([])
     }).strict();
   }
 });
@@ -25408,11 +25705,11 @@ function pageSnapshotTargetsFromBody(body) {
     sourcePosition: null
   }));
 }
-var import_hono11, SERP_INTELLIGENCE_RATE_LIMIT, SERP_INTELLIGENCE_RATE_WINDOW_SECONDS, POST_CAPTURE_ROUTE_LABEL, POST_PAGE_SNAPSHOTS_ROUTE_LABEL, serpIntelligenceApp;
+var import_hono13, 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_hono11 = require("hono");
+    import_hono13 = require("hono");
     init_browser_service_env();
     init_page_snapshot_extractor();
     init_serp_capture_service();
@@ -25425,7 +25722,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_hono11.Hono();
+    serpIntelligenceApp = new import_hono13.Hono();
     serpIntelligenceApp.use("*", createApiKeyAuth());
     serpIntelligenceApp.post("/capture", async (c) => {
       void POST_CAPTURE_ROUTE_LABEL;
@@ -25557,7 +25854,7 @@ var PACKAGE_VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    PACKAGE_VERSION = "0.3.42";
+    PACKAGE_VERSION = "0.3.45";
   }
 });
 
@@ -25633,6 +25930,19 @@ Multi-step orchestrations \u2014 prefer these over hand-chaining primitives when
 - Stand up a rank-tracking blueprint (database + cron + ingestion plan) -> **rank_tracker_workflow**.
 - Find which sources an AI answer cites for a query (AEO) -> **query_fanout_workflow** (open a browser
   session on chatgpt.com or claude.ai FIRST, then run it against that session).
+- Not sure which workflow fits a goal -> **workflow_suggest**; to just see what's available -> **workflow_list**.
+- Hosted/stepwise chain: **workflow_run** starts and returns \`runId\` (+ \`nextStep\` when multi-leg) ->
+  **workflow_step** with that \`runId\` advances one leg at a time until \`done\` -> **workflow_status**
+  re-opens a run to check state or recover artifact ids -> **workflow_artifact_read** pulls one artifact's
+  full content by \`runId\` + \`artifactId\`.
+- Browser replay recording: **browser_replay_start** begins it -> **browser_replay_mark** (while
+  recording) locates a DOM target and returns a ready-to-use timed annotation -> **browser_replay_stop**
+  ends it -> feed collected annotations to **browser_replay_annotate**, or just
+  **browser_replay_download** the plain MP4. **browser_list_replays** recovers replay ids.
+- Video breakdown is async: **video_frame_analysis** takes a DIRECT media file URL (resolve
+  YouTube/Facebook/Instagram page URLs to one first, e.g. via \`facebook_page_intel\`'s \`videoUrl\`) and
+  returns a \`runId\` immediately -> poll **video_frame_analysis_status** with that \`runId\` until \`status\`
+  is \`done\`.
 
 ## Notes
 - Bulk / full-site crawls: call \`extract_site\` with \`rotateProxies:true\` for blocked or rate-limited
@@ -25646,183 +25956,193 @@ Multi-step orchestrations \u2014 prefer these over hand-chaining primitives when
 });
 
 // src/mcp/mcp-tool-schemas.ts
-var import_zod30, HarvestPaaInputSchema, ExtractUrlInputSchema, MapSiteUrlsInputSchema, ExtractSiteInputSchema, AuditSiteInputSchema, YoutubeHarvestInputSchema, YoutubeTranscribeInputSchema, FacebookPageIntelInputSchema, FacebookAdSearchInputSchema, RedditThreadInputSchema, FacebookAdTranscribeInputSchema, FacebookVideoTranscribeInputSchema, GoogleAdsSearchInputSchema, GoogleAdsPageIntelInputSchema, GoogleAdsTranscribeInputSchema, InstagramProfileContentInputSchema, InstagramMediaDownloadInputSchema, MapsPlaceIntelInputSchema, MapsSearchInputSchema, DirectoryWorkflowInputSchema, RankTrackerModeSchema, RankTrackerBlueprintInputSchema, NullableString, MapsSearchAttemptOutput, MapsSearchOutputSchema, DirectoryMapsBusinessOutput, DirectoryWorkflowOutputSchema, RankTrackerToolPlanOutput, RankTrackerTableOutput, RankTrackerCronJobOutput, RankTrackerBlueprintOutputSchema, OrganicResultOutput, AiOverviewOutput, EntityIdsOutput, HarvestPaaOutputSchema, SearchSerpOutputSchema, ExtractUrlOutputSchema, ExtractSiteOutputSchema, AuditSiteOutputSchema, MapsPlaceIntelOutputSchema, CreditsInfoOutputSchema, MapSiteUrlsOutputSchema, YoutubeHarvestOutputSchema, FacebookAdSearchOutputSchema, RedditThreadOutputSchema, FacebookPageIntelOutputSchema, GoogleAdsSearchOutputSchema, GoogleAdsPageIntelOutputSchema, FacebookVideoTranscribeOutputSchema, TranscriptChunkOutput, InstagramBrowserOutput, InstagramPaginationOutput, InstagramProfileContentOutputSchema, InstagramMediaTrackOutput, InstagramDownloadOutput, InstagramMediaDownloadOutputSchema, YoutubeTranscribeOutputSchema, FacebookAdTranscribeOutputSchema, GoogleAdsTranscribeOutputSchema, 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_zod31, HarvestPaaInputSchema, ExtractUrlInputSchema, MapSiteUrlsInputSchema, ExtractSiteInputSchema, AuditSiteInputSchema, YoutubeHarvestInputSchema, YoutubeTranscribeInputSchema, FacebookPageIntelInputSchema, FacebookAdSearchInputSchema, RedditThreadInputSchema, VideoFrameAnalysisInputSchema, VideoFrameAnalysisStatusInputSchema, FacebookAdTranscribeInputSchema, FacebookVideoTranscribeInputSchema, GoogleAdsSearchInputSchema, GoogleAdsPageIntelInputSchema, GoogleAdsTranscribeInputSchema, InstagramProfileContentInputSchema, InstagramMediaDownloadInputSchema, MapsPlaceIntelInputSchema, MapsSearchInputSchema, DirectoryWorkflowInputSchema, RankTrackerModeSchema, RankTrackerBlueprintInputSchema, NullableString, MapsSearchAttemptOutput, MapsSearchOutputSchema, DirectoryMapsBusinessOutput, DirectoryWorkflowOutputSchema, RankTrackerToolPlanOutput, RankTrackerTableOutput, RankTrackerCronJobOutput, RankTrackerBlueprintOutputSchema, OrganicResultOutput, AiOverviewOutput, EntityIdsOutput, HarvestPaaOutputSchema, SearchSerpOutputSchema, ExtractUrlOutputSchema, ExtractSiteOutputSchema, AuditSiteOutputSchema, MapsPlaceIntelOutputSchema, CreditsInfoOutputSchema, MapSiteUrlsOutputSchema, YoutubeHarvestOutputSchema, FacebookAdSearchOutputSchema, VideoFrameAnalysisOutputSchema, VideoFrameAnalysisStatusOutputSchema, RedditThreadOutputSchema, FacebookPageIntelOutputSchema, GoogleAdsSearchOutputSchema, GoogleAdsPageIntelOutputSchema, FacebookVideoTranscribeOutputSchema, TranscriptChunkOutput, InstagramBrowserOutput, InstagramPaginationOutput, InstagramProfileContentOutputSchema, InstagramMediaTrackOutput, InstagramDownloadOutput, InstagramMediaDownloadOutputSchema, YoutubeTranscribeOutputSchema, FacebookAdTranscribeOutputSchema, GoogleAdsTranscribeOutputSchema, 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_zod30 = require("zod");
+    import_zod31 = require("zod");
     init_schemas3();
     HarvestPaaInputSchema = {
-      query: import_zod30.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_zod30.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_zod30.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_zod30.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_zod30.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_zod30.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_zod30.z.enum(["location", "configured", "none"]).default(DEFAULT_PROXY_MODE).describe('Leave unset \u2014 routing is automatic (clean egress by default; residential only when a location is given, with fallback). Set "location" only to force local-pack targeting.'),
-      proxyZip: import_zod30.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_zod30.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_zod31.z.string().min(1).describe('The search query. KEEP the place in the query text for localized results (e.g. "best hvac company Denver CO") and also set location \u2014 city-in-query is what localizes reliably.'),
+      location: import_zod31.z.string().optional().describe('City, region, or country for geo signals, e.g. "Denver, CO". Set alongside city-in-query wording; alone it does NOT reliably localize.'),
+      maxQuestions: import_zod31.z.number().int().min(1).max(200).default(30).describe("PAA questions to extract. Default 30, maximum 200. Use 10 for quick probes, 100-200 for deep research. Billed per extracted question; unused hold refunded."),
+      gl: import_zod31.z.string().length(2).default("us").describe("Google country code inferred from location or user language."),
+      hl: import_zod31.z.string().default("en").describe("Google interface/content language inferred from the user request."),
+      device: import_zod31.z.enum(["desktop", "mobile"]).default("desktop").describe("SERP device context. Use mobile only for mobile rankings."),
+      proxyMode: import_zod31.z.enum(["location", "configured", "none"]).default(DEFAULT_PROXY_MODE).describe('Leave unset (clean egress). Do NOT set "location" just because a city was named \u2014 that comes from city-in-query wording. "location" forces residential geo-IP for rank-tracking fidelity, is frequently CAPTCHA-blocked, and accepts failures.'),
+      proxyZip: import_zod31.z.string().regex(/^\d{5}$/).optional().describe('US ZIP for residential geo-IP targeting. Only meaningful with proxyMode "location".'),
+      debug: import_zod31.z.boolean().default(false).describe("Include sanitized diagnostics for debugging localization, CAPTCHA, or proxy behavior.")
     };
     ExtractUrlInputSchema = {
-      url: import_zod30.z.string().url().describe("Public http/https URL to extract. Use this when the user provides one specific page URL."),
-      screenshot: import_zod30.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_zod30.z.enum(["desktop", "mobile"]).default("desktop").describe("Viewport for screenshot. desktop = 1440\xD7900. mobile = 390\xD7844. Default desktop."),
-      extractBranding: import_zod30.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_zod30.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_zod30.z.array(import_zod30.z.enum(["image", "video", "audio"])).default(["image", "video", "audio"]).describe("Which media types to download. Default all three."),
-      allowLocal: import_zod30.z.boolean().default(false).describe("Allow localhost and private-network URLs. For local development only."),
-      depositToVault: import_zod30.z.boolean().default(false).describe("Also save the full page content into the user's MCP Memory Library vault, server-side. The complete body is stored and embedded for semantic recall WITHOUT passing through this conversation \u2014 the tool result only confirms the saved note. Use when the user asks to save/remember/store a page, or to build a knowledge base from scrapes."),
-      vaultName: import_zod30.z.string().trim().min(1).max(120).optional().describe("Optional vault to deposit into. Defaults to the user's personal vault.")
+      url: import_zod31.z.string().url().describe("Public http/https URL to extract."),
+      screenshot: import_zod31.z.boolean().default(false).describe("Capture a full-page screenshot, saved to ~/Downloads/mcp-scraper/screenshots/ and returned inline."),
+      screenshotDevice: import_zod31.z.enum(["desktop", "mobile"]).default("desktop").describe("Viewport for screenshot. desktop = 1440\xD7900, mobile = 390\xD7844."),
+      extractBranding: import_zod31.z.boolean().default(false).describe("Extract brand colors, fonts, logo, and favicon via a rendered browser session."),
+      downloadMedia: import_zod31.z.boolean().default(false).describe("Extract and download page media (images/video/audio) to ~/Downloads/mcp-scraper/media/. Ad/tracking noise is filtered automatically."),
+      mediaTypes: import_zod31.z.array(import_zod31.z.enum(["image", "video", "audio"])).default(["image", "video", "audio"]).describe("Which media types to download. Default all three."),
+      allowLocal: import_zod31.z.boolean().default(false).describe("Allow localhost and private-network URLs. Local development only."),
+      depositToVault: import_zod31.z.boolean().default(false).describe("Save the full page content into the user's MCP Memory vault server-side, embedded for semantic recall \u2014 the full body is NOT returned to chat."),
+      vaultName: import_zod31.z.string().trim().min(1).max(120).optional().describe("Optional vault to deposit into. Defaults to the user's personal vault.")
     };
     MapSiteUrlsInputSchema = {
-      url: import_zod30.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_zod30.z.number().int().min(1).max(1e4).optional().describe("Maximum URLs to discover. Use 100 for normal maps, up to 10000 for a full inventory. Large maps (over 500 URLs) write the complete inventory to a local file and return only a summary plus the file path instead of the full list inline.")
+      url: import_zod31.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_zod31.z.number().int().min(1).max(1e4).optional().describe("Maximum URLs to discover. Use 100 for normal maps, up to 10000 for a full inventory. Large maps (over 500 URLs) write the complete inventory to a local file and return only a summary plus the file path instead of the full list inline.")
     };
     ExtractSiteInputSchema = {
-      url: import_zod30.z.string().url().describe("Public website URL or domain to crawl for page CONTENT across multiple pages (map + scrape). Use when the user wants the content/text/markdown of a site's pages. For a technical SEO audit (issues, link graph, indexability, headings, image weights) use audit_site instead \u2014 extract_site returns content only, not analysis."),
-      maxPages: import_zod30.z.number().int().min(1).max(1e4).optional().describe("Maximum pages to extract. Use 50 for a normal crawl, up to 10000 for a full-site bulk scrape. Bulk crawls (over 25 pages) switch to folder mode: every page is saved as its own Markdown file in a local folder and the response returns only a summary plus the folder path, so the full content never floods the context window."),
-      rotateProxies: import_zod30.z.boolean().optional().describe("Route page fetches through rotating residential proxies in headful browsers to defeat rate-limiting and bot blocks (403/429). Discovers URLs from the sitemap, fetches in batches with a fresh proxy per batch, retries failures on a new proxy, and automatically parallelizes across the account's concurrency slots. Slower and pricier than the default fetch path, so use only when a site blocks normal crawling."),
-      rotateProxyEvery: import_zod30.z.number().int().min(1).max(100).optional().describe("When rotateProxies is on, how many pages to fetch per browser/proxy before discarding it and minting a fresh one. Default 30. Lower values rotate IPs more aggressively against strict rate limits."),
-      formats: import_zod30.z.array(import_zod30.z.enum(["markdown", "links", "json", "images", "branding"])).optional().describe("Which data formats to include in the per-page output. markdown=page content as Markdown, links=internal/external link graph, json=structured data/schema, images=per-page image URLs (links only, no downloads), branding=site-level logo/colors/fonts captured once from the homepage (requires a browser, adds time). markdown, links, json, and images are always captured cheaply from the HTML; branding is the only opt-in capture. Defaults to markdown+links when omitted.")
+      url: import_zod31.z.string().url().describe("Public website URL or domain to crawl for page CONTENT (map + scrape). For a technical SEO audit use audit_site instead \u2014 this returns content only, not analysis."),
+      maxPages: import_zod31.z.number().int().min(1).max(1e4).optional().describe("Maximum pages to extract. Bulk crawls (over 25 pages) switch to folder mode: each page saved as its own Markdown file, with a summary plus folder path returned instead of inlining content."),
+      rotateProxies: import_zod31.z.boolean().optional().describe("Route page fetches through rotating residential proxies to defeat rate-limiting and bot blocks (403/429). Slower and pricier \u2014 use only when a site blocks normal crawling."),
+      rotateProxyEvery: import_zod31.z.number().int().min(1).max(100).optional().describe("When rotateProxies is on, pages fetched per proxy before rotating. Default 30."),
+      formats: import_zod31.z.array(import_zod31.z.enum(["markdown", "links", "json", "images", "branding"])).optional().describe("Per-page output formats: markdown, links, json, images are captured cheaply from HTML; branding (site-level logo/colors/fonts) requires a browser and adds time. Defaults to markdown+links.")
     };
     AuditSiteInputSchema = {
-      url: import_zod30.z.string().url().describe("Public website URL or domain to run a full technical SEO audit on. Use when the user asks for a technical audit, SEO audit, site health check, or a Screaming-Frog-style crawl \u2014 i.e. they want ANALYSIS (issues, internal link graph, indexability, heading breakdown, image sizes/formats), not just page content. For plain content scraping use extract_site instead."),
-      maxPages: import_zod30.z.number().int().min(1).max(1e4).optional().describe("Maximum pages to crawl and audit. Use 50 for a normal audit, up to 10000 for a full-site audit. The audit always writes a folder of analysis files (report.md, issues.json, pages.jsonl, links.jsonl, link-metrics.jsonl, images.jsonl) plus per-page content, and returns a headline summary plus the folder path."),
-      rotateProxies: import_zod30.z.boolean().optional().describe("Route page fetches through rotating residential proxies to defeat rate-limiting and bot blocks (403/429). Slower and pricier than the default fetch path, so use only when a site blocks normal crawling."),
-      rotateProxyEvery: import_zod30.z.number().int().min(1).max(100).optional().describe("When rotateProxies is on, how many pages to fetch per browser/proxy before discarding it and minting a fresh one. Default 30.")
+      url: import_zod31.z.string().url().describe("Public website URL or domain for a full technical SEO audit (issues, link graph, indexability, headings, images). For plain content use extract_site instead."),
+      maxPages: import_zod31.z.number().int().min(1).max(1e4).optional().describe("Maximum pages to crawl and audit. Always writes a folder of analysis files plus per-page content, returning a summary plus the folder path."),
+      rotateProxies: import_zod31.z.boolean().optional().describe("Route page fetches through rotating residential proxies to defeat rate-limiting and bot blocks. Slower/pricier \u2014 use only when a site blocks normal crawling."),
+      rotateProxyEvery: import_zod31.z.number().int().min(1).max(100).optional().describe("When rotateProxies is on, pages fetched per proxy before rotating. Default 30.")
     };
     YoutubeHarvestInputSchema = {
-      mode: import_zod30.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_zod30.z.string().optional().describe("Required when mode is search. The YouTube search topic in the user\u2019s words."),
-      channelHandle: import_zod30.z.string().optional().describe("YouTube channel handle, channel ID, or URL. Examples: @mkbhd, UC..., https://youtube.com/@mkbhd."),
-      maxVideos: import_zod30.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_zod31.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_zod31.z.string().optional().describe("Required when mode is search. The YouTube search topic in the user\u2019s words."),
+      channelHandle: import_zod31.z.string().optional().describe("YouTube channel handle, channel ID, or URL. Examples: @mkbhd, UC..., https://youtube.com/@mkbhd."),
+      maxVideos: import_zod31.z.number().int().min(1).max(500).default(50).describe("Number of videos to return. Default 50, maximum 500.")
     };
     YoutubeTranscribeInputSchema = {
-      videoId: import_zod30.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_zod30.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_zod31.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_zod31.z.string().url().optional().describe("Full YouTube URL. Use when the user pasted a URL instead of an ID. Provide videoId or url.")
     };
     FacebookPageIntelInputSchema = {
-      pageId: import_zod30.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_zod30.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_zod30.z.string().optional().describe("Advertiser or brand name when pageId/libraryId is not known. One of pageId, libraryId, or query is required."),
-      maxAds: import_zod30.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_zod30.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_zod31.z.string().optional().describe("Facebook advertiser/page ID. Use only a value returned by facebook_ad_search or copied from Ad Library."),
+      libraryId: import_zod31.z.string().optional().describe("Facebook Ad Library archive ID. Use a value returned by facebook_ad_search, or a libraryId/adArchiveId visible in Ad Library."),
+      query: import_zod31.z.string().optional().describe("Advertiser or brand name when pageId/libraryId is not known. One of pageId, libraryId, or query is required."),
+      maxAds: import_zod31.z.number().int().min(1).max(200).default(50).describe("Maximum ads to inspect. Default 50, maximum 200."),
+      country: import_zod31.z.string().length(2).default("US").describe("Two-letter Ad Library country code. Default US.")
     };
     FacebookAdSearchInputSchema = {
-      query: import_zod30.z.string().min(1).describe("Advertiser, brand, competitor, niche, or keyword to search in Facebook Ad Library."),
-      country: import_zod30.z.string().length(2).default("US").describe("Two-letter Ad Library country code. Default US. Examples: US, CA, GB, AU."),
-      maxResults: import_zod30.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_zod31.z.string().min(1).describe("Advertiser, brand, competitor, niche, or keyword to search in Facebook Ad Library."),
+      country: import_zod31.z.string().length(2).default("US").describe("Two-letter Ad Library country code. Default US. Examples: US, CA, GB, AU."),
+      maxResults: import_zod31.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.")
     };
     RedditThreadInputSchema = {
-      url: import_zod30.z.string().min(1).describe("A reddit.com thread/post URL (www, old, or new Reddit, or a redd.it link). The service fetches it via old.reddit through a residential proxy and returns the post plus its comment tree."),
-      maxComments: import_zod30.z.number().int().min(1).max(2e3).optional().describe("Optional cap on comments returned. Omit to return all captured comments.")
+      url: import_zod31.z.string().min(1).describe("A reddit.com thread/post URL (www, old, new Reddit, or redd.it)."),
+      maxComments: import_zod31.z.number().int().min(1).max(2e3).optional().describe("Optional cap on comments returned. Omit to return all captured comments.")
+    };
+    VideoFrameAnalysisInputSchema = {
+      sourceUrl: import_zod31.z.string().min(1).describe("A DIRECT video file URL (.mp4/.webm/.mov). Not a YouTube/Facebook/Instagram page URL \u2014 resolve those to a direct media URL first. Videos up to 30 minutes are supported."),
+      intervalS: import_zod31.z.number().min(1).max(30).optional().describe("Preferred seconds between sampled frames (1-30, default 2). Automatically widened for long videos so the whole duration is covered within the frame budget."),
+      maxFrames: import_zod31.z.number().int().min(1).max(120).optional().describe("Max frames analyzed (<=120, default 120). Frames are spread evenly across the whole video."),
+      detail: import_zod31.z.enum(["fast", "standard", "deep"]).optional().describe("Analysis depth. Default standard."),
+      vault: import_zod31.z.string().min(1).optional().describe('Memory vault to save the finished breakdown into. Default "Library".')
+    };
+    VideoFrameAnalysisStatusInputSchema = {
+      runId: import_zod31.z.string().min(1).describe("The runId returned by video_frame_analysis.")
     };
     FacebookAdTranscribeInputSchema = {
-      videoUrl: import_zod30.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_zod31.z.string().url().describe("Direct Facebook CDN video URL from facebook_page_intel. Do not pass a public post/reel/share URL \u2014 use facebook_video_transcribe for those.")
     };
     FacebookVideoTranscribeInputSchema = {
-      url: import_zod30.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_zod30.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_zod31.z.string().url().describe("Organic Facebook reel/video/watch/post/share URL from facebook.com, m.facebook.com, or fb.watch."),
+      quality: import_zod31.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.")
     };
     GoogleAdsSearchInputSchema = {
-      query: import_zod30.z.string().min(1).describe("A domain (e.g. getviktor.com) or advertiser/brand name to look up in the Google Ads Transparency Center. Domains resolve to the advertisers running ads that point to that site."),
-      region: import_zod30.z.string().length(2).default("US").describe("Two-letter region code for where the ads are shown. Default US. Examples: US, CA, GB, AU."),
-      maxResults: import_zod30.z.number().int().min(1).max(20).default(10).describe("Maximum advertisers to return. Default 10, maximum 20.")
+      query: import_zod31.z.string().min(1).describe("A domain (e.g. getviktor.com) or advertiser/brand name to look up in Google Ads Transparency Center."),
+      region: import_zod31.z.string().length(2).default("US").describe("Two-letter region code for where the ads are shown. Default US. Examples: US, CA, GB, AU."),
+      maxResults: import_zod31.z.number().int().min(1).max(20).default(10).describe("Maximum advertisers to return. Default 10, maximum 20.")
     };
     GoogleAdsPageIntelInputSchema = {
-      advertiserId: import_zod30.z.string().optional().describe("Google Ads Transparency advertiser ID (starts with AR...). Use one returned by google_ads_search; do not construct one yourself."),
-      domain: import_zod30.z.string().optional().describe("A domain (e.g. getviktor.com) whose primary advertiser to inspect when advertiserId is unknown. One of advertiserId or domain is required."),
-      region: import_zod30.z.string().length(2).default("US").describe("Two-letter region code for where the ads are shown. Default US."),
-      maxAds: import_zod30.z.number().int().min(1).max(200).default(50).describe("Maximum creatives to inspect and hydrate. Default 50, maximum 200. Prefer 25-50 for focused scans.")
+      advertiserId: import_zod31.z.string().optional().describe("Google Ads Transparency advertiser ID (starts with AR...). Use one returned by google_ads_search; do not construct one yourself."),
+      domain: import_zod31.z.string().optional().describe("A domain (e.g. getviktor.com) whose primary advertiser to inspect when advertiserId is unknown. One of advertiserId or domain is required."),
+      region: import_zod31.z.string().length(2).default("US").describe("Two-letter region code for where the ads are shown. Default US."),
+      maxAds: import_zod31.z.number().int().min(1).max(200).default(50).describe("Maximum creatives to inspect and hydrate. Default 50, maximum 200. Prefer 25-50 for focused scans.")
     };
     GoogleAdsTranscribeInputSchema = {
-      videoUrl: import_zod30.z.string().url().describe("Direct googlevideo.com playback URL from a google_ads_page_intel video ad result (the videoUrl field). For YouTube-hosted ads use youtube_transcribe with the returned youtubeVideoId instead.")
+      videoUrl: import_zod31.z.string().url().describe("Direct googlevideo.com playback URL from google_ads_page_intel. For YouTube-hosted ads use youtube_transcribe instead.")
     };
     InstagramProfileContentInputSchema = {
-      handle: import_zod30.z.string().min(1).optional().describe("Instagram handle, with or without @. Provide handle or url."),
-      url: import_zod30.z.string().url().optional().describe("Instagram profile URL, e.g. https://www.instagram.com/nasaartemis/. Provide handle or url."),
-      profile: import_zod30.z.string().min(1).optional().describe("Optional saved hosted browser profile name to load authenticated Instagram access. If omitted, the server uses its configured default profile when present."),
-      saveProfileChanges: import_zod30.z.boolean().optional().describe("Whether to save browser changes back to the hosted profile. Leave unset unless intentionally updating the saved login session."),
-      maxItems: import_zod30.z.number().int().min(1).max(2e3).default(50).describe("Maximum profile grid post/reel/tv URLs to collect. Default 50, maximum 2000. Use higher values only when the user asks for a fuller archive."),
-      maxScrolls: import_zod30.z.number().int().min(0).max(250).default(10).describe("Maximum pagination scroll attempts. Default 10, maximum 250. Increase for long profiles when Instagram continues loading more grid links."),
-      scrollDelayMs: import_zod30.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_zod30.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.")
+      handle: import_zod31.z.string().min(1).optional().describe("Instagram handle, with or without @. Provide handle or url."),
+      url: import_zod31.z.string().url().optional().describe("Instagram profile URL. Provide handle or url."),
+      profile: import_zod31.z.string().min(1).optional().describe("Optional saved hosted browser profile name for authenticated Instagram access."),
+      saveProfileChanges: import_zod31.z.boolean().optional().describe("Save browser changes back to the hosted profile. Leave unset unless intentionally updating the saved login."),
+      maxItems: import_zod31.z.number().int().min(1).max(2e3).default(50).describe("Maximum grid URLs to collect. Default 50, maximum 2000."),
+      maxScrolls: import_zod31.z.number().int().min(0).max(250).default(10).describe("Maximum pagination scroll attempts. Default 10, maximum 250."),
+      scrollDelayMs: import_zod31.z.number().int().min(250).max(5e3).default(1200).describe("Delay after each scroll before collecting new links. Default 1200ms."),
+      stableScrollLimit: import_zod31.z.number().int().min(1).max(10).default(4).describe("Stop after this many consecutive scrolls with no new links.")
     };
     InstagramMediaDownloadInputSchema = {
-      url: import_zod30.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."),
-      profile: import_zod30.z.string().min(1).optional().describe("Optional saved hosted browser profile name to load authenticated Instagram access. If omitted, the server uses its configured default profile when present."),
-      saveProfileChanges: import_zod30.z.boolean().optional().describe("Whether to save browser changes back to the hosted profile. Leave unset unless intentionally updating the saved login session."),
-      mediaTypes: import_zod30.z.array(import_zod30.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_zod30.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_zod30.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_zod30.z.boolean().default(false).describe("Transcribe the selected audio track when available. This adds transcription cost and may take longer."),
-      mux: import_zod30.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.")
+      url: import_zod31.z.string().url().describe("Instagram post, reel, or tv URL, e.g. https://www.instagram.com/reel/SHORTCODE/."),
+      profile: import_zod31.z.string().min(1).optional().describe("Optional saved hosted browser profile name for authenticated Instagram access."),
+      saveProfileChanges: import_zod31.z.boolean().optional().describe("Save browser changes back to the hosted profile. Leave unset unless intentionally updating the saved login."),
+      mediaTypes: import_zod31.z.array(import_zod31.z.enum(["image", "video", "audio"])).default(["image", "video", "audio"]).describe("Which media types to download when downloadMedia is true."),
+      downloadMedia: import_zod31.z.boolean().default(true).describe("Download extracted text/media files to the output directory. Media URLs are always returned even when false."),
+      downloadAllTracks: import_zod31.z.boolean().default(false).describe("Download every captured MP4 track instead of only the best video/audio pair."),
+      includeTranscript: import_zod31.z.boolean().default(false).describe("Transcribe the selected audio track. Adds transcription cost and time."),
+      mux: import_zod31.z.boolean().default(true).describe("Mux separately downloaded video/audio tracks into one MP4 if ffmpeg is available.")
     };
     MapsPlaceIntelInputSchema = {
-      businessName: import_zod30.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_zod30.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_zod30.z.string().length(2).default("us").describe("Google country code inferred from location."),
-      hl: import_zod30.z.string().length(2).default("en").describe("Language inferred from user request."),
-      includeReviews: import_zod30.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_zod30.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_zod31.z.string().min(1).describe('Business name only, e.g. "Elite Roofing" (not "Elite Roofing Denver CO" \u2014 put the city in location).'),
+      location: import_zod31.z.string().min(1).describe('City/region/country where the business should be searched, e.g. "Denver, CO".'),
+      gl: import_zod31.z.string().length(2).default("us").describe("Google country code inferred from location."),
+      hl: import_zod31.z.string().length(2).default("en").describe("Language inferred from user request."),
+      includeReviews: import_zod31.z.boolean().default(false).describe("Fetch individual review cards \u2014 for reviews, customer pain, complaints, or praise themes."),
+      maxReviews: import_zod31.z.number().int().min(1).max(500).default(50).describe("Max review cards when includeReviews is true. Default 50, maximum 500.")
     };
     MapsSearchInputSchema = {
-      query: import_zod30.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_zod30.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_zod30.z.string().length(2).default("us").describe("Google country code inferred from location."),
-      hl: import_zod30.z.string().length(2).default("en").describe("Language inferred from user request."),
-      maxResults: import_zod30.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_zod30.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_zod30.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_zod30.z.boolean().default(false).describe("Include sanitized browser/proxy diagnostics when debugging Maps localization, CAPTCHA, or proxy behavior.")
+      query: import_zod31.z.string().min(1).describe('Business category, niche, or search term, e.g. "roofers". Do not include location here \u2014 use location instead.'),
+      location: import_zod31.z.string().optional().describe('City, region, country, or service area, e.g. "Denver, CO".'),
+      gl: import_zod31.z.string().length(2).default("us").describe("Google country code inferred from location."),
+      hl: import_zod31.z.string().length(2).default("en").describe("Language inferred from user request."),
+      maxResults: import_zod31.z.number().int().min(1).max(50).default(10).describe("Number of candidates to return. Default 10, maximum 50."),
+      proxyMode: import_zod31.z.enum(["location", "configured", "none"]).default(DEFAULT_MAPS_PROXY_MODE).describe("Defaults to location (city/state residential proxy targeting). configured forces the service proxy without city/ZIP targeting; none is local debugging only."),
+      proxyZip: import_zod31.z.string().regex(/^\d{5}$/).optional().describe("Optional US ZIP override for residential proxy targeting."),
+      debug: import_zod31.z.boolean().default(false).describe("Include sanitized browser/proxy diagnostics.")
     };
     DirectoryWorkflowInputSchema = {
-      query: import_zod30.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_zod30.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_zod30.z.number().int().min(0).default(1e5).describe('Minimum Census place population for market selection. Use 100000 for "cities above 100k population".'),
-      populationYear: import_zod30.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_zod30.z.number().int().min(1).max(100).default(25).describe("Maximum number of markets to process after sorting by population descending."),
-      maxResultsPerCity: import_zod30.z.number().int().min(1).max(50).default(50).describe("Google Maps business/profile candidates to collect for each city. Maximum 50."),
-      concurrency: import_zod30.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_zod30.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_zod30.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_zod30.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_zod30.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_zod30.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_zod30.z.boolean().default(false).describe("Include sanitized browser/proxy diagnostics in each Maps browser session when supported.")
+      query: import_zod31.z.string().min(1).describe("Business category, niche, or keyword to search on Google Maps for every market. Do not include the city."),
+      state: import_zod31.z.string().min(2).default("TN").describe("US state abbreviation or name used to select Census places, e.g. TN."),
+      minPopulation: import_zod31.z.number().int().min(0).default(1e5).describe("Minimum Census place population for market selection."),
+      populationYear: import_zod31.z.number().int().min(2020).max(2025).default(2025).describe("Census population estimate year (2020-2025 Population Estimates Program)."),
+      maxCities: import_zod31.z.number().int().min(1).max(100).default(25).describe("Maximum markets to process after sorting by population descending."),
+      maxResultsPerCity: import_zod31.z.number().int().min(1).max(50).default(50).describe("Google Maps candidates to collect per city."),
+      concurrency: import_zod31.z.number().int().min(1).max(5).default(5).describe("City Maps searches to run in parallel."),
+      includeZipGroups: import_zod31.z.boolean().default(true).describe("Attach ZIP groups from a configured US ZIPS CSV when available (MCP_SCRAPER_USZIPS_CSV_PATH or usZipsCsvPath)."),
+      usZipsCsvPath: import_zod31.z.string().optional().describe("Local/test-only path to a US ZIPS CSV (state_abbr, zipcode, county, city columns). Deployed APIs should use MCP_SCRAPER_USZIPS_CSV_PATH instead."),
+      saveCsv: import_zod31.z.boolean().default(true).describe("Save a directory-ready CSV of results to the MCP Scraper output directory and return its path."),
+      proxyMode: import_zod31.z.enum(["location", "configured", "none"]).default(DEFAULT_MAPS_PROXY_MODE).describe("Proxy targeting per city search. Defaults to location (city/ZIP-group residential targeting); configured forces the service proxy; none is local debugging only."),
+      proxyZip: import_zod31.z.string().regex(/^\d{5}$/).optional().describe("Optional ZIP override for proxy targeting; normally omitted."),
+      debug: import_zod31.z.boolean().default(false).describe("Include sanitized browser/proxy diagnostics.")
     };
-    RankTrackerModeSchema = import_zod30.z.enum(["maps", "organic", "ai_overview", "paa"]);
+    RankTrackerModeSchema = import_zod31.z.enum(["maps", "organic", "ai_overview", "paa"]);
     RankTrackerBlueprintInputSchema = {
-      projectName: import_zod30.z.string().min(1).optional().describe("Optional name for the rank tracker project, client, or campaign."),
-      targetDomain: import_zod30.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_zod30.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_zod30.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_zod30.z.array(import_zod30.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_zod30.z.array(import_zod30.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_zod30.z.array(import_zod30.z.string().min(1)).max(100).default([]).describe("Optional competitor domains or business names to persist as comparison targets."),
-      database: import_zod30.z.enum(["postgres", "neon", "supabase", "sqlite", "mysql"]).default("postgres").describe("Database family the downstream AI should target when generating migrations."),
-      scheduleCadence: import_zod30.z.enum(["daily", "weekly", "monthly", "custom"]).default("weekly").describe("Default recurring rank check cadence for the generated cron/heartbeat plan."),
-      customCron: import_zod30.z.string().min(1).optional().describe("Cron expression to use when scheduleCadence is custom."),
-      timezone: import_zod30.z.string().min(1).default("UTC").describe("IANA timezone for scheduled rank checks, e.g. America/Denver."),
-      includeCron: import_zod30.z.boolean().default(true).describe("Include a cron or heartbeat worker plan. Keep true for production rank trackers."),
-      includeDashboard: import_zod30.z.boolean().default(true).describe("Include dashboard/reporting requirements in the generated prompt."),
-      includeAlerts: import_zod30.z.boolean().default(true).describe("Include alert rules for rank movement and SERP feature gains/losses."),
-      notes: import_zod30.z.string().max(4e3).optional().describe("Extra product, client, stack, or hosting requirements to include in the implementation prompt.")
+      projectName: import_zod31.z.string().min(1).optional().describe("Optional name for the rank tracker project, client, or campaign."),
+      targetDomain: import_zod31.z.string().min(1).optional().describe("Primary domain to track in organic results, AI Overview citations, and PAA sources."),
+      targetBusinessName: import_zod31.z.string().min(1).optional().describe("Primary Google Business Profile/brand name to match in Maps results. Required for Maps tracking."),
+      trackingModes: import_zod31.z.array(RankTrackerModeSchema).min(1).max(4).default(["maps", "organic", "ai_overview", "paa"]).describe("Rank tracker surfaces to build: maps, organic, ai_overview, paa."),
+      keywords: import_zod31.z.array(import_zod31.z.string().min(1)).max(200).default([]).describe("Seed keywords or service queries to track. Leave empty to derive from user input downstream."),
+      locations: import_zod31.z.array(import_zod31.z.string().min(1)).max(100).default([]).describe('Markets, cities, ZIPs, or service areas to track, e.g. "Denver, CO".'),
+      competitors: import_zod31.z.array(import_zod31.z.string().min(1)).max(100).default([]).describe("Optional competitor domains or business names to persist as comparison targets."),
+      database: import_zod31.z.enum(["postgres", "neon", "supabase", "sqlite", "mysql"]).default("postgres").describe("Database family to target when generating migrations."),
+      scheduleCadence: import_zod31.z.enum(["daily", "weekly", "monthly", "custom"]).default("weekly").describe("Default recurring rank check cadence."),
+      customCron: import_zod31.z.string().min(1).optional().describe("Cron expression to use when scheduleCadence is custom."),
+      timezone: import_zod31.z.string().min(1).default("UTC").describe("IANA timezone for scheduled rank checks."),
+      includeCron: import_zod31.z.boolean().default(true).describe("Include a cron/heartbeat worker plan."),
+      includeDashboard: import_zod31.z.boolean().default(true).describe("Include dashboard/reporting requirements."),
+      includeAlerts: import_zod31.z.boolean().default(true).describe("Include alert rules for rank movement and SERP feature changes."),
+      notes: import_zod31.z.string().max(4e3).optional().describe("Extra product, client, stack, or hosting requirements.")
     };
-    NullableString = import_zod30.z.string().nullable();
-    MapsSearchAttemptOutput = import_zod30.z.object({
-      attemptNumber: import_zod30.z.number().int().min(1),
-      maxAttempts: import_zod30.z.number().int().min(1),
-      status: import_zod30.z.enum(["ok", "failed"]),
-      outcome: import_zod30.z.string(),
-      willRetry: import_zod30.z.boolean(),
-      durationMs: import_zod30.z.number().int().min(0),
-      resultCount: import_zod30.z.number().int().min(0),
+    NullableString = import_zod31.z.string().nullable();
+    MapsSearchAttemptOutput = import_zod31.z.object({
+      attemptNumber: import_zod31.z.number().int().min(1),
+      maxAttempts: import_zod31.z.number().int().min(1),
+      status: import_zod31.z.enum(["ok", "failed"]),
+      outcome: import_zod31.z.string(),
+      willRetry: import_zod31.z.boolean(),
+      durationMs: import_zod31.z.number().int().min(0),
+      resultCount: import_zod31.z.number().int().min(0),
       error: NullableString,
-      proxyMode: import_zod30.z.enum(["location", "configured", "none"]),
-      proxyResolutionSource: import_zod30.z.enum(["disabled", "location_reused", "location_created", "configured_fallback", "unavailable"]).nullable(),
+      proxyMode: import_zod31.z.enum(["location", "configured", "none"]),
+      proxyResolutionSource: import_zod31.z.enum(["disabled", "location_reused", "location_created", "configured_fallback", "unavailable"]).nullable(),
       proxyIdSuffix: NullableString,
-      proxyTargetLevel: import_zod30.z.enum(["zip", "city", "state"]).nullable(),
+      proxyTargetLevel: import_zod31.z.enum(["zip", "city", "state"]).nullable(),
       proxyTargetLocation: NullableString,
       proxyTargetZip: NullableString,
       browserSessionIdSuffix: NullableString,
@@ -25831,17 +26151,17 @@ var init_mcp_tool_schemas = __esm({
       observedRegion: NullableString
     });
     MapsSearchOutputSchema = {
-      query: import_zod30.z.string(),
-      location: import_zod30.z.string().nullable(),
-      searchQuery: import_zod30.z.string(),
-      searchUrl: import_zod30.z.string().url(),
-      extractedAt: import_zod30.z.string(),
-      requestedMaxResults: import_zod30.z.number().int().min(1).max(50),
-      resultCount: import_zod30.z.number().int().min(0).max(50),
-      results: import_zod30.z.array(import_zod30.z.object({
-        position: import_zod30.z.number().int().min(1),
-        name: import_zod30.z.string(),
-        placeUrl: import_zod30.z.string().url(),
+      query: import_zod31.z.string(),
+      location: import_zod31.z.string().nullable(),
+      searchQuery: import_zod31.z.string(),
+      searchUrl: import_zod31.z.string().url(),
+      extractedAt: import_zod31.z.string(),
+      requestedMaxResults: import_zod31.z.number().int().min(1).max(50),
+      resultCount: import_zod31.z.number().int().min(0).max(50),
+      results: import_zod31.z.array(import_zod31.z.object({
+        position: import_zod31.z.number().int().min(1),
+        name: import_zod31.z.string(),
+        placeUrl: import_zod31.z.string().url(),
         cid: NullableString,
         cidDecimal: NullableString,
         rating: NullableString,
@@ -25852,15 +26172,15 @@ var init_mcp_tool_schemas = __esm({
         hoursStatus: NullableString,
         websiteUrl: NullableString,
         directionsUrl: NullableString,
-        metadata: import_zod30.z.array(import_zod30.z.string())
+        metadata: import_zod31.z.array(import_zod31.z.string())
       })),
-      attempts: import_zod30.z.array(MapsSearchAttemptOutput),
-      durationMs: import_zod30.z.number().int().min(0)
+      attempts: import_zod31.z.array(MapsSearchAttemptOutput),
+      durationMs: import_zod31.z.number().int().min(0)
     };
-    DirectoryMapsBusinessOutput = import_zod30.z.object({
-      position: import_zod30.z.number().int().min(1),
-      name: import_zod30.z.string(),
-      placeUrl: import_zod30.z.string().url(),
+    DirectoryMapsBusinessOutput = import_zod31.z.object({
+      position: import_zod31.z.number().int().min(1),
+      name: import_zod31.z.string(),
+      placeUrl: import_zod31.z.string().url(),
       cid: NullableString,
       cidDecimal: NullableString,
       rating: NullableString,
@@ -25871,120 +26191,120 @@ var init_mcp_tool_schemas = __esm({
       hoursStatus: NullableString,
       websiteUrl: NullableString,
       directionsUrl: NullableString,
-      metadata: import_zod30.z.array(import_zod30.z.string())
+      metadata: import_zod31.z.array(import_zod31.z.string())
     });
     DirectoryWorkflowOutputSchema = {
-      query: import_zod30.z.string(),
-      state: import_zod30.z.string(),
-      minPopulation: import_zod30.z.number().int().min(0),
-      populationYear: import_zod30.z.number().int().min(2020).max(2025),
-      maxResultsPerCity: import_zod30.z.number().int().min(1).max(50),
-      concurrency: import_zod30.z.number().int().min(1).max(5),
-      censusSourceUrl: import_zod30.z.string().url(),
+      query: import_zod31.z.string(),
+      state: import_zod31.z.string(),
+      minPopulation: import_zod31.z.number().int().min(0),
+      populationYear: import_zod31.z.number().int().min(2020).max(2025),
+      maxResultsPerCity: import_zod31.z.number().int().min(1).max(50),
+      concurrency: import_zod31.z.number().int().min(1).max(5),
+      censusSourceUrl: import_zod31.z.string().url(),
       usZipsSourcePath: NullableString,
-      warnings: import_zod30.z.array(import_zod30.z.string()),
-      extractedAt: import_zod30.z.string(),
-      selectedCityCount: import_zod30.z.number().int().min(0),
-      totalResultCount: import_zod30.z.number().int().min(0),
+      warnings: import_zod31.z.array(import_zod31.z.string()),
+      extractedAt: import_zod31.z.string(),
+      selectedCityCount: import_zod31.z.number().int().min(0),
+      totalResultCount: import_zod31.z.number().int().min(0),
       csvPath: NullableString,
-      cities: import_zod30.z.array(import_zod30.z.object({
-        city: import_zod30.z.string(),
-        state: import_zod30.z.string(),
-        location: import_zod30.z.string(),
-        cityKey: import_zod30.z.string(),
-        censusName: import_zod30.z.string(),
-        population: import_zod30.z.number().int().min(0),
-        populationYear: import_zod30.z.number().int().min(2020).max(2025),
-        zips: import_zod30.z.array(import_zod30.z.string()),
-        counties: import_zod30.z.array(import_zod30.z.string()),
-        status: import_zod30.z.enum(["ok", "empty", "failed"]),
+      cities: import_zod31.z.array(import_zod31.z.object({
+        city: import_zod31.z.string(),
+        state: import_zod31.z.string(),
+        location: import_zod31.z.string(),
+        cityKey: import_zod31.z.string(),
+        censusName: import_zod31.z.string(),
+        population: import_zod31.z.number().int().min(0),
+        populationYear: import_zod31.z.number().int().min(2020).max(2025),
+        zips: import_zod31.z.array(import_zod31.z.string()),
+        counties: import_zod31.z.array(import_zod31.z.string()),
+        status: import_zod31.z.enum(["ok", "empty", "failed"]),
         error: NullableString,
-        resultCount: import_zod30.z.number().int().min(0),
-        durationMs: import_zod30.z.number().int().min(0),
-        attempts: import_zod30.z.array(MapsSearchAttemptOutput),
-        results: import_zod30.z.array(DirectoryMapsBusinessOutput)
+        resultCount: import_zod31.z.number().int().min(0),
+        durationMs: import_zod31.z.number().int().min(0),
+        attempts: import_zod31.z.array(MapsSearchAttemptOutput),
+        results: import_zod31.z.array(DirectoryMapsBusinessOutput)
       })),
-      durationMs: import_zod30.z.number().int().min(0)
+      durationMs: import_zod31.z.number().int().min(0)
     };
-    RankTrackerToolPlanOutput = import_zod30.z.object({
-      tool: import_zod30.z.string(),
-      purpose: import_zod30.z.string()
+    RankTrackerToolPlanOutput = import_zod31.z.object({
+      tool: import_zod31.z.string(),
+      purpose: import_zod31.z.string()
     });
-    RankTrackerTableOutput = import_zod30.z.object({
-      name: import_zod30.z.string(),
-      purpose: import_zod30.z.string(),
-      keyColumns: import_zod30.z.array(import_zod30.z.string())
+    RankTrackerTableOutput = import_zod31.z.object({
+      name: import_zod31.z.string(),
+      purpose: import_zod31.z.string(),
+      keyColumns: import_zod31.z.array(import_zod31.z.string())
     });
-    RankTrackerCronJobOutput = import_zod30.z.object({
-      name: import_zod30.z.string(),
-      purpose: import_zod30.z.string(),
-      modes: import_zod30.z.array(RankTrackerModeSchema),
-      recommendedTools: import_zod30.z.array(import_zod30.z.string())
+    RankTrackerCronJobOutput = import_zod31.z.object({
+      name: import_zod31.z.string(),
+      purpose: import_zod31.z.string(),
+      modes: import_zod31.z.array(RankTrackerModeSchema),
+      recommendedTools: import_zod31.z.array(import_zod31.z.string())
     });
     RankTrackerBlueprintOutputSchema = {
-      projectName: import_zod30.z.string(),
+      projectName: import_zod31.z.string(),
       targetDomain: NullableString,
       targetBusinessName: NullableString,
-      trackingModes: import_zod30.z.array(RankTrackerModeSchema),
-      database: import_zod30.z.string(),
-      recommendedTools: import_zod30.z.array(RankTrackerToolPlanOutput),
-      tables: import_zod30.z.array(RankTrackerTableOutput),
-      cron: import_zod30.z.object({
-        enabled: import_zod30.z.boolean(),
-        cadence: import_zod30.z.string(),
-        expression: import_zod30.z.string(),
-        timezone: import_zod30.z.string(),
-        jobs: import_zod30.z.array(RankTrackerCronJobOutput)
+      trackingModes: import_zod31.z.array(RankTrackerModeSchema),
+      database: import_zod31.z.string(),
+      recommendedTools: import_zod31.z.array(RankTrackerToolPlanOutput),
+      tables: import_zod31.z.array(RankTrackerTableOutput),
+      cron: import_zod31.z.object({
+        enabled: import_zod31.z.boolean(),
+        cadence: import_zod31.z.string(),
+        expression: import_zod31.z.string(),
+        timezone: import_zod31.z.string(),
+        jobs: import_zod31.z.array(RankTrackerCronJobOutput)
       }),
-      metrics: import_zod30.z.array(import_zod30.z.string()),
-      implementationPrompt: import_zod30.z.string()
+      metrics: import_zod31.z.array(import_zod31.z.string()),
+      implementationPrompt: import_zod31.z.string()
     };
-    OrganicResultOutput = import_zod30.z.object({
-      position: import_zod30.z.number().int(),
-      title: import_zod30.z.string(),
-      url: import_zod30.z.string(),
-      domain: import_zod30.z.string(),
+    OrganicResultOutput = import_zod31.z.object({
+      position: import_zod31.z.number().int(),
+      title: import_zod31.z.string(),
+      url: import_zod31.z.string(),
+      domain: import_zod31.z.string(),
       snippet: NullableString
     });
-    AiOverviewOutput = import_zod30.z.object({
-      detected: import_zod30.z.boolean(),
+    AiOverviewOutput = import_zod31.z.object({
+      detected: import_zod31.z.boolean(),
       text: NullableString,
       shareUrl: NullableString.optional()
     }).nullable();
-    EntityIdsOutput = import_zod30.z.object({
-      entities: import_zod30.z.array(import_zod30.z.object({
-        name: import_zod30.z.string(),
-        kgId: import_zod30.z.string().nullable(),
-        cid: import_zod30.z.string().nullable(),
-        gcid: import_zod30.z.string().nullable()
-      })).describe("Each entity actually named on the page, with whichever of its kgId/cid/gcid were found \u2014 the linked view. kgIds/cids/gcids below are the same IDs as flat deduplicated lists, without the name link, kept for backward compatibility."),
-      kgIds: import_zod30.z.array(import_zod30.z.string()),
-      cids: import_zod30.z.array(import_zod30.z.string()),
-      gcids: import_zod30.z.array(import_zod30.z.string())
+    EntityIdsOutput = import_zod31.z.object({
+      entities: import_zod31.z.array(import_zod31.z.object({
+        name: import_zod31.z.string(),
+        kgId: import_zod31.z.string().nullable(),
+        cid: import_zod31.z.string().nullable(),
+        gcid: import_zod31.z.string().nullable()
+      })).describe("Entities named on the page with their kgId/cid/gcid. Flat lists below are the same IDs deduplicated, kept for backward compatibility."),
+      kgIds: import_zod31.z.array(import_zod31.z.string()),
+      cids: import_zod31.z.array(import_zod31.z.string()),
+      gcids: import_zod31.z.array(import_zod31.z.string())
     }).nullable();
     HarvestPaaOutputSchema = {
-      query: import_zod30.z.string(),
+      query: import_zod31.z.string(),
       location: NullableString,
-      questionCount: import_zod30.z.number().int().min(0),
+      questionCount: import_zod31.z.number().int().min(0),
       completionStatus: NullableString,
-      questions: import_zod30.z.array(import_zod30.z.object({
-        question: import_zod30.z.string(),
+      questions: import_zod31.z.array(import_zod31.z.object({
+        question: import_zod31.z.string(),
         answer: NullableString,
         sourceTitle: NullableString,
         sourceSite: NullableString
       })),
-      organicResults: import_zod30.z.array(OrganicResultOutput),
+      organicResults: import_zod31.z.array(OrganicResultOutput),
       aiOverview: AiOverviewOutput,
       entityIds: EntityIdsOutput,
-      durationMs: import_zod30.z.number().min(0).nullable()
+      durationMs: import_zod31.z.number().min(0).nullable()
     };
     SearchSerpOutputSchema = {
-      query: import_zod30.z.string(),
+      query: import_zod31.z.string(),
       location: NullableString,
-      organicResults: import_zod30.z.array(OrganicResultOutput),
-      localPack: import_zod30.z.array(import_zod30.z.object({
-        position: import_zod30.z.number().int(),
-        name: import_zod30.z.string(),
+      organicResults: import_zod31.z.array(OrganicResultOutput),
+      localPack: import_zod31.z.array(import_zod31.z.object({
+        position: import_zod31.z.number().int(),
+        name: import_zod31.z.string(),
         rating: NullableString,
         reviewCount: NullableString,
         websiteUrl: NullableString
@@ -25993,61 +26313,61 @@ var init_mcp_tool_schemas = __esm({
       entityIds: EntityIdsOutput
     };
     ExtractUrlOutputSchema = {
-      url: import_zod30.z.string(),
+      url: import_zod31.z.string(),
       title: NullableString,
-      headings: import_zod30.z.array(import_zod30.z.object({
-        level: import_zod30.z.number().int(),
-        text: import_zod30.z.string()
+      headings: import_zod31.z.array(import_zod31.z.object({
+        level: import_zod31.z.number().int(),
+        text: import_zod31.z.string()
       })),
-      schemaBlockCount: import_zod30.z.number().int().min(0),
+      schemaBlockCount: import_zod31.z.number().int().min(0),
       entityName: NullableString,
-      entityTypes: import_zod30.z.array(import_zod30.z.string()),
-      napScore: import_zod30.z.number().nullable(),
-      missingSchemaFields: import_zod30.z.array(import_zod30.z.string()),
+      entityTypes: import_zod31.z.array(import_zod31.z.string()),
+      napScore: import_zod31.z.number().nullable(),
+      missingSchemaFields: import_zod31.z.array(import_zod31.z.string()),
       screenshotSaved: NullableString,
-      memory: import_zod30.z.object({
-        deposited: import_zod30.z.boolean(),
-        vault: import_zod30.z.string().optional(),
-        noteId: import_zod30.z.string().optional(),
-        path: import_zod30.z.string().optional(),
-        chunks: import_zod30.z.number().int().optional(),
-        fileUrl: import_zod30.z.string().optional(),
-        fileExpiresAt: import_zod30.z.string().optional(),
-        error: import_zod30.z.string().optional()
+      memory: import_zod31.z.object({
+        deposited: import_zod31.z.boolean(),
+        vault: import_zod31.z.string().optional(),
+        noteId: import_zod31.z.string().optional(),
+        path: import_zod31.z.string().optional(),
+        chunks: import_zod31.z.number().int().optional(),
+        fileUrl: import_zod31.z.string().optional(),
+        fileExpiresAt: import_zod31.z.string().optional(),
+        error: import_zod31.z.string().optional()
       }).optional()
     };
     ExtractSiteOutputSchema = {
-      url: import_zod30.z.string(),
-      pageCount: import_zod30.z.number().int().min(0),
-      pages: import_zod30.z.array(import_zod30.z.object({
-        url: import_zod30.z.string(),
+      url: import_zod31.z.string(),
+      pageCount: import_zod31.z.number().int().min(0),
+      pages: import_zod31.z.array(import_zod31.z.object({
+        url: import_zod31.z.string(),
         title: NullableString,
-        schemaTypes: import_zod30.z.array(import_zod30.z.string())
+        schemaTypes: import_zod31.z.array(import_zod31.z.string())
       })),
-      durationMs: import_zod30.z.number().min(0)
+      durationMs: import_zod31.z.number().min(0)
     };
     AuditSiteOutputSchema = {
-      url: import_zod30.z.string(),
-      pageCount: import_zod30.z.number().int().min(0),
-      durationMs: import_zod30.z.number().min(0),
-      bulkFolder: import_zod30.z.string().nullable(),
-      issues: import_zod30.z.record(import_zod30.z.string(), import_zod30.z.number()),
-      images: import_zod30.z.object({
-        unique: import_zod30.z.number().int().min(0),
-        totalBytes: import_zod30.z.number().min(0),
-        over100kb: import_zod30.z.number().int().min(0),
-        legacyFormat: import_zod30.z.number().int().min(0)
+      url: import_zod31.z.string(),
+      pageCount: import_zod31.z.number().int().min(0),
+      durationMs: import_zod31.z.number().min(0),
+      bulkFolder: import_zod31.z.string().nullable(),
+      issues: import_zod31.z.record(import_zod31.z.string(), import_zod31.z.number()),
+      images: import_zod31.z.object({
+        unique: import_zod31.z.number().int().min(0),
+        totalBytes: import_zod31.z.number().min(0),
+        over100kb: import_zod31.z.number().int().min(0),
+        legacyFormat: import_zod31.z.number().int().min(0)
       }),
-      links: import_zod30.z.object({
-        internal: import_zod30.z.number().int().min(0),
-        external: import_zod30.z.number().int().min(0),
-        orphans: import_zod30.z.number().int().min(0),
-        brokenInternal: import_zod30.z.number().int().min(0),
-        externalDomains: import_zod30.z.number().int().min(0)
+      links: import_zod31.z.object({
+        internal: import_zod31.z.number().int().min(0),
+        external: import_zod31.z.number().int().min(0),
+        orphans: import_zod31.z.number().int().min(0),
+        brokenInternal: import_zod31.z.number().int().min(0),
+        externalDomains: import_zod31.z.number().int().min(0)
       })
     };
     MapsPlaceIntelOutputSchema = {
-      name: import_zod30.z.string(),
+      name: import_zod31.z.string(),
       rating: NullableString,
       reviewCount: NullableString,
       category: NullableString,
@@ -26059,75 +26379,75 @@ var init_mcp_tool_schemas = __esm({
       kgmid: NullableString,
       cidDecimal: NullableString,
       cidUrl: NullableString,
-      lat: import_zod30.z.number().nullable(),
-      lng: import_zod30.z.number().nullable(),
-      reviewsStatus: import_zod30.z.string(),
-      reviewsCollected: import_zod30.z.number().int().min(0),
-      reviewTopics: import_zod30.z.array(import_zod30.z.object({
-        label: import_zod30.z.string(),
-        count: import_zod30.z.string()
+      lat: import_zod31.z.number().nullable(),
+      lng: import_zod31.z.number().nullable(),
+      reviewsStatus: import_zod31.z.string(),
+      reviewsCollected: import_zod31.z.number().int().min(0),
+      reviewTopics: import_zod31.z.array(import_zod31.z.object({
+        label: import_zod31.z.string(),
+        count: import_zod31.z.string()
       }))
     };
     CreditsInfoOutputSchema = {
-      balanceCredits: import_zod30.z.number().nullable(),
-      matchedCost: import_zod30.z.object({
-        label: import_zod30.z.string(),
-        credits: import_zod30.z.number(),
-        unit: import_zod30.z.string(),
+      balanceCredits: import_zod31.z.number().nullable(),
+      matchedCost: import_zod31.z.object({
+        label: import_zod31.z.string(),
+        credits: import_zod31.z.number(),
+        unit: import_zod31.z.string(),
         notes: NullableString
       }).nullable(),
-      costs: import_zod30.z.array(import_zod30.z.object({
-        key: import_zod30.z.string(),
-        label: import_zod30.z.string(),
-        credits: import_zod30.z.number(),
-        unit: import_zod30.z.string(),
+      costs: import_zod31.z.array(import_zod31.z.object({
+        key: import_zod31.z.string(),
+        label: import_zod31.z.string(),
+        credits: import_zod31.z.number(),
+        unit: import_zod31.z.string(),
         notes: NullableString
       })),
-      ledger: import_zod30.z.array(import_zod30.z.object({
-        createdAt: import_zod30.z.string(),
-        operation: import_zod30.z.string(),
-        credits: import_zod30.z.number(),
+      ledger: import_zod31.z.array(import_zod31.z.object({
+        createdAt: import_zod31.z.string(),
+        operation: import_zod31.z.string(),
+        credits: import_zod31.z.number(),
         description: NullableString
       })),
-      concurrency: import_zod30.z.object({
-        currentExtraSlots: import_zod30.z.number().int().min(0),
-        currentLimit: import_zod30.z.number().int().min(1),
-        hasSubscription: import_zod30.z.boolean(),
-        upgrade: import_zod30.z.object({
-          product: import_zod30.z.string(),
-          priceLabel: import_zod30.z.string(),
-          unitAmountUsd: import_zod30.z.number(),
-          currency: import_zod30.z.string(),
-          interval: import_zod30.z.string(),
-          billingUrl: import_zod30.z.string().url(),
-          terminalCommand: import_zod30.z.string(),
-          terminalCommandWithApiKeyEnv: import_zod30.z.string()
+      concurrency: import_zod31.z.object({
+        currentExtraSlots: import_zod31.z.number().int().min(0),
+        currentLimit: import_zod31.z.number().int().min(1),
+        hasSubscription: import_zod31.z.boolean(),
+        upgrade: import_zod31.z.object({
+          product: import_zod31.z.string(),
+          priceLabel: import_zod31.z.string(),
+          unitAmountUsd: import_zod31.z.number(),
+          currency: import_zod31.z.string(),
+          interval: import_zod31.z.string(),
+          billingUrl: import_zod31.z.string().url(),
+          terminalCommand: import_zod31.z.string(),
+          terminalCommandWithApiKeyEnv: import_zod31.z.string()
         })
       }).nullable()
     };
     MapSiteUrlsOutputSchema = {
-      startUrl: import_zod30.z.string(),
-      totalFound: import_zod30.z.number().int().min(0),
-      truncated: import_zod30.z.boolean(),
-      okCount: import_zod30.z.number().int().min(0),
-      redirectCount: import_zod30.z.number().int().min(0),
-      brokenCount: import_zod30.z.number().int().min(0),
-      urls: import_zod30.z.array(import_zod30.z.object({
-        url: import_zod30.z.string(),
-        status: import_zod30.z.number().int().nullable()
+      startUrl: import_zod31.z.string(),
+      totalFound: import_zod31.z.number().int().min(0),
+      truncated: import_zod31.z.boolean(),
+      okCount: import_zod31.z.number().int().min(0),
+      redirectCount: import_zod31.z.number().int().min(0),
+      brokenCount: import_zod31.z.number().int().min(0),
+      urls: import_zod31.z.array(import_zod31.z.object({
+        url: import_zod31.z.string(),
+        status: import_zod31.z.number().int().nullable()
       })),
-      durationMs: import_zod30.z.number().min(0)
+      durationMs: import_zod31.z.number().min(0)
     };
     YoutubeHarvestOutputSchema = {
-      mode: import_zod30.z.string(),
-      videoCount: import_zod30.z.number().int().min(0),
-      channel: import_zod30.z.object({
+      mode: import_zod31.z.string(),
+      videoCount: import_zod31.z.number().int().min(0),
+      channel: import_zod31.z.object({
         title: NullableString,
         subscriberCount: NullableString
       }).nullable(),
-      videos: import_zod30.z.array(import_zod30.z.object({
-        videoId: import_zod30.z.string(),
-        title: import_zod30.z.string(),
+      videos: import_zod31.z.array(import_zod31.z.object({
+        videoId: import_zod31.z.string(),
+        title: import_zod31.z.string(),
         channelName: NullableString,
         views: NullableString,
         duration: NullableString,
@@ -26135,17 +26455,33 @@ var init_mcp_tool_schemas = __esm({
       }))
     };
     FacebookAdSearchOutputSchema = {
-      query: import_zod30.z.string(),
-      advertiserCount: import_zod30.z.number().int().min(0),
-      advertisers: import_zod30.z.array(import_zod30.z.object({
+      query: import_zod31.z.string(),
+      advertiserCount: import_zod31.z.number().int().min(0),
+      advertisers: import_zod31.z.array(import_zod31.z.object({
         name: NullableString,
         pageId: NullableString,
         pageUrl: NullableString,
-        adCount: import_zod30.z.number().int().nullable(),
+        adCount: import_zod31.z.number().int().nullable(),
         libraryId: NullableString,
         sampleLibraryId: NullableString
       }))
     };
+    VideoFrameAnalysisOutputSchema = {
+      ok: import_zod31.z.boolean(),
+      runId: NullableString,
+      status: NullableString,
+      message: NullableString
+    };
+    VideoFrameAnalysisStatusOutputSchema = {
+      ok: import_zod31.z.boolean(),
+      runId: NullableString,
+      status: NullableString,
+      progress: import_zod31.z.object({ analyzed: import_zod31.z.number().int(), total: import_zod31.z.number().int() }).nullable().optional(),
+      frameCount: import_zod31.z.number().int().nullable().optional(),
+      artifactPath: NullableString,
+      report: NullableString,
+      error: NullableString
+    };
     RedditThreadOutputSchema = {
       sourceUrl: NullableString,
       oldRedditUrl: NullableString,
@@ -26153,21 +26489,21 @@ var init_mcp_tool_schemas = __esm({
       author: NullableString,
       score: NullableString,
       postBody: NullableString,
-      numComments: import_zod30.z.number().int().min(0),
-      comments: import_zod30.z.array(import_zod30.z.object({
+      numComments: import_zod31.z.number().int().min(0),
+      comments: import_zod31.z.array(import_zod31.z.object({
         author: NullableString,
         score: NullableString,
-        depth: import_zod30.z.number().int().min(0),
-        body: import_zod30.z.string()
+        depth: import_zod31.z.number().int().min(0),
+        body: import_zod31.z.string()
       }))
     };
     FacebookPageIntelOutputSchema = {
       advertiserName: NullableString,
-      totalAds: import_zod30.z.number().int().min(0),
-      activeCount: import_zod30.z.number().int().min(0),
-      videoCount: import_zod30.z.number().int().min(0),
-      imageCount: import_zod30.z.number().int().min(0),
-      ads: import_zod30.z.array(import_zod30.z.object({
+      totalAds: import_zod31.z.number().int().min(0),
+      activeCount: import_zod31.z.number().int().min(0),
+      videoCount: import_zod31.z.number().int().min(0),
+      imageCount: import_zod31.z.number().int().min(0),
+      ads: import_zod31.z.array(import_zod31.z.object({
         libraryId: NullableString,
         status: NullableString,
         creativeType: NullableString,
@@ -26180,18 +26516,18 @@ var init_mcp_tool_schemas = __esm({
         videoUrl: NullableString,
         imageUrl: NullableString,
         videoPoster: NullableString,
-        variations: import_zod30.z.number().int().nullable()
+        variations: import_zod31.z.number().int().nullable()
       }))
     };
     GoogleAdsSearchOutputSchema = {
-      query: import_zod30.z.string(),
-      region: import_zod30.z.string(),
-      advertiserCount: import_zod30.z.number().int().min(0),
-      advertisers: import_zod30.z.array(import_zod30.z.object({
+      query: import_zod31.z.string(),
+      region: import_zod31.z.string(),
+      advertiserCount: import_zod31.z.number().int().min(0),
+      advertisers: import_zod31.z.array(import_zod31.z.object({
         advertiserId: NullableString,
         name: NullableString,
         domain: NullableString,
-        approxAdCount: import_zod30.z.number().int().nullable(),
+        approxAdCount: import_zod31.z.number().int().nullable(),
         detailUrl: NullableString
       }))
     };
@@ -26199,205 +26535,205 @@ var init_mcp_tool_schemas = __esm({
       advertiserId: NullableString,
       advertiserName: NullableString,
       domain: NullableString,
-      region: import_zod30.z.string(),
-      totalCreatives: import_zod30.z.number().int().min(0),
-      videoCount: import_zod30.z.number().int().min(0),
-      imageCount: import_zod30.z.number().int().min(0),
-      textCount: import_zod30.z.number().int().min(0),
-      ads: import_zod30.z.array(import_zod30.z.object({
+      region: import_zod31.z.string(),
+      totalCreatives: import_zod31.z.number().int().min(0),
+      videoCount: import_zod31.z.number().int().min(0),
+      imageCount: import_zod31.z.number().int().min(0),
+      textCount: import_zod31.z.number().int().min(0),
+      ads: import_zod31.z.array(import_zod31.z.object({
         creativeId: NullableString,
         advertiserId: NullableString,
         format: NullableString,
         lastShown: NullableString,
         detailUrl: NullableString,
         landingDomain: NullableString,
-        imageUrls: import_zod30.z.array(import_zod30.z.string()),
+        imageUrls: import_zod31.z.array(import_zod31.z.string()),
         youtubeVideoId: NullableString,
         videoUrl: NullableString,
-        variations: import_zod30.z.number().int().nullable()
+        variations: import_zod31.z.number().int().nullable()
       }))
     };
     FacebookVideoTranscribeOutputSchema = {
-      sourceUrl: import_zod30.z.string().url(),
-      pageUrl: import_zod30.z.string().url(),
+      sourceUrl: import_zod31.z.string().url(),
+      pageUrl: import_zod31.z.string().url(),
       videoId: NullableString,
       ownerName: NullableString,
-      selectedQuality: import_zod30.z.string(),
-      bitrate: import_zod30.z.number().int().nullable(),
-      videoDurationSec: import_zod30.z.number().nullable(),
-      videoUrl: import_zod30.z.string().url(),
-      wordCount: import_zod30.z.number().int().min(0),
-      chunkCount: import_zod30.z.number().int().min(0),
-      transcriptText: import_zod30.z.string(),
-      chunks: import_zod30.z.array(import_zod30.z.object({
-        startSec: import_zod30.z.number(),
-        endSec: import_zod30.z.number(),
-        text: import_zod30.z.string()
+      selectedQuality: import_zod31.z.string(),
+      bitrate: import_zod31.z.number().int().nullable(),
+      videoDurationSec: import_zod31.z.number().nullable(),
+      videoUrl: import_zod31.z.string().url(),
+      wordCount: import_zod31.z.number().int().min(0),
+      chunkCount: import_zod31.z.number().int().min(0),
+      transcriptText: import_zod31.z.string(),
+      chunks: import_zod31.z.array(import_zod31.z.object({
+        startSec: import_zod31.z.number(),
+        endSec: import_zod31.z.number(),
+        text: import_zod31.z.string()
       }))
     };
-    TranscriptChunkOutput = import_zod30.z.object({
-      startSec: import_zod30.z.number(),
-      endSec: import_zod30.z.number(),
-      text: import_zod30.z.string()
-    });
-    InstagramBrowserOutput = import_zod30.z.object({
-      mode: import_zod30.z.literal("hosted"),
-      requestedMode: import_zod30.z.literal("hosted"),
+    TranscriptChunkOutput = import_zod31.z.object({
+      startSec: import_zod31.z.number(),
+      endSec: import_zod31.z.number(),
+      text: import_zod31.z.string()
+    });
+    InstagramBrowserOutput = import_zod31.z.object({
+      mode: import_zod31.z.literal("hosted"),
+      requestedMode: import_zod31.z.literal("hosted"),
       profileName: NullableString,
-      profileSource: import_zod30.z.literal("hosted"),
-      profileDirConfigured: import_zod30.z.boolean(),
-      executablePathConfigured: import_zod30.z.boolean()
-    });
-    InstagramPaginationOutput = import_zod30.z.object({
-      maxItems: import_zod30.z.number().int().min(1).max(2e3),
-      maxScrolls: import_zod30.z.number().int().min(0).max(250),
-      attemptedScrolls: import_zod30.z.number().int().min(0),
-      stableScrolls: import_zod30.z.number().int().min(0),
-      stableScrollLimit: import_zod30.z.number().int().min(1).max(10),
-      scrollDelayMs: import_zod30.z.number().int().min(250).max(5e3),
-      reachedMaxItems: import_zod30.z.boolean(),
-      reachedReportedPostCount: import_zod30.z.boolean(),
-      finalScrollHeight: import_zod30.z.number().int().nullable(),
-      stoppedReason: import_zod30.z.enum(["max_items", "reported_post_count", "stable_scrolls", "max_scrolls", "no_scrolls"]),
-      stages: import_zod30.z.array(import_zod30.z.object({
-        stage: import_zod30.z.string(),
-        itemCount: import_zod30.z.number().int().min(0),
-        addedCount: import_zod30.z.number().int().min(0),
-        scrollY: import_zod30.z.number().nullable(),
-        scrollHeight: import_zod30.z.number().nullable()
+      profileSource: import_zod31.z.literal("hosted"),
+      profileDirConfigured: import_zod31.z.boolean(),
+      executablePathConfigured: import_zod31.z.boolean()
+    });
+    InstagramPaginationOutput = import_zod31.z.object({
+      maxItems: import_zod31.z.number().int().min(1).max(2e3),
+      maxScrolls: import_zod31.z.number().int().min(0).max(250),
+      attemptedScrolls: import_zod31.z.number().int().min(0),
+      stableScrolls: import_zod31.z.number().int().min(0),
+      stableScrollLimit: import_zod31.z.number().int().min(1).max(10),
+      scrollDelayMs: import_zod31.z.number().int().min(250).max(5e3),
+      reachedMaxItems: import_zod31.z.boolean(),
+      reachedReportedPostCount: import_zod31.z.boolean(),
+      finalScrollHeight: import_zod31.z.number().int().nullable(),
+      stoppedReason: import_zod31.z.enum(["max_items", "reported_post_count", "stable_scrolls", "max_scrolls", "no_scrolls"]),
+      stages: import_zod31.z.array(import_zod31.z.object({
+        stage: import_zod31.z.string(),
+        itemCount: import_zod31.z.number().int().min(0),
+        addedCount: import_zod31.z.number().int().min(0),
+        scrollY: import_zod31.z.number().nullable(),
+        scrollHeight: import_zod31.z.number().nullable()
       }))
     });
     InstagramProfileContentOutputSchema = {
-      handle: import_zod30.z.string(),
-      profileUrl: import_zod30.z.string().url(),
-      pageUrl: import_zod30.z.string().url(),
+      handle: import_zod31.z.string(),
+      profileUrl: import_zod31.z.string().url(),
+      pageUrl: import_zod31.z.string().url(),
       browser: InstagramBrowserOutput,
       profileName: NullableString,
-      reportedPostCount: import_zod30.z.number().int().nullable(),
+      reportedPostCount: import_zod31.z.number().int().nullable(),
       reportedPostCountText: NullableString,
       followerCountText: NullableString,
       followingCountText: NullableString,
-      collectedContentCount: import_zod30.z.number().int().min(0),
-      typeCounts: import_zod30.z.object({
-        post: import_zod30.z.number().int().min(0),
-        reel: import_zod30.z.number().int().min(0),
-        tv: import_zod30.z.number().int().min(0)
+      collectedContentCount: import_zod31.z.number().int().min(0),
+      typeCounts: import_zod31.z.object({
+        post: import_zod31.z.number().int().min(0),
+        reel: import_zod31.z.number().int().min(0),
+        tv: import_zod31.z.number().int().min(0)
       }),
       pagination: InstagramPaginationOutput,
-      limited: import_zod30.z.boolean(),
-      limitations: import_zod30.z.array(import_zod30.z.string()),
-      items: import_zod30.z.array(import_zod30.z.object({
-        url: import_zod30.z.string().url(),
-        type: import_zod30.z.enum(["post", "reel", "tv"]),
-        shortcode: import_zod30.z.string(),
+      limited: import_zod31.z.boolean(),
+      limitations: import_zod31.z.array(import_zod31.z.string()),
+      items: import_zod31.z.array(import_zod31.z.object({
+        url: import_zod31.z.string().url(),
+        type: import_zod31.z.enum(["post", "reel", "tv"]),
+        shortcode: import_zod31.z.string(),
         anchorText: NullableString,
-        firstSeenStage: import_zod30.z.string()
+        firstSeenStage: import_zod31.z.string()
       }))
     };
-    InstagramMediaTrackOutput = import_zod30.z.object({
-      url: import_zod30.z.string().url(),
-      streamType: import_zod30.z.enum(["video", "audio", "unknown"]),
-      bitrate: import_zod30.z.number().int().nullable(),
-      durationSec: import_zod30.z.number().nullable(),
+    InstagramMediaTrackOutput = import_zod31.z.object({
+      url: import_zod31.z.string().url(),
+      streamType: import_zod31.z.enum(["video", "audio", "unknown"]),
+      bitrate: import_zod31.z.number().int().nullable(),
+      durationSec: import_zod31.z.number().nullable(),
       vencodeTag: NullableString,
-      width: import_zod30.z.number().int().nullable(),
-      height: import_zod30.z.number().int().nullable()
+      width: import_zod31.z.number().int().nullable(),
+      height: import_zod31.z.number().int().nullable()
     });
-    InstagramDownloadOutput = import_zod30.z.object({
-      kind: import_zod30.z.enum(["text", "image", "video", "audio", "muxed_video"]),
-      url: import_zod30.z.string().url().nullable(),
+    InstagramDownloadOutput = import_zod31.z.object({
+      kind: import_zod31.z.enum(["text", "image", "video", "audio", "muxed_video"]),
+      url: import_zod31.z.string().url().nullable(),
       savedPath: NullableString,
-      sizeBytes: import_zod30.z.number().int().nullable(),
+      sizeBytes: import_zod31.z.number().int().nullable(),
       mimeType: NullableString,
       error: NullableString
     });
     InstagramMediaDownloadOutputSchema = {
-      sourceUrl: import_zod30.z.string().url(),
-      pageUrl: import_zod30.z.string().url(),
+      sourceUrl: import_zod31.z.string().url(),
+      pageUrl: import_zod31.z.string().url(),
       browser: InstagramBrowserOutput,
-      type: import_zod30.z.enum(["post", "reel", "tv"]).nullable(),
+      type: import_zod31.z.enum(["post", "reel", "tv"]).nullable(),
       shortcode: NullableString,
       ownerName: NullableString,
       caption: NullableString,
-      imageUrl: import_zod30.z.string().url().nullable(),
-      trackCount: import_zod30.z.number().int().min(0),
+      imageUrl: import_zod31.z.string().url().nullable(),
+      trackCount: import_zod31.z.number().int().min(0),
       selectedVideoTrack: InstagramMediaTrackOutput.nullable(),
       selectedAudioTrack: InstagramMediaTrackOutput.nullable(),
-      downloads: import_zod30.z.array(InstagramDownloadOutput),
+      downloads: import_zod31.z.array(InstagramDownloadOutput),
       outputDir: NullableString,
-      warnings: import_zod30.z.array(import_zod30.z.string()),
-      limitations: import_zod30.z.array(import_zod30.z.string()),
-      transcript: import_zod30.z.object({
-        wordCount: import_zod30.z.number().int().min(0),
-        chunkCount: import_zod30.z.number().int().min(0),
-        durationMs: import_zod30.z.number().nullable(),
-        transcriptText: import_zod30.z.string(),
-        chunks: import_zod30.z.array(TranscriptChunkOutput)
+      warnings: import_zod31.z.array(import_zod31.z.string()),
+      limitations: import_zod31.z.array(import_zod31.z.string()),
+      transcript: import_zod31.z.object({
+        wordCount: import_zod31.z.number().int().min(0),
+        chunkCount: import_zod31.z.number().int().min(0),
+        durationMs: import_zod31.z.number().nullable(),
+        transcriptText: import_zod31.z.string(),
+        chunks: import_zod31.z.array(TranscriptChunkOutput)
       }).nullable()
     };
     YoutubeTranscribeOutputSchema = {
       videoId: NullableString,
       url: NullableString,
-      wordCount: import_zod30.z.number().int().min(0),
-      chunkCount: import_zod30.z.number().int().min(0),
-      durationMs: import_zod30.z.number().nullable(),
-      transcriptText: import_zod30.z.string(),
-      chunks: import_zod30.z.array(TranscriptChunkOutput),
-      resolvedInputs: import_zod30.z.object({
+      wordCount: import_zod31.z.number().int().min(0),
+      chunkCount: import_zod31.z.number().int().min(0),
+      durationMs: import_zod31.z.number().nullable(),
+      transcriptText: import_zod31.z.string(),
+      chunks: import_zod31.z.array(TranscriptChunkOutput),
+      resolvedInputs: import_zod31.z.object({
         videoId: NullableString,
         url: NullableString
       })
     };
     FacebookAdTranscribeOutputSchema = {
-      videoUrl: import_zod30.z.string().url(),
-      wordCount: import_zod30.z.number().int().min(0),
-      chunkCount: import_zod30.z.number().int().min(0),
-      durationMs: import_zod30.z.number().nullable(),
-      transcriptText: import_zod30.z.string(),
-      chunks: import_zod30.z.array(TranscriptChunkOutput),
-      resolvedInputs: import_zod30.z.object({
-        videoUrl: import_zod30.z.string().url()
+      videoUrl: import_zod31.z.string().url(),
+      wordCount: import_zod31.z.number().int().min(0),
+      chunkCount: import_zod31.z.number().int().min(0),
+      durationMs: import_zod31.z.number().nullable(),
+      transcriptText: import_zod31.z.string(),
+      chunks: import_zod31.z.array(TranscriptChunkOutput),
+      resolvedInputs: import_zod31.z.object({
+        videoUrl: import_zod31.z.string().url()
       })
     };
     GoogleAdsTranscribeOutputSchema = {
-      videoUrl: import_zod30.z.string().url(),
-      wordCount: import_zod30.z.number().int().min(0),
-      chunkCount: import_zod30.z.number().int().min(0),
-      durationMs: import_zod30.z.number().nullable(),
-      transcriptText: import_zod30.z.string(),
-      chunks: import_zod30.z.array(TranscriptChunkOutput),
-      resolvedInputs: import_zod30.z.object({
-        videoUrl: import_zod30.z.string().url()
+      videoUrl: import_zod31.z.string().url(),
+      wordCount: import_zod31.z.number().int().min(0),
+      chunkCount: import_zod31.z.number().int().min(0),
+      durationMs: import_zod31.z.number().nullable(),
+      transcriptText: import_zod31.z.string(),
+      chunks: import_zod31.z.array(TranscriptChunkOutput),
+      resolvedInputs: import_zod31.z.object({
+        videoUrl: import_zod31.z.string().url()
       })
     };
     CaptureSerpSnapshotOutputSchema = {
-      schemaVersion: import_zod30.z.literal("serp-intelligence.capture.v1"),
-      status: import_zod30.z.string(),
+      schemaVersion: import_zod31.z.literal("serp-intelligence.capture.v1"),
+      status: import_zod31.z.string(),
       query: NullableString,
       location: NullableString,
       capturedAt: NullableString,
-      resultCount: import_zod30.z.number().int().min(0).nullable(),
+      resultCount: import_zod31.z.number().int().min(0).nullable(),
       snapshotId: NullableString,
-      resolvedInputs: import_zod30.z.record(import_zod30.z.unknown()),
-      artifacts: import_zod30.z.array(import_zod30.z.record(import_zod30.z.unknown())),
-      diagnostics: import_zod30.z.record(import_zod30.z.unknown()).nullable(),
-      providerPayload: import_zod30.z.record(import_zod30.z.unknown())
+      resolvedInputs: import_zod31.z.record(import_zod31.z.unknown()),
+      artifacts: import_zod31.z.array(import_zod31.z.record(import_zod31.z.unknown())),
+      diagnostics: import_zod31.z.record(import_zod31.z.unknown()).nullable(),
+      providerPayload: import_zod31.z.record(import_zod31.z.unknown())
     };
     CaptureSerpPageSnapshotsOutputSchema = {
-      schemaVersion: import_zod30.z.literal("serp-intelligence.page-snapshots.v1"),
-      status: import_zod30.z.string(),
-      count: import_zod30.z.number().int().min(0),
-      failedCount: import_zod30.z.number().int().min(0),
-      captures: import_zod30.z.array(import_zod30.z.record(import_zod30.z.unknown())),
-      resolvedInputs: import_zod30.z.record(import_zod30.z.unknown()),
-      diagnostics: import_zod30.z.record(import_zod30.z.unknown()).nullable(),
-      providerPayload: import_zod30.z.record(import_zod30.z.unknown())
+      schemaVersion: import_zod31.z.literal("serp-intelligence.page-snapshots.v1"),
+      status: import_zod31.z.string(),
+      count: import_zod31.z.number().int().min(0),
+      failedCount: import_zod31.z.number().int().min(0),
+      captures: import_zod31.z.array(import_zod31.z.record(import_zod31.z.unknown())),
+      resolvedInputs: import_zod31.z.record(import_zod31.z.unknown()),
+      diagnostics: import_zod31.z.record(import_zod31.z.unknown()).nullable(),
+      providerPayload: import_zod31.z.record(import_zod31.z.unknown())
     };
     CreditsInfoInputSchema = {
-      item: import_zod30.z.string().optional().describe('Optional tool, action, or feature to look up, e.g. "maps reviews", "extract_url", "YouTube transcription", or "concurrency"'),
-      includeLedger: import_zod30.z.boolean().default(false).describe("Whether to include recent credit ledger entries")
+      item: import_zod31.z.string().optional().describe('Optional tool, action, or feature to look up, e.g. "maps reviews", "extract_url", "YouTube transcription", or "concurrency"'),
+      includeLedger: import_zod31.z.boolean().default(false).describe("Whether to include recent credit ledger entries")
     };
-    WorkflowIdSchema2 = import_zod30.z.enum([
+    WorkflowIdSchema2 = import_zod31.z.enum([
       "directory",
       "get-leads",
       "agent-packet",
@@ -26408,129 +26744,129 @@ var init_mcp_tool_schemas = __esm({
       "ai-overview-language"
     ]);
     WorkflowListInputSchema = {
-      includeRecipes: import_zod30.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_zod31.z.boolean().default(true).describe("Include high-level AI-facing recipes (market analysis, ICP research, CRO audits, content gaps, etc).")
     };
     WorkflowSuggestInputSchema = {
-      goal: import_zod30.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_zod30.z.string().optional().describe("Business category, niche, or Maps query when known."),
-      keyword: import_zod30.z.string().optional().describe("Search keyword, audience problem, or content topic when known."),
-      domain: import_zod30.z.string().optional().describe("Target domain or brand domain when known."),
-      url: import_zod30.z.string().url().optional().describe("Target URL when the workflow should inspect a specific page."),
-      location: import_zod30.z.string().optional().describe("City/region/country for localized research, e.g. Denver, CO."),
-      state: import_zod30.z.string().optional().describe("US state abbreviation or name for state-wide market research."),
-      maxSuggestions: import_zod30.z.number().int().min(1).max(8).default(3).describe("Number of matching workflow recipes to return.")
+      goal: import_zod31.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_zod31.z.string().optional().describe("Business category, niche, or Maps query when known."),
+      keyword: import_zod31.z.string().optional().describe("Search keyword, audience problem, or content topic when known."),
+      domain: import_zod31.z.string().optional().describe("Target domain or brand domain when known."),
+      url: import_zod31.z.string().url().optional().describe("Target URL when the workflow should inspect a specific page."),
+      location: import_zod31.z.string().optional().describe("City/region/country for localized research, e.g. Denver, CO."),
+      state: import_zod31.z.string().optional().describe("US state abbreviation or name for state-wide market research."),
+      maxSuggestions: import_zod31.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, get-leads, 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_zod30.z.record(import_zod30.z.unknown()).default({}).describe("Workflow-specific input object. Examples: get-leads uses {query, location, maxResults?, enrichWebsites?, hydrateReviewCounts?}; 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_zod30.z.string().url().optional().describe("Optional HTTPS webhook to receive the completed hosted workflow run event.")
+      workflowId: WorkflowIdSchema2.describe("Workflow to run. Call workflow_list or workflow_suggest first when unsure."),
+      input: import_zod31.z.record(import_zod31.z.unknown()).default({}).describe("Workflow-specific input object; shape depends on workflowId. Call workflow_list or workflow_suggest to see required fields."),
+      webhookUrl: import_zod31.z.string().url().optional().describe("Optional HTTPS webhook to receive the completed hosted workflow run event.")
     };
     WorkflowStepInputSchema = {
-      runId: import_zod30.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_zod31.z.string().min(1).describe("Workflow run id returned by workflow_run/workflow_step/workflow_status. Advances the run by exactly one step.")
     };
     WorkflowStatusInputSchema = {
-      runId: import_zod30.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_zod31.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_zod30.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_zod30.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_zod30.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_zod31.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_zod31.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_zod31.z.number().int().min(1e3).max(1e6).default(2e5).describe("Maximum bytes of artifact text to return inline.")
     };
-    WorkflowRecipeOutput = import_zod30.z.object({
-      id: import_zod30.z.string(),
-      title: import_zod30.z.string(),
-      description: import_zod30.z.string(),
-      primaryWorkflowId: import_zod30.z.string().nullable(),
-      recommendedTools: import_zod30.z.array(import_zod30.z.string()),
-      requiredInputs: import_zod30.z.array(import_zod30.z.string()),
-      optionalInputs: import_zod30.z.array(import_zod30.z.string()),
-      produces: import_zod30.z.array(import_zod30.z.string()),
-      runHint: import_zod30.z.string()
-    });
-    WorkflowDefinitionOutput = import_zod30.z.object({
-      id: import_zod30.z.string(),
-      title: import_zod30.z.string(),
-      description: import_zod30.z.string()
+    WorkflowRecipeOutput = import_zod31.z.object({
+      id: import_zod31.z.string(),
+      title: import_zod31.z.string(),
+      description: import_zod31.z.string(),
+      primaryWorkflowId: import_zod31.z.string().nullable(),
+      recommendedTools: import_zod31.z.array(import_zod31.z.string()),
+      requiredInputs: import_zod31.z.array(import_zod31.z.string()),
+      optionalInputs: import_zod31.z.array(import_zod31.z.string()),
+      produces: import_zod31.z.array(import_zod31.z.string()),
+      runHint: import_zod31.z.string()
+    });
+    WorkflowDefinitionOutput = import_zod31.z.object({
+      id: import_zod31.z.string(),
+      title: import_zod31.z.string(),
+      description: import_zod31.z.string()
     });
-    WorkflowArtifactOutput = import_zod30.z.record(import_zod30.z.unknown());
+    WorkflowArtifactOutput = import_zod31.z.record(import_zod31.z.unknown());
     WorkflowListOutputSchema = {
-      workflows: import_zod30.z.array(WorkflowDefinitionOutput),
-      recipes: import_zod30.z.array(WorkflowRecipeOutput)
+      workflows: import_zod31.z.array(WorkflowDefinitionOutput),
+      recipes: import_zod31.z.array(WorkflowRecipeOutput)
     };
     WorkflowSuggestOutputSchema = {
-      goal: import_zod30.z.string(),
-      suggestions: import_zod30.z.array(WorkflowRecipeOutput)
+      goal: import_zod31.z.string(),
+      suggestions: import_zod31.z.array(WorkflowRecipeOutput)
     };
     WorkflowRunOutputSchema = {
-      workflowId: import_zod30.z.string(),
-      input: import_zod30.z.record(import_zod30.z.unknown()),
-      run: import_zod30.z.record(import_zod30.z.unknown()).optional(),
-      summary: import_zod30.z.record(import_zod30.z.unknown()).optional(),
-      step: import_zod30.z.record(import_zod30.z.unknown()).optional(),
-      nextStep: import_zod30.z.record(import_zod30.z.unknown()).nullable().optional(),
-      done: import_zod30.z.boolean().optional(),
-      artifacts: import_zod30.z.array(WorkflowArtifactOutput)
+      workflowId: import_zod31.z.string(),
+      input: import_zod31.z.record(import_zod31.z.unknown()),
+      run: import_zod31.z.record(import_zod31.z.unknown()).optional(),
+      summary: import_zod31.z.record(import_zod31.z.unknown()).optional(),
+      step: import_zod31.z.record(import_zod31.z.unknown()).optional(),
+      nextStep: import_zod31.z.record(import_zod31.z.unknown()).nullable().optional(),
+      done: import_zod31.z.boolean().optional(),
+      artifacts: import_zod31.z.array(WorkflowArtifactOutput)
     };
     WorkflowStepOutputSchema = {
-      runId: import_zod30.z.string(),
-      run: import_zod30.z.record(import_zod30.z.unknown()).optional(),
-      summary: import_zod30.z.record(import_zod30.z.unknown()).nullable().optional(),
-      step: import_zod30.z.record(import_zod30.z.unknown()).optional(),
-      nextStep: import_zod30.z.record(import_zod30.z.unknown()).nullable().optional(),
-      done: import_zod30.z.boolean(),
-      artifacts: import_zod30.z.array(WorkflowArtifactOutput)
+      runId: import_zod31.z.string(),
+      run: import_zod31.z.record(import_zod31.z.unknown()).optional(),
+      summary: import_zod31.z.record(import_zod31.z.unknown()).nullable().optional(),
+      step: import_zod31.z.record(import_zod31.z.unknown()).optional(),
+      nextStep: import_zod31.z.record(import_zod31.z.unknown()).nullable().optional(),
+      done: import_zod31.z.boolean(),
+      artifacts: import_zod31.z.array(WorkflowArtifactOutput)
     };
     WorkflowStatusOutputSchema = {
-      run: import_zod30.z.record(import_zod30.z.unknown()).optional(),
-      artifacts: import_zod30.z.array(WorkflowArtifactOutput)
+      run: import_zod31.z.record(import_zod31.z.unknown()).optional(),
+      artifacts: import_zod31.z.array(WorkflowArtifactOutput)
     };
     WorkflowArtifactReadOutputSchema = {
-      runId: import_zod30.z.string(),
-      artifactId: import_zod30.z.string(),
-      contentType: import_zod30.z.string(),
-      bytes: import_zod30.z.number().int().min(0),
-      truncated: import_zod30.z.boolean(),
-      text: import_zod30.z.string()
+      runId: import_zod31.z.string(),
+      artifactId: import_zod31.z.string(),
+      contentType: import_zod31.z.string(),
+      bytes: import_zod31.z.number().int().min(0),
+      truncated: import_zod31.z.boolean(),
+      text: import_zod31.z.string()
     };
     SearchSerpInputSchema = {
-      query: import_zod30.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_zod30.z.string().optional().describe("City, region, or country for geo-targeted results, inferred from user request when present."),
-      gl: import_zod30.z.string().length(2).default("us").describe("Google country code inferred from location or user language."),
-      hl: import_zod30.z.string().default("en").describe("Google interface/content language inferred from user request."),
-      device: import_zod30.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_zod30.z.enum(["location", "configured", "none"]).default(DEFAULT_PROXY_MODE).describe('Leave unset \u2014 routing is automatic. Set "location" only to force local-pack targeting.'),
-      proxyZip: import_zod30.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_zod30.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_zod30.z.number().int().min(1).max(2).default(1).describe("Number of result pages to fetch (1\u20132)")
+      query: import_zod31.z.string().min(1).describe('The search query. KEEP the place in the query text for localized results (e.g. "best dentist Brooklyn NY") and also set location \u2014 city-in-query is what localizes reliably.'),
+      location: import_zod31.z.string().optional().describe("City, region, or country for geo signals. Set alongside city-in-query wording; alone it does NOT reliably localize."),
+      gl: import_zod31.z.string().length(2).default("us").describe("Google country code inferred from location or user language."),
+      hl: import_zod31.z.string().default("en").describe("Google interface/content language inferred from user request."),
+      device: import_zod31.z.enum(["desktop", "mobile"]).default("desktop").describe("SERP device context. Use mobile only for mobile rankings."),
+      proxyMode: import_zod31.z.enum(["location", "configured", "none"]).default(DEFAULT_PROXY_MODE).describe('Leave unset (clean egress). Do NOT set "location" just because a city was named \u2014 that comes from city-in-query wording. "location" forces residential geo-IP for rank-tracking fidelity, is frequently CAPTCHA-blocked, and accepts failures.'),
+      proxyZip: import_zod31.z.string().regex(/^\d{5}$/).optional().describe('US ZIP for residential geo-IP targeting. Only meaningful with proxyMode "location".'),
+      debug: import_zod31.z.boolean().default(false).describe("Include sanitized diagnostics for debugging localization, CAPTCHA, or proxy behavior."),
+      pages: import_zod31.z.number().int().min(1).max(2).default(1).describe("Number of result pages to fetch (1\u20132).")
     };
     CaptureSerpSnapshotInputSchema = {
-      query: import_zod30.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_zod30.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_zod30.z.string().length(2).default("us").describe("Google country code inferred from the requested market, e.g. us, gb, ca, au."),
-      hl: import_zod30.z.string().default("en").describe("Google interface/content language inferred from the user request."),
-      device: import_zod30.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_zod30.z.enum(["location", "configured", "none"]).default(DEFAULT_PROXY_MODE).describe('Leave unset \u2014 routing is automatic. Set "location" only to force city/ZIP targeting.'),
-      proxyZip: import_zod30.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_zod30.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_zod30.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_zod30.z.boolean().default(false).describe("Also capture ranking-page snapshots for selected SERP URLs through the same product capture path."),
-      pageSnapshotLimit: import_zod30.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_zod31.z.string().min(1).describe('Search query to capture. KEEP the place in the query text for localized captures (e.g. "botox clinic austin tx") and also set location.'),
+      location: import_zod31.z.string().optional().describe("City, region, country, or service area for localized Google results."),
+      gl: import_zod31.z.string().length(2).default("us").describe("Google country code inferred from the requested market."),
+      hl: import_zod31.z.string().default("en").describe("Google interface/content language inferred from the user request."),
+      device: import_zod31.z.enum(["desktop", "mobile"]).default("desktop").describe("SERP device context. Use mobile only for mobile rankings/evidence."),
+      proxyMode: import_zod31.z.enum(["location", "configured", "none"]).default(DEFAULT_PROXY_MODE).describe('Leave unset (clean egress). Do NOT set "location" just because a city was named \u2014 that comes from city-in-query wording. "location" forces residential geo-IP, is frequently CAPTCHA-blocked, and accepts failures.'),
+      proxyZip: import_zod31.z.string().regex(/^\d{5}$/).optional().describe('US ZIP for residential geo-IP targeting. Only meaningful with proxyMode "location".'),
+      pages: import_zod31.z.number().int().min(1).max(2).default(1).describe("Google result pages to capture. Use 2 only for deeper ranking evidence."),
+      debug: import_zod31.z.boolean().default(false).describe("Include sanitized browser/proxy/location diagnostics."),
+      includePageSnapshots: import_zod31.z.boolean().default(false).describe("Also capture ranking-page snapshots for selected SERP URLs."),
+      pageSnapshotLimit: import_zod31.z.number().int().min(0).max(10).default(0).describe("Maximum ranking-page snapshots when includePageSnapshots is true.")
     };
     ScreenshotInputSchema = {
-      url: import_zod30.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_zod30.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_zod30.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_zod31.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_zod31.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_zod31.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_zod30.z.array(import_zod30.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_zod30.z.array(import_zod30.z.object({
-        url: import_zod30.z.string().url().describe("Public HTTP/HTTPS URL to capture."),
-        sourceKind: import_zod30.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_zod30.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_zod30.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_zod30.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_zod30.z.boolean().default(false).describe("Include sanitized browser/proxy diagnostics for page snapshot debugging. Use true for capture, network, or proxy troubleshooting.")
+      urls: import_zod31.z.array(import_zod31.z.string().url()).min(1).max(25).describe("Public HTTP/HTTPS URLs to capture. Do not pass localhost, private IPs, file URLs, or internal admin URLs."),
+      targets: import_zod31.z.array(import_zod31.z.object({
+        url: import_zod31.z.string().url().describe("Public HTTP/HTTPS URL to capture."),
+        sourceKind: import_zod31.z.enum(["organic", "ai_citation", "local_pack_website", "configured_target", "site_subject"]).default("configured_target").describe("Why this page is being captured."),
+        sourcePosition: import_zod31.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 targets. Use instead of urls when source kind or position should be preserved."),
+      maxConcurrency: import_zod31.z.number().int().min(1).max(5).default(2).describe("Parallel page captures."),
+      timeoutMs: import_zod31.z.number().int().min(1e3).max(6e4).default(15e3).describe("Per-page capture timeout in milliseconds; timeouts return as structured capture failures."),
+      debug: import_zod31.z.boolean().default(false).describe("Include sanitized browser/proxy diagnostics.")
     };
   }
 });
@@ -26877,14 +27213,14 @@ function liveWebToolAnnotations(title) {
 function registerSerpIntelligenceCaptureTools(server, executor) {
   server.registerTool("capture_serp_snapshot", {
     title: "SERP Intelligence Snapshot",
-    description: "Capture a structured SERP Intelligence Google snapshot through POST /serp-intelligence/capture, the same product capture path used by Phoenix. Split query from location and infer gl/hl. Routing is automatic \u2014 leave proxyMode unset. Set debug true when investigating location evidence, proxy behavior, CAPTCHA, or capture reliability.",
+    description: "Capture a structured SERP Intelligence Google snapshot (the product capture path used by Phoenix). Split query from location; leave proxyMode unset.",
     inputSchema: CaptureSerpSnapshotInputSchema,
     outputSchema: CaptureSerpSnapshotOutputSchema,
     annotations: liveWebToolAnnotations("SERP Intelligence Snapshot")
   }, async (input) => formatCaptureSerpSnapshot(await executor.captureSerpSnapshot(input), input));
   server.registerTool("capture_serp_page_snapshots", {
     title: "SERP Intelligence Page Snapshots",
-    description: "Capture public ranking-page evidence through POST /serp-intelligence/page-snapshots, the same product page snapshot path used by Phoenix. Provide urls for simple captures or targets when preserving organic, AI citation, local-pack, configured target, or site-subject source metadata. Private IPs, localhost, file URLs, and internal URLs are rejected by the service. Use timeoutMs for slow pages and debug true for sanitized proxy/browser diagnostics.",
+    description: "Capture public ranking-page evidence as SERP Intelligence page snapshots (the product path used by Phoenix). Provide urls, or targets to preserve source metadata. Private IPs, localhost, file, and internal URLs are rejected.",
     inputSchema: CaptureSerpPageSnapshotsInputSchema,
     outputSchema: CaptureSerpPageSnapshotsOutputSchema,
     annotations: liveWebToolAnnotations("SERP Intelligence Page Snapshots")
@@ -26945,203 +27281,217 @@ function registerPaaExtractorMcpTools(server, executor, options = {}) {
   if (savesReports) registerSavedReportResources(server);
   server.registerTool("harvest_paa", {
     title: "Google PAA + SERP Harvest",
-    description: withReportNote('Best default tool for Google search research. Extracts People Also Ask questions plus answers/source URLs, organic SERP, local pack when present, entity IDs (CID/GCID/KG MID), and AI Overview. Infer the user language: split topic from location (e.g. "best hvac company in Denver CO" => query "best hvac company", location "Denver, CO", gl "us", hl "en"). Routing is automatic \u2014 leave proxyMode unset. If a deep harvest exceeds the time budget it returns the questions gathered so far (partial), billed per returned question. Use maxQuestions 30 normally, 100-200 for "full", "deep", "all", or comprehensive research. Deep harvests above 100 questions can run for several minutes with no interim progress \u2014 warn the user before starting one and keep maxQuestions at or below 100 unless they explicitly want a deep harvest. Credits are charged by extracted question; unused request hold is refunded.'),
+    description: withReportNote("Best default tool for Google search research: People Also Ask questions with answers/sources, organic SERP, local pack, entity IDs, and AI Overview. Split topic from location; leave proxyMode unset. Warn the user before maxQuestions above 100 \u2014 deep harvests can run several minutes with no interim progress, billed per extracted question."),
     inputSchema: HarvestPaaInputSchema,
     outputSchema: HarvestPaaOutputSchema,
     annotations: liveWebToolAnnotations("Google PAA + SERP Harvest")
   }, async (input) => formatHarvestPaa(await executor.harvestPaa(input), input));
   server.registerTool("search_serp", {
     title: "Google SERP Lookup",
-    description: withReportNote("Fast Google SERP lookup without PAA expansion. Use when the user asks for rankings, organic results, local pack, quick SERP, or positions. Split topic from location and infer gl/hl from the user request. Routing is automatic \u2014 leave proxyMode unset; set location only to force local-pack targeting."),
+    description: withReportNote("Fast Google SERP lookup without PAA expansion \u2014 rankings, organic results, local pack, positions. Split topic from location; leave proxyMode unset."),
     inputSchema: SearchSerpInputSchema,
     outputSchema: SearchSerpOutputSchema,
     annotations: liveWebToolAnnotations("Google SERP Lookup")
   }, async (input) => formatSearchSerp(await executor.searchSerp(input), input));
   server.registerTool("extract_url", {
     title: "Single URL Extract",
-    description: withReportNote("Extract structured data from one public URL when the user provides one page, asks to inspect/scrape a page, or needs page content, schema, headings, metadata, screenshots, branding, or media assets. Returns structured page fields plus artifact handles for saved reports/screenshots/media when requested. Set depositToVault:true to also save the full page into the user's MCP Memory vault server-side (the full body is NOT returned to chat). Use map_site_urls before extracting a site inventory; use extract_site for multi-page crawling."),
+    description: withReportNote("Extract structured data from one public URL: content, schema, headings, metadata, screenshots, branding, or media assets. Set depositToVault:true to save the full page into the user's MCP Memory vault server-side (not returned to chat)."),
     inputSchema: ExtractUrlInputSchema,
     outputSchema: ExtractUrlOutputSchema,
     annotations: liveWebToolAnnotations("Single URL Extract")
   }, async (input) => formatExtractUrl(await executor.extractUrl(input), input));
   server.registerTool("map_site_urls", {
     title: "Site URL Map",
-    description: withReportNote("Map/crawl a public website when the user asks for a sitemap, URL inventory, broken-link scan, redirect scan, or crawl planning. Returns internal URLs with HTTP status and truncation metadata. Supports up to maxUrls=10000; maps over 500 URLs write the complete inventory to a local CSV file and return a summary plus the file path instead of the full list inline. Use this before extract_site when choosing pages for an audit; use extract_url for one known page."),
+    description: withReportNote("Map/crawl a public website for a sitemap, URL inventory, or broken-link scan. Returns internal URLs with HTTP status; maps over 500 URLs are written to a local CSV file instead of inlined."),
     inputSchema: MapSiteUrlsInputSchema,
     outputSchema: MapSiteUrlsOutputSchema,
     annotations: liveWebToolAnnotations("Site URL Map")
   }, async (input) => formatMapSiteUrls(await executor.mapSiteUrls(input), input));
   server.registerTool("extract_site", {
     title: "Multi-Page Site Content Crawl",
-    description: withReportNote("Crawl a public website and return the page CONTENT across multiple pages (map + scrape). Returns per-page titles and Markdown content. Supports up to maxPages=10000; bulk crawls over 25 pages switch to folder mode: each page is saved as its own Markdown file in a local folder and the response returns a summary plus the folder path instead of inlining all content. This tool returns content only \u2014 for a technical SEO audit (issues, internal link graph, indexability, heading breakdown, image sizes/formats) use audit_site. Use map_site_urls first when URL selection matters; use extract_url for one page."),
+    description: withReportNote("Crawl a public website and return page CONTENT (Markdown) across multiple pages. Bulk crawls over 25 pages are saved as per-page Markdown files in a local folder instead of inlined. Content only \u2014 for a technical SEO audit use audit_site instead."),
     inputSchema: ExtractSiteInputSchema,
     outputSchema: ExtractSiteOutputSchema,
     annotations: liveWebToolAnnotations("Multi-Page Site Content Crawl")
   }, async (input) => formatExtractSite(await executor.extractSite(input), input));
   server.registerTool("audit_site", {
     title: "Technical SEO Audit",
-    description: withReportNote("Run a full technical SEO audit (Screaming-Frog-style) on a public website. Crawls up to maxPages and produces a complete on-page + crawl analysis: per-page title/meta lengths, heading breakdown, indexability and canonical status, schema, an internal link graph (inlinks/orphans/crawl-depth), a link analysis (top internal pages by inlinks, top external domains by link count, broken/orphan counts), an issues report, and an image audit (byte size, format, over-100KB and legacy-format flags). Writes everything to a local folder (report.md, issues.json, pages.jsonl, links.jsonl, link-metrics.jsonl, link-report.md, links-summary.json, external-domains.json, images.jsonl) plus per-page content, and returns a headline summary plus the folder path. Use this when the user wants an audit or analysis; use extract_site when they just want page content."),
+    description: withReportNote("Run a full technical SEO audit (Screaming-Frog-style) on a public website: on-page issues, internal link graph, indexability, heading/image analysis. Writes a folder of analysis files plus per-page content, and returns a summary plus the folder path. Use extract_site instead for plain page content."),
     inputSchema: AuditSiteInputSchema,
     outputSchema: AuditSiteOutputSchema,
     annotations: liveWebToolAnnotations("Technical SEO Audit")
   }, async (input) => formatAuditSite(await executor.auditSite(input), input));
   server.registerTool("youtube_harvest", {
     title: "YouTube Video Harvest",
-    description: withReportNote('Harvest YouTube video metadata when the user wants to find videos by topic, inspect a channel library, compare video angles, or get videoIds for later transcription. Use mode "search" for keyword/topic requests and mode "channel" for @handles, channel IDs, or channel URLs. Returns titles, views, durations, URLs, and videoIds for follow-up transcription. Use youtube_transcribe after selecting one video.'),
+    description: withReportNote('Harvest YouTube video metadata by topic search or channel library. Use mode "search" for keyword/topic requests, mode "channel" for @handles/channel IDs/URLs. Returns titles, views, durations, and videoIds.'),
     inputSchema: YoutubeHarvestInputSchema,
     outputSchema: YoutubeHarvestOutputSchema,
     annotations: liveWebToolAnnotations("YouTube Video Harvest")
   }, async (input) => formatYoutubeHarvest(await executor.youtubeHarvest(input), input));
   server.registerTool("youtube_transcribe", {
     title: "YouTube Transcription",
-    description: withReportNote("Fetch and transcribe captions from a YouTube video. Use this when the user asks what was said in a YouTube video, wants claims/offers/lessons extracted from a video, or provides a YouTube URL for transcript work. Returns full transcript, timestamped chunks, word count, and resolvedInputs. Pass videoId from youtube_harvest results, or pass url when the user pasted a YouTube URL. Use youtube_harvest first when you need to discover videos by topic/channel."),
+    description: withReportNote("Fetch and transcribe captions from a YouTube video. Pass videoId from youtube_harvest, or a url the user pasted. Returns full transcript, timestamped chunks, and word count."),
     inputSchema: YoutubeTranscribeInputSchema,
     outputSchema: YoutubeTranscribeOutputSchema,
     annotations: liveWebToolAnnotations("YouTube Transcription")
   }, async (input) => formatYoutubeTranscribe(await executor.youtubeTranscribe(input), input));
   server.registerTool("facebook_page_intel", {
     title: "Facebook Advertiser Ad Intel",
-    description: withReportNote("Harvest ads from a Facebook advertiser when the user wants current ad copy, creative angles, CTAs, video URLs, or competitive ad intelligence for one brand/page. Returns ad copy, headlines, CTAs, creative type, status, landing URLs, and direct ad video URLs ready for facebook_ad_transcribe. Accepts pageId, libraryId, or a brand/advertiser name as query. Use facebook_ad_search first when the advertiser handle is unknown. For normal public Facebook reels/posts/watch/share URLs, use facebook_video_transcribe instead."),
+    description: withReportNote("Harvest ads from a Facebook advertiser: copy, creative angles, CTAs, and direct video URLs ready for facebook_ad_transcribe. Accepts pageId, libraryId, or a brand/advertiser name."),
     inputSchema: FacebookPageIntelInputSchema,
     outputSchema: FacebookPageIntelOutputSchema,
     annotations: liveWebToolAnnotations("Facebook Advertiser Ad Intel")
   }, async (input) => formatFacebookPageIntel(await executor.facebookPageIntel(input), input));
   server.registerTool("facebook_ad_search", {
     title: "Facebook Ad Library Search",
-    description: withReportNote("Search Facebook Ad Library when the user wants to find advertisers by brand, competitor, niche, or keyword. Returns advertisers with ad counts and library IDs. Use this to discover competitor/page handles, then pass libraryId or pageId to facebook_page_intel for ad details."),
+    description: withReportNote("Search Facebook Ad Library to find advertisers by brand, competitor, niche, or keyword. Returns advertisers with ad counts and library IDs."),
     inputSchema: FacebookAdSearchInputSchema,
     outputSchema: FacebookAdSearchOutputSchema,
     annotations: liveWebToolAnnotations("Facebook Ad Library Search")
   }, async (input) => formatFacebookAdSearch(await executor.facebookAdSearch(input), input));
   server.registerTool("reddit_thread", {
     title: "Reddit Thread + Comments",
-    description: withReportNote("Capture a Reddit post and its comment tree from any reddit.com thread URL. Use this when the user wants Reddit comments, opinions, discussion, or audience voice from a specific thread (find threads first with search_serp, which surfaces reddit.com/comments links). Returns the post title, author, score, body, and a list of comments with author, score, nesting depth, and text. Handles Reddit's bot protection automatically (fetches via old.reddit through a residential proxy with retries); pass maxComments to cap the list."),
+    description: withReportNote("Capture a Reddit post and its comment tree from a reddit.com thread URL \u2014 comments, opinions, audience voice. Handles Reddit's bot protection automatically; pass maxComments to cap the list."),
     inputSchema: RedditThreadInputSchema,
     outputSchema: RedditThreadOutputSchema,
     annotations: liveWebToolAnnotations("Reddit Thread + Comments")
   }, async (input) => formatRedditThread(await executor.redditThread(input), input));
+  server.registerTool("video_frame_analysis", {
+    title: "Video Breakdown (frame-by-frame + transcript)",
+    description: "Produce a deep frame-by-frame + transcript breakdown of a video \u2014 pacing, hook, visual style, and how to replicate it. Pass a DIRECT video file URL (.mp4/.webm/.mov), not a page URL. Runs asynchronously and costs a flat $1 (refunded on failure): returns a runId immediately; poll video_frame_analysis_status until done.",
+    inputSchema: VideoFrameAnalysisInputSchema,
+    outputSchema: VideoFrameAnalysisOutputSchema,
+    annotations: { title: "Video Breakdown", readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true }
+  }, async (input) => executor.videoFrameAnalysis(input));
+  server.registerTool("video_frame_analysis_status", {
+    title: "Video Breakdown Status",
+    description: 'Check progress of a video breakdown started with video_frame_analysis, using its runId. Free to call. When status is "done" it returns the full report and vault path; stop polling on "done" or "failed".',
+    inputSchema: VideoFrameAnalysisStatusInputSchema,
+    outputSchema: VideoFrameAnalysisStatusOutputSchema,
+    annotations: { title: "Video Breakdown Status", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false }
+  }, async (input) => executor.videoFrameAnalysisStatus(input));
   server.registerTool("facebook_ad_transcribe", {
     title: "Facebook Ad Transcription",
-    description: "Transcribe audio from a Facebook ad video CDN URL. Use this when facebook_page_intel returned a direct videoUrl and the user asks what the ad says, what claims it makes, or wants ad-message extraction. Returns full transcript, timestamped chunks, word count, and resolvedInputs. Use only with the direct videoUrl value from facebook_page_intel results; do not pass public Facebook post/reel/share URLs. Use facebook_video_transcribe for organic Facebook URLs, and facebook_page_intel first when you only have a brand/page/ad library handle.",
+    description: "Transcribe audio from a Facebook ad video CDN URL returned by facebook_page_intel. Use only that direct videoUrl value \u2014 do not pass public Facebook post/reel/share URLs (use facebook_video_transcribe for those).",
     inputSchema: FacebookAdTranscribeInputSchema,
     outputSchema: FacebookAdTranscribeOutputSchema,
     annotations: liveWebToolAnnotations("Facebook Ad Transcription")
   }, async (input) => formatFacebookAdTranscribe(await executor.facebookAdTranscribe(input), input));
   server.registerTool("google_ads_search", {
     title: "Google Ads Transparency Search",
-    description: withReportNote("Search the Google Ads Transparency Center to find advertisers running Google ads (Search, Display, YouTube) by domain or brand/advertiser name. Pass a domain like getviktor.com to see every advertiser account pointing ads at that site, or an advertiser name. Returns advertisers with their advertiser ID and an approximate ad count. Use this to discover an advertiserId, then pass it (or the domain) to google_ads_page_intel for the actual ad creatives."),
+    description: withReportNote("Search the Google Ads Transparency Center to find advertisers by domain or brand name. Returns advertisers with advertiser ID and approximate ad count, to pass to google_ads_page_intel."),
     inputSchema: GoogleAdsSearchInputSchema,
     outputSchema: GoogleAdsSearchOutputSchema,
     annotations: liveWebToolAnnotations("Google Ads Transparency Search")
   }, async (input) => formatGoogleAdsSearch(await executor.googleAdsSearch(input), input));
   server.registerTool("google_ads_page_intel", {
     title: "Google Ads Advertiser Intel",
-    description: withReportNote("Harvest an advertiser's ads from the Google Ads Transparency Center when the user wants a competitor's Google/YouTube ad creatives, copy angles, image URLs, or video ads. Accepts an advertiserId (from google_ads_search) or a domain directly. Returns each creative's format (text/image/video), image URLs, landing info, a detail URL, and \u2014 for video ads \u2014 the YouTube video ID and/or a direct video URL ready for transcription. Use google_ads_search first when you only have a brand name. Transcribe video ads with google_ads_transcribe (video URL) or youtube_transcribe (YouTube ID)."),
+    description: withReportNote("Harvest an advertiser's ad creatives from the Google Ads Transparency Center: format, image URLs, and \u2014 for video ads \u2014 a YouTube video ID or direct video URL. Accepts advertiserId (from google_ads_search) or a domain."),
     inputSchema: GoogleAdsPageIntelInputSchema,
     outputSchema: GoogleAdsPageIntelOutputSchema,
     annotations: liveWebToolAnnotations("Google Ads Advertiser Intel")
   }, async (input) => formatGoogleAdsPageIntel(await executor.googleAdsPageIntel(input), input));
   server.registerTool("google_ads_transcribe", {
     title: "Google Ad Video Transcription",
-    description: "Transcribe audio from a Google video ad. Use this when google_ads_page_intel returned a direct videoUrl (a googlevideo.com playback URL) for a video creative and the user asks what the ad says or wants its claims/messaging. Returns full transcript, timestamped chunks, and word count. For YouTube-hosted ads, pass the returned youtubeVideoId to youtube_transcribe instead; run google_ads_page_intel first when you only have an advertiser/domain.",
+    description: "Transcribe audio from a Google video ad's direct videoUrl (a googlevideo.com playback URL) returned by google_ads_page_intel. For YouTube-hosted ads, use youtube_transcribe with the returned youtubeVideoId instead.",
     inputSchema: GoogleAdsTranscribeInputSchema,
     outputSchema: GoogleAdsTranscribeOutputSchema,
     annotations: liveWebToolAnnotations("Google Ad Video Transcription")
   }, async (input) => formatGoogleAdsTranscribe(await executor.googleAdsTranscribe(input), input));
   server.registerTool("facebook_video_transcribe", {
     title: "Facebook Organic Video Transcription",
-    description: withReportNote("Transcribe audio from an organic Facebook reel, video, watch, post, or share URL, including fb.watch links. Use this when the user pastes a normal Facebook video page URL and wants the transcript or downloadable MP4. Renders the Facebook page in a browser, selects the best matching public Facebook CDN MP4 URL from page state, then returns sourceUrl, resolved pageUrl, videoId, ownerName, selectedQuality, bitrate, videoDurationSec, extracted MP4 URL, full transcript, and timestamped chunks."),
+    description: withReportNote("Transcribe audio from an organic Facebook reel/video/post/share URL (including fb.watch). Renders the page, selects the best public CDN MP4, and returns the transcript plus resolved video metadata."),
     inputSchema: FacebookVideoTranscribeInputSchema,
     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 details, pagination attempts, stop reason, and limitations."),
+    description: withReportNote("Discover Instagram profile grid content links (posts/reels/tv) for a handle or profile URL, for later selection with instagram_media_download. Returns profile stats and collected URLs."),
     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."),
+    description: withReportNote("Extract and download media from one Instagram post, reel, or tv URL \u2014 image, caption, video/audio tracks, optional muxed MP4, or transcript. Selects the best video/audio track pair and muxes when ffmpeg is available."),
     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.'),
+    description: withReportNote("Extract Google Maps business intelligence for one known/named business: rating, reviews, category, address, phone, hours, entity IDs. Not for category searches or multi-business prospect lists \u2014 use maps_search for those. Split business name from location."),
     inputSchema: MapsPlaceIntelInputSchema,
     outputSchema: MapsPlaceIntelOutputSchema,
     annotations: liveWebToolAnnotations("Google Maps Business Profile Details")
   }, async (input) => formatMapsPlaceIntel(await executor.mapsPlaceIntel(input), input));
   server.registerTool("maps_search", {
     title: "Google Maps Business Search",
-    description: withReportNote('Search Google Maps for multiple businesses/profiles by category, niche, keyword, or local market. Use this when the user asks for several Google Business Profiles, GMBs, GBPs, leads, prospects, competitors, or "more than the 3-pack." Routing is automatic and location-aware \u2014 leave proxyMode unset; pass proxyZip only to force a specific ZIP. Returns up to 50 candidates with names, place URLs, CIDs when available, ratings, review counts, profile metadata, and sanitized attempt telemetry. Default maxResults is 10; maximum is 50. Use maps_place_intel afterward only when a selected business needs full details and reviews.'),
+    description: withReportNote("Search Google Maps for multiple businesses by category, niche, or local market \u2014 leads, prospects, competitors, or beyond the 3-pack. Leave proxyMode unset. Returns up to 50 candidates (default 10) with names, place URLs, CIDs, ratings."),
     inputSchema: MapsSearchInputSchema,
     outputSchema: MapsSearchOutputSchema,
     annotations: liveWebToolAnnotations("Google Maps Business Search")
   }, async (input) => formatMapsSearch(await executor.mapsSearch(input), input));
   server.registerTool("directory_workflow", {
     title: "Directory Workflow: Markets + Maps",
-    description: withReportNote('Build directory/prospecting datasets by selecting US city markets from the free Census Population Estimates city/place dataset, optionally joining configured US ZIPS/Lead Magician ZIP groups, then running Google Maps business searches for each city in parallel. Use this when the user wants "all cities over 100k population in a state", "build a directory CSV", "find markets then get Maps data", or similar location-database + Maps workflows. Set minPopulation, state, query, maxResultsPerCity, and concurrency. Routing is automatic per city. Saved 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, cid_decimal, city population, and ZIP groups. Structured city results include sanitized attempt telemetry. Use maps_place_intel only when a selected profile needs deeper review topics, profile review count confirmation, or review cards. For local Lead Magician ZIP enrichment, set MCP_SCRAPER_USZIPS_CSV_PATH on the API server or pass usZipsCsvPath only in local/test mode.'),
+    description: withReportNote('Build directory/prospecting datasets: selects US city markets from Census population data, optionally joins configured ZIP groups, then runs Google Maps business searches per city in parallel. Use for "all cities over 100k population in a state" or market+Maps workflows. Saves a CSV of results per city. For ZIP enrichment, set MCP_SCRAPER_USZIPS_CSV_PATH on the server, or pass usZipsCsvPath in local/test mode.'),
     inputSchema: DirectoryWorkflowInputSchema,
     outputSchema: DirectoryWorkflowOutputSchema,
     annotations: liveWebToolAnnotations("Directory Workflow: Markets + Maps")
   }, async (input) => formatDirectoryWorkflow(await executor.directoryWorkflow(input), input));
   server.registerTool("workflow_list", {
     title: "Workflow Catalog",
-    description: "List MCP Scraper higher-level workflows and AI-facing recipes. Use this when the user asks what MCP Scraper can do beyond single tools, or asks for market analysis, ICP research, forum/review acquisition, full brand design briefings, CRO audits, competitive positioning, content gap briefs, or AI search visibility audits. Returns runnable workflow ids plus recipe guidance for the best tool chain.",
+    description: "List MCP Scraper higher-level workflows and recipes \u2014 market analysis, ICP research, CRO audits, competitive positioning, content gap briefs, AI search visibility, and more. Returns runnable workflow ids plus tool-chain guidance.",
     inputSchema: WorkflowListInputSchema,
     outputSchema: WorkflowListOutputSchema,
     annotations: localPlanningToolAnnotations("Workflow Catalog")
   }, async (input) => formatWorkflowList(await executor.workflowList(input), input));
   server.registerTool("workflow_suggest", {
     title: "Workflow Intent Router",
-    description: 'Route a high-level business or research goal to the right MCP Scraper workflow/tool chain. Use before running work when the user says things like "do market analysis", "research my ICP", "acquire forum and review language", "build a brand design brief", "run a CRO audit", "compare competitors", "make a content gap brief", or "audit AI search visibility". This tool does not spend credits; it tells the AI exactly which workflow/tool chain to run next.',
+    description: "Route a high-level business/research goal (market analysis, ICP research, CRO audit, competitor comparison, content gap brief, AI search visibility, etc) to the right MCP Scraper workflow/tool chain. Free; tells you what to run next.",
     inputSchema: WorkflowSuggestInputSchema,
     outputSchema: WorkflowSuggestOutputSchema,
     annotations: localPlanningToolAnnotations("Workflow Intent Router")
   }, async (input) => formatWorkflowSuggest(input));
   server.registerTool("workflow_run", {
     title: "Run Workflow",
-    description: withReportNote("Start a higher-level MCP Scraper workflow. Use after workflow_suggest or workflow_list. Runnable workflow ids: directory, agent-packet, local-competitive-audit, map-comparison, serp-comparison, paa-expansion-brief, ai-overview-language. This is the main MCP tool for market analysis, ICP evidence packets, local competitive audits, Maps/SERP comparisons, content gap briefs, and AI Overview language guidance. Stepwise workflows (e.g. agent-packet) run ONE leg per call and return runId, the step output, and nextStep \u2014 when nextStep is present, call workflow_step with the runId to run the next leg, and keep calling it until done is true. This keeps each call short instead of one long blocking run, so report each step result to the user as it arrives."),
+    description: withReportNote("Start a higher-level MCP Scraper workflow (directory, agent-packet, local-competitive-audit, map-comparison, serp-comparison, paa-expansion-brief, ai-overview-language). Use after workflow_suggest or workflow_list. Stepwise workflows return runId + nextStep \u2014 call workflow_step with the runId until done is true."),
     inputSchema: WorkflowRunInputSchema,
     outputSchema: WorkflowRunOutputSchema,
     annotations: liveWebToolAnnotations("Run Workflow")
   }, async (input) => formatWorkflowRun(await executor.workflowRun(input), input));
   server.registerTool("workflow_step", {
     title: "Advance Workflow Step",
-    description: withReportNote("Run the next leg of a stepwise MCP Scraper workflow started with workflow_run. Pass the runId. Each call executes exactly one logical step (typically one live harvest), persists that step's artifacts, and returns the step output plus nextStep. Keep calling workflow_step with the same runId until done is true, reporting each step result to the user as it lands. Use this instead of waiting on one long workflow call \u2014 it avoids client timeouts on long multi-step jobs."),
+    description: withReportNote("Run the next leg of a stepwise workflow started with workflow_run. Pass the runId; each call executes one step and returns its output plus nextStep. Keep calling with the same runId until done is true."),
     inputSchema: WorkflowStepInputSchema,
     outputSchema: WorkflowStepOutputSchema,
     annotations: liveWebToolAnnotations("Advance Workflow Step")
   }, async (input) => formatWorkflowStep(await executor.workflowStep(input), input));
   server.registerTool("workflow_status", {
     title: "Workflow Status",
-    description: "Fetch a hosted workflow run by id and list its current status and artifacts. Use when a workflow may still be running, when the model needs to re-open a run, inspect artifact ids, recover from a long workflow, or decide whether to call workflow_step or workflow_artifact_read next. Use only a runId returned by workflow_run/workflow_step/workflow_status; do not construct one yourself.",
+    description: "Fetch a hosted workflow run by id and list its current status and artifacts, to re-open a run or recover artifact ids. Use only a runId returned by workflow_run/workflow_step/workflow_status.",
     inputSchema: WorkflowStatusInputSchema,
     outputSchema: WorkflowStatusOutputSchema,
     annotations: liveWebToolAnnotations("Workflow Status")
   }, async (input) => formatWorkflowStatus(await executor.workflowStatus(input), input));
   server.registerTool("workflow_artifact_read", {
     title: "Read Workflow Artifact",
-    description: "Read a workflow artifact back into MCP context by run id and artifact id. Use this before writing final deliverables so the answer is grounded in generated evidence.json, CSVs, Markdown briefs, reports, and task files instead of memory. Use workflow_status first when artifact ids are unknown. Use only artifactId values returned by workflow_run/workflow_step/workflow_status; do not construct one yourself. Use maxBytes to limit large CSV/JSON artifacts.",
+    description: "Read a workflow artifact back into context by run id and artifact id, so final deliverables are grounded in generated evidence rather than memory. Use workflow_status first when artifact ids are unknown. Use maxBytes to limit large artifacts.",
     inputSchema: WorkflowArtifactReadInputSchema,
     outputSchema: WorkflowArtifactReadOutputSchema,
     annotations: liveWebToolAnnotations("Read Workflow Artifact")
   }, async (input) => formatWorkflowArtifactRead(await executor.workflowArtifactRead(input), input));
   server.registerTool("rank_tracker_workflow", {
     title: "Rank Tracker Blueprint Builder",
-    description: "Generate a build-ready database, cron/heartbeat, ingestion, metrics, and AI implementation prompt for a rank tracker powered by MCP Scraper. Supports Maps rankings through directory_workflow/maps_search, organic rankings through search_serp, AI Overview citation tracking, and People Also Ask source presence tracking. This tool is local planning only; it does not call the web or spend credits.",
+    description: "Generate a build-ready database schema, cron plan, and implementation prompt for a rank tracker powered by MCP Scraper (Maps, organic, AI Overview, or PAA tracking). Local planning only \u2014 does not call the web or spend credits.",
     inputSchema: RankTrackerBlueprintInputSchema,
     outputSchema: RankTrackerBlueprintOutputSchema,
     annotations: localPlanningToolAnnotations("Rank Tracker Blueprint Builder")
   }, async (input) => buildRankTrackerBlueprint(input));
   server.registerTool("credits_info", {
     title: "MCP Scraper Credits & Costs",
-    description: "Answer questions about MCP Scraper credits, usage limits, and concurrency upgrades: current credit balance, what a specific tool/action costs, the full cost table, current concurrency limit, the extra-slot price, billing URL, and the terminal checkout command. Does not expose payment methods or credit card information.",
+    description: "Answer questions about MCP Scraper credits, usage limits, and concurrency upgrades \u2014 balance, tool costs, concurrency limits, billing URL. Does not expose payment methods or card information.",
     inputSchema: CreditsInfoInputSchema,
     outputSchema: CreditsInfoOutputSchema,
     annotations: {
@@ -27382,6 +27732,12 @@ var init_http_mcp_tool_executor = __esm({
       redditThread(input) {
         return this.call("/reddit/thread", input, this.httpTimeoutOverrideMs ?? 24e4);
       }
+      videoFrameAnalysis(input) {
+        return this.call("/video/analyze", input);
+      }
+      videoFrameAnalysisStatus(input) {
+        return this.call("/video/status", input);
+      }
       facebookAdTranscribe(input) {
         return this.call("/facebook/transcribe", input);
       }
@@ -27588,17 +27944,17 @@ var init_export = __esm({
 });
 
 // src/mcp/browser-agent-tool-schemas.ts
-var import_zod31, NullableString2, BrowserRawObject, BrowserElementOutput, BrowserBaseOutput, BrowserReplayBaseOutput, BrowserOpenInputSchema, BrowserProfileConnectInputSchema, BrowserProfileListInputSchema, BrowserSessionInputSchema, BrowserLocateTargetSchema, BrowserLocateInputSchema, BrowserGotoInputSchema, BrowserClickInputSchema, BrowserTypeInputSchema, BrowserScrollInputSchema, BrowserPressInputSchema, BrowserReplayStopInputSchema, BrowserReplayDownloadInputSchema, BrowserReplayAnnotationSchema, BrowserReplayMarkInputSchema, BrowserReplayAnnotateInputSchema, BrowserListInputSchema, BrowserCaptureFanoutInputSchema, FanoutSourceOutput, BrowserCaptureFanoutOutputSchema, BrowserOpenOutputSchema, BrowserProfileLogin, BrowserProfileConnectOutputSchema, BrowserProfileListOutputSchema, BrowserScreenshotOutputSchema, BrowserReadOutputSchema, BrowserLocateOutputSchema, BrowserActionOutputSchema, BrowserReplayStartOutputSchema, BrowserReplayStopOutputSchema, BrowserListReplaysOutputSchema, BrowserReplayDownloadOutputSchema, BrowserReplayMarkOutputSchema, BrowserReplayAnnotateOutputSchema, BrowserCloseOutputSchema, BrowserListSessionsOutputSchema;
+var import_zod32, NullableString2, BrowserRawObject, BrowserElementOutput, BrowserBaseOutput, BrowserReplayBaseOutput, BrowserOpenInputSchema, BrowserProfileConnectInputSchema, BrowserProfileListInputSchema, BrowserSessionInputSchema, BrowserLocateTargetSchema, BrowserLocateInputSchema, BrowserGotoInputSchema, BrowserClickInputSchema, BrowserTypeInputSchema, BrowserScrollInputSchema, BrowserPressInputSchema, BrowserReplayStopInputSchema, BrowserReplayDownloadInputSchema, BrowserReplayAnnotationSchema, BrowserReplayMarkInputSchema, BrowserReplayAnnotateInputSchema, BrowserListInputSchema, BrowserCaptureFanoutInputSchema, FanoutSourceOutput, BrowserCaptureFanoutOutputSchema, BrowserOpenOutputSchema, BrowserProfileLogin, BrowserProfileConnectOutputSchema, BrowserProfileListOutputSchema, BrowserScreenshotOutputSchema, BrowserReadOutputSchema, BrowserLocateOutputSchema, BrowserActionOutputSchema, BrowserReplayStartOutputSchema, BrowserReplayStopOutputSchema, BrowserListReplaysOutputSchema, BrowserReplayDownloadOutputSchema, BrowserReplayMarkOutputSchema, BrowserReplayAnnotateOutputSchema, BrowserCloseOutputSchema, BrowserListSessionsOutputSchema;
 var init_browser_agent_tool_schemas = __esm({
   "src/mcp/browser-agent-tool-schemas.ts"() {
     "use strict";
-    import_zod31 = require("zod");
-    NullableString2 = import_zod31.z.string().nullable();
-    BrowserRawObject = import_zod31.z.record(import_zod31.z.unknown());
-    BrowserElementOutput = import_zod31.z.record(import_zod31.z.unknown());
+    import_zod32 = require("zod");
+    NullableString2 = import_zod32.z.string().nullable();
+    BrowserRawObject = import_zod32.z.record(import_zod32.z.unknown());
+    BrowserElementOutput = import_zod32.z.record(import_zod32.z.unknown());
     BrowserBaseOutput = {
-      ok: import_zod31.z.boolean().describe("Whether the browser-agent action succeeded."),
-      tool: import_zod31.z.string().describe("Browser Agent MCP tool that produced this response."),
+      ok: import_zod32.z.boolean().describe("Whether the browser-agent action succeeded."),
+      tool: import_zod32.z.string().describe("Browser Agent MCP tool that produced this response."),
       session_id: NullableString2.describe("Browser session id when the response is scoped to a session.")
     };
     BrowserReplayBaseOutput = {
@@ -27606,333 +27962,333 @@ var init_browser_agent_tool_schemas = __esm({
       replay_id: NullableString2.describe("Replay id when the response is scoped to a replay.")
     };
     BrowserOpenInputSchema = {
-      label: import_zod31.z.string().optional().describe("Optional human label for this session, shown in the watch console."),
-      url: import_zod31.z.string().url().optional().describe("Optional URL to navigate to immediately after opening."),
-      profile: import_zod31.z.string().optional().describe("Optional saved hosted profile name to load a logged-in session for a site."),
-      save_profile_changes: import_zod31.z.boolean().optional().describe("Persist cookies and browser storage back to the named profile when the session is closed. Use this for profile setup or intentional auth refreshes; avoid parallel sessions writing to the same profile."),
-      timeout_seconds: import_zod31.z.number().int().min(60).max(259200).optional().describe("How long the direct no-proxy browser session may live before auto-termination. Defaults to 600. The browser idles into a zero-cost standby between actions, so a longer timeout is cheap.")
+      label: import_zod32.z.string().optional().describe("Optional human label for this session, shown in the watch console."),
+      url: import_zod32.z.string().url().optional().describe("Optional URL to navigate to immediately after opening."),
+      profile: import_zod32.z.string().optional().describe("Optional saved hosted profile name to load a logged-in session for a site."),
+      save_profile_changes: import_zod32.z.boolean().optional().describe("Persist cookies/storage back to the named profile on close. Avoid parallel sessions writing to the same profile."),
+      timeout_seconds: import_zod32.z.number().int().min(60).max(259200).optional().describe("Session lifetime before auto-termination. Defaults to 600.")
     };
     BrowserProfileConnectInputSchema = {
-      email: import_zod31.z.string().optional().describe("Account email for the login being saved. Used to derive a stable, reusable profile name AND recorded as a note of who is connected. Does NOT import existing cookies \u2014 the user signs in fresh via the returned watch_url."),
-      profile: import_zod31.z.string().optional().describe("Profile to add this login to. Omit to derive one from email. A single profile holds MANY site logins \u2014 pass the same profile name again with a different domain to stack another account (e.g. add claude.ai to a profile that already has chatgpt.com)."),
-      domain: import_zod31.z.string().optional().describe("Site to log into, e.g. chatgpt.com, claude.ai, reddit.com. Defaults to chatgpt.com. Each domain is a separate login inside the profile."),
-      login_url: import_zod31.z.string().url().optional().describe("Login page for the domain. Defaults to https://<domain>/ (https://chatgpt.com/ when domain is omitted)."),
-      url: import_zod31.z.string().url().optional().describe("Deprecated alias for login_url. Use login_url."),
-      note: import_zod31.z.string().optional().describe('Free-text note describing this login, e.g. "ChatGPT Plus, work account". Surfaced by browser_profile_list so you can see what the profile holds.'),
-      label: import_zod31.z.string().optional().describe("Optional human label for this sign-in setup session."),
-      timeout_seconds: import_zod31.z.number().int().min(60).max(259200).optional().describe("How long the sign-in setup session may live before auto-termination. Defaults to 600.")
+      email: import_zod32.z.string().optional().describe("Account email for the login. Derives a stable profile name and is recorded as a note. Does NOT import existing cookies \u2014 the user signs in fresh."),
+      profile: import_zod32.z.string().optional().describe("Profile to add this login to. Omit to derive from email. A single profile holds MANY logins \u2014 pass the same name with a different domain to stack accounts."),
+      domain: import_zod32.z.string().optional().describe("Site to log into, e.g. chatgpt.com, claude.ai, reddit.com. Defaults to chatgpt.com."),
+      login_url: import_zod32.z.string().url().optional().describe("Login page for the domain. Defaults to https://<domain>/."),
+      url: import_zod32.z.string().url().optional().describe("Deprecated alias for login_url."),
+      note: import_zod32.z.string().optional().describe("Free-text note describing this login. Surfaced by browser_profile_list."),
+      label: import_zod32.z.string().optional().describe("Optional human label for this sign-in setup session."),
+      timeout_seconds: import_zod32.z.number().int().min(60).max(259200).optional().describe("Sign-in session lifetime before auto-termination. Defaults to 600.")
     };
     BrowserProfileListInputSchema = {
-      profile: import_zod31.z.string().optional().describe("Profile whose saved logins to list. Omit to derive from email."),
-      email: import_zod31.z.string().optional().describe("Account email used to derive the profile name when profile is not given."),
-      domain: import_zod31.z.string().optional().describe("Restrict to one site login, e.g. chatgpt.com. Use this to poll a single login until its status reads AUTHENTICATED."),
-      connection_id: import_zod31.z.string().optional().describe("A specific login connection id returned by browser_profile_connect, to poll just that one.")
+      profile: import_zod32.z.string().optional().describe("Profile whose saved logins to list. Omit to derive from email."),
+      email: import_zod32.z.string().optional().describe("Account email used to derive the profile name when profile is not given."),
+      domain: import_zod32.z.string().optional().describe("Restrict to one site login, e.g. chatgpt.com. Use this to poll a single login until its status reads AUTHENTICATED."),
+      connection_id: import_zod32.z.string().optional().describe("A specific login connection id returned by browser_profile_connect, to poll just that one.")
     };
     BrowserSessionInputSchema = {
-      session_id: import_zod31.z.string().describe("The session id returned by browser_open or browser_list_sessions. Use only a returned session_id; do not construct one yourself.")
+      session_id: import_zod32.z.string().describe("The session id returned by browser_open or browser_list_sessions.")
     };
-    BrowserLocateTargetSchema = import_zod31.z.object({
-      name: import_zod31.z.string().optional().describe("Optional label for this target, echoed in the result."),
-      selector: import_zod31.z.string().optional().describe('CSS selector for the exact DOM element to locate, for example h1, input[name="q"], or [data-testid="result"].'),
-      text: import_zod31.z.string().optional().describe("Visible text to locate when a selector is not known. The tool returns the text range bounds when possible."),
-      match: import_zod31.z.enum(["contains", "exact"]).default("contains").describe("How to match text targets. Defaults to contains."),
-      index: import_zod31.z.number().int().min(0).default(0).describe("Zero-based match index when multiple elements match.")
+    BrowserLocateTargetSchema = import_zod32.z.object({
+      name: import_zod32.z.string().optional().describe("Optional label for this target, echoed in the result."),
+      selector: import_zod32.z.string().optional().describe('CSS selector for the exact DOM element to locate, for example h1, input[name="q"], or [data-testid="result"].'),
+      text: import_zod32.z.string().optional().describe("Visible text to locate when a selector is not known. The tool returns the text range bounds when possible."),
+      match: import_zod32.z.enum(["contains", "exact"]).default("contains").describe("How to match text targets. Defaults to contains."),
+      index: import_zod32.z.number().int().min(0).default(0).describe("Zero-based match index when multiple elements match.")
     }).refine((value) => Boolean(value.selector || value.text), {
       message: "target requires selector or text"
     });
     BrowserLocateInputSchema = {
-      session_id: import_zod31.z.string().describe("The session id returned by browser_open or browser_list_sessions. Use only a returned session_id; do not construct one yourself."),
-      targets: import_zod31.z.array(BrowserLocateTargetSchema).min(1).max(20).describe("DOM targets to locate in the current viewport. Use selectors for exact elements, or text for visible text ranges.")
+      session_id: import_zod32.z.string().describe("The session id returned by browser_open or browser_list_sessions."),
+      targets: import_zod32.z.array(BrowserLocateTargetSchema).min(1).max(20).describe("DOM targets to locate in the current viewport. Use selectors for exact elements, or text for visible text ranges.")
     };
     BrowserGotoInputSchema = {
-      session_id: import_zod31.z.string().describe("The session id returned by browser_open or browser_list_sessions. Use only a returned session_id; do not construct one yourself."),
-      url: import_zod31.z.string().url().describe("URL to navigate the browser to.")
+      session_id: import_zod32.z.string().describe("The session id returned by browser_open or browser_list_sessions."),
+      url: import_zod32.z.string().url().describe("URL to navigate the browser to.")
     };
     BrowserClickInputSchema = {
-      session_id: import_zod31.z.string().describe("The session id returned by browser_open or browser_list_sessions. Use only a returned session_id; do not construct one yourself."),
-      x: import_zod31.z.number().describe("X coordinate to click, in screenshot pixels. Use only coordinates from the latest browser_screenshot, browser_read, or browser_locate result; do not guess."),
-      y: import_zod31.z.number().describe("Y coordinate to click, in screenshot pixels. Use only coordinates from the latest browser_screenshot, browser_read, or browser_locate result; do not guess."),
-      button: import_zod31.z.enum(["left", "right", "middle"]).default("left").describe("Mouse button."),
-      num_clicks: import_zod31.z.number().int().min(1).max(3).optional().describe("Number of clicks, e.g. 2 for double-click.")
+      session_id: import_zod32.z.string().describe("The session id returned by browser_open or browser_list_sessions."),
+      x: import_zod32.z.number().describe("X coordinate to click, in screenshot pixels. Use only coordinates from the latest browser_screenshot, browser_read, or browser_locate result; do not guess."),
+      y: import_zod32.z.number().describe("Y coordinate to click, in screenshot pixels. Use only coordinates from the latest browser_screenshot, browser_read, or browser_locate result; do not guess."),
+      button: import_zod32.z.enum(["left", "right", "middle"]).default("left").describe("Mouse button."),
+      num_clicks: import_zod32.z.number().int().min(1).max(3).optional().describe("Number of clicks, e.g. 2 for double-click.")
     };
     BrowserTypeInputSchema = {
-      session_id: import_zod31.z.string().describe("The session id returned by browser_open or browser_list_sessions. Use only a returned session_id; do not construct one yourself."),
-      text: import_zod31.z.string().describe("Text to type at the current focus. Click a field first to focus it."),
-      delay: import_zod31.z.number().int().min(0).max(500).optional().describe("Optional per-keystroke delay in ms for human-like typing.")
+      session_id: import_zod32.z.string().describe("The session id returned by browser_open or browser_list_sessions."),
+      text: import_zod32.z.string().describe("Text to type at the current focus. Click a field first to focus it."),
+      delay: import_zod32.z.number().int().min(0).max(500).optional().describe("Optional per-keystroke delay in ms for human-like typing.")
     };
     BrowserScrollInputSchema = {
-      session_id: import_zod31.z.string().describe("The session id returned by browser_open or browser_list_sessions. Use only a returned session_id; do not construct one yourself."),
-      delta_y: import_zod31.z.number().default(5).describe("Vertical scroll in wheel units. Positive scrolls down, negative up."),
-      delta_x: import_zod31.z.number().default(0).describe("Horizontal scroll in wheel units."),
-      x: import_zod31.z.number().optional().describe("X position to scroll at. Defaults to screen center."),
-      y: import_zod31.z.number().optional().describe("Y position to scroll at. Defaults to screen center.")
+      session_id: import_zod32.z.string().describe("The session id returned by browser_open or browser_list_sessions."),
+      delta_y: import_zod32.z.number().default(5).describe("Vertical scroll in wheel units. Positive scrolls down, negative up."),
+      delta_x: import_zod32.z.number().default(0).describe("Horizontal scroll in wheel units."),
+      x: import_zod32.z.number().optional().describe("X position to scroll at. Defaults to screen center."),
+      y: import_zod32.z.number().optional().describe("Y position to scroll at. Defaults to screen center.")
     };
     BrowserPressInputSchema = {
-      session_id: import_zod31.z.string().describe("The session id returned by browser_open or browser_list_sessions. Use only a returned session_id; do not construct one yourself."),
-      keys: import_zod31.z.array(import_zod31.z.string()).min(1).describe('Keys or combinations to press, e.g. ["Return"], ["Ctrl+a"], ["Ctrl+Shift+Tab"].')
+      session_id: import_zod32.z.string().describe("The session id returned by browser_open or browser_list_sessions."),
+      keys: import_zod32.z.array(import_zod32.z.string()).min(1).describe('Keys or combinations to press, e.g. ["Return"], ["Ctrl+a"], ["Ctrl+Shift+Tab"].')
     };
     BrowserReplayStopInputSchema = {
-      session_id: import_zod31.z.string().describe("The session id returned by browser_open or browser_list_sessions. Use only a returned session_id; do not construct one yourself."),
-      replay_id: import_zod31.z.string().describe("The replay id returned by browser_replay_start or browser_list_replays. Use only a returned replay_id; do not construct one yourself.")
+      session_id: import_zod32.z.string().describe("The session id returned by browser_open or browser_list_sessions."),
+      replay_id: import_zod32.z.string().describe("The replay id returned by browser_replay_start or browser_list_replays.")
     };
     BrowserReplayDownloadInputSchema = {
-      session_id: import_zod31.z.string().describe("The session id returned by browser_open or browser_list_sessions. Use only a returned session_id; do not construct one yourself."),
-      replay_id: import_zod31.z.string().describe("The replay id returned by browser_replay_start or browser_list_replays. Use only a returned replay_id; do not construct one yourself."),
-      filename: import_zod31.z.string().optional().describe("Optional local MP4 filename. Defaults to a timestamped replay filename.")
+      session_id: import_zod32.z.string().describe("The session id returned by browser_open or browser_list_sessions."),
+      replay_id: import_zod32.z.string().describe("The replay id returned by browser_replay_start or browser_list_replays."),
+      filename: import_zod32.z.string().optional().describe("Optional local MP4 filename. Defaults to a timestamped replay filename.")
     };
-    BrowserReplayAnnotationSchema = import_zod31.z.object({
-      type: import_zod31.z.enum(["box", "circle", "underline", "arrow", "label"]).default("box").describe("Annotation style to draw over the replay."),
-      start_seconds: import_zod31.z.number().min(0).default(0).describe("When the annotation should appear in the replay."),
-      end_seconds: import_zod31.z.number().min(0).optional().describe("When the annotation should disappear. Defaults to two seconds after start_seconds."),
-      left: import_zod31.z.number().optional().describe("Target left edge in browser screenshot pixels. Use element.left from browser_screenshot/browser_read."),
-      top: import_zod31.z.number().optional().describe("Target top edge in browser screenshot pixels. Use element.top from browser_screenshot/browser_read."),
-      width: import_zod31.z.number().positive().optional().describe("Target width in browser screenshot pixels. Use element.width from browser_screenshot/browser_read."),
-      height: import_zod31.z.number().positive().optional().describe("Target height in browser screenshot pixels. Use element.height from browser_screenshot/browser_read."),
-      x: import_zod31.z.number().optional().describe("Point target x coordinate in browser screenshot pixels when no box is available."),
-      y: import_zod31.z.number().optional().describe("Point target y coordinate in browser screenshot pixels when no box is available."),
-      from_x: import_zod31.z.number().optional().describe("Arrow start x coordinate in browser screenshot pixels. Defaults near the target."),
-      from_y: import_zod31.z.number().optional().describe("Arrow start y coordinate in browser screenshot pixels. Defaults near the target."),
-      to_x: import_zod31.z.number().optional().describe("Arrow target x coordinate in browser screenshot pixels. Defaults to the target box center."),
-      to_y: import_zod31.z.number().optional().describe("Arrow target y coordinate in browser screenshot pixels. Defaults to the target box center."),
-      label: import_zod31.z.string().max(120).optional().describe("Optional text callout to render near the annotation."),
-      color: import_zod31.z.string().regex(/^#?[0-9a-fA-F]{6}$/).optional().describe("Annotation color as hex, for example #ff3b30."),
-      thickness: import_zod31.z.number().min(1).max(24).optional().describe("Stroke thickness in pixels. Defaults to 5.")
+    BrowserReplayAnnotationSchema = import_zod32.z.object({
+      type: import_zod32.z.enum(["box", "circle", "underline", "arrow", "label"]).default("box").describe("Annotation style."),
+      start_seconds: import_zod32.z.number().min(0).default(0).describe("When the annotation should appear."),
+      end_seconds: import_zod32.z.number().min(0).optional().describe("When it disappears. Defaults to 2s after start_seconds."),
+      left: import_zod32.z.number().optional().describe("Target left edge in screenshot pixels (element.left)."),
+      top: import_zod32.z.number().optional().describe("Target top edge in screenshot pixels (element.top)."),
+      width: import_zod32.z.number().positive().optional().describe("Target width in screenshot pixels (element.width)."),
+      height: import_zod32.z.number().positive().optional().describe("Target height in screenshot pixels (element.height)."),
+      x: import_zod32.z.number().optional().describe("Point target x coordinate when no box is available."),
+      y: import_zod32.z.number().optional().describe("Point target y coordinate when no box is available."),
+      from_x: import_zod32.z.number().optional().describe("Arrow start x coordinate. Defaults near the target."),
+      from_y: import_zod32.z.number().optional().describe("Arrow start y coordinate. Defaults near the target."),
+      to_x: import_zod32.z.number().optional().describe("Arrow end x coordinate. Defaults to the target box center."),
+      to_y: import_zod32.z.number().optional().describe("Arrow end y coordinate. Defaults to the target box center."),
+      label: import_zod32.z.string().max(120).optional().describe("Optional text callout."),
+      color: import_zod32.z.string().regex(/^#?[0-9a-fA-F]{6}$/).optional().describe("Annotation color as hex, e.g. #ff3b30."),
+      thickness: import_zod32.z.number().min(1).max(24).optional().describe("Stroke thickness in pixels. Defaults to 5.")
     });
     BrowserReplayMarkInputSchema = {
-      session_id: import_zod31.z.string().describe("The session id returned by browser_open or browser_list_sessions. Use only a returned session_id; do not construct one yourself. A replay must already be recording."),
+      session_id: import_zod32.z.string().describe("The session id returned by browser_open or browser_list_sessions. A replay must already be recording."),
       target: BrowserLocateTargetSchema.describe("The exact DOM element or text range to mark in the current viewport."),
-      type: import_zod31.z.enum(["box", "circle", "underline", "arrow"]).default("box").describe("Annotation style to generate. Labels are included on the returned annotation when label is provided."),
-      label: import_zod31.z.string().max(120).optional().describe("Optional callout text to render near the target."),
-      color: import_zod31.z.string().regex(/^#?[0-9a-fA-F]{6}$/).optional().describe("Annotation color as hex, for example #ff3b30."),
-      thickness: import_zod31.z.number().min(1).max(24).optional().describe("Stroke thickness in pixels. Defaults to 5."),
-      padding: import_zod31.z.number().min(0).max(80).default(8).describe("Pixels to expand the DOM bounds so the highlight does not touch the text edge."),
-      start_offset_seconds: import_zod31.z.number().min(-5).max(10).default(-0.25).describe("Offset from the current replay time. Negative values make the callout appear just before the mark action is captured."),
-      duration_seconds: import_zod31.z.number().min(0.5).max(30).default(4).describe("How long the generated annotation should remain visible.")
+      type: import_zod32.z.enum(["box", "circle", "underline", "arrow"]).default("box").describe("Annotation style to generate."),
+      label: import_zod32.z.string().max(120).optional().describe("Optional callout text to render near the target."),
+      color: import_zod32.z.string().regex(/^#?[0-9a-fA-F]{6}$/).optional().describe("Annotation color as hex, e.g. #ff3b30."),
+      thickness: import_zod32.z.number().min(1).max(24).optional().describe("Stroke thickness in pixels. Defaults to 5."),
+      padding: import_zod32.z.number().min(0).max(80).default(8).describe("Pixels to expand the DOM bounds so the highlight does not touch the text edge."),
+      start_offset_seconds: import_zod32.z.number().min(-5).max(10).default(-0.25).describe("Offset from the current replay time; negative appears just before the mark action."),
+      duration_seconds: import_zod32.z.number().min(0.5).max(30).default(4).describe("How long the annotation should remain visible.")
     };
     BrowserReplayAnnotateInputSchema = {
-      session_id: import_zod31.z.string().describe("The session id returned by browser_open or browser_list_sessions. Use only a returned session_id; do not construct one yourself."),
-      replay_id: import_zod31.z.string().describe("The replay id returned by browser_replay_start or browser_list_replays. Use only a returned replay_id; do not construct one yourself."),
-      annotations: import_zod31.z.array(BrowserReplayAnnotationSchema).min(1).max(50).describe("Timed overlay annotations to render on the replay. Prefer annotations returned by browser_replay_mark; otherwise use exact DOM bounds from browser_locate/browser_screenshot/browser_read."),
-      filename: import_zod31.z.string().optional().describe("Optional output MP4 filename. Defaults to a timestamped annotated replay filename."),
-      source_width: import_zod31.z.number().positive().optional().describe("Width of the screenshot coordinate space used for annotations. Defaults to the replay video width."),
-      source_height: import_zod31.z.number().positive().optional().describe("Height of the coordinate space used for annotations. When this is a page viewport height smaller than the replay video height, the annotator infers the browser chrome top offset."),
-      source_left_offset: import_zod31.z.number().min(0).optional().describe("Optional explicit X offset from annotation coordinates to replay video coordinates. Usually omitted."),
-      source_top_offset: import_zod31.z.number().min(0).optional().describe("Optional explicit Y offset from annotation coordinates to replay video coordinates. Usually omitted because browser chrome offset is inferred when source_height is a page viewport height.")
+      session_id: import_zod32.z.string().describe("The session id returned by browser_open or browser_list_sessions."),
+      replay_id: import_zod32.z.string().describe("The replay id returned by browser_replay_start or browser_list_replays."),
+      annotations: import_zod32.z.array(BrowserReplayAnnotationSchema).min(1).max(50).describe("Timed overlay annotations. Prefer ones from browser_replay_mark; otherwise use exact DOM bounds from browser_locate."),
+      filename: import_zod32.z.string().optional().describe("Optional output MP4 filename. Defaults to a timestamped filename."),
+      source_width: import_zod32.z.number().positive().optional().describe("Width of the screenshot coordinate space used for annotations. Defaults to the replay video width."),
+      source_height: import_zod32.z.number().positive().optional().describe("Height of the annotation coordinate space; if smaller than the replay video height, the browser chrome offset is inferred."),
+      source_left_offset: import_zod32.z.number().min(0).optional().describe("Explicit X offset from annotation to replay video coordinates. Usually omitted."),
+      source_top_offset: import_zod32.z.number().min(0).optional().describe("Explicit Y offset from annotation to replay video coordinates. Usually omitted.")
     };
     BrowserListInputSchema = {
-      include_closed: import_zod31.z.boolean().default(false).describe("Include closed sessions in the list.")
+      include_closed: import_zod32.z.boolean().default(false).describe("Include closed sessions in the list.")
     };
     BrowserCaptureFanoutInputSchema = {
-      session_id: import_zod31.z.string().describe("The session id returned by browser_open or browser_list_sessions. The session must be on chatgpt.com or claude.ai and logged in through a saved hosted profile. Use only a returned session_id; do not construct one yourself."),
-      prompt: import_zod31.z.string().optional().describe("Optional prompt to type into the chat composer and submit before capturing. Omit to passively capture the fan-out of a prompt the user just ran in the visible browser. The prompt must trigger web search for there to be a fan-out."),
-      wait_ms: import_zod31.z.number().int().min(0).max(18e4).optional().describe("How long to wait for the answer stream to finish before parsing. Defaults to 90000 when a prompt is sent, 8000 for passive capture. Capture ends as soon as the answer stream finishes."),
-      first_party_domain: import_zod31.z.string().optional().describe("The brand/site being researched, for example example.com. Sources on this domain are tagged First-party/vendor. Set this when the prompt is about a specific business."),
-      reset: import_zod31.z.boolean().default(false).describe("Clear any previously buffered stream for this page before capturing. Use when re-running to avoid mixing turns."),
-      export: import_zod31.z.boolean().default(false).describe("When true, write JSON, CSV, TSV exports (queries, citations, all sources, browsed-only sources, snippets, domains) and a self-contained HTML report to MCP_SCRAPER_OUTPUT_DIR/fanout, returning paths relative to MCP_SCRAPER_OUTPUT_DIR.")
+      session_id: import_zod32.z.string().describe("Session id from browser_open. Must be on chatgpt.com or claude.ai, logged in via a saved hosted profile."),
+      prompt: import_zod32.z.string().optional().describe("Optional prompt to type and submit before capturing. Omit to passively capture a prompt the user just ran. Must trigger web search to produce a fan-out."),
+      wait_ms: import_zod32.z.number().int().min(0).max(18e4).optional().describe("How long to wait for the answer stream to finish. Defaults to 90000 when a prompt is sent, 8000 for passive capture."),
+      first_party_domain: import_zod32.z.string().optional().describe("The brand/site being researched, e.g. example.com \u2014 sources on this domain are tagged First-party/vendor."),
+      reset: import_zod32.z.boolean().default(false).describe("Clear any previously buffered stream for this page before capturing."),
+      export: import_zod32.z.boolean().default(false).describe("Write JSON/CSV/TSV/HTML exports to MCP_SCRAPER_OUTPUT_DIR/fanout, returning relative paths.")
     };
-    FanoutSourceOutput = import_zod31.z.object({
-      url: import_zod31.z.string(),
-      domain: import_zod31.z.string(),
-      title: import_zod31.z.string(),
-      cited: import_zod31.z.boolean(),
-      timesCited: import_zod31.z.number().int().min(0),
-      snippet: import_zod31.z.string(),
-      round: import_zod31.z.number().int().nullable(),
-      siteType: import_zod31.z.string().describe("URL category: First-party/vendor, News/media, Reddit, Social/video, Encyclopedia, Review site, Docs, or Blog.")
+    FanoutSourceOutput = import_zod32.z.object({
+      url: import_zod32.z.string(),
+      domain: import_zod32.z.string(),
+      title: import_zod32.z.string(),
+      cited: import_zod32.z.boolean(),
+      timesCited: import_zod32.z.number().int().min(0),
+      snippet: import_zod32.z.string(),
+      round: import_zod32.z.number().int().nullable(),
+      siteType: import_zod32.z.string().describe("URL category: First-party/vendor, News/media, Reddit, Social/video, Encyclopedia, Review site, Docs, or Blog.")
     });
     BrowserCaptureFanoutOutputSchema = {
       ...BrowserBaseOutput,
-      tool: import_zod31.z.literal("query_fanout_workflow"),
-      platform: import_zod31.z.enum(["ChatGPT", "Claude"]).describe("Which AI-search surface the fan-out was captured from."),
-      captured_at: import_zod31.z.string(),
-      prompt: import_zod31.z.string().describe("The user prompt that triggered the captured fan-out, when recoverable."),
-      meta: import_zod31.z.object({
-        model: import_zod31.z.string(),
-        finishType: import_zod31.z.string(),
-        title: import_zod31.z.string(),
-        rounds: import_zod31.z.number().int().min(0)
+      tool: import_zod32.z.literal("query_fanout_workflow"),
+      platform: import_zod32.z.enum(["ChatGPT", "Claude"]).describe("Which AI-search surface the fan-out was captured from."),
+      captured_at: import_zod32.z.string(),
+      prompt: import_zod32.z.string().describe("The user prompt that triggered the captured fan-out, when recoverable."),
+      meta: import_zod32.z.object({
+        model: import_zod32.z.string(),
+        finishType: import_zod32.z.string(),
+        title: import_zod32.z.string(),
+        rounds: import_zod32.z.number().int().min(0)
       }),
-      queries: import_zod31.z.array(import_zod31.z.string()).describe("Every web-search sub-query the model issued, in capture order. Classify these by funnel stage and type yourself from the text."),
-      browsed_urls: import_zod31.z.array(FanoutSourceOutput).describe("Every researched URL (cited and browsed-only), cited first."),
-      cited_urls: import_zod31.z.array(FanoutSourceOutput).describe("The subset of researched URLs actually cited in the final answer."),
-      browsed_only: import_zod31.z.array(FanoutSourceOutput).describe("Researched URLs the model pulled but did not cite."),
-      snippets: import_zod31.z.array(import_zod31.z.object({ url: import_zod31.z.string(), domain: import_zod31.z.string(), title: import_zod31.z.string(), text: import_zod31.z.string() })),
-      counts: import_zod31.z.object({
-        subQueries: import_zod31.z.number().int().min(0),
-        browsed: import_zod31.z.number().int().min(0),
-        cited: import_zod31.z.number().int().min(0),
-        browsedOnly: import_zod31.z.number().int().min(0)
+      queries: import_zod32.z.array(import_zod32.z.string()).describe("Every web-search sub-query issued, in capture order."),
+      browsed_urls: import_zod32.z.array(FanoutSourceOutput).describe("Every researched URL, cited first."),
+      cited_urls: import_zod32.z.array(FanoutSourceOutput).describe("Researched URLs cited in the final answer."),
+      browsed_only: import_zod32.z.array(FanoutSourceOutput).describe("Researched URLs pulled but not cited."),
+      snippets: import_zod32.z.array(import_zod32.z.object({ url: import_zod32.z.string(), domain: import_zod32.z.string(), title: import_zod32.z.string(), text: import_zod32.z.string() })),
+      counts: import_zod32.z.object({
+        subQueries: import_zod32.z.number().int().min(0),
+        browsed: import_zod32.z.number().int().min(0),
+        cited: import_zod32.z.number().int().min(0),
+        browsedOnly: import_zod32.z.number().int().min(0)
       }),
-      aggregates: import_zod31.z.object({
-        topSites: import_zod31.z.array(import_zod31.z.object({ domain: import_zod31.z.string(), count: import_zod31.z.number().int(), cited: import_zod31.z.boolean(), timesCited: import_zod31.z.number().int(), siteType: import_zod31.z.string() })),
-        citationOrder: import_zod31.z.array(import_zod31.z.object({ rank: import_zod31.z.number().int(), domain: import_zod31.z.string(), url: import_zod31.z.string(), timesCited: import_zod31.z.number().int() })),
-        byCategory: import_zod31.z.record(import_zod31.z.number().int())
+      aggregates: import_zod32.z.object({
+        topSites: import_zod32.z.array(import_zod32.z.object({ domain: import_zod32.z.string(), count: import_zod32.z.number().int(), cited: import_zod32.z.boolean(), timesCited: import_zod32.z.number().int(), siteType: import_zod32.z.string() })),
+        citationOrder: import_zod32.z.array(import_zod32.z.object({ rank: import_zod32.z.number().int(), domain: import_zod32.z.string(), url: import_zod32.z.string(), timesCited: import_zod32.z.number().int() })),
+        byCategory: import_zod32.z.record(import_zod32.z.number().int())
       }).describe("Objective aggregates: top sourced sites by frequency, citation order, and URL-category counts."),
-      first_party_domain: import_zod31.z.string().nullable(),
-      exports: import_zod31.z.object({
-        relativeTo: import_zod31.z.string(),
-        dir: import_zod31.z.string(),
-        json: import_zod31.z.string(),
-        queriesCsv: import_zod31.z.string(),
-        queriesTsv: import_zod31.z.string(),
-        citationsCsv: import_zod31.z.string(),
-        sourcesCsv: import_zod31.z.string(),
-        browsedOnlyCsv: import_zod31.z.string(),
-        snippetsCsv: import_zod31.z.string(),
-        domainsCsv: import_zod31.z.string(),
-        report: import_zod31.z.string()
+      first_party_domain: import_zod32.z.string().nullable(),
+      exports: import_zod32.z.object({
+        relativeTo: import_zod32.z.string(),
+        dir: import_zod32.z.string(),
+        json: import_zod32.z.string(),
+        queriesCsv: import_zod32.z.string(),
+        queriesTsv: import_zod32.z.string(),
+        citationsCsv: import_zod32.z.string(),
+        sourcesCsv: import_zod32.z.string(),
+        browsedOnlyCsv: import_zod32.z.string(),
+        snippetsCsv: import_zod32.z.string(),
+        domainsCsv: import_zod32.z.string(),
+        report: import_zod32.z.string()
       }).nullable().describe("Relative export paths when export=true, otherwise null. Paths are relative to MCP_SCRAPER_OUTPUT_DIR, or ~/Downloads/mcp-scraper when that env var is not set."),
-      debug: import_zod31.z.object({
-        interceptorReady: import_zod31.z.boolean(),
-        rawBytes: import_zod31.z.number().int().min(0),
-        unmappedKeys: import_zod31.z.array(import_zod31.z.string()),
-        note: import_zod31.z.string()
+      debug: import_zod32.z.object({
+        interceptorReady: import_zod32.z.boolean(),
+        rawBytes: import_zod32.z.number().int().min(0),
+        unmappedKeys: import_zod32.z.array(import_zod32.z.string()),
+        note: import_zod32.z.string()
       }).optional()
     };
     BrowserOpenOutputSchema = {
-      ok: import_zod31.z.boolean(),
-      tool: import_zod31.z.literal("browser_open"),
-      session_id: import_zod31.z.string().describe("Session id returned by browser_open. Use only this exact value in later browser_* calls; do not construct one yourself."),
-      watch_url: import_zod31.z.string().describe("Human watch/takeover URL for this browser session on mcpscraper.dev."),
+      ok: import_zod32.z.boolean(),
+      tool: import_zod32.z.literal("browser_open"),
+      session_id: import_zod32.z.string().describe("Session id returned by browser_open. Use only this exact value in later browser_* calls; do not construct one yourself."),
+      watch_url: import_zod32.z.string().describe("Human watch/takeover URL for this browser session on mcpscraper.dev."),
       live_view_url: NullableString2.describe("Deprecated; always null. Open watch_url to view the live session."),
       url: NullableString2.describe("Initial URL requested by the caller, when provided."),
-      hint: import_zod31.z.string(),
+      hint: import_zod32.z.string(),
       raw: BrowserRawObject.optional()
     };
-    BrowserProfileLogin = import_zod31.z.object({
+    BrowserProfileLogin = import_zod32.z.object({
       connection_id: NullableString2.describe("Auth connection id for this login."),
-      domain: import_zod31.z.string().describe("Site this login is for, e.g. chatgpt.com."),
-      status: import_zod31.z.string().describe("Auth status, e.g. NEEDS_AUTH or AUTHENTICATED."),
+      domain: import_zod32.z.string().describe("Site this login is for, e.g. chatgpt.com."),
+      status: import_zod32.z.string().describe("Auth status, e.g. NEEDS_AUTH or AUTHENTICATED."),
       account_email: NullableString2.describe("Account email recorded for this login, when known."),
       note: NullableString2.describe("Free-text note describing this login."),
       watch_url: NullableString2.describe("mcpscraper.dev sign-in link when this login still needs the user to authenticate."),
       last_connected_at: NullableString2.describe("When this login was last saved or refreshed.")
     });
     BrowserProfileConnectOutputSchema = {
-      ok: import_zod31.z.boolean(),
-      tool: import_zod31.z.literal("browser_profile_connect"),
+      ok: import_zod32.z.boolean(),
+      tool: import_zod32.z.literal("browser_profile_connect"),
       session_id: NullableString2,
-      auth_connection_id: import_zod31.z.string(),
-      watch_url: import_zod31.z.string().describe("mcpscraper.dev sign-in link to give the user so they can complete this login."),
+      auth_connection_id: import_zod32.z.string(),
+      watch_url: import_zod32.z.string().describe("mcpscraper.dev sign-in link to give the user so they can complete this login."),
       live_view_url: NullableString2.describe("Deprecated; always null. Open watch_url to view the sign-in."),
-      profile: import_zod31.z.string().describe("Profile this login was added to. Reuse it to stack more logins or to open a session."),
-      domain: import_zod31.z.string(),
-      setup_url: import_zod31.z.string(),
+      profile: import_zod32.z.string().describe("Profile this login was added to. Reuse it to stack more logins or to open a session."),
+      domain: import_zod32.z.string(),
+      setup_url: import_zod32.z.string(),
       account_email: NullableString2,
       note: NullableString2,
-      status: import_zod31.z.string(),
+      status: import_zod32.z.string(),
       flow_status: NullableString2,
       flow_step: NullableString2,
       flow_expires_at: NullableString2,
       post_login_url: NullableString2,
-      connected_logins: import_zod31.z.array(BrowserProfileLogin).describe("Every login currently saved in this profile, so you can see what else is connected."),
-      next_steps: import_zod31.z.array(import_zod31.z.string()),
+      connected_logins: import_zod32.z.array(BrowserProfileLogin).describe("Every login currently saved in this profile, so you can see what else is connected."),
+      next_steps: import_zod32.z.array(import_zod32.z.string()),
       raw: BrowserRawObject.optional()
     };
     BrowserProfileListOutputSchema = {
-      ok: import_zod31.z.boolean(),
-      tool: import_zod31.z.literal("browser_profile_list"),
-      session_id: import_zod31.z.null(),
-      profile: import_zod31.z.string().describe("Profile these logins belong to."),
-      connections: import_zod31.z.array(BrowserProfileLogin).describe("All site logins saved in this profile, each with its current auth status and note."),
-      count: import_zod31.z.number().int().min(0)
+      ok: import_zod32.z.boolean(),
+      tool: import_zod32.z.literal("browser_profile_list"),
+      session_id: import_zod32.z.null(),
+      profile: import_zod32.z.string().describe("Profile these logins belong to."),
+      connections: import_zod32.z.array(BrowserProfileLogin).describe("All site logins saved in this profile, each with its current auth status and note."),
+      count: import_zod32.z.number().int().min(0)
     };
     BrowserScreenshotOutputSchema = {
       ...BrowserBaseOutput,
-      tool: import_zod31.z.literal("browser_screenshot"),
+      tool: import_zod32.z.literal("browser_screenshot"),
       url: NullableString2,
       title: NullableString2,
-      text: import_zod31.z.string(),
-      elements: import_zod31.z.array(BrowserElementOutput),
-      screenshot: import_zod31.z.object({
-        mime_type: import_zod31.z.string(),
-        inline: import_zod31.z.boolean()
+      text: import_zod32.z.string(),
+      elements: import_zod32.z.array(BrowserElementOutput),
+      screenshot: import_zod32.z.object({
+        mime_type: import_zod32.z.string(),
+        inline: import_zod32.z.boolean()
       }).nullable()
     };
     BrowserReadOutputSchema = {
       ...BrowserBaseOutput,
-      tool: import_zod31.z.literal("browser_read"),
+      tool: import_zod32.z.literal("browser_read"),
       url: NullableString2,
       title: NullableString2,
-      text: import_zod31.z.string(),
-      elements: import_zod31.z.array(BrowserElementOutput),
+      text: import_zod32.z.string(),
+      elements: import_zod32.z.array(BrowserElementOutput),
       raw: BrowserRawObject.optional()
     };
     BrowserLocateOutputSchema = {
       ...BrowserBaseOutput,
-      tool: import_zod31.z.literal("browser_locate"),
+      tool: import_zod32.z.literal("browser_locate"),
       url: NullableString2,
       title: NullableString2,
       viewport: BrowserRawObject.nullable(),
       replay: BrowserRawObject.nullable(),
-      targets: import_zod31.z.array(BrowserRawObject),
+      targets: import_zod32.z.array(BrowserRawObject),
       raw: BrowserRawObject.optional()
     };
     BrowserActionOutputSchema = {
       ...BrowserBaseOutput,
       result: BrowserRawObject.describe("Provider action result. Check ok and follow with browser_screenshot/browser_read when page state matters."),
-      nextRecommendedTool: import_zod31.z.string().nullable()
+      nextRecommendedTool: import_zod32.z.string().nullable()
     };
     BrowserReplayStartOutputSchema = {
       ...BrowserReplayBaseOutput,
-      tool: import_zod31.z.literal("browser_replay_start"),
+      tool: import_zod32.z.literal("browser_replay_start"),
       view_url: NullableString2,
       download_url: NullableString2,
       raw: BrowserRawObject.optional()
     };
     BrowserReplayStopOutputSchema = {
       ...BrowserReplayBaseOutput,
-      tool: import_zod31.z.literal("browser_replay_stop"),
+      tool: import_zod32.z.literal("browser_replay_stop"),
       view_url: NullableString2,
       download_url: NullableString2,
       raw: BrowserRawObject.optional()
     };
     BrowserListReplaysOutputSchema = {
       ...BrowserBaseOutput,
-      tool: import_zod31.z.literal("browser_list_replays"),
-      replays: import_zod31.z.array(BrowserRawObject),
-      count: import_zod31.z.number().int().min(0)
+      tool: import_zod32.z.literal("browser_list_replays"),
+      replays: import_zod32.z.array(BrowserRawObject),
+      count: import_zod32.z.number().int().min(0)
     };
     BrowserReplayDownloadOutputSchema = {
       ...BrowserReplayBaseOutput,
-      tool: import_zod31.z.literal("browser_replay_download"),
+      tool: import_zod32.z.literal("browser_replay_download"),
       file_path: NullableString2,
-      bytes: import_zod31.z.number().int().min(0).nullable(),
+      bytes: import_zod32.z.number().int().min(0).nullable(),
       mime_type: NullableString2,
       download_url: NullableString2
     };
     BrowserReplayMarkOutputSchema = {
       ...BrowserReplayBaseOutput,
-      tool: import_zod31.z.literal("browser_replay_mark"),
+      tool: import_zod32.z.literal("browser_replay_mark"),
       annotation: BrowserRawObject,
-      source_width: import_zod31.z.number().nullable(),
-      source_height: import_zod31.z.number().nullable(),
+      source_width: import_zod32.z.number().nullable(),
+      source_height: import_zod32.z.number().nullable(),
       target: BrowserRawObject.nullable(),
-      hint: import_zod31.z.string()
+      hint: import_zod32.z.string()
     };
     BrowserReplayAnnotateOutputSchema = {
       ...BrowserReplayBaseOutput,
-      tool: import_zod31.z.literal("browser_replay_annotate"),
+      tool: import_zod32.z.literal("browser_replay_annotate"),
       source_file_path: NullableString2,
       annotated_file_path: NullableString2,
-      bytes: import_zod31.z.number().int().min(0).nullable(),
-      width: import_zod31.z.number().int().min(0).nullable(),
-      height: import_zod31.z.number().int().min(0).nullable(),
-      annotation_count: import_zod31.z.number().int().min(0).nullable(),
+      bytes: import_zod32.z.number().int().min(0).nullable(),
+      width: import_zod32.z.number().int().min(0).nullable(),
+      height: import_zod32.z.number().int().min(0).nullable(),
+      annotation_count: import_zod32.z.number().int().min(0).nullable(),
       mime_type: NullableString2
     };
     BrowserCloseOutputSchema = {
       ...BrowserBaseOutput,
-      tool: import_zod31.z.literal("browser_close"),
-      closed: import_zod31.z.boolean(),
+      tool: import_zod32.z.literal("browser_close"),
+      closed: import_zod32.z.boolean(),
       raw: BrowserRawObject.optional()
     };
     BrowserListSessionsOutputSchema = {
-      ok: import_zod31.z.boolean(),
-      tool: import_zod31.z.literal("browser_list_sessions"),
-      session_id: import_zod31.z.null(),
-      sessions: import_zod31.z.array(BrowserRawObject),
-      count: import_zod31.z.number().int().min(0)
+      ok: import_zod32.z.boolean(),
+      tool: import_zod32.z.literal("browser_list_sessions"),
+      session_id: import_zod32.z.null(),
+      sessions: import_zod32.z.array(BrowserRawObject),
+      count: import_zod32.z.number().int().min(0)
     };
   }
 });
@@ -28366,7 +28722,7 @@ function registerBrowserAgentMcpTools(server, opts) {
     "browser_profile_connect",
     {
       title: "Save a Site Login to a Profile",
-      description: `Save a logged-in browser session so this server can reuse a site the user is signed into (ChatGPT, Claude, Reddit, or any account-gated site). Returns an mcpscraper.dev watch_url \u2014 give it to the user, they sign in once, and the cookies are saved to a named profile for later browser_open calls. ONE profile holds MANY logins: call this again with the SAME profile and a DIFFERENT domain to stack another account (e.g. add claude.ai to a profile that already has chatgpt.com). Pass note to record what each login is. Side effects: opens a short-lived sign-in session and persists cookies to the profile; it does NOT import the user's existing browser cookies (they log in fresh). NOT for one-off scraping of public pages (use extract_url) and NOT a way to drive the browser (use browser_open). Sample asks: "save my ChatGPT login", "connect my Reddit account", "add my Claude login to the same profile". After the user signs in, poll browser_profile_list until the login reads AUTHENTICATED, then browser_open with the profile.`,
+      description: "Save a logged-in browser session so this server can reuse a site the user is signed into (ChatGPT, Claude, Reddit, any account-gated site). Returns a watch_url; the user signs in fresh (existing browser cookies are NOT imported) and cookies save to a named profile. ONE profile holds MANY logins \u2014 call again with the same profile and a different domain to stack another account. NOT for one-off scraping (use extract_url) or driving the browser (use browser_open). After sign-in, poll browser_profile_list until AUTHENTICATED, then browser_open with the profile.",
       inputSchema: BrowserProfileConnectInputSchema,
       outputSchema: BrowserProfileConnectOutputSchema,
       annotations: annotations("Save a Site Login to a Profile")
@@ -28424,7 +28780,7 @@ function registerBrowserAgentMcpTools(server, opts) {
     "browser_profile_list",
     {
       title: "List Saved Logins in a Profile",
-      description: `List every site login saved in a profile, each with its current auth status (NEEDS_AUTH / AUTHENTICATED), account email, and note. Use it to (1) see what a profile is connected to before opening a session, and (2) poll a just-saved login until it flips to AUTHENTICATED. Read-only, no cost. Pass profile (or email to derive it); narrow with domain or connection_id to poll a single login. Sample asks: "what's connected in my profile", "is my ChatGPT login ready yet", "which accounts are saved". Pairs with browser_profile_connect (which adds logins) and browser_open (which uses them).`,
+      description: "List every site login saved in a profile with its auth status (NEEDS_AUTH/AUTHENTICATED), email, and note. Use to check what's connected, or to poll a just-saved login until AUTHENTICATED. Read-only, no cost. Pass profile (or email to derive it); narrow with domain or connection_id.",
       inputSchema: BrowserProfileListInputSchema,
       outputSchema: BrowserProfileListOutputSchema,
       annotations: annotations("List Saved Logins in a Profile", true)
@@ -28458,7 +28814,7 @@ function registerBrowserAgentMcpTools(server, opts) {
     "browser_open",
     {
       title: "Open Browser Session",
-      description: "Open a direct no-proxy hosted browser session you can drive. Pass a saved profile name to load a session that is already logged into the sites saved in that profile (one profile can hold several logins). To set up or refresh a login first, use browser_profile_connect, then poll browser_profile_list until it reads AUTHENTICATED. Returns a session_id used by all other browser_* tools.",
+      description: "Open a direct no-proxy hosted browser session you can drive. Pass a saved profile name to load a session already logged into that profile's sites (set one up first with browser_profile_connect). Returns a session_id used by all other browser_* tools.",
       inputSchema: BrowserOpenInputSchema,
       outputSchema: BrowserOpenOutputSchema,
       annotations: annotations("Open Browser Session")
@@ -28492,7 +28848,7 @@ function registerBrowserAgentMcpTools(server, opts) {
     "browser_screenshot",
     {
       title: "See Page (Screenshot + Elements)",
-      description: "Capture what the browser currently shows. Returns a screenshot image PLUS a text snapshot listing interactive elements with their center x,y coordinates, the page url and title, and visible text. This is your primary way to perceive the page. Click elements by their listed x,y. If a Cloudflare/CAPTCHA challenge is visible, wait and screenshot again rather than clicking it.",
+      description: "Capture what the browser currently shows: a screenshot plus a text snapshot of interactive elements with x,y coordinates, page url/title, and visible text. Primary way to perceive the page; click elements by their listed x,y. If a Cloudflare/CAPTCHA challenge is visible, wait and screenshot again rather than clicking it.",
       inputSchema: BrowserSessionInputSchema,
       outputSchema: BrowserScreenshotOutputSchema,
       annotations: annotations("See Page", true)
@@ -28524,7 +28880,7 @@ function registerBrowserAgentMcpTools(server, opts) {
     "browser_read",
     {
       title: "Read Page Text + Elements",
-      description: "Return the page url, title, visible text, and the list of interactive elements (with x,y) without an image. Cheaper than browser_screenshot when you only need to read content or find a target element to click.",
+      description: "Return the page url, title, visible text, and interactive elements (with x,y) without an image. Cheaper than browser_screenshot when you only need to read content or find a click target.",
       inputSchema: BrowserSessionInputSchema,
       outputSchema: BrowserReadOutputSchema,
       annotations: annotations("Read Page", true)
@@ -28548,7 +28904,7 @@ function registerBrowserAgentMcpTools(server, opts) {
     "browser_locate",
     {
       title: "Locate DOM Targets",
-      description: "Locate exact visible DOM elements or text ranges in the current browser viewport and return left/top/width/height bounds in screenshot pixels. Use this before drawing annotations or when a callout must literally circle, box, underline, or point to a real element. Prefer CSS selectors for exact UI elements; use text when selector is unknown. When a replay is actively recording, the result includes replay_elapsed_seconds for timing.",
+      description: "Locate exact visible DOM elements or text ranges and return left/top/width/height bounds in screenshot pixels. Use before drawing annotations that must circle, box, underline, or point to a real element. Prefer CSS selectors; use text when selector is unknown.",
       inputSchema: BrowserLocateInputSchema,
       outputSchema: BrowserLocateOutputSchema,
       annotations: annotations("Locate DOM Targets", true)
@@ -28573,7 +28929,7 @@ function registerBrowserAgentMcpTools(server, opts) {
     "browser_goto",
     {
       title: "Navigate To URL",
-      description: "Navigate an existing browser session to a URL when the user asks you to go to another page or continue browsing in the same session. Use browser_open first if no session exists. Follow with browser_screenshot to see redirects, login walls, CAPTCHA/Cloudflare state, or the loaded page.",
+      description: "Navigate an existing browser session to a URL. Use browser_open first if no session exists; follow with browser_screenshot to see the loaded page.",
       inputSchema: BrowserGotoInputSchema,
       outputSchema: BrowserActionOutputSchema,
       annotations: annotations("Navigate To URL")
@@ -28587,7 +28943,7 @@ function registerBrowserAgentMcpTools(server, opts) {
     "browser_click",
     {
       title: "Click",
-      description: "Click a visible page target using screenshot pixel coordinates. Use this when the user asks you to press a button, open a menu, choose a result, or activate a visible UI element. Use x/y only from the latest browser_screenshot, browser_read, or browser_locate result; do not guess coordinates. Follow with browser_screenshot when the click may change the page.",
+      description: "Click a visible page target using screenshot pixel coordinates. Use x/y only from the latest browser_screenshot, browser_read, or browser_locate result; do not guess coordinates.",
       inputSchema: BrowserClickInputSchema,
       outputSchema: BrowserActionOutputSchema,
       annotations: annotations("Click")
@@ -28606,7 +28962,7 @@ function registerBrowserAgentMcpTools(server, opts) {
     "browser_type",
     {
       title: "Type Text",
-      description: 'Type text into the currently focused browser field. Use this when the user asks you to fill a search box, form field, login field, or editable text area. Click or Tab to the field first if focus is uncertain. Use browser_press with ["Return"] to submit, and browser_screenshot afterward when page state matters.',
+      description: 'Type text into the currently focused browser field. Click or Tab to the field first if focus is uncertain. Use browser_press with ["Return"] to submit.',
       inputSchema: BrowserTypeInputSchema,
       outputSchema: BrowserActionOutputSchema,
       annotations: annotations("Type Text")
@@ -28620,7 +28976,7 @@ function registerBrowserAgentMcpTools(server, opts) {
     "browser_scroll",
     {
       title: "Scroll",
-      description: "Scroll the page to reveal more content before reading, clicking, or locating elements. Positive delta_y scrolls down; negative delta_y scrolls up. Follow with browser_screenshot or browser_read to inspect newly revealed content.",
+      description: "Scroll the page to reveal more content. Positive delta_y scrolls down; negative scrolls up.",
       inputSchema: BrowserScrollInputSchema,
       outputSchema: BrowserActionOutputSchema,
       annotations: annotations("Scroll")
@@ -28639,7 +28995,7 @@ function registerBrowserAgentMcpTools(server, opts) {
     "browser_press",
     {
       title: "Press Keys",
-      description: 'Press keyboard keys or combinations in the active browser session. Use this for submit, Escape, Tab navigation, select-all, or keyboard shortcuts. Examples: ["Return"], ["Escape"], ["Tab"], ["Ctrl+a"], ["Ctrl+Shift+Tab"]. Use browser_type for text entry and browser_screenshot after keypresses that may change the page.',
+      description: "Press keyboard keys or combinations in the active browser session \u2014 submit, Escape, Tab navigation, select-all, or shortcuts. Use browser_type for text entry.",
       inputSchema: BrowserPressInputSchema,
       outputSchema: BrowserActionOutputSchema,
       annotations: annotations("Press Keys")
@@ -28653,7 +29009,7 @@ function registerBrowserAgentMcpTools(server, opts) {
     "browser_replay_start",
     {
       title: "Start Recording",
-      description: "Start recording an MP4 replay of the session. Returns replay_id, view_url when available, and a download_url. Use to capture a task for later review; stop with browser_replay_stop.",
+      description: "Start recording an MP4 replay of the session. Returns replay_id and a download_url. Stop with browser_replay_stop.",
       inputSchema: BrowserSessionInputSchema,
       outputSchema: BrowserReplayStartOutputSchema,
       annotations: annotations("Start Recording")
@@ -28676,7 +29032,7 @@ function registerBrowserAgentMcpTools(server, opts) {
     "browser_replay_stop",
     {
       title: "Stop Recording",
-      description: "Stop a replay recording and expose the final view_url and download_url. Use browser_replay_download to save the MP4 to the configured output directory.",
+      description: "Stop a replay recording and expose its final view_url/download_url. Use browser_replay_download to save the MP4.",
       inputSchema: BrowserReplayStopInputSchema,
       outputSchema: BrowserReplayStopOutputSchema,
       annotations: annotations("Stop Recording")
@@ -28699,7 +29055,7 @@ function registerBrowserAgentMcpTools(server, opts) {
     "browser_list_replays",
     {
       title: "List Replay Videos",
-      description: "List replay recordings for a browser session, including final view_url and authenticated download_url values when available.",
+      description: "List replay recordings for a browser session, including view_url and download_url when available.",
       inputSchema: BrowserSessionInputSchema,
       outputSchema: BrowserListReplaysOutputSchema,
       annotations: annotations("List Replay Videos", true)
@@ -28721,7 +29077,7 @@ function registerBrowserAgentMcpTools(server, opts) {
     "browser_replay_download",
     {
       title: "Download Replay MP4",
-      description: "Download a replay recording through MCP Scraper and save the MP4 under MCP_SCRAPER_OUTPUT_DIR/browser-replays. Use after browser_replay_stop or browser_list_replays.",
+      description: "Download a replay recording and save the MP4 under MCP_SCRAPER_OUTPUT_DIR/browser-replays. Use after browser_replay_stop or browser_list_replays.",
       inputSchema: BrowserReplayDownloadInputSchema,
       outputSchema: BrowserReplayDownloadOutputSchema,
       annotations: annotations("Download Replay MP4")
@@ -28745,7 +29101,7 @@ function registerBrowserAgentMcpTools(server, opts) {
     "browser_replay_mark",
     {
       title: "Mark Replay Annotation",
-      description: "While a replay is actively recording, locate one exact DOM target and return a ready-to-use annotation object with DOM bounds and replay-relative timing. Use this instead of guessing start_seconds or drawing rough rectangles. Workflow: start browser_replay_start, navigate until the target is visible and stable, call browser_replay_mark for each callout, then stop the replay and pass the returned annotations to browser_replay_annotate.",
+      description: "While a replay is actively recording, locate one exact DOM target and return a ready-to-use annotation with DOM bounds and replay-relative timing, instead of guessing start_seconds or rectangles. Pass the returned annotations to browser_replay_annotate after stopping the replay.",
       inputSchema: BrowserReplayMarkInputSchema,
       outputSchema: BrowserReplayMarkOutputSchema,
       annotations: annotations("Mark Replay Annotation", true)
@@ -28795,7 +29151,7 @@ function registerBrowserAgentMcpTools(server, opts) {
     "browser_replay_annotate",
     {
       title: "Annotate Replay MP4",
-      description: "Download a browser replay MP4, render visual annotations over it, and save a new annotated MP4 under MCP_SCRAPER_OUTPUT_DIR/browser-replays. Use this after browser_replay_stop when the user wants proof videos with circles, boxes, arrows, underlines, or labels. For accurate timing and placement, prefer annotations returned by browser_replay_mark while the replay is recording; otherwise use exact left/top/width/height bounds from browser_locate. If the replay video size differs from the screenshot coordinate space, pass source_width and source_height.",
+      description: "Download a browser replay MP4, render visual annotations (circles/boxes/arrows/labels) over it, and save a new annotated MP4. Prefer annotations from browser_replay_mark for accurate timing; otherwise use exact bounds from browser_locate. Pass source_width/source_height if the replay video size differs from the screenshot coordinate space.",
       inputSchema: BrowserReplayAnnotateInputSchema,
       outputSchema: BrowserReplayAnnotateOutputSchema,
       annotations: annotations("Annotate Replay MP4")
@@ -28837,7 +29193,7 @@ function registerBrowserAgentMcpTools(server, opts) {
     "browser_close",
     {
       title: "Close Browser Session",
-      description: "Close and release a browser session when the task is done, when the user asks to stop the browser, or when active browser billing should end. Use browser_list_sessions first if you need to recover the session_id.",
+      description: "Close and release a browser session when the task is done, to end active browser billing. Use browser_list_sessions first to recover a session_id.",
       inputSchema: BrowserSessionInputSchema,
       outputSchema: BrowserCloseOutputSchema,
       annotations: { title: "Close Browser Session", readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: false }
@@ -28858,7 +29214,7 @@ function registerBrowserAgentMcpTools(server, opts) {
     "browser_list_sessions",
     {
       title: "List Browser Sessions",
-      description: "List browser sessions and their status, with a watch_url for each. Use this to recover a session_id, find an active browser, or decide which session to close. Use browser_open to create a new session.",
+      description: "List browser sessions and their status, with a watch_url for each. Use to recover a session_id or decide which session to close.",
       inputSchema: BrowserListInputSchema,
       outputSchema: BrowserListSessionsOutputSchema,
       annotations: annotations("List Browser Sessions", true)
@@ -28880,7 +29236,7 @@ function registerBrowserAgentMcpTools(server, opts) {
     "query_fanout_workflow",
     {
       title: "Capture AI Search Fan-Out",
-      description: `Capture the query fan-out behind a ChatGPT or Claude web-search answer for Answer Engine Optimization (AEO): the exact sub-queries the model issued, every researched URL split into cited vs browsed-only (with citation frequency and snippet), each source tagged by category (First-party/vendor, News/media, Reddit, Social/video, Encyclopedia, Review site, Docs, Blog), plus top sourced sites and citation order. Set export=true for durable JSON, CSV, TSV, and HTML artifacts; export paths are returned relative to MCP_SCRAPER_OUTPUT_DIR. This returns the raw structured data; YOU analyze it \u2014 classify each sub-query by funnel stage (Problem-aware, Solution-aware, Decision-aware, Retention) and type (BoFu, Branded, Comparison, How-to, Search operator), name the brands the model researched, and give AEO insights. Sample asks: "capture the fan-out for this ChatGPT answer", "what did Claude search and cite for best CRM", "show the sub-queries and sources behind this AI answer". WRITE NOTE: passing prompt submits a real message in the user's logged-in account (a new conversation turn) \u2014 only send when the user wants that; omit prompt to capture a prompt the user just ran. Setup, if not already connected or if the profile disconnected: call browser_profile_connect, give the user the watch_url, let them complete login, then poll browser_profile_list until status is AUTHENTICATED. After that, browser_open the saved direct no-proxy profile and go to chatgpt.com or claude.ai. Fan-out is captured only as it streams, so the session must be open when the prompt runs. NOT for Google AI Overview citations \u2014 use harvest_paa for those; this tool is ChatGPT and Claude only.`,
+      description: "Capture the query fan-out behind a ChatGPT or Claude web-search answer for AEO: sub-queries issued, every researched URL split into cited vs browsed-only, and top sourced sites. Returns raw structured data for you to classify and analyze. Set export=true for JSON/CSV/TSV/HTML artifacts. WRITE NOTE: passing prompt submits a real message in the user's logged-in account \u2014 only send when the user wants that; omit it to capture a prompt the user just ran. The session must already be open on chatgpt.com or claude.ai (see browser_profile_connect) while the prompt streams. NOT for Google AI Overview \u2014 use harvest_paa for that.",
       inputSchema: BrowserCaptureFanoutInputSchema,
       outputSchema: BrowserCaptureFanoutOutputSchema,
       annotations: annotations("Capture AI Search Fan-Out")
@@ -29036,11 +29392,11 @@ async function requireMcpCallerKey(c) {
   if (!user) return mcpAuthError();
   return callerKey;
 }
-var import_hono12, import_webStandardStreamableHttp, mcpApp;
+var import_hono14, import_webStandardStreamableHttp, mcpApp;
 var init_mcp_routes = __esm({
   "src/mcp/mcp-routes.ts"() {
     "use strict";
-    import_hono12 = require("hono");
+    import_hono14 = require("hono");
     import_webStandardStreamableHttp = require("@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js");
     init_paa_mcp_server();
     init_http_mcp_tool_executor();
@@ -29049,7 +29405,7 @@ var init_mcp_routes = __esm({
     init_db();
     init_mcp_oauth();
     configureReportSaving(false);
-    mcpApp = new import_hono12.Hono();
+    mcpApp = new import_hono14.Hono();
     mcpApp.all("/", async (c) => {
       try {
         const keyOrError = await requireMcpCallerKey(c);
@@ -29185,7 +29541,7 @@ async function listAuthConnectionsByProfile(profile) {
 }
 async function createSessionRow(input) {
   const db = getDb();
-  const id = `bas_${(0, import_node_crypto7.randomUUID)().replace(/-/g, "").slice(0, 20)}`;
+  const id = `bas_${(0, import_node_crypto9.randomUUID)().replace(/-/g, "").slice(0, 20)}`;
   await db.execute({
     sql: `INSERT INTO browser_agent_sessions (id, runtime_session_id, live_view_url, cdp_ws_url, status, label, user_id, concurrency_lock_id, last_action_at)
           VALUES (?, ?, ?, ?, 'open', ?, ?, ?, datetime('now'))`,
@@ -29254,7 +29610,7 @@ async function recordAction(input) {
     sql: `INSERT INTO browser_agent_actions (id, session_id, type, params_json, ok, error)
           VALUES (?, ?, ?, ?, ?, ?)`,
     args: [
-      `baa_${(0, import_node_crypto7.randomUUID)().replace(/-/g, "").slice(0, 20)}`,
+      `baa_${(0, import_node_crypto9.randomUUID)().replace(/-/g, "").slice(0, 20)}`,
       input.sessionId,
       input.type,
       input.params == null ? null : JSON.stringify(input.params),
@@ -29294,11 +29650,11 @@ async function listReplayRows(sessionId) {
   });
   return res.rows;
 }
-var import_node_crypto7, _ready2;
+var import_node_crypto9, _ready2;
 var init_browser_agent_db = __esm({
   "src/api/browser-agent-db.ts"() {
     "use strict";
-    import_node_crypto7 = require("crypto");
+    import_node_crypto9 = require("crypto");
     init_db();
     _ready2 = false;
   }
@@ -30573,7 +30929,7 @@ async function loadOpenSession(id, userId) {
   return row;
 }
 function buildBrowserAgentRoutes() {
-  const app2 = new import_hono13.Hono();
+  const app2 = new import_hono15.Hono();
   app2.use("*", async (c, next) => {
     await migrateBrowserAgent();
     return next();
@@ -31035,11 +31391,11 @@ function buildBrowserAgentRoutes() {
   });
   return app2;
 }
-var import_hono13, auth, DEFAULT_BROWSER_SESSION_LOCK_TTL_SECONDS;
+var import_hono15, auth, DEFAULT_BROWSER_SESSION_LOCK_TTL_SECONDS;
 var init_browser_agent_routes = __esm({
   "src/api/browser-agent-routes.ts"() {
     "use strict";
-    import_hono13 = require("hono");
+    import_hono15 = require("hono");
     init_api_auth();
     init_errors();
     init_db();
@@ -31299,168 +31655,6 @@ var init_browser_agent_console = __esm({
   }
 });
 
-// src/api/session.ts
-function getSessionSecret() {
-  const configured = process.env.SESSION_SECRET?.trim();
-  if (configured) return configured;
-  if (isProduction()) throw new Error("SESSION_SECRET is not set \u2014 add it to your Vercel env vars (see src/api/env.ts)");
-  return "dev-secret-change-me";
-}
-function safeEqualHex(a, b) {
-  if (a.length !== b.length) return false;
-  try {
-    return (0, import_node_crypto8.timingSafeEqual)(Buffer.from(a, "hex"), Buffer.from(b, "hex"));
-  } catch {
-    return false;
-  }
-}
-function signSession(userId) {
-  const payload = String(userId);
-  const sig = (0, import_node_crypto8.createHmac)("sha256", secret()).update(payload).digest("hex");
-  return `${payload}.${sig}`;
-}
-function verifySession(token) {
-  const dot = token.lastIndexOf(".");
-  if (dot === -1) return null;
-  const payload = token.slice(0, dot);
-  const sig = token.slice(dot + 1);
-  const expected = (0, import_node_crypto8.createHmac)("sha256", secret()).update(payload).digest("hex");
-  if (!safeEqualHex(sig, expected)) return null;
-  const id = parseInt(payload);
-  return isNaN(id) ? null : id;
-}
-var import_node_crypto8, isProduction, secret;
-var init_session = __esm({
-  "src/api/session.ts"() {
-    "use strict";
-    import_node_crypto8 = require("crypto");
-    isProduction = () => process.env.NODE_ENV === "production" || process.env.VERCEL === "1";
-    secret = () => getSessionSecret();
-  }
-});
-
-// src/api/memory.ts
-function isMemoryOperator(email) {
-  if (!email) return false;
-  const ops = (process.env.MEMORY_OPERATOR_IDENTITIES ?? "").split(",").map((s) => s.trim().toLowerCase()).filter(Boolean);
-  return ops.includes(email.trim().toLowerCase());
-}
-function encKey() {
-  return (0, import_node_crypto9.scryptSync)(getSessionSecret(), "mcp-memory-key-v1", 32);
-}
-function encryptMemoryKey(secret2) {
-  const iv = (0, import_node_crypto9.randomBytes)(12);
-  const cipher = (0, import_node_crypto9.createCipheriv)("aes-256-gcm", encKey(), iv);
-  const enc = Buffer.concat([cipher.update(secret2, "utf8"), cipher.final()]);
-  const tag = cipher.getAuthTag();
-  return `${iv.toString("base64")}:${tag.toString("base64")}:${enc.toString("base64")}`;
-}
-function decryptMemoryKey(stored) {
-  try {
-    const [ivB, tagB, dataB] = stored.split(":");
-    const decipher = (0, import_node_crypto9.createDecipheriv)("aes-256-gcm", encKey(), Buffer.from(ivB, "base64"));
-    decipher.setAuthTag(Buffer.from(tagB, "base64"));
-    return Buffer.concat([decipher.update(Buffer.from(dataB, "base64")), decipher.final()]).toString("utf8");
-  } catch {
-    return null;
-  }
-}
-async function memoryCall(toolName, args, userMemoryKey) {
-  try {
-    const res = await fetch(`${MEMORY_BASE_URL()}/api/mcp/memoryServer/tools/${toolName}/execute`, {
-      method: "POST",
-      headers: { "content-type": "application/json" },
-      body: JSON.stringify({ data: { ...args, apiKey: userMemoryKey } })
-    });
-    const body = await res.json().catch(() => null);
-    if (!res.ok) return { ok: false, error: body?.error ?? `memory ${toolName} failed (${res.status})` };
-    if (body?.result) return body.result;
-    return { ok: false, error: body?.error ?? `memory ${toolName} returned no result` };
-  } catch (err) {
-    return { ok: false, error: err?.message ?? "memory call failed" };
-  }
-}
-function personalVault(user) {
-  return `mcp-${user.id}`;
-}
-function memoryIdentity(user) {
-  return user.email;
-}
-function resolveMemoryIdentity(user) {
-  return memoryIdentity(user);
-}
-function memoryPlanForReads(user) {
-  if (isMemoryOperator(user.email)) return "unlimited";
-  if (user.memory_plan === "pro" || user.memory_plan === "team") return user.memory_plan;
-  return "free";
-}
-async function provisionMemoryForUser(user) {
-  try {
-    const { key } = await getOrCreateUserMemoryKey(user);
-    if (key) await setMemoryProvisioned(user.id, true);
-  } catch {
-  }
-}
-async function getOrCreateUserMemoryKey(user) {
-  const creds = await getUserMemoryCreds(user.id);
-  if (creds.memory_key) {
-    const decrypted = decryptMemoryKey(creds.memory_key);
-    if (decrypted) return { key: decrypted };
-  }
-  const admin = ADMIN_KEY();
-  if (!admin) return { key: null, error: "memory not configured (MCP_MEMORY_ADMIN_KEY missing)" };
-  const identity = memoryIdentity(user);
-  const plan = isMemoryOperator(user.email) ? "unlimited" : (await getMemoryPlan(user.id)).plan;
-  const provisioned = await memoryCall(
-    "provisionDefaultsTool",
-    { granteeIdentity: identity, issueKey: true, plan },
-    admin
-  );
-  if (!provisioned.ok || !provisioned.secret) {
-    return { key: null, error: provisioned.error ?? "failed to provision default vaults" };
-  }
-  await setUserMemoryCreds(user.id, encryptMemoryKey(provisioned.secret), identity);
-  return { key: provisioned.secret };
-}
-async function syncMemoryKeyPlan(user, plan) {
-  const effectivePlan = isMemoryOperator(user.email) ? "unlimited" : plan;
-  const { key, error } = await getOrCreateUserMemoryKey(user);
-  if (!key) return { ok: false, error: error ?? "memory unavailable" };
-  const listed = await memoryCall(
-    "listKeysTool",
-    {},
-    key
-  );
-  if (!listed.ok || !listed.keys?.length) return { ok: false, error: listed.error ?? "no memory keys found" };
-  const target = listed.keys[0];
-  if (target.plan === effectivePlan) return { ok: true };
-  const res = await memoryCall("setScopeTool", { keyId: target.keyId, plan: effectivePlan }, key);
-  return { ok: res.ok, error: res.error };
-}
-async function syncScheduleEntitlement(user, enabled, quotaPerPeriod) {
-  const admin = ADMIN_KEY();
-  if (!admin) return { ok: false, error: "memory not configured (MCP_MEMORY_ADMIN_KEY missing)" };
-  const identity = resolveMemoryIdentity(user);
-  const res = await memoryCall("setScheduleEntitlementTool", {
-    granteeIdentity: identity,
-    enabled,
-    quotaPerPeriod,
-    mcpScraperApiKey: user.api_key
-  }, admin);
-  return { ok: res.ok, error: res.error };
-}
-var import_node_crypto9, MEMORY_BASE_URL, ADMIN_KEY;
-var init_memory = __esm({
-  "src/api/memory.ts"() {
-    "use strict";
-    import_node_crypto9 = require("crypto");
-    init_session();
-    init_db();
-    MEMORY_BASE_URL = () => (process.env.MCP_MEMORY_BASE_URL ?? "https://mcp-memory-omega.vercel.app").replace(/\/$/, "");
-    ADMIN_KEY = () => process.env.MCP_MEMORY_ADMIN_KEY?.trim() ?? "";
-  }
-});
-
 // src/api/stripe-routes.ts
 function linePriceId(line) {
   const l = line;
@@ -31474,17 +31668,17 @@ async function resolveUser(customerId, emailFallback) {
   if (user) await setStripeCustomerId(user.id, customerId);
   return user;
 }
-var import_stripe, import_hono14, stripe, stripeApp;
+var import_stripe, import_hono16, stripe, stripeApp;
 var init_stripe_routes = __esm({
   "src/api/stripe-routes.ts"() {
     "use strict";
     import_stripe = __toESM(require("stripe"), 1);
-    import_hono14 = require("hono");
+    import_hono16 = require("hono");
     init_db();
     init_rates();
     init_memory();
     stripe = new import_stripe.default(process.env.STRIPE_SECRET_KEY, { apiVersion: "2026-02-25.clover" });
-    stripeApp = new import_hono14.Hono();
+    stripeApp = new import_hono16.Hono();
     stripeApp.post("/webhooks", async (c) => {
       const sig = c.req.header("stripe-signature");
       const body = await c.req.text();
@@ -31775,11 +31969,11 @@ async function mintAccessToken(identity, scope, plan, audience) {
 function tokenErrorResponse(c, error, description, status) {
   return c.json({ error, error_description: description }, status);
 }
-var import_hono15, import_cookie, import_node_crypto10, import_jose2, ISSUER, RESOURCE, SCRAPER_RESOURCE, MEMORY_SCOPES, SCRAPER_SCOPES, SUPPORTED_SCOPES, ACCESS_TTL_SECONDS, REFRESH_TTL_SECONDS, CODE_TTL_SECONDS, secureCookies, sessionCookieOptions, cachedKeys, oauthApp;
+var import_hono17, import_cookie, import_node_crypto10, import_jose2, ISSUER, RESOURCE, SCRAPER_RESOURCE, MEMORY_SCOPES, SCRAPER_SCOPES, SUPPORTED_SCOPES, ACCESS_TTL_SECONDS, REFRESH_TTL_SECONDS, CODE_TTL_SECONDS, ROTATION_GRACE_SECONDS, secureCookies, sessionCookieOptions, cachedKeys, oauthApp;
 var init_oauth_routes = __esm({
   "src/api/oauth-routes.ts"() {
     "use strict";
-    import_hono15 = require("hono");
+    import_hono17 = require("hono");
     import_cookie = require("hono/cookie");
     import_node_crypto10 = require("crypto");
     import_jose2 = require("jose");
@@ -31796,6 +31990,7 @@ var init_oauth_routes = __esm({
     ACCESS_TTL_SECONDS = 3600;
     REFRESH_TTL_SECONDS = 60 * 60 * 24 * 30;
     CODE_TTL_SECONDS = 60;
+    ROTATION_GRACE_SECONDS = 120;
     secureCookies = process.env.NODE_ENV === "production" || process.env.VERCEL === "1";
     sessionCookieOptions = {
       httpOnly: true,
@@ -31805,7 +32000,7 @@ var init_oauth_routes = __esm({
       sameSite: "Lax"
     };
     cachedKeys = null;
-    oauthApp = new import_hono15.Hono();
+    oauthApp = new import_hono17.Hono();
     oauthApp.use("*", async (c, next) => {
       c.header("Access-Control-Allow-Origin", "*");
       c.header("Access-Control-Allow-Methods", "GET, POST, OPTIONS");
@@ -31974,6 +32169,13 @@ var init_oauth_routes = __esm({
         const refreshToken = get("refresh_token") ?? "";
         const clientId = get("client_id") ?? "";
         const record = await getRefresh(refreshToken);
+        if (record && record.revoked && record.replaced_by && record.rotated_at && Date.now() - new Date(record.rotated_at).getTime() < ROTATION_GRACE_SECONDS * 1e3 && (!clientId || record.client_id === clientId)) {
+          const graceUser = await getUserByEmail(record.identity);
+          const gracePlan = graceUser ? resolvePlan(graceUser) : "free";
+          const graceAudience = record.resource ?? RESOURCE();
+          const graceAccess = await mintAccessToken(record.identity, record.scope, gracePlan, graceAudience);
+          return c.json({ access_token: graceAccess, token_type: "Bearer", expires_in: ACCESS_TTL_SECONDS, refresh_token: record.replaced_by, scope: record.scope });
+        }
         if (!record || record.revoked) return tokenErrorResponse(c, "invalid_grant", "Refresh token is invalid or revoked", 400);
         if (new Date(record.expires_at).getTime() < Date.now()) return tokenErrorResponse(c, "invalid_grant", "Refresh token has expired", 400);
         if (clientId && record.client_id !== clientId) return tokenErrorResponse(c, "invalid_grant", "client_id mismatch", 400);
@@ -32543,13 +32745,13 @@ loadChannels();
 </body>
 </html>`;
 }
-var import_hono16, chatApp;
+var import_hono18, chatApp;
 var init_chat_routes = __esm({
   "src/api/chat-routes.ts"() {
     "use strict";
-    import_hono16 = require("hono");
+    import_hono18 = require("hono");
     init_memory();
-    chatApp = new import_hono16.Hono();
+    chatApp = new import_hono18.Hono();
     chatApp.get("/api/channels", async (c) => {
       const token = c.req.query("token");
       if (!tokenOk(token)) return jsonError("missing or malformed token", 401);
@@ -32939,13 +33141,13 @@ loadActions();
 </body>
 </html>`;
 }
-var import_hono17, scheduleApp;
+var import_hono19, scheduleApp;
 var init_schedule_routes = __esm({
   "src/api/schedule-routes.ts"() {
     "use strict";
-    import_hono17 = require("hono");
+    import_hono19 = require("hono");
     init_memory();
-    scheduleApp = new import_hono17.Hono();
+    scheduleApp = new import_hono19.Hono();
     scheduleApp.get("/api/status", async (c) => {
       const token = c.req.query("token");
       if (!tokenOk2(token)) return jsonError2("missing or malformed token", 401);
@@ -33636,6 +33838,7 @@ function opForCostPath(p) {
   if (p.startsWith("/instagram/")) return "instagram";
   if (p === "/reddit/thread") return "reddit_thread";
   if (p.startsWith("/api/internal/site-architecture-auditor")) return "audit_site";
+  if (p.startsWith("/api/internal/memory")) return "memory_ai";
   if (p.startsWith("/agent/")) return "browser_session";
   return null;
 }
@@ -33689,7 +33892,7 @@ async function checkHarvestLimits(user, reuseLockId) {
   }
   return null;
 }
-var import_resend, import_hono18, import_hono19, import_factory6, import_cookie2, import_stripe2, secureCookies2, isProduction2, sessionCookieOptions2, requireAllowedOrigin, auth2, adminAuth, sessionAuth, app, STRIPE_API_VERSION, SYNC_HARVEST_TIMEOUT_OVERRIDE_MS;
+var import_resend, import_hono20, import_hono21, import_factory6, import_cookie2, import_stripe2, secureCookies2, isProduction2, sessionCookieOptions2, requireAllowedOrigin, auth2, adminAuth, sessionAuth, app, STRIPE_API_VERSION, SYNC_HARVEST_TIMEOUT_OVERRIDE_MS;
 var init_server = __esm({
   "src/api/server.ts"() {
     "use strict";
@@ -33707,20 +33910,22 @@ var init_server = __esm({
     init_media_extractor();
     init_site_mapper();
     init_site_extractor();
-    import_hono18 = require("hono");
-    import_hono19 = require("inngest/hono");
+    import_hono20 = require("hono");
+    import_hono21 = require("inngest/hono");
     init_client();
     init_site_audit();
     init_site_extract();
     init_site_extract_repository();
     init_catalog_seed();
     init_site_audit_routes();
+    init_internal_memory_routes();
     init_youtube_routes();
     init_screenshot_routes();
     init_facebook_ad_routes();
     init_google_ads_routes();
     init_instagram_routes();
     init_reddit_routes();
+    init_video_routes();
     init_maps_routes();
     init_directory_routes();
     init_workflow_routes();
@@ -33797,7 +34002,7 @@ var init_server = __esm({
       c.set("sessionUser", { ...refreshed, balance_mc: balanceMc });
       return next();
     });
-    app = new import_hono18.Hono();
+    app = new import_hono20.Hono();
     STRIPE_API_VERSION = "2026-02-25.clover";
     app.use("*", async (c, next) => {
       await next();
@@ -33879,6 +34084,27 @@ var init_server = __esm({
       (0, import_cookie2.deleteCookie)(c, "session", { path: "/", secure: secureCookies2, sameSite: "Strict" });
       return c.json({ ok: true });
     });
+    app.post("/account/delete", requireAllowedOrigin, sessionAuth, async (c) => {
+      const user = c.get("sessionUser");
+      const secret2 = requireStripeSecret();
+      if (secret2 && user.stripe_customer_id) {
+        const stripeClient = new import_stripe2.default(secret2, { apiVersion: STRIPE_API_VERSION });
+        const subs = await stripeClient.subscriptions.list({ customer: user.stripe_customer_id, status: "all", limit: 100 });
+        for (const sub of subs.data) {
+          if (sub.status === "active" || sub.status === "trialing" || sub.status === "past_due") {
+            try {
+              await stripeClient.subscriptions.cancel(sub.id);
+            } catch (err) {
+              console.error("[account/delete] failed to cancel subscription", sub.id, err instanceof Error ? err.message : String(err));
+              return c.json({ error: "Could not cancel an active subscription \u2014 please try again or contact support." }, 500);
+            }
+          }
+        }
+      }
+      await deactivateUser(user.id);
+      (0, import_cookie2.deleteCookie)(c, "session", { path: "/", secure: secureCookies2, sameSite: "Strict" });
+      return c.json({ ok: true });
+    });
     app.post("/auth/forgot-password", requireAllowedOrigin, async (c) => {
       const { email } = await c.req.json();
       const normalizedEmail = email?.trim().toLowerCase();
@@ -34851,6 +35077,24 @@ var init_server = __esm({
         return c.json({ error: message }, 500);
       }
     });
+    app.post("/billing/portal", requireAllowedOrigin, sessionAuth, async (c) => {
+      try {
+        const user = c.get("sessionUser");
+        if (!user.stripe_customer_id) return c.json({ error: "No billing account yet \u2014 subscribe first." }, 409);
+        const secret2 = requireStripeSecret();
+        if (!secret2) return c.json({ error: "Stripe is not configured." }, 503);
+        const stripeClient = new import_stripe2.default(secret2, { apiVersion: STRIPE_API_VERSION });
+        const session = await stripeClient.billingPortal.sessions.create({
+          customer: user.stripe_customer_id,
+          return_url: `${appOrigin()}/billing`
+        });
+        return c.json({ url: session.url });
+      } catch (err) {
+        const message = err instanceof Error ? err.message : "Unable to open billing portal.";
+        console.error("[billing/portal]", message);
+        return c.json({ error: message }, 500);
+      }
+    });
     app.post("/billing/concurrency/terminal-checkout", auth2, async (c) => {
       try {
         const user = c.get("user");
@@ -35031,14 +35275,16 @@ var init_server = __esm({
       ]);
       return c.json({ drained: results.length, results, sweepResult, reaped: reapResult, expired: expiredResult, blobCleanup, workflowDispatch: workflowDispatchResult });
     });
-    app.on(["GET", "POST", "PUT"], "/api/inngest", (0, import_hono19.serve)({ client: inngest, functions: [siteAuditFn, siteExtractFn] }));
+    app.on(["GET", "POST", "PUT"], "/api/inngest", (0, import_hono21.serve)({ client: inngest, functions: [siteAuditFn, siteExtractFn] }));
     app.route("/api/internal/site-architecture-auditor", siteAuditApp);
+    app.route("/api/internal/memory", internalMemoryApp);
     app.route("/youtube", youtubeApp);
     app.route("/screenshot", screenshotApp);
     app.route("/facebook", facebookAdApp);
     app.route("/google-ads", googleAdsApp);
     app.route("/instagram", instagramApp);
     app.route("/reddit", redditApp);
+    app.route("/video", videoApp);
     app.route("/maps", mapsApp);
     app.route("/directory", directoryApp);
     app.route("/workflows", workflowApp);