{"schema_version":5,"server":{"name":"product-images","title":"Product Images","version":"4.0.0"},"tools":[{"name":"search_product_images","title":"Search Product Images","description":"Find product images by text and optional brand, category or exact variant-label filters. Optional requirements strictly enforce native pixel dimensions, measured alpha-channel values and dated source evidence before pagination. Unknown required evidence is excluded, constraints are never relaxed, and rejection diagnostics explain an empty result. Reuse the same requirements with a cursor. Use image_url; thumbnail_url is secondary. Matching labels do not verify exact depicted product identity.","inputSchema":{"type":"object","additionalProperties":false,"properties":{"query":{"type":"string","maxLength":240},"brand":{"type":"string","maxLength":160,"minLength":1},"category":{"type":"string","maxLength":160,"minLength":1},"variant":{"type":"string","maxLength":160,"minLength":1},"requirements":{"type":"object","additionalProperties":false,"properties":{"min_width_px":{"type":"integer","minimum":1,"maximum":100000,"description":"Minimum actual native primary-image width; thumbnails and upscaling cannot satisfy this."},"min_height_px":{"type":"integer","minimum":1,"maximum":100000,"description":"Minimum actual native primary-image height."},"alpha_channel":{"type":"boolean","description":"Require a measured primary-image alpha-channel value. Unknown measurements do not qualify."},"source_scope":{"type":"string","enum":["product","variant"],"description":"Require dated recorded source evidence at product or variant scope. This is not a live source check or pictured-variant verification."},"source_evidence":{"type":"string","enum":["source_reported","source_reviewed"],"description":"Minimum recorded source evidence. Requires source_scope; defaults to source_reported."}},"required":[],"minProperties":1,"dependentRequired":{"source_evidence":["source_scope"]}},"sort":{"type":"string","enum":["relevance","name","brand"],"default":"relevance"},"limit":{"type":"integer","minimum":1,"maximum":100,"default":6},"cursor":{"type":"string","maxLength":512,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$"}},"required":[]},"outputSchema":{"type":"object","additionalProperties":false,"properties":{"images":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"asset_id":{"type":"string","maxLength":101,"minLength":1,"pattern":"^[A-Za-z0-9][A-Za-z0-9_-]*$"},"title":{"type":"string","maxLength":2000},"product_name":{"type":"string","maxLength":2000},"brand":{"type":"string","maxLength":200},"variant":{"type":"string","maxLength":200},"category":{"type":"string","maxLength":200},"alt_text":{"type":"string","maxLength":2000},"image_url":{"type":"string","maxLength":4096,"description":"Default public native-resolution lossless image. Never replace it with a thumbnail."},"image_width_px":{"type":"integer","minimum":1,"maximum":100000},"image_height_px":{"type":"integer","minimum":1,"maximum":100000},"image_mime_type":{"type":"string","const":"image/webp"},"image_access":{"type":"string","const":"public"},"image_quality":{"type":"string","const":"native_lossless"},"primary_image":{"type":"object","additionalProperties":false,"properties":{"url":{"type":"string","maxLength":4096},"width_px":{"type":"integer","minimum":1,"maximum":100000},"height_px":{"type":"integer","minimum":1,"maximum":100000},"mime_type":{"type":"string","const":"image/webp"},"access":{"type":"string","const":"public"},"role":{"type":"string","const":"primary"},"quality":{"type":"string","const":"native_lossless"},"rendered_image_sha256":{"type":"string","maxLength":64,"minLength":64,"pattern":"^[a-f0-9]{64}$"}},"required":["url","width_px","height_px","mime_type","access","role","quality","rendered_image_sha256"]},"thumbnail_url":{"type":["string","null"],"maxLength":4096,"description":"Optional secondary thumbnail only."},"thumbnail_image":{"type":["object","null"],"additionalProperties":false,"properties":{"url":{"type":"string","maxLength":4096},"width_px":{"type":["integer","null"],"minimum":1,"maximum":100000},"height_px":{"type":["integer","null"],"minimum":1,"maximum":100000},"mime_type":{"type":"string","enum":["image/webp","image/png","image/jpeg","image/avif"]},"access":{"type":"string","const":"public"},"role":{"type":"string","const":"thumbnail"},"quality":{"type":"string","const":"thumbnail"}},"required":["url","width_px","height_px","mime_type","access","role","quality"]},"original_image":{"type":["object","null"],"additionalProperties":false,"properties":{"url":{"type":"string","maxLength":4096},"width_px":{"type":"integer","minimum":1,"maximum":100000},"height_px":{"type":"integer","minimum":1,"maximum":100000},"mime_type":{"type":"string","const":"image/png"},"access":{"type":"string","enum":["authorization_required","public"]},"role":{"type":"string","const":"original"},"rendered_image_sha256":{"type":"string","maxLength":64,"minLength":64,"pattern":"^[a-f0-9]{64}$"}},"required":["url","width_px","height_px","mime_type","access","role","rendered_image_sha256"]},"description":{"type":["object","null"],"additionalProperties":false,"properties":{"text":{"type":"string","maxLength":4000},"source_url":{"type":["string","null"],"maxLength":4096},"observed_at":{"type":["string","null"],"maxLength":64},"source_scope":{"type":["string","null"],"maxLength":80},"evidence_status":{"type":"string","enum":["catalog_declared","source_reported","source_reviewed","archived_source_observation","conflicted","not_established"]}},"required":["text","source_url","observed_at","source_scope","evidence_status"]},"identifiers":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"identifier_type":{"type":"string","enum":["asset_id","gtin","mpn","merchant_sku","merchant_product_id","merchant_variant_id"]},"value":{"type":"string","maxLength":200,"minLength":1},"merchant_scope":{"type":["string","null"],"maxLength":253},"source_url":{"type":["string","null"],"maxLength":4096},"observed_at":{"type":["string","null"],"maxLength":64},"source_scope":{"type":["string","null"],"maxLength":80},"evidence_status":{"type":"string","enum":["catalog_declared","source_reported","source_reviewed","archived_source_observation","conflicted","not_established"]}},"required":["identifier_type","value","merchant_scope","source_url","observed_at","source_scope","evidence_status"]},"maxItems":64},"facts":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","maxLength":120,"minLength":1},"value":{"type":"string","maxLength":2000,"minLength":1},"unit":{"type":["string","null"],"maxLength":80},"source_url":{"type":["string","null"],"maxLength":4096},"observed_at":{"type":["string","null"],"maxLength":64},"source_scope":{"type":["string","null"],"maxLength":80},"evidence_status":{"type":"string","enum":["catalog_declared","source_reported","source_reviewed","archived_source_observation","conflicted","not_established"]},"conflicted":{"type":"boolean"}},"required":["name","value","unit","source_url","observed_at","source_scope","evidence_status","conflicted"]},"maxItems":96},"sources":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"url":{"type":"string","maxLength":4096},"observed_at":{"type":["string","null"],"maxLength":64},"scope":{"type":["string","null"],"maxLength":80},"evidence_status":{"type":"string","enum":["catalog_declared","source_reported","source_reviewed","archived_source_observation","conflicted","not_established"]}},"required":["url","observed_at","scope","evidence_status"]},"maxItems":512},"caveats":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"field":{"type":"string","maxLength":120},"text":{"type":"string","maxLength":2000},"source_urls":{"type":"array","items":{"type":"string","maxLength":4096},"maxItems":16}},"required":["field","text","source_urls"]},"maxItems":64},"rights":{"type":"object","additionalProperties":false,"properties":{"ai_generated":{"type":["boolean","null"]},"approval_status":{"type":["string","null"],"maxLength":80},"license_id":{"type":["string","null"],"maxLength":200},"license_url":{"type":["string","null"],"maxLength":4096},"reuse_status":{"type":["string","null"],"maxLength":120}},"required":["ai_generated","approval_status","license_id","license_url","reuse_status"]},"geometry":{"type":"object","additionalProperties":false,"properties":{"canvas_width_px":{"type":"integer","minimum":1,"maximum":100000},"canvas_height_px":{"type":"integer","minimum":1,"maximum":100000},"alpha_channel":{"type":["boolean","null"]},"alpha_channel_status":{"type":"string","enum":["unknown","measured"]}},"required":["canvas_width_px","canvas_height_px","alpha_channel","alpha_channel_status"]},"product_associations":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"title":{"type":"string","maxLength":2000},"variant":{"type":"string","maxLength":200},"identifiers":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"identifier_type":{"type":"string","enum":["asset_id","gtin","mpn","merchant_sku","merchant_product_id","merchant_variant_id"]},"value":{"type":"string","maxLength":200,"minLength":1},"merchant_scope":{"type":["string","null"],"maxLength":253},"source_url":{"type":["string","null"],"maxLength":4096},"observed_at":{"type":["string","null"],"maxLength":64},"source_scope":{"type":["string","null"],"maxLength":80},"evidence_status":{"type":"string","enum":["catalog_declared","source_reported","source_reviewed","archived_source_observation","conflicted","not_established"]}},"required":["identifier_type","value","merchant_scope","source_url","observed_at","source_scope","evidence_status"]},"maxItems":32},"source_url":{"type":["string","null"],"maxLength":4096},"observed_at":{"type":["string","null"],"maxLength":64},"relation":{"type":"string","const":"listed_for"},"exact_variant_verified":{"type":"boolean","const":false}},"required":["title","variant","identifiers","source_url","observed_at","relation","exact_variant_verified"]},"maxItems":256}},"required":["asset_id","title","product_name","brand","variant","category","alt_text","image_url","image_width_px","image_height_px","image_mime_type","image_access","image_quality","primary_image","thumbnail_url","thumbnail_image","original_image","description","identifiers","facts","sources","caveats","rights","geometry","product_associations"]},"maxItems":100},"returned_count":{"type":"integer","minimum":0},"matched_count":{"type":"integer","minimum":0},"total_count":{"type":"integer","minimum":0},"next_cursor":{"type":["string","null"],"maxLength":512,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$"},"snapshot":{"type":"string","maxLength":256},"requirement_result":{"type":"object","additionalProperties":false,"properties":{"status":{"type":"string","enum":["matched","no_candidates","requirements_unmet"]},"applied":{"type":"object","additionalProperties":false,"properties":{"min_width_px":{"type":"integer","minimum":1,"maximum":100000,"description":"Minimum actual native primary-image width; thumbnails and upscaling cannot satisfy this."},"min_height_px":{"type":"integer","minimum":1,"maximum":100000,"description":"Minimum actual native primary-image height."},"alpha_channel":{"type":"boolean","description":"Require a measured primary-image alpha-channel value. Unknown measurements do not qualify."},"source_scope":{"type":"string","enum":["product","variant"],"description":"Require dated recorded source evidence at product or variant scope. This is not a live source check or pictured-variant verification."},"source_evidence":{"type":"string","enum":["source_reported","source_reviewed"],"description":"Minimum recorded source evidence. Requires source_scope; defaults to source_reported."}},"required":[],"minProperties":1,"dependentRequired":{"source_evidence":["source_scope"]}},"candidate_count":{"type":"integer","minimum":0},"eligible_count":{"type":"integer","minimum":0},"rejected_count":{"type":"integer","minimum":0},"rejection_counts":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"requirement":{"type":"string","enum":["min_width_px","min_height_px","alpha_channel","source_scope","source_evidence"]},"reason":{"type":"string","enum":["below_minimum","measurement_unknown","value_mismatch","evidence_missing","evidence_unverified"]},"count":{"type":"integer","minimum":0}},"required":["requirement","reason","count"]},"maxItems":25},"rejection_counting":{"type":"string","const":"first_failing_requirement_per_candidate"},"unknowns_excluded":{"type":"boolean","const":true}},"required":["status","applied","candidate_count","eligible_count","rejected_count","rejection_counts","rejection_counting","unknowns_excluded"]},"search_info":{"type":"object","additionalProperties":false,"properties":{"strategy":{"type":"string","const":"deterministic_lexical"},"match_mode":{"type":"string","enum":["browse","exact","synonym","normalized","fuzzy","none"]},"corrections":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"from":{"type":"string","maxLength":240},"alternatives":{"type":"array","items":{"type":"string","maxLength":240},"maxItems":30},"method":{"type":"string","const":"edit_distance_1"},"ambiguous":{"type":"boolean"}},"required":["from","alternatives","method","ambiguous"]},"maxItems":60},"exact_product_identity_verified":{"type":"boolean","const":false},"constraints_relaxed":{"type":"boolean","const":false}},"required":["strategy","match_mode","corrections","exact_product_identity_verified","constraints_relaxed"]},"error":{"type":"object","additionalProperties":false,"properties":{"code":{"type":"string","maxLength":80},"message":{"type":"string","maxLength":500},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":"integer","minimum":1,"maximum":60}},"required":["code","message"]}},"anyOf":[{"required":["images","returned_count","matched_count","total_count","next_cursor","snapshot"]},{"required":["error"]}]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get_product_image","title":"Get Product Image","description":"Retrieve one exact published image and its metadata using the stable asset_id. image.image_url is the public native-resolution lossless primary. Original files have their own access requirements. Missing or invalid primary imagery is an error, never a thumbnail fallback.","inputSchema":{"type":"object","additionalProperties":false,"properties":{"asset_id":{"type":"string","maxLength":101,"minLength":1,"pattern":"^[A-Za-z0-9][A-Za-z0-9_-]*$"}},"required":["asset_id"]},"outputSchema":{"type":"object","additionalProperties":false,"properties":{"image":{"type":"object","additionalProperties":false,"properties":{"asset_id":{"type":"string","maxLength":101,"minLength":1,"pattern":"^[A-Za-z0-9][A-Za-z0-9_-]*$"},"title":{"type":"string","maxLength":2000},"product_name":{"type":"string","maxLength":2000},"brand":{"type":"string","maxLength":200},"variant":{"type":"string","maxLength":200},"category":{"type":"string","maxLength":200},"alt_text":{"type":"string","maxLength":2000},"image_url":{"type":"string","maxLength":4096,"description":"Default public native-resolution lossless image. Never replace it with a thumbnail."},"image_width_px":{"type":"integer","minimum":1,"maximum":100000},"image_height_px":{"type":"integer","minimum":1,"maximum":100000},"image_mime_type":{"type":"string","const":"image/webp"},"image_access":{"type":"string","const":"public"},"image_quality":{"type":"string","const":"native_lossless"},"primary_image":{"type":"object","additionalProperties":false,"properties":{"url":{"type":"string","maxLength":4096},"width_px":{"type":"integer","minimum":1,"maximum":100000},"height_px":{"type":"integer","minimum":1,"maximum":100000},"mime_type":{"type":"string","const":"image/webp"},"access":{"type":"string","const":"public"},"role":{"type":"string","const":"primary"},"quality":{"type":"string","const":"native_lossless"},"rendered_image_sha256":{"type":"string","maxLength":64,"minLength":64,"pattern":"^[a-f0-9]{64}$"}},"required":["url","width_px","height_px","mime_type","access","role","quality","rendered_image_sha256"]},"thumbnail_url":{"type":["string","null"],"maxLength":4096,"description":"Optional secondary thumbnail only."},"thumbnail_image":{"type":["object","null"],"additionalProperties":false,"properties":{"url":{"type":"string","maxLength":4096},"width_px":{"type":["integer","null"],"minimum":1,"maximum":100000},"height_px":{"type":["integer","null"],"minimum":1,"maximum":100000},"mime_type":{"type":"string","enum":["image/webp","image/png","image/jpeg","image/avif"]},"access":{"type":"string","const":"public"},"role":{"type":"string","const":"thumbnail"},"quality":{"type":"string","const":"thumbnail"}},"required":["url","width_px","height_px","mime_type","access","role","quality"]},"original_image":{"type":["object","null"],"additionalProperties":false,"properties":{"url":{"type":"string","maxLength":4096},"width_px":{"type":"integer","minimum":1,"maximum":100000},"height_px":{"type":"integer","minimum":1,"maximum":100000},"mime_type":{"type":"string","const":"image/png"},"access":{"type":"string","enum":["authorization_required","public"]},"role":{"type":"string","const":"original"},"rendered_image_sha256":{"type":"string","maxLength":64,"minLength":64,"pattern":"^[a-f0-9]{64}$"}},"required":["url","width_px","height_px","mime_type","access","role","rendered_image_sha256"]},"description":{"type":["object","null"],"additionalProperties":false,"properties":{"text":{"type":"string","maxLength":4000},"source_url":{"type":["string","null"],"maxLength":4096},"observed_at":{"type":["string","null"],"maxLength":64},"source_scope":{"type":["string","null"],"maxLength":80},"evidence_status":{"type":"string","enum":["catalog_declared","source_reported","source_reviewed","archived_source_observation","conflicted","not_established"]}},"required":["text","source_url","observed_at","source_scope","evidence_status"]},"identifiers":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"identifier_type":{"type":"string","enum":["asset_id","gtin","mpn","merchant_sku","merchant_product_id","merchant_variant_id"]},"value":{"type":"string","maxLength":200,"minLength":1},"merchant_scope":{"type":["string","null"],"maxLength":253},"source_url":{"type":["string","null"],"maxLength":4096},"observed_at":{"type":["string","null"],"maxLength":64},"source_scope":{"type":["string","null"],"maxLength":80},"evidence_status":{"type":"string","enum":["catalog_declared","source_reported","source_reviewed","archived_source_observation","conflicted","not_established"]}},"required":["identifier_type","value","merchant_scope","source_url","observed_at","source_scope","evidence_status"]},"maxItems":64},"facts":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","maxLength":120,"minLength":1},"value":{"type":"string","maxLength":2000,"minLength":1},"unit":{"type":["string","null"],"maxLength":80},"source_url":{"type":["string","null"],"maxLength":4096},"observed_at":{"type":["string","null"],"maxLength":64},"source_scope":{"type":["string","null"],"maxLength":80},"evidence_status":{"type":"string","enum":["catalog_declared","source_reported","source_reviewed","archived_source_observation","conflicted","not_established"]},"conflicted":{"type":"boolean"}},"required":["name","value","unit","source_url","observed_at","source_scope","evidence_status","conflicted"]},"maxItems":96},"sources":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"url":{"type":"string","maxLength":4096},"observed_at":{"type":["string","null"],"maxLength":64},"scope":{"type":["string","null"],"maxLength":80},"evidence_status":{"type":"string","enum":["catalog_declared","source_reported","source_reviewed","archived_source_observation","conflicted","not_established"]}},"required":["url","observed_at","scope","evidence_status"]},"maxItems":512},"caveats":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"field":{"type":"string","maxLength":120},"text":{"type":"string","maxLength":2000},"source_urls":{"type":"array","items":{"type":"string","maxLength":4096},"maxItems":16}},"required":["field","text","source_urls"]},"maxItems":64},"rights":{"type":"object","additionalProperties":false,"properties":{"ai_generated":{"type":["boolean","null"]},"approval_status":{"type":["string","null"],"maxLength":80},"license_id":{"type":["string","null"],"maxLength":200},"license_url":{"type":["string","null"],"maxLength":4096},"reuse_status":{"type":["string","null"],"maxLength":120}},"required":["ai_generated","approval_status","license_id","license_url","reuse_status"]},"geometry":{"type":"object","additionalProperties":false,"properties":{"canvas_width_px":{"type":"integer","minimum":1,"maximum":100000},"canvas_height_px":{"type":"integer","minimum":1,"maximum":100000},"alpha_channel":{"type":["boolean","null"]},"alpha_channel_status":{"type":"string","enum":["unknown","measured"]}},"required":["canvas_width_px","canvas_height_px","alpha_channel","alpha_channel_status"]},"product_associations":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"title":{"type":"string","maxLength":2000},"variant":{"type":"string","maxLength":200},"identifiers":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"identifier_type":{"type":"string","enum":["asset_id","gtin","mpn","merchant_sku","merchant_product_id","merchant_variant_id"]},"value":{"type":"string","maxLength":200,"minLength":1},"merchant_scope":{"type":["string","null"],"maxLength":253},"source_url":{"type":["string","null"],"maxLength":4096},"observed_at":{"type":["string","null"],"maxLength":64},"source_scope":{"type":["string","null"],"maxLength":80},"evidence_status":{"type":"string","enum":["catalog_declared","source_reported","source_reviewed","archived_source_observation","conflicted","not_established"]}},"required":["identifier_type","value","merchant_scope","source_url","observed_at","source_scope","evidence_status"]},"maxItems":32},"source_url":{"type":["string","null"],"maxLength":4096},"observed_at":{"type":["string","null"],"maxLength":64},"relation":{"type":"string","const":"listed_for"},"exact_variant_verified":{"type":"boolean","const":false}},"required":["title","variant","identifiers","source_url","observed_at","relation","exact_variant_verified"]},"maxItems":256}},"required":["asset_id","title","product_name","brand","variant","category","alt_text","image_url","image_width_px","image_height_px","image_mime_type","image_access","image_quality","primary_image","thumbnail_url","thumbnail_image","original_image","description","identifiers","facts","sources","caveats","rights","geometry","product_associations"]},"error":{"type":"object","additionalProperties":false,"properties":{"code":{"type":"string","maxLength":80},"message":{"type":"string","maxLength":500},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":"integer","minimum":1,"maximum":60}},"required":["code","message"]}},"anyOf":[{"required":["image"]},{"required":["error"]}]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get_product_images","title":"Get Product Images","description":"Retrieve up to twenty exact images and their metadata in input order. Missing or unpublished IDs are returned explicitly; no replacement image is inferred. Use each image_url for native-resolution display.","inputSchema":{"type":"object","additionalProperties":false,"properties":{"asset_ids":{"type":"array","items":{"type":"string","maxLength":101,"minLength":1,"pattern":"^[A-Za-z0-9][A-Za-z0-9_-]*$"},"maxItems":20,"minItems":1,"uniqueItems":true}},"required":["asset_ids"]},"outputSchema":{"type":"object","additionalProperties":false,"properties":{"images":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"asset_id":{"type":"string","maxLength":101,"minLength":1,"pattern":"^[A-Za-z0-9][A-Za-z0-9_-]*$"},"title":{"type":"string","maxLength":2000},"product_name":{"type":"string","maxLength":2000},"brand":{"type":"string","maxLength":200},"variant":{"type":"string","maxLength":200},"category":{"type":"string","maxLength":200},"alt_text":{"type":"string","maxLength":2000},"image_url":{"type":"string","maxLength":4096,"description":"Default public native-resolution lossless image. Never replace it with a thumbnail."},"image_width_px":{"type":"integer","minimum":1,"maximum":100000},"image_height_px":{"type":"integer","minimum":1,"maximum":100000},"image_mime_type":{"type":"string","const":"image/webp"},"image_access":{"type":"string","const":"public"},"image_quality":{"type":"string","const":"native_lossless"},"primary_image":{"type":"object","additionalProperties":false,"properties":{"url":{"type":"string","maxLength":4096},"width_px":{"type":"integer","minimum":1,"maximum":100000},"height_px":{"type":"integer","minimum":1,"maximum":100000},"mime_type":{"type":"string","const":"image/webp"},"access":{"type":"string","const":"public"},"role":{"type":"string","const":"primary"},"quality":{"type":"string","const":"native_lossless"},"rendered_image_sha256":{"type":"string","maxLength":64,"minLength":64,"pattern":"^[a-f0-9]{64}$"}},"required":["url","width_px","height_px","mime_type","access","role","quality","rendered_image_sha256"]},"thumbnail_url":{"type":["string","null"],"maxLength":4096,"description":"Optional secondary thumbnail only."},"thumbnail_image":{"type":["object","null"],"additionalProperties":false,"properties":{"url":{"type":"string","maxLength":4096},"width_px":{"type":["integer","null"],"minimum":1,"maximum":100000},"height_px":{"type":["integer","null"],"minimum":1,"maximum":100000},"mime_type":{"type":"string","enum":["image/webp","image/png","image/jpeg","image/avif"]},"access":{"type":"string","const":"public"},"role":{"type":"string","const":"thumbnail"},"quality":{"type":"string","const":"thumbnail"}},"required":["url","width_px","height_px","mime_type","access","role","quality"]},"original_image":{"type":["object","null"],"additionalProperties":false,"properties":{"url":{"type":"string","maxLength":4096},"width_px":{"type":"integer","minimum":1,"maximum":100000},"height_px":{"type":"integer","minimum":1,"maximum":100000},"mime_type":{"type":"string","const":"image/png"},"access":{"type":"string","enum":["authorization_required","public"]},"role":{"type":"string","const":"original"},"rendered_image_sha256":{"type":"string","maxLength":64,"minLength":64,"pattern":"^[a-f0-9]{64}$"}},"required":["url","width_px","height_px","mime_type","access","role","rendered_image_sha256"]},"description":{"type":["object","null"],"additionalProperties":false,"properties":{"text":{"type":"string","maxLength":4000},"source_url":{"type":["string","null"],"maxLength":4096},"observed_at":{"type":["string","null"],"maxLength":64},"source_scope":{"type":["string","null"],"maxLength":80},"evidence_status":{"type":"string","enum":["catalog_declared","source_reported","source_reviewed","archived_source_observation","conflicted","not_established"]}},"required":["text","source_url","observed_at","source_scope","evidence_status"]},"identifiers":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"identifier_type":{"type":"string","enum":["asset_id","gtin","mpn","merchant_sku","merchant_product_id","merchant_variant_id"]},"value":{"type":"string","maxLength":200,"minLength":1},"merchant_scope":{"type":["string","null"],"maxLength":253},"source_url":{"type":["string","null"],"maxLength":4096},"observed_at":{"type":["string","null"],"maxLength":64},"source_scope":{"type":["string","null"],"maxLength":80},"evidence_status":{"type":"string","enum":["catalog_declared","source_reported","source_reviewed","archived_source_observation","conflicted","not_established"]}},"required":["identifier_type","value","merchant_scope","source_url","observed_at","source_scope","evidence_status"]},"maxItems":64},"facts":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","maxLength":120,"minLength":1},"value":{"type":"string","maxLength":2000,"minLength":1},"unit":{"type":["string","null"],"maxLength":80},"source_url":{"type":["string","null"],"maxLength":4096},"observed_at":{"type":["string","null"],"maxLength":64},"source_scope":{"type":["string","null"],"maxLength":80},"evidence_status":{"type":"string","enum":["catalog_declared","source_reported","source_reviewed","archived_source_observation","conflicted","not_established"]},"conflicted":{"type":"boolean"}},"required":["name","value","unit","source_url","observed_at","source_scope","evidence_status","conflicted"]},"maxItems":96},"sources":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"url":{"type":"string","maxLength":4096},"observed_at":{"type":["string","null"],"maxLength":64},"scope":{"type":["string","null"],"maxLength":80},"evidence_status":{"type":"string","enum":["catalog_declared","source_reported","source_reviewed","archived_source_observation","conflicted","not_established"]}},"required":["url","observed_at","scope","evidence_status"]},"maxItems":512},"caveats":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"field":{"type":"string","maxLength":120},"text":{"type":"string","maxLength":2000},"source_urls":{"type":"array","items":{"type":"string","maxLength":4096},"maxItems":16}},"required":["field","text","source_urls"]},"maxItems":64},"rights":{"type":"object","additionalProperties":false,"properties":{"ai_generated":{"type":["boolean","null"]},"approval_status":{"type":["string","null"],"maxLength":80},"license_id":{"type":["string","null"],"maxLength":200},"license_url":{"type":["string","null"],"maxLength":4096},"reuse_status":{"type":["string","null"],"maxLength":120}},"required":["ai_generated","approval_status","license_id","license_url","reuse_status"]},"geometry":{"type":"object","additionalProperties":false,"properties":{"canvas_width_px":{"type":"integer","minimum":1,"maximum":100000},"canvas_height_px":{"type":"integer","minimum":1,"maximum":100000},"alpha_channel":{"type":["boolean","null"]},"alpha_channel_status":{"type":"string","enum":["unknown","measured"]}},"required":["canvas_width_px","canvas_height_px","alpha_channel","alpha_channel_status"]},"product_associations":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"title":{"type":"string","maxLength":2000},"variant":{"type":"string","maxLength":200},"identifiers":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"identifier_type":{"type":"string","enum":["asset_id","gtin","mpn","merchant_sku","merchant_product_id","merchant_variant_id"]},"value":{"type":"string","maxLength":200,"minLength":1},"merchant_scope":{"type":["string","null"],"maxLength":253},"source_url":{"type":["string","null"],"maxLength":4096},"observed_at":{"type":["string","null"],"maxLength":64},"source_scope":{"type":["string","null"],"maxLength":80},"evidence_status":{"type":"string","enum":["catalog_declared","source_reported","source_reviewed","archived_source_observation","conflicted","not_established"]}},"required":["identifier_type","value","merchant_scope","source_url","observed_at","source_scope","evidence_status"]},"maxItems":32},"source_url":{"type":["string","null"],"maxLength":4096},"observed_at":{"type":["string","null"],"maxLength":64},"relation":{"type":"string","const":"listed_for"},"exact_variant_verified":{"type":"boolean","const":false}},"required":["title","variant","identifiers","source_url","observed_at","relation","exact_variant_verified"]},"maxItems":256}},"required":["asset_id","title","product_name","brand","variant","category","alt_text","image_url","image_width_px","image_height_px","image_mime_type","image_access","image_quality","primary_image","thumbnail_url","thumbnail_image","original_image","description","identifiers","facts","sources","caveats","rights","geometry","product_associations"]},"maxItems":20},"requested_count":{"type":"integer","minimum":0},"returned_count":{"type":"integer","minimum":0},"missing_asset_ids":{"type":"array","items":{"type":"string","maxLength":101,"minLength":1,"pattern":"^[A-Za-z0-9][A-Za-z0-9_-]*$"},"maxItems":20},"snapshot":{"type":"string","maxLength":256},"error":{"type":"object","additionalProperties":false,"properties":{"code":{"type":"string","maxLength":80},"message":{"type":"string","maxLength":500},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":"integer","minimum":1,"maximum":60}},"required":["code","message"]}},"anyOf":[{"required":["images","requested_count","returned_count","missing_asset_ids","snapshot"]},{"required":["error"]}]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"list_image_facets","title":"List Image Facets","description":"List optional brand or category filter values with image counts and aliases. Results are paginated and tied to a catalog snapshot; labels describe the images rather than an application hierarchy.","inputSchema":{"type":"object","additionalProperties":false,"properties":{"kind":{"type":"string","enum":["brands","categories"],"default":"brands"},"query":{"type":"string","maxLength":240},"sort":{"type":"string","enum":["name","count"],"default":"name"},"limit":{"type":"integer","minimum":1,"maximum":100,"default":30},"cursor":{"type":"string","maxLength":512,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$"}},"required":[]},"outputSchema":{"type":"object","additionalProperties":false,"properties":{"kind":{"type":"string","enum":["brands","categories"]},"items":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"value":{"type":"string","maxLength":200},"label":{"type":"string","maxLength":200},"count":{"type":"integer","minimum":0},"aliases":{"type":"array","items":{"type":"string","maxLength":200},"maxItems":12}},"required":["value","label","count","aliases"]},"maxItems":100},"returned_count":{"type":"integer","minimum":0},"total_count":{"type":"integer","minimum":0},"matched_count":{"type":"integer","minimum":0},"next_cursor":{"type":["string","null"],"maxLength":512,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$"},"snapshot":{"type":"string","maxLength":256},"error":{"type":"object","additionalProperties":false,"properties":{"code":{"type":"string","maxLength":80},"message":{"type":"string","maxLength":500},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":"integer","minimum":1,"maximum":60}},"required":["code","message"]}},"anyOf":[{"required":["kind","items","returned_count","total_count","matched_count","next_cursor","snapshot"]},{"required":["error"]}]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"resolve_product_image","title":"Resolve Product Image","description":"Resolve a recorded image ID, GTIN, MPN or merchant-scoped identifier to matching images. Preserves ambiguity, source evidence and known source holds. A listing association does not verify an exact depicted variant. No substitute image is returned for a hold.","inputSchema":{"type":"object","additionalProperties":false,"properties":{"identifier_type":{"type":"string","enum":["asset_id","gtin","mpn","merchant_sku","merchant_product_id","merchant_variant_id"]},"identifier":{"type":"string","maxLength":160,"minLength":1},"merchant_scope":{"type":"string","maxLength":253,"minLength":3,"description":"Hostname that scopes a merchant identifier, when known."},"limit":{"type":"integer","minimum":1,"maximum":20,"default":5}},"required":["identifier_type","identifier"]},"outputSchema":{"type":"object","additionalProperties":false,"properties":{"identifier_type":{"type":"string","enum":["asset_id","gtin","mpn","merchant_sku","merchant_product_id","merchant_variant_id"]},"identifier":{"type":"string","maxLength":160},"merchant_scope":{"type":["string","null"],"maxLength":253},"status":{"type":"string","enum":["no_match","matched_record","multiple_records","merchant_scope_required","image_unavailable"]},"match_count":{"type":"integer","minimum":0},"returned_count":{"type":"integer","minimum":0},"truncated":{"type":"boolean"},"merchant_scopes":{"type":"array","items":{"type":"string","maxLength":253},"maxItems":100},"merchant_scopes_truncated":{"type":"boolean"},"matches":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"image":{"type":"object","additionalProperties":false,"properties":{"asset_id":{"type":"string","maxLength":101,"minLength":1,"pattern":"^[A-Za-z0-9][A-Za-z0-9_-]*$"},"title":{"type":"string","maxLength":2000},"product_name":{"type":"string","maxLength":2000},"brand":{"type":"string","maxLength":200},"variant":{"type":"string","maxLength":200},"category":{"type":"string","maxLength":200},"alt_text":{"type":"string","maxLength":2000},"image_url":{"type":"string","maxLength":4096,"description":"Default public native-resolution lossless image. Never replace it with a thumbnail."},"image_width_px":{"type":"integer","minimum":1,"maximum":100000},"image_height_px":{"type":"integer","minimum":1,"maximum":100000},"image_mime_type":{"type":"string","const":"image/webp"},"image_access":{"type":"string","const":"public"},"image_quality":{"type":"string","const":"native_lossless"},"primary_image":{"type":"object","additionalProperties":false,"properties":{"url":{"type":"string","maxLength":4096},"width_px":{"type":"integer","minimum":1,"maximum":100000},"height_px":{"type":"integer","minimum":1,"maximum":100000},"mime_type":{"type":"string","const":"image/webp"},"access":{"type":"string","const":"public"},"role":{"type":"string","const":"primary"},"quality":{"type":"string","const":"native_lossless"},"rendered_image_sha256":{"type":"string","maxLength":64,"minLength":64,"pattern":"^[a-f0-9]{64}$"}},"required":["url","width_px","height_px","mime_type","access","role","quality","rendered_image_sha256"]},"thumbnail_url":{"type":["string","null"],"maxLength":4096,"description":"Optional secondary thumbnail only."},"thumbnail_image":{"type":["object","null"],"additionalProperties":false,"properties":{"url":{"type":"string","maxLength":4096},"width_px":{"type":["integer","null"],"minimum":1,"maximum":100000},"height_px":{"type":["integer","null"],"minimum":1,"maximum":100000},"mime_type":{"type":"string","enum":["image/webp","image/png","image/jpeg","image/avif"]},"access":{"type":"string","const":"public"},"role":{"type":"string","const":"thumbnail"},"quality":{"type":"string","const":"thumbnail"}},"required":["url","width_px","height_px","mime_type","access","role","quality"]},"original_image":{"type":["object","null"],"additionalProperties":false,"properties":{"url":{"type":"string","maxLength":4096},"width_px":{"type":"integer","minimum":1,"maximum":100000},"height_px":{"type":"integer","minimum":1,"maximum":100000},"mime_type":{"type":"string","const":"image/png"},"access":{"type":"string","enum":["authorization_required","public"]},"role":{"type":"string","const":"original"},"rendered_image_sha256":{"type":"string","maxLength":64,"minLength":64,"pattern":"^[a-f0-9]{64}$"}},"required":["url","width_px","height_px","mime_type","access","role","rendered_image_sha256"]},"description":{"type":["object","null"],"additionalProperties":false,"properties":{"text":{"type":"string","maxLength":4000},"source_url":{"type":["string","null"],"maxLength":4096},"observed_at":{"type":["string","null"],"maxLength":64},"source_scope":{"type":["string","null"],"maxLength":80},"evidence_status":{"type":"string","enum":["catalog_declared","source_reported","source_reviewed","archived_source_observation","conflicted","not_established"]}},"required":["text","source_url","observed_at","source_scope","evidence_status"]},"identifiers":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"identifier_type":{"type":"string","enum":["asset_id","gtin","mpn","merchant_sku","merchant_product_id","merchant_variant_id"]},"value":{"type":"string","maxLength":200,"minLength":1},"merchant_scope":{"type":["string","null"],"maxLength":253},"source_url":{"type":["string","null"],"maxLength":4096},"observed_at":{"type":["string","null"],"maxLength":64},"source_scope":{"type":["string","null"],"maxLength":80},"evidence_status":{"type":"string","enum":["catalog_declared","source_reported","source_reviewed","archived_source_observation","conflicted","not_established"]}},"required":["identifier_type","value","merchant_scope","source_url","observed_at","source_scope","evidence_status"]},"maxItems":64},"facts":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","maxLength":120,"minLength":1},"value":{"type":"string","maxLength":2000,"minLength":1},"unit":{"type":["string","null"],"maxLength":80},"source_url":{"type":["string","null"],"maxLength":4096},"observed_at":{"type":["string","null"],"maxLength":64},"source_scope":{"type":["string","null"],"maxLength":80},"evidence_status":{"type":"string","enum":["catalog_declared","source_reported","source_reviewed","archived_source_observation","conflicted","not_established"]},"conflicted":{"type":"boolean"}},"required":["name","value","unit","source_url","observed_at","source_scope","evidence_status","conflicted"]},"maxItems":96},"sources":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"url":{"type":"string","maxLength":4096},"observed_at":{"type":["string","null"],"maxLength":64},"scope":{"type":["string","null"],"maxLength":80},"evidence_status":{"type":"string","enum":["catalog_declared","source_reported","source_reviewed","archived_source_observation","conflicted","not_established"]}},"required":["url","observed_at","scope","evidence_status"]},"maxItems":512},"caveats":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"field":{"type":"string","maxLength":120},"text":{"type":"string","maxLength":2000},"source_urls":{"type":"array","items":{"type":"string","maxLength":4096},"maxItems":16}},"required":["field","text","source_urls"]},"maxItems":64},"rights":{"type":"object","additionalProperties":false,"properties":{"ai_generated":{"type":["boolean","null"]},"approval_status":{"type":["string","null"],"maxLength":80},"license_id":{"type":["string","null"],"maxLength":200},"license_url":{"type":["string","null"],"maxLength":4096},"reuse_status":{"type":["string","null"],"maxLength":120}},"required":["ai_generated","approval_status","license_id","license_url","reuse_status"]},"geometry":{"type":"object","additionalProperties":false,"properties":{"canvas_width_px":{"type":"integer","minimum":1,"maximum":100000},"canvas_height_px":{"type":"integer","minimum":1,"maximum":100000},"alpha_channel":{"type":["boolean","null"]},"alpha_channel_status":{"type":"string","enum":["unknown","measured"]}},"required":["canvas_width_px","canvas_height_px","alpha_channel","alpha_channel_status"]},"product_associations":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"title":{"type":"string","maxLength":2000},"variant":{"type":"string","maxLength":200},"identifiers":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"identifier_type":{"type":"string","enum":["asset_id","gtin","mpn","merchant_sku","merchant_product_id","merchant_variant_id"]},"value":{"type":"string","maxLength":200,"minLength":1},"merchant_scope":{"type":["string","null"],"maxLength":253},"source_url":{"type":["string","null"],"maxLength":4096},"observed_at":{"type":["string","null"],"maxLength":64},"source_scope":{"type":["string","null"],"maxLength":80},"evidence_status":{"type":"string","enum":["catalog_declared","source_reported","source_reviewed","archived_source_observation","conflicted","not_established"]}},"required":["identifier_type","value","merchant_scope","source_url","observed_at","source_scope","evidence_status"]},"maxItems":32},"source_url":{"type":["string","null"],"maxLength":4096},"observed_at":{"type":["string","null"],"maxLength":64},"relation":{"type":"string","const":"listed_for"},"exact_variant_verified":{"type":"boolean","const":false}},"required":["title","variant","identifiers","source_url","observed_at","relation","exact_variant_verified"]},"maxItems":256}},"required":["asset_id","title","product_name","brand","variant","category","alt_text","image_url","image_width_px","image_height_px","image_mime_type","image_access","image_quality","primary_image","thumbnail_url","thumbnail_image","original_image","description","identifiers","facts","sources","caveats","rights","geometry","product_associations"]},"matched_identifiers":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"identifier_type":{"type":"string","enum":["asset_id","gtin","mpn","merchant_sku","merchant_product_id","merchant_variant_id"]},"value":{"type":"string","maxLength":200,"minLength":1},"merchant_scope":{"type":["string","null"],"maxLength":253},"source_url":{"type":["string","null"],"maxLength":4096},"observed_at":{"type":["string","null"],"maxLength":64},"source_scope":{"type":["string","null"],"maxLength":80},"evidence_status":{"type":"string","enum":["catalog_declared","source_reported","source_reviewed","archived_source_observation","conflicted","not_established"]}},"required":["identifier_type","value","merchant_scope","source_url","observed_at","source_scope","evidence_status"]},"maxItems":32}},"required":["image","matched_identifiers"]},"maxItems":20},"source_holds":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"identifier_type":{"type":"string","enum":["asset_id","gtin","mpn","merchant_sku","merchant_product_id","merchant_variant_id"]},"identifier":{"type":"string","maxLength":200,"minLength":1},"source_url":{"type":["string","null"],"maxLength":4096},"observed_at":{"type":["string","null"],"maxLength":64},"reason":{"type":"string","maxLength":2000,"minLength":1}},"required":["identifier_type","identifier","source_url","observed_at","reason"]},"maxItems":256},"snapshot":{"type":"string","maxLength":256},"error":{"type":"object","additionalProperties":false,"properties":{"code":{"type":"string","maxLength":80},"message":{"type":"string","maxLength":500},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":"integer","minimum":1,"maximum":60}},"required":["code","message"]}},"anyOf":[{"required":["identifier_type","identifier","merchant_scope","status","match_count","returned_count","truncated","merchant_scopes","merchant_scopes_truncated","matches","source_holds","snapshot"]},{"required":["error"]}]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get_related_images","title":"Get Related Images","description":"Retrieve related images using recorded product types, categories and brand labels, with optional exclusions. Similar labels do not establish product identity or compatibility. Returns the same native image metadata contract.","inputSchema":{"type":"object","additionalProperties":false,"properties":{"asset_id":{"type":"string","maxLength":101,"minLength":1,"pattern":"^[A-Za-z0-9][A-Za-z0-9_-]*$"},"same_type":{"type":"boolean","default":true},"brand_mode":{"type":"string","enum":["any","same","different"],"default":"any"},"excluded_terms":{"type":"array","items":{"type":"string","maxLength":80,"minLength":1},"maxItems":8},"exclude_asset_ids":{"type":"array","items":{"type":"string","maxLength":101,"minLength":1,"pattern":"^[A-Za-z0-9][A-Za-z0-9_-]*$"},"maxItems":50,"uniqueItems":true},"limit":{"type":"integer","minimum":1,"maximum":10,"default":5}},"required":["asset_id"]},"outputSchema":{"type":"object","additionalProperties":false,"properties":{"asset_id":{"type":"string","maxLength":101,"minLength":1,"pattern":"^[A-Za-z0-9][A-Za-z0-9_-]*$"},"images":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"asset_id":{"type":"string","maxLength":101,"minLength":1,"pattern":"^[A-Za-z0-9][A-Za-z0-9_-]*$"},"title":{"type":"string","maxLength":2000},"product_name":{"type":"string","maxLength":2000},"brand":{"type":"string","maxLength":200},"variant":{"type":"string","maxLength":200},"category":{"type":"string","maxLength":200},"alt_text":{"type":"string","maxLength":2000},"image_url":{"type":"string","maxLength":4096,"description":"Default public native-resolution lossless image. Never replace it with a thumbnail."},"image_width_px":{"type":"integer","minimum":1,"maximum":100000},"image_height_px":{"type":"integer","minimum":1,"maximum":100000},"image_mime_type":{"type":"string","const":"image/webp"},"image_access":{"type":"string","const":"public"},"image_quality":{"type":"string","const":"native_lossless"},"primary_image":{"type":"object","additionalProperties":false,"properties":{"url":{"type":"string","maxLength":4096},"width_px":{"type":"integer","minimum":1,"maximum":100000},"height_px":{"type":"integer","minimum":1,"maximum":100000},"mime_type":{"type":"string","const":"image/webp"},"access":{"type":"string","const":"public"},"role":{"type":"string","const":"primary"},"quality":{"type":"string","const":"native_lossless"},"rendered_image_sha256":{"type":"string","maxLength":64,"minLength":64,"pattern":"^[a-f0-9]{64}$"}},"required":["url","width_px","height_px","mime_type","access","role","quality","rendered_image_sha256"]},"thumbnail_url":{"type":["string","null"],"maxLength":4096,"description":"Optional secondary thumbnail only."},"thumbnail_image":{"type":["object","null"],"additionalProperties":false,"properties":{"url":{"type":"string","maxLength":4096},"width_px":{"type":["integer","null"],"minimum":1,"maximum":100000},"height_px":{"type":["integer","null"],"minimum":1,"maximum":100000},"mime_type":{"type":"string","enum":["image/webp","image/png","image/jpeg","image/avif"]},"access":{"type":"string","const":"public"},"role":{"type":"string","const":"thumbnail"},"quality":{"type":"string","const":"thumbnail"}},"required":["url","width_px","height_px","mime_type","access","role","quality"]},"original_image":{"type":["object","null"],"additionalProperties":false,"properties":{"url":{"type":"string","maxLength":4096},"width_px":{"type":"integer","minimum":1,"maximum":100000},"height_px":{"type":"integer","minimum":1,"maximum":100000},"mime_type":{"type":"string","const":"image/png"},"access":{"type":"string","enum":["authorization_required","public"]},"role":{"type":"string","const":"original"},"rendered_image_sha256":{"type":"string","maxLength":64,"minLength":64,"pattern":"^[a-f0-9]{64}$"}},"required":["url","width_px","height_px","mime_type","access","role","rendered_image_sha256"]},"description":{"type":["object","null"],"additionalProperties":false,"properties":{"text":{"type":"string","maxLength":4000},"source_url":{"type":["string","null"],"maxLength":4096},"observed_at":{"type":["string","null"],"maxLength":64},"source_scope":{"type":["string","null"],"maxLength":80},"evidence_status":{"type":"string","enum":["catalog_declared","source_reported","source_reviewed","archived_source_observation","conflicted","not_established"]}},"required":["text","source_url","observed_at","source_scope","evidence_status"]},"identifiers":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"identifier_type":{"type":"string","enum":["asset_id","gtin","mpn","merchant_sku","merchant_product_id","merchant_variant_id"]},"value":{"type":"string","maxLength":200,"minLength":1},"merchant_scope":{"type":["string","null"],"maxLength":253},"source_url":{"type":["string","null"],"maxLength":4096},"observed_at":{"type":["string","null"],"maxLength":64},"source_scope":{"type":["string","null"],"maxLength":80},"evidence_status":{"type":"string","enum":["catalog_declared","source_reported","source_reviewed","archived_source_observation","conflicted","not_established"]}},"required":["identifier_type","value","merchant_scope","source_url","observed_at","source_scope","evidence_status"]},"maxItems":64},"facts":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","maxLength":120,"minLength":1},"value":{"type":"string","maxLength":2000,"minLength":1},"unit":{"type":["string","null"],"maxLength":80},"source_url":{"type":["string","null"],"maxLength":4096},"observed_at":{"type":["string","null"],"maxLength":64},"source_scope":{"type":["string","null"],"maxLength":80},"evidence_status":{"type":"string","enum":["catalog_declared","source_reported","source_reviewed","archived_source_observation","conflicted","not_established"]},"conflicted":{"type":"boolean"}},"required":["name","value","unit","source_url","observed_at","source_scope","evidence_status","conflicted"]},"maxItems":96},"sources":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"url":{"type":"string","maxLength":4096},"observed_at":{"type":["string","null"],"maxLength":64},"scope":{"type":["string","null"],"maxLength":80},"evidence_status":{"type":"string","enum":["catalog_declared","source_reported","source_reviewed","archived_source_observation","conflicted","not_established"]}},"required":["url","observed_at","scope","evidence_status"]},"maxItems":512},"caveats":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"field":{"type":"string","maxLength":120},"text":{"type":"string","maxLength":2000},"source_urls":{"type":"array","items":{"type":"string","maxLength":4096},"maxItems":16}},"required":["field","text","source_urls"]},"maxItems":64},"rights":{"type":"object","additionalProperties":false,"properties":{"ai_generated":{"type":["boolean","null"]},"approval_status":{"type":["string","null"],"maxLength":80},"license_id":{"type":["string","null"],"maxLength":200},"license_url":{"type":["string","null"],"maxLength":4096},"reuse_status":{"type":["string","null"],"maxLength":120}},"required":["ai_generated","approval_status","license_id","license_url","reuse_status"]},"geometry":{"type":"object","additionalProperties":false,"properties":{"canvas_width_px":{"type":"integer","minimum":1,"maximum":100000},"canvas_height_px":{"type":"integer","minimum":1,"maximum":100000},"alpha_channel":{"type":["boolean","null"]},"alpha_channel_status":{"type":"string","enum":["unknown","measured"]}},"required":["canvas_width_px","canvas_height_px","alpha_channel","alpha_channel_status"]},"product_associations":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"title":{"type":"string","maxLength":2000},"variant":{"type":"string","maxLength":200},"identifiers":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"identifier_type":{"type":"string","enum":["asset_id","gtin","mpn","merchant_sku","merchant_product_id","merchant_variant_id"]},"value":{"type":"string","maxLength":200,"minLength":1},"merchant_scope":{"type":["string","null"],"maxLength":253},"source_url":{"type":["string","null"],"maxLength":4096},"observed_at":{"type":["string","null"],"maxLength":64},"source_scope":{"type":["string","null"],"maxLength":80},"evidence_status":{"type":"string","enum":["catalog_declared","source_reported","source_reviewed","archived_source_observation","conflicted","not_established"]}},"required":["identifier_type","value","merchant_scope","source_url","observed_at","source_scope","evidence_status"]},"maxItems":32},"source_url":{"type":["string","null"],"maxLength":4096},"observed_at":{"type":["string","null"],"maxLength":64},"relation":{"type":"string","const":"listed_for"},"exact_variant_verified":{"type":"boolean","const":false}},"required":["title","variant","identifiers","source_url","observed_at","relation","exact_variant_verified"]},"maxItems":256}},"required":["asset_id","title","product_name","brand","variant","category","alt_text","image_url","image_width_px","image_height_px","image_mime_type","image_access","image_quality","primary_image","thumbnail_url","thumbnail_image","original_image","description","identifiers","facts","sources","caveats","rights","geometry","product_associations"]},"maxItems":10},"returned_count":{"type":"integer","minimum":0},"snapshot":{"type":"string","maxLength":256},"error":{"type":"object","additionalProperties":false,"properties":{"code":{"type":"string","maxLength":80},"message":{"type":"string","maxLength":500},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":"integer","minimum":1,"maximum":60}},"required":["code","message"]}},"anyOf":[{"required":["asset_id","images","returned_count","snapshot"]},{"required":["error"]}]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}}]}