tripadvice

type Context struct {
	// 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
	// OwnRates is what the user actually paid per kWh at each network (slug), from
	// their own receipts, with how many sessions it rests on. The caller supplies
	// only figures that meet the minimum (receipts.PaidMinSessions) in this
	// context's currency. nil when the user has no receipts.
	OwnRates map[string]OwnRate
	// Now is the clock for the observed-price expiry; zero means time.Now().
	Now time.Time
}

type CostEstimate struct {
	Currency string `json:"currency"`
	// DCFCSpendLow and DCFCSpendHigh sum the priced stops' cost range. Equal when no
	// priced stop has a range; both 0 when no stop has a price (see PricedStops).
	DCFCSpendLow  float64 `json:"dcfc_spend_low"`
	DCFCSpendHigh float64 `json:"dcfc_spend_high"`
	// PricedStops and UnpricedStops count the DC fast stops with and without a price,
	// so the UI can say "partial: 2 of 3 stops priced".
	PricedStops   int `json:"priced_stops"`
	UnpricedStops int `json:"unpriced_stops"`
	// EstimateBasis is which sources fed the figure: "your_receipts", "your_setting",
	// "observed", "mixed" (more than one of them) or "none" (no stop priced). The UI
	// words the estimate from it ("estimate (typical observed price)" when observed or
	// mixed).
	EstimateBasis  string  `json:"estimate_basis"`
	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"`
	// HomeRateUsed is the user's configured at-home rate, 0 when
	// unconfigured.
	HomeRateUsed float64 `json:"home_rate_used"`
	// Breakdown lists each DC fast 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"`
	MemberPlan  string  `json:"member_plan,omitempty"`
	// Price is nil when there is none for this stop: "price shown at the charger".
	Price *StopPrice `json:"price"`
	// CostLow and CostHigh are EnergyKWh times the price range, nil with no price.
	CostLow  *float64 `json:"cost_low"`
	CostHigh *float64 `json:"cost_high"`
}

type OwnRate struct {
	PerKWh   float64
	Sessions int
}

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
}

type StopPrice struct {
	Basis      string  `json:"basis"`
	PerKWhLow  float64 `json:"per_kwh_low"`
	PerKWhHigh float64 `json:"per_kwh_high"`
	// LowNote and HighNote say what each end of a range is (observed Tesla: with and
	// without the membership); empty when the ends are equal.
	LowNote  string `json:"low_note,omitempty"`
	HighNote string `json:"high_note,omitempty"`
	// Sessions is how many of the user's receipts a your_receipts figure rests on.
	Sessions int `json:"sessions,omitempty"`
	// Source, SourceURL and ObservedMonth name the third party behind an observed figure.
	Source        string `json:"source,omitempty"`
	SourceURL     string `json:"source_url,omitempty"`
	ObservedMonth string `json:"observed_month,omitempty"`
	// Label is the exact wording to show with the figure.
	Label string `json:"label"`
}