{"request_id":"req_57ef4d3c696245758563","success":true,"schema_version":"1.0","data_version":"c1.o0","data_mode":"production","generated_at":"2026-09-25T15:55:19.951Z","request":{"operation":"get_sunglasses_coverage","params":{}},"result":{"status":"COVERAGE","service":{"name":"sunglassesguides","market":"US","currency":"USD","units":"mm","language":"en-US","read_only":true,"a2a_supported":false,"action_layer":{"supported":false,"reason":"Version 1 is a read-only data service. No purchase, booking or write actions exist."}},"catalog":{"data_mode":"production","brands":[{"brand":"Ray-Ban","brand_id":"ray-ban","models":11,"published_variants":30},{"brand":"Oakley","brand_id":"oakley","models":14,"published_variants":26},{"brand":"Maui Jim","brand_id":"maui-jim","models":15,"published_variants":25}],"totals":{"brands":3,"models":40,"published_variants":81},"not_published":{},"target":{"variants":80,"note":"Target, not achieved unless published_variants says so."},"catalog_published_at":"2026-09-25T08:39:44Z","latest_batches":[{"batch_id":"b_3bf310148c50","kind":"catalog","label":"mauijim-2026-09-25a","status":"published","created_at":"2026-09-25T08:39:40Z","published_at":"2026-09-25T08:39:44Z","counts":{"models":15,"variants":25,"changed_variants":25,"unchanged_variants":0,"sources":27,"withheld_evidence":0}},{"batch_id":"b_00235bae6b85","kind":"catalog","label":"oakley-2026-09-25a","status":"published","created_at":"2026-09-25T08:39:32Z","published_at":"2026-09-25T08:39:44Z","counts":{"models":14,"variants":26,"changed_variants":26,"unchanged_variants":0,"sources":39,"withheld_evidence":0}},{"batch_id":"b_6e245432dce2","kind":"catalog","label":"rayban-2026-09-25a","status":"published","created_at":"2026-09-25T08:39:24Z","published_at":"2026-09-25T08:39:44Z","counts":{"models":11,"variants":30,"changed_variants":30,"unchanged_variants":0,"sources":33,"withheld_evidence":2}}]},"field_coverage":[{"field":"lens_width_mm","known":78,"unknown":3,"conflicting":0,"withheld":0,"known_pct":96},{"field":"bridge_width_mm","known":78,"unknown":3,"conflicting":0,"withheld":0,"known_pct":96},{"field":"temple_length_mm","known":48,"unknown":32,"conflicting":0,"withheld":1,"known_pct":59},{"field":"lens_height_mm","known":48,"unknown":32,"conflicting":0,"withheld":1,"known_pct":59},{"field":"frame_width_mm","known":23,"unknown":58,"conflicting":0,"withheld":0,"known_pct":28},{"field":"manufacturer_fit_label","known":39,"unknown":42,"conflicting":0,"withheld":0,"known_pct":48},{"field":"bridge_fit","known":39,"unknown":42,"conflicting":0,"withheld":0,"known_pct":48},{"field":"adjustable_nosepads","known":3,"unknown":78,"conflicting":0,"withheld":0,"known_pct":4},{"field":"frame_material","known":57,"unknown":24,"conflicting":0,"withheld":0,"known_pct":70},{"field":"frame_color","known":81,"unknown":0,"conflicting":0,"withheld":0,"known_pct":100},{"field":"lens_color","known":80,"unknown":1,"conflicting":0,"withheld":0,"known_pct":99},{"field":"polarized","known":44,"unknown":37,"conflicting":0,"withheld":0,"known_pct":54},{"field":"vlt_percent","known":19,"unknown":62,"conflicting":0,"withheld":0,"known_pct":23},{"field":"lens_category","known":16,"unknown":65,"conflicting":0,"withheld":0,"known_pct":20},{"field":"lens_material","known":29,"unknown":52,"conflicting":0,"withheld":0,"known_pct":36},{"field":"uv_claim","known":24,"unknown":57,"conflicting":0,"withheld":0,"known_pct":30},{"field":"gtin","known":0,"unknown":81,"conflicting":0,"withheld":0,"known_pct":0}],"fit_label_definitions":[{"brand":"Ray-Ban","label":"Low Bridge Fit","normalized":"low_bridge_fit","definition_excerpt":"Low bridge fit sunglasses are designed to accomodate those with low nose bridges.","source_id":"src_rayban_guide_low_bridge_fit_sunglasses"},{"brand":"Oakley","label":"Low Bridge Fit","normalized":"low_bridge_fit","definition_excerpt":"Offers a more secure and comfortable fit for those with a low nose bridge and higher cheekbones. A good choice if eyewear tends to slide down your nose, sit too low, or press on your temples or cheeks.","source_id":"src_oakleysi_oo9244_2556"},{"brand":"Oakley","label":"High Bridge Fit","normalized":"high_bridge_fit","definition_excerpt":"Offers a more secure and comfortable fit for those with a high nose bridge and lower cheekbones. A good choice if the bridge of your nose is above the level of your pupils.","source_id":"src_oakleysi_oo9250_0357"},{"brand":"Maui Jim","label":"Asian Fit","normalized":"low_bridge_fit","definition_excerpt":"Also referred to as \"low bridge fit\", \"alternative fit\", or \"universal fit\", Asian fit styles are nearly identical to their counterparts","source_id":"src_mauijim_support_asian_fit"},{"brand":"Maui Jim","label":"Universal Fit","normalized":"low_bridge_fit","definition_excerpt":"Also referred to as \"low bridge fit\", \"alternative fit\", or \"universal fit\", Asian fit styles are nearly identical to their counterparts","source_id":"src_mauijim_support_asian_fit"}],"offers":{"coverage":"not_covered","covered_offers":0,"merchants":[],"note":"No approved merchant or affiliate feed is connected. Offer tools are implemented and return NO_OFFER_COVERAGE."},"freshness_policy":{"specs":{"update_schedule":"manual","update_schedule_note":"Specifications are re-checked manually against maker pages; target cadence is monthly. There is no automated crawler. When a record is older than max_age_seconds, a spec condition it would pass is reported as stale, not pass.","max_age_seconds":2592000},"offers":{"update_schedule":"not_covered","update_schedule_note":"No approved merchant or affiliate price feed is connected. Offer tools return NO_OFFER_COVERAGE.","max_age_seconds":86400}},"task_coverage_matrix":[{"task_id":"size_only_polarized","title":"Polarized alternatives for an existing 52-18-140 frame","kind":"substitution","scenario":"The user only knows the temple marking 52-18-140 and needs frames the maker states are polarized.","tool":"find_sunglasses","input":{"reference_text":"52-18-140","require":{"polarized":true},"limit":3},"required_fields":["lens_width_mm","bridge_width_mm","temple_length_mm","polarized"],"variants_with_required_fields":31,"current_status":"MATCHES_FOUND","current_result_count":3,"verified_positive":true,"readiness":"ready","gaps":["lens_width_mm unknown for 3/81 published variants","bridge_width_mm unknown for 3/81 published variants","temple_length_mm unknown for 33/81 published variants","polarized unknown for 37/81 published variants"]},{"task_id":"resolve_ambiguous_model","title":"Identify an ambiguous model name","kind":"clarification","scenario":"The user says \"Ray-Ban Original Wayfarer\" without size or lens; the service must list the variants and ask for the missing detail.","tool":"resolve_sunglasses","input":{"query":"Ray-Ban Original Wayfarer"},"required_fields":["lens_width_mm","bridge_width_mm","lens_color"],"variants_with_required_fields":77,"current_status":"NEEDS_VARIANT","current_result_count":5,"verified_positive":true,"readiness":"ready","gaps":["lens_width_mm unknown for 3/81 published variants","bridge_width_mm unknown for 3/81 published variants","lens_color unknown for 1/81 published variants"]},{"task_id":"compare_fit_versions","title":"Compare standard and maker-labeled low bridge versions","kind":"comparison","scenario":"Compare Maui Jim Red Sands with Red Sands Asian Fit in the same colour: fit label, sizes and lens.","tool":"compare_sunglasses","input":{"variant_ids":["mauijim-432-2m","mauijim-432n-2m"]},"required_fields":["manufacturer_fit_label","lens_width_mm","bridge_width_mm","polarized"],"variants_with_required_fields":19,"current_status":"COMPARED","current_result_count":2,"verified_positive":true,"readiness":"ready","gaps":["manufacturer_fit_label unknown for 42/81 published variants","lens_width_mm unknown for 3/81 published variants","bridge_width_mm unknown for 3/81 published variants","polarized unknown for 37/81 published variants"]},{"task_id":"compound_low_bridge_polarized","title":"Maker-labeled low bridge fit AND polarized near 52-18-140","kind":"compound","scenario":"The composite demo: size close to 52-18-140, maker labels the variant low bridge fit, maker states polarized; show up to three with size differences and evidence.","tool":"find_sunglasses","input":{"reference_text":"52-18-140","require":{"polarized":true,"bridge_fit":"low_bridge_fit"},"limit":3},"required_fields":["lens_width_mm","bridge_width_mm","temple_length_mm","polarized","manufacturer_fit_label"],"variants_with_required_fields":19,"current_status":"MATCHES_FOUND","current_result_count":3,"verified_positive":true,"readiness":"ready","gaps":["lens_width_mm unknown for 3/81 published variants","bridge_width_mm unknown for 3/81 published variants","temple_length_mm unknown for 33/81 published variants","polarized unknown for 37/81 published variants","manufacturer_fit_label unknown for 42/81 published variants"]},{"task_id":"compound_with_budget","title":"Composite demo plus a 150 USD item-price budget","kind":"compound","scenario":"Same as the composite demo, plus one single covered US offer at or below 150 USD item price. 150 USD is a demo budget, not a price of any product.","tool":"find_sunglasses","input":{"reference_text":"52-18-140","require":{"polarized":true,"bridge_fit":"low_bridge_fit","max_item_price_usd":150},"limit":3},"required_fields":["lens_width_mm","bridge_width_mm","temple_length_mm","polarized","manufacturer_fit_label","offer"],"variants_with_required_fields":19,"current_status":"NO_OFFER_COVERAGE","current_result_count":0,"verified_positive":false,"readiness":"not_ready","gaps":["lens_width_mm unknown for 3/81 published variants","bridge_width_mm unknown for 3/81 published variants","temple_length_mm unknown for 33/81 published variants","polarized unknown for 37/81 published variants","manufacturer_fit_label unknown for 42/81 published variants","no merchant offer source connected (offers: not_covered)"]}],"product_state":{"engineering_ready":"see /data-quality and REQUIREMENTS_MATRIX.md for evidence","task_trial_ready":true,"task_trial_ready_basis":"4 task(s) with a verified positive answer; substitution task with >=2 real candidates: true; published variants 81 (first-trial target 20).","production_ready":false,"production_ready_basis":"Requires a verified public deployment, update/correction and recovery checks. Not claimed."},"capabilities":[{"tool":"get_sunglasses_coverage","rest":"GET /api/v1/coverage","implemented":true,"data_covered":"yes","externally_verified":false,"notes":"Computed live from the published catalog."},{"tool":"resolve_sunglasses","rest":"POST /api/v1/resolve","implemented":true,"data_covered":"partial","externally_verified":false,"notes":"Works over the published catalog only (Ray-Ban, Oakley, Maui Jim subset)."},{"tool":"find_sunglasses","rest":"POST /api/v1/search","implemented":true,"data_covered":"partial","externally_verified":false,"notes":"Offer conditions are implemented but no offer source is connected, so they return NO_OFFER_COVERAGE in production."},{"tool":"compare_sunglasses","rest":"POST /api/v1/compare","implemented":true,"data_covered":"partial","externally_verified":false,"notes":"Many fields are unknown for some brands; unknowns are reported, never filled from siblings."},{"tool":"get_sunglasses_variant","rest":"GET /api/v1/variants/{variant_id}","implemented":true,"data_covered":"partial","externally_verified":false,"notes":""},{"tool":"get_sunglasses_offers","rest":"GET /api/v1/variants/{variant_id}/offers","implemented":true,"data_covered":"no","externally_verified":false,"notes":"No approved merchant/affiliate feed is connected yet. Production returns NO_OFFER_COVERAGE."}]},"sources":[],"freshness":{"specs":{"update_schedule":"manual","update_schedule_note":"Specifications are re-checked manually against maker pages; target cadence is monthly. There is no automated crawler. When a record is older than max_age_seconds, a spec condition it would pass is reported as stale, not pass.","max_age_seconds":2592000,"as_of":"2026-09-25T08:24:02Z","status":"fresh","stale_reason":null,"records":{"fresh":81,"stale":0,"unknown":0},"note":"as_of is the oldest successful check time among the records in this response. Per-record checked_at is authoritative."},"offers":{"update_schedule":"not_covered","update_schedule_note":"No approved merchant or affiliate price feed is connected. Offer tools return NO_OFFER_COVERAGE.","max_age_seconds":86400,"as_of":null,"status":"not_covered","stale_reason":"no_offer_source_connected","records":{"fresh":0,"stale":0,"unknown":0}}},"cache":{"layer":"none","hit":null,"age_seconds":null,"expires_at":null,"note":"This response was computed for this request. No application response cache applies to this operation."},"next_actions":[],"error":null}