gemini

type Blob struct {
	MimeType string `json:"mimeType,omitzero"`
	Data     []byte `json:"data,omitzero"`
}

type CachedContent struct {
	Expiration
	Contents          []Content  `json:"contents,omitzero"`
	Tools             []Tool     `json:"tools,omitzero"`
	Name              string     `json:"name,omitzero"`
	DisplayName       string     `json:"displayName,omitzero"`
	Model             string     `json:"model"`
	SystemInstruction Content    `json:"systemInstruction,omitzero"`
	ToolConfig        ToolConfig `json:"toolConfig,omitzero"`

	// Not to be set on upload.
	CreateTime    string               `json:"createTime,omitzero"`
	UpdateTime    string               `json:"updateTime,omitzero"`
	UsageMetadata CachingUsageMetadata `json:"usageMetadata,omitzero"`
}

type CachingUsageMetadata struct {
	TotalTokenCount int64 `json:"totalTokenCount"`
}

type ChatRequest struct {
	Contents          []Content       `json:"contents"`
	Tools             []Tool          `json:"tools,omitzero"`
	ToolConfig        ToolConfig      `json:"toolConfig,omitzero"`
	SafetySettings    []SafetySetting `json:"safetySettings,omitzero"`
	SystemInstruction Content         `json:"systemInstruction,omitzero"`
	// https://ai.google.dev/api/generate-content?hl=en#v1beta.GenerationConfig
	GenerationConfig struct {
		StopSequences              []string   `json:"stopSequences,omitzero"`
		ResponseMimeType           string     `json:"responseMimeType,omitzero"` // "text/plain", "application/json", "text/x.enum"
		ResponseSchema             Schema     `json:"responseSchema,omitzero"`   // Requires ResponseMimeType == "application/json"
		ResponseModalities         []Modality `json:"responseModalities,omitzero"`
		CandidateCount             int64      `json:"candidateCount,omitzero"` // >= 1
		MaxOutputTokens            int64      `json:"maxOutputTokens,omitzero"`
		Temperature                float64    `json:"temperature,omitzero"` // [0, 2]
		TopP                       float64    `json:"topP,omitzero"`
		TopK                       int64      `json:"topK,omitzero"`
		Seed                       int64      `json:"seed,omitzero"`
		PresencePenalty            float64    `json:"presencePenalty,omitzero"`
		FrequencyPenalty           float64    `json:"frequencyPenalty,omitzero"`
		ResponseLogprobs           bool       `json:"responseLogprobs,omitzero"`
		Logprobs                   int64      `json:"logprobs,omitzero"`
		EnableEnhancedCivicAnswers bool       `json:"enableEnhancedCivicAnswers,omitzero"`
		// https://ai.google.dev/api/generate-content?hl=en#SpeechConfig
		SpeechConfig struct {
			// https://ai.google.dev/api/generate-content?hl=en#VoiceConfig
			VoiceConfig struct {
				// https://ai.google.dev/api/generate-content?hl=en#PrebuiltVoiceConfig
				PrebuiltVoiceConfig struct {
					VoiceName string `json:"voiceName,omitzero"`
				} `json:"prebuiltVoiceConfig,omitzero"`
			} `json:"voiceConfig,omitzero"`
		} `json:"speechConfig,omitzero"`
		// See https://ai.google.dev/gemini-api/docs/thinking#rest
		// This is frustrating: it must be present for thinking models to make it possible to disable thinking. It
		// must NOT be present for non-thinking models.
		ThinkingConfig  *ThinkingConfig `json:"thinkingConfig,omitempty"`
		MediaResolution MediaResolution `json:"mediaResolution,omitzero"`
	} `json:"generationConfig,omitzero"`
	CachedContent string `json:"cachedContent,omitzero"` // Name of the cached content with "cachedContents/" prefix.
}

type ChatResponse struct {
	Candidates     []ResponseCandidate `json:"candidates"`
	PromptFeedback struct{}            `json:"promptFeedback,omitzero"`
	UsageMetadata  UsageMetadata       `json:"usageMetadata"`
	ModelVersion   string              `json:"modelVersion"`
	ResponseID     string              `json:"responseId"`
}

type ChatStreamChunkResponse struct {
	Candidates []struct {
		Content            Content            `json:"content"`
		FinishReason       FinishReason       `json:"finishReason"`
		FinishMessage      string             `json:"finishMessage"`
		Index              int64              `json:"index"`
		GroundingMetadata  GroundingMetadata  `json:"groundingMetadata"`
		UrlContextMetadata UrlContextMetadata `json:"urlContextMetadata"`
	} `json:"candidates"`
	UsageMetadata UsageMetadata `json:"usageMetadata"`
	ModelVersion  string        `json:"modelVersion"`
	ResponseID    string        `json:"responseId"`
}

type Client struct {
	base.NotImplemented
	// contains filtered or unexported fields
}

type CodeExecutionResult struct {
	Outcome string `json:"outcome,omitzero"` // One of OUTCOME_UNSPECIFIED, OUTCOME_OK, OUTCOME_FAILED, OUTCOME_DEADLINE_EXCEEDED
	Output  string `json:"output,omitzero"`
}

type Content struct {
	Role string `json:"role,omitzero"` // "user", "model"
	// Parts can be both content and tool calls.
	Parts []Part `json:"parts"`
}

type CountTokensResponse struct {
	TotalTokens             int64 `json:"totalTokens"`
	CachedContentTokenCount int64 `json:"cachedContentTokenCount,omitzero"`
}

type Duration time.Duration

type ErrorResponse struct {
	ErrorVal ErrorResponseError `json:"error"`
}

type ErrorResponseError struct {
	Code    int64  `json:"code"` // 429
	Message string `json:"message"`
	Status  string `json:"status"` // "RESOURCE_EXHAUSTED"
	Details []struct {
		Type     string `json:"@type"`
		Reason   string `json:"reason"`
		Domain   string `json:"domain"`
		Metadata struct {
			Service string `json:"service"`
		} `json:"metadata"`
		FieldViolations []struct {
			Field       string `json:"field"`
			Description string `json:"description"`
		} `json:"fieldViolations"`
		Locale  string `json:"locale"`
		Message string `json:"message"`

		// "type.googleapis.com/google.rpc.QuotaFailure"
		Violations []struct {
			// "generativelanguage.googleapis.com/generate_requests_per_model_per_day"
			// "generativelanguage.googleapis.com/generate_requests_per_model"
			// "generativelanguage.googleapis.com/generate_content_paid_tier_input_token_count"
			QuotaMetric string `json:"quotaMetric"`
			// "GenerateRequestsPerDayPerProjectPerModel"
			// "GenerateRequestsPerMinutePerProjectPerModel"
			// "GenerateContentPaidTierInputTokensPerModelPerMinute"
			QuotaID         string `json:"quotaId"`
			QuotaDimensions struct {
				Location string `json:"location"` // "global"
				Model    string `json:"model"`    // model name
			} `json:"quotaDimensions"`
		} `json:"violations"`

		// "type.googleapis.com/google.rpc.Help"
		Links []struct {
			Description string `json:"description"`
			URL         string `json:"url"`
		} `json:"links"`

		// Type == "type.googleapis.com/google.rpc.RetryInfo"
		RetryDelay string `json:"retryDelay"` // "28s"
	} `json:"details"`
}

type ExecutableCode struct {
	Language string `json:"language,omitzero"` // Only PYTHON is supported as of March 2025.
	Code     string `json:"code,omitzero"`
}

type Expiration struct {
	ExpireTime time.Time `json:"expireTime,omitzero"` // ISO 8601
	TTL        Duration  `json:"ttl,omitzero"`        // Duration; input only
}

type FileData struct {
	MimeType string `json:"mimeType,omitzero"`
	FileURI  string `json:"fileUri,omitzero"`
}

type FileListResponse struct {
	Files         []FileMetadata `json:"files,omitzero"`
	NextPageToken string         `json:"nextPageToken,omitzero"`
}

type FileMetadata struct {
	Name           string    `json:"name,omitzero"`
	DisplayName    string    `json:"displayName,omitzero"`
	MimeType       string    `json:"mimeType,omitzero"`
	SizeBytes      int64     `json:"sizeBytes,omitzero,string"`
	CreateTime     time.Time `json:"createTime,omitzero"`
	UpdateTime     time.Time `json:"updateTime,omitzero"`
	ExpirationTime time.Time `json:"expirationTime,omitzero"`
	SHA256Hash     string    `json:"sha256Hash,omitzero"`
	URI            string    `json:"uri,omitzero"`
	DownloadURI    string    `json:"downloadUri,omitzero"`
	State          FileState `json:"state,omitzero"`
	Source         string    `json:"source,omitzero"`
	Error          *Status   `json:"error,omitzero"`
}

type FileSearch struct {
	FileSearchStoreNames []string `json:"fileSearchStoreNames,omitzero"`
	TopK                 int32    `json:"topK,omitzero"`
	MetadataFilter       string   `json:"metadataFilter,omitzero"`
}

type FileSearchStore struct {
	Name                 string               `json:"name,omitzero"`
	DisplayName          string               `json:"displayName,omitzero"`
	CreateTime           time.Time            `json:"createTime,omitzero"`
	UpdateTime           time.Time            `json:"updateTime,omitzero"`
	State                FileSearchStoreState `json:"state,omitzero"`
	ActiveDocumentsCount int64                `json:"activeDocumentsCount,omitzero,string"`
	SizeBytes            int64                `json:"sizeBytes,omitzero,string"`
}

type FileSearchStoreDocument struct {
	Name        string                       `json:"name,omitzero"`
	DisplayName string                       `json:"displayName,omitzero"`
	State       FileSearchStoreDocumentState `json:"state,omitzero"`
	CreateTime  time.Time                    `json:"createTime,omitzero"`
	UpdateTime  time.Time                    `json:"updateTime,omitzero"`
	SizeBytes   int64                        `json:"sizeBytes,omitzero,string"`
	MimeType    string                       `json:"mimeType,omitzero"`
	Error       *Status                      `json:"error,omitzero"`
}

type FileSearchStoreDocumentListResponse struct {
	Documents     []FileSearchStoreDocument `json:"documents,omitzero"`
	NextPageToken string                    `json:"nextPageToken,omitzero"`
}

type FileSearchStoreDocumentState string

type FileSearchStoreListResponse struct {
	FileSearchStores []FileSearchStore `json:"fileSearchStores,omitzero"`
	NextPageToken    string            `json:"nextPageToken,omitzero"`
}

type FileSearchStoreState string

type FileState string

type FinishReason string

type Format string

type FunctionCall struct {
	ID               string      `json:"id,omitzero"`
	Name             string      `json:"name,omitzero"`
	Args             StructValue `json:"args,omitzero"`
	ThoughtSignature []byte      `json:"thoughtSignature,omitzero"` // Returned by some models with thinking
}

type FunctionDeclaration struct {
	Name        string `json:"name,omitzero"`
	Description string `json:"description,omitzero"`
	Parameters  Schema `json:"parameters,omitzero"`
	Response    Schema `json:"response,omitzero"`
}

type FunctionResponse struct {
	ID       string      `json:"id,omitzero"`
	Name     string      `json:"name,omitzero"`
	Response StructValue `json:"response,omitzero"`
}

type GenOption struct {
	// ThinkingBudget is the maximum number of tokens the LLM can use to reason about the answer.
	//
	// From https://ai.google.dev/gemini-api/docs/thinking#set-budget
	//
	// # gemini-2.5-pro
	//
	// - Default: Dynamic thinking, model decides when and how much to think
	// - Range: 128 to 32768
	// - Cannot disable thinking
	// - Dynamic thinking: -1
	//
	// # gemini-2.5-flash
	//
	// - Default: Dynamic thinking, model decides when and how much to think
	// - Range: 0 to 24576
	// - Disable thinking with 0
	// - Dynamic thinking: -1
	//
	// # gemini-2.5-flash-lite
	//
	// - Default: Model does not think
	// - Range: 512 to 24576
	// - Disable thinking with 0
	// - Dynamic thinking: -1
	ThinkingBudget int64

	// CodeExecution enables the code execution tool, allowing the model to generate and run Python code.
	//
	// https://ai.google.dev/gemini-api/docs/code-execution
	CodeExecution bool

	// URLContext enables the URL context tool, allowing the model to fetch and process web pages.
	//
	// https://ai.google.dev/gemini-api/docs/url-context
	URLContext bool

	// FileSearch enables the file search tool with the specified configuration.
	//
	// https://ai.google.dev/gemini-api/docs/file-search
	FileSearch *FileSearch
}

type GoogleSearch struct{}

type GroundingChunk struct {
	Web              GroundingChunkWeb              `json:"web,omitzero"`
	RetrievedContext GroundingChunkRetrievedContext `json:"retrievedContext,omitzero"`
}

type GroundingChunkRetrievedContext struct {
	URI          string `json:"uri,omitzero"`
	Title        string `json:"title,omitzero"`
	Text         string `json:"text,omitzero"`
	DocumentName string `json:"documentName,omitzero"`
	// FileSearchStore is the store name that sourced this chunk. Not in the official Go SDK but returned by the API.
	FileSearchStore string `json:"fileSearchStore,omitzero"`
}

type GroundingChunkWeb struct {
	URI   string `json:"uri,omitzero"`
	Title string `json:"title,omitzero"`
}

type GroundingMetadata struct {
	GroundingChunks   []GroundingChunk   `json:"groundingChunks,omitzero"`
	GroundingSupports []GroundingSupport `json:"groundingSupports,omitzero"`
	WebSearchQueries  []string           `json:"webSearchQueries,omitzero"`
	SearchEntryPoint  SearchEntryPoint   `json:"searchEntryPoint,omitzero"`
	RetrievalMetadata RetrievalMetadata  `json:"retrievalMetadata,omitzero"`
}

type GroundingSupport struct {
	GroundingChunkIndices []int64   `json:"groundingChunkIndices,omitzero"`
	ConfidenceScores      []float64 `json:"confidenceScores,omitzero"`
	Segment               Segment   `json:"segment,omitzero"`
}

type ImageInstance struct {
	Prompt string `json:"prompt"`
	Image  struct {
		BytesBase64Encoded []byte `json:"bytesBase64Encoded,omitzero"`
		MimeType           string `json:"mimeType,omitzero"`
	} `json:"image,omitzero"`
}

type ImageOutput struct {
	MimeType           string  `json:"mimeType,omitzero"` // "image/jpeg"
	CompressionQuality float64 `json:"compressionQuality,omitzero"`
}

type ImageParameters struct {
	// Both image and video:
	SampleCount      int64  `json:"sampleCount,omitzero"` // Number of images to generate. Default to 4.
	AspectRatio      string `json:"aspectRatio,omitzero"` // "1:1", "3:4", "4:3", "9:16", and "16:9".
	PersonGeneration string `json:"personGeneration"`     // "dont_allow", "allow_adult", "allow_all" (not valid in EU, UK, CH, MENA locations)
	EnhancePrompt    bool   `json:"enhancePrompt,omitzero"`

	// Image only.
	GuidanceScale           float64     `json:"guidanceScale,omitzero"`
	Seed                    int64       `json:"seed,omitzero"`
	SafetySetting           string      `json:"safetySetting,omitzero"`
	IncludeSafetyAttributes bool        `json:"includeSafetyAttributes,omitzero"`
	IncludeRAIReason        bool        `json:"includeRAIReason,omitzero"`
	Language                string      `json:"language,omitzero"`
	OutputOptions           ImageOutput `json:"outputOptions,omitzero"`
	AddWatermark            bool        `json:"addWatermark,omitzero"`
	SampleImageSize         string      `json:"SampleImageSize,omitzero"`

	// Video only.
	DurationSeconds int64  `json:"durationSeconds,omitzero"`
	NegativePrompt  string `json:"negativePrompt,omitzero"`
}

type ImageRequest struct {
	// There should be only one instance.
	Instances  []ImageInstance `json:"instances"`
	Parameters ImageParameters `json:"parameters"`
}

type ImageResponse struct {
	Predictions []struct {
		MimeType         string `json:"mimeType"`
		SafetyAttributes struct {
			Categories []string  `json:"categories"`
			Scores     []float64 `json:"scores"`
		} `json:"safetyAttributes"`
		BytesBase64Encoded []byte `json:"bytesBase64Encoded"`
		ContentType        string `json:"contentType"` // "Positive Prompt"
	} `json:"predictions"`
}

type LogprobsResult struct {
	TopCandidates    []TopCandidate   `json:"topCandidates"`
	ChosenCandidates []TokenCandidate `json:"chosenCandidates"`
}

type MediaResolution string

type Modality string

type ModalityTokenCount struct {
	Modality   Modality `json:"modality"`
	TokenCount int64    `json:"tokenCount"`
}

type Model struct {
	Name                       string   `json:"name"`
	BaseModelID                string   `json:"baseModelId"`
	Version                    string   `json:"version"`
	DisplayName                string   `json:"displayName"`
	Description                string   `json:"description"`
	InputTokenLimit            int64    `json:"inputTokenLimit"`
	OutputTokenLimit           int64    `json:"outputTokenLimit"`
	SupportedGenerationMethods []string `json:"supportedGenerationMethods"` // "batchGenerateContent", "bidiGenerateContent", "createCachedContent", "countTokens", "countTextTokens", "embedText", "generateContent", "predict", "predictLongRunning"
	Temperature                float64  `json:"temperature"`
	MaxTemperature             float64  `json:"maxTemperature"`
	TopP                       float64  `json:"topP"`
	TopK                       int64    `json:"topK"`
	Thinking                   bool     `json:"thinking"`
}

type ModelsResponse struct {
	Models        []Model `json:"models"`
	NextPageToken string  `json:"nextPageToken"`
}

type Operation struct {
	Name     string         `json:"name"`
	Metadata map[string]any `json:"metadata"`
	Done     bool           `json:"done"`
	// One of the following:
	Error    Status `json:"error"`
	Response struct {
		Type string `json:"@type"`
		// Video generation response.
		GenerateVideoResponse struct {
			GeneratedSamples []struct {
				Video struct {
					URI        string `json:"uri"`
					VideoBytes []byte `json:"videoBytes"` // Not set in Gemini API
					MimeType   string `json:"mimeType"`   // Not set in Gemini API
				} `json:"video"`
				RAIMediaFilteredCount   int64    `json:"raiMediaFilteredCount"`
				RAIMediaFilteredReasons []string `json:"raiMediaFilteredReasons"`
			} `json:"generatedSamples"`
		} `json:"generateVideoResponse"`
		// File search store document upload response.
		DocumentName string `json:"documentName,omitzero"`
		Parent       string `json:"parent,omitzero"`
		MimeType     string `json:"mimeType,omitzero"`
		SizeBytes    string `json:"sizeBytes,omitzero"`
	} `json:"response"`
}

type Part struct {
	Thought          bool   `json:"thought,omitzero"`
	ThoughtSignature []byte `json:"thoughtSignature,omitzero"`

	// Union:
	Text                string              `json:"text,omitzero"`
	InlineData          Blob                `json:"inlineData,omitzero"` // Uploaded with /v1beta/cachedContents. Content is deleted after 1 hour.
	FunctionCall        FunctionCall        `json:"functionCall,omitzero"`
	FunctionResponse    FunctionResponse    `json:"functionResponse,omitzero"`
	FileData            FileData            `json:"fileData,omitzero"`            // Uploaded with /upload/v1beta/files. Files are deleted after 2 days.
	ExecutableCode      ExecutableCode      `json:"executableCode,omitzero"`      // TODO: Map to genai types.
	CodeExecutionResult CodeExecutionResult `json:"codeExecutionResult,omitzero"` // TODO: Map to genai types.

	// Union:
	VideoMetadata VideoMetadata `json:"videoMetadata,omitzero"`
}

type ResponseCandidate struct {
	Content       Content      `json:"content"`
	FinishReason  FinishReason `json:"finishReason"`
	FinishMessage string       `json:"finishMessage,omitzero"` // Newer models with thinking return this
	// https://ai.google.dev/api/generate-content?hl=en#v1beta.SafetyRating
	SafetyRatings []struct {
		// https://ai.google.dev/api/generate-content?hl=en#v1beta.HarmCategory
		Category string `json:"category"`
		// https://ai.google.dev/api/generate-content?hl=en#HarmProbability
		Probability string `json:"probability"`
		Blocked     bool   `json:"blocked"`
	} `json:"safetyRatings"`
	// https://ai.google.dev/api/generate-content?hl=en#v1beta.CitationMetadata
	CitationMetadata struct {
		// https://ai.google.dev/api/generate-content?hl=en#CitationSource
		CitationSources []struct {
			StartIndex int64  `json:"startIndex"`
			EndIndex   int64  `json:"endIndex"`
			URI        string `json:"uri"`
			License    string `json:"license"`
		} `json:"citationSources"`
	} `json:"citationMetadata"`
	TokenCount int64 `json:"tokenCount"`
	// https://ai.google.dev/api/generate-content?hl=en#GroundingAttribution
	GroundingAttributions []struct {
		SourceID string  `json:"sourceId"`
		Countent Content `json:"countent"`
	} `json:"groundingAttributions"`
	GroundingMetadata  GroundingMetadata  `json:"groundingMetadata"`
	UrlContextMetadata UrlContextMetadata `json:"urlContextMetadata"`
	AvgLogprobs        float64            `json:"avgLogprobs"`
	LogprobsResult     LogprobsResult     `json:"logprobsResult"`
	Index              int64              `json:"index"`
}

type RetrievalMetadata struct {
	GoogleSearchDynamicRetrievalScore float64 `json:"googleSearchDynamicRetrievalScore,omitzero"`
}

type SafetySetting struct {
	Category  string `json:"category"`  // https://ai.google.dev/api/generate-content?hl=en#v1beta.HarmCategory
	Threshold int64  `json:"threshold"` // https://ai.google.dev/api/generate-content?hl=en#HarmBlockThreshold
}

type Schema struct {
	// Optional. The value should be validated against any (one or more) of the subschemas
	// in the list.
	AnyOf []*Schema `json:"anyOf,omitzero"`
	// Optional. Default value of the data.
	Default any `json:"default,omitzero"`
	// Optional. The description of the data.
	Description string `json:"description,omitzero"`
	// Optional. Possible values of the element of primitive type with enum format. Examples:
	// 1. We can define direction as : {type:STRING, format:enum, enum:["EAST", NORTH",
	// "SOUTH", "WEST"]} 2. We can define apartment number as : {type:INTEGER, format:enum,
	// enum:["101", "201", "301"]}
	Enum []string `json:"enum,omitzero"`
	// Optional. Example of the object. Will only populated when the object is the root.
	Example any `json:"example,omitzero"`
	// Optional. The format of the data. Supported formats: for NUMBER type: "float", "double"
	// for INTEGER type: "int32", "int64" for STRING type: "email", "byte", etc
	Format Format `json:"format,omitzero"`
	// Optional. SCHEMA FIELDS FOR TYPE ARRAY Schema of the elements of Type.ARRAY.
	Items *Schema `json:"items,omitzero"`
	// Optional. Maximum number of the elements for Type.ARRAY.
	MaxItems int64 `json:"maxItems,omitzero,string"`
	// Optional. Maximum length of the Type.STRING
	MaxLength int64 `json:"maxLength,omitzero,string"`
	// Optional. Maximum number of the properties for Type.OBJECT.
	MaxProperties int64 `json:"maxProperties,omitzero,string"`
	// Optional. Maximum value of the Type.INTEGER and Type.NUMBER
	Maximum float64 `json:"maximum,omitzero"`
	// Optional. Minimum number of the elements for Type.ARRAY.
	MinItems int64 `json:"minItems,omitzero,string"`
	// Optional. SCHEMA FIELDS FOR TYPE STRING Minimum length of the Type.STRING
	MinLength int64 `json:"minLength,omitzero,string"`
	// Optional. Minimum number of the properties for Type.OBJECT.
	MinProperties int64 `json:"minProperties,omitzero,string"`
	// Optional. Minimum value of the Type.INTEGER and Type.NUMBER.
	Minimum float64 `json:"minimum,omitzero"`
	// Optional. Indicates if the value may be null.
	Nullable bool `json:"nullable,omitzero"`
	// Optional. Pattern of the Type.STRING to restrict a string to a regular expression.
	Pattern string `json:"pattern,omitzero"`
	// Optional. SCHEMA FIELDS FOR TYPE OBJECT Properties of Type.OBJECT.
	Properties map[string]Schema `json:"properties,omitzero"`
	// Optional. The order of the properties. Not a standard field in open API spec. Only
	// used to support the order of the properties.
	PropertyOrdering []string `json:"propertyOrdering,omitzero"`
	// Optional. Required properties of Type.OBJECT.
	Required []string `json:"required,omitzero"`
	// Optional. The title of the Schema.
	Title string `json:"title,omitzero"`
	// Optional. The type of the data.
	Type Type `json:"type,omitzero"`
}

type SearchEntryPoint struct {
	RenderedContent string `json:"renderedContent,omitzero"`
	SDKBlob         []byte `json:"sdkBlob,omitzero"` // JSON encoded list of (search term,search url) results
}

type Segment struct {
	PartIndex  int64  `json:"partIndex,omitzero"`
	StartIndex int64  `json:"startIndex,omitzero"`
	EndIndex   int64  `json:"endIndex,omitzero"`
	Text       string `json:"text,omitzero"`
}

type Status struct {
	Code    int64          `json:"code"`
	Message string         `json:"message"`
	Details map[string]any `json:"details"`
}

type StructValue map[string]any

type ThinkingConfig struct {
	// IncludeThoughts has no effect since January 2025 according to
	// https://discuss.ai.google.dev/t/thoughts-are-missing-cot-not-included-anymore/63653/13
	IncludeThoughts bool  `json:"includeThoughts"` // Must not be omitted.
	ThinkingBudget  int64 `json:"thinkingBudget"`  // Must not be omitted. [0, 24576]
}

type TokenCandidate struct {
	Token          string  `json:"token"`
	TokenID        int64   `json:"tokenId"`
	LogProbability float64 `json:"logProbability"`
}

type Tool struct {
	FunctionDeclarations []FunctionDeclaration `json:"functionDeclarations,omitzero"`
	// https://ai.google.dev/api/caching?hl=en#GoogleSearchRetrieval
	GoogleSearchRetrieval struct {
		// https://ai.google.dev/api/caching?hl=en#DynamicRetrievalConfig
		DynamicRetrievalConfig struct {
			// https://ai.google.dev/api/caching?hl=en#Mode
			Mode             string  `json:"mode,omitzero"` // MODE_UNSPECIFIED, MODE_DYNAMIC
			DynamicThreshold float64 `json:"dynamicThreshold,omitzero"`
		} `json:"dynamicRetrievalConfig,omitzero"`
	} `json:"googleSearchRetrieval,omitzero"`
	CodeExecution *struct{} `json:"codeExecution,omitzero"`
	URLContext    *struct{} `json:"urlContext,omitzero"`
	// GoogleSearch presence signifies that it should be enabled,
	GoogleSearch *GoogleSearch `json:"googleSearch,omitzero"`
	// FileSearch enables file search tool.
	FileSearch *FileSearch `json:"fileSearch,omitzero"`
}

type ToolConfig struct {
	// https://ai.google.dev/api/caching?hl=en#FunctionCallingConfig
	FunctionCallingConfig struct {
		Mode                 ToolMode `json:"mode,omitzero"`
		AllowedFunctionNames []string `json:"allowedFunctionNames,omitzero"`
	} `json:"functionCallingConfig,omitzero"`
}

type ToolMode string

type TopCandidate struct {
	Candidates []TokenCandidate `json:"candidates"`
}

type Type string

type UrlContextMetadata struct {
	UrlMetadata []UrlMetadataEntry `json:"urlMetadata,omitzero"`
}

type UrlMetadataEntry struct {
	RetrievedUrl       string `json:"retrievedUrl,omitzero"`
	UrlRetrievalStatus string `json:"urlRetrievalStatus,omitzero"`
}

type UsageMetadata struct {
	PromptTokenCount           int64                `json:"promptTokenCount"`
	CachedContentTokenCount    int64                `json:"cachedContentTokenCount"`
	CandidatesTokenCount       int64                `json:"candidatesTokenCount"`
	ToolUsePromptTokenCount    int64                `json:"toolUsePromptTokenCount"`
	ThoughtsTokenCount         int64                `json:"thoughtsTokenCount"`
	TotalTokenCount            int64                `json:"totalTokenCount"`
	PromptTokensDetails        []ModalityTokenCount `json:"promptTokensDetails"`
	CacheTokensDetails         []ModalityTokenCount `json:"cacheTokensDetails"`
	CandidatesTokensDetails    []ModalityTokenCount `json:"candidatesTokensDetails"`
	ToolUsePromptTokensDetails []ModalityTokenCount `json:"toolUsePromptTokensDetails"`
}

type Value struct {
	NullValue   int64       `json:"null_value,omitzero"`
	NumberValue float64     `json:"number_value,omitzero"`
	StringValue string      `json:"string_value,omitzero"`
	BoolValue   bool        `json:"bool_value,omitzero"`
	StructValue StructValue `json:"struct_value,omitzero"`
	ListValue   []Value     `json:"list_value,omitzero"`
}

type VideoMetadata struct {
	StartOffset Duration `json:"startOffset,omitzero"`
	EndOffset   Duration `json:"endOffset,omitzero"`
	FPS         int64    `json:"fps,omitzero"` // Default: 1.0, range ]0, 24]
}