app

type APODInput struct {
	// Date in YYYY-MM-DD format. Leave empty for today's picture.
	Date string `json:"date,omitempty"`
}

type APODResult struct {
	Date        string `json:"date"`
	Title       string `json:"title"`
	Explanation string `json:"explanation"`
	URL         string `json:"url"`
	HDURL       string `json:"hdurl,omitempty"`
	MediaType   string `json:"media_type"`
	Copyright   string `json:"copyright,omitempty"`
}

type Brief struct {
	ID          string       `json:"id"`          // YYYY-MM-DD (UTC)
	GeneratedAt string       `json:"generatedAt"` // RFC3339
	Headline    BriefSection `json:"headline"`
	EarthWatch  BriefSection `json:"earthWatch"`
	PhotoOfDay  BriefSection `json:"photoOfDay"`
	DidYouKnow  BriefSection `json:"didYouKnow"`
}

type BriefGenerator interface {
	Generate(ctx context.Context, date string) (*Brief, error)
}

type BriefSection struct {
	Title    string `json:"title"`
	Body     string `json:"body"`
	ImageURL string `json:"imageUrl,omitempty"`
}

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

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

type ChatRunner interface {
	// LoadSession returns a Session hydrated from the given bytes,
	// or a fresh Session when raw is empty.
	LoadSession(ctx context.Context, raw []byte) (*agent.Session, error)

	// Run drives one turn of the agent against userMessage, mutating
	// sess in place and emitting SSE frames via emit(event, payload).
	// Frame vocabulary: "text", "tool_call", "tool_result".
	Run(ctx context.Context, sess *agent.Session, userMessage string, emit func(event string, payload any) error) error
}

type EarthEvent struct {
	ID         string               `json:"id"`
	Title      string               `json:"title"`
	Link       string               `json:"link"`
	Categories []EarthEventCategory `json:"categories"`
}

type EarthEventCategory struct {
	Title string `json:"title"`
}

type EarthEventsInput struct {
	// One of: "open" (active) or "closed". Defaults to "open".
	Status string `json:"status,omitempty"`
}

type EarthEventsResult struct {
	Events []EarthEvent `json:"events"`
}

type EarthPhotoInput struct{}

type EarthPhotoResult struct {
	Caption string `json:"caption,omitempty"`
	Date    string `json:"date"`
	// ImageURL is a fully-formed URL you can drop into an <img> tag.
	ImageURL string `json:"image_url"`
}

type MarsInput struct {
	// Rover name: curiosity | perseverance | opportunity | spirit. Default: curiosity.
	Rover string `json:"rover,omitempty"`
	// Martian sol (day). Mutually exclusive with earth_date.
	Sol int `json:"sol,omitempty"`
	// Earth date in YYYY-MM-DD format. Mutually exclusive with sol.
	EarthDate string `json:"earth_date,omitempty"`
	// Optional camera abbreviation (FHAZ, RHAZ, MAST, CHEMCAM, NAVCAM, ...).
	Camera string `json:"camera,omitempty"`
}

type MarsPhoto struct {
	ID          int    `json:"id"`
	ImageURL    string `json:"img_src"`
	EarthDate   string `json:"earth_date"`
	Sol         int    `json:"sol"`
	Camera      string `json:"camera"`
	Rover       string `json:"rover"`
	RoverStatus string `json:"rover_status"`
}

type MarsResult struct {
	Photos []MarsPhoto `json:"photos"`
}

type NEOApproach struct {
	Name              string  `json:"name"`
	CloseApproachDate string  `json:"close_approach_date"`
	MissDistanceKm    float64 `json:"miss_distance_km"`
	RelativeVelKps    float64 `json:"relative_velocity_kps"`
	DiameterMinMeters float64 `json:"diameter_min_meters"`
	DiameterMaxMeters float64 `json:"diameter_max_meters"`
	Hazardous         bool    `json:"potentially_hazardous"`
	NASAJPLURL        string  `json:"nasa_jpl_url"`
}

type NEOInput struct {
	// Start date in YYYY-MM-DD format. Defaults to today.
	StartDate string `json:"start_date,omitempty"`
	// End date in YYYY-MM-DD format. Max 7 days from start. Defaults to start_date.
	EndDate string `json:"end_date,omitempty"`
}

type NEOResult struct {
	ElementCount int           `json:"element_count"`
	Approaches   []NEOApproach `json:"approaches"`
}

type SessionSink interface {
	Load(ctx context.Context, conversationID string) ([]byte, error)
	Save(ctx context.Context, conversationID string, sess *agent.Session) error
	Delete(ctx context.Context, conversationID string) error
}

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