mcp-scraper 0.51.1 → 0.52.0

package/dist/bin/mcp-stdio-server.cjs

@@ -979,7 +979,7 @@ render();
 }
 
 // src/version.ts
-var PACKAGE_VERSION = "0.51.1";
+var PACKAGE_VERSION = "0.52.0";
 
 // src/mcp/browser-agent-tool-schemas.ts
 var import_zod = require("zod");
@@ -4491,6 +4491,7 @@ ${[h1Lines, h2Lines].filter(Boolean).join("\n")}` : "";
     kpo.address ? `- **Address:** ${kpo.address}` : "",
     kpo.phone ? `- **Phone:** ${kpo.phone}` : "",
     kpo.email ? `- **Email:** ${kpo.email}` : "",
+    kpo.logo ? `- **Structured-data logo:** ${kpo.logo}` : "",
     kpo.faqCount ? `- **FAQ items:** ${kpo.faqCount}` : "",
     kpo.sameAs?.length ? `- **sameAs:** ${kpo.sameAs.slice(0, 5).join(", ")}` : "",
     kpo.missingFields?.length ? `
@@ -4525,15 +4526,23 @@ ${mem.error ?? "unknown error"} \u2014 the page content is still in the truncate
 ## Branding`,
     branding.colorScheme ? `- **Color scheme:** ${branding.colorScheme}` : "",
     `- **Colors:**${Object.entries(branding.colors ?? {}).filter(([, v]) => v).map(([k, v]) => ` ${k}=${v}`).join(",") || " (none extracted)"}`,
+    branding.colorEvidence ? `- **Color evidence:**${Object.entries(branding.colorEvidence).filter(([, v]) => v).map(([key, value]) => value ? ` ${key}=${value.source}/${value.confidence}${value.detail ? ` (${value.detail})` : ""}` : "").join(";") || " (none)"}` : "",
     `- **Fonts:**${Object.entries(branding.fonts ?? {}).filter(([, v]) => v).map(([k, v]) => ` ${k}=${v}`).join(",") || " (none extracted)"}`,
-    branding.assets?.logo ? `- **Logo:** ${branding.assets.logo}` : "",
+    branding.assets?.logo ? `- **Logo:** ${branding.assets.logo}${branding.assets.logoConfidence ? ` (${branding.assets.logoConfidence} confidence)` : ""}` : "- **Logo:** no candidate cleared the evidence threshold",
+    branding.assets?.logoSelectionReason ? `- **Logo evidence:** ${branding.assets.logoSelectionReason}` : "",
+    branding.assets?.logoVariants?.length ? `- **Logo variants:** ${branding.assets.logoVariants.join(", ")}` : "",
+    branding.assets?.proofImages?.length ? `- **Proof images:** ${branding.assets.proofImages.map((image) => `${image.proofType} (${image.confidence}) \u2014 ${image.url}${image.context ? ` [${image.context}]` : ""}`).join("; ")}` : "",
     branding.assets?.favicon ? `- **Favicon:** ${branding.assets.favicon}` : ""
   ].filter(Boolean).join("\n") : "";
   const mediaSection = media ? [
     `
 ## Media Assets`,
-    `- **Found:** ${media.totalFound} total, ${media.filteredCount} filtered (ads/noise), ${media.assets.length} downloaded`,
-    media.outputDir ? `- **Saved to:** ${media.outputDir}` : ""
+    `- **Discovery:** ${media.totalFound} candidates (${media.staticFound} static, ${media.renderedFound} rendered); ${media.assets.length} retained after filtering and responsive-variant collapse`,
+    `- **Downloads:** ${media.assets.filter((asset) => asset.downloadStatus === "downloaded").length} succeeded, ${media.assets.filter((asset) => asset.downloadStatus === "failed").length} failed`,
+    `- **Completeness:** ${media.completeness} \u2014 ${media.exhausted ? "rendered page exhausted after stable scrolling" : `stopped with ${media.stopReason}; more media may exist`}`,
+    media.outputDir ? `- **Saved to:** ${media.outputDir}` : "",
+    media.artifact ? `- **ZIP artifact:** \`${String(media.artifact.artifactId ?? "")}\` (use \`archive_read\` for \`summary.json\` or \`media.jsonl\`)` : "",
+    ...media.warnings.map((warning) => `- ${warning}`)
   ].filter(Boolean).join("\n") : "";
   const archiveSection = archive ? `
 ## Wayback Capture
@@ -4560,6 +4569,25 @@ ${archiveSection}${headingSection}${kpoSection}${brandingSection}${featuredImage
 ${archiveSection}${headingSection}${kpoSection}${brandingSection}${featuredImageSection}${bodySectionFull}${memSection}${screenshotSection}${mediaSection}${tips}`;
   const localBlock = oneBlockWithLocalPath(full, diskReport);
   const textResult = localBlock.result;
+  const structuredMediaAssets = media?.assets.map((asset) => {
+    const { inlinePreview: _preview, ...clean } = asset;
+    return { ...clean, contentIndex: null };
+  }) ?? null;
+  const structuredMedia = media ? {
+    pageUrl: url,
+    staticFound: media.staticFound,
+    renderedFound: media.renderedFound,
+    totalFound: media.totalFound,
+    filteredCount: media.filteredCount,
+    retainedCount: media.assets.length,
+    completeness: media.completeness,
+    exhausted: media.exhausted,
+    stopReason: media.stopReason,
+    scrollRounds: media.scrollRounds,
+    warnings: media.warnings,
+    assets: structuredMediaAssets,
+    artifact: media.artifact
+  } : null;
   const structuredContent = {
     url,
     title: d.title ?? null,
@@ -4567,6 +4595,7 @@ ${archiveSection}${headingSection}${kpoSection}${brandingSection}${featuredImage
     schemaBlockCount: schemaCount,
     entityName: kpo?.entityName ?? null,
     entityTypes: kpo?.type ?? [],
+    structuredDataLogo: kpo?.logo ?? null,
     napScore: kpo?.napScore ?? null,
     missingSchemaFields: kpo?.missingFields ?? [],
     screenshotSaved: screenshotPath ?? null,
@@ -4574,12 +4603,44 @@ ${archiveSection}${headingSection}${kpoSection}${brandingSection}${featuredImage
     archive: archive ?? null,
     featuredImage: featuredImage ?? null,
     branding: branding ?? null,
-    mediaAssets: media?.assets ?? null,
+    mediaAssets: structuredMediaAssets,
+    media: structuredMedia,
     memory: mem ?? void 0,
     memoryImages: d.memoryImages ?? void 0,
     delivery: d.delivery ?? void 0,
     localPath: localBlock.localPath ?? void 0
   };
+  const attachMedia = (base, baseStructured) => {
+    const content = [...base.content];
+    if (screenshotMeta?.base64) content.push({ type: "image", data: screenshotMeta.base64, mimeType: "image/png" });
+    const assets = structuredMediaAssets?.map((asset) => ({ ...asset })) ?? null;
+    for (let index = 0; index < (media?.assets.length ?? 0); index += 1) {
+      const preview = media?.assets[index]?.inlinePreview;
+      if (!preview?.data || !preview.mimeType) continue;
+      if (assets?.[index]) assets[index].contentIndex = content.length;
+      content.push({ type: "image", data: preview.data, mimeType: preview.mimeType });
+    }
+    const artifact = media?.artifact;
+    if (artifact && typeof artifact.downloadUrl === "string") {
+      content.push({
+        type: "resource_link",
+        name: String(artifact.filename ?? "website-media.zip"),
+        title: `Download media from ${title}`,
+        uri: artifact.downloadUrl,
+        mimeType: "application/zip",
+        size: typeof artifact.bytes === "number" ? artifact.bytes : void 0
+      });
+    }
+    return {
+      ...base,
+      content,
+      structuredContent: {
+        ...baseStructured,
+        mediaAssets: assets,
+        media: structuredMedia ? { ...structuredMedia, assets } : null
+      }
+    };
+  };
   if (input.delivery !== "inline" && input.delivery !== "memory") {
     const offloaded = await maybeOffload(
       "extract_url",
@@ -4599,22 +4660,12 @@ The full extraction is available as an owned artifact.`,
         retained: true,
         nextAction: "Use report_artifact_read with artifact.artifactId."
       };
-      return {
-        ...offloaded,
-        structuredContent: { ...structuredRecord(offloaded.structuredContent), delivery }
-      };
+      return attachMedia({
+        ...offloaded
+      }, { ...structuredRecord(offloaded.structuredContent), delivery });
     }
   }
-  if (screenshotMeta?.base64) {
-    return {
-      content: [
-        ...textResult.content,
-        { type: "image", data: screenshotMeta.base64, mimeType: "image/png" }
-      ],
-      structuredContent
-    };
-  }
-  return { ...textResult, structuredContent };
+  return attachMedia(textResult, structuredContent);
 }
 var DIFF_PAGE_PREVIEW_HUNKS = 20;
 function formatDiffPage(raw, input) {
@@ -6391,6 +6442,7 @@ function formatMapsPlaceIntel(raw, input) {
   const lat = d.lat;
   const lng = d.lng;
   const durationMs = d.durationMs;
+  const placeUrl = d.placeUrl;
   const histogram = d.reviewHistogram ?? [];
   const topics = d.reviewTopics ?? [];
   const about = d.aboutAttributes ?? [];
@@ -6399,6 +6451,10 @@ function formatMapsPlaceIntel(raw, input) {
   const services = d.services ?? [];
   const areasServed = d.areasServed ?? [];
   const servicesStatus = d.servicesStatus ?? "not_requested";
+  const media = structuredRecord(d.media);
+  const mediaImages = Array.isArray(media.images) ? media.images.map(structuredRecord) : [];
+  const mediaArtifact = media.artifact && typeof media.artifact === "object" && !Array.isArray(media.artifact) ? media.artifact : null;
+  const mediaWarnings = Array.isArray(media.warnings) ? media.warnings.map(String) : [];
   const hoursTable = d.hoursTable ?? [];
   const ratingLine = [rating, reviewCount ? `(${reviewCount} reviews)` : null].filter(Boolean).join(" ");
   const basicLines = [
@@ -6466,6 +6522,35 @@ ${areasServed.map((a) => `- ${a}`).join("\n")}` : null
     return parts.length ? `
 ## Services & Areas Served
 ${parts.join("\n\n")}` : "";
+  })();
+  const mediaSection = (() => {
+    const status = String(media.status ?? "not_requested");
+    if (status === "not_requested") return "";
+    if (status === "unavailable") return "\n## Images\n> The Google Maps photo gallery could not be retrieved in this run.";
+    const counts = [
+      `${Number(media.imagesCollected ?? mediaImages.length)} collected`,
+      `${Number(media.imagesDownloaded ?? 0)} downloaded`,
+      `${Number(media.ownerImagesCollected ?? 0)} owner`,
+      `${Number(media.otherImagesCollected ?? 0)} other`,
+      `${Number(media.unknownOriginImagesCollected ?? 0)} unknown origin`
+    ].join(" \xB7 ");
+    const completion = media.exhausted === true ? "Gallery exhausted after three stable quiescence checks." : `Collection stopped with \`${String(media.stopReason ?? "unknown")}\`; more photos may exist.`;
+    const artifactLines = mediaArtifact ? [
+      `- **ZIP artifact:** \`${String(mediaArtifact.artifactId ?? "")}\``,
+      typeof mediaArtifact.downloadUrl === "string" ? `- **Download:** ${mediaArtifact.downloadUrl}` : null,
+      typeof mediaArtifact.localPath === "string" ? `- **Local file:** \`${mediaArtifact.localPath}\`` : null,
+      "- **AI readback:** call `archive_read` with the artifactId, then read `summary.json` or `images.jsonl`."
+    ].filter(Boolean).join("\n") : "";
+    const provenance = Number(media.otherImagesCollected ?? 0) > 0 || Number(media.unknownOriginImagesCollected ?? 0) > 0 ? "\n> `other` means absent from a fully exhausted **By owner** gallery. It may include customer, review, Street View, Google, or unattributed media; MCP Scraper does not relabel it as review imagery without evidence." : "";
+    return `
+## Images
+**${counts}**
+
+${completion}${provenance}${artifactLines ? `
+
+${artifactLines}` : ""}${mediaWarnings.length ? `
+
+${mediaWarnings.map((warning) => `- ${warning}`).join("\n")}` : ""}`;
   })();
   const full = [
     `# ${name}`,
@@ -6483,14 +6568,49 @@ ${basicLines}` : null,
 ${entitySection}` : null,
     reviewsSection,
     servicesSection,
+    mediaSection,
     durationMs != null ? `
 ---
 *Extracted in ${(durationMs / 1e3).toFixed(1)}s*` : null
   ].filter(Boolean).join("\n");
+  const content = [{ type: "text", text: full }];
+  const structuredImages = mediaImages.map((image) => {
+    const preview = structuredRecord(image.inlinePreview);
+    let contentIndex = null;
+    if (typeof preview.data === "string" && typeof preview.mimeType === "string") {
+      contentIndex = content.length;
+      content.push({ type: "image", data: preview.data, mimeType: preview.mimeType });
+    }
+    return {
+      index: Number(image.index ?? 0),
+      galleryPosition: typeof image.galleryPosition === "number" ? image.galleryPosition : null,
+      sourceUrl: String(image.sourceUrl ?? ""),
+      mediaKey: String(image.mediaKey ?? ""),
+      origin: image.origin === "owner" || image.origin === "other" ? image.origin : "unknown",
+      originConfidence: String(image.originConfidence ?? ""),
+      filename: typeof image.filename === "string" ? image.filename : null,
+      mimeType: typeof image.mimeType === "string" ? image.mimeType : null,
+      bytes: typeof image.bytes === "number" ? image.bytes : null,
+      downloadStatus: typeof image.downloadStatus === "string" ? image.downloadStatus : "not_attempted",
+      downloadError: typeof image.downloadError === "string" ? image.downloadError : null,
+      contentIndex
+    };
+  });
+  if (mediaArtifact && typeof mediaArtifact.downloadUrl === "string") {
+    content.push({
+      type: "resource_link",
+      name: String(mediaArtifact.filename ?? "Google Maps images.zip"),
+      title: `Download ${name} Google Maps images`,
+      uri: mediaArtifact.downloadUrl,
+      mimeType: "application/zip",
+      size: typeof mediaArtifact.bytes === "number" ? mediaArtifact.bytes : void 0
+    });
+  }
   return {
-    ...oneBlock(full),
+    content,
     structuredContent: {
       name,
+      placeUrl: placeUrl ?? null,
       rating: rating ?? null,
       reviewCount: reviewCount ?? null,
       category: category ?? null,
@@ -6498,6 +6618,8 @@ ${entitySection}` : null,
       phone: phone ?? null,
       website: website ?? null,
       hoursSummary: hoursSummary ?? null,
+      hoursTable,
+      plusCode: plusCode ?? null,
       bookingUrl: bookingUrl ?? null,
       kgmid: kgmid ?? null,
       cidDecimal: cidDecimal ?? null,
@@ -6506,10 +6628,49 @@ ${entitySection}` : null,
       lng: lng ?? null,
       reviewsStatus,
       reviewsCollected: reviews.length,
+      reviews: reviews.map((review) => ({
+        reviewId: review.reviewId ?? null,
+        author: review.author ?? null,
+        stars: review.stars ?? null,
+        date: review.date ?? null,
+        text: review.text ?? null,
+        ownerResponse: review.ownerResponse ?? null
+      })),
+      reviewHistogram: histogram.map((row) => ({ stars: Number(row.stars), count: String(row.count ?? "") })),
       reviewTopics: topics.map((t) => ({ label: String(t.label ?? ""), count: String(t.count ?? "") })),
       services,
       areasServed,
-      servicesStatus
+      servicesStatus,
+      aboutAttributes: about.map((row) => ({ section: String(row.section ?? ""), attribute: String(row.attribute ?? "") })),
+      media: {
+        status: String(media.status ?? "not_requested"),
+        scope: media.scope === "owner" ? "owner" : "all",
+        requestedMaxImages: Number(media.requestedMaxImages ?? 100),
+        imagesCollected: Number(media.imagesCollected ?? structuredImages.length),
+        imagesDownloaded: Number(media.imagesDownloaded ?? 0),
+        ownerImagesCollected: Number(media.ownerImagesCollected ?? 0),
+        otherImagesCollected: Number(media.otherImagesCollected ?? 0),
+        unknownOriginImagesCollected: Number(media.unknownOriginImagesCollected ?? 0),
+        ownerGalleryAvailable: media.ownerGalleryAvailable === true,
+        ownerGalleryExhausted: media.ownerGalleryExhausted === true,
+        ownerPhotosDiscovered: Number(media.ownerPhotosDiscovered ?? 0),
+        allPhotosDiscovered: Number(media.allPhotosDiscovered ?? 0),
+        exhausted: media.exhausted === true,
+        stopReason: String(media.stopReason ?? "not_requested"),
+        images: structuredImages,
+        artifact: mediaArtifact ? {
+          artifactId: String(mediaArtifact.artifactId ?? ""),
+          filename: String(mediaArtifact.filename ?? ""),
+          contentType: String(mediaArtifact.contentType ?? "application/zip"),
+          bytes: Number(mediaArtifact.bytes ?? 0),
+          sha256: String(mediaArtifact.sha256 ?? ""),
+          expiresAt: String(mediaArtifact.expiresAt ?? ""),
+          downloadUrl: typeof mediaArtifact.downloadUrl === "string" ? mediaArtifact.downloadUrl : null,
+          downloadUrlExpiresAt: typeof mediaArtifact.downloadUrlExpiresAt === "string" ? mediaArtifact.downloadUrlExpiresAt : null,
+          localPath: typeof mediaArtifact.localPath === "string" ? mediaArtifact.localPath : null
+        } : null,
+        warnings: mediaWarnings
+      }
     }
   };
 }
@@ -6970,7 +7131,7 @@ seam is noted so you can chain them.
   \`extract_url\` or \`reddit_thread\`.
 
 ## Pages & sites
-- One page -> **extract_url** (takes a url).
+- One page -> **extract_url** (takes a url). Set \`preserveMedia:true\` only when the user wants the actual page media; it returns static-plus-rendered provenance, bounded image blocks, and an owner-scoped ZIP readable with \`archive_read\`.
 - Whole site, crawl + SEO report -> **extract_site** (takes a url).
 - Wayback replay URLs work with the same tools: \`extract_url\` removes playback chrome and can return
   a featured image; \`extract_site\` batches nearby archived HTML captures for the replayed site.
@@ -7057,8 +7218,9 @@ seam is noted so you can chain them.
   placeUrl, cid; set \`includeServices: true\` to enrich each result where available).
 - One business deep-dive -> **maps_place_intel** (takes businessName + location, NOT an id; returns
   reviews, full hours, About attributes, entity IDs/CID, and with \`includeServices: true\`, the full
-  configured services and areas-served lists. Call it directly with a name from a \`maps_search\` result
-  or from the user).
+  configured services and areas-served lists. Set \`includeImages:true\` only when photos are requested;
+  use \`imageScope:"owner"\` for listing-owner photos or \`"all"\` for the full evidence-labeled gallery.
+  Call it directly with a name from a \`maps_search\` result or from the user).
 
 ## YouTube
 - Find or list videos -> **youtube_harvest** (returns \`videos[].videoId\`).
@@ -7240,12 +7402,15 @@ note, registers canonical tags, writes it, and verifies readback. Reserve low-le
 deliberate edits and migrations. Use
 **table-create**/**table-insert-rows**/**table-query** instead when the caller wants row-shaped data
 they'll filter/sort by exact value. **memory-search** is meaning-based over full content (embeds, slower);
-**memory-list** filters one vault by kind/tags (fast, exact).
+**memory-list** filters one vault by kind/tags (fast, exact), or lists the whole entitled account when
+\`allVaults:true\`.
 
-Choose the read surface by completeness, not convenience. **list-vaults** is the account inventory and
-reports each vault's note count. **memory-list** returns the complete metadata inventory for one vault but
-no note bodies, plus a sorted complete folder inventory derived from those paths; use it to identify every
-stable \`vault + path\` address. **list-memory-tags** returns the
+Choose the read surface by completeness, not convenience. **list-vaults** is the compact account inventory and
+reports each vault's note count. **memory-list** returns the complete metadata inventory for one vault by
+default, with no note bodies and a sorted complete folder inventory derived from those paths. When the user
+asks for every note or folder they have across Memory, call **memory-list** once with \`allVaults:true\`; use
+its account totals and per-vault groups, and never present the default single-vault count as the account
+total. Use the result to identify every stable \`vault + path\` address. **list-memory-tags** returns the
 complete account-wide canonical tag inventory, including aliases, usage counts, and per-vault distribution.
 **memory-search** returns ranked
 content chunks, not an exhaustive inventory or complete documents: deduplicate hits by vault/path and call
@@ -8190,8 +8355,10 @@ var ExtractUrlBaseInputSchema = {
   includeFeaturedImage: import_zod6.z.boolean().default(false).describe("Return the best featured image from Open Graph, Twitter, JSON-LD, or page content. For Wayback replay URLs, also returns the timestamp-matched archived image URL when available."),
   downloadMedia: import_zod6.z.boolean().optional().describe("Deprecated alias for preserveMedia. Omit when using preserveMedia; when omitted, media preservation defaults to false."),
   mediaTypes: import_zod6.z.array(import_zod6.z.enum(["image", "video", "audio"])).default(["image", "video", "audio"]).describe("Which media types to download. Default all three."),
+  maxMediaAssets: import_zod6.z.number().int().min(1).max(250).default(100).describe("Maximum media records to retain and attempt to download after filtering and responsive-variant collapse."),
+  maxInlineImages: import_zod6.z.number().int().min(0).max(5).default(3).describe("Maximum downloaded images to attach as AI-readable image content blocks. All successfully downloaded media remains available in the ZIP."),
   delivery: import_zod6.z.enum(["auto", "inline", "artifact", "memory"]).default("auto").describe("Where to deliver the result. auto keeps small results inline and offloads large ones; artifact always returns an owned artifact; memory stores the full page in hosted Memory; inline returns a bounded response."),
-  preserveMedia: import_zod6.z.boolean().default(false).describe("Preserve discovered media in the result workflow. This is the preferred replacement for downloadMedia."),
+  preserveMedia: import_zod6.z.boolean().default(false).describe("Collect media from static source plus a rendered, lazy-loaded page; collapse responsive variants; return provenance and completeness; attach bounded image previews; and create an owner-scoped ZIP readable with archive_read."),
   depositToVault: import_zod6.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_zod6.z.string().trim().min(1).max(120).optional().describe("Optional vault to deposit into. Defaults to the user's personal vault.")
 };
@@ -8349,7 +8516,11 @@ var MapsPlaceIntelInputSchema = {
   hl: import_zod6.z.string().length(2).default("en").describe("Language inferred from user request."),
   includeReviews: import_zod6.z.boolean().default(false).describe("Fetch individual review cards \u2014 for reviews, customer pain, complaints, or praise themes."),
   maxReviews: import_zod6.z.number().int().min(1).max(500).default(50).describe("Max review cards when includeReviews is true. Default 50, maximum 500."),
-  includeServices: import_zod6.z.boolean().default(false).describe("Fetch the business's configured services list and areas-served list, when the profile has them. Adds one extra page visit; not present for every business.")
+  includeServices: import_zod6.z.boolean().default(false).describe("Fetch the business's configured services list and areas-served list, when the profile has them. Adds one extra page visit; not present for every business."),
+  includeImages: import_zod6.z.boolean().default(false).describe("Collect Google Maps listing photos, download them, and return an AI-readable manifest plus an owner-scoped ZIP artifact. The gallery is scrolled until quiescent or maxImages is reached."),
+  imageScope: import_zod6.z.enum(["owner", "all"]).default("all").describe("owner collects only the Google Maps By owner gallery. all collects the full gallery and labels exact owner matches versus other/unknown media."),
+  maxImages: import_zod6.z.number().int().min(1).max(250).default(100).describe("Maximum photos to collect when includeImages is true. Default 100, maximum 250."),
+  maxInlineImages: import_zod6.z.number().int().min(0).max(5).default(3).describe("Maximum downloaded photos attached as MCP image blocks for direct AI vision. The ZIP and structured manifest still contain the wider result.")
 };
 var TrustpilotReviewsInputSchema = {
   domain: import_zod6.z.string().min(1).describe(`The business's domain as it appears in its Trustpilot URL, e.g. "www.bhphotovideo.com" (include the www. if the site uses it \u2014 pass the domain as-is, do not guess).`),
@@ -9106,6 +9277,37 @@ var SearchSerpOutputSchema = {
   aiOverview: AiOverviewOutput,
   entityIds: EntityIdsOutput
 };
+var PageMediaAssetOutput = import_zod6.z.object({
+  url: import_zod6.z.string(),
+  type: import_zod6.z.enum(["image", "video", "audio"]),
+  mimeType: NullableString2,
+  filename: import_zod6.z.string(),
+  savedPath: NullableString2,
+  sizeBytes: import_zod6.z.number().int().min(0).nullable(),
+  discoveryMethods: import_zod6.z.array(import_zod6.z.string()),
+  altTexts: import_zod6.z.array(import_zod6.z.string()),
+  contexts: import_zod6.z.array(import_zod6.z.string()),
+  width: import_zod6.z.number().int().min(0).nullable(),
+  height: import_zod6.z.number().int().min(0).nullable(),
+  variants: import_zod6.z.array(import_zod6.z.string()),
+  finalUrl: NullableString2.optional(),
+  duplicateOf: NullableString2.optional(),
+  sha256: NullableString2.optional(),
+  downloadStatus: import_zod6.z.enum(["downloaded", "failed", "not_attempted"]).optional(),
+  downloadError: NullableString2.optional(),
+  contentIndex: import_zod6.z.number().int().min(0).nullable()
+});
+var PageMediaArtifactOutput = import_zod6.z.object({
+  artifactId: import_zod6.z.string(),
+  filename: import_zod6.z.string(),
+  contentType: import_zod6.z.string(),
+  bytes: import_zod6.z.number().int().min(0),
+  sha256: import_zod6.z.string(),
+  expiresAt: import_zod6.z.string(),
+  downloadUrl: NullableString2,
+  downloadUrlExpiresAt: NullableString2,
+  localPath: NullableString2
+});
 var ExtractUrlOutputSchema = {
   url: import_zod6.z.string(),
   title: NullableString2,
@@ -9116,6 +9318,7 @@ var ExtractUrlOutputSchema = {
   schemaBlockCount: import_zod6.z.number().int().min(0),
   entityName: NullableString2,
   entityTypes: import_zod6.z.array(import_zod6.z.string()),
+  structuredDataLogo: NullableString2.describe("Logo declared by the selected Organization or LocalBusiness JSON-LD entity, separate from the rendered branding candidate ranking."),
   napScore: import_zod6.z.number().nullable(),
   missingSchemaFields: import_zod6.z.array(import_zod6.z.string()),
   screenshotSaved: NullableString2,
@@ -9140,6 +9343,78 @@ var ExtractUrlOutputSchema = {
     archivedUrl: NullableString2,
     source: import_zod6.z.enum(["og:image", "twitter:image", "json-ld", "content-image"])
   }).nullable(),
+  branding: import_zod6.z.object({
+    colorScheme: import_zod6.z.enum(["light", "dark"]).nullable(),
+    colors: import_zod6.z.object({
+      primary: NullableString2,
+      accent: NullableString2,
+      background: NullableString2,
+      text: NullableString2,
+      heading: NullableString2
+    }),
+    colorEvidence: import_zod6.z.object({
+      primary: import_zod6.z.object({
+        value: import_zod6.z.string(),
+        source: import_zod6.z.enum(["css_variable", "theme_color", "visible_cta", "navigation_background", "header_svg", "visible_background", "body_background", "body_text", "heading_text"]),
+        confidence: import_zod6.z.enum(["high", "medium", "low"]),
+        detail: NullableString2
+      }).nullable(),
+      accent: import_zod6.z.object({
+        value: import_zod6.z.string(),
+        source: import_zod6.z.enum(["css_variable", "theme_color", "visible_cta", "navigation_background", "header_svg", "visible_background", "body_background", "body_text", "heading_text"]),
+        confidence: import_zod6.z.enum(["high", "medium", "low"]),
+        detail: NullableString2
+      }).nullable(),
+      background: import_zod6.z.object({ value: import_zod6.z.string(), source: import_zod6.z.literal("body_background"), confidence: import_zod6.z.enum(["high", "medium", "low"]), detail: NullableString2 }).nullable(),
+      text: import_zod6.z.object({ value: import_zod6.z.string(), source: import_zod6.z.literal("body_text"), confidence: import_zod6.z.enum(["high", "medium", "low"]), detail: NullableString2 }).nullable(),
+      heading: import_zod6.z.object({ value: import_zod6.z.string(), source: import_zod6.z.literal("heading_text"), confidence: import_zod6.z.enum(["high", "medium", "low"]), detail: NullableString2 }).nullable()
+    }).describe("Rendered provenance for each selected color so callers can distinguish explicit brand tokens and semantic elements from lower-confidence fallbacks."),
+    fonts: import_zod6.z.object({ heading: NullableString2, body: NullableString2 }),
+    assets: import_zod6.z.object({
+      logo: NullableString2,
+      favicon: NullableString2,
+      logoConfidence: import_zod6.z.enum(["high", "medium", "low"]).nullable(),
+      logoSelectionReason: NullableString2,
+      logoVariants: import_zod6.z.array(import_zod6.z.string()).describe("Responsive or original-size files from the same brand-logo family as logo; never partner, certification, award, press, or customer marks."),
+      logoCandidates: import_zod6.z.array(import_zod6.z.object({
+        url: import_zod6.z.string(),
+        score: import_zod6.z.number(),
+        confidence: import_zod6.z.enum(["high", "medium", "low"]),
+        region: import_zod6.z.enum(["json_ld", "header", "nav", "footer", "body", "favicon"]),
+        evidence: import_zod6.z.array(import_zod6.z.string()),
+        alt: NullableString2,
+        width: import_zod6.z.number().nullable(),
+        height: import_zod6.z.number().nullable()
+      })),
+      proofImages: import_zod6.z.array(import_zod6.z.object({
+        url: import_zod6.z.string(),
+        proofType: import_zod6.z.enum(["certification", "accreditation", "award", "membership", "partner_or_customer", "press_mention", "trust_mark"]),
+        score: import_zod6.z.number(),
+        confidence: import_zod6.z.enum(["high", "medium", "low"]),
+        evidence: import_zod6.z.array(import_zod6.z.string()),
+        alt: NullableString2,
+        context: NullableString2,
+        width: import_zod6.z.number().nullable(),
+        height: import_zod6.z.number().nullable()
+      })).describe("Prominent body images supported by trust context, kept separate from the site logo. Classification is evidence-ranked rather than a claim that the depicted organization endorses the site.")
+    })
+  }).nullable().describe("Rendered brand and proof evidence. logo is the site identity, logoVariants are the same mark family, and proofImages are separately typed body trust signals. Inspect confidence and evidence rather than treating uncertain relationships as facts."),
+  mediaAssets: import_zod6.z.array(PageMediaAssetOutput).nullable().describe("Backward-compatible flattened page-media inventory. Use media for completeness, warnings, and artifact delivery."),
+  media: import_zod6.z.object({
+    pageUrl: import_zod6.z.string(),
+    staticFound: import_zod6.z.number().int().min(0),
+    renderedFound: import_zod6.z.number().int().min(0),
+    totalFound: import_zod6.z.number().int().min(0),
+    filteredCount: import_zod6.z.number().int().min(0),
+    retainedCount: import_zod6.z.number().int().min(0),
+    completeness: import_zod6.z.enum(["complete", "partial"]),
+    exhausted: import_zod6.z.boolean(),
+    stopReason: import_zod6.z.enum(["page_exhausted", "asset_limit", "scroll_round_limit", "render_unavailable"]),
+    scrollRounds: import_zod6.z.number().int().min(0),
+    warnings: import_zod6.z.array(import_zod6.z.string()),
+    assets: import_zod6.z.array(PageMediaAssetOutput),
+    artifact: PageMediaArtifactOutput.nullable()
+  }).nullable().describe("Static-plus-rendered website media manifest with provenance, bounded image content-block indices, completion state, and owner-scoped ZIP delivery."),
   memory: import_zod6.z.object({
     deposited: import_zod6.z.boolean(),
     vault: import_zod6.z.string().optional(),
@@ -9330,6 +9605,7 @@ var ArchiveReadOutputSchema = {
 };
 var MapsPlaceIntelOutputSchema = {
   name: import_zod6.z.string(),
+  placeUrl: import_zod6.z.string().nullable(),
   rating: NullableString2,
   reviewCount: NullableString2,
   category: NullableString2,
@@ -9337,6 +9613,8 @@ var MapsPlaceIntelOutputSchema = {
   phone: NullableString2,
   website: NullableString2,
   hoursSummary: NullableString2,
+  hoursTable: import_zod6.z.array(import_zod6.z.object({ day: import_zod6.z.string(), hours: import_zod6.z.string() })),
+  plusCode: NullableString2,
   bookingUrl: NullableString2,
   kgmid: NullableString2,
   cidDecimal: NullableString2,
@@ -9345,13 +9623,65 @@ var MapsPlaceIntelOutputSchema = {
   lng: import_zod6.z.number().nullable(),
   reviewsStatus: import_zod6.z.string(),
   reviewsCollected: import_zod6.z.number().int().min(0),
+  reviews: import_zod6.z.array(import_zod6.z.object({
+    reviewId: NullableString2,
+    author: NullableString2,
+    stars: NullableString2,
+    date: NullableString2,
+    text: NullableString2,
+    ownerResponse: NullableString2
+  })),
+  reviewHistogram: import_zod6.z.array(import_zod6.z.object({ stars: import_zod6.z.number().int().min(1).max(5), count: import_zod6.z.string() })),
   reviewTopics: import_zod6.z.array(import_zod6.z.object({
     label: import_zod6.z.string(),
     count: import_zod6.z.string()
   })),
   services: import_zod6.z.array(import_zod6.z.string()),
   areasServed: import_zod6.z.array(import_zod6.z.string()),
-  servicesStatus: import_zod6.z.string()
+  servicesStatus: import_zod6.z.string(),
+  aboutAttributes: import_zod6.z.array(import_zod6.z.object({ section: import_zod6.z.string(), attribute: import_zod6.z.string() })),
+  media: import_zod6.z.object({
+    status: import_zod6.z.string(),
+    scope: import_zod6.z.enum(["owner", "all"]),
+    requestedMaxImages: import_zod6.z.number().int().min(1),
+    imagesCollected: import_zod6.z.number().int().min(0),
+    imagesDownloaded: import_zod6.z.number().int().min(0),
+    ownerImagesCollected: import_zod6.z.number().int().min(0),
+    otherImagesCollected: import_zod6.z.number().int().min(0),
+    unknownOriginImagesCollected: import_zod6.z.number().int().min(0),
+    ownerGalleryAvailable: import_zod6.z.boolean(),
+    ownerGalleryExhausted: import_zod6.z.boolean(),
+    ownerPhotosDiscovered: import_zod6.z.number().int().min(0),
+    allPhotosDiscovered: import_zod6.z.number().int().min(0),
+    exhausted: import_zod6.z.boolean(),
+    stopReason: import_zod6.z.string(),
+    images: import_zod6.z.array(import_zod6.z.object({
+      index: import_zod6.z.number().int().min(1),
+      galleryPosition: import_zod6.z.number().int().min(1).nullable(),
+      sourceUrl: import_zod6.z.string(),
+      mediaKey: import_zod6.z.string(),
+      origin: import_zod6.z.enum(["owner", "other", "unknown"]),
+      originConfidence: import_zod6.z.string(),
+      filename: NullableString2,
+      mimeType: NullableString2,
+      bytes: import_zod6.z.number().int().min(0).nullable(),
+      downloadStatus: import_zod6.z.string(),
+      downloadError: NullableString2,
+      contentIndex: import_zod6.z.number().int().min(1).nullable()
+    })),
+    artifact: import_zod6.z.object({
+      artifactId: import_zod6.z.string(),
+      filename: import_zod6.z.string(),
+      contentType: import_zod6.z.string(),
+      bytes: import_zod6.z.number().int().min(0),
+      sha256: import_zod6.z.string(),
+      expiresAt: import_zod6.z.string(),
+      downloadUrl: NullableString2,
+      downloadUrlExpiresAt: NullableString2,
+      localPath: NullableString2
+    }).nullable(),
+    warnings: import_zod6.z.array(import_zod6.z.string())
+  })
 };
 var TrustpilotReviewsOutputSchema = {
   domain: import_zod6.z.string(),
@@ -11694,7 +12024,7 @@ function registerPaaExtractorMcpTools(server, executor, options = {}) {
   }, async (input) => formatInstagramMediaDownload(await executor.instagramMediaDownload(input), input));
   server.registerTool("maps_place_intel", {
     title: "Google Maps Business Profile Details",
-    description: "Deep-dive one known/named Google Business Profile: rating, reviews, category, address, phone, full hours, About attributes, entity IDs/CID, and \u2014 with includeServices: true \u2014 the full configured services and areas-served lists. Not for category searches or multi-business prospect lists; use maps_search for those. Split business name from location.",
+    description: 'Deep-dive one known/named Google Business Profile: rating, reviews, category, address, phone, website, full hours, About attributes, entity IDs/CID, configured services/areas, and optional photos. Set includeImages:true for a provenance-aware manifest, bounded AI image blocks, and an owner-scoped ZIP; choose imageScope:"owner" for listing-owner photos only. Not for category searches or multi-business prospect lists; use maps_search for those. Split business name from location.',
     inputSchema: MapsPlaceIntelInputSchema,
     outputSchema: recordOutputSchema("maps_place_intel", MapsPlaceIntelOutputSchema),
     annotations: liveWebToolAnnotations("Google Maps Business Profile Details")
@@ -13509,31 +13839,42 @@ var GetSchema = {
     openWorldHint: false
   }
 };
+var listNoteSchema = import_zod10.z.object({
+  path: import_zod10.z.string().describe("Vault-relative note path, e.g. projects/q3-plan."),
+  title: import_zod10.z.string().describe("Human-readable note title."),
+  kind: import_zod10.z.string().describe("Note kind: note, library, capture, or decision."),
+  tags: import_zod10.z.array(import_zod10.z.string()).describe("The note's tags, if any."),
+  updatedAt: import_zod10.z.string().describe("ISO-8601 timestamp of the note last update.")
+});
 var ListSchema = {
   id: "memory-list",
   upstreamName: "listTool",
-  description: "Return every note in one vault as a complete metadata inventory \u2014 stable path, title, kind, tags, and last-updated \u2014 plus a sorted list of every unique folder and nested folder represented by those paths. It contains no bodies. Use memory-get for exact full content, memory-search for ranked semantic recall, or memory-export only when explicitly asked for every full note. Defaults to the active or first entitled vault; also returns entitled vaults. Requires read scope.",
+  description: "Return a complete note-and-folder metadata inventory without note bodies. Set allVaults:true when the user asks for every note or folder they have across their whole Memory account; the result is grouped by vault and includes aggregate totals. Otherwise list one exact vault, defaulting to the active or first entitled vault. Never report a single-vault count as the account total. Use memory-get for exact full content, memory-search for ranked semantic recall, or memory-export only when explicitly asked for every full note. Requires read scope.",
   input: {
     vault: import_zod10.z.string().optional().describe(
       "Vault to list. Optional; defaults to the session active vault, then the first vault the caller is entitled to."
     ),
+    allVaults: import_zod10.z.boolean().optional().describe("Set true for one complete account-wide inventory across every entitled vault. Omit or set false for one vault. When true, vault is ignored and reads run sequentially to avoid backend contention."),
     kind: import_zod10.z.enum(["note", "library", "capture", "decision"]).optional().describe("Filter to a single note kind. Optional; omit to list every kind in the vault."),
     tags: import_zod10.z.array(import_zod10.z.string()).optional().describe("Filter to notes tagged with any of these tags (matches the note's tags primitive). Optional; omit to not filter by tag.")
   },
   output: {
     ok: import_zod10.z.boolean().describe("True when the listing succeeded; false on an auth/scope/lookup error."),
+    scope: import_zod10.z.enum(["vault", "account"]).optional().describe("Whether the result covers one logical vault or the whole entitled account."),
+    partial: import_zod10.z.boolean().optional().describe("Account-wide mode only: true if one vault failed and vaultInventories contains only the completed prefix."),
     vault: import_zod10.z.string().optional().describe("The vault that was actually listed (after defaulting)."),
-    notes: import_zod10.z.array(
-      import_zod10.z.object({
-        path: import_zod10.z.string().describe("Vault-relative note path, e.g. projects/q3-plan."),
-        title: import_zod10.z.string().describe("Human-readable note title."),
-        kind: import_zod10.z.string().describe("Note kind: note, library, capture, or decision."),
-        tags: import_zod10.z.array(import_zod10.z.string()).describe("The note's tags, if any."),
-        updatedAt: import_zod10.z.string().describe("ISO-8601 timestamp of the note last update.")
-      })
-    ).optional().describe("The notes in the vault (metadata only, no content). Present when ok is true."),
+    notes: import_zod10.z.array(listNoteSchema).optional().describe("The notes in the vault (metadata only, no content). Present when ok is true."),
     folders: import_zod10.z.array(import_zod10.z.string()).optional().describe("Sorted complete folder inventory derived from note paths, including represented nested parent folders. Present when ok is true."),
     vaults: import_zod10.z.array(import_zod10.z.string()).optional().describe("All vaults the caller is entitled to, for choosing a different vault to list."),
+    totalNotes: import_zod10.z.number().int().nonnegative().optional().describe("Account-wide mode only: total notes across every completed vault inventory."),
+    totalFolders: import_zod10.z.number().int().nonnegative().optional().describe("Account-wide mode only: total represented folder instances across vaults."),
+    vaultInventories: import_zod10.z.array(import_zod10.z.object({
+      vault: import_zod10.z.string().describe("Exact vault handle for every note and folder in this group."),
+      noteCount: import_zod10.z.number().int().nonnegative(),
+      folderCount: import_zod10.z.number().int().nonnegative(),
+      notes: import_zod10.z.array(listNoteSchema).describe("Every note metadata record in this vault."),
+      folders: import_zod10.z.array(import_zod10.z.string()).describe("Every represented folder and nested parent folder in this vault.")
+    })).optional().describe("Account-wide mode only: complete note and folder inventories grouped by vault so paths remain unambiguous."),
     error: import_zod10.z.string().optional().describe("Human-readable failure reason when ok is false.")
   },
   annotations: {