tools

type APIError struct {
	Service     string // The API service name (e.g., "Nominatim", "Overpass")
	StatusCode  int    // HTTP status code
	Message     string // Error message
	Recoverable bool   // Whether the error can be recovered from
	Guidance    string // Guidance for users on how to recover
}

type Address struct {
	Street      string `json:"street,omitempty"`
	HouseNumber string `json:"house_number,omitempty"`
	City        string `json:"city,omitempty"`
	State       string `json:"state,omitempty"`
	Country     string `json:"country,omitempty"`
	PostalCode  string `json:"postal_code,omitempty"`
	Formatted   string `json:"formatted,omitempty"`
}

type AreaDescription struct {
	Center       Location         `json:"center"`
	Radius       float64          `json:"radius"`
	Categories   map[string]int   `json:"categories"`
	PlaceCounts  map[string]int   `json:"place_counts"`
	KeyFeatures  []string         `json:"key_features"`
	TopPlaces    []Place          `json:"top_places"`
	Neighborhood NeighborhoodInfo `json:"neighborhood,omitempty"`
}

type ChargingStation struct {
	ID          string   `json:"id"`
	Name        string   `json:"name"`
	Location    Location `json:"location"`
	Distance    float64  `json:"distance,omitempty"` // in meters
	Operator    string   `json:"operator,omitempty"`
	SocketTypes []string `json:"socket_types,omitempty"`
	Power       string   `json:"power,omitempty"` // max power in kW
	Access      string   `json:"access,omitempty"`
	Fee         bool     `json:"fee,omitempty"`
}

type CommuteAnalysis struct {
	HomeLocation      Location        `json:"home_location"`
	WorkLocation      Location        `json:"work_location"`
	CommuteOptions    []CommuteOption `json:"commute_options"`
	RecommendedOption string          `json:"recommended_option"` // e.g., "car", "transit", "cycling"
	Factors           []string        `json:"factors,omitempty"`  // factors considered in recommendation
}

type CommuteOption struct {
	Mode           string   `json:"mode"`                      // car, transit, walking, cycling
	Distance       float64  `json:"distance"`                  // in meters
	Duration       float64  `json:"duration"`                  // in seconds
	Summary        string   `json:"summary"`                   // brief description of the route
	Instructions   []string `json:"instructions,omitempty"`    // turn-by-turn directions
	CO2Emission    float64  `json:"co2_emission,omitempty"`    // in kg, if available
	CaloriesBurned float64  `json:"calories_burned,omitempty"` // if applicable (walking, cycling)
	Cost           float64  `json:"cost,omitempty"`            // estimated cost in local currency, if available
}

type GeocodeAddressInput struct {
	Address string `json:"address"`
}

type GeocodeAddressOutput struct {
	Place Place `json:"place"`
}

type Location struct {
	Latitude  float64 `json:"latitude"`
	Longitude float64 `json:"longitude"`
}

type NeighborhoodAnalysis struct {
	Name            string   `json:"name,omitempty"`
	Location        Location `json:"location"`
	WalkScore       int      `json:"walk_score"`       // 0-100 walkability score
	BikeScore       int      `json:"bike_score"`       // 0-100 biking score
	TransitScore    int      `json:"transit_score"`    // 0-100 public transit score
	EducationScore  int      `json:"education_score"`  // 0-100 education facilities score
	ShoppingScore   int      `json:"shopping_score"`   // 0-100 shopping amenities score
	DiningScore     int      `json:"dining_score"`     // 0-100 dining options score
	RecreationScore int      `json:"recreation_score"` // 0-100 recreation options score
	SafetyScore     int      `json:"safety_score"`     // 0-100 safety score
	HealthcareScore int      `json:"healthcare_score"` // 0-100 healthcare facilities score
	OverallScore    int      `json:"overall_score"`    // 0-100 overall livability score
	PriceIndex      int      `json:"price_index"`      // 0-100 relative price index (higher is more expensive)
	Summary         string   `json:"summary"`          // Textual summary of the analysis
	KeyAmenities    []string `json:"key_amenities"`    // List of notable amenities nearby
	KeyIssues       []string `json:"key_issues"`       // List of notable issues or drawbacks
}

type NeighborhoodInfo struct {
	Name        string   `json:"name,omitempty"`
	Type        string   `json:"type,omitempty"`
	Description string   `json:"description,omitempty"`
	Tags        []string `json:"tags,omitempty"`
}

type OSRMLeg struct {
	Distance float64    `json:"distance"`
	Duration float64    `json:"duration"`
	Steps    []OSRMStep `json:"steps"`
	Summary  string     `json:"summary"`
	Weight   float64    `json:"weight"`
}

type OSRMManeuver struct {
	BearingAfter  int       `json:"bearing_after"`
	BearingBefore int       `json:"bearing_before"`
	Location      []float64 `json:"location"`
	Type          string    `json:"type"`
}

type OSRMRoute struct {
	Distance   float64   `json:"distance"`
	Duration   float64   `json:"duration"`
	Geometry   string    `json:"geometry"`
	Legs       []OSRMLeg `json:"legs"`
	Weight     float64   `json:"weight"`
	WeightName string    `json:"weight_name"`
}

type OSRMRouteResponse struct {
	Code      string         `json:"code"`
	Message   string         `json:"message,omitempty"`
	Routes    []OSRMRoute    `json:"routes,omitempty"`
	Waypoints []OSRMWaypoint `json:"waypoints,omitempty"`
}

type OSRMStep struct {
	Distance float64      `json:"distance"`
	Duration float64      `json:"duration"`
	Geometry string       `json:"geometry"`
	Maneuver OSRMManeuver `json:"maneuver"`
	Mode     string       `json:"mode"`
	Name     string       `json:"name"`
	Weight   float64      `json:"weight"`
}

type OSRMWaypoint struct {
	Distance float64   `json:"distance"`
	Name     string    `json:"name"`
	Location []float64 `json:"location"`
}

type ParkingArea struct {
	ID           string   `json:"id"`
	Name         string   `json:"name"`
	Location     Location `json:"location"`
	Distance     float64  `json:"distance,omitempty"`     // in meters
	Type         string   `json:"type,omitempty"`         // e.g., surface, underground, multi-storey
	Access       string   `json:"access,omitempty"`       // e.g., public, private, customers
	Capacity     int      `json:"capacity,omitempty"`     // number of parking spaces if available
	Fee          bool     `json:"fee,omitempty"`          // whether there's a parking fee
	MaxStay      string   `json:"max_stay,omitempty"`     // maximum parking duration if available
	Availability string   `json:"availability,omitempty"` // if real-time availability is known
	Wheelchair   bool     `json:"wheelchair,omitempty"`   // wheelchair accessibility
	Operator     string   `json:"operator,omitempty"`     // who operates the facility
}

type Place struct {
	ID         string   `json:"id,omitempty"`
	Name       string   `json:"name"`
	Location   Location `json:"location"`
	Address    Address  `json:"address,omitempty"`
	Categories []string `json:"categories,omitempty"`
	Rating     float64  `json:"rating,omitempty"`
	Distance   float64  `json:"distance,omitempty"` // in meters
}

type Registry struct {
	// contains filtered or unexported fields
}

type ReverseGeocodeInput struct {
	Latitude  float64 `json:"latitude"`
	Longitude float64 `json:"longitude"`
}

type ReverseGeocodeOutput struct {
	Place Place `json:"place"`
}

type Route struct {
	Distance     float64    `json:"distance"` // in meters
	Duration     float64    `json:"duration"` // in seconds
	StartPoint   Location   `json:"start_point"`
	EndPoint     Location   `json:"end_point"`
	Instructions []string   `json:"instructions"`
	Polyline     []Location `json:"polyline,omitempty"`
}

type RouteChargingStation struct {
	ChargingStation
	DistanceFromStart float64 `json:"distance_from_start"` // in meters
	PercentAlongRoute float64 `json:"percent_along_route"` // 0-100
}

type RouteDirections struct {
	Distance    float64     `json:"distance"`    // Total distance in meters
	Duration    float64     `json:"duration"`    // Total duration in seconds
	StartPoint  Location    `json:"start_point"` // Starting point
	EndPoint    Location    `json:"end_point"`   // Ending point
	Segments    []Segment   `json:"segments"`    // Route segments
	Coordinates [][]float64 `json:"coordinates"` // Route geometry as [lon, lat] pairs
}

type School struct {
	ID          string   `json:"id"`
	Name        string   `json:"name"`
	Location    Location `json:"location"`
	Distance    float64  `json:"distance,omitempty"`     // in meters
	Type        string   `json:"type,omitempty"`         // e.g., elementary, secondary, university
	Rating      float64  `json:"rating,omitempty"`       // if available
	IsPublic    bool     `json:"is_public,omitempty"`    // true for public schools
	Website     string   `json:"website,omitempty"`      // school website if available
	PhoneNumber string   `json:"phone_number,omitempty"` // contact number if available
}

type Segment struct {
	Distance    float64  `json:"distance"`    // Segment distance in meters
	Duration    float64  `json:"duration"`    // Segment duration in seconds
	Instruction string   `json:"instruction"` // Human-readable instruction
	Location    Location `json:"location"`    // Location of the maneuver
}

type ToolDefinition struct {
	Name        string
	Description string
	Tool        mcp.Tool
	Handler     func(ctx context.Context, req mcp.CallToolRequest) (*mcp.CallToolResult, error)
}

type TransportMode string