tripadvice

type Context struct {
	OriginLabel      string
	DestinationLabel string
	// DriveMode is the mode the user explicitly chose, or "" for
	// "let the planner pick". Included so the model can say "you
	// planned in Conserve mode" rather than treating it as a mystery.
	DriveMode   string
	StartingSoC float64
	HasAdapter  bool
	// Weather at the origin at departure time. nil when the operator
	// has not enabled the weather feature (recap.weather_enabled).
	Weather *weather.Snapshot
	// TirePressurebars holds [FL, FR, RL, RR] in bar from the live
	// vehicle state. Zero values mean unavailable for that corner.
	TirePressureBars [4]float64
	// PackKWh is the observed battery capacity in kWh from the vehicle
	// record. 0 means unknown.
	PackKWh float64
	// TirePlacardPSI is the user-configured door-jamb cold-fill
	// pressure from the vehicle profile. 0 means unconfigured; the
	// prompt then falls back to a generic "below placard" framing
	// instead of citing a specific number.
	TirePlacardPSI float64
	// HomePricePerKWh is the user's at-home charging cost in
	// HomeCurrency (typically USD). 0 means unconfigured — the cost
	// section degrades to a pure-DCFC estimate.
	HomePricePerKWh float64
	HomeCurrency    string
	// GasPricePerGallon × distance / ComparisonMPG drives the gas-
	// equivalent chip. Both must be > 0 for the chip to render.
	GasPricePerGallon float64
	ComparisonMPG     float64
	// DCFCNetworks is the user's edited price book from Settings.
	// Pass nil or empty to use the built-in defaults from dcfcrates.
	// Per-stop rates honour each row's MemberActive flag so the
	// estimate's user-totals match what the user has actually
	// signed up for.
	DCFCNetworks []dcfcrates.NetworkOverride
}

type CostEstimate struct {
	Currency            string  `json:"currency"`
	DCFCSpend           float64 `json:"dcfc_spend"`
	DCFCSpendUserMember float64 `json:"dcfc_spend_user_member"`
	DCFCSpendAllMember  float64 `json:"dcfc_spend_all_member"`
	HomeEquivalent      float64 `json:"home_equivalent"`
	// GasEquivalent is what the same distance would cost in an ICE
	// vehicle at the user's configured gas price + MPG. Zero when
	// either input is unset.
	GasEquivalent     float64 `json:"gas_equivalent"`
	GasPricePerGallon float64 `json:"gas_price_per_gallon"`
	GasMPG            float64 `json:"gas_mpg"`
	// DCFCRateUsed is the avg per-kWh guest rate weighted by energy.
	// Falls back to DefaultDCFCRateUSD when no waypoints priced.
	DCFCRateUsed           float64 `json:"dcfc_rate_used"`
	DCFCRateUsedUserMember float64 `json:"dcfc_rate_used_user_member"`
	DCFCRateUsedAllMember  float64 `json:"dcfc_rate_used_all_member"`
	// HomeRateUsed is the user's configured at-home rate, 0 when
	// unconfigured.
	HomeRateUsed float64 `json:"home_rate_used"`
	// Breakdown lists each priced stop. Empty when no DCFC stops
	// were on the route (all-from-home trip).
	Breakdown []CostStop `json:"breakdown,omitempty"`
}

type CostStop struct {
	NetworkSlug   string  `json:"network_slug"`
	NetworkName   string  `json:"network_name"`
	ChargerName   string  `json:"charger_name"`
	EnergyKWh     float64 `json:"energy_kwh"`
	GuestRate     float64 `json:"guest_rate"`
	UserRate      float64 `json:"user_rate"`
	AllMemberRate float64 `json:"all_member_rate"`
	MemberPlan    string  `json:"member_plan,omitempty"`
}

type Parsed struct {
	Headline   string   `json:"headline"`
	Cost       []string `json:"cost"`
	Efficiency []string `json:"efficiency"`
	Weather    []string `json:"weather"`
	Vehicle    []string `json:"vehicle"`
}

type Result struct {
	// Raw is the model's reply, stored and forwarded as-is.
	Raw          string
	Parsed       *Parsed
	Model        string
	InputTokens  int64
	OutputTokens int64
	// Cost is computed deterministically in Go (not by the LLM) so
	// the dollar figure is always accurate. The LLM gets the same
	// numbers in the prompt and writes the commentary around them.
	Cost CostEstimate
}