client

type APIError struct {
	Error string `json:"error"`
}

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

type ContentStatus struct {
	ID     string `json:"id" toon:"id"`
	Status string `json:"status" toon:"status"`
	Error  *struct {
		Tag            string `json:"tag,omitempty"`
		HTTPStatusCode int    `json:"httpStatusCode,omitempty"`
	} `json:"error,omitempty"`
}

type ContentsOptions struct {
	Text       any `json:"text,omitempty"`       // bool or TextOptions
	Highlights any `json:"highlights,omitempty"` // bool
	Summary    any `json:"summary,omitempty"`    // bool or SummaryOptions
}

type ContentsRequest struct {
	IDs              []string `json:"ids"`
	Text             any      `json:"text,omitempty"`       // bool or TextOptions
	Highlights       any      `json:"highlights,omitempty"` // bool
	Summary          any      `json:"summary,omitempty"`    // bool or SummaryOptions
	Context          any      `json:"context,omitempty"`    // bool or ContextOptions
	Subpages         int      `json:"subpages,omitempty"`
	SubpageTarget    []string `json:"subpageTarget,omitempty"`
	MaxAgeHours      *int     `json:"maxAgeHours,omitempty"`
	LivecrawlTimeout int      `json:"livecrawlTimeout,omitempty"`
}

type ContentsResponse struct {
	Results  []SearchResult  `json:"results" toon:"results"`
	Statuses []ContentStatus `json:"statuses,omitempty" toon:"statuses,omitempty"`
}

type ContextOptions struct {
	MaxCharacters int `json:"maxCharacters,omitempty"`
}

type SearchRequest struct {
	Query              string           `json:"query"`
	Type               string           `json:"type,omitempty"`
	NumResults         int              `json:"numResults,omitempty"`
	Contents           *ContentsOptions `json:"contents,omitempty"`
	IncludeDomains     []string         `json:"includeDomains,omitempty"`
	ExcludeDomains     []string         `json:"excludeDomains,omitempty"`
	StartPublishedDate string           `json:"startPublishedDate,omitempty"`
	EndPublishedDate   string           `json:"endPublishedDate,omitempty"`
	Category           string           `json:"category,omitempty"`
	MaxAgeHours        *int             `json:"maxAgeHours,omitempty"`
}

type SearchResponse struct {
	Results            []SearchResult `json:"results" toon:"results"`
	AutopromptString   string         `json:"autopromptString,omitempty" toon:"autopromptString,omitempty"`
	ResolvedSearchType string         `json:"resolvedSearchType,omitempty" toon:"resolvedSearchType,omitempty"`
}

type SearchResult struct {
	Title         string   `json:"title" toon:"title"`
	URL           string   `json:"url" toon:"url"`
	PublishedDate string   `json:"publishedDate,omitempty" toon:"publishedDate,omitempty"`
	Author        string   `json:"author,omitempty" toon:"author,omitempty"`
	Score         float64  `json:"score,omitempty" toon:"score,omitempty"`
	ID            string   `json:"id" toon:"id"`
	Text          string   `json:"text,omitempty" toon:"text,omitempty"`
	Highlights    []string `json:"highlights,omitempty" toon:"highlights,omitempty"`
	Summary       string   `json:"summary,omitempty" toon:"summary,omitempty"`
}

type SummaryOptions struct {
	Query  string `json:"query,omitempty"`
	Schema any    `json:"schema,omitempty"` // JSON schema for structured extraction
}

type TextOptions struct {
	MaxCharacters   int    `json:"maxCharacters,omitempty"`
	IncludeHtmlTags bool   `json:"includeHtmlTags,omitempty"`
	Verbosity       string `json:"verbosity,omitempty"` // compact, standard, full
}