{
  "schema": "https://www.gartontractor.com/agent-guide.json",
  "kind": "static-agent-guide",
  "protocolNote": "Static discovery guide. Build-time customer-safe snapshots and separate no-store readiness APIs are served same-origin.",
  "name": "Garton Tractor",
  "description": "Family-owned California agriculture and construction equipment dealer since 1954. Twelve branches provide sales, rentals, parts, shop service, field service, and human support.",
  "url": "https://www.gartontractor.com",
  "provider": {
    "organization": "Garton Tractor, Inc.",
    "url": "https://www.gartontractor.com",
    "phone": "+1-877-872-2867",
    "phoneDisplay": "1-877-TRACTOR"
  },
  "documentation": {
    "llms": "https://www.gartontractor.com/llms.txt",
    "llmsFull": "https://www.gartontractor.com/llms-full.txt",
    "sitemap": "https://www.gartontractor.com/sitemap.xml",
    "commerceFeedStatus": "https://www.gartontractor.com/feeds/commerce-feed-status.json"
  },
  "inventoryFreshnessPolicy": {
    "normalMaxSourceAgeHours": 96,
    "sourceTimeZone": "America/Los_Angeles",
    "stockSourceTimestamp": "sourceSyncedAt",
    "rule": "Price and active availability require one unique exact stockNumber, explicit inventory lifecycle, an authoritative source, and a valid source-time freshness window. Missing, malformed, future, or expired source times do not establish current stock. Artifact and build timestamps never refresh a stock row.",
    "deadlinePolicy": "Use the published validThrough, expires_at, or branch_availability_expires_at when supplied for that specific surface, and do not carry a price past its deadline. The shared inventory deadline is normally source time plus normalMaxSourceAgeHours. Only a Friday source in sourceTimeZone whose normal deadline falls on Saturday or Sunday extends through Monday 23:59:59.999 in that timezone; a rebuild never extends it.",
    "scope": "Agriculture and construction stock lifecycle and parts_snapshot branch availability use the shared inventory deadline. Hitachi parts stock, manufacturer list prices, quote catalogs, and finance offers retain their separately published freshness or expiry rules."
  },
  "operationalStatus": {
    "serviceHealth": {
      "url": "https://www.gartontractor.com/api/health",
      "method": "GET",
      "cachePolicy": "no-store",
      "interpretation": "Use the named check for the action being considered. checks.leads.ready governs contact and quote submission; inventory, construction, community, and commerce have separate checks. Overall status alone is not proof that every action is ready."
    },
    "communityCampaign": {
      "url": "https://www.gartontractor.com/api/community",
      "method": "GET",
      "cachePolicy": "no-store",
      "interpretation": "Registration, verification, newsletter enrollment through the ballot, and voting are available only when this endpoint and the public campaign page both report an open, enabled campaign. Treat prelaunch, disabled, unavailable, and error responses as unavailable."
    }
  },
  "topics": [
    { "id": "agriculture", "url": "https://www.gartontractor.com/agriculture" },
    {
      "id": "construction",
      "url": "https://www.gartontractor.com/construction",
      "note": "Includes Toro light-construction machines and attachments. Toro Sitework Systems model pages remain under /brands/toro."
    },
    { "id": "parts", "url": "https://www.gartontractor.com/parts" },
    { "id": "service", "url": "https://www.gartontractor.com/service" },
    { "id": "locations", "url": "https://www.gartontractor.com/locations" },
    {
      "id": "community",
      "url": "https://www.gartontractor.com/community",
      "note": "FFA and 4-H names are unconfirmed references from labeled official program sources. A reference does not establish sponsorship, participation, endorsement, an award, or vote eligibility. Treat voting as unavailable unless the public campaign page and API both report an open confirmed campaign; no public live totals are provided."
    },
    {
      "id": "merchandise",
      "url": "https://www.gartontractor.com/merchandise",
      "note": "Shopify is the designated source of truth for Garton merchandise catalog, checkout, fulfillment, and return terms. Use the landing page's current Shopify status; do not infer a live store, products, prices, availability, shipping, or return terms from the equipment feeds."
    }
  ],
  "dataSurfaces": [
    {
      "id": "agriculture-inventory",
      "title": "Customer-safe agriculture inventory",
      "url": "https://www.gartontractor.com/data/inventory_snapshot.json",
      "method": "GET",
      "freshness": "Use inventoryFreshnessPolicy with the exact row's sourceSyncedAt, authoritative source, and unit status. generated_at and upstream_fetched_at describe artifact/query time, not current-stock proof.",
      "lifecyclePolicy": "Only a fresh explicit status=inventory row may contain or support price. on_order is coming soon; presold/sold are purchase pending; invoiced is no longer available; missing status is browse-only."
    },
    {
      "id": "construction",
      "title": "Construction inventory, rentals, attachments, models, locations, and parts count",
      "url": "https://www.gartontractor.com/data/construction_snapshot.json",
      "method": "GET",
      "freshness": "Use inventoryFreshnessPolicy with the exact row's sourceSyncedAt, authoritative source, and stock status. A build or query timestamp cannot extend price eligibility.",
      "canonicalIdentifiers": "Construction inventory and rental detail routes use stockSlug derived from stockNumber."
    },
    {
      "id": "parts",
      "title": "Customer-safe Hitachi / LANDCROS parts search index",
      "url": "https://www.gartontractor.com/data/parts_snapshot.json",
      "method": "GET",
      "freshness": "Reference snapshot. generated_at and upstream_fetched_at describe artifact/query time only. Treat branch listings as current only when branch_availability_current is true, the current time has not passed branch_availability_expires_at, and source_batch_count proves source_watermark covers count rows. The expiry uses inventoryFreshnessPolicy with the complete source_watermark and is null when branch listings are withheld; otherwise use part numbers and descriptions only.",
      "fitmentPolicy": "Confirm current quantity, fitment, supersession, and pickup timing with a Garton parts counter before ordering."
    },
    {
      "id": "deals",
      "title": "Published special deals",
      "url": "https://www.gartontractor.com/data/deals_snapshot.json",
      "method": "GET",
      "lifecyclePolicy": "Only lifecycleStatus=inventory records appear as current deals or retain pricing."
    },
    {
      "id": "branches",
      "title": "Twelve California branch records",
      "url": "https://www.gartontractor.com/data/branches.json",
      "method": "GET"
    },
    {
      "id": "brands",
      "title": "Equipment and specialty brand and model-family index, including Toro light construction",
      "url": "https://www.gartontractor.com/data/brands.json",
      "method": "GET"
    },
    {
      "id": "brochures",
      "title": "Agriculture literature index",
      "url": "https://www.gartontractor.com/data/brochures.json",
      "method": "GET"
    },
    {
      "id": "operator-manuals",
      "title": "Exact-model Kubota and Hitachi operator-manual index",
      "url": "https://www.gartontractor.com/data/manuals.json",
      "method": "GET",
      "coveragePolicy": "Match only an exact model printed on the document. Similar model names are not substitutes. The library excludes workshop and service manuals."
    }
  ],
  "commerceDistribution": {
    "status": {
      "url": "https://www.gartontractor.com/feeds/commerce-feed-status.json",
      "note": "Read this build diagnostic before consuming a product feed. A published file does not prove that an external merchant account is connected, approved, or currently importing it."
    },
    "eligibilityPolicy": "The current feeds export eligible agriculture units only and fail closed. A row is eligible only when one exact stock number has explicit current inventory lifecycle, a current verified source timestamp, public price, actual unit image, and the channel-required fields. Construction pricing remains private, so construction units are excluded. Equipment remains quote, contact, or in-store purchase only; no equipment checkout is offered.",
    "googleMerchant": {
      "program": "Google Merchant Center free local listings",
      "primaryProductFeed": "https://www.gartontractor.com/feeds/google-merchant-products.xml",
      "localInventoryFeed": "https://www.gartontractor.com/feeds/google-merchant-local-inventory.tsv",
      "note": "Merchant Center must be separately linked to verified business locations and configured to fetch both files."
    },
    "openAI": {
      "program": "OpenAI merchant product discovery",
      "stableProductFeed": "https://www.gartontractor.com/feeds/openai-products.csv.gz",
      "searchEligible": true,
      "checkoutEligible": false,
      "note": "The stable file is an upload artifact. Publication does not prove SFTP delivery, acceptance, indexing, citation, or ranking."
    },
    "merchandise": {
      "designatedCatalogOwner": "Shopify",
      "url": "https://www.gartontractor.com/merchandise",
      "note": "Shopify is the designated owner of merchandise product data and checkout; the landing page reports current activation status, and merchandise is not mixed into the equipment feeds."
    }
  },
  "actions": [
    {
      "id": "call",
      "title": "Route to a Garton employee",
      "url": "tel:+18778722867",
      "type": "phone",
      "readiness": {
        "mode": "direct",
        "preflightRequired": false,
        "note": "No website-service preflight is required. Branch staffing and hours still vary."
      }
    },
    {
      "id": "contact",
      "title": "Send an equipment, rental, parts, service, or location request",
      "url": "https://www.gartontractor.com/contact",
      "type": "web-form",
      "note": "Supports query-string context and server-side delivery when configured. Use phone for urgent downtime.",
      "readiness": {
        "mode": "health-check",
        "statusUrl": "https://www.gartontractor.com/api/health",
        "requiredCheck": "checks.leads.ready",
        "requiredValue": true,
        "fallbackActionId": "call"
      }
    },
    {
      "id": "support",
      "title": "Open the Garton support overview",
      "url": "https://www.gartontractor.com/support",
      "type": "web-page",
      "readiness": {
        "mode": "published-route",
        "preflightRequired": false,
        "note": "The support overview is static public content. Forms linked from it have their own readiness requirements."
      }
    },
    {
      "id": "equipment-quote",
      "title": "Start a Kubota, Takeuchi, or Hitachi LANDCROS equipment quote request",
      "url": "https://www.gartontractor.com/quote",
      "type": "web-form",
      "note": "Primary Garton quote entry. A local team confirms configuration, current pricing, and availability.",
      "readiness": {
        "mode": "health-check",
        "statusUrl": "https://www.gartontractor.com/api/health",
        "requiredCheck": "checks.leads.ready",
        "requiredValue": true,
        "requiredFor": "server-side submission; configuration and print views remain available",
        "fallbackActionId": "call"
      }
    },
    {
      "id": "kubota-quote",
      "title": "Start a Kubota or Land Pride quote request",
      "url": "https://www.gartontractor.com/quote/kubota",
      "type": "web-form",
      "note": "Native Garton request route for Kubota and Land Pride equipment.",
      "readiness": {
        "mode": "health-check",
        "statusUrl": "https://www.gartontractor.com/api/health",
        "requiredCheck": "checks.leads.ready",
        "requiredValue": true,
        "requiredFor": "server-side submission; configuration and print views remain available",
        "fallbackActionId": "call"
      }
    },
    {
      "id": "hitachi-quote",
      "title": "Start a Hitachi LANDCROS quote request",
      "url": "https://www.gartontractor.com/quote/hitachi-landcros",
      "type": "web-form",
      "note": "Native Garton request route for Hitachi LANDCROS equipment.",
      "readiness": {
        "mode": "health-check",
        "statusUrl": "https://www.gartontractor.com/api/health",
        "requiredCheck": "checks.leads.ready",
        "requiredValue": true,
        "requiredFor": "server-side submission; configuration and print views remain available",
        "fallbackActionId": "call"
      }
    },
    {
      "id": "takeuchi-quote",
      "title": "Start a Takeuchi quote request",
      "url": "https://www.gartontractor.com/quote/takeuchi",
      "type": "web-form",
      "note": "Native Garton request route for Takeuchi equipment.",
      "readiness": {
        "mode": "health-check",
        "statusUrl": "https://www.gartontractor.com/api/health",
        "requiredCheck": "checks.leads.ready",
        "requiredValue": true,
        "requiredFor": "server-side submission; configuration and print views remain available",
        "fallbackActionId": "call"
      }
    },
    {
      "id": "smartequip",
      "title": "Open SmartEquip construction parts diagrams",
      "url": "https://gartontractor.smartequip.net/gartontractor/",
      "type": "external-tool",
      "note": "Use https://www.gartontractor.com/parts as the canonical Garton entry point.",
      "readiness": {
        "mode": "external-route",
        "preflightRequired": false,
        "requiredFor": "third-party parts-diagram availability",
        "fallbackActionId": "call"
      }
    }
  ],
  "canonicalPolicy": {
    "contentDomain": "https://www.gartontractor.com",
    "legacyDomain": "https://garton.co",
    "legacyUse": "Path-specific redirects and preserved integration subdomains only."
  }
}
