flow

{'type': 'object', 'properties': {'origin': {'type': 'string', 'description': 'Optional origin place string, e.g. "Dallas, TX" - used only to pick which states to include'}, 'destination': {'type': 'string', 'description': 'Optional destination place string'}}}

{'type': 'object', 'required': ['truck', 'currentFuelGallons', 'origin', 'destination'], 'properties': {'truck': {'type': 'object', 'required': ['tankCapacityGallons', 'mpgForPlanning'], 'properties': {'ref': {'type': 'string', 'description': 'Your identifier for this truck, echoed back'}, 'mpgEmpty': {'type': 'number', 'description': 'Optional empty MPG (defaults to mpgForPlanning)'}, 'mpgLoaded': {'type': 'number', 'description': 'Optional loaded MPG (defaults to mpgForPlanning)'}, 'mpgForPlanning': {'type': 'number', 'description': 'Planning miles-per-gallon (e.g. 6.5)'}, 'weightSensitive': {'type': 'boolean', 'description': 'Penalize hauling extra fuel weight'}, 'tankCapacityGallons': {'type': 'number', 'description': 'Total tank capacity in gallons (e.g. 240)'}}}, 'origin': {'anyOf': [{'type': 'object', 'required': ['lat', 'lng'], 'properties': {'lat': {'type': 'number'}, 'lng': {'type': 'number'}}}, {'type': 'string'}], 'description': 'Where the trip starts, as {lat,lng} or a place string like "Des Moines, IA"'}, 'tripId': {'type': 'string', 'description': "Optional: the tripId returned by this trip's first call. Pass it (with an updated currentLocation) to replan the SAME trip at the $0.08 replan rate; omit it for a new trip ($2.25). Must match the trip's destination and be within 14 days."}, 'options': {'type': 'object', 'properties': {'pricingModel': {'enum': ['retail', 'rack'], 'type': 'string'}, 'averageSpeedMph': {'type': 'number'}, 'destinationState': {'type': 'string', 'description': 'Two-letter state for destination-state tax awareness'}, 'minGallonsPerStop': {'type': 'number'}, 'remainingDriveHours': {'type': 'number', 'description': 'HOS hours left; constrains reachable stops'}, 'discoveryRadiusMiles': {'type': 'number', 'description': 'Station search radius off-route (default 25)'}, 'minFuelReserveGallons': {'type': 'number'}, 'preferLargeTruckStops': {'type': 'boolean'}, 'interstateComplianceMode': {'type': 'boolean'}, 'outOfRoutePenaltyPerMile': {'type': 'number', 'description': 'Dollar penalty per out-of-route mile (default 4)'}}, 'description': 'Optional planning knobs'}, 'taxRates': {'type': 'array', 'items': {'type': 'object', 'required': ['jurisdiction', 'taxRatePerGallon'], 'properties': {'jurisdiction': {'type': 'string'}, 'taxRatePerGallon': {'type': 'number'}}}, 'description': 'Optional per-jurisdiction diesel tax overrides; defaults to current US/CA rates'}, 'vendorRule': {'type': 'object', 'required': ['allowedVendors'], 'properties': {'allowedVendors': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 20, 'minItems': 1, 'description': 'Brand names the truck may fuel at, e.g. ["Loves"] or ["Pilot", "Flying J"]'}}, 'description': 'STRICT vendor allowlist. Set this whenever the user says they can only fuel at certain brands ("Love\'s only"). Only stations of these brands are considered; the plan never falls back to other brands. Aliases are accepted (Love\'s / Loves / Love, Pilot / Flying J / PFJ, TA / Petro). Infeasible under the rule returns the structured error no_feasible_plan_under_vendor_rule.'}, 'destination': {'anyOf': [{'type': 'object', 'required': ['lat', 'lng'], 'properties': {'lat': {'type': 'number'}, 'lng': {'type': 'number'}}}, {'type': 'string'}], 'description': 'Destination as {lat,lng} or a place string like "Denver, CO"'}, 'currentLocation': {'type': 'object', 'required': ['lat', 'lng'], 'properties': {'lat': {'type': 'number'}, 'lng': {'type': 'number'}}, 'description': "Optional: the truck's live position for a mid-trip replan. Defaults to origin; when set, the plan covers the remaining leg from here."}, 'discountSchedule': {'type': 'array', 'items': {'type': 'object', 'required': ['discountType', 'discountAmount'], 'properties': {'id': {'type': 'string'}, 'region': {'type': 'string', 'description': 'Optional state/region restriction'}, 'vendor': {'type': 'string', 'description': 'Truck stop brand the discount applies to (e.g. "Loves", "Pilot"); omit for all. Use the same brand name as vendorRule.allowedVendors when the user is restricted to that brand.'}, 'discountType': {'enum': ['CENTS_PER_GALLON', 'PERCENTAGE'], 'type': 'string'}, 'discountAmount': {'type': 'number', 'description': 'Cents per gallon, or percent for PERCENTAGE'}}}, 'description': 'Your negotiated fuel discounts, applied on top of retail to optimize on net price'}, 'currentFuelGallons': {'type': 'number', 'description': 'Fuel currently in the tank, in gallons'}}}