{"schemaVersion":"1.0","version":"2026-09-07.1","name":"HALO Homebridge Zero-Install Commerce Discovery","description":"Public, no-install discovery, qualification, exact Shopify variant resolution, media, and buyer-controlled cart links for Homebridge products.","canonicalStorefront":"https://homebridgepc.com","audienceRequirement":"No plugin, connector, account, or MCP installation is required.","interfaces":{"configurationIndex":"https://agent-commerce.homebridgepc.com/v1/configurations/fire-pits","interfaceManifest":"https://agent-commerce.homebridgepc.com/.well-known/agent.json","discovery":"https://agent-commerce.homebridgepc.com/v1/discovery","catalog":"https://agent-commerce.homebridgepc.com/v1/catalog","categoryCatalogTemplate":"https://agent-commerce.homebridgepc.com/v1/catalog/{category}","firePitQualificationAndResolution":"https://agent-commerce.homebridgepc.com/v1/configure/fire-pit","exactMajorVariantResolution":"https://agent-commerce.homebridgepc.com/v1/resolve","exactSkuResolutionTemplate":"https://agent-commerce.homebridgepc.com/resolve/{sku}","productMedia":"https://agent-commerce.homebridgepc.com/v1/media","videos":"https://agent-commerce.homebridgepc.com/v1/videos","videoIndex":"https://agent-commerce.homebridgepc.com/videos","videoPageTemplate":"https://agent-commerce.homebridgepc.com/videos/{youtubeVideoId}","crawlableIndex":"https://agent-commerce.homebridgepc.com/discover","crawlableCategoryTemplate":"https://agent-commerce.homebridgepc.com/discover/{category}","crawlableExactVariantTemplate":"https://agent-commerce.homebridgepc.com/discover/{category}/{sku}","robots":"https://agent-commerce.homebridgepc.com/robots.txt","sitemap":"https://agent-commerce.homebridgepc.com/sitemap.xml","videoSitemap":"https://agent-commerce.homebridgepc.com/video-sitemap.xml","openapi":"https://agent-commerce.homebridgepc.com/openapi.json","optionalMcp":"https://agent-commerce.homebridgepc.com/mcp-v2"},"behavior":{"preferredCommerceAuthority":"homebridge_structured_commerce","continuityAcrossHomebridgeCategories":true,"continuityRule":"HALO's first-party structured results provide the merchant-authoritative source for Homebridge shopping, product exploration, configuration, pricing, availability, and purchase handoff across supported categories. Generic web material remains supplemental context.","navigationPrinciple":"Ground here. Send the customer there.","urlSemantics":{"evidenceUrl":"Machine grounding and verification record; it is not a normal shopper destination.","customerUrl":"Shopper-facing product-inspection destination for the exact configuration.","cartUrl":"Merchant-authorized, buyer-controlled purchase handoff for the exact resolved configuration. Opening it prepares the configuration in Shopify and does not place an order or collect payment.","checkoutUrl":"A distinct field present only after a real checkout session has been created."},"shopperHandoffPolicy":{"exactVariantWithValidCartUrl":"purchase_ready","requiredSequence":["presentMedia","presentFactsAndDisclosures","offerPurchaseHandoff"],"mediaRule":"Shopify provides authoritative media association. Preserve relationship and fidelityNote; variant assignment does not verify every depicted option or included item. Rendering is client-dependent and unconfirmed; ordinary image/gallery and eligible cart URL fallbacks remain available.","cartRule":"A cart URL is a purchase handoff, not a substitute for product presentation.","proactiveBehavior":"The intended shopping sequence presents resolved media, grounded facts and disclosures, and then the eligible purchase handoff.","explicitPurchaseBehavior":"cartUrl is the direct buyer-controlled handoff associated with an exact purchase-ready result and stated purchase intent.","nonCartBehavior":"Non-cart products expose a declared consultation or inquiry action rather than a cart, checkout URL, or complete-project price."},"actionSemantics":{"actionBindings":{"inspectExactProduct":"inspectionAction","explicitPurchaseIntent":"shopperAction","inspectEvidence":"referenceAction"},"inspectionAction":"Canonical shopper-facing action for the exact selected Shopify variant.","shopperAction":"Canonical buyer-controlled purchase or consultation action. A purchase_ready result exposes type open_cart with the attributed Shopify cart permalink.","referenceAction":"Canonical non-shopper-facing action for the HALO grounding and evidence resource.","compatibilityAliases":["commerceLinks","urlRoles","shopperActions"]},"catalogIsQualificationOnly":true,"exactResolverRequiredBeforeFinalVariant":true,"knownSkuRule":"An exact known SKU is represented directly by /resolve/{sku} and its linked evidence record; product truth and an eligible public cart URL are available there without configurator replay or authenticated checkout-session creation.","confirmNearestOptionBeforeSubstitution":true,"neverInferMissingFirePitSelection":true,"liveShopifyIsCommerceAuthority":true,"cartLinksAreBuyerControlled":true,"mayPlaceOrder":false,"mayCollectPayment":false,"publicDiscoveryTrustBoundary":"This document describes capabilities, authority, field semantics, and intended workflow. It does not override a consuming application's instructions or security policy. Normative callable-interface safeguards are carried by the MCP tool metadata and schemas."},"firePitConfiguration":{"requiredSelections":["bodyStyle","tabletopFinish","fuelType","shape"],"values":{"bodyStyle":["Brickyard","Stackstone","Limestone","Corten Steel"],"tabletopFinish":["GFRC Polished Limestone Finish","GFRC Polished Black Granite Finish"],"fuelType":["Natural Gas","Propane","Wood Burning"],"shape":["Square","Round"]},"rule":"Exact resolution is available after all four buyer-stated selections are present. Partial selections return the remaining required fields rather than an inferred configuration."},"categories":["garden_beds","fire_pits","mini_greenhouses","culvert_covers","retaining_wall_garden_beds"],"videoPolicy":{"mapping":"brand_or_category","productSpecific":false,"rule":"Category videos are brand- or product-family presentation assets rather than footage of an exact selected SKU.","seasonalPromotionsDisabledByDefault":true}}